О системе FilBox

ВойтиРегистрацияПользовательское соглашениеСогласие на ПДн

Назначение: FilBox — рабочая система планирования, координации, контроля и документирования процессов Сахалинской филармонии. Система объединяет web-контур, календарь, реестры, сообщения, уведомления, bot-runtime и юридически чувствительные процессы доступа и согласий.

Текущая версия: 1.16.0 (2026-05-13)

Текущий релизный и процессный статус

  • LIVE readiness: боевой контур готов по последнему зафиксированному evidence; статус released-code-only-green-post-git-closeout-complete.
  • LIVE release: code-only релиз от 2026-05-04 закрыт зеленым; post-release smoke pass=20 fail=0, write probes skipped.
  • LIVE runtime metadata: отдельная серверная ops-запись 1.15.0 от 2026-05-05 фиксирует server-canonical refresh и не заменяется Git baseline.
  • LAB process: новый локальный Git baseline создан 2026-05-13; старая Git history не восстанавливалась, source history начинается с commit c9b4b25.
  • LIVE Git release: post-Git production code-only release от 2026-05-13 выполнен из main с --no-install --no-delete; backup checksum OK, server smoke pass=20 fail=0, write probes disabled, docs closeout commit 96238c8.
  • Parity/readiness: source parity 9/9, env parity 19/19; external dependency readiness READY, pass=28 warn=0 fail=0.
  • Recovery: actual LIVE restore/restart rehearsal закрыт; post-restore smoke pass=20 fail=0.
  • Security transport: SSH post-quantum key exchange hardening закрыт; negotiated sntrup761x25519-sha512@openssh.com.

Что такое FilBox

FilBox — это единый рабочий контур, в котором ведутся события, участники, репертуар, назначения, билеты, персоны, уведомления, служебные сообщения, экспортные сценарии и связанный юридический пакет. Система используется как в web-интерфейсе, так и через рабочие bot-контуры Telegram и MAX.

Каноничная модель эксплуатации такая: локальная система используется как первичная среда проверки и доработки, а серверный ноутбук является основным production/runtime-контуром. Это разделение закреплено в архитектурной документации и поддерживается в самих runtime-профилях.

Каноничные рабочие контуры

  • Внешний защищённый доступ: https://filbox.sakhfilarmonia.ru.
  • Локальная сеть филармонии: http://filbox.sakhfilarmonia.ru:3001/.
  • Локальный ноутбук: каноничная рабочая копия, тестовый bot-runtime, UX/smoke/regression.
  • Серверный ноутбук: основной production web/runtime и основные боты.

Git и контурный процесс

  • Git используется как локальный журнал кода, документации, скриптов и проверенных этапов после baseline от 2026-05-13.
  • Git не является источником истины для production DB, живых сессий, очередей, секретов, bot-состояния или runtime-артефактов.
  • Рабочая формула: изменения готовятся и коммитятся в LAB, боевые симптомы и live-data truth подтверждаются на LIVE, demo-контуры используют только synthetic data.
  • Документы docs/GIT_AND_CONTOUR_WORKFLOW_CANON_2026-05-13.md, docs/GIT_ACTIVATION_REPORT_2026-05-13.md и docs/GIT_DAILY_WORKFLOW_RUNBOOK_2026-05-13.md задают текущую модель работы.

Планируемый сетевой demo-контур

Для демонстраций предусмотрена отдельная demo-среда под основным доменом по пути /demo. Это не часть production-данных: demo должен работать отдельным runtime-процессом, с базой filbox_demo, отдельной cookie-сессией, синтетическими seed-данными и отключёнными live-интеграциями.

Каноничный план реализации закреплён в docs/DEMO_PUBLIC_PATH_CONTOUR_PLAN_2026-05-02.md. До завершения rollout путь /demo считается проектируемым контуром; после внедрения production-страницы входа и регистрации смогут вести туда отдельной кнопкой Демо.

