AIDB Dev Center

Readable architecture document

AIDB Canon Index

Короткий вход в архитектуру и правила, какие документы читать под конкретную задачу.

activesource: AIDB_CANON_INDEX.md

AIDB Canon Index

Статус

Статус: active short entry index.

Дата: 2026-05-20.

Этот документ является коротким входом в архитектуру AIDB.

Его цель - сократить чтение длинных документов.

1. Читать первым

Всегда читать сначала:

  1. AIDB_ARCHITECT_INSTRUCTION.md
  2. AIDB_FOUNDATION_CANON.md
  3. AIDB_ARCHITECT_SCOPE.md
  4. AIDB_LARGE_STAGE_ROADMAP.md

2. Когда нужен system

Если задача касается:

  • Shell;
  • Gate;
  • AppMarket;
  • applications;
  • contours;
  • storefront templates;
  • backend;
  • runtime;
  • database;
  • shared packages;

читать:

  • AIDB_SYSTEM_STRUCTURE_CANON.md

3. Когда нужен children

Если задача касается:

  • business_center inventory;
  • business_level inventory;
  • digital_space inventory;
  • installed contour inventory;
  • installed app inventory;
  • uploads;
  • storefront pages;
  • runtime files;

читать:

  • AIDB_CHILDREN_STRUCTURE_CANON.md

4. Что не читать всем подряд

Не нужно читать весь пакет, если задача локальная.

Правило:

  • foundation = всем;
  • system canon = только по system tasks;
  • children canon = только по children tasks;
  • stage docs = только по текущей стадии;
  • developer получает короткий packet, а не весь docs set.

5. Когда нужны business flows

Если задача касается:

  • внешней витрины;
  • публикации карточек;
  • коммерческих предложений;
  • central_offer_intake_enabled;
  • личных кабинетов клиента, поставщика или представителя;
  • intercompany;
  • комиссий;

читать:

  • AIDB_STOREFRONT_AND_PUBLICATION_CANON.md
  • AIDB_PERSONAL_CABINET_AND_INTERCOMPANY_CANON.md

6. Главная цель индекса

Сократить:

  • лишнее чтение;
  • лишние токены;
  • лишние повторы;
  • лишнюю путаницу.