Governator
Modus

Hilfe

Stand der Spezifikation 563fe4a
glossar

Glossar

Glossar

Verbindlich in Code, Datenbank, API, MCP, UI und Dokumentation. Deutsche Begriffe sind führend. Das englische Mapping ist fest und wird überall unverändert verwendet. Abweichende Synonyme sind nicht zulässig; insbesondere heisst eine Vorgabe nie «Anforderung».

Grundsätze

  1. Deutsch führend. Dokumentation, Gespräche, Konzepte, ADRs, Commit-Nachrichten und UI-Texte in der deutschen Sprachvariante verwenden ausschliesslich die deutschen Begriffe dieses Glossars.
  2. Englisch als festes Mapping. Die englische Sprachvariante der UI, der PDF-Export und die englischen Hilfetexte verwenden ausschliesslich die englischen Begriffe der Tabelle.
  3. Bezeichner. Fachliche Bezeichner in Code, Datenbank, MCP-Werkzeugen und URLs verwenden den deutschen Begriff in ASCII-Transliteration (ä→ae, ö→oe, ü→ue, ss). Rein technische Bezeichner (id, created_at, service, repository) sind englisch. Bestätigt am 2026-09-07 (F1).
  4. Schweizer Rechtschreibung. Kein «ß», stets «ss».
  5. Zitierformen. Dokument: MAR-012 v2.1. Vorgabe: MAR-012-01-03 v2.1 (ohne Kennung die Stammkennung MAR-012-VG-033 v2.1 mit «noch nicht zugeordnet»). Unterkapitel und Kapitelteil: MAR-012 2.1 v2.1, MAR-012 A1 v2.1. Maske: M5. Item: A17. Einheit: E3. Offene Frage: F12.

Fachbegriffe

