# {{PROJECT_NAME}} - PHP Clean Architecture

> Erstellt: {{GENERATION_DATE}} | Claude Craft v{{VERSION}}

## Was (Stack & Struktur)

**Stack**: {{TECH_STACK}}
**Framework**: {{PHP_FRAMEWORK}} + PHP {{PHP_VERSION}}

### Projektstruktur
```
src/
├── Domain/                # Kern-Geschaeftslogik (KEINE externen Abhaengigkeiten)
│   ├── Entity/           # Business Entities
│   ├── ValueObject/      # Immutable Types
│   ├── Event/            # Domain Events
│   └── Repository/       # Interface-Vertraege
├── Application/           # Use Cases & CQRS
│   ├── UseCase/
│   │   └── [Feature]/
│   │       ├── Command/  # Schreiboperationen
│   │       └── Query/    # Leseoperationen
│   └── DTO/              # Data Transfer Objects
├── Infrastructure/        # Technische Implementierungen
│   ├── Persistence/      # Doctrine/Eloquent
│   └── Service/          # Externe Services
└── Presentation/          # Controller, API
```

## Warum (Zweck & Organisation)

### Architektur: Clean Architecture + CQRS
- **Domain**: Geschaeftslogik ohne Framework-Abhaengigkeiten
- **Application**: Commands/Queries fuer Use Cases
- **Infrastructure**: Adapter fuer DB, APIs, etc.

Siehe `rules/02-architecture.md` fuer Muster.

### Kritische Regeln
| Regel | Beschreibung |
|-------|--------------|
| Strict Types | `declare(strict_types=1);` in jeder Datei |
| PHPStan | Level 9 ohne Fehler |
| Tests | 80% Coverage (Domain: 90%) |
| CQRS | Commands/Queries strikt getrennt |

## Wie (Befehle & Workflows)

### Entwicklungsbefehle
```bash
composer install            # Abhaengigkeiten
{{CACHE_CLEAR_COMMAND}}     # Cache leeren
{{MIGRATION_RUN_COMMAND}}   # Migrationen
```

### Qualitaets-Pipeline
```bash
vendor/bin/phpstan analyse               # Statische Analyse
vendor/bin/php-cs-fixer fix --dry-run   # Code Style pruefen
vendor/bin/php-cs-fixer fix             # Code Style fixen
vendor/bin/phpunit --coverage-html cov/ # Tests mit Coverage
composer quality                         # Alle Pruefungen
```

### Entwicklungs-Workflow
1. **Analysieren** - `rules/01-workflow-analysis.md` lesen
2. **TDD** - Test schreiben, implementieren, refaktorisieren
3. **Qualitaet** - `composer quality` ausfuehren
4. **Commit** - Conventional Commits Format

## Referenzen
| Kontext | Datei |
|---------|-------|
| Vor Aenderungen | `rules/01-workflow-analysis.md` |
| Architektur | `rules/02-architecture.md` |
| Code Standards | `rules/03-coding-standards.md` |
| SOLID | `rules/04-solid-principles.md` |
| Testing | `rules/07-testing.md` |
| Sicherheit | `rules/11-security.md` |

<!-- PROJECT-SPECIFIC-START -->
## Projektspezifika
<!-- Projektspezifische Konfiguration hier hinzufuegen -->
<!-- PROJECT-SPECIFIC-END -->
