ShariX Open Docs

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
<sharix-knowledge-meta>
{
    "id": "ShariXKnowledgeClassificationTopics",
    "page": "sharixopen:knowledge:classification:topics",
    "area": "open",
    "type": "reference",
    "title": "Темы и понятия базы знаний",
    "status": "review",
    "schema_version": 1,
    "relations": {
        "related_to": [
            "ShariXKnowledgeClassification",
            "ShariXKnowledgeServiceRequestDeclinedBPMN",
            "ShariXKnowledgeOpenKnowledgeDomainDocuments",
            "ShariXKnowledgeOpenKnowledgeDomainRequirements",
            "ShariXKnowledgeOpenKnowledgeModulesCapabilityresolution",
            "ShariXKnowledgeOpenKnowledgeModulesHandlerdiscovery",
            "ShariXKnowledgeLayerModel",
            "ShariXKnowledgeOpenKnowledgeArchitectureSystemlayers"
        ]
    },
    "extensions": {
        "taxonomy": {
            "domain": "glossary",
            "lifecycle": "not_applicable",
            "component": "ShariX Knowledge documentation",
            "parents": [
                "ShariXKnowledgeClassification"
            ],
            "terms": [
                "product_sharix_open",
                "audience_developer",
                "audience_integrator",
                "audience_reviewer",
                "audience_ai",
                "material_index",
                "topic_knowledge_navigation"
            ]
        },
        "glossary": {
            "topic_api_contracts": "API → Контракты: Входные данные, actor, объект, операция, ответ и отказы.",
            "topic_architecture_boundaries": "Архитектура → Границы: Разделение модулей, продуктов и лицензионных областей.",
            "topic_architecture_models": "Архитектура → Владение моделями: Кто определяет данные и операции над ними.",
            "topic_design_components": "Интерфейс → Библиотека элементов: Повторное использование общих шаблонов и поведения.",
            "topic_design_forms": "Интерфейс → Формы: Подписи, ввод, ошибки, focus и доступность.",
            "topic_development_context": "Разработка → Исходный контекст: Архивы исходников, версии и статические графы.",
            "topic_development_delivery": "Разработка → Передача изменений: Состав поставки, инструкции, совместимость и передача ответственности.",
            "topic_development_git": "Разработка → Git: Репозитории, ветки, исходные commits и публикация.",
            "topic_development_methods": "Разработка → Методы: Маршрут анализа и изменения продукта.",
            "topic_development_verification": "Разработка → Проверка: Критерии, доказательства и ограничения приёмки.",
            "topic_handlers_blockly": "Обработчики → Blockly: Канонический workspace, генерация Python и происхождение файлов.",
            "topic_handlers_permissions": "Обработчики → ACCESS_REQUEST: Заявки полномочий и безопасная обработка отказа.",
            "topic_handlers_relationships": "Обработчики → NEG_REQUEST: Запросы Relationship, требования и активация.",
            "topic_handlers_runtime": "Обработчики → Runtime: Очередь, XMPP, события, defer и восстановление.",
            "topic_handlers_support": "Обработчики → ST_REQUEST: Стандартные заявки и передача их по стадиям.",
            "topic_knowledge_navigation": "База знаний → Навигация: Постоянные страницы, родители, связи и рубрикатор.",
            "topic_knowledge_source_evidence": "База знаний → Основания сведений: Что подтверждено исходниками, проверкой сервера или согласованным правилом.",
            "topic_operations_diagnostics": "Эксплуатация → Диагностика: Службы, предупреждения, зависимости и наблюдаемый результат.",
            "topic_operations_environment": "Эксплуатация → Среда: Пользователи, зависимости и исходное состояние установки.",
            "topic_operations_install": "Эксплуатация → Установка: Подготовка, deploy, restart и проверка запуска.",
            "topic_orders_assignment": "Заказы → Назначение: Предложение исполнителя, доступность и переход к подбору.",
            "topic_orders_creation": "Заказы → Создание и черновик: Создание записи, размещение, предупреждения и повтор.",
            "topic_orders_execution": "Заказы → Исполнение: Workspace, Stage, материалы и локальный результат.",
            "topic_orders_lifecycle": "Заказы → Жизненный цикл: Допустимые действия, сохранённое состояние и смена владельца.",
            "topic_orders_model": "Заказы → Модель: Различие Orders, Ticket и локальных данных.",
            "topic_orders_payments": "Заказы → Финализация оплаты: Платёжное состояние и отдельный gate закрытия.",
            "topic_security_object_access": "Доступ → Объектные права: Проверка actor, объекта и области данных.",
            "topic_security_permissions": "Доступ → Полномочия: Предметное Permissions отличается от членства в группе.",
            "topic_security_requirements": "Доступ → Требования: Подготовка проверок и gate активации.",
            "topic_service_configuration": "Сервис → Настройка: Граница настройки процесса и её источников; закрытые детали остаются внутри.",
            "topic_service_model": "Сервис → Концепция: Предметное назначение услуги и цифровой координации.",
            "topic_service_partner_onboarding": "Сервис → Подключение партнёра: Company, полномочия и договорные запросы.",
            "access_request": "ACCESS_REQUEST: заявка предметного полномочия; не равна членству в LDAP/Django-группе.",
            "api_capability": "Capability handler: узко разрешённая workflow-операция вместе с identity и object scope; не общий CRUD-доступ.",
            "blockly": "Blockly workspace: типизированный редактируемый источник, из которого генерируется исполняемый Python.",
            "bpmn": "BPMN: описательная схема участников, действий, событий и ожиданий; просмотрщик не исполняет обработчик.",
            "generated_python": "Generated Python: полученный из канонического источника файл; соответствие проверяется повторной генерацией.",
            "grace_period": "Контрольный срок: именованное ожидание от предусмотренного поля времени; не универсальный SLA-таймер.",
            "model_owner": "Владелец модели: модуль, определяющий смысл, структуру и допустимые операции изменения данных.",
            "neg_request": "NEG_REQUEST: заявка, сопровождающая Relationship; её статус и активность связи различаются.",
            "object_scope": "Object scope: ограничение объекта областью данных, actor и текущим состоянием.",
            "order": "Orders: общая запись заказа dbsynce; её ID отличается от Ticket ID.",
            "order_intent": "Намерение заказа: запрос пользователя, переданный handler; relay-подтверждение не доказывает исполнения.",
            "payment_state": "Платёжное состояние: данные выбранного платёжного владельца; success одного retry не заменяет gate закрытия.",
            "pending_at": "pending_at: вычисленная временная граница перехода планового BOOKED-заказа к PENDING.",
            "permissions": "Permissions: предметное полномочие пользователя, его статус и связанный запрос; отличается от членства в группе.",
            "provenance": "Provenance: сведения об исходных файлах, генераторе и контрольных суммах; не заменяют поведенческую проверку.",
            "provider_offer": "Provider: предложение исполнителя с пользователем, услугой, компанией и при необходимости ресурсом.",
            "relationship": "Relationship: направленная связь user_who/user_whom с типом, областью компании и собственным статусом.",
            "requirements": "Requirements: обязательные условия, доказательства и проверки, учитываемые перед доменным действием.",
            "service_request": "SERVICE_REQUEST: Ticket жизненного цикла заказа.",
            "source_evidence": "Свидетельство по исходникам: точная версия и прочитанная операция; не подтверждение установленного сервера.",
            "st_request": "ST_REQUEST: стандартная заявка; в рассмотренных процессах в том числе запрос проверки. Не подменяет произвольный тип заявки.",
            "ticket": "Ticket: типизированная заявка с lifecycle, событиями и ссылками на предметные данные.",
            "ticket_accepted": "ACCEPTED: заявка принята; выполнение требований и активация связанного объекта проверяются отдельно.",
            "ticket_booked": "BOOKED: размещённый заказ до следующего действия или перехода; это не подтверждение принятия исполнителем.",
            "ticket_closed": "CLOSED: терминальное закрытие Ticket; не физическое удаление связанных данных.",
            "ticket_declined": "DECLINED: отклонённый запрос или заказ; дальнейшие действия зависят от ticket_type.",
            "ticket_done": "DONE: завершение работы/решение соответствующего типа Ticket; финансовое закрытие или активация имеют отдельные условия.",
            "ticket_pending": "PENDING: именованная стадия Ticket; числовой код и допустимые действия зависят от ticket_type.",
            "ticket_template": "TEMPLATE: существующий черновик заказа.",
            "ticket_in_process": "IN_PROCESS — обращение ST_REQUEST находится в работе; профильная проверка определяется стабильным контрактом.",
            "ticket_duplicate": "DUPLICATE — ST_REQUEST признан дубликатом; сам статус не означает переноса содержимого или закрытия.",
            "ticket_reopened": "REOPENED — ST_REQUEST переоткрыт и ожидает нового решения о назначении; это не новая доменная попытка проверки.",
            "ticket_pre_forcemajeuer": "PRE_FORCEMAJEUER — техническое имя проблемной стадии заказа, ожидающей внешнего разбора; написание сохранено как в коде.",
            "external_resolution": "Внешний разбор — решение уполномоченного участника через канонические операции; observer лишь наблюдает состояние.",
            "verification_workflow": "Профильный workflow — обработка document-verification-v1 или requirement-check-v1 через scoped API с доменным результатом.",
            "topic_documents_lifecycle": "Документы → Жизненный цикл: Черновик, версии, проверка, согласие, переиспользование и доступ к файлам.",
            "topic_modules_availability": "Модули → Доступность: Обнаружение, установка, entitlement, конфигурация, provider и runtime health."
        },
        "classification": {
            "schema": "sharix.knowledge.classification.v1",
            "products": [
                "sharix_open"
            ],
            "audiences": [
                "developer",
                "integrator",
                "reviewer",
                "ai"
            ],
            "material": "index",
            "topics": [
                "knowledge/navigation"
            ],
            "tag_terms": [
                "product_sharix_open",
                "audience_developer",
                "audience_integrator",
                "audience_reviewer",
                "audience_ai",
                "material_index",
                "topic_knowledge_navigation"
            ]
        },
        "classification_review": {
            "date": "2026-10-31",
            "scope": "Реестр используемых терминов и навигационные указатели; роли не выдают ACL."
        }
    },
    "content_sha256": "ef649c9a57da3efe25cb5ed3879d3a935e1a68cf9baed726c95b9aa12a249b52",
    "schema": 1
}
</sharix-knowledge-meta>
====== Темы и понятия базы знаний ======
~~NOCACHE~~

