docs: document order cancellation, employee code and unverified login rules

This commit is contained in:
Jérémy Munsch 2026-11-15 18:25:49 +01:00
parent 5491c4fc30
commit 570c1e54d5
No known key found for this signature in database
GPG key ID: 2AAECDA6B7330F91

View file

@ -46,3 +46,30 @@ Elle est vérifiée côté Domaine par `Shopper::isActive()` et côté Eloquent
- En base de données, `end_date` est stockée au format `DATE` (interprétée à `00:00:00`).
- Le salarié est actif uniquement si `end_date` est `null` ou strictement supérieure à la date/heure actuelle (`end_date > now`).
- **Comportement assumé** : le salarié devient donc inactif dès le début de son dernier jour renseigné (`end_date` à `00:00:00`).
## 5. Annulation de Commande (Back-Office)
Elle est gérée côté Domaine par `Domain\Services\OrderService::cancelOrder()`.
- **Comportement assumé** : l'annulation d'une commande depuis le Back-Office met uniquement à jour son statut en base de données (`cancel()` puis `persist()`) sans émettre d'événement de domaine ni envoyer d'e-mail ou de notification à Régate ou au client.
## 6. Code d'Accès Salarié & Inscription
La génération des codes d'accès salariés est gérée par `App\Services\CodeGenerationService` et leur validation à l'inscription par `App\Http\Requests\Fo\Auth\RegisterRequest`.
- **Génération déterministe du code** :
- Chaque code d'accès (`Code`, longueur `7`) est dérivé de façon déterministe à partir du `matricule` du salarié via `SerialCasterBuilder` (`Code::ALLOWED_CHARACTERS`, `Code::LENGTH`). Il ne s'agit pas d'un secret aléatoire, mais d'un code d'appariement court lié au matricule.
- **Validation à l'inscription (`RegisterRequest`)** :
- L'existence d'un `matricule` non encore associé à un compte client (`employees.customer_id IS NULL`) est validée explicitement (`Rule::exists('employees', 'matricule')->whereNull('customer_id')`), séparément de la règle sur `code` (`Rule::exists('employees', 'code')->where('matricule', ...)->whereNull('customer_id')`).
- Les messages d'erreur distincts entre « matricule inconnu / déjà utilisé » et « code incorrect » sont assumés pour faciliter le support utilisateur, les routes d'authentification étant protégées par un rate limiter (`throttle`).
## 7. Connexion d'un Compte Non Activé (CRM & `laravel/ui`)
Elle est gérée par `App\Auth\CrmUserProvider::validateCredentials()` et `App\Http\Controllers\Fo\Auth\LoginController::authenticated()`.
- **Validation CRM (`CrmService::login()`)** :
- L'API CRM (`Api\V4\CustomerController::authenticate()`) vérifie **d'abord** le mot de passe (`ApiError::authFailed`) avant de vérifier si le compte est activé (`ApiError::customerNotActivated` → `CrmCustomerNotActivatedException`).
- **Alignement sur `laravel/ui` (`VerificationController`)** :
- Conformément au fonctionnement standard de `laravel/ui`, `VerificationController` requiert une session authentifiée (`auth:frontend`) pour accéder aux routes `email/verify`, `email/verify/{id}/{hash}` et `email/resend`.
- Lorsqu'un client saisit le **bon mot de passe** sur un compte non encore activé, `CrmUserProvider::validateCredentials()` intercepte `CrmCustomerNotActivatedException`, renvoie l'e-mail de vérification et retourne `true` afin d'ouvrir la session et de laisser le middleware `verified` (`EnsureCustomerEmailIsVerified`) rediriger vers `fo.auth.verification.notice`.
- En revanche, `LoginController::authenticated()` ne flashe le message `"You are logged in!"` que si l'e-mail du client est déjà vérifié (`AppCustomerAuthService::hasVerifiedEmail()`).