Échange de la base de connaissances organisationnelle

Transmettez les acquis des espaces de travail vers un corpus organisationnel gouverné et interrogez-le depuis tous les espaces de travail

Cet artefact est livré dans un pack. Pour le cycle de vie partagé — installation, pack build, téléversement — voir Packs & SDK d'authoring.

L'Échange de la base de connaissances organisationnelle offre aux espaces de travail une voie gouvernée pour contribuer des lignes depuis leurs données locales typées vers un corpus organisationnel partagé — et pour interroger ce corpus depuis tous les espaces de travail simultanément. Imaginez-le comme un dépôt de connaissances à l'échelle de l'entreprise, typé, versionné : acquis passés, évaluations passées, incidents passés — organisés par domaine, soumis à revue et entièrement auditables.

La base de connaissances org n'est pas un espace de travail plus grand. Les espaces de travail sont des conteneurs d'engagement ou d'équipe ; la base de connaissances org est la propriété intellectuelle de l'entreprise. La promotion est l'événement par lequel la portée d'audience d'une ligne passe de l'espace de travail à l'organisation.

Concepts fondamentaux

Domaines

La base de connaissances org est organisée en domaines (par exemple : learnings, compliance, support). Un domaine est une partition gouvernée du corpus — « domaine » est le terme utilisé dans l'interface de la plateforme ; « partition » désigne la même chose en interne. Chaque domaine est :

Typé — adossé à une ou plusieurs ontologies qui définissent quels types d'objets y résident.
Gouverné indépendamment — avec sa propre politique de lecture (quels rôles peuvent l'interroger), politique de promotion (combien de réviseurs, quels rôles) et paramètres de rétention.
Optionnellement immuable — une fois défini, les lignes d'un domaine immuable ne peuvent qu'être révoquées, jamais écrasées.

Un domaine est créé lorsqu'un pack déclarant knowledgebases[] est installé — il n'existe pas d'action « créer un domaine » dans l'interface de la plateforme. Voir Extension du manifeste du pack pour les détails de création.

Essayez-le : le pack de démarrage

Le pack Org KB Starter déclare trois domaines prêts à l'emploi pour vous permettre d'explorer l'échange de bout en bout sans créer de manifeste au préalable :

learnings — acquis durables de projets (mutable ; promotion automatique sur validated)
contracts — contrats exécutés (immuable ; promotion avec deux réviseurs)
incidents — post-mortems d'incidents (promotion approuvée automatiquement)

Téléchargez le pack de démarrage : org-kb-starter.scrydon-pack.tar.gz (ou le build épinglé à la version).

Dans la plateforme, accédez à Paramètres → Packs et installez le fichier .scrydon-pack.tar.gz téléchargé.

Ouvrez Paramètres → Organisation → Base de connaissances → Domaines. Les trois domaines (learnings, contracts, incidents) apparaissent maintenant dans le tableau.

Cycle de vie de la promotion

La promotion est la façon dont les lignes d'un espace de travail entrent dans le corpus org. Chaque promotion est un événement suivi et révisé — jamais une copie silencieuse.

Tout membre d'un espace de travail disposant du rôle approprié appelle org_kb.promote(), en indiquant la partition cible, les lignes sources et un motif. La plateforme crée un instantané du plan de révision (qui doit approuver, et dans quels rôles) au moment de la création de la demande.

Les réviseurs désignés (issus de la politique de promotion de la partition) approuvent ou rejettent la demande. Pour les partitions configurées avec autoApproveWhen, la plateforme évalue la condition sur les lignes sources et peut approuver automatiquement.

Une fois les approbations requises collectées, la plateforme matérialise les lignes dans la partition, enregistre la provenance (lien vers la ligne d'origine dans l'espace de travail) et — pour les partitions immuables — écrit une enveloppe signée permettant la vérification indépendante du contenu.

Les lignes matérialisées sont immédiatement visibles pour les appelants de org_kb.query() disposant d'un accès en lecture à cette partition.

Les promotions peuvent être annulées par l'initiateur avant qu'un réviseur intervienne. L'historique complet des demandes (qui a décidé, quand, avec quel commentaire) est conservé dans le journal d'audit.

Interroger le corpus

org_kb.query() est une lecture fédérée : la plateforme se déploie sur toutes les partitions auxquelles l'appelant peut accéder, applique une occultation par partition (les propriétés classifiées restricted sont supprimées pour les appelants sans les rôles requis), et renvoie un jeu de résultats fusionné et typé. L'API prend en charge :

asOf — requêtes dans le temps pour voir le corpus à un horodatage passé.
includeVersions — renvoie toutes les versions historiques de chaque ligne, pas seulement la version actuelle.
includeRevoked — inclut les lignes révoquées (portée audit / DPO ; requiert un privilège élevé).

Historique et provenance des lignes

Chaque ligne matérialisée porte un enregistrement de provenance la reliant à sa ligne source dans l'espace de travail. Lorsqu'une ligne est à nouveau promue (contenu mis à jour, nouveau déclenchement), un nouvel enregistrement de provenance est créé qui pointe vers le précédent — formant une chaîne de versions. Vous pouvez parcourir la chaîne complète avec org_kb.getRowHistory().

Révocation

Les lignes de la base de connaissances org peuvent être révoquées — supprimées de la surface de requête standard sans détruire la piste d'audit. La révocation suit le même cycle de vie que la promotion : une demande de type revoke est déposée, révisée (généralement par un DPO ou un réviseur légal), puis matérialisée. La ligne révoquée disparaît des résultats de org_kb.query() mais reste visible dans la chaîne de provenance pour getRowHistory() et les exports de bundle d'audit.

La re-promotion après révocation est explicitement autorisée — c'est ainsi que fonctionne la rectification. La nouvelle promotion crée une ligne fraîche avec une nouvelle provenance ; la version révoquée reste dans la chaîne comme preuve.

File de révision d'administration

Les administrateurs org et les réviseurs désignés gèrent la base de connaissances org depuis Paramètres → Organisation → Base de connaissances dans l'interface de la plateforme, répartie en quatre onglets :

Domaines — liste tous les domaines que le visualisateur peut lire, avec la source et l'immuabilité. Chaque ligne propose des actions Exporter le bundle d'audit et Révoquer une ligne… ; une indication explique que les domaines sont ajoutés en installant un pack.
File de révision — demandes de promotion/révocation en attente dans tous les domaines ; chaque carte affiche l'espace de travail source, les lignes sources, le motif et le plan de révision. Approuvez ou rejetez avec un commentaire optionnel.
Marquages — le registre des marquages de sécurité au niveau de l'instance : listez et créez des marquages (vous ne pouvez créer que des marquages que vous satisfaisez). Voir Marquages & récupération gouvernée.
Explorer — exécutez des récupérations query et expand gouvernées en tant que vous-même, pour vérifier le contrôle d'accès et l'occultation.

Le visualiseur d'historique de ligne (lancé depuis l'onglet Domaines) affiche la chaîne de provenance complète pour toute ligne de la base de connaissances org : toutes les versions, qui a promu chacune, les décisions des réviseurs et les événements de révocation.

Export du bundle d'audit

org_kb.exportAuditBundle() produit une archive signée et auto-contenue (JSON + signatures) de tous les événements de matérialisation pour une partition sur une plage de dates. Le bundle est vérifiable indépendamment sans accès à la plateforme — convient aux auditeurs externes ou aux dossiers de preuves de conformité.