leopost/.planning/PROJECT.md

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