Begriff (DE) English Bezeichner (Code / DB / MCP) Definition
Dokumenttyp Document Type Dokumenttyp / dokumenttyp / dokumenttyp_* Art eines Dokuments. Sein Kürzel bildet das erste Segment jeder Dokument- und Vorgabenkennung; er trägt den Zähler für Dokumentnummern.
Dokument Document Dokument / dokument / dokument_* Versioniertes Regelwerk, das Vorgaben gruppiert. Identität über die Kennung, Inhalt je Dokumentversion. Bezeichnet nie den PDF-Export und nie eine Importdatei.
Dokumentversion Document Version Dokumentversion / dokumentversion Ein Stand eines Dokuments mit Versionsnummer, Status und Snapshot der Vorgaben.
Vorgabe Directive Vorgabe / vorgabe / vorgabe_* Einzelne Regel innerhalb eines Dokuments. Nie «Anforderung».
Fachbereich Business Unit Fachbereich / fachbereich / fachbereich_* Organisationseinheit, die ein Dokument erstellt. Kürzel aus zwei bis acht Zeichen; geht nicht in die Kennung ein. Vorgaben erben ihn vom Dokument. Bezeichnet nicht den Geltungsbereich.
Themenbereich Topic Themenbereich / themenbereich / themenbereich_* Oberbegriff der Themenzuordnung, etwa Vertraulichkeit. Kürzel aus drei Grossbuchstaben; es präfigiert den Stichwortschlüssel. Trägt die Kennzeichen «mehrfach» und «pflicht».
Stichwort Keyword Stichwort / stichwort / stichwort_* Wert innerhalb eines Themenbereichs, etwa «intern». Vorgaben werden Stichworten mehrfach zugeordnet. Schlüssel einteilig als VER-INT; angezeigt stets als «Themenbereich: Stichwort». Basis für Abonnements.
Begriff Term Begriff / begriff / begriff_* Stammdatum des zentralen Glossars: Bezeichnung und Definition in beiden Sprachen, Kennung BEG-0001, Zustand aktiv oder veraltet. Dokumente übernehmen Begriffe in ihren Anhangsteil «Begriffe» als Kopie mit Verweis (E19, A67).
Glossar Glossary glossar Die Gesamtheit der Begriffe; gepflegt in M37 unter Stammdaten › Begriffe. Nicht zu verwechseln mit diesem Dokument docs/glossar.md.
Begriffseintrag Term entry begriffseintrag Ein Begriff im Anhangsteil «Begriffe» einer Dokumentversion: Kopie von Bezeichnung und Definition mit Verweis auf den Glossarbegriff und dessen Fassung (A68, F69).
Kapitel Chapter kapitel Einer der drei festen Teile eines Dokuments: 1 Einleitung und Kontext, 2 Vorgaben, A Anhang. Nicht bearbeitbar (ADR-0005, A45).
Unterkapitel Subchapter Unterkapitel / unterkapitel / unterkapitel_* Bewegliche Gliederungsebene im Kapitel «Vorgaben» mit Gliederungsnummer und Bezeichnung; trägt keinen eigenen Text (ADR-0005, A46). Nicht «Section», das ist der Bereich.
Kapitelteil Chapter Part Kapitelteil / kapitelteil / kapitelteil_* Nummerierter Teil von Kapitel 1 (1.1, 1.2 …) oder des Anhangs (A1, A2 …) mit Bezeichnung und zweisprachigem Rich-Text; ein Objekt für beide Kapitel, Typmarker KT (ADR-0005 Nachtrag, A50, A58).
Anhangsteil Appendix Part anhangsteil Kapitelteil im Kapitel «Anhang», Gliederungsnummer A1 bis An (ADR-0005, A50). Nie «Absatz», das ist ein Knotentyp im Rich-Text.
Gliederungsnummer Outline Number gliederungsnummer Die aus der Position berechnete Nummer eines Unterkapitels oder Kapitelteils, etwa 2.1, 1.3 oder A1; beim Einreichen festgeschrieben (ADR-0005, A48).
Stammkennung Root Identifier stammkennung Unveränderliche Identität einer Vorgabe, eines Unterkapitels oder Kapitelteils aus dem Zähler des Dokuments: MAP-001-VG-047, MAP-001-UK-003, MAP-001-KT-002. Trägt alle Anker und den Permalink (ADR-0005, A49).
Kennung (Vorgabe) Identifier kennung Die aus Dokument, Unterkapitel und Position berechnete Anzeigekennung einer Vorgabe, MAP-001-01-03; ohne Unterkapitel keine Kennung. Zitierform MAP-001-01-03 v2.1 (ADR-0005).
Umsetzungshinweis Implementation Note umsetzungshinweis Zweisprachiges Rich-Text-Feld einer Vorgabe, freiwillig; sobald gefüllt, übersetzungs- und bestätigungspflichtig und im Review kommentierbar; leer nicht im PDF (A51, F50).
Skill-Hinweis Skill Note skill_hinweis Einsprachiges, im Lesefluss eingeklapptes Feld einer Vorgabe für den Teil-Skill; vom Einfrieren ab Review ausgenommen, eigene Fassungskette (A52, F51).
Rich-Text-Tabelle Rich-text Table richtext_tabelle Tabelle als Inhalt eines Rich-Text-Feldes mit semantisch ausgezeichneter Kopfzeile und Zellverbund (A53).
Textstil Text Style textstil Auswahl in der Werkzeugleiste des Rich-Text-Editors: Überschrift 1 bis 3, Absatz, Klein; die Schriftgrösse folgt dem Stil (A66).
Dokument-Skill Document Skill dokument_skill Technisches Erzeugnis einer Dokumentversion für Agenten, einsprachig englisch, ausserhalb der Sprachvarianten (A55).
Skill-Kopf Skill Header skill_kopf Aus der Dokumentbeschreibung erzeugter Kopf des Dokument-Skills (A55).
Teil-Skill Partial Skill teil_skill Je Vorgabe erzeugter Teil des Dokument-Skills (A55).
Gesamt-Skill Complete Skill gesamt_skill Skill-Kopf und alle Teil-Skills in Gliederungsreihenfolge; Gegenstand der technischen Freigabe (A56).
Technisches Gremium Technical Board TECHNISCHES_GREMIUM Rolle, die den Gesamt-Skill prüft und freigibt (A56, M34).
Tätigkeit Activity Taetigkeit / taetigkeit Konfigurierbare AI-Tätigkeit des Gateways (Übersetzen, Einbettung, Textprüfung, …); ersetzt die Doppelbelegung von «Aufgabe» (A54, M35).
Anweisung Instruction anweisung Bearbeitbarer, geordneter Textbaustein einer Tätigkeit; mehrere Anweisungen ergeben mit dem Rahmen im Code die Systemanweisung (A54).
Agentenbereich Agent Panel agentenbereich Layoutelement am unteren Rand jeder Maske, ein- und ausblendbar und in der Höhe verstellbar, in dem der Agent hilft; jede Antwort ist ein Vorschlag (A60, F65).
Dokumentvorlage Document Template Dokumentvorlage / dokumentvorlage Je Dokumenttyp die Vorlage mit Kapitelteilen für Kapitel 1 und Unterkapiteln für Kapitel 2, mit Fassungskette; beim Anlegen als Datenkopie übernommen (A59, F64).
Maturitätsstufe Maturity Level Maturitaetsstufe / maturitaetsstufe / maturitaetsstufe_* Konfigurierbare Einstufung einer Vorgabe. Vorbelegung A, B, C.
Sprachvariante Language Variant Sprachvariante / sprachvariante Deutsche oder englische Ausprägung eines Textinhalts mit Übersetzungszustand, Herkunft und Zeitpunkt.
Arbeitssprache Working Language arbeitssprache Sprache, in der ein Inhalt verfasst wird. Führend und verbindlich.
Übersetzungszustand Translation State uebersetzungszustand Zustand einer Sprachvariante: Quelltext, übersetzt-ungeprüft, übersetzt-bestätigt, veraltet.
Herkunft Origin herkunft Wer eine Sprachvariante verfasst hat: Mensch oder Agent.
Review-Runde Review Round ReviewRunde / review_runde / review_* Ein abgeschlossener Durchlauf des Reviews zu einer Dokumentversion.
Kommentar Comment Kommentar / kommentar / kommentar_* Anmerkung einer beteiligten Identität zu einem konkreten Attribut einer Dokumentversion oder einer ihrer Vorgaben in einer Review-Runde. Kommentieren dürfen die zugewiesenen Reviewer und die Autoren der Version, damit eine Rückfrage im Faden beantwortet werden kann.
Reviewer-Empfehlung Reviewer Recommendation Empfehlung / empfehlung / empfehlung_* Empfehlung eines Reviewers je Review-Runde mit Begründung.
Review-Zusammenfassung Review Summary ReviewZusammenfassung / review_zusammenfassung Vom Agenten erzeugte Zusammenfassung der Kommentare je Attribut plus Gesamtzusammenfassung; stets ein Vorschlag.
Vorschlag Suggestion Vorschlag / vorschlag / vorschlag_* Von einem Agenten erzeugter Änderungsvorschlag, einzeln annehmbar oder verwerfbar. Nie automatisch übernommen.
Bild Image Bild / bild / bild_* Datei im Objektspeicher (PNG, JPEG, SVG) mit Alternativtext und Bezug auf ein Rich-Text-Feld.
Alternativtext Alternative Text alternativtext Zweisprachiger Pflichttext eines Bildes. Inhalt wie jedes andere zweisprachige Feld.
Audit-Eintrag Audit Entry AuditEintrag / audit_eintrag / audit_* Protokollierte Änderung mit Zeitpunkt, Identität, Kanal, Akteurstyp, Objekt, Feld, altem und neuem Wert.
Identität Identity Identitaet / identitaet / identitaet_* Eine Person oder ein Agent mit Rollen. Träger von Rechten, API-Keys, Aufgaben und Abonnements.
Akteurstyp Actor Type akteurstyp Person oder Agent. Jede Aktion trägt den Akteurstyp.
Kanal Channel kanal UI, MCP oder System (Hintergrundjobs und automatische Übergänge). Jede Aktion trägt den Kanal.
Rolle Role Rolle / rolle / rolle_* Nutzer, Verantwortlicher Autor, Mitwirkender Autor, Reviewer, Freigeber, Administrator.
Aufgabe Task Aufgabe / – / aufgaben_* Abgeleiteter Eintrag der Aufgabenliste: worauf eine Identität wartet oder wo sie am Zug ist.
Aufgabenliste Task List aufgaben_liste Maske und MCP-Werkzeug je Identität.
Abonnement Subscription Abonnement / abonnement / abonnement_* Bestellung von Benachrichtigungen zu einem Stichwort oder zu Suchbegriffen.
Benachrichtigung Notification Benachrichtigung / benachrichtigung / benachrichtigung_* Ereignismeldung aus einem Abonnement, zugestellt per Webhook und abholbar über MCP.
Suchbegriff Search Term suchbegriff Freitextbegriff eines Abonnements. Bisher «Stichwort»; das Wort bezeichnet jetzt die zweite Themenstufe.
Import-Lauf Import Run ImportLauf / import_lauf / import_* Ein Durchlauf des Imports aus Word oder Excel mit Vorschau, Mapping, Protokoll und Ergebnis.
Sprachpflege Translation Maintenance sprachpflege Ansicht und Werkzeuge zur Prüfung und Bestätigung von Übersetzungen.
Versionsvergleich Version Comparison dokument_vergleichen Gegenüberstellung zweier Dokumentversionen mit hervorgehobenen Änderungen.
Beziehungen Relations beziehungen Interner Graph über Dokument, Vorgabe und Stichwort.
AI-Gateway AI Gateway AiGateway / ai_* Zentrale Stelle für alle Aufrufe von Sprachmodellen und Einbettungen mit Providern, Schlüsseln, Kostendeckel und Protokoll.
Provider Provider Provider / ai_provider Verwalteter Anbieter im AI-Gateway.
Kostendeckel Cost Cap kostendeckel Obergrenze der Kosten im AI-Gateway je Zeitraum.
Einbettung Embedding einbettung Vektor eines Textes für die Ähnlichkeitssuche.
Objektspeicher Object Storage objektspeicher Schnittstelle für die dauerhafte Ablage von Bildern, Importdateien und PDF-Zwischenständen ausserhalb des Laufzeit-Dateisystems; Implementierung in Render Postgres (bytea), F25.
Webhook Webhook webhook Signierter HTTPS-Aufruf zur Zustellung einer Benachrichtigung.
API-Key API Key ApiKey / api_key / api_key_* An eine Identität gebundener Schlüssel für den MCP-Kanal mit Scopes, Ablauf, Rotation, Widerruf und Rate Limit.
Scope Scope scope Einschränkung eines API-Keys auf eine Teilmenge der Rechte seiner Identität.
Workflow-Konfiguration Workflow Configuration workflow_konfiguration Konfigurierbare Parameter des Statusmodells: Schritte, Rollen, Fristen, Anzahl Reviewer.
Vier-Augen-Prinzip Four-Eyes Principle Der Verantwortliche Autor kann das eigene Dokument nicht freigeben.
Hilfe Help hilfe_* Kontextsensitive Hilfe, generiert aus den Spezifikationsdateien im Repository.
Einheit E Unit E0…En Umsetzungseinheit im Backlog.
Item A Item A1…An Produktanforderung an die Software, genau einer Einheit zugewiesen.
Maske M Screen M1…Mn Adressierbare Seite der Anwendung mit eigenem Hilfe-Kontext (siehe docs/wording.md).
Offene Frage F Open Question F1…Fn Eintrag in docs/offene-fragen.md.

