# Index Instructions

Aktualisiert: 2025-10-20

Zentraler Überblick über alle *.instructions.md Dateien im Ordner `.github` für automatische Nutzung.

## Übersicht Bestehend
- Architektur: `architecture.instructions.md`
- Coding Guidelines: `coding_guidelines.instructions.md`
- Domain (Security Area): `security_area_domain.instructions.md`
- Fragebogen Workflow: `questionnaire_workflow.instructions.md`
- Projekt Erweiterung: `extend_project.instructions.md`
- Refresh & Fake-ID Mechanismus: `refresh_fake_id.instructions.md`
- Allgemeine Projektinfo: `general_project.instructions.md`
- AI Kontext / Generatorhinweise: `ai_context.instructions.md`

## Neue Spezial-Themen
- Persistence Layer: `persistence.instructions.md`
- PDF Generierung (iText7): `pdf_generation.instructions.md`
- Klon-Strategien: `cloning.instructions.md`
- Fehler & Logging: `error_handling.instructions.md`
- Test-Strategie: `testing_strategy.instructions.md`
- Transaktionen: `transactions.instructions.md`
- Manager/Controller Muster: `manager_controller_pattern.instructions.md`

## Verwendung (Automatisierung)
1. Start: `general_project.instructions.md` + `architecture.instructions.md` lesen.
2. Bei neuen Entities: `extend_project.instructions.md` + `persistence.instructions.md`.
3. Bei UI/Business Verkettung: `manager_controller_pattern.instructions.md`.
4. Für Fragebogenfunktionen: `questionnaire_workflow.instructions.md` + `security_area_domain.instructions.md`.
5. Für temporäre IDs & Refresh: `refresh_fake_id.instructions.md`.
6. Für PDF Features: `pdf_generation.instructions.md`.
7. Für Klon-Operationen: `cloning.instructions.md`.
8. Für Fehlerstrategie: `error_handling.instructions.md`.
9. Für Transaktionsregeln: `transactions.instructions.md`.
10. Für Qualitätsstil: `coding_guidelines.instructions.md`.

## Priorität bei Unklarheiten
1. `general_project.instructions.md`
2. `architecture.instructions.md`
3. `coding_guidelines.instructions.md`
4. Spezialthema betreffende Datei

## Pflegehinweise
- Beim Ändern von Basisklassen (AbstractManager / AbstractController / AbstractEntity) entsprechende Dateien aktualisieren.
- Tippfehler Methode `refrehSelected()` bei Umbenennung in Code auch in `refresh_fake_id.instructions.md` und `architecture.instructions.md` anpassen.
- Neue fachliche Domains erhalten eigene `<domain>.instructions.md` Datei mit Operations-, Entity- und Edge Case Liste.

## Roadmap Dokumentation
- Nach Einführung eines Exception Layers: `error_handling.instructions.md` erweitern.
- Nach Migration zu Jakarta: Alle Dateien Namespace Hinweis aktualisieren.

---