--- title: "Glosario" description: "Términos de Notarium: espacio, proyecto, notarium-id, clase de nota, principal, PAT, registro de revisiones, RRF y más." --- # Glosario Definiciones breves de los términos clave de Notarium. Cada término enlaza con la página donde se explica en detalle. ## Almacenamiento e identidad **file-first** — el principio según el cual la fuente de verdad son los propios archivos Markdown, en el disco. El índice de búsqueda, el grafo de enlaces y todo lo derivado se pueden reconstruir a partir de los archivos; puedes tomar la carpeta e irte cuando quieras. Más en [File-first](/docs/concepts/file-first/). **espacio** — una base de conocimiento aislada con su propio índice, grafo, búsqueda, árbol, registro de revisiones y lista de miembros. Cada usuario tiene un espacio personal no eliminable (en las páginas orientadas a agentes se le llama **dominio personal**). Más en [Espacios y proyectos](/docs/concepts/spaces-and-projects/). **proyecto** — una entidad ligera y opcional: una carpeta marcada con una identidad estable dentro de un espacio (la marca es un dot-file en la raíz de la carpeta). Un agente lo direcciona por su handle `space/slug`. Más en [Espacios y proyectos](/docs/concepts/spaces-and-projects/). **`notarium-id`** — un identificador de nota estable de 12 caracteres en el frontmatter. Sobrevive a mover y renombrar el archivo, de modo que los enlaces y el historial nunca se rompen. Más en [Historial de versiones](/docs/concepts/versioning/). **clase de nota** — un conjunto de políticas de visibilidad e indexación que se deriva del lugar donde se almacena la nota (no es un campo libre): `user-doc` (nota de usuario, visible en todas partes), `agent-memory` (memoria del agente, indexada y accesible mediante `recall` pero oculta de las superficies orientadas al usuario), más los internos `attachment`, `derived` y `profile`. Más en [Tipos de nota](/docs/concepts/note-types/). ## Acceso y agentes **principal** — un sujeto de acceso generalizado: una persona o un agente de IA. Un único mecanismo de concesión para todos. Más en [Modelo de acceso](/docs/concepts/access-model/). **roles** — membresía en un espacio: `reader` (lee todo), `writer` (edita notas), `owner` (gestiona la membresía). Más en [Modelo de acceso](/docs/concepts/access-model/). **PAT (Personal Access Token)** — un token de acceso personal para agentes, que se envía en la cabecera `Authorization: Bearer …`. Lleva un alcance (`read`/`write`), la posibilidad de restringirlo a espacios concretos y una fecha de caducidad. El secreto se muestra exactamente una vez. Más en [Conectar un agente](/docs/agents/connect/). **pasarela MCP** — el endpoint integrado `POST /mcp` a través del cual un agente de IA lee y escribe en la base de conocimiento con herramientas orientadas a la intención (en lugar de operaciones CRUD genéricas). Las ediciones de un agente se versionan, quedan limitadas por el acceso y se firman con procedencia. Más en [Agentes y MCP](/docs/agents/). **herramienta de intención** — una herramienta de la pasarela MCP que expresa una intención («buscar», «crear una nota») en lugar de una operación CRUD de bajo nivel sobre el almacenamiento. Más en [Herramientas de intención](/docs/agents/intent-tools/). ## Búsqueda **búsqueda híbrida** — una fusión de tres canales: léxico (texto completo FTS/BM25, siempre activo), semántico (vectores, se activa con un flag) y un refuerzo por grafo opcional. Los resultados se combinan mediante el algoritmo RRF. Más en [Búsqueda](/docs/concepts/search/). **RRF (Reciprocal Rank Fusion)** — un algoritmo que pondera y fusiona listas ordenadas (léxico + semántico + grafo) en un único conjunto de resultados sin una escala de puntuación común. Más en [Búsqueda](/docs/concepts/search/). **degradación** — una capacidad que recurre a una variante más simple cuando sus dependencias no están presentes: si el stack vectorial está desactivado o no disponible, la búsqueda sigue funcionando sobre el texto completo (FTS), sin error y con el mismo resultado. Más en [Configuración de la búsqueda](/docs/self-hosting/search-setup/). ## Versiones y procedencia **registro de revisiones** — el historial de versiones de las notas en la base de datos de metadatos (no git). Una revisión es una instantánea completa del estado; los estados idénticos se deduplican por contenido. El registro está indexado por `notarium-id`, así que el historial sobrevive a mover/renombrar. Más en [Historial de versiones](/docs/concepts/versioning/). **procedencia** — la atribución de cada revisión: quién hizo la edición y cómo — una persona concreta, un agente de IA concreto o un editor de archivos externo. Más en [Historial de versiones](/docs/concepts/versioning/). ## Despliegue **autoalojamiento** — el modelo de despliegue de Notarium: un único contenedor autónomo (Node/Fastify, motor en el mismo proceso, sin servicios externos). La privacidad proviene de ser dueño del servidor y de los archivos, no de un cifrado de extremo a extremo. Más en [Self-host](/docs/self-hosting/). ## Véase también - [Variables de entorno](/docs/reference/environment-variables/) — la tabla de configuración completa. - [Referencia de atajos de teclado](/docs/reference/keyboard-shortcuts/) — distribuciones y preajustes. - [Conceptos](/docs/concepts/) — cómo está construido Notarium.