Files

Michele f8d9499f80 docs(04): capture phase context

Phase 04: Enrichment
- Implementation decisions documented
- Phase boundary established
- Unsplash integration + UI polish scope confirmed
- Context injection deferred (covered by Phase 3 topic_overrides)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-09 01:43:24 +01:00

2.4 KiB

Raw Blame History

Phase 4: Enrichment - Context

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

## 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.

## 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

## 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

## 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

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

2.4 KiB Raw Blame History