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

74 lines
3.8 KiB
Markdown

# Рабочий секретарь — пробный стек (v0)
Запущен 28.10.2026. Изолирован от домашнего контура.
## Что где
| Компонент | Где |
|---|---|
| Служба | `work-secretary.service` (постоянный цикл) |
| Сводка | `work-digest.timer` — 08:00 и 18:30 |
| Код | `/opt/work-hub/{bot.py,parse.py,store.py,matrix.py}` (700) |
| База | `/opt/work-hub/work.db` |
| Конфиг | `/opt/work-hub/bot.env` (600): пользователь, токен, комната |
| Лог | `/var/log/work-secretary.log` |
| Материалы | `/opt/work-hub/{inbox,docs,mail,analysis}` |
Бот — отдельный пользователь Matrix `@work-secretary:matrix.buryans.ru`,
своя комната, свой токен. Домашние боты о нём не знают.
## Как работает
Пишете в комнату свободным текстом. Секретарь:
1. сохраняет **всё** сообщение дословно в `messages` (это и есть логи для разбора);
2. угадывает тип, партнёра и срок;
3. создаёт задачу и отвечает коротким подтверждением.
Разбор v0 — правила в `parse.py`: типы (пресейл, демо-фонд, ТЗ, техописание,
проект оборудования, прошивка/баг, встреча, внутренняя помощь, прочее),
партнёры (список вендоров), сроки («к пятнице», «до 05.11», «завтра»,
«срочно», «через 3 дня», «концу месяца»).
## Команды
| Что написать | Что будет |
|---|---|
| любой текст | новая задача с разбором |
| `список` | открытые задачи |
| `статус` | коротко: открыто / на сегодня / просрочено |
| `сводка` | полная сводка сейчас |
| `готово 12` | отметить выполненной |
| `перенеси 12 на пятницу` | сменить срок |
| `помощь` | подсказка |
## Сводки
* **08:00** — на сегодня, просрочено, что висит без срока больше 3 дней.
* **18:30** — что сделано за день и что на завтра.
## Как расширять
1. Новые типы и партнёры — в `parse.py` (списки `TYPES`, `PARTNERS`).
2. Новые команды — в `bot.py`, функция `handle()`.
3. Новые сущности (встречи, артефакты) — новые таблицы в `store.py`.
Правило: сначала копим реальные формулировки в `messages`, потом уточняем
правила по фактам, а не по догадкам.
## Проверено 28.10.2026
Прогнано живьём в комнате от имени владельца:
```
«надо подобрать ВКС для трёх переговорок у Neat к пятнице»
-> #1 записал, тип: пресейл, партнёр: Neat, срок: 30.10
«срочно: прошивка на Poly Studio не работает после обновления»
-> #2 записал, тип: прошивка/баг, партнёр: Poly, срок: 28.10
«готово 2» -> отмечено выполненным
«перенеси 1 на понедельник» -> задача #1 теперь на 02.11
«список», «статус», «сводка», «помощь» — отвечают
```
Тестовые записи после проверки удалены: база чистая.