<sharix-knowledge-meta>
{
    "id": "ShariXKnowledgeHandlerTerms",
    "page": "sharixopen:knowledge:classification:handler_terms",
    "area": "open",
    "type": "reference",
    "title": "Термины обработчиков и фоновых процессов",
    "status": "review",
    "schema_version": 1,
    "relations": {
        "related_to": [
            "ShariXKnowledgeServiceRequestPrestartBPMN",
            "ShariXKnowledgeBasicBotBPMN",
            "ShariXKnowledgeServiceRequestAcceptedBPMN",
            "ShariXKnowledgeSTRequestWontfixBPMN",
            "ShariXKnowledgeRepositoryUpdateWatchBPMN",
            "ShariXKnowledgeSTRequestAssignedBPMN",
            "ShariXKnowledgeServiceRequestForcemajeureBPMN",
            "ShariXKnowledgeServiceRequestAssignedBPMN",
            "ShariXKnowledgeNegRequestDeclinedBPMN",
            "ShariXKnowledgeTeltonikaGpsTrackerBPMN",
            "ShariXKnowledgeSTRequestDoneBPMN",
            "ShariXKnowledgeServiceRequestProcessBPMN",
            "ShariXKnowledgeServiceRequestPendingBPMN",
            "ShariXKnowledgeReportHandlerBPMN",
            "ShariXKnowledgeAccessRequestAcceptedBPMN"
        ],
        "depends_on": [
            "ShariXKnowledgeOpenKnowledgeModulesHandlers"
        ]
    },
    "extensions": {
        "taxonomy": {
            "domain": "glossary",
            "lifecycle": "not_applicable",
            "component": "handlers_backend, handlers_examples, sharix_sysadmin",
            "parents": [
                "ShariXKnowledgeClassificationTopics"
            ],
            "terms": [
                "audience_developer",
                "audience_operator",
                "audience_reviewer",
                "audience_ai",
                "product_sharix_open",
                "product_shared",
                "material_index",
                "topic_handlers_runtime",
                "topic_handlers_blockly",
                "topic_knowledge_navigation",
                "ticket_pre_start",
                "ticket_process",
                "ticket_wontfix",
                "xmpp",
                "first_party_handler",
                "optional_handler",
                "repository_updates",
                "source_snapshot",
                "order_preparation",
                "requirement_check",
                "sysadmin",
                "ticket_assigned",
                "ticket_forcemajeuer",
                "order_round",
                "teltonika",
                "udp",
                "avl",
                "gpx",
                "device_ack",
                "document_version",
                "verification_completed",
                "notification_ack",
                "completion_gate",
                "blocking_stage",
                "subscription_access_order",
                "candidate_batch",
                "matching_cursor",
                "handler_reports",
                "activation_gate"
            ]
        },
        "glossary": {
            "ticket_pre_start": "PRE_START — заказ подготовлен к началу выполнения; начало подтверждается отдельным каноническим действием.",
            "ticket_process": "PROCESS — стадия выполнения заказа; её сохранение отличается от приёма транспортного intent.",
            "ticket_wontfix": "WONTFIX — отказ от выполнения обычного обращения либо отрицательное завершение профильной проверки; ветви различаются контрактом.",
            "xmpp": "XMPP — транспорт сообщений и событий; вызов send не подтверждает доставку или доменный commit.",
            "first_party_handler": "First-party handler — встроенная typed программа с операциями, объявленными в каталоге, и отдельной реализацией runtime binding.",
            "optional_handler": "Optional handler — процессная программа, операции и module-owned исходники которой объявлены contribution; включается отдельно.",
            "repository_updates": "Статусы обновлений — evidence сравнения установленного Git-состояния с deployment/upstream-целями; монитор не применяет обновление.",
            "source_snapshot": "Source snapshot — сохранённое evidence, пригодное лишь при соответствии текущим source, branch, commit и worktree facts.",
            "order_preparation": "Подготовка заказа — канонический переход ACCEPTED → PRE_START с проверкой исполнителя, concurrency и платёжных условий.",
            "requirement_check": "RequirementCheck — конкретная доменная попытка проверки требования; её результат отличается от одного статуса сопровождающего Ticket.",
            "sysadmin": "Sysadmin — общий модуль эксплуатационных возможностей; repository_update_watch использует его узкую публичную operation.",
            "ticket_assigned": "ASSIGNED — назначенная стадия обращения или заказа; код зависит от типа Ticket. Статус не заменяет проверку assigned_to или текущего provider.",
            "ticket_forcemajeuer": "FORCEMAJEUER — техническое имя стадии форс-мажора заказа; текущий observer ждёт внешнего решения и не урегулирует заказ автоматически.",
            "order_round": "Раунд действий заказа — локальные приглашения, ответы, стратегия и сроки, связанные с order/ticket/status и участником; outcome раунда не равен бизнес-commit.",
            "teltonika": "Teltonika — в данном сценарии пример приёмника AVL-датаграмм устройств; описание не обещает поддержку всех вариантов протокола.",
            "udp": "UDP — транспорт датаграмм приёмника телеметрии; доступность его socket проверяется отдельно от XMPP bootstrap.",
            "avl": "AVL — разбираемые телематические записи устройства; успешный ACK ещё не доказывает корректность всех записей.",
            "gpx": "GPX — файловое представление точек трека; запись в примере включается отдельно и не означает обновления модели сервиса.",
            "device_ack": "ACK устройства — ответ, собранный из полей raw-пакета; здесь счётчик не вычисляется по фактически сохранённым точкам.",
            "document_version": "DocumentVersion — проверенная редакция документа со снимками данных/файлов и атрибуцией проверки; черновик и Ticket её не заменяют.",
            "verification_completed": "Verification completed — marker сохранённого доменного результата конкретного Ticket; повтор complete возвращает его, не создавая новую проверку.",
            "notification_ack": "Ack уведомления — учёт ключа после попытки отправки; это не подтверждение прочтения и не доменный результат.",
            "completion_gate": "Completion gate — проверка возможности завершения заказа; её ответ следует читать вместе с регистрацией адаптера и блокирующими этапами.",
            "blocking_stage": "Блокирующий Stage — этап заказа с blocks_order_completion=true и status=PENDING; handler не выполняет его за участника.",
            "subscription_access_order": "Заказ доступа подписки — системный тариф доступа, для которого есть отдельная ветвь истечения; не любой заказ с покрытием подпиской.",
            "candidate_batch": "Партия кандидатов — ограниченный backend набор допустимых предложений исполнителей; получение партии не резервирует их доступность.",
            "matching_cursor": "Cursor подбора — process-local позиция обхода after_provider_id вместе с циклом/партией; после рестарта не является журналом прежних приглашений.",
            "handler_reports": "Handler reports — принятые по allowlist XMPP-тексты, временно сгруппированные в памяти для пересылки; не постоянный архив.",
            "activation_gate": "Activation gate — каноническая подготовка и оценка требований перед active; одобрение Ticket и предварительный ok не заменяют gate."
        },
        "classification": {
            "schema": "sharix.knowledge.classification.v1",
            "products": [
                "sharix_open",
                "shared"
            ],
            "audiences": [
                "developer",
                "operator",
                "reviewer",
                "ai"
            ],
            "material": "index",
            "topics": [
                "handlers/runtime",
                "handlers/blockly",
                "knowledge/navigation"
            ],
            "tag_terms": [
                "audience_developer",
                "audience_operator",
                "audience_reviewer",
                "audience_ai",
                "product_sharix_open",
                "product_shared",
                "material_index",
                "topic_handlers_runtime",
                "topic_handlers_blockly",
                "topic_knowledge_navigation",
                "ticket_pre_start",
                "ticket_process",
                "ticket_wontfix",
                "xmpp",
                "first_party_handler",
                "optional_handler",
                "repository_updates",
                "source_snapshot",
                "order_preparation",
                "requirement_check",
                "sysadmin",
                "ticket_assigned",
                "ticket_forcemajeuer",
                "order_round",
                "teltonika",
                "udp",
                "avl",
                "gpx",
                "device_ack",
                "document_version",
                "verification_completed",
                "notification_ack",
                "completion_gate",
                "blocking_stage",
                "subscription_access_order",
                "candidate_batch",
                "matching_cursor",
                "handler_reports",
                "activation_gate"
            ],
            "registry_document": "ShariXKnowledgeClassification",
            "state_meaning": "Словарь понятий, стадия реализации функции неприменима"
        },
        "editorial_review": {
            "date": "2026-10-31",
            "scope": "Сохранены прежние 19 определений и ссылки; добавлены десять определений по пяти следующим проверенным сценариям",
            "runtime_checked": false
        }
    },
    "content_sha256": "9fb5d41d575a78bba292f7f9987ed2264e964bd6d9131ddf9ca5caabd51d4472",
    "schema": 1
}
</sharix-knowledge-meta>
====== Термины обработчиков и фоновых процессов ======
~~NOCACHE~~

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

