# Microsoft Fabric API-for-GraphQL-Dokumentation

> **Hinweis:** Diese Dokumentation ist verpflichtend für alle Produktiv-GraphQL-APIs.
> Nicht relevante Kapitel können leer bleiben, dürfen jedoch nicht entfernt werden.
> Automatisch befüllte Felder stammen aus dem Microsoft Fabric Service; mit
> _„Manuell zu ergänzen"_ markierte Felder sind fachlich zu vervollständigen.

---

## 1. Metadaten

| Feld | Wert |
|-----|------|
| GraphQL-API-Name | {{GQ_Name}} |
| Beschreibung | {{GQ_Beschreibung}} |
| GraphQL-API-ID | {{GQ_ID}} |
| Web-URL | {{GQ_WebUrl}} |
| Anzahl Datenquellen | {{GQ_AnzahlDatenquellen}} |
| Erstellt / konfiguriert von | {{GQ_ConfiguredBy}} |
| Zuletzt geändert | {{GQ_ModifiedTime}} |
| Fachbereich | {{GQ_Fachbereich}} |
| Konzerndomäne | {{GQ_Konzerndomaene}} |
| Aktuelle Version | 1.0 |
| Status | Produktiv |
| Letzte Aktualisierung | {{GQ_ExportDatum}} |

---

## 2. Ansprechpartner & Verantwortlichkeiten

| Rolle | Name / Team | Kontakt |
|-----|-------------|--------|
| Fachlicher Owner | {{KONTAKT_BusinessOwner}} | {{KONTAKT_BusinessOwnerMail}} |
| Technischer Owner | {{KONTAKT_TechOwner}} | {{KONTAKT_TechOwnerMail}} |
| Data Steward | {{KONTAKT_DataSteward}} | {{KONTAKT_DataStewardMail}} |
| Betrieb / Support | {{KONTAKT_Betrieb}} | {{KONTAKT_BetriebMail}} |

---

## 3. Business-Ziel & fachlicher Kontext

### 3.1 Zielsetzung
{{GQ_Zielsetzung}}

### 3.2 Fachlicher Anwendungsfall
{{GQ_Anwendungsfall}}

### 3.3 Nachgelagerte Verbraucher (Anwendungen / Dienste)
{{GQ_Konsumenten}}

---

## 4. Aufbau & Struktur

### 4.1 Angebundene Datenquellen

{{GQ_DatenquellenTabelle}}

### 4.2 GraphQL-Schema

{{GQ_SchemaBlock}}

---

## 5. Datenquellen & Beladung

### 5.1 Datenquellen-Details

{{GQ_DatenquellenTabelle2}}

### 5.2 Detailbeschreibung je Datenquelle
{{GQ_DatenquellenDetail}}

---

## 6. Inhalt & Nutzung

{{GQ_ServiceHinweis}}

### 6.1 Nutzung der API
{{GQ_VerwendungHinweis}}

### 6.2 Parameter & Konfiguration
{{GQ_ParameterHinweis}}

### 6.3 Datenqualität

- Umgang mit Fehlern: {{GQ_NullHandling}}
- Datenvalidierungsregeln: {{GQ_Validierungsregeln}}
- Aufbewahrung / Historisierung: {{GQ_Aufbewahrung}}

### 6.4 Performance-Hinweise

- Query-Komplexität / Optimierung: {{GQ_Optimierung}}
- Bekannte Performance-Engpässe: {{GQ_PerformanceHinweise}}
- Weitere Maßnahmen: {{GQ_Optimierungen}}

---

## 7. Betrieb & Wartung

### 7.1 Betrieb & Orchestrierung

{{GQ_Beladung}}

### 7.2 Monitoring & Fehlerbehandlung
{{GQ_Monitoring}}

### 7.3 Bekannte Probleme / Technische Schulden
{{GQ_BekannteProbleme}}

---

## 8. Sicherheit & Berechtigungen

### 8.1 Zugriff & Freigaben
{{GQ_Zugriffe}}

### 8.2 Sensitivity Labels
{{GQ_Labels}}

### 8.3 Risiken & Einschränkungen
{{GQ_Risiken}}

---

## 9. Versionierung & Änderungsverlauf

### 9.1 Repository / Ablage
{{GQ_Repository}}

### 9.2 Änderungsprotokoll

| Version | Datum | Änderung | Typ (fachlich/technisch) | Autor |
|-------|-------|---------|--------------------------|-------|
| 1.0 | {{GQ_ExportDatum}} | Automatische Erst-Dokumentation | technisch | Auto-Dokumentation |

---

## 10. Freigabe & Review

| Rolle | Name | Datum | Kommentar |
|-----|------|-------|----------|
| Fachlich | {{REVIEW_FachName}} | {{REVIEW_FachDatum}} | {{REVIEW_FachKommentar}} |
| Technisch | {{REVIEW_TechName}} | {{REVIEW_TechDatum}} | {{REVIEW_TechKommentar}} |

---

## 11. Anhänge & Referenzen
- Übergeordnete Workspace-Dokumentation
- Architekturdiagramme
- Regulatorische Nachweise (separat)
