@the-bearded-bear/claude-craft 3.3.3 → 3.4.0-next.593280d

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (70) hide show
  1. package/Dev/i18n/de/Angular/CLAUDE.md.template +63 -31
  2. package/Dev/i18n/de/CSharp/CLAUDE.md.template +69 -49
  3. package/Dev/i18n/de/Common/templates/CLAUDE.md.template +56 -39
  4. package/Dev/i18n/de/Flutter/CLAUDE.md.template +54 -423
  5. package/Dev/i18n/de/Laravel/CLAUDE.md.template +64 -87
  6. package/Dev/i18n/de/PHP/CLAUDE.md.template +64 -440
  7. package/Dev/i18n/de/Python/CLAUDE.md.template +73 -430
  8. package/Dev/i18n/de/React/CLAUDE.md.template +62 -510
  9. package/Dev/i18n/de/ReactNative/CLAUDE.md.template +84 -526
  10. package/Dev/i18n/de/Symfony/CLAUDE.md.template +58 -214
  11. package/Dev/i18n/de/VueJS/CLAUDE.md.template +66 -83
  12. package/Dev/i18n/en/Angular/CLAUDE.md.template +57 -27
  13. package/Dev/i18n/en/CSharp/CLAUDE.md.template +59 -45
  14. package/Dev/i18n/en/Common/commands/sub-agents-patterns.md +163 -0
  15. package/Dev/i18n/en/Common/templates/CLAUDE.md.template +57 -40
  16. package/Dev/i18n/en/Common/templates/mcp.json.template +23 -0
  17. package/Dev/i18n/en/Common/templates/settings.json.template +27 -2
  18. package/Dev/i18n/en/Flutter/CLAUDE.md.template +59 -422
  19. package/Dev/i18n/en/Laravel/CLAUDE.md.template +57 -79
  20. package/Dev/i18n/en/PHP/CLAUDE.md.template +60 -435
  21. package/Dev/i18n/en/Python/CLAUDE.md.template +67 -423
  22. package/Dev/i18n/en/React/CLAUDE.md.template +59 -505
  23. package/Dev/i18n/en/ReactNative/CLAUDE.md.template +68 -511
  24. package/Dev/i18n/en/Symfony/CLAUDE.md.template +74 -209
  25. package/Dev/i18n/en/VueJS/CLAUDE.md.template +53 -77
  26. package/Dev/i18n/es/Angular/CLAUDE.md.template +67 -29
  27. package/Dev/i18n/es/CSharp/CLAUDE.md.template +69 -45
  28. package/Dev/i18n/es/Common/templates/CLAUDE.md.template +57 -40
  29. package/Dev/i18n/es/Flutter/CLAUDE.md.template +51 -417
  30. package/Dev/i18n/es/Laravel/CLAUDE.md.template +63 -82
  31. package/Dev/i18n/es/PHP/CLAUDE.md.template +61 -435
  32. package/Dev/i18n/es/Python/CLAUDE.md.template +58 -415
  33. package/Dev/i18n/es/React/CLAUDE.md.template +60 -505
  34. package/Dev/i18n/es/ReactNative/CLAUDE.md.template +73 -507
  35. package/Dev/i18n/es/Symfony/CLAUDE.md.template +61 -210
  36. package/Dev/i18n/es/VueJS/CLAUDE.md.template +66 -80
  37. package/Dev/i18n/fr/Angular/CLAUDE.md.template +71 -26
  38. package/Dev/i18n/fr/CSharp/CLAUDE.md.template +82 -45
  39. package/Dev/i18n/fr/Common/templates/CLAUDE.md.template +56 -39
  40. package/Dev/i18n/fr/Flutter/CLAUDE.md.template +59 -413
  41. package/Dev/i18n/fr/Laravel/CLAUDE.md.template +70 -80
  42. package/Dev/i18n/fr/PHP/CLAUDE.md.template +67 -432
  43. package/Dev/i18n/fr/Python/CLAUDE.md.template +67 -411
  44. package/Dev/i18n/fr/React/CLAUDE.md.template +60 -501
  45. package/Dev/i18n/fr/ReactNative/CLAUDE.md.template +85 -519
  46. package/Dev/i18n/fr/Symfony/CLAUDE.md.template +54 -195
  47. package/Dev/i18n/fr/VueJS/CLAUDE.md.template +75 -80
  48. package/Dev/i18n/pt/Angular/CLAUDE.md.template +66 -29
  49. package/Dev/i18n/pt/CSharp/CLAUDE.md.template +67 -45
  50. package/Dev/i18n/pt/Common/templates/CLAUDE.md.template +56 -39
  51. package/Dev/i18n/pt/Flutter/CLAUDE.md.template +53 -420
  52. package/Dev/i18n/pt/Laravel/CLAUDE.md.template +57 -81
  53. package/Dev/i18n/pt/PHP/CLAUDE.md.template +60 -435
  54. package/Dev/i18n/pt/Python/CLAUDE.md.template +59 -415
  55. package/Dev/i18n/pt/React/CLAUDE.md.template +62 -505
  56. package/Dev/i18n/pt/ReactNative/CLAUDE.md.template +60 -510
  57. package/Dev/i18n/pt/Symfony/CLAUDE.md.template +58 -210
  58. package/Dev/i18n/pt/VueJS/CLAUDE.md.template +61 -80
  59. package/Dev/scripts/install-angular-rules.sh +1 -1
  60. package/Dev/scripts/install-common-rules.sh +16 -2
  61. package/Dev/scripts/install-csharp-rules.sh +1 -1
  62. package/Dev/scripts/install-flutter-rules.sh +1 -1
  63. package/Dev/scripts/install-laravel-rules.sh +1 -1
  64. package/Dev/scripts/install-php-rules.sh +1 -1
  65. package/Dev/scripts/install-python-rules.sh +1 -1
  66. package/Dev/scripts/install-react-rules.sh +1 -1
  67. package/Dev/scripts/install-reactnative-rules.sh +1 -1
  68. package/Dev/scripts/install-symfony-rules.sh +1 -1
  69. package/Dev/scripts/install-vuejs-rules.sh +1 -1
  70. package/package.json +1 -1
