153 lines
11 KiB
Markdown
153 lines
11 KiB
Markdown
# Раздел «Работа» — модель и план
|
||
|
||
Составлено 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/` первым результатом должен быть **список типов задач с реальными
|
||
формулировками** — по нему и проектируем секретаря.
|
||
* Почта разбирается на предмет: кто пишет, о чём просит, в какой форме
|
||
формулирует задачу, что считается «сделано».
|
||
|