Назначение: описание компонента ShariX Open и общего модуля. Для разработчика, оператора, администратора и поддержки. Состояние подготовленных изменений и серверная проверка различаются в каждом разделе.

Раздел: Модули Open и их обязанности

Классификация: ShariX Open; общий компонент · Описание компонента · Диагностика, среда и runtime обработчиков.

Единый установщик/обновлятор, контроль модулей, конфигурационные проверки, журналирование, резервные копии и диагностика процессов.

Отображает source/license, установленность, entitlement, готовность и проблемы runtime отдельно. Дополнительный модуль не должен создавать собственный конкурирующий инсталлятор.

Конфигурация экземпляра и токены остаются локальными; автоматическое обновление не стирает настройки и сохраняет проверяемый путь отката.

• Жизненный цикл модуля: установка, право, готовность
• Релизы, кандидаты и безопасное обновление

Статус: согласованный контракт и подготовленная поставка; применение и runtime конкретного сервера ещё не подтверждены.

Журналы приложения находятся в logs/handlers/<handler_id>.log внутри своей установки. Общий handlers_backend пишет записи с UTC timestamp, уровнем и traceback; файл ротируется около 2 MiB, сохраняется пять предыдущих файлов. Каталог готовит штатный root activate. Импорт и bootstrap smoke не создают журналов. Известные credentials маскируются; код операций по-прежнему не должен писать секреты и лишние персональные данные. Это диагностические файлы, а не неизменяемая история заявок.

В Sysadmin у обработчика есть отдельные ссылки на локальный журнал приложения и системный журнал unit. Локальный источник выбирается по ID установленного каталога, поддерживает период, уровень и текстовый фильтр, включая сопутствующий traceback. Период интерпретируется в текущем часовом поясе Django. Чтение ограничено по объёму; неизвестные ID, ссылки и файлы специального типа отвергаются. Отсутствие файла или прав показывается явно. Ошибки systemd до запуска Python остаются в journald. Доступ ко всему системному журналу ради локальной диагностики не выдаётся.

Флаг не создаёт роль и не заменяет проверку пользователя. Root activate выдаёт либо отзывает managed sudo-разрешения на точные команды и имена handler unit. Повторный activate приводит их к текущему флагу. Флаг читается из root .env каноническим parser; допустимы буквальные 0/1, кавычки и комментарии, неоднозначные дубликаты блокируют активацию. Обычный deploy/restart проверяет регистрацию и останавливается при её отсутствии или расхождении с флагом. Настройки работающего веб-процесса перечитываются штатным restart. Новый root helper, wildcard-разрешения и запись runtime во всё conf-real не добавляются.

Изменение версии/режима, затрагивающее автозапуск, также требует включённого управления. Обычная команда запуска/остановки/перезапуска ставится в очередь systemd: её принятие не доказывает итоговое состояние или HEALTHY. Смена ключа включённого обработчика требует этого же права, но ожидает завершения перезапуска перед отзывом старого ключа. При выключенном управлении такая смена отклоняется до изменения ключей; для отключённого обработчика подготовка ключа остаётся доступна.

При переключении на 0 необходимо повторить root activate и штатный deploy-account restart. Успешно опубликованное удаление grants не откатывается к разрешающей версии при поздней ошибке регистрации. Ошибка активации остаётся блокирующей; её нужно устранить и повторить фазу. Существующие права deploy-аккаунта, ранее действовавший отдельный механизм перезапуска основного Django и внешняя политика администратора ОС этим флагом не изменяются.

Проверка подготовленной поставки: 55 installation contracts ShariX Open, общий runtime и независимые fixtures регистрации/отзыва обеих сборок; отдельные проверки чтения/фильтров, пользовательского доступа, локализации и PageHelp. Системные вызовы в fixtures изолированы; живые LDAP/XMPP/PostgreSQL, системные права сервера и браузерная работа на установке ещё подлежат обычной приёмке. Отключённые модули не включаются ради проверки.

Поставка: open-handler-logs-web-control-20261104.patch. Подробный порядок фаз — Deploy ShariX Open. Общий код публикуется из ShariX Open; другие потребители принимают его по своему workflow.