--- title: "Glossário" description: "Termos do Notarium: espaço, projeto, notarium-id, classe de nota, principal, PAT, registro de revisões, RRF e mais." --- # Glossário Definições curtas dos principais termos do Notarium. Cada termo leva à página onde ele é explicado por completo. ## Armazenamento e identidade **file-first** — o princípio de que a fonte da verdade são os próprios arquivos Markdown, no disco. O índice de busca, o grafo de links e tudo o que é derivado podem ser reconstruídos a partir dos arquivos; você pode pegar a pasta e ir embora a qualquer momento. Mais em [File-first](/docs/concepts/file-first/). **espaço (space)** — uma base de conhecimento isolada, com seu próprio índice, grafo, busca, árvore, registro de revisões e lista de membros. Todo usuário tem um espaço pessoal que não pode ser excluído (nas páginas voltadas a agentes ele é chamado de **domínio pessoal**). Mais em [Espaços e projetos](/docs/concepts/spaces-and-projects/). **projeto** — uma entidade leve e opcional: uma pasta marcada com identidade estável dentro de um espaço (a marca é um dot-file na raiz da pasta). Um agente o endereça pelo handle `space/slug`. Mais em [Espaços e projetos](/docs/concepts/spaces-and-projects/). **`notarium-id`** — um identificador de nota estável, de 12 caracteres, no frontmatter. Ele sobrevive a mover e renomear o arquivo, então links e histórico nunca se quebram. Mais em [Histórico de versões](/docs/concepts/versioning/). **classe de nota** — um conjunto de políticas de visibilidade e indexação derivado de onde a nota está armazenada (não é um campo de texto livre): `user-doc` (nota do usuário, visível em toda parte), `agent-memory` (memória do agente, indexada e acessível via `recall`, mas oculta das superfícies voltadas ao usuário), além dos internos `attachment`, `derived` e `profile`. Mais em [Tipos de nota](/docs/concepts/note-types/). ## Acesso e agentes **principal** — um sujeito de acesso generalizado: uma pessoa ou um agente de IA. Um único mecanismo de concessão para todos eles. Mais em [Modelo de acesso](/docs/concepts/access-model/). **papéis** — participação em um espaço: `reader` (lê tudo), `writer` (edita notas), `owner` (gerencia a participação). Mais em [Modelo de acesso](/docs/concepts/access-model/). **PAT (Personal Access Token)** — um token de acesso pessoal para agentes, enviado no cabeçalho `Authorization: Bearer …`. Ele carrega um escopo (`read`/`write`), restrição opcional por espaço e uma validade. O segredo é exibido exatamente uma vez. Mais em [Conectar um agente](/docs/agents/connect/). **gateway MCP** — o endpoint `POST /mcp` embutido, pelo qual um agente de IA lê e escreve na base de conhecimento usando ferramentas orientadas a intenção (em vez de operações CRUD genéricas). As edições de um agente são versionadas, limitadas pelo acesso e assinadas com proveniência. Mais em [Agentes e MCP](/docs/agents/). **ferramenta de intenção** — uma ferramenta do gateway MCP que expressa uma intenção ("encontrar", "criar uma nota") em vez de uma operação CRUD de baixo nível no armazenamento. Mais em [Ferramentas de intenção](/docs/agents/intent-tools/). ## Busca **busca híbrida** — uma fusão de três canais: léxico (texto completo FTS/BM25, sempre ativo), semântico (vetores, habilitado por uma flag) e um graph boost opcional. Os resultados são combinados pelo algoritmo RRF. Mais em [Busca](/docs/concepts/search/). **RRF (Reciprocal Rank Fusion)** — um algoritmo que pondera e funde listas ranqueadas (léxico + semântico + grafo) em um único conjunto de resultados, sem uma escala de pontuação compartilhada. Mais em [Busca](/docs/concepts/search/). **degradação** — uma funcionalidade recuando para uma variante mais simples quando suas dependências não estão presentes: se a stack vetorial está desligada ou indisponível, a busca continua funcionando sobre o texto completo (FTS) — sem erro e com o mesmo resultado. Mais em [Configuração da busca](/docs/self-hosting/search-setup/). ## Versões e proveniência **registro de revisões** — o histórico de versões das notas no banco de metadados (não no git). Uma revisão é um snapshot completo do estado; estados idênticos são deduplicados por conteúdo. O registro é indexado por `notarium-id`, então o histórico sobrevive a mover/renomear. Mais em [Histórico de versões](/docs/concepts/versioning/). **proveniência** — a atribuição de cada revisão: quem fez a edição e como — uma pessoa específica, um agente de IA específico ou um editor de arquivos externo. Mais em [Histórico de versões](/docs/concepts/versioning/). ## Implantação **self-host** — o modelo de implantação do Notarium: um único contêiner autossuficiente (Node/Fastify, motor no mesmo processo, sem serviços externos). A privacidade vem de você ser dono do servidor e dos arquivos, não de criptografia de ponta a ponta. Mais em [Self-host](/docs/self-hosting/). ## Veja também - [Variáveis de ambiente](/docs/reference/environment-variables/) — a tabela completa de configuração. - [Referência de atalhos de teclado](/docs/reference/keyboard-shortcuts/) — layouts e presets. - [Conceitos](/docs/concepts/) — como o Notarium é construído.