Концепции

Картина продукта за 60 секунд: как Expecto собран. Любой роли полезно прочитать это один раз, даже если вы используете лишь часть платформы.

Базовый поток

Организация
  └── Проект               ─ что принимаем и для кого
        ├── Entity         ─ целевая схема, которой должны соответствовать строки
        ├── DataContract   ─ формат, в котором обещает прислать поставщик
        │     └── Revision ─ неизменяемый снимок этого формата
        ├── Transformer    ─ как поле контракта мапится на entity
        └── Session        ─ одна поставка: файлы → валидированный результат

Проект объединяет всё необходимое для приёма данных под один кейс. Внутри Entity объявляет целевую схему (и построчные правила валидации). DataContract описывает, что обещает прислать конкретный поставщик — типы файлов и имена колонок. Transformer — чистый мост-маппинг между контрактом и entity. Session — один акт поставки: один поставщик, один период, один комплект файлов, проведённый через пайплайн.

Где описано каждое понятие

Концепция	Страница
Организации и мультитенантность	Скоро.
Project и Entity	Скоро.
DataContract и Revisions	Скоро.
Transformer	Скоро.
Catalog (справочники)	Скоро.
Бизнес-правила	Скоро.
Жизненный цикл Session (FSM)	Скоро.
Модель Data Provider	Скоро.
Глоссарий	Скоро.

Как концепции связаны с ролями

• Поставщик чаще всего видит Sessions и ошибки валидации, которые из них выходят.
• Владелец проекта проводит основное время за определением Entity, DataContract и Transformer.
• Администратор организации работает на уровне Организации, Data Providers и доступов.
• Разработчик взаимодействует с теми же концепциями через API плюс каталог MCP-инструментов.