Центр состояния, честные ворота, индекс квитанций и все Python-тесты в CI
Фаза 0 «Порядок», дорожки S и Q (план
plan/report-20261010/, раздел 11). Цель — одна страница
правды вместо сотен документов-статусов и проверки, которые нельзя
случайно обойти.
Что сделано
| Что | Файл | Как запустить |
|---|---|---|
| Страница «Центр состояния» | docs/STATUS.md (генерируется) |
just status |
| Она же в сети | https://moffice-plan.24oros.ru/status/
(deploy/status-center/) |
just status-publish |
| Реестр ворот выпуска (≤ 8) | qa/gates.json |
python3 scripts/status_center.py --check (в
just ci) |
| Генератор страницы | scripts/status_center.py, тесты
scripts/test_status_center.py |
— |
| Индекс квитанций | scripts/evidence_index.py, тесты
scripts/test_evidence_index.py |
just evidence-index |
| Единый запуск Python-тестов | scripts/run_python_tests.py, реестр
scripts/python-tests-requirements.json, тесты
scripts/test_run_python_tests.py |
just test-python (в just ci) |
Страница docs/STATUS.md
Блоки между отметками <!-- status:…:begin/end -->
пишет генератор, ручной блок
<!-- manual:begin/end --> сохраняется при пересборке
как есть. Сгенерированные блоки руками не правят — правят данные.
- Срез — коммит, ветка и дата коммита (не «сейчас»), поэтому страница воспроизводима.
- Ворота выпуска — из реестра
qa/gates.json: критерий, текущее значение, итог, кто снимает, откуда данные. Числа берутся из названных квитанций по JSON Pointer; ручные оценки помечены знаком ✎ и датой. - Квитанции — итоги по всем JSON-свидетельствам и восемь последних событий (время в UTC).
- Сборки — канал загрузок из
deploy/downloads.json: цель, размер, подпись, нативная проверка.
Страница не длиннее 150 строк — генератор откажется писать более длинную.
В CI проверяется только реестр
(--check: файлы квитанций и указатели существуют, ворот не
больше восьми, у каждых есть критерий и владелец). Саму страницу CI не
сверяет: она меняется с каждой новой квитанцией и роняла бы CI из-за
чужой работы.
Публикация
python3 scripts/status_center.py --html <файл>
строит из той же страницы самодостаточный HTML (без скриптов и внешних
ресурсов, noindex, тёмная тема, на телефоне таблицы становятся
карточками). just status-publish кладёт его на sagr в
контейнер moffice-status (nginx, только чтение, порт 18312)
и подключает путь /status на
moffice-plan.24oros.ru маршрутом Traefik
sagr-moffice-status.yaml; затем сверяет sha256 страницы с
публичного адреса. Путь, а не поддомен: новые *.24oros.ru
идут через входной VPS, а его список доменов без слова владельца не
меняется. Откат: docker compose -p moffice-status down и
удалить файл маршрута.
Реестр ворот
qa/gates.json
Восемь ворот (на 11.10.2026 пройдены 1 из 8 — формулы после решения владельца об эталоне) вместо «20 ворот» прежних записей (6 настоящих и 14 исторических): данные не теряются; установка, обновление и откат; вёрстка Write; формулы Excel; приёмка на живых ОС; скорость и память; безопасность и право; пилот. Вид измерения:
ratio— доляnum / denне нижеmin(вёрстка: 660 из 2 933 = 22,5 % при цели 60 %);max— значение не вышеmax(формулы: 7 расхождений из 31 070 при допуске 0);all— составные ворота: список слоёвmeasures(каждый —ratioилиmaxсо своей подписьюlabel), пройдены, только если пройден каждый слой; так устроены слоёные ворота вёрстки G3;manual— оценка человека со статусомPASS/FAIL/PARTIAL/OPEN, датойas_ofи пояснением.
У любых ворот с данными может быть note — пояснение
рядом с числом; итог оно не меняет.
Когда появляется новая принятая квитанция, меняют поле
file в реестре, а не текст страницы.
Индекс квитанций
577 разнородных JSON-файлов (docs/integration/evidence,
docs/development/evidence-*,
docs/parallel-delivery/evidence-*) сводятся к одной схеме:
id, sha256, bytes, schema, kind, verdict, mixed, status, commit, at, host.
Итог нормализуется по первому распознанному слову статуса:
«ROOT_ACCEPTED_…» — PASS, «PASS_…_FAIL_RETAINED» — PASS с оговоркой
(mixed). Отдельно учитываются квитанции без поля статуса
(NOSTATUS) и со статусом из нераспознанных слов (UNKNOWN), чтобы «нет
вердикта» не путалось с «не умеем читать».
На срезе 10.10.2026 (вместе с квитанцией этого этапа — 577): PASS 347 · PARTIAL 35 · FAIL 40 · OPEN 7 · INFO 12 · NOSTATUS 131 · UNKNOWN 5; с оговоркой — 201.
Индекс не коммитится
(target/evidence-index.json): квитанции добавляют все
сессии каждый день, общий файл стал бы точкой конфликтов. Для кандидата
выпуска можно записать снимок
(--write --out docs/releases/<кандидат>/evidence-index.json)
и потом проверять его --check: он назовёт добавленные,
удалённые и изменённые квитанции.
Все Python-тесты в CI
Раньше just ci вызывал вручную перечисленные 6 файлов
(111 тестов) из 38 файлов репозитория. Теперь
scripts/run_python_tests.py находит все
test_*.py (кроме target, .git,
.claude, node_modules) и запускает каждый
отдельным процессом. Правила:
- файл, в котором выполнено 0 тестов, — ошибка (иначе пустой файл или сломанный импорт дают ложный «зелёный»);
- пропуск — только через
scripts/python-tests-requirements.jsonс причиной и проверяемым условием: модуль Python (requires_module) или файл (requires_path); когда условие выполнено, тест запускается обычным порядком; --strictделает любой пропуск ошибкой — для машин, где всё установлено.
Сейчас: 44 файла, 441 тест, пропущено 2 с причиной
(test_validate_run.py — нет pypdf;
test_audit_package.py — нет собранного пакета
target/odt-field-context-v1). Проверено на Mac (Python
3.14) и на Linux x86_64 sagr (Python 3.12.3) во временной
папке.