architect/management/ROADMAP.md

Platform Development Roadmap

Версия: 1.0.0
Дата: 2026-01-02
Горизонт: 22 недели (5 месяцев)


СТРАТЕГИЯ: ПАРАЛЛЕЛЬНОЕ РАЗВИТИЕ

┌─────────────────────────────────────────────────────────────┐
│  ПЛАТФОРМА + ПРОЕКТЫ = ОДНОВРЕМЕННО                         │
│                                                             │
│  Делаем компонент платформы → Сразу используем в проектах  │
└─────────────────────────────────────────────────────────────┘

Принцип

НЕ: Сначала полностью платформа, потом проекты
ДА: Инкрементально — каждый компонент сразу в работу


4 ПАРАЛЛЕЛЬНЫХ ТРЕКА

Track A: INFRASTRUCTURE 🏗️

Кто: Infra Agent
Что: Базовые сервисы платформы
Использование: Сразу для всех проектов

Track B: DEVELOPMENT 🔧

Кто: DevOps Agent (новый)
Что: CI/CD, тесты, качество кода
Использование: Сразу для всех репозиториев

Track C: PROJECT MANAGEMENT 📊

Кто: Projector + Platform UI
Что: Дашборд, трекер задач, документация
Использование: Управление всеми проектами

Track D: BUSINESS PROJECTS 💼

Кто: Специалисты (Business, Technical, PIM)
Что: Бизнес-задачи (OZON, PIM, сайты)
Использование: Используем готовое из A/B/C


ROADMAP ПО НЕДЕЛЯМ

НЕДЕЛЯ 1-2: КРИТИЧЕСКИЙ ФУНДАМЕНТ

Track A: Infrastructure 🏗️

[День 1-2] Restore процесс
  ├─ Документировать процедуру восстановления
  ├─ Протестировать восстановление из backup
  └─ → Использование: Безопасность всех проектов

[День 3-5] Secrets Rotation
  ├─ Скрипт ротации API ключей
  ├─ Документация процесса
  └─ → Использование: Безопасность credentials

Track B: Development 🔧

[День 1-2] Testing Framework
  ├─ Структура pytest (conftest.py, fixtures)
  ├─ Примеры тестов для library/connectors/
  └─  Использование: Тесты для всех новых компонентов

[День 3-5] CI/CD Pipeline (базовый)
  ├─ GitHub Actions: test на каждый push
  ├─ Линтеры (black, ruff) в pipeline
  └─  Использование: Автопроверка всех коммитов

Track C: Project Management 📊

[День 1-3] Task Tracker (persistent)
  ├─ TASKS.yaml структура
  ├─ TodoWrite → сохранение в файл
  └─ → Использование: Сохранение задач между сессиями

[День 4-5] Monitor cron
  ├─ Настроить system/monitor/run.py по расписанию
  ├─ Алерты в Telegram
  └─ → Использование: Автоконтроль здоровья платформы

Track D: Business Projects 💼

[Использует готовое из A/B/C]

[День 1-5] OZON + PIM
  ├─ Тесты для sync_smart.py (Track B)
  ├─ Задачи в TASKS.yaml (Track C)
  └─ Безопасное восстановление при сбоях (Track A)

Итого неделя 1-2: 4 компонента платформы → сразу в работе


НЕДЕЛЯ 3-4: НАБЛЮДАЕМОСТЬ

Track A: Infrastructure 🏗️

[День 1-3] Централизованное логирование
  ├─ Loki + Promtail + Grafana
  ├─ Дашборды для мониторинга
  └─ → Использование: Отладка всех проектов

[День 4-6] Real-time метрики
  ├─ Prometheus + Node Exporter
  ├─ Grafana дашборды (CPU, RAM, Disk)
  └─ → Использование: Контроль ресурсов

Track B: Development 🔧

[День 1-2] Pre-commit Hooks
  ├─ .pre-commit-config.yaml
  ├─ black, ruff, pytest автозапуск
  └─ → Использование: Качество кода перед коммитом

