docs: add PROJECT_GOAL (north star) + MVP-1 whitelists (employees, SD projects, forecast stages)
This commit is contained in:
Roman Chesnokov
@@ -0,0 +1,95 @@
|
||||
# Project Goal — Северная звезда проекта `bit-flight-deck`
|
||||
|
||||
> **Назначение этого документа:** возвращаться сюда каждый раз когда возникает сомнение «правильно ли мы идём», «куда мы хотим прийти», «что главное». Если фокус сбился — этот файл возвращает на курс.
|
||||
|
||||
## Что мы строим
|
||||
|
||||
Система автоматизации для руководителя проектного отдела ИТ-компании. Объединяет данные 4 учётных систем (BIT.RA, EVA Desk, Битрикс24, самописная финрезная 1С) в единое read-only хранилище и даёт **автоматические ответы** на главные операционные вопросы.
|
||||
|
||||
## Зачем (the Why)
|
||||
|
||||
Сейчас руководитель проектного отдела отвечает на эти вопросы вручную через 3-4 системы + Excel. Это:
|
||||
- не масштабируется (часов в неделе не хватает на сводку);
|
||||
- не даёт прогноза (только реакция постфактум);
|
||||
- даёт ответы с задержкой — часто пропускает критические сигналы вовремя.
|
||||
|
||||
**Цель проекта — автоматизация принятия операционных решений**, освобождение руководителя от ручного сбора данных, проактивная сигнализация о проблемах.
|
||||
|
||||
## К чему хочу прийти (end state, через ~3-6 месяцев)
|
||||
|
||||
1. **Открыл утром дашборд — увидел всё:** кто загружен, кто свободен, какие проекты в риске, какая маржа, что подписывать в следующем месяце, прогноз финреза.
|
||||
2. **Получил уведомление вовремя:** задача подвисла → Telegram-алёрт. Сделка ушла в реализацию без проектной команды → алёрт. Этап просрочен → алёрт.
|
||||
3. **Прогноз вместо реакции:** вижу что через 3 недели у команды X простой, а в Битриксе квалифицированных сделок на Y часов — могу принять решение заранее.
|
||||
4. **Финрез по подразделениям автоматически**, без месячного ручного Excel-сводения.
|
||||
5. **Компетенции команды объективны** — выводятся из истории работ, не из «как сам себя оценил».
|
||||
|
||||
## Главные бизнес-вопросы которым отвечает система
|
||||
|
||||
| Вопрос | MVP / Подсистема |
|
||||
|---|---|
|
||||
| Кто из сотрудников сейчас загружен коммерческими работами? | MVP-1 |
|
||||
| На какой период загружен и до когда? | MVP-1 |
|
||||
| Сколько часов может прилететь из сделок Битрикса? | MVP-1 |
|
||||
| Какие задачи подвисают и тормозят следующие работы? | MVP-2 |
|
||||
| В каком состоянии проекты по срокам, с декомпозицией до задачи? | MVP-2 |
|
||||
| Какая маржа проектов (план/факт)? | MVP-3 |
|
||||
| Сколько НЗП (незавершёнки) на проектах? | MVP-3 |
|
||||
| Сколько денег будем актировать в следующем месяце? | MVP-3 |
|
||||
| Какой финрез у каждого подразделения? | MVP-4 |
|
||||
| Прогноз финреза на основе загрузки? | MVP-4 |
|
||||
| Кто из сотрудников реально что умеет (компетенции)? | Подсистема D |
|
||||
|
||||
## Принципы (используются для разрешения спорных решений)
|
||||
|
||||
1. **Автоматизация, не digital Excel.** Если вижу таблицу которую пользователь должен фильтровать руками — это не цель. Дашборд = ответы без фильтрации.
|
||||
|
||||
2. **Read-only из источников.** Не строим параллельный учёт, не вводим данные дважды. Источники остаются мастерами.
|
||||
|
||||
3. **Email — главный ключ identity** между всеми системами. Если в каком-то источнике email пуст — это организационная задача дозаполнить, а не повод писать сложный fuzzy-маппер.
|
||||
|
||||
4. **Вертикальный срез по MVP.** Каждый MVP за 2-4 недели даёт **видимый дашборд + алёрты**, не «фундамент на 3 месяца без результата». Если MVP не даёт ответа на конкретный бизнес-вопрос — нужно либо переосмыслить MVP, либо запретить запускать.
|
||||
|
||||
5. **Компетенции — производная.** Из реальных работ (`core.work_log`), не из ручного справочника. Ручные справочники компетенций — антипаттерн.
|
||||
|
||||
6. **Single-user MVP.** Multi-user, RLS, персональные дашборды — вне scope. Когда понадобится — будет отдельный проект.
|
||||
|
||||
7. **Используем существующую инфру.** PostgreSQL, N8N, Cloudflare Tunnel, LiteLLM, Gitea — всё это уже стоит в `~/infrastructure/`. Не дублируем.
|
||||
|
||||
## Возврат к этому документу — checklist «фокус не сбился»
|
||||
|
||||
Признаки **сбившегося фокуса** (пора открыть этот файл и пересверить):
|
||||
|
||||
- ✖ Обсуждаем "крутую техническую вещь" которая не отвечает ни на один из 11 бизнес-вопросов выше.
|
||||
- ✖ Строим инфраструктуру "на вырост" без видимого MVP за 2-4 недели.
|
||||
- ✖ Возвращаемся к ручной фильтрации таблиц вместо автоматических ответов.
|
||||
- ✖ Углубляемся в один источник, теряя картину всех 4 (или общую цель).
|
||||
- ✖ Проектируем фичу для воображаемых будущих пользователей вместо одного руководителя проектного отдела.
|
||||
- ✖ Пытаемся синхронизировать что-то "потому что можно", а не потому что нужно для бизнес-вопроса.
|
||||
- ✖ Создаём ручной справочник там где можно вывести из данных.
|
||||
|
||||
Если хоть один пункт совпадает — пауза, откат, чтение этого файла, переоценка.
|
||||
|
||||
## Roadmap высокоуровневый
|
||||
|
||||
| MVP/Phase | Бизнес-выход | Спек |
|
||||
|---|---|---|
|
||||
| MVP-1 | Дашборд загрузки сотрудников (4 слоя) | [specs/2026-05-13-mvp1-workload-design.md](specs/2026-05-13-mvp1-workload-design.md) |
|
||||
| MVP-2 | Подвисшие задачи + контроль сроков + Telegram-алёрты | [specs/2026-05-13-mvp2-deadlines-design.md](specs/2026-05-13-mvp2-deadlines-design.md) |
|
||||
| MVP-3 | Маржа, НЗП, прогноз актирования | [specs/2026-05-13-mvp3-finance-design.md](specs/2026-05-13-mvp3-finance-design.md) |
|
||||
| MVP-4 | Финрез по подразделениям (с отдельным мозговым штурмом) | [specs/2026-05-13-mvp4-finrez-design.md](specs/2026-05-13-mvp4-finrez-design.md) |
|
||||
| Subsystem D | Компетенции команды как производная из истории работ | [specs/2026-05-13-subsystem-d-competence-design.md](specs/2026-05-13-subsystem-d-competence-design.md) |
|
||||
|
||||
## Что вне scope (никогда, или не в этом проекте)
|
||||
|
||||
- ❌ Замена BIT.RA / EVA / Битрикса. Это **аналитический слой поверх**, не новая ERP.
|
||||
- ❌ Multi-user интерфейс. Пользователь один — Руководитель проектного отдела.
|
||||
- ❌ Расширение функционала источников. Если что-то нужно добавить в BIT.RA / EVA — это отдельные задачи, не часть этого проекта.
|
||||
- ❌ Mobile app, web frontend для сотрудников. Метабейс + NocoDB через браузер — достаточно.
|
||||
- ❌ Алгоритмы предсказания на ML/AI до тех пор, пока не разберёмся со статистикой простыми SQL.
|
||||
|
||||
## Связанные документы
|
||||
|
||||
- **Спеки MVP** — в [specs/](specs/).
|
||||
- **План реализации MVP-1** — в [plans/2026-05-13-mvp1-workload.md](plans/2026-05-13-mvp1-workload.md).
|
||||
- **Конфигурация MVP-1** (whitelist'ы сотрудников, SD-проектов, стадий) — в [specs/mvp1-config.md](specs/mvp1-config.md).
|
||||
- **Декомпозиция и архитектурные решения** — в memory-системе агента (`project_workload_control`, `architecture_*`, `feedback_*`).
|
||||
Reference in New Issue
Block a user