69 lines
2.8 KiB
Markdown
69 lines
2.8 KiB
Markdown
# Requirements: ClientHub v2.3 Email & Accesso
|
|
|
|
**Defined:** 2026-06-21
|
|
**Core Value:** Il cliente apre il link e vede esattamente a che punto è il suo progetto, cosa deve ancora succedere e cosa ha già approvato — senza dover scrivere email per chiedere aggiornamenti.
|
|
|
|
## v2.3 Requirements
|
|
|
|
### Email OTP Gate (AUTH-OTP-01)
|
|
|
|
Portale cliente blindato da email OTP. Nuovo `client_emails` table (whitelist) + `otp_codes` table (codice, email, expires_at, consumed). Resend come provider email. Sessione 30gg con cookie dopo verifica.
|
|
|
|
- [ ] **OTP-01**: Admin può aggiungere e rimuovere email dalla whitelist di ogni cliente nell'admin UI
|
|
- [ ] **OTP-02**: Cliente senza sessione OTP vede una schermata "inserisci email" invece della dashboard
|
|
- [ ] **OTP-03**: Sistema invia OTP via Resend solo se l'email inserita è nella whitelist di quel cliente
|
|
- [ ] **OTP-04**: Cliente inserisce il codice OTP ricevuto e ottiene sessione autenticata (cookie 30 giorni)
|
|
- [ ] **OTP-05**: Codici OTP scadono dopo 15 minuti dall'invio
|
|
- [ ] **OTP-06**: Endpoint OTP è rate-limited per prevenire brute force
|
|
- [ ] **OTP-07**: Messaggi di errore OTP non rivelano se l'email è in whitelist o no (no enumeration)
|
|
|
|
### Invio Link Preventivo via Email (PUB-03)
|
|
|
|
Admin invia link deck pubblico al lead direttamente dall'admin UI. Usa stessa infrastruttura Resend del OTP gate.
|
|
|
|
- [ ] **SEND-01**: Admin può inviare link `/preventivo/[slug]` via email al lead con un'azione dall'admin UI
|
|
- [ ] **SEND-02**: Email inviata via Resend include link deck + nome cliente, template minimale in italiano
|
|
|
|
## v2.4+ Backlog
|
|
|
|
### Conversione Commerciale
|
|
|
|
- **PROP-03**: Stripe Payment Link su deck pubblico `/preventivo/[slug]`
|
|
- **PROP-04**: Auto-provisioning cliente/progetto/fasi al "Vinto" nel CRM
|
|
|
|
### Post-Vendita
|
|
|
|
- **Phase 13**: Gestione servizi attivi/ricorrenti post-vendita nel portale cliente (congelata da v2.1)
|
|
|
|
## Out of Scope
|
|
|
|
| Feature | Reason |
|
|
|---------|--------|
|
|
| Self-registration cliente | Solo whitelist admin-gestita — nessun accesso senza approvazione esplicita |
|
|
| Magic link senza OTP | OTP è più sicuro e già deciso come design; magic link = scope creep |
|
|
| Email marketing / newsletter | Non pertinente al portale |
|
|
| Multi-admin | Ancora single admin per ora |
|
|
|
|
## Traceability
|
|
|
|
| Requirement | Phase | Status |
|
|
|-------------|-------|--------|
|
|
| OTP-01 | Phase 24 | Pending |
|
|
| OTP-02 | Phase 25 | Pending |
|
|
| OTP-03 | Phase 25 | Pending |
|
|
| OTP-04 | Phase 25 | Pending |
|
|
| OTP-05 | Phase 25 | Pending |
|
|
| OTP-06 | Phase 25 | Pending |
|
|
| OTP-07 | Phase 25 | Pending |
|
|
| SEND-01 | Phase 23 | Pending |
|
|
| SEND-02 | Phase 23 | Pending |
|
|
|
|
**Coverage:**
|
|
- v2.3 requirements: 9 total
|
|
- Mapped to phases: 9
|
|
- Unmapped: 0 ✓
|
|
|
|
---
|
|
*Requirements defined: 2026-06-21*
|
|
*Last updated: 2026-06-21 — traceability filled after roadmap creation*
|