[День 3-4] Code Coverage
  ├─ pytest-cov интеграция
  ├─ CI показывает покрытие
  └─ → Использование: Метрика качества тестов

Track C: Project Management 📊

[День 1-5] Project Dashboard (MVP)
  ├─ Расширить Platform UI: список проектов
  ├─ Статус каждого (active/paused/done)
  ├─ Счётчики задач (pending/in_progress/done)
  └─ → Использование: Обзор всех проектов

Track D: Business Projects 💼

[День 1-6] Pirotehnika
  ├─ Смотрим логи через Loki (Track A)
  ├─ Метрики sync_smart через Prometheus (Track A)
  ├─ Статус проекта в Dashboard (Track C)
  └─ Качество кода через pre-commit (Track B)

Итого неделя 3-4: Наблюдаемость → используем для всех проектов


НЕДЕЛЯ 5-7: УПРАВЛЕНИЕ ПРОЕКТАМИ

Track A: Infrastructure 🏗️

[День 1-3] Redis Cache
  ├─ Docker контейнер Redis
  ├─ Connector в library/connectors/data/redis/
  └─  Использование: Кеширование в проектах

[День 4-5] DB Migrations (платформенные)
  ├─ Alembic для platform_ui
  ├─ Миграции NocoDB схемы
  └─  Использование: Версионирование схем

Track B: Development 🔧

[День 1-3] CI/CD Pipeline (полный)
  ├─ test → build → deploy stages
  ├─ Deploy на dev-pro сервер
  └─ → Использование: Автодеплой при merge в main

Track C: Project Management 📊

[День 1-5] Task Tracker (API + UI)
  ├─ REST API для задач
  ├─ UI в Platform UI: канбан доска
  └─ → Использование: Визуальное управление задачами

[День 6-8] Documentation Versioning
  ├─ Git history для .md файлов
  ├─ UI показывает историю изменений
  └─ → Использование: Видим кто что менял

[День 9-10] Documentation Search
  ├─ Полнотекстовый поиск по docs.0kt.ru
  ├─ Индекс через SQLite FTS
  └─ → Использование: Быстрый поиск информации

Track D: Business Projects 💼

[День 1-10] Lideravto
  ├─ Задачи в новом Task Tracker (Track C)
  ├─ Кеширование через Redis (Track A)
  ├─ Автодеплой через CI/CD (Track B)
  └─ Поиск по документации (Track C)

Итого неделя 5-7: Полноценное управление → сразу для Lideravto


НЕДЕЛЯ 8-10: API И ИНТЕГРАЦИИ

Track A: Infrastructure 🏗️

