@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.
- package/Dev/i18n/de/Angular/CLAUDE.md.template +63 -31
- package/Dev/i18n/de/CSharp/CLAUDE.md.template +69 -49
- package/Dev/i18n/de/Common/templates/CLAUDE.md.template +56 -39
- package/Dev/i18n/de/Flutter/CLAUDE.md.template +54 -423
- package/Dev/i18n/de/Laravel/CLAUDE.md.template +64 -87
- package/Dev/i18n/de/PHP/CLAUDE.md.template +64 -440
- package/Dev/i18n/de/Python/CLAUDE.md.template +73 -430
- package/Dev/i18n/de/React/CLAUDE.md.template +62 -510
- package/Dev/i18n/de/ReactNative/CLAUDE.md.template +84 -526
- package/Dev/i18n/de/Symfony/CLAUDE.md.template +58 -214
- package/Dev/i18n/de/VueJS/CLAUDE.md.template +66 -83
- package/Dev/i18n/en/Angular/CLAUDE.md.template +57 -27
- package/Dev/i18n/en/CSharp/CLAUDE.md.template +59 -45
- package/Dev/i18n/en/Common/commands/sub-agents-patterns.md +163 -0
- package/Dev/i18n/en/Common/templates/CLAUDE.md.template +57 -40
- package/Dev/i18n/en/Common/templates/mcp.json.template +23 -0
- package/Dev/i18n/en/Common/templates/settings.json.template +27 -2
- package/Dev/i18n/en/Flutter/CLAUDE.md.template +59 -422
- package/Dev/i18n/en/Laravel/CLAUDE.md.template +57 -79
- package/Dev/i18n/en/PHP/CLAUDE.md.template +60 -435
- package/Dev/i18n/en/Python/CLAUDE.md.template +67 -423
- package/Dev/i18n/en/React/CLAUDE.md.template +59 -505
- package/Dev/i18n/en/ReactNative/CLAUDE.md.template +68 -511
- package/Dev/i18n/en/Symfony/CLAUDE.md.template +74 -209
- package/Dev/i18n/en/VueJS/CLAUDE.md.template +53 -77
- package/Dev/i18n/es/Angular/CLAUDE.md.template +67 -29
- package/Dev/i18n/es/CSharp/CLAUDE.md.template +69 -45
- package/Dev/i18n/es/Common/templates/CLAUDE.md.template +57 -40
- package/Dev/i18n/es/Flutter/CLAUDE.md.template +51 -417
- package/Dev/i18n/es/Laravel/CLAUDE.md.template +63 -82
- package/Dev/i18n/es/PHP/CLAUDE.md.template +61 -435
- package/Dev/i18n/es/Python/CLAUDE.md.template +58 -415
- package/Dev/i18n/es/React/CLAUDE.md.template +60 -505
- package/Dev/i18n/es/ReactNative/CLAUDE.md.template +73 -507
- package/Dev/i18n/es/Symfony/CLAUDE.md.template +61 -210
- package/Dev/i18n/es/VueJS/CLAUDE.md.template +66 -80
- package/Dev/i18n/fr/Angular/CLAUDE.md.template +71 -26
- package/Dev/i18n/fr/CSharp/CLAUDE.md.template +82 -45
- package/Dev/i18n/fr/Common/templates/CLAUDE.md.template +56 -39
- package/Dev/i18n/fr/Flutter/CLAUDE.md.template +59 -413
- package/Dev/i18n/fr/Laravel/CLAUDE.md.template +70 -80
- package/Dev/i18n/fr/PHP/CLAUDE.md.template +67 -432
- package/Dev/i18n/fr/Python/CLAUDE.md.template +67 -411
- package/Dev/i18n/fr/React/CLAUDE.md.template +60 -501
- package/Dev/i18n/fr/ReactNative/CLAUDE.md.template +85 -519
- package/Dev/i18n/fr/Symfony/CLAUDE.md.template +54 -195
- package/Dev/i18n/fr/VueJS/CLAUDE.md.template +75 -80
- package/Dev/i18n/pt/Angular/CLAUDE.md.template +66 -29
- package/Dev/i18n/pt/CSharp/CLAUDE.md.template +67 -45
- package/Dev/i18n/pt/Common/templates/CLAUDE.md.template +56 -39
- package/Dev/i18n/pt/Flutter/CLAUDE.md.template +53 -420
- package/Dev/i18n/pt/Laravel/CLAUDE.md.template +57 -81
- package/Dev/i18n/pt/PHP/CLAUDE.md.template +60 -435
- package/Dev/i18n/pt/Python/CLAUDE.md.template +59 -415
- package/Dev/i18n/pt/React/CLAUDE.md.template +62 -505
- package/Dev/i18n/pt/ReactNative/CLAUDE.md.template +60 -510
- package/Dev/i18n/pt/Symfony/CLAUDE.md.template +58 -210
- package/Dev/i18n/pt/VueJS/CLAUDE.md.template +61 -80
- package/Dev/scripts/install-angular-rules.sh +1 -1
- package/Dev/scripts/install-common-rules.sh +16 -2
- package/Dev/scripts/install-csharp-rules.sh +1 -1
- package/Dev/scripts/install-flutter-rules.sh +1 -1
- package/Dev/scripts/install-laravel-rules.sh +1 -1
- package/Dev/scripts/install-php-rules.sh +1 -1
- package/Dev/scripts/install-python-rules.sh +1 -1
- package/Dev/scripts/install-react-rules.sh +1 -1
- package/Dev/scripts/install-reactnative-rules.sh +1 -1
- package/Dev/scripts/install-symfony-rules.sh +1 -1
- package/Dev/scripts/install-vuejs-rules.sh +1 -1
- package/package.json +1 -1
|
@@ -1,47 +1,17 @@
|
|
|
1
|
-
#
|
|
1
|
+
# {{PROJECT_NAME}} - Flutter
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> Erstellt: {{GENERATION_DATE}} | Claude Craft v{{VERSION}}
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
## Was (Stack & Struktur)
|
|
6
6
|
|
|
7
|
-
**
|
|
8
|
-
**
|
|
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/ #
|
|
44
|
-
├── features/ # Features
|
|
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
|
-
|
|
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
|
-
###
|
|
24
|
+
### Architektur: Clean Architecture
|
|
25
|
+
- **Presentation** -> Domain <- **Data**
|
|
26
|
+
- Domain hat KEINE externen Abhaengigkeiten
|
|
27
|
+
- Dependency Inversion fuer Testbarkeit
|
|
75
28
|
|
|
76
|
-
|
|
29
|
+
Siehe `rules/02-architecture.md` fuer Muster.
|
|
77
30
|
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
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
|
-
|
|
40
|
+
## Wie (Befehle & Workflows)
|
|
85
41
|
|
|
86
|
-
|
|
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 #
|
|
103
|
-
make
|
|
104
|
-
make
|
|
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
|
-
|
|
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
|
-
#
|
|
285
|
-
make
|
|
286
|
-
make
|
|
287
|
-
|
|
288
|
-
#
|
|
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
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
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
|
|
1
|
+
# {{PROJECT_NAME}} - Laravel
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> Erstellt: {{GENERATION_DATE}} | Claude Craft v{{VERSION}}
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
- **PHP Version**: {{PHP_VERSION}}
|
|
7
|
-
- **Architecture**: {{ARCHITECTURE_PATTERN}}
|
|
8
|
-
- **Database**: {{DATABASE_TYPE}}
|
|
5
|
+
## Was (Stack & Struktur)
|
|
9
6
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
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/ #
|
|
58
|
-
├──
|
|
59
|
-
|
|
60
|
-
|
|
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
|
-
##
|
|
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
|
-
###
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
80
|
-
- **Minimum Coverage**: 80%
|
|
81
|
-
- **Test Types**: Feature, Unit, Architecture
|
|
45
|
+
## Wie (Befehle & Workflows)
|
|
82
46
|
|
|
47
|
+
### Entwicklungsbefehle
|
|
83
48
|
```bash
|
|
84
|
-
#
|
|
85
|
-
php artisan
|
|
86
|
-
|
|
87
|
-
#
|
|
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
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
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
|
-
|
|
103
|
-
- `
|
|
104
|
-
|
|
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 -->
|