Гайд тестировщика: единая нормализация ББ/ОФР (контракт 2.0) (#128) #129

Merged
aep merged 2 commits from feat/128-qa-normalization-v2 into main 2026-10-19 08:01:09 +03:00
Owner

Closes #128. Связано с #116.

Что сделано

  • dev/qa-statements-v2.md (новый) — для тестировщиков на стенде контура: что изменилось для пользователя (было → стало), как работает (загрузка → шаг 1 сервиса → шаги 2–8 общего кода → результат 2.0 → ядро → экран → подтверждение), предусловия (очистка форм purge_statements, «сначала ядро», как узнать новую версию ядра и сервисов, повторная загрузка смешанных файлов), справочник файлов Т1–Т14 с особенностями (fixtures в контур не переносятся), справка по цветам/значкам и кодам предупреждений, чек-лист N1–N66 (12 групп), известные замечания I-1…I-5, M-1…M-9, O-2, F-1, F-2, «не баг», как заводить баги по формам.
  • dev/qa-guide.md — ссылки на новый гайд (шапка, §1, §6.9, §8.5, §8.7, §9); §6.7/§6.8/§6.9 приведены к контракту 2.0 (структурные предупреждения, статусы строк, aep_3/aep_6 по эталонам 2.0, F2 — шаблонные строки, column_index листа, NUMBERS_OUTSIDE_TABLE; «не баги»); O-1 прогона: §7.2, W18, W30 — несопоставленных 1236 (было 1260; пересчитано по экспорту свода 19.10), W16 — плоская таблица ОСВ, W32a — ГСК 10 / ГК 26 / Внешний 1349 и почему «Внешний» ≠ «Осталось»; W13 — значок «ⓘ 1» у ОСВ; W20 — подсветка по «требует внимания».
  • dev/README.md — ссылка на гайд; ожидания aep_3/aep_6 приведены к 2.0.

Уточнения известных замечаний

  • M-1 — по Р-4 не дефект: повтор кода законен, LINE_CODE_TAKEN только против строки, созданной правкой, с суммами; оставлено как вопрос о подсказке.
  • M-2 — не дефект: поля is_detail в API нет (extra=forbid), правильно line_status: "detail", экран шлёт верно.
  • M-4 — сужено: правка снимает связанные error и REPORT_DATE_UNPARSED, остаются info INN_NOT_FOUND/INN_UNCERTAIN/ORGANIZATION_UNCERTAIN/UNITS_NOT_FOUND.
  • I-1 — проявляется и в заголовках колонок OCR без подписи (aep_3: «Колонка 3/5/6»); N = номер столбца листа/таблицы ИС.
  • I-2 — то же у aep_6; период документа верный.
  • I-5 — правило «нарастающая по данным Q1» со Среза 2c.

Проверка

make check — зелёный (validate-contracts, validate-openspec, test-snapshot, test-sync-web, test-sync-statements).

Rulings I made

  • Документ сделан самодостаточным: fixtures в контур не переносятся, поэтому у каждого файла — признаки для подбора аналога.
  • Скриншоты в docs не добавлены (экономия времени и объёма; тексты экрана дословно из кода arm-web test 4a02512).
  • Сценарии, не прогнанные на стенде (DUPLICATE_FORM, LINE_CODE_TAKEN, xlsb/тыс. руб.), помечены «(спека)».
  • 1236 подтверждено подсчётом по svod-2024Q3.xlsx прогона 19.10; причина расхождения с 1260 указана как вероятная, не проверенная.
  • Попутно обновлены §6.7/§6.8 qa-guide и dev/README.md (aep_3/aep_6), которые прямо противоречили 2.0.

🤖 Generated with Claude Code

Closes #128. Связано с #116. ## Что сделано - **dev/qa-statements-v2.md** (новый) — для тестировщиков на стенде контура: что изменилось для пользователя (было → стало), как работает (загрузка → шаг 1 сервиса → шаги 2–8 общего кода → результат 2.0 → ядро → экран → подтверждение), предусловия (очистка форм purge_statements, «сначала ядро», как узнать новую версию ядра и сервисов, повторная загрузка смешанных файлов), справочник файлов Т1–Т14 с особенностями (fixtures в контур не переносятся), справка по цветам/значкам и кодам предупреждений, чек-лист N1–N66 (12 групп), известные замечания I-1…I-5, M-1…M-9, O-2, F-1, F-2, «не баг», как заводить баги по формам. - **dev/qa-guide.md** — ссылки на новый гайд (шапка, §1, §6.9, §8.5, §8.7, §9); §6.7/§6.8/§6.9 приведены к контракту 2.0 (структурные предупреждения, статусы строк, aep_3/aep_6 по эталонам 2.0, F2 — шаблонные строки, column_index листа, NUMBERS_OUTSIDE_TABLE; «не баги»); O-1 прогона: §7.2, W18, W30 — несопоставленных **1236** (было 1260; пересчитано по экспорту свода 19.10), W16 — плоская таблица ОСВ, W32a — ГСК 10 / ГК 26 / Внешний 1349 и почему «Внешний» ≠ «Осталось»; W13 — значок «ⓘ 1» у ОСВ; W20 — подсветка по «требует внимания». - **dev/README.md** — ссылка на гайд; ожидания aep_3/aep_6 приведены к 2.0. ## Уточнения известных замечаний - M-1 — по Р-4 не дефект: повтор кода законен, LINE_CODE_TAKEN только против строки, созданной правкой, с суммами; оставлено как вопрос о подсказке. - M-2 — не дефект: поля is_detail в API нет (extra=forbid), правильно line_status: "detail", экран шлёт верно. - M-4 — сужено: правка снимает связанные error и REPORT_DATE_UNPARSED, остаются info INN_NOT_FOUND/INN_UNCERTAIN/ORGANIZATION_UNCERTAIN/UNITS_NOT_FOUND. - I-1 — проявляется и в заголовках колонок OCR без подписи (aep_3: «Колонка 3/5/6»); N = номер столбца листа/таблицы ИС. - I-2 — то же у aep_6; период документа верный. - I-5 — правило «нарастающая по данным Q1» со Среза 2c. ## Проверка make check — зелёный (validate-contracts, validate-openspec, test-snapshot, test-sync-web, test-sync-statements). ## Rulings I made - Документ сделан самодостаточным: fixtures в контур не переносятся, поэтому у каждого файла — признаки для подбора аналога. - Скриншоты в docs не добавлены (экономия времени и объёма; тексты экрана дословно из кода arm-web test 4a02512). - Сценарии, не прогнанные на стенде (DUPLICATE_FORM, LINE_CODE_TAKEN, xlsb/тыс. руб.), помечены «(спека)». - 1236 подтверждено подсчётом по svod-2024Q3.xlsx прогона 19.10; причина расхождения с 1260 указана как вероятная, не проверенная. - Попутно обновлены §6.7/§6.8 qa-guide и dev/README.md (aep_3/aep_6), которые прямо противоречили 2.0. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
aep added 1 commit 2026-10-19 07:59:24 +03:00
- dev/qa-statements-v2.md: что изменилось для пользователя, как работает, предусловия
  стенда контура (очистка форм, «сначала ядро», признаки новой версии), справка по
  цветам, значкам и кодам предупреждений, чек-лист N1–N66, известные замечания
  I-1…I-5, M-1…M-9, O-2, F-1, F-2, «не баг», как заводить баги по формам.
- dev/qa-guide.md: ссылки на новый гайд (шапка, §1, §6.9, §8.5, §8.7, §9); §6.7, §6.8,
  §6.9 приведены к контракту 2.0; §7.2 и W18/W30 — несопоставленных 1236 (было 1260);
  W16 — плоская таблица ОСВ; W32a — счётчики «ГСК/ГК/Внешний» и отличие «Внешний»
  от «Осталось»; W13 — значок «ⓘ 1» у ОСВ; W20 — подсветка по «требует внимания».
- dev/README.md: ссылка на гайд, ожидания aep_3/aep_6 по контракту 2.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
aep added 1 commit 2026-10-19 08:00:34 +03:00
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
aep merged commit 1865874c83 into main 2026-10-19 08:01:09 +03:00
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: RSHB/arm-ka-docs#129
No description provided.