[День 1-3] API Gateway
  ├─ Traefik как reverse proxy
  ├─ Маршрутизация всех API через единый endpoint
  └─ → Использование: docs.0kt.ru/api/* → все сервисы

[День 4-5] Rate Limiting
  ├─ Traefik middleware для rate limit
  ├─ Защита от DDoS
  └─ → Использование: Безопасность всех API

Track B: Development 🔧

[День 1-2] OpenAPI Spec
  ├─ Автогенерация спецификации из FastAPI
  ├─ Swagger UI на /docs
  └─ → Использование: Документация всех API

[День 3-5] DevOps Agent (новый агент)
  ├─ Контекст деплоя, CI/CD, Docker
  ├─ Интеграция с GitHub Actions
  └─ → Использование: Автоматизация деплоя

Track C: Project Management 📊

[День 1-3] Roadmap Visualization
  ├─ Timeline view проектов
  ├─ Milestones и deadlines
  └─ → Использование: Планирование проектов

Track D: Business Projects 💼

[День 1-8] Интеграции (OZON → 1C → сайты)
  ├─ API через Gateway (Track A)
  ├─ OpenAPI спецификация (Track B)
  ├─ Roadmap синхронизации (Track C)
  └─ Автодеплой через DevOps Agent (Track B)

Итого неделя 8-10: Единая API платформа → используем везде


НЕДЕЛЯ 11-13: БЕЗОПАСНОСТЬ И КАЧЕСТВО

Track A: Infrastructure 🏗️

[День 1-2] Access Audit
  ├─ Логирование всех API запросов
  ├─ Audit log в PostgreSQL
  └─ → Использование: Кто что делал

[День 3-4] CDN
  ├─ CloudFlare для статики
  ├─ Кеширование изображений
  └─ → Использование: Быстрая загрузка сайтов

Track B: Development 🔧

[День 1-3] QA Agent (новый агент)
  ├─ Контекст тестирования
  ├─ Автозапуск тестов перед релизом
  └─ → Использование: Проверка качества

[День 4-5] Vulnerability Scanning
  ├─ Trivy для Docker образов
  ├─ GitHub Dependabot для Python
  └─ → Использование: Автопроверка уязвимостей

Track C: Project Management 📊

[День 1-3] Platform Changelog
  ├─ CHANGELOG.md автогенерация
  ├─ История релизов платформы
  └─ → Использование: Знаем что изменилось

Track D: Business Projects 💼

[День 1-8] Pirotehnika сайты (аудит безопасности)
  ├─ Vulnerability scanning (Track B)
  ├─ Access audit для админки (Track A)
  ├─ QA проверки перед деплоем (Track B)
  └─ CDN для изображений товаров (Track A)

Итого неделя 11-13: Безопасность → все проекты защищены


НЕДЕЛЯ 14-16: ПРОИЗВОДИТЕЛЬНОСТЬ

Track A: Infrastructure 🏗️

[День 1-2] Database Indexes
  ├─ Скрипт анализа запросов
  ├─ Автосоздание недостающих индексов
  └─ → Использование: Быстрые запросы

[День 3-4] Query Optimization
  ├─ pg_stat_statements включён
  ├─ Дашборд медленных запросов
  └─ → Использование: Профилирование SQL

Track B: Development 🔧

[День 1-3] Performance Agent (новый агент)
  ├─ Контекст профилирования
  ├─ Анализ узких мест
  └─ → Использование: Оптимизация кода

Track C: Project Management 📊

[День 1-2] Architecture Diagrams
  ├─ Mermaid диаграммы в документации
  ├─ Автогенерация из кода
  └─ → Использование: Визуализация структуры

Track D: Business Projects 💼

[День 1-8] NocoDB оптимизация
  ├─ Индексы через Track A
  ├─ Профилирование через Track A
  ├─ Redis кеш для частых запросов
  └─ Performance Agent анализ (Track B)

Итого неделя 14-16: Производительность → быстрые проекты


НЕДЕЛЯ 17-19: ДОКУМЕНТАЦИЯ И ОНБОРДИНГ

Track B: Development 🔧

[День 1-3] Onboarding Guide
  ├─ Пошаговая инструкция для новых
  ├─ Видео-туры по платформе
  └─ → Использование: Онбординг новых разработчиков

[День 4-6] Runbooks
  ├─ Инструкции для типовых проблем
  ├─ Troubleshooting гайды
  └─ → Использование: Быстрое решение проблем

Track C: Project Management 📊

[День 1-4] Enhanced Dashboard
  ├─ Метрики здоровья проектов
  ├─ Burndown charts
  └─ → Использование: Глубокая аналитика

Track D: Business Projects 💼

[День 1-8] Content Factory (новый проект)
  ├─ Использует все компоненты платформы
  ├─ Онбординг через Guide (Track B)
  └─ Управление через Dashboard (Track C)

Итого неделя 17-19: Зрелая платформа → легко начинать новые проекты


НЕДЕЛЯ 20-22: РАСШИРЕННЫЕ ВОЗМОЖНОСТИ

Track A: Infrastructure 🏗️

[День 1-3] Webhooks
  ├─ Система событий
  ├─ Подписки на события
  └─ → Использование: Интеграции через события

Track B: Development 🔧

[День 1-3] Security Agent (новый агент)
  ├─ Контекст безопасности
  ├─ Аудит кода и инфраструктуры
  └─ → Использование: Автоматический security review

Track C: Project Management 📊

[День 1-4] Mobile UI (начало)
  ├─ Responsive дизайн Platform UI
  ├─ Touch-friendly интерфейс
  └─ → Использование: Управление с телефона

Track D: Business Projects 💼

[День 1-8] Масштабирование
  ├─ Webhooks для интеграций (Track A)
  ├─ Security audit всех проектов (Track B)
  └─ Мобильное управление (Track C)

Итого неделя 20-22: Расширенная платформа → готовы к масштабу


ИТОГО ROADMAP

По трекам

Track Компонентов Недели
A: Infrastructure 12 1-22
B: Development 11 1-22
C: Project Management 9 1-22
D: Business Projects Все 22 недели 1-22

По фазам

Фаза Недели Фокус Результат
1. Критический фундамент 1-2 Стабильность Безопасное восстановление, тесты, задачи
2. Наблюдаемость 3-4 Контроль Логи, метрики, дашборд
3. Управление проектами 5-7 Продуктивность Трекер, поиск, кеш
4. API и интеграции 8-10 Расширяемость Gateway, OpenAPI, DevOps Agent
5. Безопасность 11-13 Защита Аудит, сканирование, QA Agent
6. Производительность 14-16 Скорость Индексы, профилирование
7. Документация 17-19 Зрелость Онбординг, runbooks
8. Расширения 20-22 Масштаб Webhooks, mobile, security

ПРИНЦИПЫ РЕАЛИЗАЦИИ

1. Инкрементально

НЕ: Сделать полностью компонент  потом использовать
ДА: MVP компонента  сразу в работу  дорабатываем

2. Параллельно

4 трека работают одновременно
├─ Infrastructure: Infra Agent
├─ Development: DevOps Agent (создадим на неделе 8)
├─ Project Management: Projector
└─ Business: Specialists

3. Используем сразу

Каждый компонент после реализации:
├─ Документируем
├─ Тестируем
└─ Используем в проектах (Track D)

4. Итерируем

Неделя N: Создали MVP компонента
Неделя N+1: Используем в проекте
Неделя N+2: Собрали обратную связь → улучшили

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

Еженедельно отслеживаем

Метрика Цель к концу недели
Компонентов реализовано +2-3 компонента
Покрытие тестами +5% (цель 80%)
Использование в проектах Каждый компонент используется
Документация 100% новых компонентов

Milestones

Milestone Неделя Критерий успеха
M1: Стабильность 2 Восстановление работает, тесты запускаются
M2: Наблюдаемость 4 Видим все логи и метрики
M3: Управление 7 Dashboard + трекер работают
M4: API платформа 10 Единый gateway для всех API
M5: Безопасность 13 Аудит + сканирование включены
M6: Производительность 16 Все запросы <100ms
M7: Зрелость 19 Онбординг <1 день
M8: Масштаб 22 Готовы к 10+ проектам

БЫСТРЫЙ СТАРТ

Первая неделя (детально)

День 1

Track A: Restore процесс (документация)
Track B: Testing Framework (структура pytest)
Track C: TASKS.yaml структура
Track D: Тесты для OZON sync

День 2

Track A: Restore процесс (тестирование)
Track B: Testing Framework (примеры тестов)
Track C: TodoWrite → TASKS.yaml
Track D: Используем TASKS.yaml для OZON

День 3

Track A: Secrets Rotation (скрипт)
Track B: CI/CD (GitHub Actions базовый)
Track C: Monitor cron (настройка)
Track D: CI для PIM проекта

День 4

Track A: Secrets Rotation (документация)
Track B: CI/CD (линтеры)
Track C: Monitor cron (алерты)
Track D: Тестируем ротацию OZON API key

День 5

Track A: Secrets Rotation (тестирование)
Track B: CI/CD (тесты в pipeline)
Track C: Monitor проверка
Track D: Все проекты используют новые компоненты

СВЯЗИ


ОБНОВЛЕНИЯ

По мере реализации:
- [ ] Отмечать выполненное
- [ ] Добавлять реальные сроки
- [ ] Корректировать оценки


Версия: 1.0.0