Roman Chesnokov
70 lines
5.4 KiB
Markdown
70 lines
5.4 KiB
Markdown
# 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`
|