MOffice

Центр состояния, честные ворота, индекс квитанций и все 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 --> сохраняется при пересборке как есть. Сгенерированные блоки руками не правят — правят данные.

Страница не длиннее 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; приёмка на живых ОС; скорость и память; безопасность и право; пилот. Вид измерения:

У любых ворот с данными может быть 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) и запускает каждый отдельным процессом. Правила:

  1. файл, в котором выполнено 0 тестов, — ошибка (иначе пустой файл или сломанный импорт дают ложный «зелёный»);
  2. пропуск — только через scripts/python-tests-requirements.json с причиной и проверяемым условием: модуль Python (requires_module) или файл (requires_path); когда условие выполнено, тест запускается обычным порядком;
  3. --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) во временной папке.