docs(03-01): complete SwipeService CRUD + SwipeFile UI plan

Tasks completed: 2/2
- Task 1: Backend — SwipeService + Pydantic schemas + FastAPI router
- Task 2: Frontend — TypeScript types + TanStack hooks + pagina SwipeFile + navigazione

SUMMARY: .planning/phases/03-organization-layer/03-01-SUMMARY.md
This commit is contained in:
Michele
2026-03-09 00:27:24 +01:00
parent d379789ec0
commit babdf8a250
3 changed files with 155 additions and 19 deletions

View File

@@ -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 2 COMPLETA — Prompt Control + Output Review
**Current focus:** Phase 3 — Organization Layer (Plan 1/2 completato)
## Current Position
Phase: 2 of 4 (Prompt Control + Output Review)
Plan: 2 of 2 in current phase — PHASE COMPLETE
Status: Phase 2 complete — ready for Phase 3 or deploy
Last activity: 2026-03-08 — Completed 02-02-PLAN.md (Per-item Regeneration + Summary Counter)
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)
Progress: [██████░░░] 66% (6/9 piani totali)
Progress: [██████░░░] 77% (7/9 piani totali)
## Performance Metrics
**Velocity:**
- Total plans completed: 6
- Average duration: ~7 min
- Total execution time: 42 min
- Total plans completed: 7
- Average duration: ~6.5 min
- Total execution time: 47 min
**By Phase:**
@@ -29,10 +29,11 @@ Progress: [██████░░░░] 66% (6/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 |
**Recent Trend:**
- Last 5 plans: 9 min, 8 min, 10 min, 5 min, 4 min
- Trend: velocita' in aumento
- Last 5 plans: 8 min, 10 min, 5 min, 4 min, 5 min
- Trend: stabile intorno a 5 min
*Updated after each plan completion*
@@ -62,21 +63,26 @@ Recent decisions affecting current work:
- [02-01]: PromptService init lazy via _get_prompt_service() per sincronizzazione con lifespan directory
- [02-02]: Regen notes passate via campo tono in GenerateRequest (pragmatico, no backend changes)
- [02-02]: Edit detection manuale via JSON.stringify comparison (trascurabile con 13 post)
- [03-01]: SwipeService lazy init identico a PromptService (DATA_PATH creato nel lifespan FastAPI)
- [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)
### 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 completa — serve vps-lab-deploy per testare end-to-end il sistema
- [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
## Session Continuity
Last session: 2026-03-08
Stopped at: Completed 02-02-PLAN.md (Per-item Regeneration + Summary Counter) — Phase 2 COMPLETE
Last session: 2026-03-09
Stopped at: Completed 03-01-PLAN.md (SwipeService + SwipeFile UI) — Plan 1/2 Phase 3
Resume file: None
## Next Actions
1. `vps-lab-deploy` per deployare su VPS e testare end-to-end
2. Pianificare Phase 3 (Canva-ready CSV polish + advanced export)
3. Eseguire Phase 3
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)