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
@@ -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 стадии Битрикса.