# bit-flight-deck

Система учёта рабочего времени сотрудников и контроля проектов для проектного отдела.

> 🌟 **Общая цель проекта — [docs/superpowers/PROJECT_GOAL.md](docs/superpowers/PROJECT_GOAL.md).** Возвращаться к этому документу каждый раз когда фокус сбивается.

## Контекст

Инициатива объединяет данные четырёх систем-источников в единое 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`