Initial spec: MVP-1 workload + drafts for MVP-2/3/4 + Subsystem D

README.md

@@ -0,0 +1,67 @@
+# bit-flight-deck
+
+Система учёта рабочего времени сотрудников и контроля проектов для проектного отдела.
+
+## Контекст
+
+Инициатива объединяет данные четырёх систем-источников в единое read-only аналитическое хранилище для ответов на главные вопросы руководителя проектного отдела:
+
+- Кто из сотрудников сейчас загружен коммерческими работами?
+- Какие задачи подвисают и тормозят следующие работы?
+- В каком состоянии проекты по срокам, марже, НЗП, актированию?
+- Какой финрезультат у каждого подразделения?
+
+## Системы-источники
+
+| Система | Что в ней мастер | Транспорт |
+|---|---|---|
+| **BIT.RA** (1С на BSP) | Часы, классификация работ, проектная финансовая аналитика, справочник сотрудников | HTTP-сервисы 1С (одноразовая разработка) |
+| **EVA Desk** | Задачи разработчиков/PM, Service Desk, история смены статусов | JSON-RPC pull + глобальный админ-токен |
+| **Битрикс24** | Сделки и прогноз продаж, оргструктура | Outbound webhooks через CF Tunnel + nightly reconcile |
+| **finrez_1c** (самописная 1С) | Месячный финрез по подразделениям (ручной ввод) | HTTP-сервисы 1С (отложено до MVP-4) |
+
+## Архитектура
+
+PostgreSQL + N8N + Metabase + NocoDB. Используется существующая инфра в `~/infrastructure/`:
+- `pipeline_postgres` (PG 15) — создаём отдельную БД `bit_flight_deck`.
+- `n8n` — оркестратор, workflows в существующем контейнере.
+- `pipeline_litellm` — LLM-шлюз (опц. для fuzzy-match имён).
+- `cloudflared` (host-systemd) — публичный поддомен `n8n.bigmadnekenny.ru` для Bitrix webhooks.
+
+Новые сервисы в `~/projects/bit-flight-deck/docker-compose.yml`:
+- **Metabase** — дашборды.
+- **NocoDB** — UI для управления identity_map и весами проектных команд.
+
+## Декомпозиция на MVP
+
+| MVP | Цель | Статус |
+|---|---|---|
+| **MVP-1** | Загрузка сотрудников (4 слоя: факт / текущая / плановая как «осталось» / прогноз из Битрикса) | Spec ready ([docs/superpowers/specs/2026-05-13-mvp1-workload-design.md](docs/superpowers/specs/2026-05-13-mvp1-workload-design.md)) |
+| **MVP-2** | Подвисшие задачи + контроль сроков проектов | Draft ([docs/superpowers/specs/2026-05-13-mvp2-deadlines-design.md](docs/superpowers/specs/2026-05-13-mvp2-deadlines-design.md)) |
+| **MVP-3** | Маржа, НЗП, прогноз актирования | Draft ([docs/superpowers/specs/2026-05-13-mvp3-finance-design.md](docs/superpowers/specs/2026-05-13-mvp3-finance-design.md)) |
+| **MVP-4** | Финрез по подразделениям | Draft, требует отдельного мозгового штурма ([docs/superpowers/specs/2026-05-13-mvp4-finrez-design.md](docs/superpowers/specs/2026-05-13-mvp4-finrez-design.md)) |
+| **Подсистема D** | Компетенции сотрудников (производная из истории работ) | Draft ([docs/superpowers/specs/2026-05-13-subsystem-d-competence-design.md](docs/superpowers/specs/2026-05-13-subsystem-d-competence-design.md)) |
+
+## Принципы
+
+- **Read-only** интеграция. Источники остаются мастерами.
+- **Single-user MVP.** Multi-user — вне scope MVP-1.
+- **Email — главный ключ identity-resolution** для сотрудников между всеми системами.
+- **Вертикальный срез по MVP.** Каждый MVP даёт видимый дашборд за 2-4 недели, не «фундамент на всё».
+- **Компетенции — производные.** Не справочник, а расчёт из истории работ.
+
+## Структура репозитория
+
+```
+docs/superpowers/specs/   — спецификации MVP по очереди
+sql/                       — DDL миграции, views, procedures, seed
+infra/                     — init-скрипты БД, документация по поддоменам CF Tunnel
+n8n/workflows/             — JSON-экспорты workflows
+```
+
+(На MVP-1: создаются по мере реализации.)
+
+## Связанные
+
+- Инфра-репозиторий: `https://gitea.bigmadnekenny.ru/admin/infrastructure`
+- EVA-bot документация (API EVA + SD-проекты): `https://gitea.bigmadnekenny.ru/admin/eva-bot`