Attribute

Begriff (DE) English Bezeichner
Kennung Identifier kennung
Kürzel Code kuerzel
Nummer Number nummer
Version Version version
Bezeichnung Name bezeichnung
Beschreibung Description beschreibung
Reihenfolge Order reihenfolge
aktiv active aktiv
Umsetzungsfrist Implementation Deadline umsetzungsfrist
Geltungsbeginn Effective Date geltungsbeginn
Verantwortlicher Autor Responsible Author verantwortlicher_autor
Mitwirkende Autoren Contributing Authors mitwirkende_autoren
Vorgänger Predecessor vorgaenger
Nachfolger Successor nachfolger
Wirksamwerden Taking Effect wirksamwerden
Zähler Counter zaehler
Zeitpunkt Timestamp zeitpunkt
Verfasser Author (of a comment) verfasser
Begründung Rationale begruendung
Zustand (Kommentar) State zustand

Statuswerte einer Dokumentversion

DE English Bezeichner
Entwurf Draft ENTWURF
Review In Review REVIEW
Abgenommen Approved ABGENOMMEN
Gültig Effective GUELTIG
Obsolet Obsolete OBSOLET
Zurückgezogen Withdrawn ZURUECKGEZOGEN

Übergänge (Aktionen): Einreichen (Entwurf → Review), Zurückweisen (Review → Entwurf), Freigeben (Review → Abgenommen), Inkraftsetzen (Abgenommen → Gültig, automatisch am Geltungsbeginn), Ablösen (Gültig → Obsolet, durch Nachfolger oder Folgeversion), Zurückziehen (jeder Status vor Gültig → Zurückgezogen), Löschen (nur Entwurf, kein Status, Tombstone).