**Навигация:** [[sharixopen:knowledge:start|База знаний]] → [[sharixopen:knowledge:classification:start|Рубрикатор]] → Тема.

Метки описывают содержание и назначение материала; они не выдают доступ и не подтверждают выполнение серверных проверок.

Путь темы задаёт вложенность: сначала область, затем конкретный вопрос. Технический код метки стабилен; читаемое название и определение находятся ниже.

===== API =====
==== Контракты ====
Входные данные, actor, объект, операция, ответ и отказы.

**Код метки:** topic_api_contracts.

  * [[sharixopen:knowledge:architecture:api_contracts|API ShariX Open: операции, доступ и взаимодействие модулей]].
  * [[sharixopen:knowledge:modules:backend_dbsynce|Backend/dbsynce: синхронизируемые сущности]].
  * [[sharixopen:knowledge:modules:webservice_running|Webservice Running: локальные данные и исполнение заказа]].
  * [[sharixopen:knowledge:integrations:start|Интеграции Open]].
  * [[sharixopen:knowledge:scenarios:order_create|Создание заказа через API: транзакция, ответ и внешние события]].

  * [[sharixopen:knowledge:architecture:system_layers|Слои архитектуры и разделение ответственности]].

  * [[sharixopen:knowledge:domain:provider_selection_target|Подбор исполнителя: требования к дальнейшей реализации]].

