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

11 KiB
Raw Blame History

Раздел «Работа» — модель и план

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