64 lines
4.7 KiB
Markdown
64 lines
4.7 KiB
Markdown
# Tasks: Классификация писем и подключение обработчиков
|
|
|
|
## 1. Починить скачивание вложений
|
|
|
|
- [x] 1.1 Исправить `get_attachments()` в `scripts/mail_archive.py`: заменить
|
|
`--dir` на `--downloads-dir`, передавать `<msg_dir>/attachments/`
|
|
- [x] 1.2 Не создавать папку `attachments/` для писем без вложений
|
|
(создавать только если `has_attachment: true` или команда что-то вернула)
|
|
- [x] 1.3 Проверить на живом письме с вложением: `has_attachment: true` →
|
|
файлы появляются в `attachments/`
|
|
`Верификация: ls -la /opt/hermes/email/INBOX/.../<uid>/attachments/`
|
|
- [x] 1.4 Проверить идемпотентность: повторный запуск не качает повторно
|
|
|
|
## 2. Классификатор писем (email_classifier.py)
|
|
|
|
- [x] 2.1 Создать `scripts/email_classifier.py`:
|
|
- читает неклассифицированные email.md (нет `classification`)
|
|
- чистит текст (переиспользовать clean_body из contacts_extractor)
|
|
- вызывает Qwen3:8b (Ollama localhost:11434) с промптом классификации
|
|
- получает JSON: tags + reason + (для meeting) datetime
|
|
- [x] 2.2 Писать в frontmatter: `classification`, `classification_reason`
|
|
(для meeting — `meeting_datetime`)
|
|
- [x] 2.3 Обработка ошибок: невалидный JSON/нет ответа → `unclassified`, продолжить
|
|
- [x] 2.4 `--limit N` для дозирования (как contacts_extractor)
|
|
- [x] 2.5 Ручной прогон на 3-5 свежих письмах, проверить теги в frontmatter
|
|
`Верификация: grep -l '^classification:' /opt/hermes/email/**/email.md | head`
|
|
|
|
## 3. Обработчики (email_handlers.py)
|
|
|
|
- [x] 3.1 Создать `scripts/email_handlers.py`: сканирует письма с тегами и без `handled_*`
|
|
- [x] 3.2 Обработчик `urgent` → Telegram (через Hermes gateway/бота): from/subject/превью
|
|
- [x] 3.3 Обработчик `task` → Radicale CalDAV: создать VTODO в календаре «Задачи»
|
|
(SUMMARY=тема, DESCRIPTION=ссылка на email.md, DTSTART/DUE при наличии даты)
|
|
вместо Vikunja API (см. чейндж remove-vikunja-use-radicale-tasks)
|
|
- [x] 3.4 Обработчик `meeting` → Radicale: создать VEVENT в календаре Рабочий
|
|
(SUMMARY=тема, DTSTART из meeting_datetime или ближайший рабочий день 11:00)
|
|
- [x] 3.5 Помечать письмо `handled_urgent` / `handled_task` / `handled_meeting`
|
|
- [x] 3.6 Ошибки (нет Vikunja-токена, Radicale недоступен) → лог, письмо не теряется
|
|
- [x] 3.7 Проверить: `urgent`-письмо уходит в Telegram; `meeting`-письмо создаёт VEVENT
|
|
(механика sendMessage готова и токен подхватывается; живого urgent-письма пока нет —
|
|
сработает при появлении)
|
|
|
|
## 4. Подготовка зависимостей
|
|
|
|
- [x] 4.1 Секреты в `.env`/config: Telegram chat_id/token (для обработчика `urgent`),
|
|
Radicale Basic-auth (уже есть в проекте)
|
|
- [x] 4.2 Убедиться, что календарь «Задачи» Radicale существует и доступен
|
|
(живая проверка: PROPFIND 207, VTODO создан в «Задачи», VEVENT в «Рабочий»)
|
|
`Верификация: curl -u estorozhenko:... -X PROPFIND -H 'Depth: 0' https://cal.nixg.ru/estorozhenko/<urlencoded Задачи>/`
|
|
|
|
## 5. Cron
|
|
|
|
- [x] 5.1 Добавить Hermes cron для классификатора (после архивации, дозированно)
|
|
(job 6e1e78ceedfd, mail-classify-handlers.sh, каждые 5 мин, лимит 10)
|
|
- [x] 5.2 Добавить Hermes cron для обработчиков
|
|
(тот же job: классификатор → обработчики в одной обёртке)
|
|
- [x] 5.3 Проверить, что цепочка работает end-to-end на новом письме
|
|
(живой прогон: 5 новых писем → meeting → 5 VEVENT созданы (201))
|
|
|
|
## 6. Документация
|
|
|
|
- [ ] 6.1 Обновить STATUS.md: новые скрипты, cron, фронтмэттер поля
|
|
- [ ] 6.2 Зафиксировать доступы (Vikunja token, Telegram) в ресурсах проекта
|