===== Архитектура =====
==== Границы ====
Разделение модулей, продуктов и лицензионных областей.

**Код метки:** topic_architecture_boundaries.

  * [[sharixopen:knowledge:architecture:start|Архитектура ShariX Open]].
  * [[sharixopen:knowledge:architecture:model_ownership|Владение моделями: где изменять данные ShariX Open]].
  * [[sharixopen:knowledge:modules:start|Компоненты и модули Open]].
  * [[sharixopen:knowledge:modules:constructor|Конструктор сервиса: закрытый компонент]].
  * [[sharixopen:knowledge:modules:catalog|Модули Open и их обязанности]].
  * [[sharixopen:knowledge:development:shared_change_flow|Общие модули ShariX Open: публикация и передача ответственному]].

  * [[sharixopen:knowledge:modules:capability_resolution|Capability resolution и проверяемые зависимости]].

  * [[sharixopen:knowledge:architecture:layers|Уровни системы и источники истины]].

  * [[sharixopen:knowledge:architecture:system_layers|Слои архитектуры и разделение ответственности]].

==== Владение моделями ====
Кто определяет данные и операции над ними.

**Код метки:** topic_architecture_models.

  * [[sharixopen:knowledge:modules:backend_dbsynce|Backend/dbsynce: синхронизируемые сущности]].
  * [[sharixopen:knowledge:modules:webservice_running|Webservice Running: локальные данные и исполнение заказа]].
  * [[sharixopen:knowledge:architecture:model_ownership|Владение моделями: где изменять данные ShariX Open]].
  * [[sharixopen:knowledge:domain:order_ticket|Заказ, Ticket и PROCESS]].
  * [[sharixopen:knowledge:foundation:service_model|Концепция сервиса и назначение цифровой координации]].

  * [[sharixopen:knowledge:scenarios:neg_request_declined|NEG_REQUEST в DECLINED: сохранение active Relationship и очистка после срока]].

  * [[sharixopen:knowledge:architecture:layers|Уровни системы и источники истины]].

  * [[sharixopen:knowledge:architecture:system_layers|Слои архитектуры и разделение ответственности]].

===== Интерфейс =====
==== Библиотека элементов ====
Повторное использование общих шаблонов и поведения.

**Код метки:** topic_design_components.

  * [[sharixopen:knowledge:modules:design_template|Design Template: как использовать общие элементы интерфейса]].

==== Формы ====
Подписи, ввод, ошибки, focus и доступность.

**Код метки:** topic_design_forms.

  * [[sharixopen:knowledge:modules:design_template|Design Template: как использовать общие элементы интерфейса]].

===== Разработка =====
==== Исходный контекст ====
Архивы исходников, версии и статические графы.

**Код метки:** topic_development_context.

  * [[sharixopen:knowledge:development:source_bundle_context|Архив исходников ShariX Open: получение и работа с Graphify]].

==== Передача изменений ====
Состав поставки, инструкции, совместимость и передача ответственности.

**Код метки:** topic_development_delivery.

  * [[sharixopen:knowledge:development:human_ai_handoff|Как подготовить изменение и инструкцию для оператора]].
  * [[sharixopen:knowledge:development:repository_flow|Как публиковать общий код ShariX Open и передавать изменение на проверку]].
  * [[sharixopen:knowledge:development:shared_change_flow|Общие модули ShariX Open: публикация и передача ответственному]].
  * [[sharixopen:knowledge:development:acceptance|Приёмка изменений ShariX Open: проверки, миграции и результат]].
  * [[sharixopen:knowledge:development:start|Разработка ShariX Open]].

==== Git ====
Репозитории, ветки, исходные commits и публикация.

**Код метки:** topic_development_git.

  * [[sharixopen:knowledge:development:repository_flow|Как публиковать общий код ShariX Open и передавать изменение на проверку]].

  * [[sharixopen:knowledge:scenarios:repository_update_watch|Монитор обновлений repository_update_watch]].

