architect/management/GAPS.md

Анализ недостающих компонентов платформы

Версия: 1.0.0
Дата: 2026-01-02
Статус: Анализ текущего состояния

EXECUTIVE SUMMARY

Всего не хватает: 47 компонентов

Приоритет Количество Статус
🔴 CRITICAL 15 Блокируют стабильность
🟡 HIGH 17 Снижают продуктивность
🟢 MEDIUM 11 Улучшают качество
🔵 LOW 4 Будущее развитие

Время на минимальную стабильность: 4-6 недель (8 CRITICAL компонентов)
Время на полноценную платформу: 8-10 недель (32 компонента CRITICAL+HIGH)

✅ ЧТО УЖЕ РАБОТАЕТ

Сервисы (systemd)

file-share.service        ← Публикация файлов
upload-service.service    ← Загрузка в inbox

Cron задачи

OZON sync                 ← Каждые 2 часа
NocoDB monitor            ← Каждые 5 минут
NocoDB backup             ← 03:00 ежедневно
Golden backup             ← 04:00 воскресенье

Инфраструктура

Серверы:      beget-kondurov, dev-pro, beget-feyerverk
Хранилища:    beget-s3 (S3), yandex-disk
Приложения:   NocoDB, Wiki.js, Platform UI
Мониторинг:   Telegram (@aiproektor_bot)

Методология

architect/
├── theory/          ✅ LOCKED (v3.1.0)
├── concept/         ✅ Готово (v5.0.0)
├── standards/       ✅ Готово (частично)
├── patterns/        ⚠️  Мало паттернов
└── templates/       ✅ Готово

Агенты

Системные:     Dispatcher, Projector, Librarian
Специалисты:   Business, Technical, PIM, 1C, Marketing, Data
Исполнители:   Coder, Infra, Analyst, Integrator

Ресурсы (library/)

connectors/api/      ozon, telegram, 1c
connectors/data/     postgres, nocodb
connectors/storage/  s3, yandex-disk

❌ БЛОК 1: РАЗРАБОТКА И КАЧЕСТВО

# Компонент Что не хватает Приоритет Время
1 Testing Framework pytest структура, unit/integration тесты 🔴 CRITICAL 2д
2 CI/CD Pipeline GitHub Actions: test → build → deploy 🔴 CRITICAL 3д
3 Code Quality Linters (pylint, black, ruff) 🟡 HIGH 1д
4 Pre-commit Hooks Автопроверки перед коммитом 🟡 HIGH 1д
5 Code Coverage Измерение покрытия тестами 🟢 MEDIUM 1д

Последствия: Регрессии, баги в production, несогласованный код.

Итого блок: 8 дней

❌ БЛОК 2: ОПЕРАЦИИ И МОНИТОРИНГ

# Компонент Что не хватает Приоритет Время
6 Централизованное логирование Loki + Promtail + Grafana 🔴 CRITICAL 3д
7 Real-time метрики Prometheus + Node Exporter + Grafana 🔴 CRITICAL 3д
8 Monitor cron Настроить по system/monitor/CLAUDE.md 🟡 HIGH 0.5д
9 Alerting Escalation rules, email fallback 🟡 HIGH 1д
10 Tracing Distributed tracing (Jaeger) — опционально 🟢 MEDIUM 2д

Последствия: Поздно узнаём о проблемах, сложно дебажить.

Итого блок: 9.5 дней (без tracing: 7.5д)

❌ БЛОК 3: ДАННЫЕ И БЕКАПЫ

# Компонент Что не хватает Приоритет Время
11 Restore процесс Документация + тестирование восстановления 🔴 CRITICAL 2д
12 DB Migrations Платформенные миграции (Alembic) 🟡 HIGH 2д
13 Data Validation Автопроверки качества данных 🟢 MEDIUM 2д
14 Data Catalog Метаданные о данных (что где лежит) 🟢 MEDIUM 3д

Последствия: Риск потери данных, невозможность восстановить систему.

Итого блок: 9 дней (CRITICAL: 2д)

❌ БЛОК 4: БЕЗОПАСНОСТЬ

# Компонент Что не хватает Приоритет Время
15 Secrets Rotation Автоматическая ротация API ключей 🔴 CRITICAL 2д
16 Access Audit Логирование действий пользователей 🟡 HIGH 2д
17 Rate Limiting Защита от DDoS/abuse 🟡 HIGH 1д
18 WAF Web Application Firewall 🟢 MEDIUM 2д
19 Vulnerability Scanning Автопроверка зависимостей (Snyk/Trivy) 🟢 MEDIUM 1д

Последствия: Уязвимости, возможная утечка данных.

Итого блок: 8 дней (CRITICAL: 2д)

❌ БЛОК 5: УПРАВЛЕНИЕ ПРОЕКТАМИ

# Компонент Что не хватает Приоритет Время
20 Project Dashboard Визуализация статуса всех проектов 🔴 CRITICAL 5д
21 Task Tracker Persistent TASKS.yaml + API + UI 🔴 CRITICAL 5д
22 Documentation Versioning История изменений .md через Git 🟡 HIGH 2д
23 Documentation Search Полнотекстовый поиск по документации 🟡 HIGH 3д
24 Roadmap Visualization Визуализация планов проектов 🟢 MEDIUM 3д