@@ -1,47 +1,17 @@
1
- # Règles de Développement Flutter - {{PROJECT_NAME}}
1
+ # {{PROJECT_NAME}} - Flutter
2
2
 
3
- ## Contexte du Projet
3
+ > Erstellt: {{GENERATION_DATE}} | Claude Craft v{{VERSION}}
4
4
 
5
- Voir le fichier détaillé : [rules/00-project-context.md](rules/00-project-context.md)
5
+ ## Was (Stack & Struktur)
6
6
 
7
- **Projet** : {{PROJECT_NAME}}
8
- **Stack** : {{TECH_STACK}}
9
- **State Management** : {{STATE_MANAGEMENT_PATTERN}}
10
-
11
- ---
12
-
13
- ## Règles Fondamentales
14
-
15
- ### 1. Méthodologie Obligatoire
16
-
17
- ⚠️ **IMPÉRATIF** : Toujours suivre le workflow d'analyse avant de coder.
18
-
19
- Voir : [rules/01-workflow-analysis.md](rules/01-workflow-analysis.md)
20
-
21
- **Étapes obligatoires** :
22
- 1. Comprendre le besoin métier
23
- 2. Explorer le code existant
24
- 3. Identifier les patterns du projet
25
- 4. Concevoir l'architecture
26
- 5. Définir le plan de test
27
- 6. Estimer les tâches
28
-
29
- ❌ **Ne JAMAIS** :
30
- - Commencer à coder sans analyse
31
- - Modifier du code sans comprendre l'impact
32
- - Dupliquer du code existant
33
- - Ignorer les conventions du projet
34
-
35
- ### 2. Architecture
36
-
37
- Voir : [rules/02-architecture.md](rules/02-architecture.md)
38
-
39
- **Clean Architecture obligatoire** :
7
+ **Stack**: {{TECH_STACK}}
8
+ **State Management**: {{STATE_MANAGEMENT_PATTERN}}
40
9
 
