docs: add PROJECT_GOAL (north star) + MVP-1 whitelists (employees, SD projects, forecast stages)

2026-05-13 20:02:27 +05:00
parent ff1db85d7c
commit 7b282af5be
7 changed files with 262 additions and 6 deletions
@@ -454,15 +454,17 @@ Materialized views, обновляемые после каждой пачки sy
 - **Дисциплина EVA**: внедрить в команде заполнение `plan_start_date` / `plan_end_date` / `deadline` / `responsible_id` для всех новых задач. Через 2-3 месяца — пересмотр MVP-1 с честной «плановой» через plan_start_date.
 - **Email во всех системах**: дозаполнить email сотрудников в BIT.RA `Catalog.Пользователи` где пусто. Аналогично в Битриксе для новых юзеров.

-## 13. Open questions / TODO
+## 13. Open questions / TODO — закрыто (2026-05-13)

 - ✅ **Имя проекта** — `bit-flight-deck`. Gitea-репозиторий `bit-flight-deck`. Локальная папка `~/projects/bit-flight-deck/`.
 - ✅ **Поддомен для Bitrix-webhooks** — `n8n.bigmadnekenny.ru`. Добавить ingress-роут в cloudflared `host-systemd`.
- **Список ~20 сотрудников MVP-1.** Какие конкретно email/department-id попадают в фокус? До начала разработки — выписать явный whitelist.
- **3 SD-проекта.** Извлечь точные ID/коды из `https://gitea.bigmadnekenny.ru/admin/eva-bot/docs/`.
- **Стадии Битрикса для прогноза.** Подтвердить точный список стадий CAT=16, в которых сделка должна учитываться в прогнозе. Кандидаты: `FINAL_INVOICE` («Защита сделки»), `UC_A02TUT` («Отложено»), `UC_U68WK1` («Подготовка рамочного договора»). Стадии `UC_XPZ8Z5/UC_QYTFP3` (Реализация) — туда уже EVA, в прогноз НЕ включаем.
- **Заполняемость email в BIT.RA.** Через MCP проверить какой % пользователей имеет email в `КонтактнойИнформации`. Если ниже 80% — параллельная организационная задача.
- **Распределение часов сделки по проектной команде.** Базовая логика — поровну между членами команды. Веса можно править в NocoDB. Возможно нужна более умная логика (по компетенциям) — это backlog для подсистемы D.
+- ✅ **Список сотрудников MVP-1** — 15 email подтверждены пользователем + 1 TBA. Полный список в [mvp1-config.md](mvp1-config.md). Применяется через `sql/seed/mvp1_target_employees.sql`.
+- ✅ **3 SD-проекта EVA** — `pbsd`, `sd-perm`, `sd-czentralnyj`. Применяется через `sql/seed/sd_projects_whitelist.sql`.
+- ✅ **Стадии Битрикса CAT=16 для прогноза** — `C16:UC_A2446J` (Оценка и подготовка КП), `C16:FINAL_INVOICE` (Защита сделки), `C16:UC_U68WK1` (Подготовка рамочного договора). Применяется через `sql/seed/bitrix_forecast_stages.sql`. `UC_A02TUT` (Отложено) и стадии Реализации **НЕ включены** (двойной счёт с EVA).
+- ✅ **Заполняемость email в BIT.RA** — пользователь подтверждает «все заполнены или будут заполнены к запуску MVP-1». Через MCP не проверяемо, но это организационная гарантия. ETL пишем в предположении что email есть.
+
+Остающиеся внутренние:
+- **Распределение часов сделки по проектной команде.** Базовая логика — поровну между членами команды. Веса можно править в NocoDB. Более умная логика (по компетенциям) — backlog для Подсистемы D.

 ## 14. Backlog после MVP-1

