From f8d9499f803e6805d678a5caee455547d255d25d Mon Sep 17 00:00:00 2001 From: Michele Date: Mon, 9 Mar 2026 01:43:24 +0100 Subject: [PATCH] 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 --- .planning/phases/04-enrichment/04-CONTEXT.md | 61 ++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 .planning/phases/04-enrichment/04-CONTEXT.md diff --git a/.planning/phases/04-enrichment/04-CONTEXT.md b/.planning/phases/04-enrichment/04-CONTEXT.md new file mode 100644 index 0000000..bf9aca8 --- /dev/null +++ b/.planning/phases/04-enrichment/04-CONTEXT.md @@ -0,0 +1,61 @@ +# 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*