Terminology and Language Policy

Verbindliche Sprachregel fuer die IIO-Dokumentation: Informatik- und IT-Fachsprache zuerst, IIO-Wording als klares Mapping. Business- und Team-Sprache wird ueber Uebersetzung und Sprachstile angebunden.

Legende
GO Vollstaendige Freigabe — Operation darf ausgefuehrt werden.
BLOCK Stoppsignal — keine Fortsetzung ohne Korrektur/Klärung.
ESCALATE Menschliche Entscheidung (HITL) erforderlich.

0. Top-20 Begriffe fuer den schnellen Einstieg

Begriff1-Satz-Erklaerung
ActorIdentifizierbare Einheit, die im System handelt (Mensch oder Agent).
RoleKontext, der festlegt, welche Aufgaben ein Actor ausfuehren darf.
SkillNachgewiesene Faehigkeit, die fuer bestimmte Rollen/Operationen gebraucht wird.
EvidencePruefbarer Nachweis fuer die Gueltigkeit eines Skills oder einer Entscheidung.
ProficiencyReifegrad eines Skills (novice, practitioner, expert).
StoryZweck- und Wirkungspfad einer Aenderung im Betrieb.
TransactionAppend-only Zustandswechsel mit nachvollziehbaren Metadaten.
Audit TrailLueckenlose Nachweiskette aller relevanten Aktionen und Freigaben.
Gate CascadeFeste Reihenfolge von Pruefungen vor einer GO-Entscheidung.
GO/BLOCK/ESCALATEStandardisierte Entscheidungsresultate im IIO-Betrieb.
Fail-ClosedBei Unsicherheit oder fehlendem Input wird sicherheitshalber blockiert.
HITLMenschliche Freigabe fuer risikoreiche oder unklare Entscheidungen.
SeedReferenzmodell mit Regeln und Struktur fuer neue Ableitungen.
Node (tenant)Konkrete Betriebsinstanz fuer Kunde/Organisation im Alltag.
ProjectionKontrollierte Ableitung eines Nodes aus dem Seed.
CompositionKoordinierter Verbund mehrerer Actors mit gemeinsamer Story.
BoundaryDefinierte Grenze fuer Zugriff, Sichtbarkeit und Verantwortung.
DispatchZuordnung einer Operation zu passendem Actor, Role und Skill.
GuardrailOperative Leitplanke zur Vermeidung von Fehlverhalten unter Last.
TraceabilityRueckverfolgbarkeit von Entscheidung bis Artefakt und Quelle.

Operator-Hinweis

  1. Diese Top-20 zuerst lesen, dann in die Cluster und A-Z-Ansicht springen.
  2. Bei Governance-Fragen immer die Begriffe Actor, Role, Skill, Evidence gemeinsam betrachten.
  3. Bei Incident/Review zuerst Transaction, Audit Trail, Gate Cascade und Fail-Closed pruefen.

0.1 Visuelle Begriffslandkarte

Mindmap: IIO Begriffswelt auf einen Blick

mindmap
  root((IIO Begriffswelt))
    Governance
      Actor
      Role
      Skill
      Evidence
      Gate Cascade
      GO/BLOCK/ESCALATE
      HITL
    Operations
      Transaction
      Audit Trail
      Dispatch
      Operator Runbook
      Rollback
      Drift
    Architektur
      Seed
      Node (tenant)
      Projection
      Composition
      Boundary
      Federation
      Runtime Contract
    Publishing
      Language Channel
      Canonical Source
      Traceability

Flow: Von Begriff zu operativer Entscheidung

flowchart LR
  A[Actor + Role] --> B[Skill + Proficiency]
  B --> C[Evidence Class]
  C --> D[Gate Cascade]
  D --> E{Decision}
  E -->|GO| F[Transaction Write]
  E -->|BLOCK| G[Fail-Closed Stop]
  E -->|ESCALATE| H[HITL Review]
  F --> I[Audit Trail + Traceability]
  H --> I

Interpretation

  1. Ein Begriff ist nie isoliert, sondern Teil eines Entscheidungsflusses.
  2. Governance-Begriffe bestimmen, wer handeln darf; Operations-Begriffe beweisen, was passiert ist.
  3. Architektur- und Publishing-Begriffe sichern Skalierung und konsistente Kommunikation.

0.2 Entscheidungs-Checkkarte (1-Screen, druckbar)

Nutzung: Diese Karte vor jeder riskanten Aenderung einmal vollstaendig durchlaufen.

