docs: document order cancellation, employee code and unverified login rules
This commit is contained in:
parent
5491c4fc30
commit
570c1e54d5
1 changed files with 27 additions and 0 deletions
|
|
@ -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()`).
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue