Files
buryan-infra/ops/work/SECRETARY.md

73 lines
4.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Рабочий секретарь — v2 (напоминания + Nextcloud)
Обновлено 28.10.2026.
## Что нового против v1
1. **Напоминания.** «напомни через 2 часа про #3», «напомни завтра в 10»,
«напомни в пятницу в 9»; список — команда `напоминания`. Напоминание приходит
в комнату и само снимается, если задачу закрыли.
2. **Синхронизация в Nextcloud.** Задачи дублируются как VTODO в календарь-список
**«Работа»** аккаунта `roman` — отдельный аккаунт не заводили, как и просил
владелец: у него будут «Работа», «Дом» и прочие списки в одном месте.
Команда `синк` отправляет все открытые задачи сразу.
3. Промпт агента ужесточён: он трогает только те задачи, о которых идёт речь,
и не подмешивает посторонние (раньше обновлял #1 в каждом действии).
## Как устроена синхронизация
* CalDAV, Basic-auth по app-паролю Nextcloud (`/root/.nextcloud-app-pass`).
* URL: `…/remote.php/dav/calendars/roman/work/`, UID задачи — `work-<id>@buryans.ru`.
* Поля VTODO: SUMMARY (текст), CATEGORIES (тип), DUE (срок), STATUS,
X-BURYANS-ITEM (номер задачи в базе секретаря).
* Создание/правка/закрытие/удаление в Matrix → те же операции в Nextcloud.
## Проверено 28.10.2026
```
«синк» -> «Отправлено в Nextcloud (список «Работа»): 2 из 2»
REPORT по календарю: 2 задачи — «Выдать КП по Vinteo для Кабаков Максим»,
«Разобраться с проектом Ricoh…»
напоминание через 1 минуту -> пришло в комнату
```
## Ловушки
* **Переменные окружения.** `bot.env` читался в словарь, но не в `os.environ`,
поэтому `caldav` видел пустой пароль и молча возвращал 0. Теперь ключи
пробрасываются в окружение, а конфиг CalDAV читается при вызове, не при импорте.
* **`import caldav`** — модуль должен лежать в `/opt/work-hub` рядом с ботом,
иначе служба уходит в цикл перезапуска с `ModuleNotFoundError`.
## Файлы
`ops/work/stack/`: `bot.py`, `agent.py`, `store.py`, `matrix.py`, `parse.py`,
`caldav.py`. Служба `work-secretary.service`, сводки `work-digest.timer`
(08:00 и 18:30), хранилище `/opt/work-hub` (700).
## v3: встречи в календаре (28.10.2026)
Встречи разбираются **детерминированно, без модели**: слово-триггер
(«встреча», «созвон», «приезд», «демо в») + дата/время из фразы
(«в пятницу в 14:00», «завтра в 10»). Создаётся VEVENT в календаре
**«Работа»** того же аккаунта Nextcloud, длительность по умолчанию 1 час.
Почему без модели: на запрос «встреча в пятницу в 14:00…» агент дважды
отвечал «создал», не создав ничего, а затем стал переспрашивать — тянул
лишнее из истории переписки. Для структурированного запроса правило надёжнее.
Проверено: событие в календаре с `DTSTART:20261030T140000`, ответ бота:
«Встреча #5: 30.10 в 14:00 — …».
Задачи (VTODO) остаются на агенте, встречи (VEVENT) — на правилах.
### Ловушки
* Агент пишет «создал», не выполнив действие: его ответ надо логировать.
Теперь сырой JSON пишется в `/var/log/work-agent.jsonl` — по нему видно,
что именно вернула модель.
* Дата из модели может прийти в разных форматах; для встреч добавлен разбор
по нескольким шаблонам, а при неудаче задача всё равно создаётся
(без календаря) и бот честно об этом сообщает.