PD-32 — Plan d'implémentation¶

1. Découpage en composants¶

1.1 Nouveaux composants¶

1.2 Composants modifiés¶

1.3 Composants réutilisés (sans modification)¶

2. Flux techniques¶

2.1 GET /user/profile (F-32-01)¶

1. Client → GET /user/profile (Header: Authorization: Bearer <JWT>)
2. AuthenticationGuard → Valide JWT, extrait userId (sub claim)
3. RateLimitGuard → Vérifie seuil global
4. RlsMiddleware → SET LOCAL app.current_user_id = userId
5. UserProfileController.getProfile(@CurrentUser() user)
6. UserProfileService.getProfile(userId)
   6.1 SELECT name, email, avatar_url, preferences FROM users WHERE id = userId
   6.2 (RLS filtre automatiquement sur current_user_id)
7. Transformation → UserProfileResponseDto (exclut champs sensibles)
8. Response 200 → { name, email, avatar_url, preferences }

2.2 PUT /user/profile (F-32-02)¶

1. Client → PUT /user/profile (Header: Authorization, Body: UpdateUserProfileDto)
2. AuthenticationGuard → Valide JWT, extrait userId
3. ValidationPipe → Valide UpdateUserProfileDto
   3.1 Si champ protégé présent (forbidNonWhitelisted: true rejecte) → 400 ERR-32-PROTECTED-FIELD
   3.2 Si preferences non conforme au schéma → 400 ERR-32-VALIDATION
   3.3 Si avatar_url non https ou > 2048 chars → 400 ERR-32-VALIDATION
4. RateLimitGuard → Vérifie seuil global
5. RlsMiddleware → SET LOCAL app.current_user_id = userId
6. UserProfileController.updateProfile(@CurrentUser(), @Body() dto)
7. UserProfileService.updateProfile(userId, dto)
   7.1 UPDATE users SET name=?, avatar_url=?, preferences=? WHERE id = userId
   7.2 (RLS filtre automatiquement)
8. Transformation → UserProfileResponseDto
9. Response 200 → { name, email, avatar_url, preferences }

2.3 Diagrammes Mermaid¶

Graphe de dépendances des composants¶

graph TD
    Client([Client HTTP])

    subgraph NestJS Pipeline
        AG[AuthenticationGuard]
        RLG[RateLimitGuard]
        RLS[RlsMiddleware]
        VP[ValidationPipe]
    end

    subgraph UserModule
        UPC[UserProfileController]
        UPS[UserProfileService]
        UUPD[UpdateUserProfileDto]
        UPRD[UserProfileResponseDto]
        UPD[UserPreferencesDto]
    end

    subgraph Shared
        CU["@CurrentUser()"]
        EF[ExceptionFilter]
    end

    subgraph Persistence
        UE[User Entity]
        PG[(PostgreSQL + RLS)]
    end

    Client --> AG
    AG --> RLG
    RLG --> RLS
    RLS --> UPC
    UPC --> UPS
    UPC -.-> CU
    UPC -.-> VP
    VP -.-> UUPD
    VP -.-> UPD
    UPS --> UE
    UPS --> UPRD
    UE --> PG
    RLS --> PG
    EF -.-> UPC

    UUPD --> UPD

    style AG fill:#f9d71c,stroke:#333
    style RLG fill:#f9d71c,stroke:#333
    style RLS fill:#f9d71c,stroke:#333
    style VP fill:#f9d71c,stroke:#333
    style PG fill:#4a90d9,stroke:#333,color:#fff

Diagramme de séquence — PUT /user/profile (F-32-02)¶