==== Методы ====
Маршрут анализа и изменения продукта.

**Код метки:** topic_development_methods.

  * [[sharixopen:knowledge:development:methodology:start|Методология разработки и ведения знаний]].
  * [[sharixopen:knowledge:development:start|Разработка ShariX Open]].
  * [[sharixopen:knowledge:development:practice|Разработка ShariX Open: от задачи до опубликованного изменения]].
  * [[sharixopen:knowledge:standards:start|Стандарты решений и изменений]].

  * [[sharixopen:knowledge:classification:maintenance|Как поддерживать классификацию и рубрикатор]].

==== Проверка ====
Критерии, доказательства и ограничения приёмки.

**Код метки:** topic_development_verification.

  * [[sharixopen:knowledge:development:human_ai_handoff|Как подготовить изменение и инструкцию для оператора]].
  * [[sharixopen:knowledge:architecture:source_of_truth|Как проверять сведения о коде, установке и планах разработки]].
  * [[sharixopen:knowledge:development:acceptance|Приёмка изменений ShariX Open: проверки, миграции и результат]].
  * [[sharixopen:knowledge:development:verification|Проверка изменений и критерии приёмки]].
  * [[sharixopen:knowledge:development:practice|Разработка ShariX Open: от задачи до опубликованного изменения]].

===== Обработчики =====
==== Blockly ====
Канонический workspace, генерация Python и происхождение файлов.

**Код метки:** topic_handlers_blockly.

  * [[sharixopen:knowledge:modules:handlers|Обработчики ShariX Open: Blockly, Python и выполнение]].

  * [[sharixopen:knowledge:scenarios:st_request_inprocess|ST_REQUEST в работе: обычное обращение и профильная проверка]].

  * [[sharixopen:knowledge:scenarios:basic_bot|Диагностический XMPP-обработчик open_basic_bot]].

  * [[sharixopen:knowledge:scenarios:st_request_wontfix|ST_REQUEST в WONTFIX: отрицательный результат и решение о закрытии]].

  * [[sharixopen:knowledge:scenarios:repository_update_watch|Монитор обновлений repository_update_watch]].

  * [[sharixopen:knowledge:classification:handler_terms|Термины обработчиков и фоновых процессов]].

  * [[sharixopen:knowledge:scenarios:teltonika_gps_tracker|Приёмник Teltonika open_teltonika_gps_tracker]].

  * [[sharixopen:knowledge:scenarios:st_request_done|ST_REQUEST в DONE: подтверждение закрытия и завершение проверки]].

  * [[sharixopen:knowledge:scenarios:report_handler|Сборщик служебных отчётов open_report_handler]].

  * [[sharixopen:knowledge:modules:handler_discovery|Registry обработчиков и доступность capabilities]].

==== ACCESS_REQUEST ====
Заявки полномочий и безопасная обработка отказа.

**Код метки:** topic_handlers_permissions.

  * [[sharixopen:knowledge:scenarios:access_request_declined|ACCESS_REQUEST в DECLINED: контрольный срок и безопасная очистка]].

  * [[sharixopen:knowledge:scenarios:access_request_pending|ACCESS_REQUEST в PENDING: рассмотрение запроса на право]].

  * [[sharixopen:knowledge:scenarios:access_request_accepted|ACCESS_REQUEST в ACCEPTED: требования и активация права]].

==== NEG_REQUEST ====
Запросы Relationship, требования и активация.

**Код метки:** topic_handlers_relationships.

  * [[sharixopen:knowledge:scenarios:neg_request_accepted|NEG_REQUEST в ACCEPTED: активация Relationship и срок закрытия]].
  * [[sharixopen:knowledge:scenarios:neg_request_pending|NEG_REQUEST в PENDING: решение по Relationship и граница API scope]].
  * [[sharixopen:knowledge:scenarios:partner_request|Подача и обработка заявки партнёра]].

  * [[sharixopen:knowledge:scenarios:neg_request_declined|NEG_REQUEST в DECLINED: сохранение active Relationship и очистка после срока]].

==== Runtime ====
Очередь, XMPP, события, defer и восстановление.

