# 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.