sequenceDiagram
    participant C as Client
    participant AG as AuthenticationGuard
    participant RLG as RateLimitGuard
    participant VP as ValidationPipe
    participant RLS as RlsMiddleware
    participant Ctrl as UserProfileController
    participant Svc as UserProfileService
    participant DB as PostgreSQL (RLS)

    C->>AG: PUT /user/profile (JWT + Body)
    AG->>AG: Valide JWT, extrait userId
    alt JWT invalide
        AG-->>C: 401 ERR-32-UNAUTHENTICATED
    end

    AG->>VP: Payload → UpdateUserProfileDto
    VP->>VP: whitelist + forbidNonWhitelisted
    alt Champ protégé présent
        VP-->>C: 400 ERR-32-PROTECTED-FIELD
    end
    VP->>VP: @ValidateNested → UserPreferencesDto
    alt Validation échouée
        VP-->>C: 400 ERR-32-VALIDATION
    end

    VP->>RLG: Requête validée
    alt Seuil dépassé
        RLG-->>C: 429 ERR-32-RATE-LIMIT
    end

    RLG->>RLS: Requête autorisée
    RLS->>DB: SET LOCAL app.current_user_id = userId

    RLS->>Ctrl: getProfile(@CurrentUser)
    Ctrl->>Svc: updateProfile(userId, dto)
    Svc->>DB: UPDATE users SET name, avatar_url, preferences WHERE id = userId
    Note over DB: RLS filtre automatiquement sur current_user_id
    DB-->>Svc: Updated row
    Svc->>Svc: Transformation → UserProfileResponseDto
    Note over Svc: @Exclude() supprime passwordHash, srpSalt, etc.
    Svc-->>Ctrl: UserProfileResponseDto
    Ctrl-->>C: 200 { name, email, avatar_url, preferences }

3. Mapping invariants → mécanismes¶

4. Mapping critères d'acceptation → mécanismes¶

5. Mapping tests (TC-*) → mécanismes + observables¶

Note test acces croise (TC-ERR-03/04) : Les tests TC-ERR-03/04 verifient l'isolation RLS en creant deux utilisateurs U1 et U2 en base, puis en executant une requete avec le contexte RLS de U1 tout en verifiant que les donnees de U2 ne sont jamais exposees ni modifiees. Le test controle l'etat de U2 avant/apres via SELECT direct.

6. Gestion des erreurs¶

6.1 Format de réponse d'erreur¶

{
  "error": "ERR-32-XXX",
  "message": "Description lisible"
}

6.2 Mapping codes erreur¶

6.3 ExceptionFilter dédié¶

Un ExceptionFilter (global ou dédié UserProfileExceptionFilter) DOIT mapper les exceptions vers le format contractuel {error: ERR-32-*, message}. La verification de ce mapping fait partie des tests TC-INV-02.

7. Impacts sécurité¶

7.1 Risques et mitigations¶

7.2 Journalisation¶

• Toute mise à jour profil → log d'audit (userId, champs modifiés, timestamp)
• Erreurs 4xx/5xx → log avec contexte (userId, payload sanitisé)

7.3 Conformité¶

• RGPD Art. 15 (droit d'accès) : satisfait par GET /user/profile
• RGPD minimisation : satisfait par UserProfileResponseDto (exclusion champs sensibles)
• Preuve juridique exhaustive : hors périmètre PD-32

8. Hypothèses techniques¶

9. Points de vigilance (risques, dette, pièges)¶

9.1 Risques¶

• Migration existante : S'assurer que les utilisateurs existants ont des valeurs par défaut valides (name=null, avatar_url=null, preferences={})
• Serialization : Vérifier que ClassSerializerInterceptor est bien appliqué globalement
• Nested validation : class-validator nécessite @Type(() => NestedDto) pour valider les objets imbriqués

9.2 Dette technique¶

• Les préférences sont un schéma ouvert côté évolution — tout ajout nécessite modification DTO

9.3 Pièges courants¶

• Oublier de vérifier que ClassSerializerInterceptor est appliqué globalement
• Oublier @ValidateNested() sur le champ preferences
• Oublier @Type(() => UserPreferencesDto) pour la transformation
• Ne pas appliquer les guards dans le bon ordre (Auth → RateLimit → logique)

10. Hors périmètre¶

• Gestion MFA (PD-27)
• Changement de mot de passe
• Suppression de compte
• Logout / sessions (PD-30)
• Modification email (flux de revalidation)
• Modification plan (flux facturation)
• Upload fichier avatar
• Preuve RGPD exhaustive (artefact conformité externe)