docs(03-02): complete swipe-to-calendar integration plan

Tasks completed: 2/2
- Task 1: topic_overrides in CalendarRequest + pipeline wiring
- Task 2: picker Swipe File nel form Genera Calendario + mark-used

SUMMARY: .planning/phases/03-organization-layer/03-02-SUMMARY.md

.planning/STATE.md

@@ -5,23 +5,23 @@
 See: .planning/PROJECT.md (updated 2026-03-07)
 
 **Core value:** Generare un calendario di 13 caroselli Instagram strategicamente orchestrati, pronti per Canva Bulk Create, con un click dalla Web UI.
-**Current focus:** Phase 3 — Organization Layer (Plan 1/2 completato)
+**Current focus:** Phase 3 COMPLETA — pronto per vps-lab-deploy e Phase 4
 
 ## Current Position
 
-Phase: 3 of 4 (Organization Layer)
-Plan: 1 of 2 in current phase — In progress
-Status: In progress — Plan 03-01 completo, manca 03-02
-Last activity: 2026-03-09 — Completed 03-01-PLAN.md (SwipeService + pagina SwipeFile)
+Phase: 3 of 4 (Organization Layer) — COMPLETA
+Plan: 2 of 2 in current phase — Completato
+Status: Phase 3 completa — pronto per deploy e Phase 4
+Last activity: 2026-03-09 — Completed 03-02-PLAN.md (Swipe-to-Calendar integration)
 
-Progress: [███████░░░] 77% (7/9 piani totali)
+Progress: [████████░░] 89% (8/9 piani totali)
 
 ## Performance Metrics
 
 **Velocity:**
-- Total plans completed: 7
-- Average duration: ~6.5 min
-- Total execution time: 47 min
+- Total plans completed: 8
+- Average duration: ~6 min
+- Total execution time: 50 min
 
 **By Phase:**
 
@@ -29,11 +29,11 @@ Progress: [███████░░░] 77% (7/9 piani totali)
 |-------|-------|-------|----------|
 | 01-core-generation-pipeline | 4/4 COMPLETA | 33 min | 8 min |
 | 02-prompt-control-output-review | 2/2 COMPLETA | 9 min | 4.5 min |
-| 03-organization-layer | 1/2 In corso | 5 min | 5 min |
+| 03-organization-layer | 2/2 COMPLETA | 8 min | 4 min |
 
 **Recent Trend:**
-- Last 5 plans: 8 min, 10 min, 5 min, 4 min, 5 min
-- Trend: stabile intorno a 5 min
+- Last 5 plans: 5 min, 4 min, 5 min, 3 min, 3 min
+- Trend: stabile intorno a 3-4 min
 
 *Updated after each plan completion*
 
@@ -67,22 +67,25 @@ Recent decisions affecting current work:
 - [03-01]: IDs brevi uuid4.hex[:12] — leggibili, no rischio collisione con volumi Swipe File
 - [03-01]: PUT con comportamento PATCH-like per nicchia/note — None cancella il valore
 - [03-01]: Filtro nicchia derivato dinamicamente da items (no config separata)
+- [03-02]: topic_overrides come dict[int, str] — chiave = slot_index, Pydantic converte str key → int
+- [03-02]: Override check prima di slot.topic e prima di LLM nel _run_generation
+- [03-02]: mark-used fire-and-forget (mutate senza await) per non bloccare la UI
+- [03-02]: Picker inline con absolute positioning z-20, toggle click stesso slot chiude
 
 ### Blockers/Concerns
 
 - [Phase 1]: Validare token usage reale per batch 13 post con claude-sonnet-4-5 — inter_request_delay=2.0s configurato, da validare in produzione
 - [Phase 1]: Baseline qualita' prompt italiani da validare dopo prima generazione reale
-- [Deploy]: Phase 2+3 plan1 complete — serve vps-lab-deploy per testare end-to-end il sistema
-- [03-02]: La route `/swipe-file` e il hook `useSwipeItems` sono pronti per l'integrazione nel form Genera Calendario
+- [Deploy]: Phase 3 completa — eseguire vps-lab-deploy per testare end-to-end il sistema completo
 
 ## Session Continuity
 
 Last session: 2026-03-09
-Stopped at: Completed 03-01-PLAN.md (SwipeService + SwipeFile UI) — Plan 1/2 Phase 3
+Stopped at: Completed 03-02-PLAN.md (Swipe-to-Calendar integration) — Plan 2/2 Phase 3
 Resume file: None
 
 ## Next Actions
 
-1. Eseguire 03-02-PLAN.md (Swipe-to-calendar integration: topic_overrides + picker Swipe File)
-2. `vps-lab-deploy` per deployare su VPS e testare end-to-end il sistema
-3. Pianificare Phase 4 (Enrichment: Unsplash integration)
+1. `vps-lab-deploy` per deployare su VPS e testare end-to-end il sistema completo
+2. Pianificare Phase 4 (Enrichment: Unsplash integration)
+3. Test reale della generazione bulk con topic_overrides dallo Swipe File