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>
This commit is contained in:
61
.planning/phases/04-enrichment/04-CONTEXT.md
Normal file
61
.planning/phases/04-enrichment/04-CONTEXT.md
Normal file
@@ -0,0 +1,61 @@
|
|||||||
|
# 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*
|
||||||
Reference in New Issue
Block a user