Основные рабочие модули

  • Ведет календарь событий и афишу, включая ролевые режимы отображения.
  • Поддерживает реестры мероприятий, персон, участий, репертуара, назначений, билетов, площадок, подразделений и словарей.
  • Содержит витрины ускоренного ввода и операторские рабочие сценарии для событий и связанных сущностей.
  • Управляет служебными сообщениями, уведомлениями и автоматическими рассылками в system/TG/MAX.
  • Поддерживает публичную афишу, публичный просмотр события и PDF/экспортный контур.
  • Обеспечивает ролевой доступ, аудит изменений и прозрачность эксплуатационных процессов.

Доменная логика и рабочие правила

  • Мероприятия являются центром рабочего домена; с ними связаны участия, репертуар и назначения.
  • Статус Архив для мероприятий отменён; каноничный финальный статус — Исполнено.
  • При переходе мероприятия в Исполнено связанные подтверждённые участники, репертуар и назначения каскадно переходят в Исполнено.
  • Ответственные учитываются в статистике и рейтинге, а агрегаты события считают уникальных людей события без лишнего дублирования в текстовом списке.
  • Автоматические напоминания и digest-сценарии используют уже обновлённое доменное состояние.

Bot-runtime и коммуникации

  • FilBox работает с Telegram и MAX как с рабочими каналами доступа и уведомлений.
  • Локальный ноутбук использует тестовые боты, серверный — основные.
  • Система поддерживает служебные сообщения, персональные уведомления, автонапоминания и зеркалирование автоуведомлений в TG/MAX через единый dispatch-контур.
  • Для персональных bot-сценариев используется чувствительный контур связки персона <-> пользователь <-> bot profile.

