Domaines et isolement
Un domaine porte un secteur métier, comme hr ou sales. Les doctypes,
les hooks et les attributions se trouvent tous à l’intérieur. Rien ne
franchit la limite de son propre chef. Chaque flux inter-domaines exige un
consentement explicite.
Explication
Section intitulée « Explication »Ce que porte un domaine. Un domaine est un document core.Domain, et
son id est le nom du domaine. Tout id de doctype est donc qualifié, comme
hr.Employee. Le domaine doit exister avant l’enregistrement de ses
doctypesà ; sinon, l’enregistrement répond 422.
Le domaine possède ses doctypes et leurs modèles de vue. Il possède aussi
les hooks déclarés sur le document du domaine, et les attributions qu’il
accorde à d’autres domaines. Il possède enfin son état de brouillon : un
domaine de brouillon porte un id qui commence par _. Vous publiez un
brouillon dans un nouveau domaine réel. Les attributions ne concernent
jamais des brouillons — les deux côtés doivent être des domaines réels.
Un domaine se déplace comme un tout. Le domaine est aussi l’unité de portabilité. L’export et l’import transportent un domaine avec ses définitions et ses données.
L’isolement est la règle par défaut. Les données ne quittent pas un domaine de leur propre chef. Une lecture inter-domaines exige l’un de deux consentements explicitesà :
-
L’API de documents. Les lectures suivent les permissions du rôle. Le rôle doit porter une ligne de permission qui nomme le doctype étranger.
-
Les surfaces d’automatisation. Les champs de réplication, les hooks à
source étrangère et les lectures Lua d’un doctype étranger exigent une attribution de domaine active. Sans couverture, la lecture est refusée.
Les flux au sein d’un même domaine sautent tous ces contrôles. Un domaine qui se lit lui-même ne pose pas de décision de partage.
Ce que partage une attribution. Une attribution est un document sous le domaine producteur, et une attribution couvre un seul domaine consommateur. Elle porte une liste de ressourcesà : une entrée par doctype producteur, et chaque entrée nomme des étiquettes de champ. Les attributions donnent un accès en lecture seulement — aucun accès en écriture n’existe.
Un champ est partagé quand ses étiquettes correspondent. Les champs sans étiquette comptent comme
default, donc une entrée qui nommedefaultatteint chaque champ sans étiquette. Le consommateur reçoit seulement les champs couvertsà ; le serveur retire les autres avant la livraison.Le producteur décide de l’activation. L’activation appartient au producteur, et elle est tout ou rien par attribution. Une publication qui élargit les ressources partagées fait repasser une attribution active en inactive. Le producteur doit l’accepter de nouveau.
Un seul saut. La réplication fait un seul saut. Un champ de réplication ne peut pas alimenter un autre champ de réplicationà ; le contrôle de création refuse la chaîne avec un
422.
Le compromis
Section intitulée « Le compromis »Les attributions couplent les domaines. Le consommateur lit la donnée à
la source, donc il dépend du contrat du producteur. Désactivez l’attribution : les copies cessent de se mettre à jour. Réduisez les étiquettesà : les valeurs déj à copiées restent en place. Aucun traitement ne les efface. Réactivez l’attribution : le prochain événement source renvoie la valeur.
L’isolement strict coûte de la duplication. Les deux options sont pleinement prises en charge. Quand le couplage coûte plus que la copie, dupliquez le champ et gardez les domaines totalement indépendants.
Voir aussi
Section intitulée « Voir aussi »- Architecture en un coup d’œil — où les domaines se situent dans le chemin d’une requête.
- Domaines, brouillons et éditeurs de domaines — créer un domaine et y enregistrer des doctypes.
- Réplication inter-domaines — le mécanisme de copie qu’une attribution contrôle.
- Application des autorisations — les vérifications de rôle derrière l’API de documents.
- Internes sur GitHubà : doctype-system.md, domain-grants.md, replication.md.