@@ -0,0 +1,68 @@
+# MVP-1 Configuration — Whitelists и точные коды
+
+> **Назначение:** конкретные значения для конфигурации MVP-1. Меняются по мере добавления/удаления сотрудников, проектов, стадий. Не зашиваем в спеку (она про дизайн), а живут здесь — отдельным конфигом. SQL-файлы в `sql/seed/` импортируют эти значения.
+
+## Сотрудники MVP-1 — whitelist по email
+
+Команда РП-2 и связанные. Перечень от пользователя на 2026-05-13.
+
+| # | Email |
+|---|---|
+| 1 | `AleUZhukov@1cbit.ru` |
+| 2 | `AKPetyanina@1cbit.ru` |
+| 3 | `AAGevorgyan@1cbit.ru` |
+| 4 | `AAPrilukov@1cbit.ru` |
+| 5 | `VVGaspirovich@1cbit.ru` |
+| 6 | `VDKhaldin@1cbit.ru` |
+| 7 | `VUKozlov@1cbit.ru` |
+| 8 | `GATokareva@1cbit.ru` |
+| 9 | `DSBulychev@1cbit.ru` |
+| 10 | `dmvmikhaylov@1cbit.ru` |
+| 11 | `EASenik@1cbit.ru` |
+| 12 | `ZGalihanova@1cbit.ru` |
+| 13 | `IAGadzhiev@1cbit.ru` |
+| 14 | `LAYagudina@1cbit.ru` |
+| 15 | `SYaMamedbakova@1cbit.ru` |
+| 16 | (TBA — будет добавлен) |
+
+Применение: см. `sql/seed/mvp1_target_employees.sql`.
+
+## SD-проекты EVA — явный список
+
+Известны через URL в EVA (предоставлены пользователем):
+
+| EVA Project code | URL | Описание |
+|---|---|---|
+| `pbsd` | https://firstbit.evateam.ru/project/Project/pbsd | Центр поддержки офиса Екатеринбург Проектный центр |
+| `sd-perm` | https://firstbit.evateam.ru/project/Project/sd-perm | SD Пермь |
+| `sd-czentralnyj` | https://firstbit.evateam.ru/project/Project/sd-czentralnyj | SD Центральный |
+
+Эти 3 проекта — единственные SD-проекты. Все остальные `CmfProject` — обычные PM-проекты, даже если `enable_sdesk` пустое.
+
+Применение: см. `sql/seed/sd_projects_whitelist.sql`.
+
+## Стадии Битрикса CAT=16 для прогнозной загрузки
+
+| STAGE_ID (полный) | NAME | Используется в прогнозе |
+|---|---|---|
+| `C16:UC_A2446J` | Оценка и подготовка КП | ✅ |
+| `C16:FINAL_INVOICE` | Защита сделки | ✅ |
+| `C16:UC_U68WK1` | Подготовка рамочного договора | ✅ |
+
+Не включаем в прогноз:
+- Более ранние стадии (NEW «Wish-List», PREPARATION «Проработка», PREPAYMENT_INVOIC «Квалификация», EXECUTING «Уточнение требований») — слишком ранняя стадия, ещё не подтверждено что будет проект.
+- `UC_A02TUT` «Отложено» — пауза, неопределённость, не считаем загрузку.
+- `UC_XPZ8Z5` «Реализация первого этапа проекта», `UC_QYTFP3` «Реализация проекта» — это уже **фактическая загрузка через EVA**, не прогноз (двойной счёт нельзя).
+- `WON`, `LOSE`, `APOLOGY` — закрытые, не считаем.
+
+Применение: см. `sql/seed/bitrix_forecast_stages.sql`.
+
+## Email в BIT.RA — статус
+
+**От пользователя:** через MCP проверить невозможно, но email сотрудников **все заполнены или будут заполнены к моменту запуска MVP-1**. Это организационная гарантия — на ETL пишем код в предположении что email есть для всех целевых сотрудников.
+
+Fallback (если кто-то всё-таки без email): запись в `core.identity_map` с `confidence='manual'`, ждёт ручного разрешения через NocoDB.
+
+## История изменений
+
+- **2026-05-13:** первая версия. 15 email + 1 TBA. 3 SD-проекта. 3 стадии Битрикса.