# {{PROJECT_NAME}} - Flutter

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

## Quoi (Stack & Structure)

**Stack**: {{TECH_STACK}}
**State Management**: {{STATE_MANAGEMENT_PATTERN}}

### Structure du projet
```
lib/
├── core/                 # Fonctionnalites communes
├── features/             # Features metier
│   └── [feature_name]/
│       ├── data/         # Models, DataSources, Repositories
│       ├── domain/       # Entities, UseCases, Interfaces
│       └── presentation/ # BLoC, Pages, Widgets
└── main.dart
```

## Pourquoi (Objectif & Organisation)

### Architecture: Clean Architecture
- **Presentation**: UI et state management (BLoC/Provider)
- **Domain**: Logique metier pure, use cases
- **Data**: Sources de donnees et implementations

Regle de dependance: `PRESENTATION -> DOMAIN <- DATA`

Voir `rules/02-architecture.md` pour les patterns.

### Regles critiques

| Regle | Description |
|-------|-------------|
| Analyse avant code | Consulter `rules/01-workflow-analysis.md` |
| const partout | Utiliser `const` widgets |
| Coverage 80%+ | Unit 70%, Widget 20%, Integration 10% |
| Docker obligatoire | Toutes commandes via Makefile |

## Comment (Commandes & Workflows)

### Commandes de developpement
```bash
make setup             # Installer dependances
make run               # Lancer app
make generate          # Generer code (freezed, json_serializable)
make generate-watch    # Mode watch
```

### Pipeline de qualite
```bash
make analyze           # Analyser code
make format            # Formater code
make test              # Tous les tests
make test-coverage     # Tests avec coverage
make quality           # Toutes verifications
make ci                # Pipeline complete
```

### Build
```bash
make build-apk         # Android APK
make build-appbundle   # Android App Bundle
make build-ios         # iOS
```

### Workflow de developpement
1. **Analyser** - `rules/01-workflow-analysis.md`
2. **TDD** - Test first, puis implementation
3. **Qualite** - `make ci`
4. **Commit** - Conventional Commits

## References

| Contexte | Fichier |
|----------|---------|
| Workflow | `rules/01-workflow-analysis.md` |
| Architecture | `rules/02-architecture.md` |
| Standards | `rules/03-coding-standards.md` |
| SOLID | `rules/04-solid-principles.md` |
| Tests | `rules/07-testing.md` |
| State | `rules/13-state-management.md` |
| Securite | `rules/11-security.md` |
| Performance | `rules/12-performance.md` |

<!-- PROJECT-SPECIFIC-START -->
## Specificites du projet

<!-- Cette section est preservee lors des mises a jour -->

<!-- PROJECT-SPECIFIC-END -->
