RSHB/arm-ka-docs
9
0
Fork 0
Code Issues 17 Pull Requests 5 Actions Packages Projects Releases Wiki Activity
arm-ka-docs/openspec/changes/ex-payload-schema/proposal.md
Andrey Epifancev 9086c064e4 ЕХ: дизайн и план change ex-payload-schema (#208) 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 23:03:19 +04:00

3.4 KiB
Raw Blame History

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 у аналитика; схема от них не зависит.