diff --git a/.planning/REQUIREMENTS.md b/.planning/REQUIREMENTS.md new file mode 100644 index 0000000..a84747e --- /dev/null +++ b/.planning/REQUIREMENTS.md @@ -0,0 +1,124 @@ +# Requirements: Leopost + +**Defined:** 2026-01-30 +**Core Value:** L'AI fa il lavoro sporco del social media manager — minimo sforzo, massima resa + +## v1 Requirements + +Requirements per il rilascio iniziale. Ogni requirement mappa a fasi della roadmap. + +### Authentication + +- [ ] **AUTH-01**: Utente può registrarsi con email/password +- [ ] **AUTH-02**: Utente può accedere con Google OAuth +- [ ] **AUTH-03**: Sistema supporta 3 piani (Free, Creator, Pro) con limiti configurabili +- [ ] **AUTH-04**: Utente può collegare account Facebook tramite OAuth + +### Onboarding + +- [ ] **ONBR-01**: Wizard raccoglie info base (nome attività, settore, descrizione) +- [ ] **ONBR-02**: Contesto utente persiste tra sessioni (memoria) + +### AI Chat + +- [ ] **CHAT-01**: Interfaccia chat come esperienza principale dell'app +- [ ] **CHAT-02**: Utente può scegliere modello AI (GPT, Claude, Gemini) +- [ ] **CHAT-03**: AI propone azioni suggerite dopo completamento onboarding +- [ ] **CHAT-04**: AI memorizza e impara preferenze utente nel tempo + +### Content Generation + +- [ ] **CONT-01**: AI genera post testuali su richiesta dell'utente +- [ ] **CONT-02**: AI genera immagini per i post +- [ ] **CONT-03**: AI crea piano editoriale (calendario contenuti suggeriti) + +### Scheduling & Publishing + +- [ ] **SCHD-01**: Utente può programmare post con data/ora specifica +- [ ] **SCHD-02**: Post vengono pubblicati automaticamente su Facebook +- [ ] **SCHD-03**: Utente può configurare livello automazione (da approval a autopilot) +- [ ] **SCHD-04**: Calendario editoriale visuale mostra post programmati + +### Messaging Integration + +- [ ] **MSGN-01**: Utente può inviare comandi via Telegram bot +- [ ] **MSGN-02**: Utente può inviare comandi via WhatsApp bot + +## v2 Requirements + +Deferred per release future. Tracciati ma non nella roadmap corrente. + +### Authentication + +- **AUTH-05**: Utente può accedere con Facebook OAuth +- **AUTH-06**: Utente può accedere con LinkedIn OAuth +- **AUTH-07**: Utente può accedere con Instagram OAuth + +### Social Platforms + +- **SOCL-01**: Utente può collegare e pubblicare su Instagram +- **SOCL-02**: Utente può collegare e pubblicare su LinkedIn +- **SOCL-03**: Utente può collegare e pubblicare su YouTube +- **SOCL-04**: Utente può collegare e pubblicare su TikTok +- **SOCL-05**: Utente può collegare e pubblicare su X (Twitter) + +### Onboarding Extended + +- **ONBR-03**: Wizard raccoglie brand kit (logo, colori, font) +- **ONBR-04**: Wizard raccoglie siti web e link +- **ONBR-05**: Wizard raccoglie target audience e zona geografica + +### Content Generation Extended + +- **CONT-04**: AI adatta tono/lunghezza/hashtag per piattaforma specifica +- **CONT-05**: Utente può fornire template grafici come base +- **CONT-06**: AI genera video (oltre a immagini) + +## Out of Scope + +Esclusi esplicitamente. Documentati per prevenire scope creep. + +| Feature | Reason | +|---------|--------| +| App native iOS/Android | Architettura headless pronta, ma web-first per v1 | +| Dashboard analytics avanzate | Focus su creazione/pubblicazione, non analytics | +| Social listening | Complessità elevata, non core per freelance | +| Influencer marketplace | Fuori target (freelance, non brand) | +| White-label | Enterprise feature, non micro-SaaS | +| Video editing integrato | Complessità, costi storage/bandwidth | +| Gestione ads/campagne | Fuori scope, focus su contenuti organici | + +## Traceability + +Quali fasi coprono quali requirements. Aggiornato durante creazione roadmap. + +| Requirement | Phase | Status | +|-------------|-------|--------| +| AUTH-01 | TBD | Pending | +| AUTH-02 | TBD | Pending | +| AUTH-03 | TBD | Pending | +| AUTH-04 | TBD | Pending | +| ONBR-01 | TBD | Pending | +| ONBR-02 | TBD | Pending | +| CHAT-01 | TBD | Pending | +| CHAT-02 | TBD | Pending | +| CHAT-03 | TBD | Pending | +| CHAT-04 | TBD | Pending | +| CONT-01 | TBD | Pending | +| CONT-02 | TBD | Pending | +| CONT-03 | TBD | Pending | +| SCHD-01 | TBD | Pending | +| SCHD-02 | TBD | Pending | +| SCHD-03 | TBD | Pending | +| SCHD-04 | TBD | Pending | +| MSGN-01 | TBD | Pending | +| MSGN-02 | TBD | Pending | + +**Coverage:** +- v1 requirements: 19 total +- Mapped to phases: 0 +- Unmapped: 19 ⚠️ + +--- +*Requirements defined: 2026-01-30* +*Last updated: 2026-01-30 after initial definition*