Различия

Показаны различия между двумя версиями страницы.

--- sharixopen:knowledge:modules:sysadmin [2026/10/31 11:04] – [sharixknowledge] approved package sx_knowledge_api_open
+++ sharixopen:knowledge:modules:sysadmin [2026/11/04 11:09] (текущий) – [sharixknowledge] approved package sx_knowledge_api_open
@@ Строка 4: / Строка 4: @@
     "page": "sharixopen:knowledge:modules:sysadmin",
     "area": "open",
-    "type": "reference",
+    "type": "component",
     "title": "Sysadmin: установка, backup и проверки",
     "status": "review",
@@ Строка 17: / Строка 17: @@
     "extensions": {
         "taxonomy": {
-            "domain": "reference",
+            "domain": "operations",
-            "lifecycle": "unspecified",
+            "lifecycle": "implemented",
             "parents": [
                 "ShariXKnowledgeModules"
             ],
-            "terms": []
+            "terms": [
+                "product_sharix_open",
+                "product_shared",
+                "material_component",
+                "audience_developer",
+                "audience_operator",
+                "audience_administrator",
+                "audience_support",
+                "topic_operations_diagnostics",
+                "topic_handlers_runtime",
+                "topic_operations_environment"
+            ],
+            "component": "sharix_sysadmin"
         },
         "glossary": [],
@@ Строка 28: / Строка 40: @@
             "kind": "metadata_only",
             "basis": "Устаревший ID заменён действующим ID той же страницы раздела; URL и тело сохранены."
+        },
+        "classification": {
+            "schema": "sharix.knowledge.classification.v1",
+            "products": [
+                "sharix_open",
+                "shared"
+            ],
+            "audiences": [
+                "developer",
+                "operator",
+                "administrator",
+                "support"
+            ],
+            "material": "component",
+            "topics": [
+                "operations/diagnostics",
+                "handlers/runtime",
+                "operations/environment"
+            ],
+            "tag_terms": [
+                "product_sharix_open",
+                "product_shared",
+                "material_component",
+                "audience_developer",
+                "audience_operator",
+                "audience_administrator",
+                "audience_support",
+                "topic_operations_diagnostics",
+                "topic_handlers_runtime",
+                "topic_operations_environment"
+            ],
+            "registry_document": "ShariXKnowledgeClassification"
+        },
+        "handler_diagnostics_20261104": {
+            "state": "prepared_patch",
+            "owner_approved": true,
+            "runtime_verified": false,
+            "shared_command_owner": "conf.utils.handler_control",
+            "log_writer_owner": "handlers_backend",
+            "read_control_owner": "sharix_sysadmin"
         }
     },
-    "content_sha256": "e018eed2a6da8c17068fe208eb800241327ce42ca3302043ee3a8e57a53eb87b",
+    "content_sha256": "6e629497a905e0fbd88bb762c3cfc3fbd327de23b9a016cb54fb72b59e23ae6b",
     "schema": 1
 }
@@ Строка 37: / Строка 89: @@
 ~~NOCACHE~~
-**Тип:** component · **Статус:** сведения требуют сверки с действующей установкой; архитектурные правила сформулированы как целевой контракт.
+**Назначение:** описание компонента ShariX Open и общего модуля. Для разработчика, оператора, администратора и поддержки. Состояние подготовленных изменений и серверная проверка различаются в каждом разделе.
 **Раздел:** [[sharixopen:knowledge:modules:catalog|Модули Open и их обязанности]]
+**Классификация:** [[sharixopen:knowledge:classification:products|ShariX Open; общий компонент]] · [[sharixopen:knowledge:classification:materials|Описание компонента]] · [[sharixopen:knowledge:classification:topics|Диагностика, среда и runtime обработчиков]].
 ===== Ответственность =====
@@ Строка 51: / Строка 106: @@
   * [[sharixopen:knowledge:modules:installation_entitlement_health|Жизненный цикл модуля: установка, право, готовность]]
   * [[sharixopen:knowledge:development:releases|Релизы, кандидаты и безопасное обновление]]
+===== Локальные журналы и управление обработчиками: согласовано 04.11.2026 =====
+**Статус:** согласованный контракт и подготовленная поставка; применение и 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 .env ^ Результат ^
+| ''HANDLER_WEB_CONTROL_ENABLED=0'' | Значение по умолчанию: веб-управление процессами и автозапуском отключено; мониторинг и чтение локальных журналов остаются доступны по действующей политике Sysadmin. |
+| ''HANDLER_WEB_CONTROL_ENABLED=1'' | Уполномоченный действующий пользователь Sysadmin может запускать, останавливать и перезапускать только обработчики своей установки, после согласования системных разрешений root-фазой. |
+Флаг не создаёт роль и не заменяет проверку пользователя. 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. Подробный порядок фаз — [[sharixopen:knowledge:operations:deploy|Deploy ShariX Open]]. Общий код публикуется из ShariX Open; другие потребители принимают его по своему workflow.
 ~~SHARIX_KNOWLEDGE_RELATED~~