# Phase 4: Enrichment - Context

**Gathered:** 2026-03-09
**Status:** Ready for planning

<domain>
## Phase Boundary

Arricchire il CSV con URL immagini reali da Unsplash (opzionale, attivo solo se API key configurata) e applicare miglioramenti UI generali. La context injection dallo Swipe File e' gia' coperta dal topic_overrides di Phase 3 e non rientra in questa fase.

</domain>

<decisions>
## Implementation Decisions

### Ricerca immagini Unsplash
- Lingua query e filtri (orientamento, dimensione): Claude's discretion
- Strategia per restare nei limiti 50 req/h free tier: Claude's discretion (cache, raggruppamento keyword, ecc.)
- Numero immagini per keyword: Claude's discretion
- URL formato: **regular (~1080px)** — gia' dimensionata, buon compromesso qualita'/peso per Canva
- Attribuzione fotografo: **non richiesta** — nessuna colonna extra nel CSV

### Fallback e resilienza
- Unsplash non configurato: **indicatore discreto** nella UI — piccolo avviso in Settings o Output Review ("Configura Unsplash per immagini reali")
- Errori di rete/timeout: **1 retry poi placeholder** — non rallentare la generazione
- Rate limit a meta' batch: Claude's discretion su come comunicare lo stato misto all'utente
- Cache: **persistente su disco** — file nella directory data/, sopravvive ai riavvii container

### Preview immagini nell'Output Review
- Mostrare un **thumbnail della slide copertina** (slide 1) per ogni post nell'anteprima
- Non mostrare preview per tutte le 8 slide — solo copertina, leggero e sufficiente

### Claude's Discretion
- Traduzione keyword italiano → inglese per query Unsplash
- Filtri immagine (orientamento, colore, ecc.)
- Numero risultati per keyword e logica di selezione
- Strategia rate limiting e ottimizzazione chiamate API
- Comunicazione stato misto (URL reali + placeholder) all'utente
- UI polish: Claude identifica e applica miglioramenti dove servono

</decisions>

<specifics>
## Specific Ideas

- L'utente vuole vedere le immagini nell'anteprima prima di esportare, non solo l'URL nel CSV
- La cache deve sopravvivere ai riavvii — coerente con pattern data/ gia' usato per swipe_file.json e prompts

</specifics>

<deferred>
## Deferred Ideas

- Context injection avanzata Swipe File (note come contesto prompt LLM) — considerata coperta dal topic_overrides di Phase 3, ma potrebbe essere ripresa in v2

</deferred>

---

*Phase: 04-enrichment*
*Context gathered: 2026-03-09*