Приёмка шага 5: сплошная сверка выгрузки конструктора с эталонной выгрузкой

Дата: 12.08.2026. Эталон — reference/etalon-punc-avgust-2024.xlsx («Пример выгрузки готового отчета.xlsx» заказчика). Все числа получены запуском python3 verify_punc_full.py; сырой протокол — evidence/verify-punc-full.txt, машинный реестр — evidence/punc-registry.csv (разделитель ;, UTF-8).

**Итог одной строкой: 2368 проверок, совпало 2347, расхождений 24. Ошибок портирования среди них нет: 21 расхождение вызвано отсутствием данных за сентябрь 2024 в наборе 00102, 3 — вторым комплектом листов эталона, правило появления которого из эталонов не выводится. Код после сверки не правился.**

Реестр расхождений одним файлом (CSV, открывается Excel): punc-registry.csv. Спецификация расчёта: spec-punc.html. Приёмка предыдущего шага: punc-acceptance-step4.html.

1. Что и как сверялось

Сверка идёт не «на глаз», а по четырём уровням для каждой ячейки:

Сверялись обе выгрузки: собранная в процессе (punc_template.render) **и файл, реально отданный сервисом по HTTP** (GET /api/punc/export?contract_id=20&year=2024&month=8 → HTTP 200, 13 536 байт, evidence/step5-live-aug.xlsx, заголовки — evidence/step5-live-aug.headers).

2. Что сошлось — с числами

Лист «август 2024» совпал полностью, включая полную двоичную точность чисел (59921.393000000004, 4.3172822696), все прочерки -, пустую B5, хвостовой пробел в B4 и числовые форматы всех 468 ячеек. Лист «Сравнение» совпал по всем формулам (20 расхождений — только в 20 ячейках-константах, см. §3) и по всем форматам.

3. Реестр расхождений (24 записи)

Полный машинный реестр: evidence/punc-registry.csv. Ниже он же, сгруппированный.

3.1 Лист «Сравнение» — 20 ячеек-констант

Причина у всех одна: агрегаты «Сравнения» считаются по всем листам комплекта (SPEC-PUNC §6), в эталоне это август + сентябрь, а конструктор посчитал только август.

Классификация причины: отличие исходных данных, не ошибка портирования. Доказательство — в §4.2: при подстановке строк сентября из эталонной выгрузки лист «Сравнение» совпадает с эталоном полностью (0 расхождений на 286 проверках). Формульные ячейки (D, G, H, I, J, K, L, M и итоговая строка 11) расхождений не дали вообще — формулы перенесены как есть, включая H11=SUM(H5:H9) без строки УИРП.

3.2 Отсутствующие листы — 3 записи

3.3 Состав книги — 1 запись

• эталон: август 2024 | сентябрь 2024 | август 2024_1 | сентябрь 2024_1 | Сравнение
• конструктор: август 2024 | Сравнение

Причина — сумма двух предыдущих пунктов (нет сентября + не воспроизводится второй комплект). Порядок листов у совпадающих имён верный: лист периода первым, «Сравнение» последним.

3.4 Новый факт шага 5 про второй комплект листов

Поячеечное сравнение листов эталона между собой:

То есть второй комплект — точная копия первого, а не второй сценарий расчёта с другими числами. Это уточняет [ВОПРОС 1] спецификации, но не закрывает его: из эталонов не выводится, при каком условии код печатает период дважды (это может быть и особенность конкретной выгрузки, и правило вида «раскладка + сводка»). Дублировать листы «на всякий случай» — додумывание логики, прямо запрещённое ТЗ, поэтому конструктор по-прежнему печатает один лист на период. Правило дублирования — за заказчиком (одна строка ответа: дублировать всегда / никогда / по условию).

4. Доказательства того, что расхождения не от логики

4.1 Формулы работают и на сентябрьских числах

К колонкам самих эталонных листов применены формулы спецификации: K = D+E+F+G+I−J (прочерк = 0), N = D·C, O = E·C, P = (F−J)·C, Q = G·C, R = I·C.

Это проверяет перенос формул там, где нет исходных данных для проверки выборки: на 11 строках сентября, которых конструктор не считал, его формулы дают ровно те числа, что лежат в эталоне.

4.2 Пробы с подстановкой строк из эталона (в зачёт §2 не входят)

Строки сентября берутся из эталонной выгрузки заказчика (это подстановка чисел, а не расчёт конструктора) и подаются в штатный рендер:

Вывод: вёрстка листа сентября (имя листа, B6, A9 = за сентябрь 2024 г., другой порядок разделов, матрица прочерков, L только у «Электрической энергии») и агрегаты «Сравнения» (в т.ч. деление объёма мощности на 1000) воспроизводятся точно. Не хватает только исходных строк за сентябрь.

5. Что подгонялось и что правилось в коде

Ничего. После сверки код расчёта и вёрстки (app.py, mart.py, punc_template.py) не изменялся — ошибок портирования сверка не выявила, а расхождения §3 исправлению кодом не подлежат (их причина — данные и неопределённое правило эталона). Добавлены только средства проверки, на результат отчёта не влияющие:

6. Чем закрыть оставшиеся 24 расхождения

7. Как проверить руками

python3 -m pytest -q                 # тесты, включая регресс сверки
python3 verify_punc_full.py          # 2368 проверок, 24 расхождения, реестр в evidence/
python3 app.py --port 8911
curl -o punc.xlsx "http://127.0.0.1:8911/api/punc/export?contract_id=20&year=2024&month=8"
curl "http://127.0.0.1:8911/api/punc/export?contract_id=20&year=2024&month=9"   # 400 + причина

Развёрнутый сервис: https://sol-msqct09w-2ae.apps.sreda-ai.ru (проверка — /healthz, выгрузка — /api/punc/export?contract_id=20&year=2024&month=8). Страницы: приёмка шага 5 — punc-acceptance.html, спецификация — spec-punc.html, приёмка шага 4 — punc-acceptance-step4.html (все — по ссылке проекта https://app.sreda-ai.ru/api/projects/sol-msqct09w-2ae/preview/).