# Leopost

## What This Is

Leopost è un micro-SaaS di social media management potenziato da AI, pensato per freelance e solopreneur italiani. L'utente configura il proprio brand una volta, poi l'AI genera, schedula e pubblica contenuti sui social in autonomia. L'interfaccia principale è una chat con l'assistente AI, supportata da schermate per calendario e impostazioni.

## Core Value

L'AI fa il lavoro sporco del social media manager: l'utente investe poco tempo nella configurazione iniziale e ottiene contenuti pubblicati automaticamente sui propri canali, con qualità che migliora nel tempo man mano che l'AI impara le sue preferenze.

## Requirements

### Validated

(None yet — ship to validate)

### Active

**Onboarding & Brand Context**
- [ ] Wizard di onboarding progressivo (info essenziali subito, resto nel tempo)
- [ ] Raccolta brand kit (loghi, colori, font)
- [ ] Raccolta info azienda/freelance (settore, target, zona geografica, siti web)
- [ ] Memoria persistente del contesto utente

**Autenticazione & Account**
- [ ] Registrazione/login utente
- [ ] 3 piani: Free, Creator, Pro (limiti da definire post-testing)
- [ ] Collegamento account social (Facebook, Instagram, LinkedIn)

**Chat AI**
- [ ] Interfaccia chat come esperienza principale
- [ ] Scelta modello AI (ChatGPT, Claude, Gemini)
- [ ] Suggerimenti azioni iniziali post-onboarding
- [ ] L'AI impara le preferenze utente nel tempo (feedback + analisi comportamento)

**Generazione Contenuti**
- [ ] Generazione post testuali adattati per piattaforma (tono, lunghezza, hashtag)
- [ ] Generazione immagini AI
- [ ] Supporto template grafici utente
- [ ] Creazione piano editoriale

**Scheduling & Pubblicazione**
- [ ] Scheduling post con data/ora
- [ ] Pubblicazione automatica sui social collegati
- [ ] Livelli automazione configurabili (approval → autopilot)

**Calendario & Visualizzazione**
- [ ] Calendario editoriale visuale con post programmati

**Integrazioni Messaging**
- [ ] Integrazione Telegram per comandi testuali/vocali
- [ ] Integrazione WhatsApp per comandi testuali/vocali

### Out of Scope

- App native iOS/Android — architettura headless pronta, ma web-first per v1
- Video generation — solo immagini per v1, video in futuro
- Social aggiuntivi (YouTube, TikTok, X) — solo Facebook, Instagram, LinkedIn per v1
- Dashboard analytics avanzate — focus su creazione/pubblicazione, non analytics

## Context

**Target primario**: Freelance e solopreneur italiani che gestiscono i propri social personalmente. Non hanno tempo o competenze per fare content marketing professionale, ma sanno che devono essere presenti sui social.

**Problema che risolve**: Creare contenuti social richiede tempo, creatività e costanza. La maggior parte dei freelance inizia con entusiasmo, poi abbandona. Leopost elimina l'attrito: l'AI fa il lavoro creativo e operativo.

**Modello mentale**: L'utente "assume" un social media manager AI. All'inizio supervisiona il lavoro, poi si fida sempre di più e lascia fare.

**Esperienza target**: "Minimo sforzo, massima resa". Configurazione iniziale leggera, poi l'app lavora in background. L'utente può interagire via chat web, Telegram o WhatsApp quando vuole, ma non è obbligato.

**Nome assistente AI**: Placeholder (da definire). L'app si chiama Leopost (nome temporaneo).

## Constraints

- **Architettura**: Headless (frontend/backend separati) — preparato per future app native
- **Stack AI**: Multi-provider (OpenAI, Anthropic, Google) — utente sceglie
- **Social API**: Dipendenza da API ufficiali Facebook/Meta, LinkedIn — soggette a limitazioni e approvazioni
- **Generazione immagini**: Modello da scegliere in base a qualità/costo (DALL-E 3, Imagen, etc.)
- **Target geografico**: Italia (lingua italiana, contesto PMI italiane)

## Key Decisions

| Decision | Rationale | Outcome |
|----------|-----------|---------|
| Chat-first con schermate di supporto | L'interazione naturale riduce l'attrito, ma calendario e settings servono visuali | — Pending |
| Multi-model AI (GPT, Claude, Gemini) | Diversi utenti preferiscono modelli diversi, evita lock-in | — Pending |
| Onboarding progressivo | Evita abbandono per "troppo da fare" al primo accesso | — Pending |
| Automazione configurabile | Costruisce fiducia gradualmente, dall'approval all'autopilot | — Pending |
| Headless architecture | Prepara per app native senza riscrivere logica | — Pending |
| Limiti piano Free da definire post-test | Meglio testare dove l'utente sente il bisogno di upgrade | — Pending |

---
*Last updated: 2026-01-30 after initialization*