---
title: "Глоссарий"
description: "Notarium терминдері: кеңістік, жоба, notarium-id, жазба класы, субъект, PAT, журнал, RRF және басқалары."
---

# Глоссарий

Notarium-ның негізгі терминдерінің қысқаша анықтамалары. Әрбір термин ол толығырақ ашылатын бетке сілтейді.

## Сақтау және бірегейлік

**file-first** — ақиқат көзі дискідегі Markdown-файлдардың өзі болатын принцип. Іздеу индексі, байланыстар графы және барлық туынды нәрсе файлдардан қайта құрылады; қалтаны алып, кез келген сәтте кетуге болады. Толығырақ — [File-first](/docs/concepts/file-first/).

**кеңістік (space)** — өз индексі, графы, іздеуі, ағашы, ревизиялар журналы және қатысушылар құрамы бар оқшауланған білім қоры. Әр пайдаланушыда жойылмайтын жеке кеңістік болады (агенттік беттерде оны **жеке домен** деп атайды). Толығырақ — [Кеңістіктер мен жобалар](/docs/concepts/spaces-and-projects/).

**жоба** — жеңіл әрі міндетті емес нысан: кеңістік ішінде тұрақты бірегейлігі бар белгіленген қалта (белгі — қалта түбіріндегі dot-файл). Агент оны `space/slug` хэндлі арқылы адрестейді. Толығырақ — [Кеңістіктер мен жобалар](/docs/concepts/spaces-and-projects/).

**`notarium-id`** — frontmatter-дегі жазбаның тұрақты 12 таңбалы идентификаторы. Файлды жылжытқанда және қайта атағанда да сақталады, сондықтан байланыстар мен тарих үзілмейді. Толығырақ — [Нұсқалар тарихы](/docs/concepts/versioning/).

**жазба класы** — сақталу орнынан шығарылатын көріну мен индекстеу саясаттарының жиынтығы (еркін өріс емес): `user-doc` (пайдаланушылық, барлық жерде көрінеді), `agent-memory` (агент жады, индекстеледі және `recall` арқылы қолжетімді, бірақ пайдаланушылық беттерден жасырылған), сондай-ақ қызметтік `attachment`, `derived` және `profile`. Толығырақ — [Жазба түрлері](/docs/concepts/note-types/).

## Қол жеткізу және агенттер

**субъект (principal)** — жалпыланған қол жеткізу субъектісі: адам немесе ЖИ-агент. Барлығына бір ғана рұқсат беру механизмі. Толығырақ — [Қол жеткізу моделі](/docs/concepts/access-model/).

**рөлдер** — кеңістіктегі мүшелік: `reader` (бәрін оқиды), `writer` (жазбаларды өңдейді), `owner` (мүшелікті басқарады). Толығырақ — [Қол жеткізу моделі](/docs/concepts/access-model/).

**PAT (Personal Access Token)** — агенттерге арналған жеке қол жеткізу токені, `Authorization: Bearer …` тақырыбымен беріледі. Оның ауқымы (`read`/`write`), кеңістіктер бойынша міндетті емес тарылтуы және жарамдылық мерзімі бар. Құпия дәл бір рет қана көрсетіледі. Толығырақ — [Агентті қосу](/docs/agents/connect/).

**MCP шлюзі** — ЖИ-агент білім қорын ниетке бағытталған құралдармен (әмбебап CRUD-операциялармен емес) оқитын және жазатын кірістірілген `POST /mcp` эндпоинті. Агенттің түзетулері нұсқаланады, қол жеткізулермен шектеледі және шығу тегімен қолтаңбаланады. Толығырақ — [Агенттер және MCP](/docs/agents/).

**ниет құралы** — төмен деңгейлі қойма CRUD-операциясын емес, ниетті («тап», «жазба жаса») білдіретін MCP шлюзінің құралы. Толығырақ — [Ниет құралдары](/docs/agents/intent-tools/).

## Іздеу

**гибридті іздеу** — үш арнаның бірігуі: лексикалық (толық мәтіндік FTS/BM25, әрдайым қосулы), семантикалық (векторлар, жалаушамен қосылады) және міндетті емес граф күшейтуі. Нәтижелер RRF алгоритмімен біріктіріледі. Толығырақ — [Іздеу](/docs/concepts/search/).

**RRF (Reciprocal Rank Fusion)** — рейтингтелген тізімдерді (лексика + семантика + граф) ортақ ұпай шкаласынсыз біртұтас нәтижеге салмақтап біріктіретін алгоритм. Толығырақ — [Іздеу](/docs/concepts/search/).

**деградация** — тәуелділіктері болмаған кезде мүмкіндіктің қарапайымырақ нұсқаға шегінуі: векторлық стек өшірулі немесе қолжетімсіз болса, іздеу толық мәтін (FTS) бойынша жұмысын жалғастырады — қатесіз әрі сол нәтижемен. Толығырақ — [Іздеуді баптау](/docs/self-hosting/search-setup/).

## Нұсқалар мен шығу тегі

**ревизиялар журналы** — қызметтік дерекқордағы жазбалардың нұсқалар тарихы (git емес). Ревизия — күйдің толық лездік көшірмесі; бірдей күйлер мазмұны бойынша дедупликацияланады. Журналдың кілті — `notarium-id`, сондықтан тарих жылжытқанда және қайта атағанда да сақталады. Толығырақ — [Нұсқалар тарихы](/docs/concepts/versioning/).

**шығу тегі (provenance)** — әр ревизияның атрибуциясы: түзетуді кім және қалай енгізді — нақты адам, нақты ЖИ-агент немесе сыртқы файл редакторы. Толығырақ — [Нұсқалар тарихы](/docs/concepts/versioning/).

## Орналастыру

**self-host** — Notarium-ның орналастыру моделі: бір өзіне-өзі жеткілікті контейнер (Node/Fastify, процесс ішіндегі қозғалтқыш, сыртқы сервистерсіз). Құпиялылық серверге және файлдарға иелік етумен қамтамасыз етіледі, ұштан-ұшқа шифрлаумен емес. Толығырақ — [Self-host](/docs/self-hosting/).

## Сондай-ақ қараңыз

- [Орта айнымалылары](/docs/reference/environment-variables/) — конфигурацияның толық кестесі.
- [Пернелер тіркесімінің анықтамасы](/docs/reference/keyboard-shortcuts/) — орналасулар мен пресеттер.
- [Концепциялар](/docs/concepts/) — Notarium қалай құрылған.