HSIMC · UN Six-Language White Paper · P6 / W0-017
# Annexe C - Contrat commun de capacité
Un Common Capability Contract est la frontière partagée qui permet à différentes équipes de travailler avant que le matériel final soit disponible. Il décrit la fonction, et non une permission illimitée d'utiliser une Resource.
## C.Field - `contract_id`
Identifiant stable du contrat de fonction ou du Profile.
## C.Field - `function`
Action/résultat lisible par une personne, par exemple `locate_marks`.
## C.Field - `input_schema`
Objets d'entrée versionnés, unités, plages autorisées et fichiers requis.
## C.Field - `output_schema`
Résultat versionné, champs de qualité, unités, références Evidence et états d'erreur.
## C.Field - `resource_target`
HSIMC Resource ou classe cible ; l'instance physique réelle est liée séparément.
## C.Field - `execution_mode`
simulation / physical_reference / physical_delivered / operational.
## C.Field - `conditions`
Environnement, outillage, étalonnage, matériau et conditions préalables.
## C.Field - `authority_required`
Authority minimale requise pour découvrir, lire, réserver, configurer, exécuter, arrêter, accepter ou administrer.
## C.Field - `effect_identity`
Digest ou identifiant qui verrouille l'effet physique prévu indépendamment des credentials de courte durée.
## C.Field - `operation_id`
Identité stable utilisée pour retry/read-back d'une requête à effet physique.
## C.Field - `freshness_requirement`
Âge maximum acceptable des observations utilisées pour autoriser ou planifier l'action.
## C.Field - `resource_locking`
Règles de réservation, lease, busy/conflit et libération.
## C.Field - `safety_boundary`
Conditions qui doivent rester locales/déterministes et ne peuvent pas être déléguées à un modèle distant.
## C.Field - `acceptance`
Mesure, tolérances, Evidence et étape d'acceptation humaine/organisationnelle.
## C.Field - `recovery`
Comportement d'arrêt, résultat inconnu, interruption réseau et redémarrage.
## C.Field - `version`
Références de versions du contrat, adaptateur, algorithme, hardware/BOM, étalonnage et déploiement.
## C.Field - `cost_time`
Champs de temps, matériaux, énergie et coûts monétaires attendus et réels.
## C.Field - `rights`
Contraintes de contribution, réutilisation, attribution, confidentialité et retrait.
## C.1 Exemple - `locate_marks`
```json
{
"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"]
}
```
Le même contrat peut fonctionner avec des images fixes, un simulateur cloud, une caméra de référence distante ou un appareil livré. Chaque cible nécessite néanmoins son propre adaptateur et sa propre Evidence.
## C.2 Règle de retry et d'effet
Un retry devrait réutiliser l'`operation_id` d'origine lorsque l'effet physique demandé est le même. Si le résultat est inconnu, interroger l'opération d'origine avant de créer un nouvel effet. De nouveaux credentials ou un token rafraîchi ne créent pas, à eux seuls, un nouveau Work physique.
---