Update Systemprompt und Architekturhinweis

2026-06-21 15:56:01 +02:00 · 2026-06-21 15:56:01 +02:00 · 1f12fb5625
commit 1f12fb5625
parent 07050fa5a6
3 changed files with 525 additions and 0 deletions
--- a/#00_meta/README_architektur.md
+++ b/#00_meta/README_architektur.md
@ -0,0 +1,132 @@
+# DIGITOM Repository – Architektur-Überblick
+
+## Zweck dieses Dokuments
+Dieses README erklärt die Struktur dieses Repositories und dient als Orientierung für die Navigation und Interpretation des Modells.
+
+## Was dieses Repository ist
+
+Dieses Repository ist die **öffentliche, unter Creative Commons veröffentlichte Konzeptsammlung** des **DIGIT Operating Models (DIGITOM)** – des Organisationsmodells des Amts für Digitales und IT der Stadt Freiburg. Das Modell strukturiert die Abläufe auf Basis von **ITIL 4**.
+
+Es enthält ausschließlich die **strukturierten Konzept-Dateien** (YAML) der fünf Kernfunktionen. Es ist ein **kuratierter Auszug** aus einem internen Arbeitsrepository und wird daraus gepflegt – dieses Repository wird **nicht direkt bearbeitet**.
+
+### Repository-Philosophie
+
+Das Modell folgt einem **Bottom-Up-Entwicklungsansatz**: Governance-Strukturen emergieren aus operativen Konzepten, nicht umgekehrt. Die Konzepte sind als maschinen- und menschenlesbare YAML-Dateien abgelegt, damit Struktur, Rollen, Schnittstellen und Entscheidungsregeln eindeutig und versionierbar bleiben.
+
+### Konzepttypen (Taxonomie)
+
+Das Modell unterscheidet mehrere Konzepttypen (vollständig definiert in [digitom_taxonomie.yaml](digitom_taxonomie.yaml)):
+
+| Typ | Charakter | Beispiel |
+|-----|-----------|----------|
+| **Funktion** | Organisationseinheit mit Mandat und Schnittstellen | DPM, SPM, SHM |
+| **Practice** | Inhaltliche Verantwortung innerhalb einer Funktion | Service Level Management, Incident Management |
+| **Rolle** | Aufgaben-/Verantwortungsbereich einer Person | Service Owner, Demand-Portfolio-Manager*in |
+| **Gremium** | Entscheidungsinstanz mit Geschäftsordnung | Vision Board, Mission Board, DSR |
+| **Wertschöpfungsprozess** | End-to-End-Ablauf über mehrere Funktionen | Demand-Lifecycle, Service-Lifecycle |
+
+### Dokumenttypen
+
+| Suffix/Präfix | Bedeutung |
+|---------------|-----------|
+| `README_*.md` | Kontext und Navigation für ein Modul |
+| `*_glossar.yaml` | Begriffsdefinitionen |
+| `*_funktionsbeschreibung.yaml` | Mandat, Zweck und Schnittstellen einer Funktion |
+| `*_governance*.yaml` / `*_raci.yaml` | Verantwortlichkeiten, RACI, Entscheidungsregeln |
+| `*_schema_*.yaml` | Strukturdefinitionen für Artefakte |
+| `*_practice_*.yaml` | Practice-Beschreibungen |
+| `*-lifecycle-blueprint*` | Prozessabläufe über Phasen und Quality Gates |
+
+---
+
+## Ordnerstruktur
+```
+digitom_cc/
+├── #00_meta/                               # Übergreifende Dokumente
+│   ├── digitom_taxonomie.yaml              # Konzepttypen-Definition
+│   └── README_architektur.md               # (dieses Dokument)
+│
+├── #01_demand-portfolio-management/        # Funktion: DPM
+│   ├── #01.1_demand-portfolio-management_documentation/   # Konzept-Dokumentation
+│   └── #01.2_demand-lifecycle-blueprint/   # Lifecycle-Prozess
+│
+├── #02_service-portfolio-management/       # Funktion: SPM
+│   ├── service-portfolio-management_glossar.yaml          # SPM-Begriffe (primäre Begriffsreferenz)
+│   └── 02.1_spm_konzepte/
+│       ├── 01_spm_governance/              # Governance-Dokumente
+│       ├── 02_spm_service-lifecycle-blueprint/    # Lifecycle-Prozess
+│       ├── 02a_lifecycle-konzepte/         # Ergänzende Lifecycle-Konzepte
+│       ├── 03_spm_practices/               # Practice-Definitionen
+│       ├── 04_rollen/                      # Rollenbeschreibungen
+│       ├── 06_Informationsmodell/          # Schemas für Artefakte
+│       └── 07_spm_arbeitsmaterialien/      # Templates, Leitfäden
+│
+├── #03_stakeholder-management/             # Funktion: SHM
+│   ├── #03.1_funktion/
+│   ├── #03.2_governance/
+│   ├── #03.3_konzepte/
+│   ├── #03.4_methodik/
+│   ├── #03.5_schnittstellen/
+│   ├── #03.6_informationsmodell/
+│   └── #03.7_arbeitsmaterialien/
+│
+├── #04_mission-board/                      # Gremium: Mission Board (Geschäftsordnung)
+│
+├── #05_prozessmanagement/                  # Funktion: Prozessmanagement
+│   ├── #05.1_funktion/
+│   ├── #05.2_governance/
+│   ├── #05.3_konzepte/
+│   ├── #05.4_rollen/
+│   └── docs/
+│
+└── README.md
+```
+
+---
+
+## Navigationslogik
+
+### Einstieg nach Funktion
+- **DPM-Themen** (Demand-Portfolio-Management): `#01_demand-portfolio-management/`
+- **SPM-Themen** (Service-Portfolio-Management): `#02_service-portfolio-management/`
+- **SHM-Themen** (Stakeholder-Management): `#03_stakeholder-management/`
+- **Mission Board** (Gremium): `#04_mission-board/`
+- **Prozessmanagement**: `#05_prozessmanagement/`
+
+### Einstieg nach Informationstyp
+- **Begriffsdefinitionen**: `*_glossar.yaml` (primär: `service-portfolio-management_glossar.yaml`)
+- **Rollen und Verantwortlichkeiten**: `*/governance/`, `*/rollen/` oder `*_raci.yaml`
+- **Prozessabläufe**: `*-lifecycle-blueprint/`
+- **Artefakt-Strukturen**: `*/Informationsmodell/` oder `*_schema_*.yaml`
+
+### Status-Konvention
+Jedes YAML enthält im `meta`/`metadata`-Block einen `status`:
+- `draft` – in Entwicklung
+- `review` – zur Abstimmung
+- `abgenommen_in_gesamtkonzept` / `final` – abgestimmt und gültig
+
+Konzepte mit nicht-finalem Status sind als solche zu kennzeichnen, wenn daraus zitiert wird.
+
+---
+
+## Querverweise und Kohärenz
+
+### Glossar als Begriffsbasis
+Das SPM-Glossar (`service-portfolio-management_glossar.yaml`) ist die primäre Begriffsreferenz für alle Funktionen. Abweichende oder ergänzende Begriffe werden in funktionsspezifischen Glossaren dokumentiert. Begriffe werden **nicht gleichgesetzt** – z. B. ist „Bedarf" nicht dasselbe wie „Demand".
+
+### Schnittstellen zwischen Funktionen
+Die wichtigsten Übergabepunkte:
+- **SHM → DPM**: Qualifizierte Bedarfe aus der Stakeholder-Interaktion
+- **DPM → SPM/PPM**: Übergabe freigegebener Demands an Service- bzw. Projektentwicklung
+- **SPM → SHM**: Service-Informationen für die Stakeholder-Kommunikation
+
+---
+
+## Hinweis zur Pflege
+
+Dieses Repository ist ein **Einweg-Spiegel** des internen Arbeitsmodells: Änderungen entstehen im internen Repository und werden hierher übertragen. Direkte Änderungen in diesem Repository fließen **nicht** zurück und sollten daher unterbleiben.
+
+---
+
+## Lizenz
+Die Inhalte dieses Repositories stehen unter einer **Creative-Commons-Lizenz** (siehe Repository-Lizenzangabe). Sie dürfen unter den dort genannten Bedingungen nachgenutzt werden.