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