Методика и контроль/Выпуск 0.5.1 и запуск

Финансовый выпуск 0.5.1 — исправления выплат и корпоративных действий, 21.10.2026

Выпуск 0.5.1 исправляет подтверждённые ошибки реестра выплат финансовой базы 0.5.0 и одно незаписанное дробление. Рыночный срез (16.10.2026), календарь, цены, состав индекса, синтетические модели, денежная подбаза и расчётный движок 0.5.0-rc.2 не менялись. Индикатор ширины рынка выпущен как 1.3.1: в нём заново оценены только участники, чей ряд полной доходности изменился. Архивный сценарий с фиксированным сдвигом 20 п.п. сохранён как результат 1.3.0.

Идентичность

data_version 0.5.1 = SHA-256(data_version 0.5.0 ‖ SHA-256 перечня исправлений ‖ SHA-256 сборщика). Метаданные базы содержат ссылки на предыдущий выпуск, перечень и сборщик.

Как получен выпуск

Исходный архив акций (moex_factors.sqlite), из которого движок собирает базовый слой, в рабочем окружении отсутствует, поэтому полная пересборка из первоисточника невозможна. 0.5.1 — документированный корректирующий выпуск поверх принятой 0.5.0:

1. db/corrections-0.5.1.json перечисляет 23 решения. У каждого — действие, причина и файлы-доказательства с SHA-256 (control/evidence_0_5_1/).
2. scripts/build_financial_0_5_1.py открывает 0.5.0 только для чтения, проверяет её SHA-256 и хеши всех доказательств и применяет изменения к копии.
3. Ряд полной доходности базы удовлетворяет TR_t = TR_{t−1}·(P_t·k + D)/P_{t−1}. Поэтому исправление на дату E умножает все уровни с даты E на постоянный множитель. Удаление выплаты D даёт P/(P+D), добавление — (P+D)/P, замена суммы — (P+D₁)/(P+D₀), дробление 1:k — k. Перед применением сборщик проверяет, что в 0.5.0 дневная доходность на дату E точно равна формуле со старыми данными; иначе сборка останавливается.
4. Удалённые записи переносятся в event_exclusions вместе с полным содержимым и зависимыми строками. Сырые строки distribution_evidence не удаляются. Новые решения записаны в event_reviews и sources.
5. Сборка детерминирована: два запуска дают побайтно одинаковый файл.

Исправления

Итог по последнему уровню полной доходности: GAZP −21,70%, MSNG −9,24%, MAGN −7,48%, RTKMP −7,53%, RTKM −5,59%, NLMK −2,30%, GMKN +0,007%, MSTT +17,89%. У PHOR провал на −90,8% 26.03.2012 снят; без учёта самого дробления уровень ниже на 3,88%.

Годовой контроль dividend_annual_control после исправлений согласован для GAZP 2022, GMKN 2014, MSNG 2026, NLMK 2023, PHOR 2023 и 2025, RTKM и RTKMP 2016. Расхождения MAGN 2022 и PHOR 2017 — перенос выплат между календарными годами у второго источника; суммы по смежным годам совпадают.

Исправления прежних выводов 2.4.2

• Вывод «GMKN: дубль 248 ₽ 16.06.2014, TR завышен на 3,7%» был ошибочным. Эмитент указывает реестр 17.06.2014 и 248,48 ₽. Ошибочна запись с реестром 06.06.2014, она лежит вне окна TR. Реальное влияние на ряд — только уточнение суммы, +0,007%.
• Вывод «MSTT 11,29 ₽ в декабре 2019 — база верна, okama ошибается» был ошибочным. Собрание 12.12.2019 не состоялось, выплаты не было.
• Выплаты MSTT 7,09 ₽ (2014 и 2015) есть не только в okama: их подтверждают investfunds, investmint и vsdelke, а цена на экс-даты падает на величину выплаты.

Ширина рынка 1.3.1

Принятое исследование 1.3.0 не пересчитывается целиком. scripts/correct_market_breadth.py берёт его участников и для девяти бумаг с изменённым рядом (GAZP, GMKN, MAGN, MSNG, MSTT, NLMK, PHOR, RTKM, RTKMP) пересчитывает отношение TR к SMA200 тем же правилом: 200 последовательных поддерживаемых уровней, те же даты. Перед изменением строки инструмент проверяет, что TR исследования равен финансовому TR с постоянным множителем и что отношение к SMA200 совпадает до 1e-9. Неизвестные статусы, идентичности, даты и все прочие участники не меняются.

Пересчитано 608 строк участников; статус изменился у 13 — во всех случаях с «выше» на «ниже». Число участников выше SMA200 изменилось в 12 месяцах:

Полный перечень с прежними и новыми значениями: public/market-breadth/corrections-1.3.1.json. Выгрузки 1.3.0 сохранены в public/market-breadth/archive-1.3.0/.

Влияние на результаты

Отдельная стратегия аллокации MCFTR / MM_CBR, 05.01.2015–16.10.2026, 1 000 000 ₽, расходы 10 б.п.:

Ряды 100% MCFTR и 100% MM_CBR не изменились. Пять модельных портфелей состоят из фондов и индексов и не затронуты: изменились только ссылки провенанса. Пользовательские портфели с GAZP, MAGN, NLMK, PHOR, MSTT, MSNG, RTKM, RTKMP или GMKN после переключения дадут другие результаты, поэтому прежние паспорта расчётов нужно повторить.

Проверка

Не выполнялось в этом окружении (нет входов или прав):

• полная пересборка из moex_factors.sqlite и tools/control.py --full;
• tests/synthetic-models.py --rebuild — нет сырых входов; синтетические таблицы побайтно равны 0.5.0;
• tests/market-breadth.py и tests/index-history.py с архивами;
• загрузка в рабочий D1 и HTTP-сверка;
• браузерная приёмка и нагрузка.

