37 lines
3.4 KiB
Markdown
37 lines
3.4 KiB
Markdown
# Proposal: схема среза ЕХ ex-payload-v1 (docs #208)
|
||
|
||
## Why
|
||
|
||
AURORA-1560 (запись среза ЕХ при «Верифицирован», Потапова, разработка 12–18.11.2026, тест заказчика с 19.11) в
|
||
«Нужно до старта» называет схему замороженных данных `docs/contracts/ex-payload-v1.schema.json` — её нет, поля по типам
|
||
элементов среза не описаны. Без неё нельзя ни записать срез, ни проверить, что просмотр и выгрузка из среза совпадают с
|
||
рабочей версией (AURORA-2001 — чтение среза, AURORA-1562 — тест).
|
||
|
||
Источники: DOC-274687 «Срез при верификации», DOC-274686 «Версии и прошлые периоды», DOC-274685 «Архив» (черновики
|
||
команды, Старовойтов); ЕХ ТЗ 5.2, 6.2–6.4; решения команды 28–29.09.2026 (самодостаточный срез, первичка ссылкой, файлы
|
||
выгрузок не хранятся, PDF не делать); DBML `ex_snapshot*`; контракт КФО (`dev/api-contract-kfo.md`, PR #207).
|
||
|
||
## What changes
|
||
|
||
- `contracts/ex-payload-v1.schema.json` — JSON Schema 2020-12: конверт элемента среза и данные по `item_type`
|
||
(`summary_osv`, `vgo_pairs`, `chess`, `kfo_balance`, `kfo_income`, `goodwill`, `corrections`, `other_report`,
|
||
`version_card`); примеры `contracts/examples/ex-payload-*.json` на числах сквозного примера §8 «КФО»; проверка в
|
||
`scripts/validate_contracts.py`.
|
||
- `context/05-domain-rules.md` — новый §14 «Срез ЕХ при верификации»: когда пишется, что входит, самодостаточность,
|
||
суммы и единицы, сбой записи, корректировки только `APPLIED`, карточка версии.
|
||
- DBML v5.26 (та же неслитая версия, что в #207) — `ex_snapshot_item.item_type` + `version_card`, версия схемы
|
||
`"1.0"`; `audit_action` + `EX_SNAPSHOT_WRITE`; пояснение `ex_snapshot.status` под ручной архив.
|
||
- `context/07-open-questions.md` — открытые вопросы среза.
|
||
|
||
Срез плана: Срез 7 (`09-delivery-plan.md`), Гант 3.3. Дочерний change — `arm-core` (AURORA-1560), заводит исполнитель.
|
||
Строится на ветке #207 (форма КФО), сливается после него.
|
||
|
||
## Non-goals
|
||
|
||
- Код записи среза — AURORA-1560; чтение, архив и разархивирование — AURORA-2001; переход «Верифицирован» — AURORA-2002.
|
||
- Копия файлов первички в отдельный префикс S3 — AURORA-1935.
|
||
- PDF «Консолидированная отчётность» — не делаем до решения заказчика.
|
||
- Перенос в data lake и сроки хранения — страница «Архив», не схема.
|
||
- Вопросы заказчику по ЕХ (ручной или автоматический архив, ключ ГК или ГСК) — AURORA-1397 у аналитика; схема от них не
|
||
зависит.
|