CheckFrageWenn "Nein"
ActorIst ein eindeutiger Actor fuer die Operation gesetzt?BLOCK
RoleHat der Actor die erforderliche Rolle?BLOCK
SkillIst der benoetigte Skill vorhanden und passend?BLOCK
EvidenceReicht die Evidence-Klasse fuer das Risiko?ESCALATE oder BLOCK
GateWurden alle relevanten Gates geprueft?BLOCK
HITLIst HITL erforderlich und erfolgt?ESCALATE
TransactionIst die TX append-only und vollstaendig dokumentiert?BLOCK
AuditIst der Nachweispfad reproduzierbar (Traceability)?BLOCK

Decision-Mini-Flow

flowchart TD
  A[Actor gesetzt?] -->|Nein| B[BLOCK]
  A -->|Ja| C[Role + Skill passend?]
  C -->|Nein| B
  C -->|Ja| D[Evidence ausreichend?]
  D -->|Nein| E[ESCALATE/HITL]
  D -->|Ja| F[Gate + TX + Audit vollstaendig?]
  F -->|Nein| B
  F -->|Ja| G[GO]
GO: Freigabe BLOCK: Stop ESCALATE: HITL

Print-Kurzmodus

  1. Actor, Role, Skill, Evidence.
  2. Gate-Cascade und HITL.
  3. Transaction + Audit Trail.
  4. Ergebnis nur GO/BLOCK/ESCALATE.

1. Grundregel

Primaersprache: Standardisierte Informatik- und IT-Fachbegriffe. Sekundaersprache: IIO-Begriffe als Mapping in Klammern oder Glossarspalte. Stilvarianten: Management-, Team- und Kundensprache werden als Uebersetzungsschicht aus der Primaersprache abgeleitet.

IT/CS-Fachbegriff zuerst IIO-Mapping explizit Sprachstile als Uebersetzung Keine unklaren Insiderbegriffe

2. Kern-Glossar (Fachwort -> IIO)

FachwortIIO-WortPraktischer Einsatz
Referenztemplate / KernmodellSeedZentrale Regeln, Methoden, Governance-Rails
Mandant / KundeninstanzNode (tenant)Konkreter Client-Betrieb, lokale Teams und Prozesse
Ableitung / InitialisierungProjectionErzeugung einer neuen Node aus dem Seed
RollenpaketRole PackageBetriebliche Aufgaben- und Berechtigungsbündel
BetriebsnachweisEvidencePrüfbare Nachweise fuer Gates und Audits
ZustandswechselprotokollTransactionAppend-only Dokumentation von Zustandswechseln
FreigabeentscheidungGO/BLOCK/ESCALATEReview- und Release-Entscheidung

2.1 Anschlussfaehigkeit zu IT- und Uni-Standards

Damit externe IT-Teams und Informatik-Kontexte sofort anschlussfaehig sind, wird IIO-Wording auf gaengige Fachsprache abgebildet. Das ist kein Bruch, sondern ein kontrolliertes Mapping mit anschliessender Stil-Uebersetzung fuer unterschiedliche Zielgruppen.

IIO-BegriffGaengiger IT-/Uni-BegriffKontext
SeedReference Template / Baseline ArchitectureReferenzmodell, von dem Instanzen abgeleitet werden
Node (tenant)Tenant / Instance / Deployment UnitKonkrete mandantenbezogene Betriebsinstanz
ProjectionInstantiation / Provisioning from TemplateAbleitung einer Instanz aus der Baseline
TransactionChange Record / Audit Trail EntryNachvollziehbarer, append-only Zustandswechsel
EvidenceVerification Evidence / Trace ArtifactPruefbare Nachweise fuer Reviews und Audits
GO/BLOCK/ESCALATEDecision Gate / Approval OutcomeSteuerentscheidung im Change- und Release-Prozess
Terminologisch kompatibel Fachlich interoperabel Keine Begriffstrennung ohne Mapping

2.2 Verbindliche Begriffe fuer Intelego, Kunden und Kundenprojekte

Diese Matrix ist die kanonische Benennung fuer euren Betrieb. Sie soll als Source-of-Truth fuer DE/EN-Uebersetzungen dienen.

