Roman Chesnokov
7da9d9dae1
- Configuration.xml: AddOn extension, prefix bfd_, compat Version8_3_14 - CommonModule bfd_IntegrationAPIHelpers (server, privileged): JSON response, ISO date parse, UUID, email extractor, limit parser - HTTPService bfd_IntegrationAPI (rootURL=bfd-api): 11 templates - /v1/health, /v1/employees, /v1/works (+modified_since, +limit) - /v1/projects, /v1/stages, /v1/work_types, /v1/dictionaries - /v1/dept_history (+modified_since), /v1/project_register (+modified_since for MVP-3) - /v1/eva_mapping/projects, /v1/eva_mapping/clients (best-effort from BIT.RA registers) - README with step-by-step instructions for 1C developer - cfe-validate: 0 errors / 0 warnings (13/13 checks)
bit-flight-deck
Система учёта рабочего времени сотрудников и контроля проектов для проектного отдела.
🌟 Общая цель проекта — 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) |
| 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