10
+ ### Projektstruktur
41
11
  ```
42
12
  lib/
43
- ├── core/ # Fonctionnalités communes
44
- ├── features/ # Features métier
13
+ ├── core/ # Gemeinsame Funktionalitaeten
14
+ ├── features/ # Business Features
45
15
  │ └── [feature_name]/
46
16
  │ ├── data/ # Models, DataSources, Repositories
47
17
  │ ├── domain/ # Entities, UseCases, Interfaces
@@ -49,399 +19,60 @@ lib/
49
19
  └── main.dart
50
20
  ```
51
21
 
52
- **Règle de dépendance** :
53
- ```
54
- PRESENTATION → DOMAIN ← DATA
55
- ```
56
-
57
- ### 3. Standards de Code
58
-
59
- Voir : [rules/03-coding-standards.md](rules/03-coding-standards.md)
60
-
61
- **Conventions de nommage** :
62
- - Fichiers/dossiers : `snake_case`
63
- - Classes/Enums : `UpperCamelCase`
64
- - Variables/fonctions : `lowerCamelCase`
65
- - Constantes : `lowerCamelCase` (pas SCREAMING_CASE)
66
- - Membres privés : `_leadingUnderscore`
67
-
68
- **Formatage** :
69
- - 80 caractères max par ligne
70
- - 2 espaces d'indentation
71
- - Virgules trailing pour multi-lignes
72
- - `const` partout où possible
22
+ ## Warum (Zweck & Organisation)
73
23
 
74
- ### 4. Principes SOLID
24
+ ### Architektur: Clean Architecture
25
+ - **Presentation** -> Domain <- **Data**
26
+ - Domain hat KEINE externen Abhaengigkeiten
27
+ - Dependency Inversion fuer Testbarkeit
75
28
 
76
- Voir : [rules/04-solid-principles.md](rules/04-solid-principles.md)
29
+ Siehe `rules/02-architecture.md` fuer Muster.
77
30
 
78
- - **S**ingle Responsibility : Une classe = une responsabilité
79
- - **O**pen/Closed : Extension sans modification
80
- - **L**iskov Substitution : Substituabilité des sous-classes
81
- - **I**nterface Segregation : Interfaces spécifiques
82
- - **D**ependency Inversion : Dépendre d'abstractions
31
+ ### Kritische Regeln
32
+ | Regel | Beschreibung |
33
+ |-------|--------------|
34
+ | Dateien | `snake_case` |
35
+ | Klassen | `UpperCamelCase` |
36
+ | Variablen | `lowerCamelCase` |
37
+ | `const` | Ueberall wo moeglich |
38
+ | Tests | 80% Coverage (Domain: 95%) |
83
39
 
84
- ### 5. KISS, DRY, YAGNI
40
+ ## Wie (Befehle & Workflows)
85
41
 
86
- Voir : [rules/05-kiss-dry-yagni.md](rules/05-kiss-dry-yagni.md)
87
-
88
- - **KISS** : Solution la plus simple
89
- - **DRY** : Éviter duplication
90
- - **YAGNI** : Coder pour besoins actuels
91
-
92
- ---
93
-
94
- ## Outils et Workflow
95
-
96
- ### Tooling
97
-
98
- Voir : [rules/06-tooling.md](rules/06-tooling.md)
99
-
100
- **Commandes quotidiennes** :
42
+ ### Entwicklungsbefehle
101
43
  ```bash
102
- make setup # Installer dépendances
103
- make generate # Générer code
104
- make test # Lancer tests
105
- make analyze # Analyser code
106
- make format # Formater code
107
- make ci # Pipeline CI complète
44
+ make setup # Abhaengigkeiten installieren
45
+ make run # App starten
46
+ make generate # Code generieren (freezed, json_serializable)
108
47
  ```
