Conception de Frontière Sémantique
Objectif
Éviter la dérive sémantique en assignant un seul propriétaire à chaque décision définissant la signification.
De nombreuses couches peuvent observer, passer ou restituer les mêmes données. Une seule couche doit décider ce que ces données signifient en termes d'identité, cycle de vie, permission, commandes, routes, événements, compatibilité ou présentation.
Utilisation / Ne Pas Utiliser
Utilisez cette compétence avant ou pendant un travail inter-couches lorsque :
- une capacité traverse plusieurs représentations
- des alias, replis, étiquettes, statuts, permissions ou règles de cycle de vie se propagent à travers les appelants
- un appelant non propriétaire commence à analyser, normaliser, traduire ou inférer une signification
- un adaptateur commence à préserver la politique produit au lieu de traduire les formes
- les tests figent les internes d'assistants plutôt que le comportement de la frontière propriétaire
N'utilisez pas cette compétence pour :
- de petites modifications locales sans mouvement de frontière sémantique
- la découverte en lecture seule des propriétaires existants ; utilisez
source-owner-audit - le nettoyage local des frontières de changement ou de flux une fois les propriétaires clairs ; utilisez
structure-first - le travail pur sur l'actualité asynchrone, la réactivité ou les interactions sujettes aux conditions de concurrence ; utilisez
interactive-state-flow - le seul contrôle du périmètre de changement ; utilisez
structure-first
Compétences Adjacentes
source-owner-audittrouve les propriétaires source actuels à partir de preuves. Cette compétence place les décisions sémantiques une fois que la question du propriétaire nécessite une conception.structure-firstdélimite et façonne l'unité courante une fois les propriétaires connus. Cette compétence commence par le registre des propriétaires à l'échelle de la capacité.interactive-state-flowse spécialise dans l'actualité, l'attente, le périmé et le comportement de présentation asynchrone. Cette compétence ne traite de l'actualité/repli/révision que lorsqu'il s'agit d'une propriété de contrat sémantique entre représentations.
Flux Opérationnel
- Nommez la capacité en termes utilisateur ou domaine.
- Listez les traversées de représentation : enregistrement source, modèle de lecture, brouillon IHM, intention utilisateur, état de route/requête, entrée de commande, charge utile API, résultat de commande, patch temps réel, modèle de présentation, adaptateur de compatibilité.
- Listez les décisions sémantiques : identité/alias, cycle de vie/statut, permission/capacité, grammaire de commande, grammaire de route/navigation, actualité/conflit/révision/en attente/repli, projection/présentation, compatibilité.
- Assignez un propriétaire par décision. Choisissez le plus petit propriétaire durable uniquement lorsque la source actuelle ou le contexte explicite de la tâche montre suffisamment de preuves et d'autorité pour décider de la signification. Si aucune couche ne possède les deux, écrivez
décision nécessaire -> preuves/autorité manquanteset nommez qui doit décider uniquement lorsque ce propriétaire de décision est attesté ou explicitement fourni. - Définissez les limites des appelants : les appelants peuvent passer, sélectionner, invoquer, afficher ou restituer ; les appelants ne doivent pas interpréter, normaliser, re-décider ou préserver une politique sauf s'ils possèdent cette décision.
- Refactorez uniquement le périmètre justifié par la tâche en cours.
- Ajoutez des gardes qui échouent lorsque les décisions sémantiques fuient chez les appelants.
- Passez la main à la compétence propriétaire adjacente (découverte de source, forme locale du code, actualité asynchrone, contrôle de périmètre) lorsque cette préoccupation devient primaire.
Règles de Sélection du Propriétaire
- Alias de schéma ou de champ -> propriétaire de l'enregistrement/contrat.
- Forme d'intention utilisateur -> propriétaire de la surface IHM ou de l'entrée de commande.
- Charge utile de commande finale -> propriétaire de la session/commande.
- Analyse de requête API -> propriétaire de la route d'application, pas de l'encapsulation framework.
- Grammaire de route ou de requête -> propriétaire de navigation.
- Permission ou capacité -> propriétaire de politique.
- Étiquettes et actions -> propriétaire de surface/modèle de vue.
- Sémantique d'enveloppe de résultat, patch ou resynchronisation -> propriétaire du résultat d'application/temps réel.
- Acceptation du périmé, en attente, repli, conflit ou révision -> propriétaire de route, session ou écran gérant l'actualité.
- Comportement de compatibilité -> l'adaptateur traduit les formes ; la propriété de politique nécessite une assignation explicite.
Indices de Dérive
- Chaînes de repli
x || y || zen dehors du propriétaire d'enregistrement/contrat. - Vérifications dupliquées de cycle de vie ou de statut.
- Le code IHM construit les charges utiles de commande finales directement à partir des enregistrements.
- Les composants de route analysent ou construisent une grammaire de requête partagée.
- Les encapsulations API lisent les champs métier des requêtes.
- Les gestionnaires temps réel ou d'événements re-décident le cycle de vie, la permission ou la politique.
- Les clés de révision, conflit, en attente, repli ou actualité sont dupliquées.
- Les adaptateurs préservent la politique au lieu de traduire vers le propriétaire.
- Les tests affirment les internes d'assistants plutôt que le comportement de la frontière propriétaire.
Gardes Requises
Choisissez la plus petite garde qui protège la frontière propriétaire :
- tests de contrat pour la normalisation d'alias, la forme de la charge utile de commande, la grammaire de route/requête ou les enveloppes de résultat
- tests de frontière montrant que les appelants passent/restituent/invoquent sans réinterpréter la signification
- cas négatifs pour le comportement périmé, de repli, de permission, de cycle de vie ou de compatibilité
- contraintes de type ou de schéma qui rendent l'interprétation dupliquée difficile à exprimer
- tests de régression pour le comportement visible par l'utilisateur qui dépend de la décision sémantique
Ne figez pas les internes d'assistants. Affirmez que le propriétaire décide du sens une fois et que les appelants ne peuvent pas choisir silencieusement un autre sens.
Contrat de Sortie
Utilisez cette forme compacte lors du rapport d'un plan, d'une revue ou d'une note d'implémentation :
Capacité :capacité utilisateur/domaineTraversées de Représentation :formes de données ou de contrôle impliquéesDécisions Sémantiques :décisions qui pourraient dériverRegistre des Propriétaires :décision -> propriétaire ou décision nécessaire -> raisonLimites des Appelants :comportement autorisé des appelants et interprétation prohibéeIndices de Dérive :fuites observées ou probablesGardes Requises :tests, schémas ou vérificationsPassages de Main :compétences adjacentes ou propriétaires suivants
Vérifications Finales
- La capacité est-elle nommée en termes utilisateur/domaine ?
- Chaque décision sémantique a-t-elle exactement un propriétaire, ou un
décision nécessairenommé ? - Les appelants peuvent-ils observer, passer, restituer ou invoquer sans décider du sens ?
- Les adaptateurs sont-ils limités à la traduction à moins que la propriété de politique soit explicite ?
- Les décisions de repli, d'actualité, de cycle de vie, de permission et de compatibilité sont-elles possédées là où elles peuvent être vérifiées ?
- Le périmètre de refactorisation est-il limité à la tâche en cours ?
- Les gardes vérifient-elles le comportement de la frontière propriétaire plutôt que les internes d'assistants ?