# Roadmap Implementazione: Redazione Social Multi-Agente

Questo documento elenca i passi necessari per costruire il sistema di automazione social.

## Fase 1: Setup Ambiente e Dati (Dockerized)
- [ ] Inizializzare un progetto con **Docker** e **docker-compose**.
- [ ] Creare la struttura delle cartelle persistenti (volumi):
    - `data/images/artista_n`: per le foto.
    - `data/audio/artista_n`: per i brani .mp3 da analizzare.
- [ ] Creare un file `config.json` con i profili dei 4 cantanti e i link Spotify/Distrokid.
- [ ] Preparare il `Dockerfile` con le dipendenze (Python, FFmpeg per audio, ecc.).

## Fase 2: Sviluppo del Database delle Immagini
- [ ] Creare uno script che scansiona la cartella immagini.
- [ ] Implementare una logica di "tracking" per segnare le immagini già usate (per evitare ripetizioni).
- [ ] (Opzionale) Usare un modello Vision per pre-analizzare le immagini e salvarne una descrizione.

## Fase 3: Sviluppo degli Agenti
- [ ] **Agente Audio Analyst**: Utilizza modelli AI multimodali (es. Gemini) per ascoltare il brano .mp3 e dedurre genere, mood, bpm e temi principali.
- [ ] **Agente Asset Manager**: Seleziona l'immagine non usata dal folder specifico dell'artista.
- [ ] **Agente Copywriter**: Genera testi basandosi sull'output dell'Audio Analyst (non più su generi predefiniti).
- [ ] **Agente Visual-Harmonizer**: Incrocia l'analisi audio con l'estetica dell'immagine scelta.
- [ ] **Agente Hashtag**: Genera tag basati sul brano analizzato e sul visual.
- [ ] **Agente Supervisore**: Verifica finale della coerenza tra audio, immagine e link.

## Fase 4: Orchestrazione e Approvazione
- [ ] Configurare il grafo di **LangGraph** per collegare gli agenti.
- [ ] Creare una semplice interfaccia (es. **Streamlit**) per visualizzare la proposta del post e cliccare su "Approva" o "Rifiuta".
- [ ] Integrare un sistema di notifiche (es. Telegram Bot) per avvisarti quando un post è pronto.

## Fase 5: Distribuzione (Post reale)
- [ ] Integrare le API dei social media o un aggregatore (es. **Buffer API** o un webhook verso **Make.com**).
- [ ] Testare il flusso completo con un post di prova.

## Fase 6: Manutenzione
- [ ] Implementare un log dei post pubblicati.
- [ ] Sistema di alert se le immagini in una cartella stanno per finire.