AGENTS.md — schemas/

Назначение этого уровня

Все схемы данных и контракты проекта. Источник истины: код не знает схему раньше, чем она здесь появилась.

Содержимое

schemas/
├── AGENTS.md                 # ← вы здесь
├── postgres/                 # DDL, миграции, ERD, описание таблиц
├── clickhouse/               # DDL аналитических таблиц
├── elasticsearch/            # JSON mappings, analyzers, synonyms
├── events/                   # JSON Schema / Avro для Kafka-событий + topics.md
└── api/                      # OpenAPI / AsyncAPI

Правила

• Любое изменение схемы — через PR.
• Нельзя изменить схему без соответствующей миграции.
• Breaking changes требуют ADR и плана миграции.
• Имена файлов и схем = snake_case (для всех БД и events).

Когда смотреть сюда

• Нужна схема конкретной таблицы / индекса / топика / endpoint’а.
• Пишете миграцию.
• Проверяете соответствие кода и схемы.

Когда НЕ смотреть сюда

• Нужно понять, зачем схема такая → ADR в ../adr/ + ../10-business/.
• Нужна реализация — идите в ../../30-services/.

Связано

• Родитель: ../AGENTS.md
• ADR: ../adr/AGENTS.md