NotariumDocumentation
Version de la documentation: latest
FR

Espaces et projets

Notarium établit une distinction entre deux unités d'organisation : l'espace — une base de connaissances isolée et une frontière de sécurité — et le projet — un dossier étiqueté à l'intérieur d'un espace. Ce sont deux choses différentes aux rôles différents : l'espace isole, le projet organise.

L'espace — l'unité d'isolation

Un espace est une base de connaissances autonome : son propre index, son graphe, sa recherche, son arborescence, son journal d'historique et son propre ensemble de membres. Les espaces ne se chevauchent pas : les notes, la recherche et les liens de l'un ne sont pas visibles depuis l'autre. Un espace joue deux rôles à la fois — l'organisation (« personnel » / « travail » / « archives ») et celui de frontière de sécurité : c'est au niveau de l'espace que se décide qui voit quoi.

  • Chaque espace est desservi par exactement une instance de moteur — l'isolation découle de l'architecture elle-même.
  • L'identité d'un espace est un space_id interne stable ; le slug (compatible URL : lettres latines minuscules, chiffres, tirets et tirets bas — [a-z0-9_-]) est une adresse renommable et un identifiant d'URL, tandis que displayName est un libellé lisible par un humain. Renommer un slug est sans risque : l'ancien nom passe dans l'historique des alias et continue de se résoudre (/s/<ancien> redirige vers l'actuel).
  • Adressage : /s/<slug> dans l'interface et /api/s/<slug>/… en REST.

Pour en savoir plus sur les rôles et la confidentialité, voir Modèle d'accès.

L'espace personnel

Chaque utilisateur dispose obligatoirement d'un espace personnel — son foyer par défaut :

  • il est créé lors de la création du compte et ne peut pas être supprimé ;
  • il sert de page d'accueil par défaut et abrite la mémoire privée des agents à votre sujet ainsi que votre profil ;
  • c'est un espace de travail à part entière : vous pouvez prendre des notes et étiqueter des projets sur-le-champ, sans rien configurer séparément.
Vous ne pouvez pas inviter un second membre dans un espace personnel

C'est la seule différence entre un espace personnel et un espace ordinaire. Un autre membre disposant d'un accès en lecture verrait votre mémoire privée et vos notes personnelles — c'est pourquoi les invitations dans un espace personnel sont interdites au niveau du serveur, et pas seulement masquées dans l'interface.

Le projet — un dossier étiqueté

Un projet est une entité légère et facultative : un sous-arbre de dossiers ordinaire à l'intérieur d'un espace, que l'on a étiqueté comme projet. Le contenu n'a pas à résider dans des projets — un dossier non étiqueté reste un simple dossier.

L'étiquette est un fichier caché .notariummeta à la racine du dossier (un JSON avec un id stable). Il voyage avec le dossier lors de tout déplacement, y compris externe (git, un gestionnaire de fichiers) — l'identité d'un projet est ancrée dans le dossier lui-même, et non uniquement dans la base de données.

myspace/
├─ research/
│  └─ .notariummeta      ← dossier étiqueté = projet
├─ inbox/                ← dossier ordinaire (pas un projet)
└─ ...
  • L'adressage est un identifiant (space, slug), sur le modèle group/project de GitLab. Le slug d'un projet est unique au sein d'un espace ; les projets de même nom d'un espace à l'autre se distinguent par le champ space. Le projet racine se réduit à <space> seul (par exemple main, et non main/main).
  • Le slug d'un projet est une forme kebab-case translittérée de displayName ou du dernier segment du chemin (pas du chemin entier).
  • Étiqueter un dossier, retirer l'étiquette ou créer un « New project » sont des actions humaines (la permission space:write). Un agent ne crée pas de conteneurs : il possède le contenu, l'humain possède la structure.
  • Créer un espace étiquette automatiquement sa racine comme projet — de sorte que l'agent peut écrire dans <space> immédiatement, sans étiquetage manuel.

Un projet est une portée et une adresse, mais pas une frontière de sécurité : la décision d'accès repose toujours sur l'appartenance à l'espace. Pour savoir comment un agent adresse les projets, voir Outils d'intention.

Prérequis et limites

Les projets s'appuient sur la base de métadonnées et le stockage local des étiquettes — sans eux, un projet ne peut pas être ouvert.