@the-bearded-bear/claude-craft 8.8.1 → 8.8.2

package/Dev/i18n/fr/Angular/commands/check-compliance.md

@@ -1,203 +1,253 @@
 ---
-description: Angular Standards Compliance Check
+description: Vérification Complète de la Conformité Angular
+argument-hint: [arguments]
 ---
 
-# Angular Standards Compliance Check
+# Vérification Complète de la Conformité Angular
 
-Verify that the Angular project follows established coding standards and best practices.
+## Arguments
 
-## What This Command Does
+$ARGUMENTS (optionnel : chemin du projet à analyser)
 
-1. **Standards Verification**
-   - Check coding conventions
-   - Verify naming conventions
-   - Validate file organization
-   - Check import order
-   - Verify documentation standards
+## Mode Plan
 
-2. **Angular-Specific Checks**
-   - Standalone components usage
-   - Signals implementation
-   - OnPush change detection
-   - Modern control flow (@if, @for)
-   - Typed forms
+> Le mode plan est activé automatiquement lorsque le périmètre couvre plusieurs modules ou nécessite une investigation transversale.
 
-3. **Generated Report**
-   - Non-compliant files
-   - Severity levels
-   - Remediation recommendations
-   - Compliance score (/100)
+## MISSION
 
-## Mode Plan
+Réaliser un audit complet de conformité du projet Angular en orchestrant les 4 grandes vérifications : Architecture, Qualité du Code, Tests et Sécurité. Produire un rapport consolidé avec un score global sur 100 points.
 
-> Le mode plan est activé automatiquement lorsque le périmètre couvre plusieurs modules ou nécessite une investigation transversale.
+### Étape 1 : Préparation de l'audit
 
-## Compliance Areas
-
-### 1. Component Standards
-
-```typescript
-// ✅ Compliant
-@Component({
-  selector: 'app-user-profile',
-  standalone: true,
-  imports: [CommonModule],
-  changeDetection: ChangeDetectionStrategy.OnPush,
-  template: `...`
-})
-export class UserProfileComponent {}
-
-// ❌ Non-compliant
-@Component({
-  selector: 'user-profile',     // Missing app- prefix
-  // standalone: missing       // Not standalone
-  // changeDetection: missing  // Not OnPush
-})
-export class UserProfile {}    // Missing Component suffix
-```
+Préparer l'environnement d'audit :
+- [ ] Identifier le chemin du projet à auditer
+- [ ] Vérifier la présence des fichiers de configuration (angular.json, tsconfig.json, package.json)
+- [ ] Lister les répertoires principaux (src/app/, e2e/, etc.)
+- [ ] Identifier la structure du projet et la version Angular
 
-### 2. Signal Usage
+**Note** : Si $ARGUMENTS est fourni, l'utiliser comme chemin du projet, sinon utiliser le répertoire courant.
 
-```typescript
-// ✅ Compliant - Using signals
-export class CounterComponent {
-  count = signal(0);
-  doubleCount = computed(() => this.count() * 2);
-}
+### Étape 2 : Audit Architecture (25 points)
 
-// ❌ Non-compliant - Using observables for local state
-export class CounterComponent {
-  count$ = new BehaviorSubject(0);
-}
-```
+Exécuter la vérification complète de l'architecture :
 
-### 3. Template Syntax
+**Commande** : Utiliser la commande slash `/angular:check-architecture` ou suivre manuellement les étapes dans `check-architecture.md`
 
-```html
-<!-- ✅ Compliant - Modern control flow -->
-@if (loading()) {
-  <app-spinner />
-}
+**Critères évalués** :
+- Structure des modules pilotée par le domaine (6 pts)
+- Utilisation des composants standalone (6 pts)
+- Lazy loading et routage (4 pts)
+- Séparation Core/Shared/Feature (4 pts)
+- Organisation de la couche service (3 pts)
+- Patterns d'injection de dépendances (2 pts)
 
-@for (item of items(); track item.id) {
-  <app-item [data]="item" />
-}
+**Référence** : `check-architecture.md`
 
-<!-- ❌ Non-compliant - Legacy syntax -->
-<app-spinner *ngIf="loading"></app-spinner>
-<app-item *ngFor="let item of items" [data]="item"></app-item>
-```
+### Étape 3 : Audit Qualité du Code (25 points)
 
-### 4. Dependency Injection
+Exécuter la vérification de la qualité du code :
 
-```typescript
-// ✅ Compliant - inject() function
-export class MyComponent {
-  private readonly userService = inject(UserService);
-}
+**Commande** : Utiliser la commande slash `/angular:check-code-quality` ou suivre manuellement les étapes dans `check-code-quality.md`
 
-// ⚠️ Warning - Constructor injection (valid but verbose)
-export class MyComponent {
-  constructor(private userService: UserService) {}
-}
-```
+**Critères évalués** :
+- Mode strict TypeScript et sûreté des types (5 pts)
+- Conformité ESLint (5 pts)
+- Signals et patterns Angular modernes (4 pts)
+- Principes KISS/DRY/YAGNI (4 pts)
+- Conventions de nommage et structure des fichiers (4 pts)
+- Détection de changement OnPush (3 pts)
 
