Phase 4.7: Модульный startup + shutdown + deployment modes

[ShaerWare]

Parent

Часть Phase 4 декомпозиции orchestrator.py: #494

Sub-issues

• Phase 4.7a: Доменные startup-функции + graceful shutdown #580 — Phase 4.7a: Доменные startup-функции + graceful shutdown
• Phase 4.7b: Модульная инициализация сервисов + удаление глобалов #581 — Phase 4.7b: Модульная инициализация сервисов + удаление глобалов

Цель

Финальная сборка: заменить монолитный startup/shutdown модульной инициализацией. orchestrator.py ≤ 200 строк.

Что сделать

Модульный startup

Заменить 394-строчный startup_event() на модульную инициализацию:

• Каждый модуль реализует async def init(container) или create_service()
• Orchestrator вызывает init() по графу зависимостей:
  1. core (DB, auth, config, roles, workspace)
  2. knowledge, llm, speech (фундаментальные сервисы)
  3. chat (зависит от knowledge + llm)
  4. channels, kanban, claude_code (зависят от chat)
  5. crm, ecommerce, sales (зависят от knowledge + chat)
  6. monitoring, admin

Graceful shutdown

Заменить однострочный shutdown_database():

async def shutdown():
    await task_registry.cancel_all(timeout=10)
    await channels.stop_all_bots()
    await bridge.stop()
    await db.close()

Deployment modes

Заменить 9 scattered if-statements на загрузку модулей по mode:

MODULES = {
    "full":  [core, knowledge, llm, speech, chat, channels, ...],
    "cloud": [core, knowledge, llm, chat, channels, ...],  # без speech, telephony
    "local": [core, knowledge, llm, speech, chat, channels, ...],
}

Целевой orchestrator.py (~100-200 строк):

• FastAPI app creation
• Middleware (CORS, rate limiter, security headers)
• Module loading по deployment mode
• Startup/shutdown lifecycle
• Vue admin mount + main

Нюансы

• ServiceContainer timing — роутеры получают сервисы через Depends(get_container). Container должен быть полностью заполнен до первого запроса. FastAPI lifespan гарантирует это
• Helper-функции (_seed_system_roles, _seed_default_workspace, _auto_start_telegram_bots, etc.) — должны быть перенесены в домены к этому моменту
• Условная регистрация роутеров — часть роутеров (speech, gsm, finetune) не нужны в cloud mode
• DEV_MODE Vite proxy — оставить в orchestrator.py
• Обратная совместимость — orchestrator:app используется в uvicorn.run() и Docker CMD

Зависимости

• Blocked by: Phase 4.1: StreamingTTSManager → modules/speech/streaming.py #546 (4.1), Phase 4.2: Widget public endpoints → modules/channels/widget/ #547 (4.2), Phase 4.3: Legacy /v1/* + core endpoints → modules/compat/router.py #548 (4.3), Phase 4.4: Admin finetune endpoints → domain modules #549 (4.4), Phase 4.5: Оставшиеся admin endpoints → domain routers #550 (4.5), Phase 4.6: Background tasks → TaskRegistry #551 (4.6) — все эндпоинты и задачи уже вынесены

Критерии готовности

• orchestrator.py ≤ 200 строк
• Модульный startup — каждый модуль инициализируется через свой init()
• Graceful shutdown: tasks → bots → bridge → DB
• Deployment modes через загрузку/не-загрузку модулей
• Health check показывает только загруженные модули
• Все endpoints работают
• Боты стартуют корректно
• Docker deploy + health check OK
• CI зелёный

[ShaerWare]

📋 Результаты аудита: #545 (comment)