0f2bbc80c9
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BJKMLHdxMwSUeYcdkwqX4W
35 lines
2.9 KiB
Markdown
35 lines
2.9 KiB
Markdown
## Why
|
||
|
||
Сквозной change `unified-statement-normalization` (RSHB/arm-ka-docs#116) переводит ББ/ОФР на единую нормализацию:
|
||
ядро (API v5.19, контракт 2.0) отдаёт все строки источника со статусами `ok` / `unreadable` / `missing` / `detail`,
|
||
признак `needs_review` у ячеек, строк и полей шапки, предупреждения `document_issue` и структурные `job.warnings`.
|
||
Экран формы и карточка файла должны это показывать и давать разобрать. Issue — RSHB/arm-web#43. План —
|
||
`docs/superpowers/plans/2026-10-18-statements-v2.md` (план 6 сквозного change).
|
||
|
||
## What Changes
|
||
|
||
Экраны: [41] проверка формы ББ/ОФР, [39] панель файлов (карточка файла).
|
||
|
||
- Раскладка «как на бумаге»: строки `unreadable` / `missing` под ближайшей предыдущей строкой с кодом, `detail` под
|
||
переключателем «Показать расшифровки (N)», справочное имя строки основное, файловое — рядом, если отличается.
|
||
- Подсветка только по `needs_review` (ячейки, строки, поля шапки); предупреждения и нарушения у места
|
||
(`issues`, `checks`).
|
||
- Режим «Редактировать»: назначение кода, «Это расшифровка», «Сделать расшифровкой», подтверждение ячеек, кодов и дат,
|
||
правка наименования организации, один `PATCH …/statement` (`header`, `values`, `columns`, `lines`).
|
||
- «Подтвердить данные» отключена при неразобранных строках; разбор 409 `LINES_UNRESOLVED`, `DUPLICATE_FORM`,
|
||
`LINE_CODE_TAKEN`.
|
||
- Карточка файла читает `job.warnings` структурами `{code, severity, message, locator}`; предупреждения ОСВ-документа
|
||
и документа — из `DocumentOut.issues`.
|
||
- Спеки: `document-review-ui` (2 MODIFIED, 4 ADDED), `primary-files-ui` (1 ADDED).
|
||
|
||
## Non-goals
|
||
|
||
- Переключатель «как в файле» (Р-14: раскладка одна).
|
||
- Склейка форм с разных листов/файлов.
|
||
- Изменения API ядра и спеки docs: расхождения фиксируются как `O-n` в отчётах задач.
|
||
|
||
## Dependencies
|
||
|
||
Выкладка вместе с ядром (план 3 сквозного change, API v5.19): `JobBrief.warnings` меняет тип со строк на структуры.
|
||
До выкладки 2.0-данных на стенде строки со статусами подставляются перехватом запросов (P6-14).
|