BetriebsfallKanonischer IT/CS-Begriff (DE)ENIIO-MappingNicht verwenden als Default
Intelego als konkrete ZielinfraTenant-Instanz IntelegoIntelego tenant instanceNode (tenant)Hub (nur wenn echte Hub-Funktion vorliegt)
Weitere Kunden neben IntelegoWeitere Tenant-InstanzenAdditional tenant instancesWeitere NodesSub-Node, Mini-Seed
Kunde als OrganisationKundenorganisation / MandantCustomer organization / tenantNode-KontextNode selbst als Firmenname ohne Klartext
Projekt bei einem KundenKundenprojektCustomer projectProjekt im Node-KontextEigener Seed, eigener Tenant (wenn es nur ein Projekt ist)
Aus Seed abgeleitete neue InstanzInstanziierung / AbleitungInstantiation / projectionProjectionSeeding als Hauptbegriff in formaler Doku
Gesamtheit mehrerer KundeninstanzenKundenportfolio von Tenant-InstanzenTenant instance portfolioNode-PortfolioEinzelner Hub (wenn nicht zentral orchestriert)
Intelego = Tenant-Instanz (Node) Weitere Kunden = weitere Nodes Kundenprojekt = Projekt im Node Hub nur bei echter Zentralfunktion

2.3 Ausfuehrliches IIO-Fachglossar (modern + praxisnah)

Cluster-Sprungmarken

A-Z Sprungmarken

Cluster: Governance

Actor, Role, Policy as Code, Premise, Gate Cascade, GO/BLOCK/ESCALATE, HITL, Audit Trail, Traceability

Cluster: Operations

Operator Runbook, Dispatch, Transaction, Revision, Rollback, Drift, Evidence Class, Proficiency

Cluster: Architektur

Seed, Node (tenant), Projection, Composition, Federation, Boundary, Semi-permeable Boundary, Root Placement, Layer Integration, Runtime Contract

Cluster: Language & Publishing

Language Channel, Canonical Source, Deterministic Processing

A-Z Index A-F

A-Z Index G-L

A-Z Index M-R

A-Z Index S-Z

BegriffKurzdefinitionWarum relevant im IIO-Betrieb
ActorHandlungsfaehige Einheit (Mensch oder Agent) mit eindeutiger ID.Ohne klaren Actor keine gueltige Transaktion und kein Audit-Anker.
RoleBerechtigter Aufgabenkontext eines Actors.Steuert, wer welche Operationen ausfuehren oder freigeben darf.
SkillNachweisbare Faehigkeit mit Evidence und Proficiency.Verhindert implizite Kompetenzannahmen bei kritischen Ops.
Skill RegistryKanonisches Verzeichnis aller Skills, Prerequisites und Konflikte.Basis fuer deterministischen Dispatch und Reliance-Entscheidungen.
Evidence ClassQualitaetsstufe eines Nachweises (mcp/workspace/model/attestation).Definiert HITL-Pflicht und Vertrauensniveau.
ProficiencyReifegrad eines Skills (novice/practitioner/expert).Regelt, ob ein Actor nur assistiert oder eigenstaendig handeln darf.
CompositionKoordinierter Verbund mehrerer Actors mit gemeinsamer Story.Wichtig fuer teamuebergreifende Ausfuehrung und Konfliktsteuerung.
BoundaryDefinierte Zugriffs- und Sichtgrenze einer Composition oder eines Layers.Schuetzt vor Scope-Leaks und unkontrollierter Kopplung.
Semi-permeable BoundarySelektiv oeffnende Grenze mit expliziter Freigabe.Erlaubt kontrollierte Zusammenarbeit ohne Vollzugriff.
FederationGeregelte Kopplung mehrerer Compositions/Nodes.Ermoeglicht Skalierung ueber Organisationseinheiten hinweg.
StoryNachvollziehbarer Zweckpfad einer Aenderung (Warum + Wirkung).Verhindert kontextlose Technik-Aenderungen ohne Betriebsbezug.
TransactionAppend-only Zustandswechsel mit Actor, Evidence und Zeitbezug.Kern fuer Revisionssicherheit und forensische Rekonstruktion.
Audit TrailLueckenlose Kette aller relevanten Entscheidungen und Aktionen.Noetig fuer Governance, Compliance und Incident-Aufarbeitung.
Gate CascadeFeste Reihenfolge von Pruef-Gates vor GO-Entscheidungen.Erzwingt systematische Qualitaet statt Ad-hoc-Freigaben.
Fail-ClosedBei fehlendem Input oder unklarer Lage wird BLOCK statt GO erzeugt.Reduziert Risiko stiller Fehler in kritischen Betriebswegen.
Deterministic ProcessingGleiches Input-Set erzeugt gleiches Ergebnis.Voraussetzung fuer reproduzierbare Automation und Audits.
HITL (Human in the Loop)Verbindliche menschliche Freigabe bei Risiko- oder Unsicherheitslagen.Sicherheitsnetz fuer Entscheidungen mit hoher Tragweite.
GO/BLOCK/ESCALATEStandardisierter Dreiklang der Entscheidungslogik.Macht Entscheidungen vergleichbar und operativ steuerbar.
SeedReferenzmodell mit Basisregeln, Guardrails und Struktur.Startpunkt fuer kontrollierte Ableitungen neuer Betriebsinstanzen.
Node (tenant)Konkrete Kunden- oder Bereichsinstanz im Betrieb.Ort der realen Ausfuehrung, Teams, Projekte und Daten.
ProjectionInstanziierung eines Nodes aus dem Seed.Standardisiert Rollout und minimiert Wildwuchs in Setups.
Root PlacementRegelwerk zur korrekten Ablage von Artefakten im Workspace.Verhindert Strukturdrift und inkonsistente Ownership.
GuardrailOperative Leitplanke mit klaren Verboten/Erlaubnissen.Stabilisiert Ausfuehrung auch unter Zeitdruck.
Policy as CodeFormale Regeln als versioniertes Artefakt.Pruefbar, reviewbar und automatisierbar statt implizit.
DriftAbweichung zwischen Soll-Kontrakt und Ist-Zustand.Fruehindikator fuer Sicherheits- und Qualitaetsverlust.
RollbackRueckkehr auf vorherigen, validierten Zustand.Sicherheitsmechanismus bei regressiven Aenderungen.
RevisionVersionierter, nachvollziehbarer Aenderungszustand.Bindeglied zwischen Ausfuehrung, Dokumentation und Audit.
Runtime ContractLaufzeitregeln fuer Inputs, Outputs und Verhaltenspflichten.Sichert stabile Schnittstellen zwischen Komponenten.
DispatchZuweisung einer Operation an Actor + Role + Skill.Zentral fuer planbare Ausfuehrung in Multi-Actor-Systemen.
Operator RunbookSchrittfolge fuer wiederkehrende Betriebsoperationen.Macht kritische Prozesse reproduzierbar und trainierbar.
Canonical SourceAutoritative Quelle fuer eine Regel oder Information.Verhindert konkurrierende Wahrheiten im System.
PremiseGrundannahme/Leitregel, auf der Entscheidungen beruhen.Definiert den Governance-Rahmen fuer alle Layer.
Layer IntegrationVerbindungslogik zwischen Architektur-, Skill-, TX- und Audit-Layern.Stellt sicher, dass lokale Entscheidungen global konsistent bleiben.
Language ChannelKanaele fuer AGT/DE/EN mit klarer Trennung.Verhindert Sprachmischung und Publikationsdrift.
TraceabilityRueckverfolgbarkeit von Entscheidung bis Artefakt.Entscheidend fuer Incident-Analyse und Compliance-Nachweis.

