chore: complete v1 milestone

Archived:
- milestones/v1-ROADMAP.md (full phase details)
- milestones/v1-REQUIREMENTS.md (46/46 shipped)
- milestones/v1-MILESTONE-AUDIT.md (audit report)

Created:
- MILESTONES.md (project milestone history)

Deleted:
- REQUIREMENTS.md (fresh one for next milestone)

Updated:
- PROJECT.md (requirements → Validated, decisions with outcomes)
- ROADMAP.md (collapsed to one-line v1 summary)
- STATE.md (reset for next milestone)

v1 MVP: 4 phases, 10 plans, 46 requirements, 8080 LOC
Timeline: 2 days (2026-03-07 → 2026-03-09)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Michele
2026-03-09 11:59:07 +01:00
parent d8f298463b
commit 1c9199bf38
8 changed files with 518 additions and 396 deletions

32
.planning/MILESTONES.md Normal file
View File

@@ -0,0 +1,32 @@
# Project Milestones: PostGenerator
## v1 MVP Content Marketing Automation (Shipped: 2026-03-09)
**Delivered:** Sistema completo di generazione caroselli Instagram B2B con pipeline AI, prompt editor, swipe file e integrazione Unsplash — 46/46 requisiti soddisfatti.
**Phases completed:** 1-4 (10 plans total)
**Key accomplishments:**
- Pipeline completa di generazione contenuti AI: CalendarService (13 slot PN+Schwartz), LLMService (retry 429/5xx, backoff), GenerationPipeline async con job polling e per-item error isolation
- Web UI React completa con 7 pagine, design stone/amber B2B, 15+ hook TanStack Query, SlideViewer con edit inline e PostCard con badge PN/Schwartz
- Sistema di 7 prompt italiani editabili via UI con CRUD completo, variabili live, confronto default/modificato e reset
- Swipe File con integrazione calendario: CRUD + picker inline per topic override su 13 slot, attraversa l'intero stack frontend->backend->pipeline
- Export CSV Canva-ready con 33 colonne locked, utf-8-sig, supporto edit inline, e risoluzione Unsplash keyword->URL con cache disco
- Architettura Docker production-ready: multi-stage build, subpath /postgenerator/ con pitfall risolti, proxy_net, named volume
**Stats:**
- 48 source files created/modified
- 8,080 lines of code (4,157 Python + 3,923 TypeScript)
- 4 phases, 10 plans, ~58 min total execution
- 2 days from init to ship (2026-03-07 → 2026-03-09)
- 51 git commits
**Git range:** `5335b3b` (docs: initialize project) → latest
**Tech debt accepted:** 4 items (1 medium, 3 low) — pipeline singleton invalidation, unused campagna field, hardcoded brand_name, non-recoverable interrupted jobs
**What's next:** Deploy su VPS (`vps-lab-deploy`) e validazione end-to-end con API key reali (Claude + Unsplash)
---