109
48
 
110
- **Docker** : Toujours utiliser Docker pour isolation (selon CLAUDE.md global)
111
-
112
- ### Testing
113
-
114
- Voir : [rules/07-testing.md](rules/07-testing.md)
115
-
116
- **Stratégie** :
117
- - 70% Unit tests
118
- - 20% Widget tests
119
- - 10% Integration tests
120
-
121
- **Coverage minimum** :
122
- - Domain : 95%
123
- - Data : 85%
124
- - Presentation : 70%
125
- - Global : 80%
126
-
127
- ### Qualité
128
-
129
- Voir : [rules/08-quality-tools.md](rules/08-quality-tools.md)
130
-
131
- **Avant chaque commit** :
132
- ```bash
133
- flutter analyze --fatal-infos
134
- dart format --set-exit-if-changed .
135
- flutter test --coverage
136
- ```
137
-
138
- ### Git Workflow
139
-
140
- Voir : [rules/09-git-workflow.md](rules/09-git-workflow.md)
141
-
142
- **Conventional Commits obligatoire** :
143
- ```
144
- feat(auth): add biometric login
145
- fix(cart): prevent duplicate items
146
- docs(readme): update installation steps
147
- ```
148
-
149
- **Branches** :
150
- - `main` : Production
151
- - `develop` : Développement
152
- - `feature/xxx` : Nouvelles features
153
- - `fix/xxx` : Bugfixes
154
-
155
- ---
156
-
157
- ## Documentation
158
-
159
- Voir : [rules/10-documentation.md](rules/10-documentation.md)
160
-
161
- **Dartdoc obligatoire pour** :
162
- - Toutes les classes publiques
163
- - Toutes les méthodes publiques
164
- - API complexes
165
-
166
- **Format** :
167
- ```dart
168
- /// Résumé sur une ligne.
169
- ///
170
- /// Description détaillée.
171
- ///
172
- /// Exemple:
173
- /// ```dart
174
- /// final user = User(id: '123');
175
- /// ```
176
- class User {
177
- // ...
178
- }
179
- ```
180
-
181
- ---
182
-
183
- ## Sécurité
184
-
185
- Voir : [rules/11-security.md](rules/11-security.md)
186
-
187
- **Règles strictes** :
188
- - Tokens → `flutter_secure_storage` uniquement
189
- - API keys → Variables d'environnement
190
- - HTTPS obligatoire
191
- - Certificate pinning en production
192
- - Obfuscation activée
193
- - Validation entrées utilisateur
194
-
195
- ❌ **INTERDIT** :
196
- - Secrets hardcodés
197
- - SharedPreferences pour données sensibles
198
- - Passwords en clair
199
- - Logs sensibles en production
200
-
201
- ---
202
-
203
- ## Performance
204
-
205
- Voir : [rules/12-performance.md](rules/12-performance.md)
206
-
207
- **Optimisations obligatoires** :
208
- - `const` widgets partout
209
- - `ListView.builder` pour listes
210
- - Image caching activé
211
- - Lazy loading
212
- - Éviter rebuilds inutiles
213
-
214
- **Vérification** :
215
- - Profile mode testé
216
- - Frame rate > 60 FPS
217
- - Temps démarrage < 2s
218
-
219
- ---
220
-
221
- ## State Management
222
-
223
- Voir : [rules/13-state-management.md](rules/13-state-management.md)
224
-
225
- **Pattern du projet** : {{STATE_MANAGEMENT_PATTERN}}
226
-
227
- **Recommandations** :
228
- - État local simple → StatefulWidget
229
- - État partagé → Provider/Riverpod
230
- - Logique complexe → BLoC
231
-
232
- ---
233
-
234
- ## Templates
235
-
236
- ### Widgets
237
-
238
- Voir : [templates/widget.md](templates/widget.md)
239
-
240
- ### BLoC
241
-
242
- Voir : [templates/bloc.md](templates/bloc.md)
243
-
244
- ### Repository
245
-
246
- Voir : [templates/repository.md](templates/repository.md)
247
-
248
- ### Tests
249
-
250
- - Widget tests : [templates/test-widget.md](templates/test-widget.md)
251
- - Unit tests : [templates/test-unit.md](templates/test-unit.md)
252
-
253
- ---
254
-
255
- ## Checklists
256
-
257
- ### Pre-Commit
258
-
259
- Voir : [checklists/pre-commit.md](checklists/pre-commit.md)
260
-
261
- - [ ] Code formaté
262
- - [ ] Analyze clean
263
- - [ ] Tests passent
264
- - [ ] Documentation à jour
265
- - [ ] Commit conventionnel
266
-
267
- ### Nouvelle Feature
268
-
269
- Voir : [checklists/new-feature.md](checklists/new-feature.md)
270
-
271
- ### Refactoring
272
-
273
- Voir : [checklists/refactoring.md](checklists/refactoring.md)
274
-
275
- ### Audit Sécurité
276
-
277
- Voir : [checklists/security.md](checklists/security.md)
278
-
279
- ---
280
-
281
- ## Commandes Makefile
282
-
49
+ ### Qualitaets-Pipeline
283
50
  ```bash
