OpenSpec: разнести openspec по проектам

2026-09-29 09:15:09 +00:00 · 2026-09-11 17:30:17 +00:00
parent 757f3413e9
commit f44bc27ce1
20 changed files with 1846 additions and 0 deletions
@@ -0,0 +1,144 @@
+# Design: Локальные сервисы календаря (Radicale) и задач (Vikunja)
+
+## Архитектура (по требованию пользователя)
+
+> **ВСЕ сервисы работают в отдельных Docker-контейнерах.**
+> Полный стек изолирован в docker compose; никаких systemd-сервисов
+> для Radicale/Vikunja.
+
+```
+┌────────────────────────────────────────────┐
+│ bigbox (docker)                             │
+│  ┌──────────────┐   ┌───────────────────┐  │
+│  │ radicale     │   │ vikunja           │  │
+│  │ :5232 CalDAV │   │ :3456 WebUI+API   │  │
+│  │              │   │ └─ postgres (:5433)│ │
+│  └──────────────┘   └───────────────────┘  │
+└────────────────────────────────────────────┘
+        │                        │
+        └── Caddy reverse proxy (TLS) → Android DAVx5
+```
+
+## Сервисы и файлы
+
+| Сервис | Образ | Порт | Каталог | Данные |
+|--------|-------|------|---------|--------|
+| Radicale | `tobymossman/radicale` | 5232 | `/opt/hermes/radicale/` | volume `radicale-data` (коллекции .xand) |
+| Vikunja | `vikunja/vikunja:latest` | 3456 | `/opt/hermes/vikunja/` | volume `vikunja-files`, `vikunja-db` |
+| PostgreSQL | `postgres:16-alpine` | 5433 (внутр.) | — | volume `vikunja-db` |
+
+## Radicale (docker)
+
+```yaml
+# /opt/hermes/radicale/docker-compose.yml
+services:
+  radicale:
+    image: tobyworrall/radicale:latest
+    container_name: radicale
+    ports:
+      - "5232:5232"
+    volumes:
+      - ./data:/data
+      - ./config:/config
+    environment:
+      - RADICALE_APPS=caldav
+    restart: unless-stopped
+```
+
+- **Auth:** HTTP Basic. Пользователи в `config` (htpasswd-файл users)
+- **Коллекции:** `/data/collections/` (календари .xand, задачи .ics)
+- **Создание коллекций:** через DAVx5/curl PUT, или вручную скриптом
+  (`radicale_collections.sh` создаёт «Личный», «Рабочий», «Задачи»)
+
+## Vikunja (docker)
+
+```yaml
+# /opt/hermes/vikunja/docker-compose.yml
+services:
+  db:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_PASSWORD: [REDACTED]
+      POSTGRES_DB: vikunja
+    volumes:
+      - vikunja-db:/var/lib/postgresql/data
+    restart: unless-stopped
+
+  vikunja:
+    image: vikunja/vikunja:latest
+    depends_on: [db]
+    environment:
+      VIKUNJA_DATABASE_TYPE: postgres
+      VIKUNJA_DATABASE_HOST: db
+      VIKUNJA_DATABASE_DATABASE: vikunja
+      VIKUNJA_DATABASE_USERNAME: vikunja
+      VIKUNJA_DATABASE_PASSWORD: [REDACTED]
+      VIKUNJA_SERVICE_JWTSECRET: [REDACTED]
+      VIKUNJA_SERVICE_FRONTENDURL: https://tasks.nixg.ru
+      VIKUNJA_SERVICE_PUBLICURL: https://tasks.nixg.ru
+    ports:
+      - "3456:80"
+    volumes:
+      - vikunja-files:/app/files
+    restart: unless-stopped
+```
+
+- **Порт:** 3456 (netbox на 8080 — не конфликтует)
+- **Postgres:** внутренний контейнер на 5433 (не публикуем наружу)
+- **Данные:** volumes vikunja-db + vikunja-files
+- **Логин:** первый зарегистрированный пользователь становится админом
+- **API:** `/api/v1/` — токен в Настройки → API tokens
+
+## Caddy reverse proxy (TLS для Android)
+
+Radicale (DAVx5) и Vikunja доступны снаружи через Caddy (он уже есть в
+/opt/gitea.nixg.ru). Домены:
+- `cal.nixg.ru` → Radicale :5232
+- `tasks.nixg.ru` → Vikunja :3456
+
+```caddy
+cal.nixg.ru {
+    reverse_proxy 127.0.0.1:5232
+}
+tasks.nixg.ru {
+    reverse_proxy 127.0.0.1:3456
+}
+```
+
+TLS — Let's Encrypt через Caddy (получает автоматически).
+
+## Команды применения
+
+```bash
+# Radicale
+mkdir -p /opt/hermes/radicale/{config,data}
+cd /opt/hermes/radicale && docker compose up -d
+
+# Vikunja
+mkdir -p /opt/hermes/vikunja
+cd /opt/hermes/vikunja && docker compose up -d
+
+# Проверка
+curl -i -X PROPFIND http://127.0.0.1:5232/ -u estorozhenko:...
+curl http://127.0.0.1:3456/api/v1/info
+```
+
+## Верификация (GIVEN/WHEN/THEN → команды)
+
+1. Radicale: `curl -s -o /dev/null -w '%{http_code}' -X PROPFIND http://127.0.0.1:5232/ -u estorozhenko:...` → 207
+2. Vikunja: `curl -s http://127.0.0.1:3456/api/v1/info` → JSON 200
+3. API-токен: создать задачу → 201
+4. Android/DAVx5: событие с телефона появляется в Radicale
+
+## Rollback
+
+```bash
+cd /opt/hermes/vikunja && docker compose down -v   # удалить всё, включая volume
+cd /opt/hermes/radicale && docker compose down -v
+rm -rf /opt/hermes/vikunja /opt/hermes/radicale
+# убрать строки из Caddy и перезапустить его (внешне, sudo systemctl restart)
+```
+
+## Секреты
+
+Пароли/токены — только в `.env` файлах сервисов ([REDACTED] в доках), НЕ в git.