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)
MVP-2	Подвисшие задачи + контроль сроков проектов	Draft (docs/superpowers/specs/2026-05-13-mvp2-deadlines-design.md)
MVP-3	Маржа, НЗП, прогноз актирования	Draft (docs/superpowers/specs/2026-05-13-mvp3-finance-design.md)
MVP-4	Финрез по подразделениям	Draft, требует отдельного мозгового штурма (docs/superpowers/specs/2026-05-13-mvp4-finrez-design.md)
Подсистема D	Компетенции сотрудников (производная из истории работ)	Draft (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

5.1 KiB Raw Blame History Unescape Escape