Юридический контур (внедрено)

  • Публичные юридические документы доступны по маршрутам /legal/*: Terms, Consent PD, Privacy Policy, Cookie Policy, Consent Public, Consent Ads.
  • Внутренние регламенты доступны в /admin/legal?tab=guide (включая пакет B1-B7 и служебные guide/policy).
  • Журнал согласий legal_consent_log работает в append-only режиме: удаление запрещено, отзыв фиксируется отдельными полями.
  • Экспорты журнала, обращения субъектов ПДн и юридический аудит доступны в админ-контуре по ролям.
  • Архив исходных docx/pdf/zip сохранен в проекте как источник версий и основание для сверки.

Документы и источники

  • Публичные документы: A1-A6 -> legal_documents и /legal/*.
  • Внутренние документы: B1-B7 -> legal_policies и раздел /admin/legal.
  • Матрица размещения: docs/LEGAL_DOCUMENT_PLACEMENT_MATRIX_2026-03-02.md.
  • Архив пакета: data/legal/archive_20260301.
  • Каноничный пакет системной документации: архитектура, логика, стабильная эксплуатация и юридический пакет закреплены в docs/*CANON*.md.

Стабильность и эксплуатация

  • Каноничный порядок изменений: локальная правка -> локальная проверка -> code-only перенос на сервер.
  • По умолчанию не трогаются база, person-linkage и bot-linkage, если задача этого не требует напрямую.
  • Перед релизом и после него обязательны smoke-проверки и rollback backup-контур.
  • Каноничные системные документы являются частью стабильности; изменение поведения без обновления канона не считается полностью закреплённым.

Авторство и охрана

Дата создания: 01.02.2026.

Автор: Александров Илья Юрьевич, директор Сахалинской филармонии ©.

FilBox. Все права защищены.

Версионный журнал

Официальная история FilBox ведётся как каноничная линейка версий 1.x. Первый выпуск — 1.0.0 от 2026-02-01. Дальше в журнале по шагам отражено, как система расширялась от базового рабочего контура до текущего стабильного релизного состояния.

Каждая запись фиксирует не только краткий заголовок, но и подробности релиза: что именно было усилено, какие модули затронуты и какие проверки считаются обязательными после выката. Старые технические ярлыки, не входящие в каноничную линию релизов, в живом журнале больше не используются.

ДатаВерсияТипКраткоАвторУтвердилВнесено кем
2026-05-13 1.16.0 OPS
Локальный Git baseline, контурный workflow и post-Git production LIVE code-only release закреплены в FilBox.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • Создан новый локальный Git baseline с текущего workspace без восстановления старой .git history; baseline commit c9b4b25 и последующие docs/runbook-коммиты стали точкой отсчета file-level history.
  • Контурная модель теперь явно связывает LAB, LIVE, LAB-DEMO и LIVE-DEMO с Git-правилами: код и документация готовятся в LAB, live-data truth остается на LIVE, demo строится только из синтетических данных.
  • Post-Git production LIVE code-only release выполнен из main с --no-install --no-delete и with_migrations=0; backup filbox_backup_20260513_201451.dump прошел sha256 checksum OK, server smoke pass=20 fail=0 при WITH_WRITE_PROBES=0.
  • Публичное read-only proof после выката подтвердило /login 200, /about 200, /demo/login 200 и demo login -> /demo/dashboard 200; docs-only closeout зафиксирован commit 96238c8.

Затронутые модули

Git workflow, About/version journal, VERSION, Documentation ledger, Deploy/release, Backup, Server smoke, LAB, LIVE, LAB-DEMO, LIVE-DEMO

Что проверить после выката

Проверить docs/GIT_ACTIVATION_REPORT_2026-05-13.md, docs/GIT_AND_CONTOUR_WORKFLOW_CANON_2026-05-13.md, docs/GIT_DAILY_WORKFLOW_RUNBOOK_2026-05-13.md, docs/DOCUMENTATION_CHANGE_LEDGER_MAP_2026-05-13.md, docs/POST_GIT_PRODUCTION_LIVE_CODE_ONLY_RELEASE_PACKET_2026-05-13.md, server_release_20260513_091451.log и /about на LIVE.
2026-05-05 1.15.0 OPS
Серверный контур принят каноничным источником для дальнейшего ревью; локальный контур обновлен из LIVE-кода, env и базы.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • Создан fresh server source backup, сохранен local protective backup и локальный контур восстановлен из серверного DB backup.
  • Подтверждена post-sync parity: source 9/9, env 19/19, selected DB counts без drift; smoke были осознанно пропущены.
  • W4 rollout остается на hold; будущий rollout требует свежих backup, readiness, smoke и dry-run с точным owner approval.

Затронутые модули

Dual contour ops, Backup/recovery, Code review baseline, Local LAB data, About/version journal

Что проверить после выката

Проверить reports/ops/contour_compare_snapshot_20260505_161850.md, reports/ops/cleanup_obsolete_artifacts_20260505_161849.md и backup artifacts 20260505_161632/161640/161649.
2026-05-04 1.14.0 RELEASE
Release-readiness closeout закрыт: code-only LIVE релиз, restore/restart rehearsal и SSH PQ hardening подтверждены зелеными проверками.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • LIVE code-only release выполнен без DB migration, import, DB sync, restore или write-smoke в release window; post-release smoke зеленый pass=20 fail=0.
  • Post-release closeout закрыл contour parity source 9/9 и env 19/19, external dependency readiness READY pass=28 warn=0 fail=0, Employee auth-readonly, MFA/MAX API-send proof, mobile read-only audit, LAB public installability smoke и G5 recovery dry-run.
  • Actual LIVE restore/restart rehearsal выполнен по отдельному approval: release backup restored, app restarted, post-restore smoke pass=20 fail=0; SSH PQ warning closed через negotiated sntrup761x25519-sha512@openssh.com.

Затронутые модули

Release readiness, About/version journal, Dual contour operations, Backup/recovery, Server smoke, External dependencies, MFA/MAX, Mobile/PWA, SSH/OpenSSH

Что проверить после выката

Проверить docs/SYSTEM_RELEASE_READINESS_FINAL_PACKET_2026-05-04.md, docs/SYSTEM_RELEASE_READINESS_WORK_PLAN_2026-05-03.md, docs/SYSTEM_RELEASE_READINESS_SSH_PQ_HARDENING_INVENTORY_2026-05-04.md, reports/ops/live_restore_restart_rehearsal_20260504_020225.md и /about после bootstrap.
2026-04-29 1.13.0 OPS
Сведения о версиях и QA-контракт двух контуров обновлены по итогам апрельского месяца.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • Файл VERSION обновлен до 2026.04.29-dual-contour-release-notes, а публичный журнал /about получил апрельскую историю изменений по LAB и LIVE.
  • QA contract map классифицирует проверки, direct scripts, desktop Start/Stop, button runners, CI/infra, npm aliases и runbook apply snippets по безопасным контурам.
  • LIVE mutation guards теперь учитывают current Tailscale endpoint 100.121.78.64 и требуют ALLOW_LIVE_MUTATING_QA=1 для персональных, бизнес- и runtime-записей.

Затронутые модули

VERSION, About/version journal, QA contract map, LIVE mutation guard, Scripts README, Release runbooks, Desktop launchers, Button runners, CI/infra docs

Что проверить после выката

Проверить VERSION, /about после bootstrap, docs/DUAL_CONTOUR_RELEASE_VERSION_SUMMARY_2026-04-29.md, docs/QA_CONTRACT_MAP_2026-04-28.md и final coverage/gap audit checkpoint.
2026-04-24 1.12.0 RELEASE
LAB-to-LIVE UI/helper rollout выполнен через code-only release с backup, smoke и post-release proof.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • Замороженный LAB UI/helper packet выведен на LIVE через code-only release без DB migration и без blind state sync.
  • Release path создал pre-release backup, выполнил restart и server smoke, затем подтвердил живые GET /login, /about и /public/afisha.
  • После точечного /about mobile issue добавлен Card-owned inline-code wrapping; LIVE mobile check подтвердил отсутствие горизонтального overflow.

Затронутые модули

Modern UI helpers, Foundation components, Service notes UI, Card component, Public pages, About page, Backup sync, Server release smoke

Что проверить после выката

Проверить reports/ops/lab_to_live_code_only_rollout_execution_checkpoint_20260424_190729.md, lab_card_fix_code_only_rollout_execution_checkpoint_20260424_194814.md и post-rollout GET/smoke доказательства.
2026-04-18 1.11.0 RELEASE
Release-critical документация, cookie/legal/public/mobile и доменные evidence-пакеты сведены в active-layer.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • Созданы функциональная карта, матрица релизно-критичной документации и канон двух контуров LAB/LIVE.
  • Домены access/sessions/persons, legal/cookie, core registries, service notes, messages/bots, ticketing, public/mobile, backup/release и security сведены к stable active-layer.
  • Cookie transparency закреплена как Phase 1: legal-surface на login/register без ложного analytics popup до появления реальной необязательной аналитики.

Затронутые модули

Documentation, Dual contour ops, Cookie/legal surface, Public/mobile/PWA, Access, Core registries, Service notes, Bots, Ticketing, Security, Backup/release

Что проверить после выката

Проверить docs/SYSTEM_FUNCTIONAL_MAP_2026-04-18.md, RELEASE_CRITICAL_DOCUMENT_MATRIX, DUAL_CONTOUR_OPERATIONS_CANON и доменные release evidence summaries.
2026-04-12 1.10.0 MINOR
Ticketing/Radario и кодовая структура получили устойчивый автоматизированный контур.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • Собраны ticketing full-auto, Radario server automation, event-state/period-sales contract и summary truth matrix.
  • Вынесены и проверены крупные helper-слои backup, runtime, ticket import, Radario download, auto-ingest и startup jobs.
  • Зафиксирован переходный слой документации для безопасного продолжения cleanup без возврата к уже закрытым контурам.

Затронутые модули

Tickets, Radario, Ticket import, Ticket dashboard, Backup runtime, Startup jobs, Auto ingest, Codebase structure, Documentation handoff

Что проверить после выката

Проверить ticketing reports/import/backfill, Radario automation docs, target helper tests, release-safe cleanup status и отсутствие возврата к закрытым helper-pass.
2026-04-02 1.9.0 MINOR
Служебки, кадровые связки и сообщения доведены до стабильного dual-contour рабочего состояния.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • Закрыт полный локальный прогон служебок: создание, действия, черновики, PDF, ссылки, уведомления и доставка.
  • Проверены оба контура для service-notes/offday, регистрационных сценариев, штатки, вакансий и person-linkage.
  • Сообщения, каналы, операторские отчеты и daily statistics получили апрельский evidence-пакет для повседневной эксплуатации.

Затронутые модули

Service notes, Offday, Workflow, Messages, Notifications, Staffing, Persons, Person linkage, Daily statistics, PDF

Что проверить после выката

Проверить создание и согласование служебок, offday/PDF, уведомления, staffing/person-linkage и апрельские P1-P13 reports на LAB и LIVE по применимым сценариям.
2026-03-21 1.8.0 RELEASE
Экспортный хаб, стабилизация UI и каноничная системная документация закреплены в первой линии FilBox.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • Собран единый /exports-хаб с PDF-сценариями и выбором мероприятия по поиску, а формы PDF открываются в новой вкладке.
  • Доведены мобильный/desktop UX, session/runtime-устойчивость, верхний горизонтальный скролл таблиц и стабильность панели.
  • Зафиксирован полный каноничный пакет системной, архитектурной, логической, юридической и эксплуатационной документации FilBox.

Затронутые модули

Exports hub, PDF cards, Dashboard UX, Table top scroll, Sessions, About page, System docs canon, Legal docs canon

Что проверить после выката

Проверить /exports, открытие PDF в новой вкладке, главную панель, мобильный UX, /about и каноничный комплект docs/*CANON*.md.
2026-03-20 1.7.0 MINOR
Жизненный цикл мероприятий и регистрационно-ботовый контур приведены к актуальному канону.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • Статус Архив для мероприятий отменён; каноничная финальная стадия события — Исполнено, с каскадом на подтверждённые дочерние записи.
  • Усилены MAX-сценарии approve/direct-set/recovery, тестовые роли, runtime PERSON/STRP и bot-проверки.
  • Автонапоминания ответственным, WEEK/Festi, PDF-месяца и каноничный учёт людей события доведены до рабочего состояния.

Затронутые модули

Event lifecycle, Participations/Repertoire/Assignments cascade, MAX access flow, PERSON/STRP, Auto notifications, Festi, WEEK, PDF month

Что проверить после выката

Проверить статусы мероприятий, MAX approve/direct-set/recovery, TG/MAX PERSON/STRP, WEEK/Festi и PDF-контур.
2026-03-17 1.6.0 MINOR
Операторские витрины и массовые рабочие сценарии доведены до стабильного уровня.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • Усилены витрины ввода участников, репертуара и назначений, пакетные действия и поведение реестров.
  • Завершён большой этап codebase hardening и разборки монолита на устойчивые рабочие блоки.
  • Операторский UX и regression-контур получили стабильную базу для повседневной работы.

Затронутые модули

Participations showcase, Repertoire showcase, Assignments showcase, Batch actions, Operator UX, Codebase hardening

Что проверить после выката

Проверить витрины, пакетные операции, сохранение записей, операторские таблицы и регрессионный проход по ролям.
2026-03-12 1.5.0 MINOR
Серверный release-контур и правила стабильной эксплуатации выведены в production-режим.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • Закреплены серверный bootstrap, backup/release/smoke/rollback и runbook-пакет.
  • Разделены локальный test-runtime и серверный main-runtime для ботов и рабочих контуров.
  • Стабильная эксплуатация стала отдельной частью каноничного пакета FilBox.

Затронутые модули

Server runtime, Release contour, Backups, Restore drill, Smoke, Runtime profiles, Runbooks

Что проверить после выката

Проверить релизный сценарий, backup/restore, restart, smoke, разделение local/test и server/main.
2026-03-02 1.4.0 MINOR
Персоны, связки доступа и юридический контур закреплены как канон FilBox.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • Person registry, связки персона-пользователь-бот и регистрационный поток приведены к единой модели.
  • Внедрён полный юридический пакет A1-A6/B1-B7, append-only журнал согласий и профильный admin/legal-контур.
  • Юридически чувствительные документы, согласия, re-accept и выгрузки зафиксированы как часть рабочего контура системы.

Затронутые модули

Persons, Registration, Person/User/Bot linkage, Legal, legal_documents, legal_consent_log, admin/legal

Что проверить после выката

Проверить /register, approve/reject, person linkage, /legal/*, /legal/reaccept, /admin/legal и выгрузки.
2026-02-27 1.3.0 MINOR
Сообщения, уведомления и базовый TG/MAX dispatch-контур закреплены как рабочие.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • Собран единый модуль сообщений, inbox-уведомлений и очередей отправки.
  • TG/MAX выведены в каноничный коммуникационный контур с журналами доставки, очередями и runtime-конфигом.
  • Weekly/Festi и другие bot-сценарии получили базовую рабочую инфраструктуру.

Затронутые модули

Messages, Notifications, message_queue, TG_CFG, TG_USERS, TG_LOGS, MAX runtime, Inbox

Что проверить после выката

Проверить историю уведомлений, ручную и queued-отправку, базовые TG/MAX-сценарии и журналы доставки.
2026-02-18 1.2.0 MINOR
Календарь, публичная афиша и PDF-контур выведены в рабочий режим.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • Календарь получил рабочие режимы all/afisha, drilldown карточки событий, фильтры и цветовую статусную модель.
  • Публичная афиша и публичная карточка события стали доступны без регистрации.
  • Появились базовые PDF-экспорты для календаря, недели, витрин и карточек событий.

Затронутые модули

Calendar, Public Afisha, Public Event, PDF export routes, Status rendering, Calendar filters

Что проверить после выката

Проверить /calendar, /public/afisha, карточку события, PDF-экспорт и соответствие статусов цветовой легенде.
2026-02-10 1.1.0 MINOR
Роли, доступ и базовые реестры выведены в единый рабочий web-контур.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • Закреплены ролевые сценарии Director/Owner, Admin, Operator, Employee, Artist, Viewer.
  • Login унифицирован по email и телефону, а базовые реестры стали доступны в одном рабочем shell.
  • Заложена матрица прав, scope-override и русскоязычная структура меню для операторской работы.

Затронутые модули

Login, Роли, Права, Scope, Events, Persons, Participations, Repertoire, Assignments, Dictionaries, Navigation

Что проверить после выката

Проверить вход по ролям, переходы по меню, чтение/редактирование реестров, корректность role/scope-ограничений.
2026-02-01 1.0.0 MAJOR
Первый каноничный выпуск FilBox и старт рабочего контура системы.
 Александров Илья Юрьевич, директор Сахалинской филармонии © Директор Каноническая запись

Подробности релиза

  • Запущен единый рабочий контур FilBox как системы планирования, координации, контроля и документирования процессов филармонии.
  • Зафиксирован базовый каркас ролей, аутентификации, календаря, реестров, операторской работы, внутренних уведомлений и bot/runtime-контуров.
  • Эта запись считается точкой отсчета официальной истории версий FilBox.

Затронутые модули

Web, Роли и доступ, Календарь, Афиша, Мероприятия, Персоны, Участия, Репертуар, Назначения, Сообщения, Уведомления, TG/MAX

Что проверить после выката

Проверить запуск web-контура, вход по ролям, календарь, базовые реестры, сообщения, уведомления и базовый bot/runtime-контур.