# 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.