--- title: "Espaces et projets" description: "Un espace est une base isolée et une frontière de sécurité ; un projet est un dossier étiqueté à l'intérieur, qu'un agent atteint par un nom stable." --- # 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/` redirige vers l'actuel). - Adressage : `/s/` dans l'interface et `/api/s//…` en REST. Pour en savoir plus sur les rôles et la confidentialité, voir [Modèle d'accès](/docs/concepts/access-model/). ## 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. > [!important] 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. ```md 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 à `` 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 `` 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](/docs/agents/intent-tools/). > [!note] 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.