-### 5. File Naming
+**Référence** : `check-code-quality.md`
 
-```
-✅ Compliant:
-- user-profile.component.ts
-- auth.service.ts
-- auth.guard.ts
-- date-format.pipe.ts
-
-❌ Non-compliant:
-- UserProfile.component.ts (PascalCase)
-- authService.ts (missing suffix)
-- AuthGuard.ts (PascalCase)
-```
+### Étape 4 : Audit Tests (25 points)
 
-## Scoring Criteria
+Exécuter la vérification des tests :
 
-| Category | Weight | Criteria |
-|----------|--------|----------|
-| Standalone Components | 20% | All components are standalone |
-| Signals Usage | 15% | Local state uses signals |
-| OnPush Strategy | 15% | All components use OnPush |
-| Modern Control Flow | 10% | @if/@for instead of *ngIf/*ngFor |
-| Typed Forms | 10% | Forms are strongly typed |
-| Naming Conventions | 10% | Correct file/class naming |
-| Import Organization | 10% | Imports properly ordered |
-| Documentation | 10% | Key components documented |
+**Commande** : Utiliser la commande slash `/angular:check-testing` ou suivre manuellement les étapes dans `check-testing.md`
 
-## Output Format
+**Critères évalués** :
+- Couverture du code (7 pts)
+- Tests unitaires pour les services et pipes (6 pts)
+- Tests de composants avec TestBed (4 pts)
+- Tests d'intégration (3 pts)
+- Tests E2E (3 pts)
+- Isolation des tests et mocks (2 pts)
+
+**Référence** : `check-testing.md`
+
+### Étape 5 : Audit Sécurité (25 points)
+
+Exécuter la vérification de sécurité :
+
+**Commande** : Utiliser la commande slash `/angular:check-security` ou suivre manuellement les étapes dans `check-security.md`
+
+**Critères évalués** :
+- Prévention XSS et DomSanitizer (6 pts)
+- Gestion des secrets et des identifiants (5 pts)
+- Validation et assainissement des entrées (4 pts)
+- Vulnérabilités des dépendances (4 pts)
+- Authentification et route guards (3 pts)
+- CSRF et intercepteurs HTTP (2 pts)
+- Content Security Policy (1 pt)
+
+**Référence** : `check-security.md`
+
+### Étape 6 : Consolidation et Score Global
+
+Calculer le score global et produire le rapport consolidé :
+- [ ] Additionner les 4 scores (max 100 points)
+- [ ] Identifier les catégories critiques (<50%)
+- [ ] Lister tous les problèmes transversaux critiques
+- [ ] Prioriser les actions par impact/effort
+- [ ] Produire le rapport final consolidé
+
+**Échelle de notation** :
+- 90-100 : Excellent - Projet de référence
+- 75-89 : Très bien - Quelques améliorations mineures
+- 60-74 : Acceptable - Des améliorations sont nécessaires
+- 40-59 : Insuffisant - Refactoring majeur requis
+- 0-39 : Critique - Refonte complète nécessaire
+
+### Étape 7 : Recommandations et Plan d'Action
+
+Produire les recommandations finales :
+- [ ] Identifier les 3 actions prioritaires dans toutes les catégories
+- [ ] Estimer l'effort (Faible/Moyen/Élevé) pour chaque action
+- [ ] Estimer l'impact (Faible/Moyen/Élevé) pour chaque action
+- [ ] Proposer un ordre d'implémentation
+- [ ] Suggérer des gains rapides (ratio impact/effort élevé)
+
+## FORMAT DE SORTIE
 
 ```
-══════════════════════════════════════════════════════════════
-ANGULAR COMPLIANCE REPORT
-══════════════════════════════════════════════════════════════
-
-📊 SCORE: 85/100
-
-✅ PASSING (6)
-──────────────────────────────────────────────────────────────
-• Standalone components: 100% (24/24 components)
-• OnPush strategy: 100% (24/24 components)
-• Typed forms: 100% (8/8 forms)
-• Import organization: 100%
-• File naming: 100%
-• Documentation: 90%
-
-⚠️ WARNINGS (2)
-──────────────────────────────────────────────────────────────
-• Modern control flow: 75% (18/24 templates)
-  - src/app/features/users/user-list.component.html:15 - Uses *ngFor
-  - src/app/shared/modal/modal.component.html:8 - Uses *ngIf
-
-• Signals usage: 80% (16/20 components with local state)
-  - src/app/features/auth/login.component.ts - Uses BehaviorSubject
-
-❌ ERRORS (1)
-──────────────────────────────────────────────────────────────
-• Constructor injection detected (prefer inject()):
-  - src/app/core/services/api.service.ts:15
-
-📋 RECOMMENDATIONS
-──────────────────────────────────────────────────────────────
-1. Migrate remaining *ngFor to @for with track
-2. Replace BehaviorSubject with signal() for local state
-3. Use inject() function instead of constructor injection
-
-══════════════════════════════════════════════════════════════
-```
+AUDIT DE CONFORMITÉ ANGULAR - RAPPORT COMPLET
+=============================================
+
+SCORE GLOBAL : XX/100
+
+NIVEAU DE CONFORMITÉ : [Excellent/Très bien/Acceptable/Insuffisant/Critique]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+SCORES PAR CATÉGORIE :
+
+ARCHITECTURE       : XX/25  [██████████░░░░░░░░░░] XX%
+QUALITÉ DU CODE    : XX/25  [██████████░░░░░░░░░░] XX%
+TESTS              : XX/25  [██████████░░░░░░░░░░] XX%
+SÉCURITÉ           : XX/25  [██████████░░░░░░░░░░] XX%
 
-## Automated Checks
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-Run these commands to verify compliance:
+POINTS FORTS GLOBAUX :
+1. [Point fort identifié dans plusieurs catégories]
+2. [Autre point fort majeur]
+3. [Troisième point fort]
 
-```bash
-# Lint check
-ng lint
+AMÉLIORATIONS GLOBALES :
+1. [Amélioration transversale mineure]
+2. [Autre amélioration recommandée]
+3. [Troisième amélioration]
 
-# Type check
-npx tsc --noEmit
+PROBLÈMES CRITIQUES :
+1. [Problème critique #1 - catégorie concernée]
+2. [Problème critique #2 - catégorie concernée]
+3. [Problème critique #3 - catégorie concernée]
 
-# Test coverage
-npm run test:ci
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-# Build check
-ng build --configuration=production
+DÉTAILS PAR CATÉGORIE :
+
+┌─────────────────────────────────────────────┐
+│ ARCHITECTURE (XX/25)                        │
+└─────────────────────────────────────────────┘
+
+Sous-scores :
+  • Modules pilotés par le domaine    : XX/6
+  • Composants standalone             : XX/6
+  • Lazy loading et routage           : XX/4
+  • Core/Shared/Feature               : XX/4
+  • Couche service                    : XX/3
+  • Injection de dépendances          : XX/2
+
+Points forts :
+- [Points forts d'architecture]
+
+Problèmes :
+- [Problèmes d'architecture]
+
+[Sections similaires pour Qualité du Code, Tests et Sécurité...]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+TOP 3 DES ACTIONS PRIORITAIRES (TOUTES CATÉGORIES) :
+
+1. CRITIQUE - [Action #1]
+   Catégorie  : [Architecture/Qualité/Tests/Sécurité]
+   Impact     : [Élevé/Moyen/Faible]
+   Effort     : [Élevé/Moyen/Faible]
+   Priorité   : IMMÉDIATE
+
+   Description détaillée :
+   [Explication du problème et solution proposée]
+
+   Fichiers concernés :
+   - [fichier:ligne]
+
+   Exemple de correction :
+   [Code ou commande de correction]
+
+2. IMPORTANT - [Action #2]
+   [Même format...]
+
+3. RECOMMANDÉ - [Action #3]
+   [Même format...]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+GAINS RAPIDES (Impact Élevé / Effort Faible) :
+
+- [Gain rapide #1] - Catégorie : [X] - Impact : [X] - Effort : [X]
+- [Gain rapide #2] - Catégorie : [X] - Impact : [X] - Effort : [X]
+- [Gain rapide #3] - Catégorie : [X] - Impact : [X] - Effort : [X]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+PLAN D'ACTION RECOMMANDÉ :
+
+SEMAINE 1 (Immédiat) :
+- [ ] [Action critique #1]
+- [ ] [Gain rapide prioritaire]
+
+SEMAINES 2-4 (Court terme) :
+- [ ] [Action importante #2]
+- [ ] [Autres gains rapides]
+
+MOIS 2-3 (Moyen terme) :
+- [ ] [Action recommandée #3]
+- [ ] [Améliorations progressives]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+RÉSUMÉ EXÉCUTIF :
+
+[Paragraphe de synthèse sur l'état global du projet, les principaux
+points forts, les principales faiblesses et la trajectoire recommandée
+pour améliorer la conformité. Mentionner si le projet est prêt pour
+la production, nécessite des corrections ou un refactoring.]
+
+Recommandation générale : [Prêt pour la production / Corrections mineures /
+Refactoring majeur / Refonte nécessaire]
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
-## Checklist
-
-- [ ] All components are standalone
-- [ ] All components use OnPush change detection
-- [ ] Local state uses signals (not BehaviorSubject)
-- [ ] Templates use @if/@for/@switch
-- [ ] Forms are typed (FormGroup<T>)
-- [ ] inject() used for dependency injection
-- [ ] File naming follows conventions
-- [ ] Imports are organized
-- [ ] Public API documented
-- [ ] Tests pass with >80% coverage
+## NOTES IMPORTANTES
+
+- Cette commande orchestre les 4 audits spécialisés
+- Utiliser Docker pour tous les outils d'analyse
+- Fournir des exemples concrets avec fichier:ligne pour chaque problème
+- Prioriser les actions selon la matrice Impact/Effort
+- Les problèmes de sécurité sont TOUJOURS prioritaires
+- Proposer des corrections automatisables (scripts, hooks pre-commit)
+- Le rapport doit être actionnable, pas seulement descriptif
+- Adapter les recommandations au contexte métier du projet