Дорожная карта 🚀 ASTRO 💙 ALGO

✅ M1 — Централизованные Settings + единый логгер

Суть: единый Pydantic-настройщик и стиль фича-флагов (UPPER_SNAKE_CASE), отказ от print.
Ценность инвестору: меньше «тихих» сбоев и быстрее локализация проблем.
Контракты: algo_common/settings.py (ключи, AA_*), логирование вместо print.
Метрики/тесты: env-override проходит; grep на print( = 0.

✅ M2 — Разгрузка main.py на модули (без изменения поведения)

Суть: фабрика приложения + вынос клиентов/хендлеров/гардрейлов в отдельные модули.
Ценность: ниже стоимость изменений, меньше регрессий.
Контракты: main.py тонкий; роутер собирается фабрикой.
Метрики/тесты: смоук старта PASS.

✅ M3 — Фасад Weaviate v4

Суть: доступ к векторной БД только через общий фасад; прямые импорты запрещены.
Ценность: безопасные апгрейды и единое поведение RAG.
Контракты: algo_common/weaviate_client.py; запрет import weaviate вне фасада.
Метрики/тесты: guard-grep, смоук RAG OK.

✅ M4 — Prophet-guardrails (short-circuit)

Суть: корректный отказ/«нет данных» при пустом RAG/низкой уверенности; JSON-ответ.
Ценность: меньше ложных сигналов/overfitting.
Контракты: гардрейл-мета подключена в роутере; short-circuit без стрима.
Метрики/тесты: JSON контракт на абстейн PASS.

✅ M5 — Смоук-набор: /health, /ready, chat/stream

Суть: светофор готовности сервиса.
Ценность: быстрая диагностика стенда перед демонстрациями.
Контракты: /health=200; /ready с ключами status/checks/timestamp; chat SSE/JSON.
Метрики/тесты: базовые смоуки зелёные.

✅ M6 — Метрики за фичефлагом (no-op по умолчанию)

Суть: /metrics выключен по умолчанию; включается флагом.
Ценность: нулевой оверхед, включаем Observability когда нужно.
Контракты: AA_METRICS_ENABLED / AA_PROM_ENABLED.
Метрики/тесты: OFF→404, ON→200 text/plain.

✅ M7 — Док для OpenWebUI (SSE/stream)

Суть: инструкция подключения UI к прокси (режимы стрима и модели).
Ценность: быстрые демо без DevOps.
Контракты: README раздел по OpenWebUI; FAQ про SSE.
Метрики/тесты: проверка наличия/валидности инструкций.

✅ M8 — In-memory память: remember/recall + SSE

Суть: легковесная «короткая память»; команды памяти распознаются эвристикой и стримятся.
Ценность: UX-прототипирование и быстрый контекст без внешних сервисов.
Контракты: память включается только флагом; иначе команды игнорируются.
Метрики/тесты: mutual exclusion ON/OFF; команды работают при разрешённой памяти.

✅ M9 — Скрипты быстрого старта + compose

Суть: PowerShell-скрипты, healthchecks, OpenWebUI контейнер.
Ценность: TTM в минуты; предсказуемый стенд.
Контракты: run_proxy_8093.ps1, health-пинги; compose с open-webui.
Метрики/тесты: смоук-команды из README проходят.

✅ M10 — Import-guard Weaviate

Суть: дисциплина зависимостей (только фасад).
Ценность: предотвращение «дрейфа» SDK и API-несовместимостей.
Контракты/тесты: grep-запрет на import weaviate.

✅ M11 — Взаимоисключение HTTP/in-proc памяти

Суть: одновременно активна только одна реализация памяти (локальная или HTTP).
Ценность: отсутствие гонок и расхождений состояния.
Контракты/тесты: включение по AA_MEM_URL/AA_MEMORY_ENABLED; unit на exclusivity.

✅ M12 — Единый источник кейсов

Суть: консолидация кейсов; депрекация альтернативных прокси-путей.
Ценность: меньше конфликтов обучающих/валидационных данных.
Контракты/тесты: импорт/версионирование кейсов согласовано.

✅ M13 — Резерв под интеграционные правки

Суть: буфер для выравнивания зависимостей.
Ценность: снижение риска блокировок при слиянии рабочих веток.
Контракты/тесты: по месту (no-op до активации).

✅ M14 — /metrics за флагом AA_PROM_ENABLED

Суть: явное включение эндпоинта метрик.
Ценность: управляемая Observability для стенда/прод.
Контракты/тесты: OFF→404; ON→200 + содержимое.

✅ M15 — OpenAPI-схема

Суть: /openapi.json доступен, схема валидна.
Ценность: совместимость со внешними SDK/генераторами клиентов.
Контракты/тесты: tests/test_openapi_schema.py PASS.

✅ M16 — Базовые счётчики метрик

Суть: экспонирование простых метрик (например, app_requests_total) при включении.
Ценность: видимость нагрузки/ошибок.
Контракты/тесты: эндпоинт отдаёт текст/числа; OFF→404.

✅ M17 — Repro-сборка + style-CI + tools.journal

Суть: pyproject/Poetry, стат-анализ, append-only журнал решений.
Ценность: воспроизводимость и аудит изменений.
Контракты/тесты: style-workflow зелёный; журнал защищён от перезаписи.

✅ M18 — Журнал (append-only)

Суть: CLI/утилита и тест-охранник против переписывания историй.
Ценность: трассируемость для инвесторских отчётов.
Контракты/тесты: попытки overwrite ловятся тестами.

✅ M19 — /healthz/detailed

Суть: расширенные проверки: settings/logger/metrics/memory/RAG/OpenAPI.
Ценность: быстрее искать корень проблем в окружении.
Контракты/тесты: JSON с checks{…}; статус ok|degraded.

✅ M20 — Circuit Breaker (RAG/память)

Суть: graceful-деградация при сбоях внешних сервисов; OPEN/half-open/closed.
Ценность: устойчивость, меньше ложных негативов.
Контракты/тесты: модуль rag_proxy/circuit.py; unit на переходы состояний.

✅ M21 — RAG LRU-кэш + улучшения app-factory

Суть: TTL/TopK-кэш запросов; общий доступ к фичефлагам через settings.
Ценность: ускорение повторных запросов и снижение токен-стоимости.
Контракты/тесты: ускорение P50 для повторов; корректная инициализация.

✅ M22 — Лимиты ввода + CORS

Суть: ограничение длины запросов, настраиваемые CORS-источники.
Ценность: защита от перегрузки и безопасные фронтовые интеграции.
Контракты/тесты: 413 на переполнение; заголовки CORS корректны.

✅ M23 — Аудит Pydantic v2

Суть: отсутствие class Config, переход на model_config/SettingsConfigDict; нет DeprecationWarnings.
Ценность: готовность к будущим версиям/вендорным библиотекам.
Контракты/тесты: grep на class Config; тест-охранник на предупреждения.

✅ M24 — Reports API/SDK

Суть: машинно-читаемые отчёты (/reports/build, /reports/render) и e2e без сети.
Ценность: быстрая витрина ценности/гипотез и воспроизводимые отчётные артефакты.
Контракты/тесты: роуты построения/рендера подключены, отчёт сохраняется; mypy=0.

✅ M25 — Финализация /reports + стабилизация CI

Суть: доводка роутов отчётов, зелёный CI на main.
Ценность: демонстрации «из коробки», доверие к стабильности.
Контракты/тесты: CI smoke зелёный; /reports/* провёрстаны.

✅ M26 — OpenAI-совместимый non-stream JSON по умолчанию

Суть: /v1/chat/completions в non-stream режиме возвращает OpenAI-совместимый JSON-объект (без SSE).
Ценность: совместимость с экосистемой OpenAI-клиентов/инструментов.
Контракты/тесты: non-stream 200 OK; stream включается только по флагу/Accept.

✅ M27.1 — Guardrails + корректное SSE + /ready

Суть: строгое разделение non-stream JSON и SSE; метаданные guardrail (reason, confidence); минимальный /ready.
Ценность: предсказуемость интеграций и безопасные ответы.
Контракты/тесты: /ready содержит status, rag, memory, timestamp; SSE только при stream=true или Accept:
text/event-stream.

✅ M27.2 — Реальный чат-роутер, 404 снят

Суть: роуты разнесены на routes/system.py и routes/chat.py, добавлен общий сборщик routes.build_router, create_app() монтирует собранный роутер. Эндпоинт /v1/chat/completions доступен.
Ценность: предсказуемый entrypoint, читаемая структура, отсутствие 404.
Контракты/тесты: test_proxy_smoke::test_contract_guardrail_json больше не падает на 404 и доходит до проверки содержимого.

✅ M27.3

M4: синхронизирован текст гардрейла (low_confidence)
M27: контракт non-stream JSON зелёный
routes: вынесены system.py и chat.py; общий сборщик routes.build_router
app: компактный create_app() монтирует собранный роутер
main: лёгкий entrypoint

🔶 ПРИМЕЧАНИЯ ПО АРХИТЕКТУРЕ И ДИСЦИПЛИНЕ

Приоритет текущей задачи и статуса — файл memory/dinamika.md; «мозг» проекта — /memory (конституция, кодекс, динамика).

Стратегические рекомендации: унификация клиентов/SDK (Weaviate v4), единые фасады/настройки, декомпозиция rag_proxy.

Контракты роутера: /health, /ready, /v1/chat/completions, /reports/* реализованы в rag_proxy/routes.py.