**Код метки:** topic_handlers_runtime.

  * [[sharixopen:knowledge:scenarios:service_request_booked|SERVICE_REQUEST в BOOKED: ожидание исполнителя и окно PENDING]].
  * [[sharixopen:knowledge:scenarios:service_request_template|SERVICE_REQUEST в TEMPLATE: черновик, действия клиента и напоминания]].
  * [[sharixopen:knowledge:processes:start|Исполнение заказа и процессы]].
  * [[sharixopen:knowledge:scenarios:st_request_waiting|Новая ST_REQUEST: ожидание, очередь и переход в ASSIGNED]].
  * [[sharixopen:knowledge:modules:handlers|Обработчики ShariX Open: Blockly, Python и выполнение]].
  * [[sharixopen:knowledge:scenarios:start|Сценарии ShariX Open: выбор процесса и проверка результата]].

  * [[sharixopen:knowledge:scenarios:st_request_duplicate|ST_REQUEST-дубликат: ожидание решения о закрытии]].

  * [[sharixopen:knowledge:scenarios:st_request_reopened|Повторно открытая ST_REQUEST: ожидание назначения]].

  * [[sharixopen:knowledge:scenarios:access_request_pending|ACCESS_REQUEST в PENDING: рассмотрение запроса на право]].

  * [[sharixopen:knowledge:scenarios:service_request_preforcemajeure|SERVICE_REQUEST в PRE_FORCEMAJEUER: ожидание внешнего решения]].

  * [[sharixopen:knowledge:scenarios:service_request_prestart|SERVICE_REQUEST в PRE_START: начало выполнения и внешние действия]].

  * [[sharixopen:knowledge:scenarios:basic_bot|Диагностический XMPP-обработчик open_basic_bot]].

  * [[sharixopen:knowledge:classification:handler_terms|Термины обработчиков и фоновых процессов]].

  * [[sharixopen:knowledge:scenarios:st_request_assigned|Назначенная заявка ST_REQUEST: ручное начало работы и автоматический переход]].

  * [[sharixopen:knowledge:scenarios:service_request_forcemajeure|SERVICE_REQUEST в FORCEMAJEUER: ожидание внешнего решения]].

  * [[sharixopen:knowledge:scenarios:neg_request_declined|NEG_REQUEST в DECLINED: сохранение active Relationship и очистка после срока]].

  * [[sharixopen:knowledge:scenarios:teltonika_gps_tracker|Приёмник Teltonika open_teltonika_gps_tracker]].

  * [[sharixopen:knowledge:scenarios:service_request_pending|SERVICE_REQUEST в PENDING: партии кандидатов и назначение победителя]].

  * [[sharixopen:knowledge:scenarios:report_handler|Сборщик служебных отчётов open_report_handler]].

  * [[sharixopen:knowledge:scenarios:service_request_declined|SERVICE_REQUEST в DECLINED: возврат в BOOKED и резервное закрытие]].

  * [[sharixopen:knowledge:modules:handler_discovery|Registry обработчиков и доступность capabilities]].

==== ST_REQUEST ====
Стандартные заявки и передача их по стадиям.

**Код метки:** topic_handlers_support.

  * [[sharixopen:knowledge:scenarios:st_request_waiting|Новая ST_REQUEST: ожидание, очередь и переход в ASSIGNED]].

  * [[sharixopen:knowledge:scenarios:st_request_inprocess|ST_REQUEST в работе: обычное обращение и профильная проверка]].

  * [[sharixopen:knowledge:scenarios:st_request_duplicate|ST_REQUEST-дубликат: ожидание решения о закрытии]].

  * [[sharixopen:knowledge:scenarios:st_request_reopened|Повторно открытая ST_REQUEST: ожидание назначения]].

  * [[sharixopen:knowledge:scenarios:st_request_wontfix|ST_REQUEST в WONTFIX: отрицательный результат и решение о закрытии]].

  * [[sharixopen:knowledge:scenarios:st_request_assigned|Назначенная заявка ST_REQUEST: ручное начало работы и автоматический переход]].

  * [[sharixopen:knowledge:scenarios:st_request_done|ST_REQUEST в DONE: подтверждение закрытия и завершение проверки]].

===== База знаний =====
==== Навигация ====
Постоянные страницы, родители, связи и рубрикатор.

**Код метки:** topic_knowledge_navigation.

  * [[sharixopen:knowledge:foundation:start|ShariX Open: основы и карта базы знаний]].
  * [[sharixopen:knowledge:start|База знаний ShariX Open]].
  * [[sharixopen:knowledge:development:methodology:start|Методология разработки и ведения знаний]].
  * [[sharixopen:knowledge:scenarios:start|Сценарии ShariX Open: выбор процесса и проверка результата]].

  * [[sharixopen:knowledge:classification:maintenance|Как поддерживать классификацию и рубрикатор]].

  * [[sharixopen:knowledge:classification:handler_terms|Термины обработчиков и фоновых процессов]].

  * [[sharixopen:knowledge:architecture:layers|Уровни системы и источники истины]].

==== Основания сведений ====
Что подтверждено исходниками, проверкой сервера или согласованным правилом.

**Код метки:** topic_knowledge_source_evidence.

  * [[sharixopen:knowledge:development:source_bundle_context|Архив исходников ShariX Open: получение и работа с Graphify]].
  * [[sharixopen:knowledge:architecture:source_of_truth|Как проверять сведения о коде, установке и планах разработки]].
  * [[sharixopen:knowledge:development:verification|Проверка изменений и критерии приёмки]].

===== Эксплуатация =====
==== Диагностика ====
Службы, предупреждения, зависимости и наблюдаемый результат.

**Код метки:** topic_operations_diagnostics.

  * [[sharixopen:knowledge:operations:start|Эксплуатация ShariX Open]].

  * [[sharixopen:knowledge:scenarios:basic_bot|Диагностический XMPP-обработчик open_basic_bot]].

  * [[sharixopen:knowledge:scenarios:repository_update_watch|Монитор обновлений repository_update_watch]].

  * [[sharixopen:knowledge:scenarios:teltonika_gps_tracker|Приёмник Teltonika open_teltonika_gps_tracker]].

  * [[sharixopen:knowledge:scenarios:report_handler|Сборщик служебных отчётов open_report_handler]].

  * [[sharixopen:knowledge:modules:capability_resolution|Capability resolution и проверяемые зависимости]].

