AIDB Large Stage Roadmap

Статус

Статус: active large-stage roadmap for architect-first start.

Дата: 2026-05-20.

Этот документ фиксирует большие этапы нового проекта AIDB.

Он нужен, чтобы не дробить работу на мелкие бессвязные задачи.

1. Общий принцип

AIDB должен строиться большими архитектурными этапами.

Не использовать модель:

• один endpoint = одна задача;
• один экран = один канон;
• одна мелкая правка = новая архитектура.

Использовать модель:

• один смысловой слой = один этап;
• один большой архитектурный контур = один пакет решений;
• один stage = один завершенный результат.

2. Stage 1 - Foundation

Вход:

• owner-approved логика проекта;
• новые термины;
• новая иерархия;
• чистый старт без старой истории.

Результат:

• AIDB_FOUNDATION_CANON.md

Состояние:

• выполнено.

3. Stage 2 - Architect Scope

Вход:

• foundation canon;
• список спорных мест;
• понимание, что новый архитектор должен закрыть.

Результат:

• AIDB_ARCHITECT_SCOPE.md
• список обязательных архитектурных deliverables.

Состояние:

• выполнено.

4. Stage 3 - System and Children Architecture

Нужно закрыть:

• system/ map;
• children/ map;
• folder rules;
• storage separation;
• Shell/Gate/AppMarket/applications/contours boundaries;
• storefront ownership.

Результат:

• AIDB_SYSTEM_STRUCTURE_CANON.md
• AIDB_CHILDREN_STRUCTURE_CANON.md

Состояние:

• выполнено первым проходом.

5. Stage 4 - Business Flows Architecture

Нужно закрыть:

• card engine;
• commercial proposal flow;
• publication model;
• personal cabinets;
• intercompany;
• commission/representative logic.

Результат:

• AIDB_STOREFRONT_AND_PUBLICATION_CANON.md
• AIDB_PERSONAL_CABINET_AND_INTERCOMPANY_CANON.md

Состояние:

• выполнено как draft-pass;
• требует финализации перед переходом к большой реализации.

6. Stage 5 - Backend and Runtime Architecture

Нужно закрыть:

• backend/API map;
• runtime contracts;
• workers and schedulers;
• upload/download handling;
• database/storage boundary.

Результат:

• AIDB_BACKEND_API_CANON.md
• AIDB_RUNTIME_STORAGE_CANON.md

7. Stage 6 - Skeleton Project

После завершения архитектурного пакета создается skeleton проекта.

В этом этапе не строится полный продукт.

Создается:

• чистый root;
• системные пакеты;
• базовые manifests;
• пустые module boundaries;
• пустые runtime contracts;
• пустые backend module files;
• чистая база старта.

8. Stage 7 - Core Implementation

Только после skeleton начинаются первые большие implementation slices:

• Gate
• Shell
• card engine
• business-center
• business-level
• digital-space
• RBAC base
• storage separation

9. Stage 8 - Commercial Core

После core implementation:

• AppMarket
• commercial proposals
• storefront publication
• personal cabinet
• intercompany

10. Stage 9 - Modules

Только после базовой платформы:

• installable business contours
• installable applications
• supplier/client extensions
• special vertical modules

11. Критерий перехода между стадиями

Переходить к следующей большой стадии можно только если:

• предыдущая стадия зафиксирована в документах;
• owner понимает и принимает результат;
• не осталось критических архитектурных дыр;
• developer не вынужден додумывать архитектуру сам.

12. Запрещенная модель

Запрещено:

• сразу писать большой живой продукт без завершенного architecture pack;
• мешать архитектуру и реализацию в один поток;
• плодить мелкие хаотичные стадии;
• открывать крупные бизнес-модули до закрытия core structure.