Files
buryan-infra/docs/WORK-SECTION-PLAN.md

153 lines
11 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.
# Раздел «Работа» — модель и план
Составлено 28.10.2026 по ответам владельца. Это проект устройства раздела,
код ещё не писан.
## Кто и что
**Роль:** пресейл / технический эксперт по ВКС, телефонии, местами мультимедиа.
Частично продакт-менеджер. Помогает коллегам по этим направлениям.
**Чем занимается (из его слов):**
1. Демо-фонд оборудования (что есть, где, в каком состоянии).
2. Подбор решений под задачу заказчика.
3. Документация и ТЗ.
4. Очные встречи.
5. Работа с прошивками и багами железа.
6. Написание технических описаний.
7. Составление проектов оборудования.
8. «И гораздо больше».
**Ограничение:** среда защищённая. Живые интеграции с почтой и мессенджерами
нежелательны — ввод **вручную через бота**. Владелец может выгрузить почту
файлом (mbox/eml) для офлайн-разбора — это допустимо и полезно, но только как
разовый анализ, не как постоянная синхронизация.
**Изоляция:** отдельное пространство, свои боты, свои доступы. Рабочее не
попадает в домашние сводки и в общие чаты.
## Модель данных
Единица работы — не одна, а четыре слоя. Они не конфликтуют, а вкладываются:
```
Клиент (заказчик)
└── Проект (пресейл/внедрение, свой срок и контекст)
├── Задача (что сделать, срок, статус)
├── Встреча (когда, с кем, итог)
├── Артефакт (ТЗ, техописание, проект оборудования, файл)
└── Запись времени (сколько ушло)
Смена / день — обёртка: что сделано сегодня, что переносится
```
Сущности и минимум полей:
| Сущность | Поля |
|---|---|
| Клиент | имя, контакт, заметки, активность |
| Проект | название, клиент, стадия, срок, приоритет, контекст (ссылки, решения) |
| Задача | формулировка, проект, срок, статус, оценка, «ждёт ответа от» |
| Встреча | дата/время, участники, проект, итог, follow-up-задачи |
| Артефакт | тип (ТЗ/описание/проект/иное), проект, версия, файл, статус |
| Демо-фонд | оборудование, модель, прошивка, где лежит, состояние, на ком |
| Время | задача/проект, минуты, дата, комментарий |
Статусы задачи: `новая → в работе → ждёт (кого/чего) → сделана`, плюс `отложена`.
Стадии проекта: `пресейл → согласование → поставка/внедрение → поддержка → закрыт`.
## Как это выглядит в работе
**Ввод (бот в пространстве «Работа»):**
```
/задача Купить демо-комплект Poly Studio — проект X, до 05.11
/встреча завтра 14:00 «Клиент N» — демо ВКС
/артефакт ТЗ на ВКС для N — проект X
/время 40м задача 17
/статус — что сегодня, что горит
```
Ввод короткий: если проект не указан, задача падает в «Входящие» и разбирается
утром.
**Утро (08:30):** короткая сводка в рабочий чат — сегодняшние встречи, что
просрочено, что «ждёт ответа» дольше 3 дней, что зависло без движения.
**Вечер (18:30, опционально):** «что сделано за день», перенос незакрытого.
**Неделя:** отчёт по проектам — что двигалось, где стоим, что требует решения.
Для клиента — версия без внутренних заметок.
## Этапы
| Этап | Что входит | Зачем именно так |
|---|---|---|
| 1. Ядро | клиенты, проекты, задачи, статусы; бот `/задача`, `/список`, `/статус`; утренняя сводка | 80% пользы при минимуме кода; сразу видно, хватает ли модели |
| 2. Контекст | встречи, артефакты, заметки по проектам, демо-фонд | перестаёт болеть «где лежит ТЗ и что мы решили» |
| 3. Время и отчёты | `/время`, недельный отчёт, заготовка счёта | нужно для отчётности, но только после того, как задачи реально ведутся |
| 4. Офлайн-разбор почты | выгрузка mbox → классификация: какие типы задач реально приходят | уточняет модель по фактам, без постоянной интеграции |
## Что решить до кода
1. **Где живёт хранилище** — отдельная SQLite в изолированном каталоге
(`/opt/work-hub/work.db`), свой бот, свой systemd-юнит.
2. **Идентификаторы** — короткие (`X-17`) для ссылок в чате и в заметках.
3. **Кто видит** — только владелец; при необходимости отдельный пользователь
Matrix, не общий бот хаба.
4. **Что делать с «гораздо больше»** — модель расширяемая: новая сущность
добавляется, не ломая задачи.
## Открытый вопрос владельцу
Выгрузка почты для этапа 4: в каком виде удобнее — mbox целиком, отдельные
`.eml` по папкам, или просто перечень тем писем за месяц? Для анализа типов
задач достаточно второго и третьего, а содержимое писем можно и не отдавать.
---
## Уточнение 28.10.2026 (вечер): дистрибьюция, партнёры, изоляция
**Контекст.** Владелец работает в **дистрибьюторе OCS** (VKS, телефония,
мультимедиа). Значит модель переворачивается:
* **Партнёры — первичны.** Именно они видны в задачах и переписке: вендоры
(производители оборудования) и партнёры-реселлеры.
* **Заказчики — вторичны.** Их не выделяем в отдельную сущность первого класса:
заказчик живёт как поле у проекта или как упоминание в задаче.
### Что нужно построить
1. **Рабочий секретарь** — отдельный бот, как домашний, но изолированный:
своё пространство Matrix, свой пользователь, своя база, никаких пересечений
с домашними сводками и уведомлениями.
2. **Агенты по направлениям** — та же логика, что в домашнем рое: приём,
разбор, подготовка черновиков, напоминания. Изоляция та же.
3. **Архивный контур** — «разобрать истории, актуализировать, навести порядок».
У владельца нет на это времени; это отдельная работа для агентов:
старые документы и переписка → структурированные карточки (партнёр, проект,
тип задачи, итог).
### Типы задач (стартовый перечень, уточняется по документам)
| Тип | Суть |
|---|---|
| Пресейл-запрос | партнёр просит подобрать решение под задачу |
| Подбор решения | сравнение вендоров/моделей, обоснование |
| Демо-фонд | выдать/вернуть/настроить оборудование |
| Документация и ТЗ | написать, обновить, согласовать |
| Техописание | описание решения для партнёра/тендера |
| Проект оборудования | состав, совместимость, лицензии |
| Прошивки и баги | воспроизвести, зафиксировать, эскалировать вендору |
| Встреча | демо, обучение, разбор с партнёром |
| Внутренняя помощь | коллегам по направлениям |
### Что это меняет в хранилище
* В `docs/` появляется деление по партнёрам, а не по заказчикам.
* В `analysis/` первым результатом должен быть **список типов задач с реальными
формулировками** — по нему и проектируем секретаря.
* Почта разбирается на предмет: кто пишет, о чём просит, в какой форме
формулирует задачу, что считается «сделано».