fixing .junie
This commit is contained in:
@@ -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"
|
||||
|
||||
@@ -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"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -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.
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user