Открытые вопросы

• Выделение «Дорог и Мостов» из MSTT (12.10.2020) не оценено в TR. Акции новой компании не торгуются, достоверной оценки нет.
• Проверены все бумаги, которые выявили сверка с okama и годовой контроль. Остальные выплаты из одного источника (smart-lab) повторно не сверялись с НРД. Систематическая сверка всех одиночных записей с сообщениями DVCA/XMET НРД — следующий шаг.
• Прежние открытые вопросы 0.5.0 сохраняются: TCSG/AGRO RUB, неполные годовые реестры семи бумаг, правила 15 БПИФ, available_at = NULL во всех 1 312 строках event_timing.

Запуск финансового выпуска 0.5.1 на сайте — порядок действий

Переключение выполняется в два развёртывания: сначала загрузка нового среза рядом с работающим, затем переключение. Сначала рабочий API продолжает отдавать запечатанный 0.5.0, а 0.5.1 загружается в собственное пространство таблиц rf04fde3f_ через временный маршрут /api/staging/. Только после полной сверки второе развёртывание делает 0.5.1 активным и убирает маршрут загрузки. Аудитория сайта не меняется: доступ остаётся закрытым, как раньше.

Развёртывание, секреты и запросы к рабочему сайту выполняет владелец. Ключи вводятся только в скрытый stdin загрузчика; в файлы, аргументы и журналы они не попадают.

0. Предусловия

• Рабочий сайт отдаёт 0.5.0: GET /api/database/status → state: ready, data_version: e43569f3…83f1.
• Есть checkout опубликованного коммита (UI 0.13.0, данные 0.5.0) и этот пакет 0.5.1.
• Python 3.12+, Node.js 22+ и для загрузчика aiohttp (pip install aiohttp).
• На D1 есть место ещё под ~1,95 млн строк. Пространства 0.4.3 и 0.5.0 не удаляются.

Локальная репетиция обеих фаз (рабочий 0.5.0 → загрузка 0.5.1 → переключение) уже выполнена:

python3 tests/prepare-staging-rehearsal.py
node tests/staging-rehearsal.mjs        # tests/staging-rehearsal-validation.json: 10/10 PASS

1. Фаза 1 — развёртывание с маршрутом загрузки

python3 launch/apply_phase.py phase1 /path/to/live-checkout

Инструмент сначала проверяет, что checkout — проверенный рабочий 0.5.0: SHA-256 db/runtime-manifest.json, lib/sql-api.mjs, db/schema.ts и журнала миграций. Затем копирует файлы из launch/phase1-staging/:

Сборка npm run build должна показать маршруты /api/:path+ и /api/staging/:path+. После развёртывания проверить:

• GET /api/database/status → по-прежнему 0.5.0, ready;
• GET /api/staging/database/status → data_version f04fde3f…, state: uninitialized, expected_chunks: 541.

2. Загрузка 0.5.1

Нужны пакеты work/sql-seed/00000.json…00540.json и work/sql-seed/manifest.json из этого пакета; манифест совпадает с db/runtime-manifest.json побайтно.

python3 scripts/seed_site_database_async.py https://<адрес сайта> \
  --manifest db/runtime-manifest.json --seed-dir work/sql-seed \
  --api-prefix staging/ --workers 6 --report tests/staging-0.5.1-live-import.json

Загрузчик запрашивает ключ обхода и ключ импорта скрыто. Каждый пакет сверяется по SHA-256 и после записи читается обратно по всем полям. Повтор пакета допустим: ранее подтверждённый вернёт already_verified. finish проверяет число строк всех 42 таблиц, внешние ключи и метаданные, затем запечатывает выпуск (ready). После этого маршрут отвечает 403 на любую попытку загрузки.

Сверка загруженного среза до переключения. Скрипт сравнивает 290 историй со статическими выгрузками 0.5.1, а также каталог и денежную модель. Манифест и выгрузки он берёт из этого пакета, ключ обхода читает из скрытого stdin.

python3 tests/live-sql-api.py https://<адрес сайта> --api-prefix staging/ --report tests/staging-0.5.1-live-api-validation.json

3. Фаза 2 — переключение

Развернуть дерево этого пакета (данные 0.5.1, UI 0.13.0). Перед развёртыванием проверить:

python3 launch/apply_phase.py verify-phase2 .

Проверка требует, чтобы активный манифест был 0.5.1, временные файлы загрузки были удалены, миграция 0003 оставалась на месте, а public/data/catalog.json был выгрузкой 0.5.1.

После развёртывания:

• GET /api/database/status → 0.5.1, ready, 541/541 пакетов, 1 946 772 строки;
• заголовок x-portfoliolab-data-version: f04fde3f… во всех ответах API;
• GET /api/staging/... → 404;
• старые страницы с данными 0.5.0 получают при расчёте 409 «Версия страницы или данных изменилась» и должны обновиться — это штатное поведение;
• python3 tests/live-launch.py https://<адрес сайта> --quick (секрет только через скрытый stdin).

Затем отозвать временный ключ импорта. Независимо от ключа запечатанные срезы закрыты для загрузки состоянием ready.

4. Откат

Откат — повторное развёртывание прежнего коммита 0.13.0 / 0.5.0. Таблицы 0.5.0 не изменялись (это проверено в репетиции по хешам манифеста), поэтому прежний код сразу работает со своим пространством. Строки готовых срезов не перезаписываются и не удаляются.

5. Чек-лист перед открытием

Без отдельного решения владельца аудитория не меняется и публичный доступ не открывается.

Описание выпуска (Markdown)

Порядок запуска (Markdown)