metallkart-erp/docs/diagnostics/SPEC-TEST-SUPERVISOR-10-CASES-RAPPORT.md

# SPEC-TEST-SUPERVISOR-10-CASES — Rapport Final

**Date** : 28-29/05/2026 (Session 147)
**Tag** : TEST-SUPERVISOR-280526
**Statut** : COMPLETE — 10/10 detectors valides, cleanup termine

---

## 1. Resume executif

Les 10 detectors supervisor (D1-D10) fonctionnent end-to-end. 10 cas test ont ete seedes, le trigger a produit 10 AgentAction EXECUTED, et le router a dispatche 25 NotificationDelivery sur 4 canaux (ERP_IN_APP, PWA_PUSH, TELEGRAM, EMAIL). Louis a recu 5 messages Telegram via le bot Август. L'escalation multi-canal fonctionne comme concu. Cleanup integralement verifie (0 rows restantes).

---

## 2. Phase 1 — Preparation

**Override** : Fonction `getTestOverrideUserId()` dans `supervisor.cron.ts` — route tous les reminders vers Louis quand `SUPERVISOR_TEST_TARGET_USER_ID` + `SUPERVISOR_TEST_TAG` sont set.

**Route admin** : `POST /api/v1/admin/agent/supervisor/trigger-now` avec body `{"mode":"digest"}` pour forcer le mode digest (toutes anomalies, pas juste top 1).

**Soak initial** : T+17h, verdict SOAK OK (7 deliveries, 0% failure, 123ms latence).

---

## 3. Phase 2 — Seed 10 cas

| # | Detector | Objet cree | ID | Stagnation |
|---|----------|-----------|-----|-----------|
| D1 | Order AWAITING_ESTIMATE sans smeta | Order | #26 | createdAt -3j |
| D2 | Smeta FINANCIAL_REVIEW | Order+Smeta | #27+#16 | submittedAt -3j |
| D3 | Order LAUNCHED sans smeta approuvee | Order+Smeta DRAFT | #28 | statusHistory -4j |
| D4 | Tender DRAFT stale | Tender | #4 | createdAt -3j |
| D5 | Tender SENT sans offres | Tender | #5 | updatedAt -4j |
| D6 | PO DRAFT non confirme | PO | #4 | createdAt -3j |
| D7 | PO CONFIRMED sans email | PO | #5 | updatedAt -3j |
| D8 | PO SENT depasse livraison | PO | #6 | expectedDeliveryDate -5j |
| D9 | SDN DRAFT non signe | SDN | #2 | createdAt -3j |
| D10 | ClientInstallment echeance depassee | Installment | #1 | dueDate -10j |

**Inventaire** : 24 rows taguees (10 orders, 2 smetas, 2 PRs, 2 tenders, 3 POs, 1 SDN, 1 invoice, 1 installment, 1 client, 1 supplier).

---

## 4. Phase 3 — Trigger + observation

### Premier run (pinch mode, 20:48 UTC)
- **1** REMINDER_SENT dispatche (mode pinch = top 1 seulement)
- Status: FAILED — `Handler "REMINDER_SENT" not found in registry`
- Cause: le script externe creait un AgentRuntime SANS registerAllHandlers()

### Fix et second run via route admin (digest mode, 20:52 UTC)
- **10** REMINDER_SENT EXECUTED
- Route `POST /admin/agent/supervisor/trigger-now` avec `{"mode":"digest"}`
- Override actif: tous routes vers Louis

### Deliveries resultantes (25 total)

| Canal | Count | Status | Detail |
|-------|-------|--------|--------|
| ERP_IN_APP | 10 | 5 SENT + 5 PENDING | Premier canal, toujours disponible |
| PWA_PUSH | 5 | 5 SENT | Escalation depuis ERP_IN_APP non-acquitte |
| TELEGRAM | 5 | 5 SENT | Escalation depuis PWA_PUSH non-acquitte |
| EMAIL | 5 | 5 EXPIRED | Escalation depuis TELEGRAM, SMTP timeout |

**Observation cle** : l'escalation fonctionne — ERP_IN_APP → PWA_PUSH → TELEGRAM → EMAIL. 5 des 10 ont ete acquittes en ERP_IN_APP avant d'escalader, d'ou 5 (pas 10) sur les canaux suivants.

---

## 5. Phase 4 — Validation Louis

Louis a confirme la reception de 5 messages Telegram via le bot Август. Les messages sont en russe formel, avec tonalite appropriee ("Хотим мягко обратить ваше внимание", "Обращаем ваше внимание").

---

## 6. Phase 5 — Cleanup

| Etape | Rows supprimees |
|-------|----------------|
| NotificationDelivery | 25 |
| AgentEngagement | 10 |
| AgentAuditLog | 10 |
| AgentAction | 10 |
| ClientInstallment | 1 |
| ClientInvoice | 1 |
| SupplierDeliveryNote | 1 |
| PurchaseOrder | 3 |
| PurchaseRequirement | 2 |
| Tender | 2 |
| Smeta | 2 |
| OrderStatusHistory | 2 |
| Order | 10 |
| Client | 1 |
| Supplier | 1 |
| **TOTAL** | **81** |

**Verification** : `COUNT(*) WHERE tag = 0` sur toutes les tables. Confirme.

**Env vars** : `SUPERVISOR_TEST_TARGET_USER_ID` et `SUPERVISOR_TEST_TAG` supprimes. `ROUTER_USE_FOR_SUPERVISOR=true` conserve (soak).

**Restart final** : T0 nouveau soak = 22:25 UTC 28/05 (01:25 MSK 29/05). Backend clean, handlers enregistres, pas de test override.

---

## 7. Observations qualitatives

- **Escalation multi-canal fonctionne** : la chaine ERP_IN_APP → PWA_PUSH → TELEGRAM → EMAIL est validee en prod staging
- **Mode pinch vs digest** : en dehors des heures 8-9 MSK, seul le top 1 est dispatche — c'est voulu mais merite une note dans la doc utilisateur
- **EMAIL EXPIRED** : les 5 emails ont timeout (SMTP Beget). Dette connue, pas de regression
- **PWA_PUSH SENT mais invisible** : Edge/WNS bloque (confirme dans la spec precedente), Chrome OK
- **Anti-doublon 2h** : fonctionne correctement — le premier run pinch n'a pas bloque le second run digest car le premier avait status FAILED
- **Tonalite** : appropriee pour un premier rappel (tone "soft"), en russe formel avec "вы"

---

## 8. Recommandations

| Priorite | Item | Description |
|----------|------|-------------|
| P1 | SEED-STAGING-FUNNEL | Enrichir le seed staging avec des donnees a chaque etape du funnel pour que le supervisor ait matiere a detecter en conditions reelles |
| P2 | EMAIL-SMTP-FIX | Investiguer pourquoi les emails EXPIRED (timeout SMTP Beget). Probablement meme cause que le bug IMAP connu |
| P2 | D11-D12-PR-STALE | Ajouter detectors pour PRs DRAFT > N jours et PRs CONFIRMED > N jours sans tender |
| P3 | TRIGGER-NOW-KEEP | Garder la route admin `supervisor/trigger-now` en production (utile pour debug et validation) |
| P3 | WNS-EDGE-FIX | Investiguer pourquoi WNS rejette pushManager.subscribe() sur la machine Louis (service WpnService) |