284
- # Setup
285
- make setup # Installer dépendances
286
- make clean # Nettoyer projet
287
-
288
- # Développement
289
- make run # Lancer app
290
- make generate # Générer code (freezed, json_serializable)
291
- make generate-watch # Mode watch
292
-
293
- # Tests
294
- make test # Tous les tests
295
- make test-unit # Tests unitaires
296
- make test-widget # Tests widgets
297
- make test-integration # Tests intégration
298
- make test-coverage # Tests avec coverage
299
-
300
- # Qualité
301
- make analyze # Analyser code
302
- make format # Formater code
303
- make format-check # Vérifier formatage
304
- make fix # Appliquer fixes auto
305
- make quality # Toutes vérifications
306
-
307
- # Build
308
- make build-apk # Android APK
309
- make build-appbundle # Android App Bundle
310
- make build-ios # iOS
311
- make build-web # Web
312
-
313
- # CI/CD
314
- make ci # Pipeline complète
51
+ make analyze # flutter analyze --fatal-infos
52
+ make format # dart format
53
+ make test # Alle Tests
54
+ make test-coverage # Mit Coverage
55
+ make quality # Alle Pruefungen
315
56
  ```
316
57
 
317
- ---
318
-
319
- ## Stack Technique
320
-
321
- ### Dépendances principales
322
-
323
- ```yaml
324
- dependencies:
325
- flutter:
326
- sdk: flutter
327
-
328
- # State Management
329
- {{STATE_MANAGEMENT_DEPENDENCIES}}
330
-
331
- # Network
332
- dio: ^5.4.0
333
- retrofit: ^4.0.3
334
-
335
- # Dependency Injection
336
- get_it: ^7.6.4
337
- injectable: ^2.3.2
338
-
339
- # Storage
340
- shared_preferences: ^2.2.2
341
- flutter_secure_storage: ^9.0.0
342
-
343
- # Utils
344
- freezed_annotation: ^2.4.1
345
- json_annotation: ^4.8.1
346
- dartz: ^0.10.1
347
-
348
- dev_dependencies:
349
- flutter_test:
350
- sdk: flutter
351
-
352
- # Code Generation
353
- build_runner: ^2.4.7
354
- freezed: ^2.4.6
355
- json_serializable: ^6.7.1
356
- injectable_generator: ^2.4.1
357
- retrofit_generator: ^8.0.4
358
-
359
- # Linting
360
- flutter_lints: ^3.0.1
361
- very_good_analysis: ^5.1.0
362
-
363
- # Testing
364
- mocktail: ^1.0.1
365
- bloc_test: ^9.1.5
366
- ```
367
-
368
- ---
369
-
370
- ## Ressources
371
-
372
- ### Documentation officielle
373
- - [Flutter Documentation](https://docs.flutter.dev/)
374
- - [Dart Language Tour](https://dart.dev/guides/language/language-tour)
375
- - [Effective Dart](https://dart.dev/guides/language/effective-dart)
376
-
377
- ### Architecture
378
- - [Clean Architecture](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html)
379
- - [Flutter Clean Architecture](https://github.com/ResoCoder/flutter-clean-architecture)
380
-
381
- ### State Management
382
- - [BLoC Library](https://bloclibrary.dev/)
383
- - [Riverpod Documentation](https://riverpod.dev/)
384
- - [Provider Documentation](https://pub.dev/packages/provider)
385
-
386
- ### Outils
387
- - [Flutter DevTools](https://docs.flutter.dev/development/tools/devtools/overview)
388
- - [FVM](https://fvm.app/)
389
- - [Dart Code Metrics](https://dcm.dev/)
390
-
391
- ---
392
-
393
- ## Contacts
394
-
395
- **Lead Developer** : {{LEAD_DEVELOPER}}
396
- **Repository** : {{REPOSITORY_URL}}
397
- **CI/CD** : {{CI_CD_PLATFORM}}
398
- **Documentation** : {{DOCS_URL}}
399
-
400
- ---
401
-
402
- ## Instructions pour Claude
403
-
404
- En tant qu'assistant de développement Flutter, tu dois :
405
-
406
- 1. **TOUJOURS** lire et appliquer ces règles
407
- 2. **TOUJOURS** commencer par l'analyse (règle 01)
408
- 3. **RESPECTER** l'architecture Clean Architecture
409
- 4. **SUIVRE** les conventions de nommage et formatage
410
- 5. **APPLIQUER** les principes SOLID, KISS, DRY, YAGNI
411
- 6. **ÉCRIRE** les tests en parallèle du code
412
- 7. **DOCUMENTER** avec dartdoc
413
- 8. **UTILISER** Docker pour toutes les commandes
414
- 9. **VÉRIFIER** la sécurité et les performances
415
- 10. **NE JAMAIS** commiter de secrets ou données sensibles
416
-
417
- ### Workflow type
418
-
419
- ```
420
- 1. Analyser besoin → rules/01-workflow-analysis.md
421
- 2. Explorer code existant
422
- 3. Concevoir architecture → rules/02-architecture.md
423
- 4. Implémenter avec standards → rules/03-coding-standards.md
424
- 5. Appliquer SOLID → rules/04-solid-principles.md
425
- 6. Écrire tests → rules/07-testing.md
426
- 7. Vérifier qualité → make ci
427
- 8. Documenter → rules/10-documentation.md
428
- 9. Commit conventionnel → rules/09-git-workflow.md
429
- ```
430
-
431
- ### Avant chaque réponse
432
-
433
- - [ ] Ai-je lu les règles pertinentes ?
434
- - [ ] Ai-je analysé l'impact sur le code existant ?
435
- - [ ] Mon code respecte-t-il Clean Architecture ?
436
- - [ ] Ai-je suivi les conventions de nommage ?
437
- - [ ] Ai-je appliqué les principes SOLID ?
438
- - [ ] Ai-je prévu les tests ?
439
- - [ ] Ai-je vérifié la sécurité ?
440
- - [ ] Ai-je documenté le code ?
441
-
442
- ---
443
-
444
- *Ces règles garantissent la qualité, la maintenabilité et l'évolutivité du projet Flutter.*
445
-
446
- **Version** : 1.0
447
- **Dernière mise à jour** : {{UPDATE_DATE}}
58
+ ### Entwicklungs-Workflow
59
+ 1. **Analysieren** - `rules/01-workflow-analysis.md` lesen
60
+ 2. **TDD** - Test schreiben, implementieren, refaktorisieren
61
+ 3. **Qualitaet** - `make quality` ausfuehren
62
+ 4. **Commit** - Conventional Commits Format
63
+
64
+ ## Referenzen
65
+ | Kontext | Datei |
66
+ |---------|-------|
67
+ | Vor Aenderungen | `rules/01-workflow-analysis.md` |
68
+ | Architektur | `rules/02-architecture.md` |
69
+ | Code Standards | `rules/03-coding-standards.md` |
70
+ | SOLID | `rules/04-solid-principles.md` |
71
+ | Testing | `rules/07-testing.md` |
72
+ | Sicherheit | `rules/11-security.md` |
73
+ | State Management | `rules/13-state-management.md` |
74
+
75
+ <!-- PROJECT-SPECIFIC-START -->
76
+ ## Projektspezifika
77
+ <!-- Projektspezifische Konfiguration hier hinzufuegen -->
78
+ <!-- PROJECT-SPECIFIC-END -->
@@ -1,104 +1,81 @@
1
- # {{PROJECT_NAME}} - Laravel Project
1
+ # {{PROJECT_NAME}} - Laravel
2
2
 
3
- ## Project Context
3
+ > Erstellt: {{GENERATION_DATE}} | Claude Craft v{{VERSION}}
4
4
 
5
- - **Technology**: Laravel {{LARAVEL_VERSION}}
6
- - **PHP Version**: {{PHP_VERSION}}
7
- - **Architecture**: {{ARCHITECTURE_PATTERN}}
8
- - **Database**: {{DATABASE_TYPE}}
5
+ ## Was (Stack & Struktur)
9
6
 
10
- ## Commands
11
-
12
- ### Development
13
- ```bash
14
- # Start development server
15
- php artisan serve
16
-
17
- # Run queue worker
18
- php artisan queue:work
19
-
20
- # Run tests
21
- php artisan test
22
-
23
- # Run tests with coverage
24
- php artisan test --coverage
25
- ```
26
-
27
- ### Code Quality
28
- ```bash
29
- # Format code
30
- ./vendor/bin/pint
31
-
32
- # Static analysis
33
- ./vendor/bin/phpstan analyse
34
-
35
- # Full quality check
36
- ./vendor/bin/pint && ./vendor/bin/phpstan analyse && php artisan test
37
- ```
38
-
39
- ### Database
40
- ```bash
41
- # Run migrations
42
- php artisan migrate
43
-
44
- # Fresh database with seeds
45
- php artisan migrate:fresh --seed
46
-
47
- # Rollback last migration
48
- php artisan migrate:rollback
49
- ```
50
-
51
- ## Architecture
52
-
53
- This project follows {{ARCHITECTURE_PATTERN}}:
7
+ **Stack**: Laravel {{LARAVEL_VERSION}} + PHP {{PHP_VERSION}}
8
+ **Datenbank**: {{DATABASE_TYPE}}
9
+ **Architektur**: {{ARCHITECTURE_PATTERN}}
54
10
 
11
+ ### Projektstruktur
55
12
  ```
56
13
  app/
57
- ├── Domain/ # Core business logic
58
- ├── Application/ # Use cases, Actions, DTOs
59
- ├── Infrastructure/ # External services, Repositories
60
- └── Http/ # Controllers, Requests, Resources
14
+ ├── Domain/ # Kern-Geschaeftslogik
15
+ │ ├── Models/ # Eloquent Models
16
+ │ └── Services/ # Domain Services
17
+ ├── Application/ # Use Cases, Actions, DTOs
18
+ │ ├── Actions/ # Single Action Classes
19
+ │ └── DTOs/ # Data Transfer Objects
20
+ ├── Infrastructure/ # Externe Services, Repositories
21
+ └── Http/ # Controller, Requests, Resources
22
+ ├── Controllers/
23
+ ├── Requests/ # Form Requests
24
+ └── Resources/ # API Resources
61
25
  ```
62
26
 
63
- ## Coding Standards
64
-
65
- - **PHP**: 8.3+ with strict types
66
- - **Style**: Laravel Pint (PSR-12 + Laravel)
67
- - **Analysis**: PHPStan level 8
27
+ ## Warum (Zweck & Organisation)
68
28
 
69
- ### Key Conventions
29
+ ### Architektur: {{ARCHITECTURE_PATTERN}}
30
+ - **Controller**: Duenn, delegiert an Actions
31
+ - **Validation**: Immer via Form Requests
32
+ - **Responses**: Immer via API Resources
33
+ - **Authorization**: Via Policies
70
34
 
71
- 1. **Controllers**: Thin, delegate to Actions
72
- 2. **Validation**: Always via Form Requests
73
- 3. **Responses**: Always via API Resources
74
- 4. **Authorization**: Via Policies
75
- 5. **Business Logic**: In Domain layer or Actions
35
+ Siehe `rules/02-architecture.md` fuer Muster.
76
36
 
77
- ## Testing
37
+ ### Kritische Regeln
38
+ | Regel | Beschreibung |
39
+ |-------|--------------|
40
+ | PHP | 8.3+ mit strict types |
41
+ | Style | Laravel Pint (PSR-12) |
42
+ | Analysis | PHPStan Level 8 |
43
+ | Tests | 80% Coverage (Pest) |
78
44
 
79
- - **Framework**: Pest PHP
80
- - **Minimum Coverage**: 80%
81
- - **Test Types**: Feature, Unit, Architecture
45
+ ## Wie (Befehle & Workflows)
82
46
 
47
+ ### Entwicklungsbefehle
83
48
  ```bash