**Назначение:** [[sharixopen:knowledge:classification:materials#ukazatel_razdela|Указатель раздела]]. **Продукт:** [[sharixopen:knowledge:classification:products#sharix_open|ShariX Open]] · [[sharixopen:knowledge:classification:products#obschij_komponent|Общий компонент]].

**Для кого:** [[sharixopen:knowledge:classification:audiences#razrabotchik|Разработчик]] · [[sharixopen:knowledge:classification:audiences#operator_razvjortyvanija|Оператор развёртывания]] · [[sharixopen:knowledge:classification:audiences#recenzent_i_prijomschik|Рецензент и приёмщик]] · [[sharixopen:knowledge:classification:audiences#nejroset|Нейросеть]].

**Темы:** [[sharixopen:knowledge:classification:topics#runtime|Обработчики → Runtime]] · [[sharixopen:knowledge:classification:topics#blockly|Обработчики → Blockly]] · [[sharixopen:knowledge:classification:topics#navigacija|База знаний → Навигация]].

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

===== Понятия и коды меток =====
  * **ticket_pre_start** — PRE_START — заказ подготовлен к началу выполнения; начало подтверждается отдельным каноническим действием.
  * **ticket_process** — PROCESS — стадия выполнения заказа; её сохранение отличается от приёма транспортного intent.
  * **ticket_wontfix** — WONTFIX — отказ от выполнения обычного обращения либо отрицательное завершение профильной проверки; ветви различаются контрактом.
  * **xmpp** — XMPP — транспорт сообщений и событий; вызов send не подтверждает доставку или доменный commit.
  * **first_party_handler** — First-party handler — встроенная typed программа с операциями, объявленными в каталоге, и отдельной реализацией runtime binding.
  * **optional_handler** — Optional handler — процессная программа, операции и module-owned исходники которой объявлены contribution; включается отдельно.
  * **repository_updates** — Статусы обновлений — evidence сравнения установленного Git-состояния с deployment/upstream-целями; монитор не применяет обновление.
  * **source_snapshot** — Source snapshot — сохранённое evidence, пригодное лишь при соответствии текущим source, branch, commit и worktree facts.
  * **order_preparation** — Подготовка заказа — канонический переход ACCEPTED → PRE_START с проверкой исполнителя, concurrency и платёжных условий.
  * **requirement_check** — RequirementCheck — конкретная доменная попытка проверки требования; её результат отличается от одного статуса сопровождающего Ticket.
  * **sysadmin** — Sysadmin — общий модуль эксплуатационных возможностей; repository_update_watch использует его узкую публичную operation.

  * **ticket_assigned** — ASSIGNED — назначенная стадия обращения или заказа; код зависит от типа Ticket. Статус не заменяет проверку assigned_to или текущего provider.
  * **ticket_forcemajeuer** — FORCEMAJEUER — техническое имя стадии форс-мажора заказа; текущий observer ждёт внешнего решения и не урегулирует заказ автоматически.
  * **order_round** — Раунд действий заказа — локальные приглашения, ответы, стратегия и сроки, связанные с order/ticket/status и участником; outcome раунда не равен бизнес-commit.
  * **teltonika** — Teltonika — в данном сценарии пример приёмника AVL-датаграмм устройств; описание не обещает поддержку всех вариантов протокола.
  * **udp** — UDP — транспорт датаграмм приёмника телеметрии; доступность его socket проверяется отдельно от XMPP bootstrap.
  * **avl** — AVL — разбираемые телематические записи устройства; успешный ACK ещё не доказывает корректность всех записей.
  * **gpx** — GPX — файловое представление точек трека; запись в примере включается отдельно и не означает обновления модели сервиса.
  * **device_ack** — ACK устройства — ответ, собранный из полей raw-пакета; здесь счётчик не вычисляется по фактически сохранённым точкам.

  * **document_version** — DocumentVersion — проверенная редакция документа со снимками данных/файлов и атрибуцией проверки; черновик и Ticket её не заменяют.
  * **verification_completed** — Verification completed — marker сохранённого доменного результата конкретного Ticket; повтор complete возвращает его, не создавая новую проверку.
  * **notification_ack** — Ack уведомления — учёт ключа после попытки отправки; это не подтверждение прочтения и не доменный результат.
  * **completion_gate** — Completion gate — проверка возможности завершения заказа; её ответ следует читать вместе с регистрацией адаптера и блокирующими этапами.
  * **blocking_stage** — Блокирующий Stage — этап заказа с blocks_order_completion=true и status=PENDING; handler не выполняет его за участника.
  * **subscription_access_order** — Заказ доступа подписки — системный тариф доступа, для которого есть отдельная ветвь истечения; не любой заказ с покрытием подпиской.
  * **candidate_batch** — Партия кандидатов — ограниченный backend набор допустимых предложений исполнителей; получение партии не резервирует их доступность.
  * **matching_cursor** — Cursor подбора — process-local позиция обхода after_provider_id вместе с циклом/партией; после рестарта не является журналом прежних приглашений.
  * **handler_reports** — Handler reports — принятые по allowlist XMPP-тексты, временно сгруппированные в памяти для пересылки; не постоянный архив.
  * **activation_gate** — Activation gate — каноническая подготовка и оценка требований перед active; одобрение Ticket и предварительный ok не заменяют gate.

===== Сценарии применения =====
  * [[sharixopen:knowledge:scenarios:service_request_prestart|SERVICE_REQUEST в PRE_START: начало выполнения и внешние действия]].
  * [[sharixopen:knowledge:scenarios:basic_bot|Диагностический XMPP-обработчик open_basic_bot]].
  * [[sharixopen:knowledge:scenarios:service_request_accepted|SERVICE_REQUEST в ACCEPTED: подготовка, подтверждение и платёжное ожидание]].
  * [[sharixopen:knowledge:scenarios:st_request_wontfix|ST_REQUEST в WONTFIX: отрицательный результат и решение о закрытии]].
  * [[sharixopen:knowledge:scenarios:repository_update_watch|Монитор обновлений repository_update_watch]].

  * [[sharixopen:knowledge:scenarios:st_request_assigned|Назначенная заявка ST_REQUEST: ручное начало работы и автоматический переход]].
  * [[sharixopen:knowledge:scenarios:service_request_forcemajeure|SERVICE_REQUEST в FORCEMAJEUER: ожидание внешнего решения]].
  * [[sharixopen:knowledge:scenarios:service_request_assigned|SERVICE_REQUEST в ASSIGNED: раунд подтверждения и принятие назначения]].
  * [[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:st_request_done|ST_REQUEST в DONE: подтверждение закрытия и завершение проверки]].
  * [[sharixopen:knowledge:scenarios:service_request_process|SERVICE_REQUEST в PROCESS: этапы выполнения, завершение и подписка]].
  * [[sharixopen:knowledge:scenarios:service_request_pending|SERVICE_REQUEST в PENDING: партии кандидатов и назначение победителя]].
  * [[sharixopen:knowledge:scenarios:report_handler|Сборщик служебных отчётов open_report_handler]].
  * [[sharixopen:knowledge:scenarios:access_request_accepted|ACCESS_REQUEST в ACCEPTED: требования и активация права]].

Для выбора, переименования и проверки меток использовать [[sharixopen:knowledge:classification:maintenance|инструкцию сопровождения рубрикатора]]. Метки не выдают доступ и не заменяют лицензионную границу модуля. Общий компонент может использоваться несколькими продуктами; внутренние сведения закрытых компонентов остаются в intrawiki.

~~SHARIX_KNOWLEDGE_RELATED~~