PD-31 — Décomposition Multi-agents¶

Vue d'ensemble¶

Story : PD-31 — Audit Log des Authentifications Branche : feature/PD-31-audit-log-auth Tâches : 15 Agents : agent-developer (Claude), agent-qa-unit-integration (Claude)

Tâches¶

T01 : Interfaces et types¶

Périmètre : - AuthAuditEvent interface (17 champs) - AuthEventType enum (8 valeurs) - Channel enum (3 valeurs) - AlertPattern enum (5 valeurs) - AlertSeverity enum (3 valeurs) - DTOs de base

T02 : Entités TypeORM¶

Périmètre : - AuthAuditLogEntity (table auth_audit_log, 20+ colonnes, 6 index) - AuthAlertLogEntity (table auth_alert_log) - AuthAlertConfigEntity (table auth_alert_config)

T03 : Migrations PostgreSQL¶

Périmètre : - Migration create tables (auth_audit_log, auth_alert_log, auth_alert_config) - Trigger append-only (trg_auth_audit_log_immutable) - Index optimisés - Configuration initiale des 5 patterns

T04 : AuthAuditNormalizerService¶

Périmètre : - Génération UUID v7 (event_id) - Normalisation timestamp UTC ms - Résolution GeoIP (pays, région) - Exclusion champs sensibles - Validation Zod

T05 : AuthAuditWriterService¶

Périmètre : - Canonicalisation JSON (RFC 8785) - Calcul hash chaîné (SHA3-256) - Advisory lock PostgreSQL - Transaction ACID insert - Émission événement audit.auth.logged

Invariants critiques : - INV-31-01 : Append-only garanti par trigger - INV-31-02 : Hash chaîné validé

T06 : RiskScoreService¶

Périmètre : - Calcul score [0.0, 1.0] - Règles chargées depuis Redis (cache) - Fallback si règles indisponibles - Performance < 0.5ms

T07 : AuthAuditProcessor (BullMQ)¶

Périmètre : - Worker BullMQ (concurrency: 1) - Pipeline : normaliser → score → persister → détecter → émettre - Gestion erreurs (retry, DLQ)

T08 : AlertDetectorService + 5 patterns¶

Périmètre : - Interface AlertPattern + 5 implémentations - BRUTEFORCE : > 5 failures / user_id / 5 min - CREDENTIAL_STUFFING : > 10 failures / ip / 1 min (distinct users) - GEO_HOPPING : 2 countries / user_id / 2 hours - DEVICE_ANOMALY : new device + failure - TOKEN_SPRAY : > 20 TOKEN_INVALID / 1 min - Fenêtre glissante Redis

T09 : AlertConfigService + AlertNotifier¶

Périmètre : - CRUD configuration seuils - Cache Redis (invalidation via événement) - Notification admin (via NotificationModule existant) - Journalisation alertes (auth_alert_log)

T10 : AuthAuditController¶

Périmètre : - POST /internal/v1/audit/auth-events (mTLS + JWT service) - GET /v1/audit/auth-events (JWT ADMIN/AUDITOR) - AuditAccessLogInterceptor - Pagination cursor-based

T11 : AuthAlertController¶

Périmètre : - PUT /v1/audit/auth-alerts/config/:patternCode - GET /v1/audit/auth-alerts - Validation DTO - Versioning config (optimistic lock)

T12 : JudicialExportService + Controller¶

Périmètre : - POST /v1/audit/auth-events/judicial-export - 6 artefacts obligatoires - Merkle path via MerkleModule existant - PARTIAL_PROOF avec warnings - Checksum SHA3-256 par artefact

T13 : AuthEventListener + Intégration auth¶

Périmètre : - EventSubscriber pour 8 événements auth.* - Envoi en queue BullMQ - Modifications auth services (EventEmitter2) - INV-31-08 : Traitement asynchrone uniquement

T14 : Modules NestJS + Guards¶

Périmètre : - AuthAuditModule (providers, exports, imports) - AuthAlertModule - AuthAuditApiModule - AuditAccessGuard (RBAC) - AuditAccessLogInterceptor - Registration AppModule

T15 : Tests unitaires et intégration¶

Périmètre : - TC-31-001..016 (unitaires) - TC-31-017..036 (intégration) - TC-31-037..044 (E2E) - TC-31-045..052 (performance) - Coverage >= 80%

Graphe de dépendances¶

T01 (interfaces)
 │
 ├──▶ T02 (entities) ──▶ T03 (migrations)
 │         │
 │         ├──▶ T05 (writer) ──────┐
 │         │                        │
 │         ├──▶ T08 (alerting) ────┤
 │         │                        │
 │         └──▶ T12 (export) ──────┤
 │                                  │
 ├──▶ T04 (normalizer) ────────────┤
 │                                  │
 └──▶ T06 (risk-score) ────────────┤
                                    │
      T07 (processor) ◀────────────┘
           │
           ├──▶ T09 (config + notifier)
           │
           ├──▶ T10 (audit controller)
           │
           ├──▶ T11 (alert controller)
           │
           └──▶ T13 (listener)
                    │
                    ▼
      T14 (modules) ──▶ T15 (tests)

Ordre d'exécution¶

Résumé¶

Décomposition générée par Claude (orchestrateur) dans le cadre du workflow de gouvernance ProbatioVault.