84
- # Run all tests
85
- php artisan test
86
-
87
- # Run specific test
88
- php artisan test --filter=OrderTest
89
-
90
- # Run in parallel
91
- php artisan test --parallel
49
+ php artisan serve # Dev Server
50
+ php artisan queue:work # Queue Worker
51
+ php artisan migrate # Migrationen
52
+ php artisan migrate:fresh --seed # DB Reset
92
53
  ```
93
54
 
94
- ## Environment
95
-
96
- - **Local**: Uses Docker via Laravel Sail
97
- - **Testing**: SQLite in-memory
98
- - **Production**: PostgreSQL
99
-
100
- ## Important Files
55
+ ### Qualitaets-Pipeline
56
+ ```bash
57
+ ./vendor/bin/pint # Code Format
58
+ ./vendor/bin/phpstan analyse # Statische Analyse
59
+ php artisan test # Tests
60
+ php artisan test --coverage # Mit Coverage
61
+ ```
101
62
 
102
- - `phpstan.neon` - Static analysis config
103
- - `pint.json` - Code style config
104
- - `.env.example` - Environment template
63
+ ### Entwicklungs-Workflow
64
+ 1. **Analysieren** - `rules/01-workflow-analysis.md` lesen
65
+ 2. **TDD** - Test schreiben, implementieren, refaktorisieren
66
+ 3. **Qualitaet** - Pint + PHPStan + Tests
67
+ 4. **Commit** - Conventional Commits Format
68
+
69
+ ## Referenzen
70
+ | Kontext | Datei |
71
+ |---------|-------|
72
+ | Vor Aenderungen | `rules/01-workflow-analysis.md` |
73
+ | Architektur | `rules/02-architecture.md` |
74
+ | Code Standards | `rules/03-coding-standards.md` |
75
+ | Testing | `rules/07-testing.md` |
76
+ | Sicherheit | `rules/11-security.md` |
77
+
78
+ <!-- PROJECT-SPECIFIC-START -->
79
+ ## Projektspezifika
80
+ <!-- Projektspezifische Konfiguration hier hinzufuegen -->
81
+ <!-- PROJECT-SPECIFIC-END -->