933c6496b1
Permet de faire vivre Rubis en accéléré pour démontrer le produit à des
prospects, SANS impacter la prod. Les vrais users ont demoMode=false par
défaut → toute la logique démo est court-circuitée.
Architecture (priorité : zéro impact prod, codebase propre)
Phase 1 — Abstraction Clock
- Migration : organizations.demo_mode + virtual_now + demo_speed_factor
(défaut false/null/1, zéro effet sur les orgs existantes)
- services/clock.ts : now(orgId?) → DateTime.utc() en prod, virtualNow
en démo. Cache mémoire 250ms pour pas spammer la DB. Helpers
setVirtualNow / setDemoMode pour les transitions.
- Refacto 7 fichiers : relance_scheduler, checkin_scheduler, dashboard,
send_relance_job, send_checkin_job, mail_dispatcher (buildRelanceVars
daysLate), activity_recorder, checkin_controller, invoices_controller
(buildTimeline + markPaid). DateTime.now() → clock.now(orgId).
- Tests existants (51) passent identique → preuve que la prod est intacte.
Phase 2 — Capture emails + dispatch
- Migration : demo_captured_emails (kind, to, from, subject, body, sent_at,
meta) — index sur (org, sent_at desc) pour l'inbox.
- services/demo/capture.ts : captureEmailIfDemo() — UNIQUE point de fork
dans la prod (deux lignes dans mail_dispatcher : if captured return).
Hors démo, fonction retourne false → flux Resend inchangé.
- services/demo/dispatch.ts : tickAndDispatch(orgId, target) → bump
virtual_now, trouve les tasks dues (relance + checkin), invoke les
handlers existants synchronement (skip BullMQ, propre). Retourne les
events fired pour l'UI.
- POST /api/v1/demo/{start,end,tick} + GET /demo/{state,inbox}, toutes
protégées par requireDemoOrg() (403 si demoMode=false).
Phase 3 — UI horloge "vivante"
- lib/demo.ts : useDemoState, useDemoTick (boucle rAF locale qui avance
virtualNow à `speed * elapsed` jours/sec, sync backend toutes les
250ms, auto-pause sur fired events). Pas de boutons +1j/+3j —
l'horloge tourne vraiment.
- DemoClock (top-right, fixed) : date pleine en font display, rail
rubis-glow avec pastille ◆ qui glisse vers le prochain event,
play/pause + sélecteur 1x/2x/5x. Auto-cachée si demoMode=false.
- DemoEmailSlide : slide-over droite quand event fires — affiche
l'email capturé (de/à/sujet/body) façon vrai client mail. Pause
forcée tant que tous les events ne sont pas acquittés ("comme si
le temps était vraiment passé").
- DemoToggle dans /parametres : démarrer/quitter le mode démo, avec
copy explicite ("emails capturés, pas envoyés à de vrais clients").
Le code démo vit isolé dans services/demo/, controllers/demo_controller.ts,
components/demo/, lib/demo.ts. La prod ne référence ces fichiers QUE
via captureEmailIfDemo dans mail_dispatcher.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
49 lines
1.5 KiB
TypeScript
49 lines
1.5 KiB
TypeScript
import DemoCapturedEmail from '#models/demo_captured_email'
|
|
import * as clock from '#services/clock'
|
|
import Organization from '#models/organization'
|
|
|
|
/**
|
|
* Service de capture d'emails en mode démo.
|
|
*
|
|
* Tout le code "démo" vit dans `services/demo/*` — la prod ne référence
|
|
* qu'une seule fonction (`captureEmailIfDemo`) depuis `mail_dispatcher`,
|
|
* pour minimiser le couplage.
|
|
*
|
|
* Si l'org est en mode démo : crée une `DemoCapturedEmail` avec le
|
|
* timestamp virtualNow et retourne `true` → caller doit ne PAS envoyer
|
|
* via Resend.
|
|
*
|
|
* Sinon : retourne `false` → comportement prod inchangé.
|
|
*/
|
|
export type CaptureInput = {
|
|
organizationId: string
|
|
kind: 'relance' | 'checkin'
|
|
to: { email: string; name?: string | null }
|
|
from: { email: string; name?: string | null }
|
|
replyTo?: string | null
|
|
subject: string
|
|
body: string
|
|
meta?: Record<string, unknown>
|
|
}
|
|
|
|
export async function captureEmailIfDemo(input: CaptureInput): Promise<boolean> {
|
|
const org = await Organization.find(input.organizationId)
|
|
if (!org || !org.demoMode) return false
|
|
|
|
const sentAt = await clock.now(input.organizationId)
|
|
await DemoCapturedEmail.create({
|
|
organizationId: input.organizationId,
|
|
kind: input.kind,
|
|
toEmail: input.to.email,
|
|
toName: input.to.name ?? null,
|
|
fromEmail: input.from.email,
|
|
fromName: input.from.name ?? null,
|
|
replyTo: input.replyTo ?? null,
|
|
subject: input.subject,
|
|
body: input.body,
|
|
meta: input.meta ?? {},
|
|
sentAt,
|
|
})
|
|
return true
|
|
}
|