==== Среда ====
Пользователи, зависимости и исходное состояние установки.

**Код метки:** topic_operations_environment.

  * [[sharixopen:knowledge:operations:installation_requirements|Установка ShariX Open: требования к среде и удобство настройки]].

==== Установка ====
Подготовка, deploy, restart и проверка запуска.

**Код метки:** topic_operations_install.

  * [[sharixopen:knowledge:operations:installation_requirements|Установка ShariX Open: требования к среде и удобство настройки]].
  * [[sharixopen:knowledge:operations:start|Эксплуатация ShariX Open]].

===== Заказы =====
==== Назначение ====
Предложение исполнителя, доступность и переход к подбору.

**Код метки:** topic_orders_assignment.

  * [[sharixopen:knowledge:scenarios:service_request_booked|SERVICE_REQUEST в BOOKED: ожидание исполнителя и окно PENDING]].

  * [[sharixopen:knowledge:scenarios:service_request_preforcemajeure|SERVICE_REQUEST в PRE_FORCEMAJEUER: ожидание внешнего решения]].

  * [[sharixopen:knowledge:scenarios:service_request_accepted|SERVICE_REQUEST в ACCEPTED: подготовка, подтверждение и платёжное ожидание]].

  * [[sharixopen:knowledge:scenarios:service_request_assigned|SERVICE_REQUEST в ASSIGNED: раунд подтверждения и принятие назначения]].

  * [[sharixopen:knowledge:scenarios:service_request_pending|SERVICE_REQUEST в PENDING: партии кандидатов и назначение победителя]].

  * [[sharixopen:knowledge:scenarios:service_request_declined|SERVICE_REQUEST в DECLINED: возврат в BOOKED и резервное закрытие]].

  * [[sharixopen:knowledge:domain:provider_selection_target|Подбор исполнителя: требования к дальнейшей реализации]].

==== Создание и черновик ====
Создание записи, размещение, предупреждения и повтор.

**Код метки:** topic_orders_creation.

  * [[sharixopen:knowledge:architecture:api_contracts|API ShariX Open: операции, доступ и взаимодействие модулей]].
  * [[sharixopen:knowledge:scenarios:service_request_template|SERVICE_REQUEST в TEMPLATE: черновик, действия клиента и напоминания]].
  * [[sharixopen:knowledge:scenarios:order_create|Создание заказа через API: транзакция, ответ и внешние события]].

==== Исполнение ====
Workspace, Stage, материалы и локальный результат.

**Код метки:** topic_orders_execution.

  * [[sharixopen:knowledge:modules:webservice_running|Webservice Running: локальные данные и исполнение заказа]].

  * [[sharixopen:knowledge:scenarios:service_request_prestart|SERVICE_REQUEST в PRE_START: начало выполнения и внешние действия]].

  * [[sharixopen:knowledge:scenarios:service_request_forcemajeure|SERVICE_REQUEST в FORCEMAJEUER: ожидание внешнего решения]].

  * [[sharixopen:knowledge:scenarios:service_request_process|SERVICE_REQUEST в PROCESS: этапы выполнения, завершение и подписка]].

  * [[sharixopen:knowledge:domain:cancellation_policy_target|Отмена заказа: ориентир политики и будущей разработки]].

==== Жизненный цикл ====
Допустимые действия, сохранённое состояние и смена владельца.

**Код метки:** topic_orders_lifecycle.

  * [[sharixopen:knowledge:scenarios:service_request_booked|SERVICE_REQUEST в BOOKED: ожидание исполнителя и окно PENDING]].
  * [[sharixopen:knowledge:scenarios:service_request_done|SERVICE_REQUEST в DONE: финализация оплаты и закрытие]].
  * [[sharixopen:knowledge:scenarios:service_request_template|SERVICE_REQUEST в TEMPLATE: черновик, действия клиента и напоминания]].
  * [[sharixopen:knowledge:domain:order_ticket|Заказ, Ticket и PROCESS]].
  * [[sharixopen:knowledge:scenarios:order_create|Создание заказа через API: транзакция, ответ и внешние события]].
  * [[sharixopen:knowledge:scenarios:start|Сценарии ShariX Open: выбор процесса и проверка результата]].

  * [[sharixopen:knowledge:scenarios:service_request_preforcemajeure|SERVICE_REQUEST в PRE_FORCEMAJEUER: ожидание внешнего решения]].

  * [[sharixopen:knowledge:scenarios:service_request_prestart|SERVICE_REQUEST в PRE_START: начало выполнения и внешние действия]].

  * [[sharixopen:knowledge:scenarios:service_request_accepted|SERVICE_REQUEST в ACCEPTED: подготовка, подтверждение и платёжное ожидание]].

  * [[sharixopen:knowledge:scenarios:service_request_forcemajeure|SERVICE_REQUEST в FORCEMAJEUER: ожидание внешнего решения]].

  * [[sharixopen:knowledge:scenarios:service_request_assigned|SERVICE_REQUEST в ASSIGNED: раунд подтверждения и принятие назначения]].

  * [[sharixopen:knowledge:scenarios:service_request_process|SERVICE_REQUEST в PROCESS: этапы выполнения, завершение и подписка]].

  * [[sharixopen:knowledge:scenarios:service_request_pending|SERVICE_REQUEST в PENDING: партии кандидатов и назначение победителя]].

  * [[sharixopen:knowledge:scenarios:service_request_declined|SERVICE_REQUEST в DECLINED: возврат в BOOKED и резервное закрытие]].

  * [[sharixopen:knowledge:domain:cancellation_policy_target|Отмена заказа: ориентир политики и будущей разработки]].

