Glossary — German contract terms to English identifiers#
The project was specified in German under the working title "Wissensdienst" (datenmodell.md,
api-vertrag.md, zielbild.md). architecture.md is the authoritative English
contract; this table maps every German term to the identifier used in code, schema and API.
Pure renames are listed only here. Changes in substance are in
abweichungen.md.
Concepts#
| German | English | Notes |
|---|---|---|
| Wissensdienst | Groundnote | service name groundnote, MCP server groundnote |
| Bereich | scope | name ^[a-z][a-z0-9-]{1,39}$ |
| bereichsübergreifend | cross_scope |
|
| Bereichsprüfung | scope check (pipeline) | |
Regel / Hinweis (art) |
rule / note (kind: rule | note) |
|
| Kennung | id |
sales-0042 |
| Fassung | version | ref rule/<id>@<n> |
| Verweis | ref | rule/<id>, source/<id>, attachment/<source-id>#<n> |
| Quelle | source | |
| Faden | thread | |
| Anhang | attachment | |
| Ausschnitt | excerpt | |
| Bezug | relation | |
| Zitat / Zitatprüfung | quote / quote check | |
| Dublette | duplicate | |
| Abruf | search | |
| Stufe a / b / c | stage a / b / c | b = semantic, c = reranker |
| Prüfer | reranker | |
| Bündel / Kopf / Gruppe / Eintrag / Zeile | bundle / head / group / entry / line | |
| Rückmeldung | feedback | |
| Rückfrage „noch gültig?" | recheck "still valid?" |
|
| Vorschlag | proposal | |
| Entscheidung | decision | |
| Freigabe | approval | UI under /approval/* |
| Zugang | grant | |
| Kanal | channel | |
| Betrieb | ops | |
| Zubringer | feeder | |
| Eingang | inbox | |
| Ausgang | output | |
| Sicherung | backup | |
| Totmannschalter | dead man's switch (deadman_url) |
|
| Wiederherstellungsprobe | restore probe | |
| Prüfsatz | test set | |
| Instanz | instance | |
| Anbieter | provider | |
| Deckel | budget |
Status, decisions, kinds, rights, channels#
| German | English |
|---|---|
vorschlag · bestaetigt · ueberholt · verworfen |
proposed · confirmed · superseded · rejected |
bestaetigen · verwerfen · aufheben · geprueft |
confirm · reject · revoke · review |
unbestaetigt |
unconfirmed |
Quellart jamie · mail · manuell |
jamie · mail · manual (ids jamie:…, mail:<…>, manual:<grant-id>) |
Bezugsart kunde · produkt · lieferant |
customer · product · supplier |
Eintragsart regel · hinweis · meeting · mail · anhang |
rule · note · meeting · mail · attachment |
Gruppenart quelle · faden · anhang · vorgaenger · nachfolger · gleicher-bezug |
source · thread · attachment · predecessor · successor · same-relation |
Stufenzustand lief · aus · ausgefallen · deckel · nicht-erlaubt |
ran · off · failed · budget · not-allowed |
Urteil passend · unpassend · fehlte |
relevant · irrelevant · missing |
Zugangsart person · dienst |
person · service |
Rechte lesen · vorschlagen · entscheiden |
read · propose · decide |
| Kanal MCP · Freigabe · Dienst-API · Webhooks | mcp · approval · api · webhook |
Abruf-Kanal mcp · api · proaktiv · aufgabe |
mcp · api · proactive · task (plus approval) |
Text-Herkunft ocr · beschreibung · keiner |
ocr · description · none |
Sicherungsart litestream · kopie |
litestream · copy |
Anbieter lokal · voyage · openai · jina · typesafe |
local · voyage · openai · jina · typesafe |
Fields#
| German | English | German | English |
|---|---|---|---|
aussage |
statement |
zitat |
quote |
zeitstempel_s |
timestamp_s |
zeitstempel (Kopf) |
timestamp |
sprecher |
speaker |
datum |
said_at (head/entry: date) |
bezuege |
relations |
stichworte |
keywords |
gueltig_ab |
valid_from |
ungueltig_ab |
valid_until |
ersetzt |
supersedes |
ersetzt_durch |
superseded_by |
grund |
reason |
geaendert_von / geaendert_am |
changed_by / changed_at |
angelegt_von / angelegt_am |
created_by / created_at |
quelle_kennung |
source_id |
zuletzt_geprueft |
last_reviewed_at |
alter_tage |
age_days |
rueckfrage |
recheck |
rang (a, b, rrf, pruefer) |
rank (a, b, rrf, reranker) |
gefunden_ueber |
found_via |
titel |
title |
auszug |
excerpt |
anzahl / eintraege / weitere |
count / entries / more |
zeitpunkt (Quelle) |
occurred_at |
von |
sender |
faden |
thread |
volltext_sha256 |
fulltext_sha256 |
geholt_am |
fetched_at |
zubringer (Spalte) |
feeder |
nr |
n |
dateiname |
filename |
medientyp |
media_type |
groesse |
size |
extern |
external |
text_herkunft |
text_origin |
wer / zeit (Entscheidung) |
decided_by / decided_at |
neue_fassung |
new_version |
fassung (Entscheidungsrumpf) |
version |
aenderung |
change |
entscheidung (Rumpf) |
decision |
zitatpruefung.geprueft |
quote_check.checked |
moegliche_dubletten |
possible_duplicates |
freigabe (URL) |
approval_url |
abruf_id |
search_id |
bereiche / bereich |
scopes / scope |
begriffe / varianten / abfrage |
terms / variants / query |
stufen / dauer_ms |
stages / duration_ms |
buendel / kopf / gruppen / zeile |
bundles / head / groups / line |
bezug (Abruf) |
relation |
stichtag |
as_of |
mit_vorschlaegen |
include_proposals |
eingang (Abruf) |
inbox |
eingabe_sha256 |
input_sha256 |
fehler / aktuell |
error / current |
angenommen |
accepted |
identitaet |
identity |
aktiv |
active |
anhaenge |
attachments |
erfassen / proaktiv |
capture / proactive |
Tables and files#
| German | English |
|---|---|
bereiche/<bereich>.sqlite · betrieb.sqlite |
data/scopes/<scope>.sqlite (rule vectors in its table vec_rule, no separate vector file) · data/ops.sqlite |
meta (bereich, schema_version, angelegt_am) |
meta (scope, schema_version, created_at) |
regel · fassung · Sicht aktuell · entscheidung |
rule · rule_version · view current_version · decision |
quelle · quelle_anhang |
source · source_attachment (new: source_segment) |
eingang · regel_fts · extraktion |
inbox · rule_fts · extraction |
abruf · rueckmeldung · hinweis_gemeldet |
search_log · feedback · notice_reported |
pruefsatz_fall · pruefsatz_lauf |
test_case · test_run |
zugang · zubringer · ausgang_protokoll · ki_usage · sicherung |
grant · feeder · outbound_log · ai_usage · backup_state |
export/<bereich>/ (INDEX.md, <kennung>.md, verlauf.jsonl, manifest.json) |
export/<scope>/ (INDEX.md, <id>.md, history.jsonl, manifest.json) |
entscheide() |
decide() in src/decision/decide.ts |
src/entscheidung/** |
src/decision/** |
Configuration (wissensdienst.json → groundnote.json)#
| German | English |
|---|---|
instanz · zone · bereiche[].name · bereiche[].anbieter_erlaubt |
instance · zone · scopes[].name · scopes[].providers_allowed |
zugang (aussteller, jwks, aud_mcp, aud_freigabe) |
access (team_domain, aud_mcp, aud_approval, aud_api) |
zubringer · ausgaenge (clickup-kommentar, claude-aufgabe, ausloeser_url) |
feeders · outputs (clickup-comment, claude-task, trigger_url) |
suche.semantisch · suche.pruefer · an · anbieter · modell · frist_ms · kandidaten |
search.semantic · search.reranker · enabled · provider · model · timeout_ms · candidates |
modelle (extraktion, begriffe) · deckel_monat_usd |
models (extraction, terms) · budgets_month_usd |
sicherung (art, ziel, praefix, verzeichnis, totmann_url) |
backup (kind, target, prefix, directory, deadman_url) |
export_uhrzeit · rueckfrage_ab_tagen |
export_time · recheck_after_days |
Routes#
| German | English |
|---|---|
POST /v1/ereignisse/quelle |
POST /v1/sources |
POST /v1/ereignisse/jamie/:zubringer · …/graph/:zubringer (…/lebenszyklus) |
POST /v1/events/jamie/:feeder · …/graph/:feeder (…/lifecycle) |
POST /v1/vorschlaege · GET /v1/vorschlaege?bereich= |
POST /v1/proposals · GET /v1/proposals?scope= |
POST /v1/regeln/:kennung/entscheidung |
POST /v1/rules/:id/decision |
GET /v1/regeln?bereich=&status=&bezug= · GET /v1/regeln/:kennung |
GET /v1/rules?scope=&status=&relation= · GET /v1/rules/:id |
GET /v1/herkunft/:kennung |
GET /v1/provenance/:id |
POST /v1/abruf · POST /v1/abruf/:abruf_id/rueckmeldung |
POST /v1/search · POST /v1/search/:search_id/feedback |
GET /v1/export/:bereich · GET /v1/status · GET /health |
GET /v1/export/:scope · GET /v1/status · GET /health |
/freigabe · /freigabe/:kennung · /freigabe/verworfen?bereich= |
/approval · /approval/rules/:id · /approval/rejected?scope= |
POST /v1/betrieb/bereiche · …/zugaenge · …/zugaenge/:id/sperren · …/vektorindex/:bereich/neu |
POST /ops/scopes · /ops/grants · /ops/grants/:id/disable · /ops/vector-index/:scope/rebuild (ops listener) |
MCP tools and CLI#
| German | English |
|---|---|
bereiche · regeln_suchen · regel_lesen · herkunft · regel_vorschlagen · vorschlaege_offen |
scopes · search_rules · read_rule · provenance · propose_rule · open_proposals |
wissensdienst … |
groundnote … |
bereich anlegen <name> |
groundnote scope create <name> |
| Zugang anlegen / sperren | groundnote grants add … / groundnote grants disable <id> |
| (Dienst starten) | groundnote serve |
wiederherstellen --aus-export |
groundnote restore --from-export (later phase) |
Error codes#
| German | English | German | English |
|---|---|---|---|
zitat-nicht-gefunden |
quote-not-found |
quelle-unbekannt |
source-unknown |
verweis-unbekannt |
reference-unknown |
fassung-veraltet |
version-outdated |
schon-entschieden |
already-decided |
vorgaenger-nicht-bestaetigt |
predecessor-not-confirmed |
quelle-unveraenderlich |
source-immutable |
grund-fehlt |
reason-missing |
mehrere-bereiche-ohne-freigabe |
multiple-scopes-without-flag |
bereich-nicht-erlaubt |
scope-not-allowed |
kanal-nicht-erlaubt |
channel-not-allowed |
bereich-gesperrt |
scope-locked |
deckel-erreicht |
budget-reached |
Trigger append-only |
append-only |
Knowledge graph (graph.md)#
The German contract already names most graph identifiers in English (datenmodell.md, section
"Wissensgraph"; api-vertrag.md, section H). Listed here are the German terms and the few
identifiers that change; substance changes are D59–D66 in abweichungen.md.
| German / contract | English | Notes |
|---|---|---|
| Wissensgraph | knowledge graph | per scope file |
| Entität · Kopf · Version | entity · entity head · entity_version |
id <scope>-e<nnnn>, ref entity/<id>@<n> |
area (Bereich der Entität) |
scope |
column entity.scope = meta.scope |
| Eltern-Entität · Kinder · Vorfahren · Nachfahren · Teilbaum | parent (parent_id) · children · ancestors · descendants · subtree |
|
| Ebene · Tiefe | level · depth |
graph.max_depth counts levels incl. the top level |
| Pfad (breadcrumb) | path |
root first; in bundles head.entities[].path |
| Anlegen · Umhängen · Bestätigen · Rücknehmen · Archivieren | create · move · confirm · revert · archive | entity_version.change |
Status active · unconfirmed · archived |
same | |
| Abteilungsleitung · Abteilung · Team | head of division · department · team | types department (both) and a configured team |
| Link · Herkunft · Konfidenz · Beleg | link · origin · confidence · evidence |
origin deterministic · proposed · human |
| Berechnete Links | computed links | replies_to, attachment_of, sourced_from, supersedes; never stored |
Urteil (review: by, at) |
review (columns decided_by, decided_by_identity, decided_at; API by, at) |
verdict confirm · reject · revert |
Strukturänderungen · /freigabe/struktur?bereich= |
Structure changes · /approval/structure?scope= |
approval channel |
| Mindestkonfidenz | graph.proposed_min_confidence |
null: only confirmed proposals count |
entitaeten · pfad · herkunft · vorgeschlagen (Bündel) |
entities · path · origin · proposed |
|
Gruppenart entitaet · widerspricht · Eintragsart entity |
entity · contradicts · entity |
|
nächste Schritte · Abhilfe |
next · remedy |
in every graph answer / error |
duplicate_candidate · cycle · area_mismatch · depth_limit |
duplicate-candidate · cycle · scope-mismatch · depth-limit |
in error, like all codes (D60) |
not_found · forbidden |
not-found · scope-not-allowed / channel-not-allowed |
existing codes |
Prompts create_level · file_incoming_mail · assign_document · restructure · where_does_this_belong |
same | MCP prompts/list |
Redaction and encryption (redaction.md, status: proposed)#
| German | English | Notes |
|---|---|---|
| Schwärzen · Schwärzung | redact · redaction | content removed, row stays |
Grabstein (grabstein) |
tombstone (redaction row, id <scope>-t<nnnn>) |
sealed by redaction_seal |
grabstein_log (betrieb.sqlite) |
redaction_log (ops.sqlite) |
journal without content, replayed after restore |
ziel |
target |
rule/<id> · source/<id> · entity/<id> · link/<id> |
Kategorie loeschanspruch · vertraulich · fehlerfassung · sonstiges |
category erasure-request · confidential · capture-error · other |
enum, no free text |
Marker [geschwärzt] |
REDACTED_TEXT = [redacted, see tombstone] |
plus NULL, '[]', '' per column (D-R3) |
{ref, geschwaerzt: {am, kategorie}} |
{ref, redacted: {at, category}} |
every read path outside approval |
409 geschwaerzt |
409 redacted |
writes to a redacted target |
/freigabe/schwaerzen/vorschau?ziel= · vorschau_id |
/approval/redact?target=, GET /v1/redactions/preview · preview token |
signed, 15 min (D-R6) |
POST /v1/schwaerzungen · schluessel_rotieren |
POST /v1/redactions · rotate_key |
|
vorschau-veraltet · kategorie-unbekannt |
preview-outdated · category-unknown |
also preview-expired, preview-invalid, confirmation-mismatch, already-redacted |
alte_sicherungen · aeltester_stand · verfaellt_am |
old_backups · oldest_state · readable_until |
|
| Krypto-Shredding | crypto-shredding | discard a scope key |
Bereichsschlüssel · Kennung · schluessel (Tabelle) |
scope key · key_id · scope_key |
identities only in GROUNDNOTE_KEY_DIR |
| rotieren · vernichten | rotate · discard | groundnote key rotate · groundnote key discard |
| Tresor | vault | second copy of every identity |
Ruhezustand · verschluesselung.ruhe |
at rest · at_rest.kind |
Phase 1: volume only (D-R8) |
schluessel_rotation_tage |
keys.rotation_days |
|
doctor.max_alter_stunden |
doctor.max_backup_age_hours |
also doctor.max_probe_age_hours |
| Sicherungsstand | backup state |
Approval modes (approval-modes.md, status: proposed)#
| German | English | Notes |
|---|---|---|
Freigabe-Modus · Modus autonom · klassifiziert · standard |
approval mode · autonomous (A) · classified (B) · manual (C) |
the task names C "manuell" |
| Leitplanke · Pflicht-Ausnahme · Klasse · sensible Klasse | guardrail · mandatory exception · class · sensitive class | |
Pflicht-Ausnahmen zahlung · geheimnis · widerspruch · extern-sensibel · injektion · Teilbaum über teilbaum_max_knoten |
payment · secret · contradiction · external-sensitive · injection · large-subtree |
new: unchecked-quote, uncertain (D76, D79, D86) |
| Regelwerk (Version der Muster) | ruleset (r1, RULESET, RULESET_SHA256) |
|
klassifiziere() · uebernimm() · nimmZurueck() |
classify() · adopt() · retract() |
plus intake(), resolve() |
src/entscheidung/automatik/** · src/entscheidung/person/** |
src/decision/policy/** · src/decision/decide.ts |
|
Tabelle klassifizierung (kennung, fassung, regelwerk, klassen, pflicht, detektor, modell, modus, ergebnis, zeit) |
classification (rule_id, version, ruleset, classes, exceptions, detector, model, mode, outcome, classified_at) |
new: patterns, sender, sender_basis, reasons, basis |
ergebnis automatisch · freigabe |
outcome auto · review |
|
entscheidung.herkunft person · automatisch |
decision.origin grant · auto |
D84 |
wer = automatik@<regelwerk> |
decided_by = policy@<ruleset> |
|
Entscheidung zuruecknehmen · Rücknahme |
decision retract · retraction |
|
uebernahme (Antwort) automatisch · freigabe · uebernahme.art (Bündel) |
adoption auto · review · adoption.kind auto · person |
|
gueltig · kennzeichnung · gruende |
valid · marking · reasons |
|
| „automatisch übernommen am …, Quelle …" | "auto-adopted on <YYYY-MM-DD>, source <source id>" | |
Gründe zahlung · widerspruch · extern-sensibel · pruefung · tagesgrenze · modus |
payment · contradiction · external-sensitive · review · daily-limit · mode |
D88 |
| Tagesgrenze · Kurzüberblick · Ausnahme-Seite · Schwärzungsvorschau | daily limit · digest · exceptions page · redaction preview (not built, D78) | |
Absender intern · extern · interne_absender |
sender internal · external · internal_senders |
|
Konfiguration freigabe (modus, bereiche, klassen automatisch·freigabe, max_automatisch_je_tag, betrag_schwelle_eur, teilbaum_max_knoten, interne_absender, klassifizierer_modell, kurzueberblick {uhrzeit, ausgang}) |
approval (mode, scopes, classes auto·review, max_auto_per_day, amount_threshold_eur, subtree_max_nodes, internal_senders, model_classifier, digest {time, output}) |
new: authserv_ids (D73) |
POST /v1/regeln/:kennung/zuruecknehmen |
POST /v1/rules/:id/retract |
|
GET /freigabe/ausnahmen?bereich= · GET /freigabe/automatisch?bereich=&seit= |
GET /approval/exceptions?scope= · GET /approval/auto?scope=&since= |
|
MCP regel_zuruecknehmen (kennung, grund) |
MCP rule_retract (ref with @n, reason) |
CLI groundnote rule retract |
409 nicht-automatisch · 422 geheimnis-erkannt |
409 not-auto-adopted · 422 secret-detected |