132 lines
6.4 KiB
Markdown
132 lines
6.4 KiB
Markdown
# 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.
|