==== Модель ====
Различие Orders, Ticket и локальных данных.

**Код метки:** topic_orders_model.

  * [[sharixopen:knowledge:domain:start|Доменная модель заказов и исполнения]].
  * [[sharixopen:knowledge:domain:order_ticket|Заказ, Ticket и PROCESS]].

  * [[sharixopen:knowledge:domain:participants|Участники, роли и видимость]].

==== Финализация оплаты ====
Платёжное состояние и отдельный gate закрытия.

**Код метки:** topic_orders_payments.

  * [[sharixopen:knowledge:scenarios:service_request_done|SERVICE_REQUEST в DONE: финализация оплаты и закрытие]].

  * [[sharixopen:knowledge:scenarios:service_request_accepted|SERVICE_REQUEST в ACCEPTED: подготовка, подтверждение и платёжное ожидание]].

  * [[sharixopen:knowledge:scenarios:service_request_assigned|SERVICE_REQUEST в ASSIGNED: раунд подтверждения и принятие назначения]].

  * [[sharixopen:knowledge:scenarios:service_request_process|SERVICE_REQUEST в PROCESS: этапы выполнения, завершение и подписка]].

  * [[sharixopen:knowledge:domain:cancellation_policy_target|Отмена заказа: ориентир политики и будущей разработки]].

===== Доступ =====
==== Объектные права ====
Проверка actor, объекта и области данных.

**Код метки:** topic_security_object_access.

  * [[sharixopen:knowledge:architecture:api_contracts|API ShariX Open: операции, доступ и взаимодействие модулей]].
  * [[sharixopen:knowledge:modules:backend_dbsynce|Backend/dbsynce: синхронизируемые сущности]].
  * [[sharixopen:knowledge:scenarios:neg_request_pending|NEG_REQUEST в PENDING: решение по Relationship и граница API scope]].

  * [[sharixopen:knowledge:domain:documents|Логические документы, проверка и переиспользование]].

  * [[sharixopen:knowledge:domain:participants|Участники, роли и видимость]].

==== Полномочия ====
Предметное Permissions отличается от членства в группе.

**Код метки:** topic_security_permissions.

  * [[sharixopen:knowledge:scenarios:access_request_declined|ACCESS_REQUEST в DECLINED: контрольный срок и безопасная очистка]].
  * [[sharixopen:knowledge:scenarios:partner_request|Подача и обработка заявки партнёра]].

  * [[sharixopen:knowledge:scenarios:access_request_pending|ACCESS_REQUEST в PENDING: рассмотрение запроса на право]].

  * [[sharixopen:knowledge:scenarios:access_request_accepted|ACCESS_REQUEST в ACCEPTED: требования и активация права]].

  * [[sharixopen:knowledge:domain:requirements|Требования, проверки и effective access]].

  * [[sharixopen:knowledge:domain:participants|Участники, роли и видимость]].

==== Требования ====
Подготовка проверок и gate активации.

**Код метки:** topic_security_requirements.

  * [[sharixopen:knowledge:scenarios:neg_request_accepted|NEG_REQUEST в ACCEPTED: активация Relationship и срок закрытия]].

  * [[sharixopen:knowledge:scenarios:st_request_inprocess|ST_REQUEST в работе: обычное обращение и профильная проверка]].

  * [[sharixopen:knowledge:scenarios:st_request_wontfix|ST_REQUEST в WONTFIX: отрицательный результат и решение о закрытии]].

  * [[sharixopen:knowledge:scenarios:st_request_done|ST_REQUEST в DONE: подтверждение закрытия и завершение проверки]].

  * [[sharixopen:knowledge:scenarios:access_request_accepted|ACCESS_REQUEST в ACCEPTED: требования и активация права]].

  * [[sharixopen:knowledge:domain:documents|Логические документы, проверка и переиспользование]].

  * [[sharixopen:knowledge:domain:requirements|Требования, проверки и effective access]].

===== Сервис =====
==== Настройка ====
Граница настройки процесса и её источников; закрытые детали остаются внутри.

**Код метки:** topic_service_configuration.

  * [[sharixopen:knowledge:modules:constructor|Конструктор сервиса: закрытый компонент]].

  * [[sharixopen:knowledge:domain:provider_selection_target|Подбор исполнителя: требования к дальнейшей реализации]].

==== Концепция ====
Предметное назначение услуги и цифровой координации.

**Код метки:** topic_service_model.

  * [[sharixopen:knowledge:foundation:start|ShariX Open: основы и карта базы знаний]].
  * [[sharixopen:knowledge:foundation:service_model|Концепция сервиса и назначение цифровой координации]].

==== Подключение партнёра ====
Company, полномочия и договорные запросы.

**Код метки:** topic_service_partner_onboarding.

  * [[sharixopen:knowledge:scenarios:partner_request|Подача и обработка заявки партнёра]].