Operator-Merksatz fuer den Alltag

  1. Erst Actor/Role/Skill klaeren, dann ausfuehren.
  2. Ohne Evidence kein GO.
  3. Bei Unsicherheit immer fail-closed und HITL aktivieren.

3. Schreibmuster nach Zielgruppe

ZielgruppeEmpfohlenes MusterBeispiel
ManagementIT/CS-Begriff + einmaliges KlammermappingTenant-Instanz (Node) wird aus einem Referenztemplate (Seed) instanziiert.
FachabteilungUebersetzter Stil aus IT/CS-PraezisionsbegriffenKundeninstanz wird initialisiert; Details siehe Glossar.
Delivery und OpsIT/CS-Praezisionsstil mit IIO-Mapping bei BedarfZustandswechsel als Transaktion dokumentieren.
Architektur und GovernanceIT/CS-Sprache als Default, IIO als internes MappingReference Template (Seed) bleibt universell.

4. Do und Don't

DoDon't
Tenant-Instanz (Node) einmal definieren und danach konsistent nutzen.Zwischen Tenant, Node, Client ohne Mapping wechseln.
Fachtexte mit Glossar-Hinweis abschliessen.Nur interne IIO-Kurzformen verwenden.
In Schulungen IT/CS-Begriffe zuerst nutzen und teamgerecht uebersetzen.Abstrakte Begriffe ohne Kontext bringen.

5. Mini-Template fuer neue Dokumente

AbschnittPflichtinhalt
Begriffsrahmen3-6 zentrale Fachbegriffe mit IIO-Mapping
ProzessbeschreibungFachsprache in Schritten, IIO nur wenn notwendig
VerweisLink auf diese Terminologie-Policy und das Seed-Node-Modell

6. Verknuepfte Kapitel