Дорожная карта и демонстрация¶
Реализовано¶
Рабочий фундамент, как описано в продуктовых материалах (подтверждать по продуктовому репозиторию, прежде чем считать любую строку жёстким инвентарём):
- рендерер Markdown / GFM;
- Mermaid и иконки архитектуры;
- профессиональные темы, изображения/ассеты, печатная вёрстка, PDF, укрепление пагинации;
- local-first рендеринг в клиентском SPA;
- доставка AWS (CloudFront, private S3 / OAC);
- Terraform и GitHub Actions с OIDC;
- аутентификация Cognito и административная control plane с USER / ADMIN / SUPER_ADMIN;
- runtime-конфигурация и версионированные промпты с публикацией / откатом;
- AI-трансформации как минимум для ADR, требований (FR/NFR, бизнес-правила / ограничения) и Resume / CV;
- кредиты / контроль стоимости и биллинговый контур Paddle;
- история трансформаций и административная наблюдаемость.
Не заявлено как реализованное: Harness на Step Functions, workers на ECS Fargate, Evidence / Canonical Fact Model, Situations, Patch Compile, GitHub App / CLI как поставленный workflow.
Текущий / следующий фокус¶
Номера эпох предварительные. Предпочитать продуктовый репозиторий, если в нём более новая дорожная карта.
| Эпоха | Фокус | Статус |
|---|---|---|
| - | Рендерер, SaaS-контур, первые AI-трансформации, кредиты / Paddle | Реализовано |
| E22 | Телеметрия качества продукта и Compiler; жизненный цикл публикации Compiler (PUBLIC / INTERNAL / DISABLED) | Следующее |
| E23 | Универсальный Transformation Harness; Artifact Contract | Запланировано |
| E24 | Evidence / Canonical Fact Model | Запланировано |
| E25 | Спецификация Compiler; пользовательские шаблоны выхода | Запланировано |
| E26 | Эталонный Requirements Compiler | Запланировано |
| E27 | API Contract Compiler; движок качества Mermaid | Запланировано |
| E28 | Постранично точная публикация; укрепление Resume Compiler | Запланировано |
| E29 | CLI / Git-native workflow | Запланировано |
| E30 | Движок Situation | Запланировано |
| E31 | Первые пакеты Situation | Запланировано |
| E32 | Patch Compile | Запланировано |
| E33 | Правила организации / пользовательские валидаторы | Запланировано |
| E34 | Интеграция GitHub App / CI | Запланировано |
Скриншоты и демо¶
Скриншоты в этом пакете не вымышляются. Добавлять проверенные ассеты в docs/assets/doccompile/, когда они есть в продуктовом репозитории. Рекомендуемый набор:
editor_main.png- основной интерфейс редактора / compiler;mermaid_document.png- документ с Mermaid и иконками архитектуры;transformation_before_after.png- вход vs выход AI-трансформации;admin_history.png- история трансформаций / наблюдаемость для администратора.
Архитектура документирована диаграммами в Архитектура и интеграции, а не статическим PNG.
Live URL, примеры запросов и GIF следует линковать здесь только после подтверждения.
Что демонстрирует этот проект¶
Этот проект демонстрирует способность:
- поставить local-first движок публикации и serverless AWS SaaS-контур как один продукт;
- тарифицировать ИИ как ограниченную систему (задачи, кредиты, версионированные промпты), а не безграничный чат;
- развернуть гипотезу workspace, когда она конкурирует с существующим домом документов пользователя;
- спроектировать следующую архитектуру (Compiler, Harness, Artifact Contract), не выдавая её за уже развёрнутую.