===== Документы =====

==== Жизненный цикл ====
Черновик, версии, проверка, согласие, переиспользование и доступ к файлам.

  * [[sharixopen:knowledge:domain:documents|Логические документы, проверка и переиспользование]].

  * [[sharixopen:knowledge:domain:requirements|Требования, проверки и effective access]].

===== Модули =====

==== Доступность ====
Обнаружение, установка, entitlement, конфигурация, provider и runtime health.

  * [[sharixopen:knowledge:modules:capability_resolution|Capability resolution и проверяемые зависимости]].

  * [[sharixopen:knowledge:modules:handler_discovery|Registry обработчиков и доступность capabilities]].

===== Общие понятия =====
  * **access_request** — ACCESS_REQUEST: заявка предметного полномочия; не равна членству в LDAP/Django-группе.
  * **api_capability** — Capability handler: узко разрешённая workflow-операция вместе с identity и object scope; не общий CRUD-доступ.
  * **blockly** — Blockly workspace: типизированный редактируемый источник, из которого генерируется исполняемый Python.
  * **bpmn** — BPMN: описательная схема участников, действий, событий и ожиданий; просмотрщик не исполняет обработчик.
  * **generated_python** — Generated Python: полученный из канонического источника файл; соответствие проверяется повторной генерацией.
  * **grace_period** — Контрольный срок: именованное ожидание от предусмотренного поля времени; не универсальный SLA-таймер.
  * **model_owner** — Владелец модели: модуль, определяющий смысл, структуру и допустимые операции изменения данных.
  * **neg_request** — NEG_REQUEST: заявка, сопровождающая Relationship; её статус и активность связи различаются.
  * **object_scope** — Object scope: ограничение объекта областью данных, actor и текущим состоянием.
  * **order** — Orders: общая запись заказа dbsynce; её ID отличается от Ticket ID.
  * **order_intent** — Намерение заказа: запрос пользователя, переданный handler; relay-подтверждение не доказывает исполнения.
  * **payment_state** — Платёжное состояние: данные выбранного платёжного владельца; success одного retry не заменяет gate закрытия.
  * **pending_at** — pending_at: вычисленная временная граница перехода планового BOOKED-заказа к PENDING.
  * **permissions** — Permissions: предметное полномочие пользователя, его статус и связанный запрос; отличается от членства в группе.
  * **provenance** — Provenance: сведения об исходных файлах, генераторе и контрольных суммах; не заменяют поведенческую проверку.
  * **provider_offer** — Provider: предложение исполнителя с пользователем, услугой, компанией и при необходимости ресурсом.
  * **relationship** — Relationship: направленная связь user_who/user_whom с типом, областью компании и собственным статусом.
  * **requirements** — Requirements: обязательные условия, доказательства и проверки, учитываемые перед доменным действием.
  * **service_request** — SERVICE_REQUEST: Ticket жизненного цикла заказа.
  * **source_evidence** — Свидетельство по исходникам: точная версия и прочитанная операция; не подтверждение установленного сервера.
  * **st_request** — ST_REQUEST: стандартная заявка; в рассмотренных процессах в том числе запрос проверки. Не подменяет произвольный тип заявки.
  * **ticket** — Ticket: типизированная заявка с lifecycle, событиями и ссылками на предметные данные.
  * **ticket_accepted** — ACCEPTED: заявка принята; выполнение требований и активация связанного объекта проверяются отдельно.
  * **ticket_booked** — BOOKED: размещённый заказ до следующего действия или перехода; это не подтверждение принятия исполнителем.
  * **ticket_closed** — CLOSED: терминальное закрытие Ticket; не физическое удаление связанных данных.
  * **ticket_declined** — DECLINED: отклонённый запрос или заказ; дальнейшие действия зависят от ticket_type.
  * **ticket_done** — DONE: завершение работы/решение соответствующего типа Ticket; финансовое закрытие или активация имеют отдельные условия.
  * **ticket_pending** — PENDING: именованная стадия Ticket; числовой код и допустимые действия зависят от ticket_type.
  * **ticket_template** — TEMPLATE: существующий черновик заказа.

  * **ticket_in_process** — IN_PROCESS — обращение ST_REQUEST находится в работе; профильная проверка определяется стабильным контрактом.
  * **ticket_duplicate** — DUPLICATE — ST_REQUEST признан дубликатом; сам статус не означает переноса содержимого или закрытия.
  * **ticket_reopened** — REOPENED — ST_REQUEST переоткрыт и ожидает нового решения о назначении; это не новая доменная попытка проверки.
  * **ticket_pre_forcemajeuer** — PRE_FORCEMAJEUER — техническое имя проблемной стадии заказа, ожидающей внешнего разбора; написание сохранено как в коде.
  * **external_resolution** — Внешний разбор — решение уполномоченного участника через канонические операции; observer лишь наблюдает состояние.
  * **verification_workflow** — Профильный workflow — обработка document-verification-v1 или requirement-check-v1 через scoped API с доменным результатом.

[[sharixopen:knowledge:classification:handler_terms|Словарь обработчиков и фоновых процессов]] содержит определения для статусов, раундов, транспорта сообщений, фоновых операций и телеметрии.

~~SHARIX_KNOWLEDGE_RELATED~~