--- title: "Glossaire" description: "Les termes de Notarium : espace, projet, notarium-id, classe de note, principal, PAT, journal des révisions, RRF, et plus encore." --- # Glossaire Définitions courtes des termes clés de Notarium. Chaque terme renvoie à la page qui le développe en détail. ## Stockage et identité **file-first** — le principe selon lequel la source de vérité, ce sont les fichiers Markdown eux-mêmes, sur le disque. L'index de recherche, le graphe de liens et tout ce qui en dérive sont reconstructibles à partir des fichiers ; vous pouvez récupérer le dossier et partir à tout moment. Plus de détails dans [File-first](/docs/concepts/file-first/). **espace** — une base de connaissances isolée, avec son propre index, son graphe, sa recherche, son arborescence, son journal des révisions et sa liste de membres. Chaque utilisateur dispose d'un espace personnel non supprimable (sur les pages destinées aux agents, on l'appelle **domaine personnel**). Plus de détails dans [Espaces et projets](/docs/concepts/spaces-and-projects/). **projet** — une entité légère et optionnelle : un dossier marqué doté d'une identité stable au sein d'un espace (le marqueur est un dot-file à la racine du dossier). Un agent l'adresse via le handle `space/slug`. Plus de détails dans [Espaces et projets](/docs/concepts/spaces-and-projects/). **`notarium-id`** — un identifiant de note stable, de 12 caractères, dans le frontmatter. Il survit au déplacement et au renommage du fichier, de sorte que les liens et l'historique ne se rompent jamais. Plus de détails dans [Historique des versions](/docs/concepts/versioning/). **classe de note** — un ensemble de politiques de visibilité et d'indexation dérivé de l'endroit où la note est stockée (et non un champ libre) : `user-doc` (note utilisateur, visible partout), `agent-memory` (mémoire d'agent, indexée et accessible via `recall` mais masquée des surfaces destinées à l'utilisateur), plus les classes internes `attachment`, `derived` et `profile`. Plus de détails dans [Types de notes](/docs/concepts/note-types/). ## Accès et agents **principal** — un sujet d'accès généralisé : une personne ou un agent IA. Un seul mécanisme d'octroi pour tous. Plus de détails dans [Modèle d'accès](/docs/concepts/access-model/). **rôles** — l'appartenance à un espace : `reader` (lit tout), `writer` (édite les notes), `owner` (gère l'appartenance). Plus de détails dans [Modèle d'accès](/docs/concepts/access-model/). **PAT (Personal Access Token)** — un jeton d'accès personnel pour les agents, transmis dans l'en-tête `Authorization: Bearer …`. Il porte une portée (`read`/`write`), une restriction facultative par espace et une date d'expiration. Le secret n'est affiché qu'une seule fois. Plus de détails dans [Connecter un agent](/docs/agents/connect/). **passerelle MCP** — l'endpoint intégré `POST /mcp` par lequel un agent IA lit et écrit dans la base de connaissances à l'aide d'outils orientés intention (plutôt que d'opérations CRUD génériques). Les modifications d'un agent sont versionnées, bornées par ses accès et signées avec leur provenance. Plus de détails dans [Agents et MCP](/docs/agents/). **outil d'intention** — un outil de la passerelle MCP qui exprime une intention (« trouver », « créer une note ») plutôt qu'une opération CRUD bas niveau sur le stockage. Plus de détails dans [Outils d'intention](/docs/agents/intent-tools/). ## Recherche **recherche hybride** — la fusion de trois canaux : lexical (plein texte FTS/BM25, toujours actif), sémantique (vecteurs, activé par un flag) et un graph boost facultatif. Les résultats sont combinés par l'algorithme RRF. Plus de détails dans [Recherche](/docs/concepts/search/). **RRF (Reciprocal Rank Fusion)** — un algorithme qui pondère et fusionne des listes classées (lexical + sémantique + graphe) en un unique jeu de résultats, sans échelle de score commune. Plus de détails dans [Recherche](/docs/concepts/search/). **dégradation** — une capacité qui se replie sur une variante plus simple lorsque ses dépendances sont absentes : si la pile vectorielle est désactivée ou indisponible, la recherche continue de fonctionner sur le plein texte (FTS) — sans erreur, et avec le même résultat. Plus de détails dans [Configuration de la recherche](/docs/self-hosting/search-setup/). ## Versions et provenance **journal des révisions** — l'historique des versions des notes dans la base de métadonnées (pas git). Une révision est un instantané complet de l'état ; les états identiques sont dédupliqués par contenu. Le journal est indexé par `notarium-id`, de sorte que l'historique survit au déplacement et au renommage. Plus de détails dans [Historique des versions](/docs/concepts/versioning/). **provenance** — l'attribution de chaque révision : qui a effectué la modification et comment — une personne précise, un agent IA précis, ou un éditeur de fichiers externe. Plus de détails dans [Historique des versions](/docs/concepts/versioning/). ## Déploiement **self-host** — le modèle de déploiement de Notarium : un unique conteneur autonome (Node/Fastify, moteur in-process, sans services externes). La confidentialité tient au fait que vous possédez le serveur et les fichiers, non à un chiffrement de bout en bout. Plus de détails dans [Auto-hébergement](/docs/self-hosting/). ## Voir aussi - [Variables d'environnement](/docs/reference/environment-variables/) — le tableau de configuration complet. - [Référence des raccourcis clavier](/docs/reference/keyboard-shortcuts/) — dispositions et préréglages. - [Concepts](/docs/concepts/) — comment Notarium est construit.