HSIMC · UN Six-Language White Paper · P6 / W0-017
HSIMC White Paper · Русский · W0-015 · источник: English Master W0-011 / Controlled Vocabulary W0-012

Приложение C — Общий контракт возможностей

Общий контракт возможностей (Common Capability Contract) — это общая граница, позволяющая разным командам работать ещё до появления финального hardware. Он описывает функцию, а не неограниченное разрешение использовать Resource.

C.Field — contract_id

Стабильный идентификатор контракта функции или Profile.

C.Field — function

Понятное человеку действие/результат, например locate_marks.

C.Field — input_schema

Versioned input objects, единицы, допустимые диапазоны и обязательные файлы.

C.Field — output_schema

Versioned result, поля качества, единицы, ссылки Evidence и error states.

C.Field — resource_target

HSIMC Resource или класс цели; фактический физический instance привязывается отдельно.

C.Field — execution_mode

simulation / physical_reference / physical_delivered / operational.

C.Field — conditions

Среда, tooling, calibration, material и prerequisite conditions.

C.Field — authority_required

Минимальная Authority, требуемая для discover, read, reserve, configure, execute, stop, accept или administer.

C.Field — effect_identity

Digest или identifier, фиксирующий намеренный физический эффект независимо от краткоживущих credentials.

C.Field — operation_id

Стабильная identity, используемая для retry/read-back запроса с физическим эффектом.

C.Field — freshness_requirement

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

C.Field — resource_locking

Reservation, lease, поведение busy/conflict и правило release.

C.Field — safety_boundary

Условия, которые должны оставаться локальными/детерминированными и не могут быть делегированы удалённой модели.

C.Field — acceptance

Measurement, tolerances, Evidence и шаг human/organizational acceptance.

C.Field — recovery

Поведение stop, unknown-result, interrupted-network и restart.

C.Field — version

Ссылки на версии contract, adapter, algorithm, hardware/BOM, calibration и deployment.

C.Field — cost_time

Поля ожидаемого и фактического времени, material, energy и monetary cost.

C.Field — rights

Ограничения contribution, reuse, attribution, confidentiality и withdrawal.

C.1 Пример — locate_marks

{
  "contract_id": "hsimc.locate_marks.v0",
  "function": "locate_marks",
  "input": {"image_ref": "sha256:...", "marker_profile": "marker-profile-v3", "calibration_ref": null},
  "target": {"resource_id": null, "mode": "simulation"},
  "authority": {"subject": "bound-at-runtime", "scope": ["read_input", "run_observation"]},
  "output": {"coordinate_space": "pixels", "marks": [], "quality": {}, "evidence_refs": []},
  "limits": ["No millimetre conversion without calibration evidence", "Observation only; no machine motion or laser action"]
}

Один и тот же contract может выполняться на фиксированных изображениях, облачном simulator, remote reference camera или delivered device. Каждая цель всё равно требует собственного adapter и Evidence.

C.2 Правило retry и effect

Retry должен повторно использовать исходный operation_id, если запрашиваемый физический эффект тот же. Если outcome неизвестен, сначала запросите исходную operation, прежде чем создавать новый effect. Новые credentials или обновлённый token сами по себе не создают новый физический Work.


← К содержанию книги