diff --git a/docs/WORK-SECTION-PLAN.md b/docs/WORK-SECTION-PLAN.md new file mode 100644 index 0000000..8839fe8 --- /dev/null +++ b/docs/WORK-SECTION-PLAN.md @@ -0,0 +1,105 @@ +# Раздел «Работа» — модель и план + +Составлено 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` по папкам, или просто перечень тем писем за месяц? Для анализа типов +задач достаточно второго и третьего, а содержимое писем можно и не отдавать.