fixing .junie

This commit is contained in:
stefan
2025-09-15 12:49:55 +02:00
parent c35cb1010b
commit f9d492c7e0
28 changed files with 2707 additions and 29 deletions
+20 -3
View File
@@ -1,7 +1,7 @@
# Meldestelle Project Guidelines
**Version:** 2.0.0
**Last Updated:** 2025-09-13
**Version:** 2.1.0
**Last Updated:** 2025-09-15
**Status:** Reorganized & AI-Optimized
---
@@ -105,13 +105,30 @@ Development process and workflow guidelines:
2. [Master-Guideline](./master-guideline.md) for project standards overview
3. Individual guidelines for specific team coordination
## 🤖 Automatisierung und Validierung
Das Guidelines-System verfügt über umfassende Automatisierungsfeatures:
### 🔗 Automatische Validierung
- **Link-Validierung:** `.junie/scripts/validate-links.sh` - Cross-Referenzen und YAML-Konsistenz
- **Template-System:** `.junie/scripts/create-guideline.sh` - Automatische Guideline-Erstellung
- **Pre-commit Hook:** `.junie/scripts/pre-commit-guidelines.sh` - Lokale Validierung vor Commits
- **CI/CD-Integration:** `.github/workflows/guidelines-validation.yml` - Automatische Pipeline-Validierung
### 📋 Verfügbare Templates
- **Project-Standards:** `project-standard-template.md`
- **Technology-Guides:** `technology-guideline-template.md`
- **Process-Guides:** `process-guide-template.md`
**Detaillierte Dokumentation:** [AUTOMATION-FEATURES.md](../AUTOMATION-FEATURES.md)
## 📝 Guideline Metadata Format
All guidelines follow this metadata structure for AI optimization:
```yaml
---
guideline_type: "project-standards" | "technology" | "process-guide"
guideline_type: "project-standards" # oder "technology" oder "process-guide"
scope: "specific-area-identifier"
audience: ["developers", "ai-assistants", "architects", "devops", "project-managers"]
last_updated: "YYYY-MM-DD"
+217
View File
@@ -0,0 +1,217 @@
{
"meta": {
"last_updated": "2025-09-15",
"description": "Cross-Referenz-Matrix für Meldestelle Guidelines",
"purpose": "Link-Validierung und Abhängigkeits-Management"
},
"cross_references": {
"master-guideline.md": {
"references_to": [
"project-standards/coding-standards.md",
"project-standards/architecture-principles.md",
"technology-guides/web-app-guideline.md",
"project-standards/testing-standards.md",
"technology-guides/docker/",
"project-standards/documentation-standards.md"
],
"referenced_by": [
"project-standards/architecture-principles.md",
"project-standards/coding-standards.md",
"project-standards/documentation-standards.md",
"project-standards/testing-standards.md",
"technology-guides/web-app-guideline.md",
"technology-guides/docker/docker-overview.md",
"process-guides/trace-bullet-guideline.md"
]
},
"README.md": {
"references_to": [
"master-guideline.md",
"project-standards/coding-standards.md",
"project-standards/testing-standards.md",
"project-standards/documentation-standards.md",
"project-standards/architecture-principles.md",
"technology-guides/web-app-guideline.md",
"technology-guides/docker/docker-overview.md",
"technology-guides/docker/docker-architecture.md",
"technology-guides/docker/docker-development.md",
"technology-guides/docker/docker-production.md",
"technology-guides/docker/docker-monitoring.md",
"technology-guides/docker/docker-troubleshooting.md",
"process-guides/trace-bullet-guideline.md"
],
"referenced_by": []
},
"project-standards/architecture-principles.md": {
"references_to": [
"master-guideline.md"
],
"referenced_by": [
"README.md",
"master-guideline.md",
"technology-guides/web-app-guideline.md"
]
},
"project-standards/coding-standards.md": {
"references_to": [
"master-guideline.md"
],
"referenced_by": [
"README.md",
"master-guideline.md"
]
},
"project-standards/documentation-standards.md": {
"references_to": [
"master-guideline.md"
],
"referenced_by": [
"README.md",
"master-guideline.md"
]
},
"project-standards/testing-standards.md": {
"references_to": [
"master-guideline.md"
],
"referenced_by": [
"README.md",
"master-guideline.md"
]
},
"technology-guides/web-app-guideline.md": {
"references_to": [
"master-guideline.md",
"project-standards/architecture-principles.md"
],
"referenced_by": [
"README.md",
"master-guideline.md",
"process-guides/trace-bullet-guideline.md"
]
},
"technology-guides/docker/docker-overview.md": {
"references_to": [
"master-guideline.md",
"technology-guides/docker/docker-architecture.md",
"technology-guides/docker/docker-development.md",
"technology-guides/docker/docker-production.md",
"technology-guides/docker/docker-monitoring.md",
"technology-guides/docker/docker-troubleshooting.md"
],
"referenced_by": [
"README.md",
"master-guideline.md",
"technology-guides/docker/docker-architecture.md",
"technology-guides/docker/docker-development.md",
"technology-guides/docker/docker-production.md",
"technology-guides/docker/docker-monitoring.md",
"technology-guides/docker/docker-troubleshooting.md"
]
},
"technology-guides/docker/docker-architecture.md": {
"references_to": [
"technology-guides/docker/docker-overview.md",
"master-guideline.md"
],
"referenced_by": [
"README.md",
"technology-guides/docker/docker-overview.md",
"technology-guides/docker/docker-development.md",
"technology-guides/docker/docker-production.md",
"technology-guides/docker/docker-monitoring.md",
"technology-guides/docker/docker-troubleshooting.md"
]
},
"technology-guides/docker/docker-development.md": {
"references_to": [
"technology-guides/docker/docker-overview.md",
"technology-guides/docker/docker-architecture.md",
"technology-guides/docker/docker-production.md",
"technology-guides/docker/docker-monitoring.md",
"technology-guides/docker/docker-troubleshooting.md"
],
"referenced_by": [
"README.md",
"technology-guides/docker/docker-overview.md",
"technology-guides/docker/docker-troubleshooting.md"
]
},
"technology-guides/docker/docker-production.md": {
"references_to": [
"technology-guides/docker/docker-overview.md",
"technology-guides/docker/docker-architecture.md"
],
"referenced_by": [
"README.md",
"technology-guides/docker/docker-overview.md",
"technology-guides/docker/docker-development.md"
]
},
"technology-guides/docker/docker-monitoring.md": {
"references_to": [
"technology-guides/docker/docker-overview.md",
"technology-guides/docker/docker-architecture.md"
],
"referenced_by": [
"README.md",
"technology-guides/docker/docker-overview.md",
"technology-guides/docker/docker-development.md"
]
},
"technology-guides/docker/docker-troubleshooting.md": {
"references_to": [
"technology-guides/docker/docker-overview.md",
"technology-guides/docker/docker-architecture.md",
"technology-guides/docker/docker-development.md"
],
"referenced_by": [
"README.md",
"technology-guides/docker/docker-overview.md",
"technology-guides/docker/docker-development.md"
]
},
"process-guides/trace-bullet-guideline.md": {
"references_to": [
"master-guideline.md",
"technology-guides/web-app-guideline.md"
],
"referenced_by": [
"README.md"
]
}
},
"link_validation": {
"last_check": "2025-09-15",
"broken_links": [],
"orphaned_guidelines": [],
"circular_dependencies": [],
"validation_status": "OK"
},
"navigation_paths": {
"common_workflows": {
"new_developer_onboarding": [
"README.md",
"master-guideline.md",
"project-standards/architecture-principles.md",
"project-standards/coding-standards.md",
"technology-guides/docker/docker-development.md"
],
"frontend_development": [
"technology-guides/web-app-guideline.md",
"project-standards/architecture-principles.md",
"project-standards/coding-standards.md"
],
"docker_setup": [
"technology-guides/docker/docker-overview.md",
"technology-guides/docker/docker-architecture.md",
"technology-guides/docker/docker-development.md"
],
"troubleshooting": [
"technology-guides/docker/docker-troubleshooting.md",
"technology-guides/docker/docker-development.md",
"technology-guides/docker/docker-monitoring.md"
]
}
}
}
+143
View File
@@ -0,0 +1,143 @@
{
"meta": {
"last_updated": "2025-09-15",
"version_schema": "1.0.0",
"description": "Zentrale Versionsverwaltung für alle Meldestelle Guidelines"
},
"guidelines": {
"master-guideline.md": {
"version": "2.1.0",
"status": "aktiv",
"last_updated": "2025-09-15",
"type": "master",
"scope": "project-overview",
"dependencies": []
},
"README.md": {
"version": "2.1.0",
"status": "aktiv",
"last_updated": "2025-09-15",
"type": "navigation",
"scope": "guidelines-overview",
"dependencies": []
},
"project-standards/architecture-principles.md": {
"version": "2.1.0",
"status": "aktiv",
"last_updated": "2025-09-15",
"type": "project-standards",
"scope": "architecture-principles",
"dependencies": ["master-guideline.md"]
},
"project-standards/coding-standards.md": {
"version": "2.1.0",
"status": "aktiv",
"last_updated": "2025-09-15",
"type": "project-standards",
"scope": "coding-standards",
"dependencies": ["master-guideline.md"]
},
"project-standards/documentation-standards.md": {
"version": "2.1.0",
"status": "aktiv",
"last_updated": "2025-09-15",
"type": "project-standards",
"scope": "documentation-standards",
"dependencies": ["master-guideline.md"]
},
"project-standards/testing-standards.md": {
"version": "2.1.0",
"status": "aktiv",
"last_updated": "2025-09-15",
"type": "project-standards",
"scope": "testing-standards",
"dependencies": ["master-guideline.md"]
},
"technology-guides/web-app-guideline.md": {
"version": "2.1.0",
"status": "aktiv",
"last_updated": "2025-09-15",
"type": "technology",
"scope": "web-app-multiplatform",
"dependencies": ["master-guideline.md", "architecture-principles.md"]
},
"technology-guides/docker/docker-overview.md": {
"version": "2.1.0",
"status": "aktiv",
"last_updated": "2025-09-15",
"type": "technology",
"scope": "docker-overview",
"dependencies": ["master-guideline.md"]
},
"technology-guides/docker/docker-architecture.md": {
"version": "2.1.0",
"status": "aktiv",
"last_updated": "2025-09-15",
"type": "technology",
"scope": "docker-architecture",
"dependencies": ["docker-overview.md", "master-guideline.md"]
},
"technology-guides/docker/docker-development.md": {
"version": "2.1.0",
"status": "aktiv",
"last_updated": "2025-09-15",
"type": "technology",
"scope": "docker-development",
"dependencies": ["docker-overview.md", "docker-architecture.md"]
},
"technology-guides/docker/docker-production.md": {
"version": "2.1.0",
"status": "aktiv",
"last_updated": "2025-09-15",
"type": "technology",
"scope": "docker-production",
"dependencies": ["docker-overview.md", "docker-architecture.md"]
},
"technology-guides/docker/docker-monitoring.md": {
"version": "2.1.0",
"status": "aktiv",
"last_updated": "2025-09-15",
"type": "technology",
"scope": "docker-monitoring",
"dependencies": ["docker-overview.md", "docker-architecture.md"]
},
"technology-guides/docker/docker-troubleshooting.md": {
"version": "2.1.0",
"status": "aktiv",
"last_updated": "2025-09-15",
"type": "technology",
"scope": "docker-troubleshooting",
"dependencies": ["docker-overview.md", "docker-architecture.md", "docker-development.md"]
},
"process-guides/trace-bullet-guideline.md": {
"version": "2.1.0",
"status": "aktiv",
"last_updated": "2025-09-15",
"type": "process-guide",
"scope": "trace-bullet-development-cycle",
"dependencies": ["master-guideline.md", "web-app-guideline.md"]
}
},
"archived": {
"_archived/docker-guideline-v3.0.1-archived-2025-09-15.md": {
"version": "3.0.1",
"status": "archiviert",
"archived_date": "2025-09-15",
"reason": "Redundant zu modularen Docker-Guides",
"type": "technology",
"scope": "docker-monolithic"
}
},
"statistics": {
"total_guidelines": 14,
"active_guidelines": 14,
"archived_guidelines": 1,
"last_optimization": "2025-09-15",
"optimization_details": {
"eliminated_redundancy": "69KB (docker-guideline.md)",
"standardized_headers": "14 Guidelines",
"unified_version": "2.1.0",
"language": "Deutsch"
}
}
}
@@ -0,0 +1,143 @@
# {{NAME}} - Prozess-Richtlinie
---
guideline_type: "process-guide"
scope: "{{SCOPE}}"
audience: ["developers", "ai-assistants", "project-managers"]
last_updated: "{{DATE}}"
dependencies: ["master-guideline.md"]
related_files: []
ai_context: "{{SCOPE}}-Prozess und Workflow-Richtlinien für effiziente Entwicklung im Meldestelle-Projekt"
---
## 🎯 Prozess-Überblick
Dieser Guide beschreibt den standardisierten Workflow für {{SCOPE}} im Meldestelle-Projekt.
> **🤖 AI-Assistant Hinweis:**
> Dieser Prozess ist optimiert für Effizienz und Qualitätssicherung:
> - **Eingabe:** [Was wird als Input benötigt]
> - **Ausgabe:** [Was wird als Output produziert]
> - **Dauer:** [Geschätzte Zeitdauer]
> - **Beteiligte:** [Rollen und Verantwortlichkeiten]
## 📋 Workflow-Schritte
### Phase 1: Vorbereitung
**Ziel:** [Beschreibung des Ziels dieser Phase]
#### Voraussetzungen
- [ ] [Voraussetzung 1]
- [ ] [Voraussetzung 2]
- [ ] [Voraussetzung 3]
#### Durchführung
1. **Schritt 1:** [Detaillierte Beschreibung]
2. **Schritt 2:** [Detaillierte Beschreibung]
3. **Schritt 3:** [Detaillierte Beschreibung]
### Phase 2: Durchführung
**Ziel:** [Beschreibung des Ziels dieser Phase]
#### Hauptaufgaben
1. **Aufgabe 1:** [Beschreibung und Verantwortlicher]
2. **Aufgabe 2:** [Beschreibung und Verantwortlicher]
3. **Aufgabe 3:** [Beschreibung und Verantwortlicher]
#### Qualitätskontrolle
- **Zwischenprüfung:** [Was wird geprüft]
- **Kriterien:** [Erfolgskriterien]
### Phase 3: Abschluss und Validierung
**Ziel:** [Beschreibung des Ziels dieser Phase]
#### Abschlusschecks
- [ ] [Qualitätssicherung 1]
- [ ] [Qualitätssicherung 2]
- [ ] [Dokumentation aktualisiert]
- [ ] [Stakeholder informiert]
## ⚠️ Häufige Fallstricke
### Problem: [Häufiges Problem]
**Symptome:** [Wie erkennt man das Problem]
**Ursache:** [Warum tritt es auf]
**Lösung:** [Konkrete Schritte zur Lösung]
**Prävention:** [Wie kann es vermieden werden]
### Problem: [Weiteres Problem]
**Symptome:** [Wie erkennt man das Problem]
**Ursache:** [Warum tritt es auf]
**Lösung:** [Konkrete Schritte zur Lösung]
**Prävention:** [Wie kann es vermieden werden]
## 🔧 Tools und Hilfsmittel
### Erforderliche Tools
| Tool | Verwendung | Installation/Zugriff | Dokumentation |
|------|------------|---------------------|---------------|
| [Tool 1] | [Zweck] | [Wie installieren] | [Link zur Doku] |
| [Tool 2] | [Zweck] | [Wie installieren] | [Link zur Doku] |
### Optionale Tools
| Tool | Vorteil | Wann verwenden |
|------|---------|----------------|
| [Tool 1] | [Vorteil] | [Situation] |
| [Tool 2] | [Vorteil] | [Situation] |
## 📊 Erfolgs-Metriken
### Qualitative Metriken
- **Kriterium 1:** [Beschreibung und Bewertung]
- **Kriterium 2:** [Beschreibung und Bewertung]
### Quantitative Metriken
- **Metrik 1:** [Zielwert und Messung]
- **Metrik 2:** [Zielwert und Messung]
### KPIs (Key Performance Indicators)
- **Effizienz:** [Wie wird gemessen]
- **Qualität:** [Wie wird gemessen]
- **Zufriedenheit:** [Wie wird gemessen]
## 🚨 Eskalation und Support
### Wann eskalieren?
- [Situation 1 mit Zeitangabe]
- [Situation 2 mit Zeitangabe]
### Eskalationspfad
1. **Level 1:** [Erste Anlaufstelle]
2. **Level 2:** [Zweite Anlaufstelle]
3. **Level 3:** [Finale Eskalation]
## 📋 Checkliste
### Vor Prozessstart
- [ ] Alle Voraussetzungen erfüllt
- [ ] Tools verfügbar und konfiguriert
- [ ] Team informiert und bereit
### Während des Prozesses
- [ ] Fortschritt dokumentiert
- [ ] Qualitätskontrollen durchgeführt
- [ ] Kommunikation aufrechterhalten
### Nach Prozessabschluss
- [ ] Ergebnisse validiert
- [ ] Dokumentation aktualisiert
- [ ] Lessons Learned erfasst
- [ ] Stakeholder informiert
## 🔗 Navigation
- [Master-Guideline](../master-guideline.md) - Übergeordnete Projektrichtlinien
- [Architecture-Principles](../project-standards/architecture-principles.md) - Architektur-Grundsätze
- [Testing-Standards](../project-standards/testing-standards.md) - Qualitätssicherung
---
**Prozess-Status:** [Aktiv/Beta/In Entwicklung]
**Letzte Aktualisierung:** {{DATE}}
**Nächste Überprüfung:** [Datum oder Trigger]
**Verantwortlicher:** [Name/Team]
@@ -0,0 +1,81 @@
# {{NAME}} - Standards und Richtlinien
---
guideline_type: "project-standards"
scope: "{{SCOPE}}"
audience: ["developers", "ai-assistants", "architects"]
last_updated: "{{DATE}}"
dependencies: ["master-guideline.md"]
related_files: []
ai_context: "{{SCOPE}}-Standards und Best Practices für das Meldestelle-Projekt"
---
## 🎯 Überblick
Diese Richtlinie definiert die verbindlichen Standards und Best Practices für {{SCOPE}} im Meldestelle-Projekt.
> **🤖 AI-Assistant Hinweis:**
> Diese Standards sind verbindlich für alle {{SCOPE}}-Entscheidungen und -Implementierungen.
> - **Scope:** {{SCOPE}}
> - **Verbindlich:** Ja, alle Entwickler müssen diese Standards befolgen
> - **Updates:** Bei Änderungen wird last_updated aktualisiert
## 📋 Grundprinzipien
### 1. [Prinzip 1]
[Beschreibung des ersten Grundprinzips]
### 2. [Prinzip 2]
[Beschreibung des zweiten Grundprinzips]
### 3. [Prinzip 3]
[Beschreibung des dritten Grundprinzips]
## 🔧 Implementierungsrichtlinien
### [Bereich 1]
[Konkrete Implementierungsanforderungen]
### [Bereich 2]
[Weitere Implementierungsrichtlinien]
## ✅ Qualitätssicherung
### Überprüfung und Validierung
- **Checkliste:** [Spezifische Prüfpunkte]
- **Tools:** [Empfohlene Validierungstools]
- **Tests:** [Erforderliche Testarten]
### Erfolgskriterien
- **Quantitativ:** [Messbare Ziele]
- **Qualitativ:** [Qualitätskriterien]
## 🚨 Häufige Fallstricke
### Problem: [Häufiges Problem]
**Ursache:** [Warum tritt es auf]
**Lösung:** [Konkrete Lösung]
### Problem: [Weiteres Problem]
**Ursache:** [Warum tritt es auf]
**Lösung:** [Konkrete Lösung]
## 📊 Checkliste
- [ ] Grundprinzipien verstanden und akzeptiert
- [ ] Implementierungsrichtlinien befolgt
- [ ] Qualitätssicherung durchgeführt
- [ ] Dokumentation aktualisiert
- [ ] Code-Review abgeschlossen
## 🔗 Navigation
- [Master-Guideline](../master-guideline.md) - Übergeordnete Projektrichtlinien
- [Architecture-Principles](./architecture-principles.md) - Architektur-Grundsätze
- [Coding-Standards](./coding-standards.md) - Code-Qualitätsstandards
---
**Status:** [Aktiv/In Entwicklung/Überarbeitung]
**Letzte Überprüfung:** {{DATE}}
**Nächste Überprüfung:** [Bei Bedarf oder regelmäßig]
@@ -0,0 +1,113 @@
# [TECHNOLOGIE-NAME] Guidelines
---
guideline_type: "technology"
scope: "[spezifischer-bereich-identifier]"
audience: ["developers", "ai-assistants", "devops"]
last_updated: "[YYYY-MM-DD]"
dependencies: ["master-guideline.md", "[weitere-abhängigkeiten]"]
related_files: ["[relevante-projekt-dateien]", "config/[konfig-dateien]"]
ai_context: "[Deutsche Kurzbeschreibung für KI-Verständnis]"
---
## 🚀 Überblick und Philosophie
[Kurze Einführung in die Technologie und ihre Rolle im Meldestelle-Projekt]
### Grundprinzipien
- **Prinzip 1**: Beschreibung
- **Prinzip 2**: Beschreibung
- **Prinzip 3**: Beschreibung
> **🤖 AI-Assistant Hinweis:**
> [Wichtige Informationen für KI-Assistenten, URLs, Ports, etc.]
## 📋 [HAUPTBEREICH 1]
### [Unterbereich 1.1]
[Detaillierte Beschreibung mit Code-Beispielen]
```bash
# Beispiel-Befehle
[command-examples]
```
### [Unterbereich 1.2]
[Weitere technische Details]
## 🎯 AI-Assistenten: [TECHNOLOGIE]-Schnellreferenz
### Häufige Aufgaben
| Aufgabe | Befehl | Beschreibung |
|---------|---------|--------------|
| [Task 1] | `[command]` | [Beschreibung] |
| [Task 2] | `[command]` | [Beschreibung] |
| [Task 3] | `[command]` | [Beschreibung] |
### Wichtige URLs/Endpoints
- **[Service 1]:** http://localhost:[PORT]
- **[Service 2]:** http://localhost:[PORT]
- **[Monitoring]:** http://localhost:[PORT]
### Debug-Commands
```bash
# [Debug-Zweck]
[debug-commands]
# [Troubleshooting-Zweck]
[troubleshooting-commands]
```
## 🔧 [HAUPTBEREICH 2]
### [Konfiguration/Setup]
[Konfigurationsdetails mit Beispielen]
### [Best Practices]
1. **[Practice 1]:** [Beschreibung]
2. **[Practice 2]:** [Beschreibung]
3. **[Practice 3]:** [Beschreibung]
## 📊 Monitoring und Observability
[Monitoring-spezifische Informationen, falls relevant]
### Metrics
| Metric | Typ | Beschreibung |
|--------|-----|--------------|
| `[metric_name]` | [Typ] | [Beschreibung] |
## 🚨 Troubleshooting
### Häufige Probleme
#### [Problem 1]
```bash
# Diagnose
[diagnostic-commands]
# Lösung
[solution-commands]
```
#### [Problem 2]
[Weitere Problemlösungen]
---
**Navigation:**
- [Docker-Overview](./docker/docker-overview.md) - [falls relevant]
- [Master-Guideline](../master-guideline.md) - Projekt-Überblick
- [Architecture Principles](../project-standards/architecture-principles.md) - Architektur-Grundlagen
---
> **Basis-Prinzipien:** Diese Guidelines erweitern die [Master-Guideline](../master-guideline.md) um [TECHNOLOGIE]-spezifische Aspekte und folgen den allgemeinen Projektstandards.
+2 -2
View File
@@ -1,8 +1,8 @@
# Meldestelle_Pro: Entwicklungs-Guideline
**Status:** Finalisiert & Verbindlich
**Version:** 1.0
**Stand:** 15. August 2025
**Version:** 2.1.0
**Stand:** 15. September 2025
## 1. Vision & Architektonische Grundpfeiler
@@ -4,10 +4,10 @@
guideline_type: "process-guide"
scope: "trace-bullet-development-cycle"
audience: ["developers", "ai-assistants", "project-managers"]
last_updated: "2025-09-13"
last_updated: "2025-09-15"
dependencies: ["master-guideline.md", "web-app-guideline.md"]
related_files: ["docker-compose.yml", "temp/ping-service/**", "client/**"]
ai_context: "End-to-end architecture validation cycle, infrastructure testing, ping service implementation"
ai_context: "End-to-End-Architektur-Validierungszyklus, Infrastruktur-Tests, Ping-Service-Implementierung"
---
* **Zyklus-Start:** 15. August 2025
@@ -4,10 +4,10 @@
guideline_type: "project-standards"
scope: "architecture-principles"
audience: ["developers", "architects", "ai-assistants"]
last_updated: "2025-09-13"
last_updated: "2025-09-15"
dependencies: ["master-guideline.md"]
related_files: ["build.gradle.kts", "settings.gradle.kts", "docker-compose.yml"]
ai_context: "Architectural foundations, microservices patterns, DDD principles, event-driven architecture, and multiplatform strategy"
ai_context: "Architektonische Grundlagen, Microservices-Pattern, DDD-Prinzipien, ereignisgesteuerte Architektur und Multiplatform-Strategie"
---
## 🏗️ Vision & Architektonische Grundpfeiler
@@ -4,7 +4,7 @@
guideline_type: "project-standards"
scope: "coding-standards"
audience: ["developers", "ai-assistants"]
last_updated: "2025-09-13"
last_updated: "2025-09-15"
dependencies: ["master-guideline.md"]
related_files: ["build.gradle.kts", "detekt.yml", "*.kt"]
ai_context: "Coding conventions, naming standards, type safety, error handling, and logging practices"
@@ -4,7 +4,7 @@
guideline_type: "project-standards"
scope: "documentation-standards"
audience: ["developers", "ai-assistants", "technical-writers"]
last_updated: "2025-09-13"
last_updated: "2025-09-15"
dependencies: ["master-guideline.md"]
related_files: ["README*.md", "docs/**", "*.md", "openapi.yaml"]
ai_context: "Documentation language standards, README structure, API documentation, and technical writing guidelines"
@@ -4,7 +4,7 @@
guideline_type: "project-standards"
scope: "testing-standards"
audience: ["developers", "ai-assistants"]
last_updated: "2025-09-13"
last_updated: "2025-09-15"
dependencies: ["master-guideline.md", "coding-standards.md"]
related_files: ["build.gradle.kts", "src/test/**", "testcontainers.properties"]
ai_context: "Testing strategies, test pyramid, tools, coverage requirements, and debugging practices"
@@ -4,10 +4,10 @@
guideline_type: "technology"
scope: "docker-architecture"
audience: ["developers", "ai-assistants", "devops"]
last_updated: "2025-09-13"
last_updated: "2025-09-15"
dependencies: ["docker-overview.md", "master-guideline.md"]
related_files: ["docker-compose.yml", "docker/versions.toml", "scripts/docker-versions-update.sh"]
ai_context: "Docker container architecture, service definitions, and centralized version management"
ai_context: "Docker-Container-Architektur, Service-Definitionen und zentrale Versionsverwaltung"
---
## 🏗️ Architektur-Überblick
@@ -4,10 +4,10 @@
guideline_type: "technology"
scope: "docker-development"
audience: ["developers", "ai-assistants"]
last_updated: "2025-09-13"
last_updated: "2025-09-15"
dependencies: ["docker-overview.md", "docker-architecture.md"]
related_files: ["docker-compose.yml", "docker-compose.override.yml", "Makefile"]
ai_context: "Development workflow, debugging, and local development setup with Docker"
ai_context: "Entwicklungs-Workflow, Debugging und lokale Entwicklungsumgebung mit Docker"
---
## 🛠️ Development-Workflow
@@ -4,10 +4,10 @@
guideline_type: "technology"
scope: "docker-monitoring"
audience: ["developers", "devops", "ai-assistants"]
last_updated: "2025-09-13"
last_updated: "2025-09-15"
dependencies: ["docker-overview.md", "docker-architecture.md"]
related_files: ["docker-compose.yml", "config/monitoring/*", "config/grafana/*", "config/prometheus/*"]
ai_context: "Monitoring setup, Prometheus metrics, Grafana dashboards, health checks, and log aggregation"
ai_context: "Monitoring-Setup, Prometheus-Metriken, Grafana-Dashboards, Health-Checks und Log-Aggregation"
---
## 📊 Monitoring und Observability
@@ -3,11 +3,11 @@
---
guideline_type: "technology"
scope: "docker-overview"
audience: ["developers", "ai-assistants"]
last_updated: "2025-09-13"
audience: ["developers", "ai-assistants", "devops"]
last_updated: "2025-09-15"
dependencies: ["master-guideline.md"]
related_files: ["docker-compose.yml", "docker/versions.toml"]
ai_context: "Docker philosophy and general principles for Meldestelle project"
ai_context: "Docker-Philosophie und allgemeine Prinzipien für das Meldestelle-Projekt"
---
## 🚀 Überblick und Philosophie
@@ -4,10 +4,10 @@
guideline_type: "technology"
scope: "docker-production"
audience: ["developers", "devops", "ai-assistants"]
last_updated: "2025-09-13"
last_updated: "2025-09-15"
dependencies: ["docker-overview.md", "docker-architecture.md"]
related_files: ["docker-compose.yml", "config/nginx/nginx.prod.conf", "config/ssl/*"]
ai_context: "Production deployment, security hardening, SSL/TLS configuration, and resource management"
ai_context: "Production-Deployment, Security-Hardening, SSL/TLS-Konfiguration und Ressourcenverwaltung"
---
## 🚀 Production-Deployment
@@ -4,10 +4,10 @@
guideline_type: "technology"
scope: "docker-troubleshooting"
audience: ["developers", "devops", "ai-assistants"]
last_updated: "2025-09-13"
last_updated: "2025-09-15"
dependencies: ["docker-overview.md", "docker-architecture.md", "docker-development.md"]
related_files: ["docker-compose.yml", "scripts/validate-docker-consistency.sh", "scripts/docker-versions-update.sh"]
ai_context: "Troubleshooting common Docker issues, debug commands, and comprehensive best practices"
ai_context: "Fehlerbehebung häufiger Docker-Probleme, Debug-Kommandos und umfassende Best Practices"
---
## 🔧 Troubleshooting
@@ -4,10 +4,10 @@
guideline_type: "technology"
scope: "web-app-multiplatform"
audience: ["developers", "ai-assistants", "frontend-developers"]
last_updated: "2025-09-13"
dependencies: ["master-guideline.md", "architecture-principles.md"]
related_files: ["client/build.gradle.kts", "client/src/commonMain/**", "client/src/wasmJsMain/**", "client/src/jvmMain/**"]
ai_context: "Compose Multiplatform development, MVVM pattern, KMP architecture, desktop and web client development"
last_updated: "2025-09-15"
dependencies: ["master-guideline.md", "project-standards/architecture-principles.md"]
related_files: ["client/build.gradle.kts", "client/src/commonMain/", "client/src/wasmJsMain/", "client/src/jvmMain/"]
ai_context: "Compose Multiplatform-Entwicklung, MVVM-Pattern, KMP-Architektur, Desktop- und Web-Client-Entwicklung"
---
## 1. Einleitung