Последствия: Теряем контекст между сессиями, нет обзора.

Итого блок: 18 дней (CRITICAL: 10д)

❌ БЛОК 6: API И ИНТЕГРАЦИИ

# Компонент Что не хватает Приоритет Время
25 API Gateway Единая точка входа (Kong/Traefik) 🟡 HIGH 3д
26 OpenAPI Spec Спецификация всех API 🟡 HIGH 2д
27 API Versioning /v1/, /v2/ в путях 🟢 MEDIUM 1д
28 Webhooks События для интеграций 🟢 MEDIUM 3д
29 GraphQL Альтернатива REST 🔵 LOW 5д

Последствия: Сложно интегрировать внешние системы.

Итого блок: 14 дней (HIGH: 5д)

❌ БЛОК 7: ПРОИЗВОДИТЕЛЬНОСТЬ

# Компонент Что не хватает Приоритет Время
30 Redis Cache Кеширование данных 🟡 HIGH 2д
31 CDN Раздача статики через CDN 🟡 HIGH 1д
32 Database Indexes Автопроверка индексов 🟢 MEDIUM 1д
33 Query Optimization Профилирование SQL (pg_stat_statements) 🟢 MEDIUM 2д
34 Load Balancer Отказоустойчивость (Nginx/HAProxy) 🔵 LOW 3д

Последствия: Медленные запросы, downtime при нагрузке.

Итого блок: 9 дней (HIGH: 3д)

❌ БЛОК 8: ДОКУМЕНТАЦИЯ

# Компонент Что не хватает Приоритет Время
35 API Documentation Автогенерация (Swagger/Redoc) 🟡 HIGH 2д
36 Architecture Diagrams Визуальные диаграммы (Mermaid) 🟢 MEDIUM 2д
37 Onboarding Guide Пошаговый гайд для новых 🟢 MEDIUM 3д
38 Platform Changelog История изменений платформы 🟢 MEDIUM 1д
39 Runbooks Инструкции для типовых проблем 🟢 MEDIUM 3д

Последствия: Сложно онбордить новых разработчиков.

Итого блок: 11 дней (HIGH: 2д)

❌ БЛОК 9: АГЕНТЫ (расширение)

# Агент Зачем нужен Приоритет Время
40 DevOps Agent Деплой, CI/CD, инфраструктура 🟡 HIGH 3д
41 QA Agent Тестирование, проверки качества 🟡 HIGH 3д
42 Security Agent Аудит, сканирование уязвимостей 🟢 MEDIUM 3д
43 Performance Agent Профилирование, оптимизация 🟢 MEDIUM 3д

Итого блок: 12 дней (HIGH: 6д)

❌ БЛОК 10: NICE TO HAVE

# Компонент Описание Приоритет Время
44 Mobile UI Мобильная версия Platform UI 🔵 LOW 7д
45 Offline Mode PWA с offline работой 🔵 LOW 5д
46 Feature Flags A/B тесты, постепенный rollout 🔵 LOW 3д
47 Email Notifications Альтернатива Telegram 🔵 LOW 2д

Итого блок: 17 дней

ИТОГО ПО ПРИОРИТЕТАМ

Приоритет Компонентов Дней работы
🔴 CRITICAL 8 24 дня (~5 недель)
🟡 HIGH 17 36 дней (~7 недель)
🟢 MEDIUM 18 35 дней (~7 недель)
🔵 LOW 4 17 дней (~3.5 недели)
ВСЕГО 47 112 дней (~22 недели)

ИТОГО ПО БЛОКАМ

Блок CRITICAL HIGH MEDIUM LOW Итого дней
1. Разработка и качество 2д 2д 1д — 8д
2. Операции и мониторинг 6д 1.5д 2д — 9.5д
3. Данные и бекапы 2д 2д 5д — 9д
4. Безопасность 2д 3д 3д — 8д
5. Управление проектами 10д 5д 3д — 18д
6. API и интеграции — 5д 4д 5д 14д
7. Производительность — 3д 3д 3д 9д
8. Документация — 2д 9д — 11д
9. Агенты — 6д 6д — 12д
10. Nice to have — — — 17д 17д
ИТОГО 24д 36д 35д 17д 112д

КРИТИЧЕСКИЙ ПУТЬ (МИНИМУМ)

Для стабильной работы платформы нужны 8 CRITICAL компонентов:

1. Testing Framework         (2д)
2. CI/CD Pipeline            (3д)
6. Централизованное логи     (3д)
7. Real-time метрики         (3д)
11. Restore процесс          (2д)
15. Secrets Rotation         (2д)
20. Project Dashboard        (5д)
21. Task Tracker             (5д)

Итого: 24 рабочих дня = 5 недель

РЕКОМЕНДАЦИИ

Фаза 1: Стабильность (5 недель)

Реализовать все CRITICAL компоненты.

Фаза 2: Продуктивность (7 недель)

Добавить все HIGH компоненты.

Фаза 3: Качество (7 недель)

Добавить все MEDIUM компоненты.

Фаза 4: Будущее (3.5 недели)

Добавить LOW компоненты по необходимости.

ССЫЛКИ

Версия: 1.0.0