Übersetzungszustände

DE English Bezeichner Kurzform (Abzeichen)
Quelltext Source QUELLE Quelle / Source
übersetzt, ungeprüft Translated, unverified UNGEPRUEFT Ungeprüft / Unverified
übersetzt, bestätigt Translated, confirmed BESTAETIGT Bestätigt / Confirmed
veraltet Outdated VERALTET Veraltet / Outdated

Rollen

DE English Bezeichner
Nutzer User NUTZER
Verantwortlicher Autor Responsible Author VERANTWORTLICHER_AUTOR
Mitwirkender Autor Contributing Author MITWIRKENDER_AUTOR
Reviewer Reviewer REVIEWER
Freigeber Approver FREIGEBER
Administrator Administrator ADMINISTRATOR

Reviewer-Empfehlungen

DE English Bezeichner
Freigabe Approve FREIGABE
Freigabe mit Auflagen Approve with Conditions FREIGABE_MIT_AUFLAGEN
Überarbeitung nötig Revision Required UEBERARBEITUNG
Ablehnung Reject ABLEHNUNG

Akteurstyp, Kanal, Herkunft

DE English Bezeichner
Person Person PERSON
Agent Agent AGENT
UI UI UI
MCP MCP MCP
System (Kanal) System SYSTEM
Mensch (Herkunft) Human MENSCH

