Michele/postgenerator
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(01): create phase plan

Browse Source 
Phase 01: Core Generation Pipeline
- 4 plan(s) in 3 wave(s)
- Wave 1: 01-01 (infra) + 01-02 (core services) parallel
- Wave 2: 01-03 (LLM pipeline + API routers)
- Wave 3: 01-04 (Web UI) with human-verify checkpoint
- Ready for execution
This commit is contained in:
Michele
2026-03-08 01:27:25 +01:00
parent 595b6ee7e7
commit 3f1dbbf396
5 changed files with 1165 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
.planning/ROADMAP.md
View File

@@ -29,13 +29,13 @@ Decimal phases appear between their surrounding integers in numeric order.
3. Al termine della generazione, l'utente puo' scaricare un file CSV che si apre correttamente in Excel con caratteri italiani intatti e header che corrispondono esattamente ai placeholder del template Canva
4. Il CSV contiene esattamente 13 righe di contenuto con la distribuzione Persuasion Nurturing corretta (4 valore, 2 storytelling, 2 news, 3 riprova, 1 coinvolgimento, 1 promo) e i livelli Schwartz assegnati
5. Se la generazione di un singolo post fallisce (errore API), gli altri post del batch sono salvati e scaricabili; il post fallito e' marcato come errore senza bloccare il resto
**Plans**: TBD
**Plans**: 4 plans
Plans:
- [ ] 01-01: Infrastructure setup — FastAPI + React SPA single container, Docker multi-stage build, subpath /postgenerator/ configurato correttamente (root_path via Uvicorn, Vite base, nginx lab-router)
- [ ] 01-02: Core services — CalendarService (distribuzione 13 post, Schwartz, nicchie, date), FormatSelector (mapping tipo x Schwartz → formato), PromptService base (carica .txt, compile variabili), file-based storage layout
- [ ] 01-03: LLM pipeline — LLMService (Claude API, retry, backoff, rate limit, JSON validation), CSVBuilder (header Canva locked, utf-8-sig encoding), per-item error isolation
- [ ] 01-04: Web UI base — Dashboard, form Genera Calendario, form Genera Singolo Post, Output Review (anteprima slide-by-slide), Impostazioni, progress indicator bulk
- [ ] 01-01-PLAN.md — Infrastructure setup: FastAPI skeleton + React SPA + Docker multi-stage build + subpath /postgenerator/ (Wave 1)
- [ ] 01-02-PLAN.md — Core services: CalendarService + FormatSelector + PromptService + costanti dominio + 5 prompt italiani (Wave 1)
- [ ] 01-03-PLAN.md — LLM pipeline: LLMService + CSVBuilder + GenerationPipeline + API routers (Wave 2)
- [ ] 01-04-PLAN.md — Web UI: Dashboard + Genera Calendario + Output Review + Genera Singolo + Settings (Wave 3)
---
@@ -93,7 +93,7 @@ Phases execute in numeric order: 1 → 2 → 3 → 4
| Phase | Plans Complete | Status | Completed |
|-------|----------------|--------|-----------|
| 1. Core Generation Pipeline | 0/4 | Not started | - |
| 1. Core Generation Pipeline | 0/4 | Planned (3 waves) | - |
| 2. Prompt Control + Output Review | 0/2 | Not started | - |
| 3. Organization Layer | 0/2 | Not started | - |
| 4. Enrichment | 0/1 | Not started | - |