digitom_cc/#00_meta/README_architektur.md

6.4 KiB
Raw Blame History

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):

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.