Ausgeschlossene Begriffe

Nicht verwenden Stattdessen
Anforderung (für eine Regel) Vorgabe
Requirement (für eine Regel) Directive
Policy Rule, Regel (als Objektname) Vorgabe
Kategorie, Tag (als Objektname) Themenbereich, Stichwort
Themenfeld (als Objektname) Themenbereich, Stichwort
Stichwort (für einen Abonnementbegriff) Suchbegriff
Richtlinie (als Objektname) Dokument
Policy (als Objektname) Document
Fachdomäne (als Objektname) Dokumenttyp
Domain (als Objektname) Document Type
Reifegrad, Level Maturitätsstufe
Organisationseinheit, Abteilung (als Objektname) Fachbereich
Genehmigen, Approve (für Freigeben) Freigeben
Publizieren, Veröffentlichen Inkraftsetzen
Mandant, Tenant – (nicht mandantenfähig)
Screen, Page, Seite (für Maske) Maske
Thema, Themenkapitel (für ein Unterkapitel) Themenbereich und Stichwort sind seit ADR-0004 die Themenzuordnung
Absatz (für einen Anhangsteil) Absatz ist ein Knotentyp im Rich-Text-Schema
Aufgabe (für eine AI-Tätigkeit) Aufgabe ist der Eintrag der Aufgabenliste
Chat (für den Agentenbereich) kein Fachbegriff
Vorlage (für die Dokumentvorlage) Vorlage ist mehrfach belegt (Systemanweisung, Typst)

«Richtlinie» bleibt zulässig, wo es Teil der Bezeichnung eines Dokumenttyps ist, etwa «Mehr Security Richtlinie» und «Mehr Architektur Richtlinie». Ausgeschlossen ist allein der Gebrauch als Name des verwalteten Objekts; dieser Oberbegriff heisst «Dokument» (ADR-0004).