feat: классификация писем Qwen3:8b + обработчики (urgent→TG, task→VTODO, meeting→VEVENT)
- mail_archive.py: фикс вложений himalaya --dir → --downloads-dir; attachments/ только при has_attachment; идемпотентно - email_classifier.py: Qwen3:8b (Ollama) → теги info/urgent/task/meeting в frontmatter email.md - email_handlers.py: urgent→Telegram (Bot API+SOCKS5), task→Radicale VTODO, meeting→Radicale VEVENT; handled_* идемпотентность; --dry-run - .gitignore: игнор *.env.bak* - openspec: чейндж email-classification-handlers (в работе) - STATUS/TODO/WALKTHROUGH: прогресс сессии, подводные камни Radicale (http.client, Depth:1, формат дат)
This commit is contained in:
@@ -0,0 +1,2 @@
|
||||
schema: spec-driven
|
||||
created: 2026-09-13
|
||||
@@ -0,0 +1,83 @@
|
||||
# Design: Убрать Vikunja, задачи через Radicale (VTODO)
|
||||
|
||||
## Context
|
||||
|
||||
- Radicale (CalDAV/CardDAV) развёрнут, календари Личный/Рабочий/Задачи на ФС.
|
||||
Публично: cal.nixg.ru (Caddy vps02 → 10.8.0.2:5232).
|
||||
- Vikunja развёрнут (compose `/opt/hermes/email-assistant/vikunja/`, контейнеры
|
||||
`vikunja` + `vikunja-db` postgres, :3456), но админ/API-токен НЕ созданы —
|
||||
это блокер для обработчика `task` в classification-чейндже.
|
||||
- Календарь «Задачи» в Radicale уже существует (VTODO-совместимый).
|
||||
- Android: jtx board синхронизирует VTODO по CalDAV через DAVx5.
|
||||
|
||||
## Goals / Non-Goals
|
||||
|
||||
**Goals:**
|
||||
- Убрать Vikunja как лишнюю сущность.
|
||||
- Задачи создаются через Radicale VTODO (календарь «Задачи»).
|
||||
- Обработчик `task` в classification-чейндже пишет VTODO, не зависит от Vikunja.
|
||||
- Обновить документацию/список задач.
|
||||
|
||||
**Non-Goals:**
|
||||
- Не мигрируем данные из Vikunja (их там нет — сервис не администрирован).
|
||||
- Не удаляем данные Radicale — только добавляем VTODO.
|
||||
- Не трогаем Caddy, если tasks.nixg.ru ещё не настроен (только не настраивать).
|
||||
|
||||
## Decisions
|
||||
|
||||
### D1: Vikunja выводится из эксплуатации
|
||||
Контейнеры `vikunja` и `vikunja-db` останавливаются и удаляются:
|
||||
```bash
|
||||
cd /opt/hermes/email-assistant/vikunja
|
||||
docker compose down -v # или docker stop vikunja vikunja-db && docker rm ...
|
||||
```
|
||||
- Данные (volume `vikunja-db`) можно удалить (сервис не использовался),
|
||||
либо сделать бэкап перед удалением (аккуратно — «не удалять данные
|
||||
пользователя»). Решение: сделать копию volume/postgres-дампа на всякий случай,
|
||||
затем удалить контейнеры; compose.yml/.env пометить deprecated или удалить
|
||||
после подтверждения пользователя.
|
||||
|
||||
### D2: Обработчик task → Radicale VTODO
|
||||
В чейндже `email-classification-handlers` обработчик `task` меняется с
|
||||
«Vikunja API POST» на «Radicale CalDAV PUT VTODO»:
|
||||
- URL: `https://cal.nixg.ru/estorozhenko/<urlencoded 'Задачи'>/<uid>.ics`
|
||||
- Auth: Basic (estorozhenko:пароль Radicale)
|
||||
- Body: VCALENDAR + VTODO (SUMMARY=тема, DESCRIPTION=ссылка на email.md,
|
||||
при наличии даты — DTSTART/DUE)
|
||||
- Пометить `handled_task: true` после успешного PUT (201/204)
|
||||
- Идемпотентность: если `handled_task: true` — пропустить
|
||||
|
||||
### D3: tasks.nixg.ru
|
||||
- Если reverse proxy уже настроен в Caddy — закомментировать/убрать.
|
||||
- Если нет — не настраивать. Единственный домен: cal.nixg.ru.
|
||||
|
||||
### D4: Android — jtx board
|
||||
Для задач (VTODO) используется jtx board, синхронизация через DAVx5 (Radicale).
|
||||
В STATUS.md зафиксировать: «задачи = Radicale VTODO, jtx board».
|
||||
|
||||
### D5: Чейндж email-classification-handlers — правка
|
||||
В `email-classification-handlers`:
|
||||
- specs/email-handlers/spec.md: «Создание задачи в Vikunja» → «Создание задачи
|
||||
в Radicale (VTODO)»
|
||||
- design.md: убрать Vikunja-ветку, заменить на Radicale VTODO
|
||||
- tasks.md: задача 3.3 (Vikunja API) → Radicale VTODO; задача 4.1 (админ Vikunja)
|
||||
→ удалить
|
||||
Это правки в активном чейндже — внести сразу.
|
||||
|
||||
## Risks / Trade-offs
|
||||
|
||||
- **Vikunja данные** — если в Vikunja что-то было создано, удаление volume потеряет
|
||||
это. Митигирует: бэкап volume/postgres-дамп перед удалением.
|
||||
- **VTODO-совместимость клиентов** — Radicale хранит VTODO как файлы, jtx board
|
||||
их читает. Риск низкий (стандарт CalDAV).
|
||||
- **Ссылка на email.md в DESCRIPTION** — на телефоне путь недоступен (локальный
|
||||
диск), но виден в reason/задаче. Это ок: задача показывает тему + обоснование.
|
||||
- **Уже развёрнутый Vikunja** — вывод из эксплуатации надо делать аккуратно,
|
||||
с бэкапом и подтверждением (не удалять данные пользователя без спроса).
|
||||
|
||||
## Verification
|
||||
|
||||
1. `docker ps` — контейнеры vikunja/vikunja-db отсутствуют.
|
||||
2. `curl -X PROPFIND https://cal.nixg.ru/estorozhenko/Задачи/` — календарь доступен.
|
||||
3. Создать VTODO через обработчик → `curl GET .../Задачи/<uid>.ics` — VTODO есть.
|
||||
4. `openspec validate remove-vikunja-use-radicale-tasks` — valid.
|
||||
@@ -0,0 +1,60 @@
|
||||
# Proposal: Убрать Vikunja, задачи через Radicale (VTODO)
|
||||
|
||||
## Why
|
||||
|
||||
В проекте email-assistant были развёрнуты два сервиса для календаря/задач:
|
||||
- **Radicale** (CalDAV/CardDAV) — календари Личный/Рабочий/Задачи
|
||||
- **Vikunja** (трекер задач) — отдельная сущность на :3456, tasks.nixg.ru
|
||||
|
||||
Это лишняя сложность: Radicale из коробки поддерживает **VTODO** (задачи через
|
||||
CalDAV), а календарь «Задачи» в Radicale уже создан. На Android задачи из
|
||||
CalDAV-VTODO прекрасно синхронизирует **jtx board** (и DAVx5), не требуя
|
||||
отдельного трекера.
|
||||
|
||||
Vikunja добавляет:
|
||||
- лишний docker-контейнер + PostgreSQL
|
||||
- отдельный API, токен, админа (не созданы — блокер)
|
||||
- отдельный домен tasks.nixg.ru (reverse proxy, сертификат)
|
||||
- дублирование логики «создать задачу» (Vikunja API вместо простого VTODO)
|
||||
- усложнение чейнджа классификации (обработчик `task` зависел от несуществующего токена)
|
||||
|
||||
Убираем Vikunja из проекта. Задачи — через Radicale (VTODO в календаре «Задачи»).
|
||||
Это упрощает архитектуру, убирает лишнюю сущность, не теряя функциональности.
|
||||
|
||||
## What Changes
|
||||
|
||||
1. **Обработчик задач переключается на Radicale VTODO** — в чейндже
|
||||
`email-classification-handlers` обработчик `task` создаёт не задачу в Vikunja,
|
||||
а **VTODO в календаре «Задачи» Radicale** (CalDAV PUT). Тема письма → SUMMARY,
|
||||
ссылка на письмо → DESCRIPTION.
|
||||
2. **Vikunja выводится из эксплуатации** — остановить и удалить контейнеры
|
||||
`vikunja` и `vikunja-db`, убрать docker-compose.yml, .env (или пометить
|
||||
deprecated), освободить порт 3456.
|
||||
3. **tasks.nixg.ru** — если reverse proxy уже настроен, убрать/закомментировать;
|
||||
если нет — не настраивать. Radicale остаётся единственным CalDAV-сервером.
|
||||
4. **Обновить документацию** — STATUS.md, TODO.md, design чейнджей убрать Vikunja,
|
||||
зафиксировать «задачи = Radicale VTODO, jtx board».
|
||||
5. **TODO/общий список** — задача «Vikunja» закрыта как «не нужна»,
|
||||
«Caddy tasks.nixg.ru» — отменена.
|
||||
|
||||
## Capabilities
|
||||
|
||||
### New Capabilities
|
||||
- `radicale-tasks`: создание задач (VTODO) в Radicale через CalDAV — заменяет
|
||||
Vikunja для обработчика `task` в email-classification-handlers.
|
||||
|
||||
### Modified Capabilities
|
||||
- (нет) — Vikunja не является capability проекта; это внешний сервис, который
|
||||
выводится из эксплуатации. Radicale-tasks — новое поведение.
|
||||
|
||||
## Impact
|
||||
|
||||
- **Docker**: остановить/удалить `vikunja`, `vikunja-db` (compose в
|
||||
`/opt/hermes/email-assistant/vikunja/`)
|
||||
- **Скрипты**: `email_handlers.py` (в чейндже classification) — обработчик `task`
|
||||
→ Radicale VTODO вместо Vikunja API
|
||||
- **Радикал**: календарь «Задачи» уже существует, туда пишутся VTODO
|
||||
- **Документация**: STATUS.md, TODO.md, design.md (local-calendar-tasks,
|
||||
email-classification-handlers) — убрать Vikunja, зафиксировать Radicale VTODO
|
||||
- **Caddy (если настроен)**: убрать/закомментировать tasks.nixg.ru
|
||||
- **TODO.md**: закрыть задачи Vikunja (2, 3, 6 — «создать задачу» теперь Radicale)
|
||||
@@ -0,0 +1,45 @@
|
||||
## Purpose
|
||||
|
||||
Создание задач через Radicale как VTODO-объектов в календаре «Задачи» (CalDAV).
|
||||
Используется обработчиком `task` в чейндже email-classification-handlers вместо
|
||||
Vikunja. Упрощает архитектуру: Radicale — единственный сервис календаря и задач.
|
||||
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: Задача создаётся как VTODO в Radicale
|
||||
|
||||
Задача MUST создаваться как VTODO-объект (CalDAV) в календаре «Задачи» Radicale
|
||||
по адресу `https://cal.nixg.ru/estorozhenko/Задачи/`, а не через Vikunja API.
|
||||
|
||||
#### Scenario: Обработчик task
|
||||
- **WHEN** `email_handlers.py` обрабатывает письмо с тегом `task`
|
||||
- **THEN** в календаре «Задачи» Radicale создаётся VTODO (PUT по адресу
|
||||
`https://cal.nixg.ru/estorozhenko/<urlencoded Задачи>/<uid>.ics`)
|
||||
|
||||
### Requirement: Поля VTODO из письма
|
||||
|
||||
VTODO MUST содержать: SUMMARY — тема письма, DESCRIPTION — ссылка на файл
|
||||
`email.md` письма. При наличии даты/дедлайна в классификации — DTSTART/DUE.
|
||||
|
||||
#### Scenario: Создание VTODO из письма с задачей
|
||||
- **WHEN** `email_handlers.py` создаёт задачу из письма с тегом `task`
|
||||
- **THEN** VTODO имеет SUMMARY=тема письма, DESCRIPTION=путь к email.md,
|
||||
и (если указано) DTSTART/DUE из классификации
|
||||
|
||||
### Requirement: Идемпотентность задач Radicale
|
||||
|
||||
Повторный запуск обработчика MUST NOT создавать дубликат VTODO для одного письма
|
||||
(поле `handled_task: true` в frontmatter после успешного создания).
|
||||
|
||||
#### Scenario: Повторный запуск обработчика task
|
||||
- **WHEN** `email_handlers.py` запущен повторно на письме с уже созданной задачей (`handled_task: true`)
|
||||
- **THEN** новый VTODO не создаётся
|
||||
|
||||
### Requirement: Совместимость с jtx board / DAVx5
|
||||
|
||||
Созданный VTODO MUST быть читаемым стандартными CalDAV-клиентами (jtx board,
|
||||
DAVx5), т.е. валидным VCALENDAR с VTODO компонентом.
|
||||
|
||||
#### Scenario: Чтение задачи в jtx board
|
||||
- **WHEN** пользователь открывает календарь «Задачи» в jtx board (через DAVx5)
|
||||
- **THEN** VTODO отображается как задача с SUMMARY и DESCRIPTION
|
||||
@@ -0,0 +1,45 @@
|
||||
# Tasks: Убрать Vikunja, задачи через Radicale VTODO
|
||||
|
||||
## 1. Переключить обработчик task на Radicale VTODO
|
||||
|
||||
- [x] 1.1 В чейндже `email-classification-handlers` обновить specs/design/tasks:
|
||||
заменить «Vikunja API» на «Radicale CalDAV PUT VTODO» (календарь Задачи)
|
||||
- [x] 1.2 Уточнить формат VTODO: SUMMARY=тема, DESCRIPTION=ссылка на email.md,
|
||||
DTSTART/DUE при наличии даты из классификации
|
||||
- [x] 1.3 Верификация: чейндж `email-classification-handlers` остаётся валидным
|
||||
`Верификация: cd /opt/hermes/email-assistant && openspec validate email-classification-handlers`
|
||||
|
||||
## 2. Вывод Vikunja из эксплуатации
|
||||
|
||||
- [x] 2.1 Сделать бэкап данных Vikunja (если есть) перед удалением
|
||||
(volume vikunja-db / postgres-дамп в backups/) — **НЕ НУЖЕН** (решение пользователя 2026-09-13)
|
||||
- [x] 2.2 **Подтверждение пользователя на удаление** volume (данные Vikunja)
|
||||
— получено: «бэкап не нужен, выполняй остальные пункты»
|
||||
- [x] 2.3 Остановить и удалить контейнеры
|
||||
`cd /opt/hermes/email-assistant/vikunja && docker compose down -v`
|
||||
`Верификация: docker ps | grep -E 'vikunja|postgres' || echo 'Vikunja removed'`
|
||||
- [x] 2.4 Удалить каталог `/opt/hermes/email-assistant/vikunja/` (compose, .env)
|
||||
`Верификация: test ! -d /opt/hermes/email-assistant/vikunja`
|
||||
- [x] 2.5 Убрать/закомментировать reverse proxy tasks.nixg.ru из Caddy,
|
||||
если он настроен (Caddyfile на vps02) — закомментирован (строки 114-120), Caddy перезагружен
|
||||
|
||||
## 3. Обновить документацию и планы
|
||||
|
||||
- [x] 3.1 TODO.md: закрыть задачи Vikunja (2 «Vikunja развёрнут», 3 «Vikunja app»,
|
||||
6 «Vikunja API»), пометить «не нужна» (сделано 2026-09-13)
|
||||
- [x] 3.2 STATUS.md: убрать Vikunja из архитектуры, зафиксировать
|
||||
«задачи = Radicale VTODO, календарь Задачи, jtx board/DAVx5» (сделано 2026-09-13)
|
||||
- [x] 3.3 Обновить запись «Ресурсы проекта»: убрать Vikunja/tasks.nixg.ru,
|
||||
добавить Radicale VTODO (сделано 2026-09-13)
|
||||
- [x] 3.4 В чейндже `local-calendar-tasks` пометить Vikunja как не входящую
|
||||
(или заархивировать его как superseded) — proposal помечен SUPERSEDED
|
||||
|
||||
## 4. Проверка end-to-end
|
||||
|
||||
- [x] 4.1 Создать тестовое письмо с тегом `task` → обработчик создаёт VTODO
|
||||
в Radicale (календарь Задачи)
|
||||
`Верификация: curl -u estorozhenko:... -X PROPFIND -H 'Depth: 1' https://cal.nixg.ru/estorozhenko/<urlencoded Задачи>/ | grep -c 'VTODO\|ics'`
|
||||
— тестовый VTODO `test-vikunja-removal-2026` создан (PUT 201, GET 200) 2026-09-13
|
||||
- [x] 4.2 Верифицировать, что Vikunja отсутствует и ничего не сломано
|
||||
`docker ps | grep -i vikunja || echo OK` — контейнеров нет, порт 3456 свободен,
|
||||
cal.nixg.ru работает (207)
|
||||
Reference in New Issue
Block a user