Files
postgenerator/.planning/STATE.md
Michele f9c452586f docs(01-02): complete servizi dominio plan
Tasks completed: 2/2
- Task 1: Costanti dominio, Pydantic schemas, FormatSelector
- Task 2: CalendarService, PromptService, 7 prompt .txt in italiano

SUMMARY: .planning/phases/01-core-generation-pipeline/01-02-SUMMARY.md
2026-03-08 02:02:35 +01:00

3.1 KiB

Project State

Project Reference

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 1 — Core Generation Pipeline

Current Position

Phase: 1 of 4 (Core Generation Pipeline) Plan: 2 of 4 in current phase Status: In progress — Plan 02 completato (parallelo con Plan 01) Last activity: 2026-03-08 — Completato 01-02-PLAN.md (servizi dominio + prompt)

Progress: [██░░░░░░░░] 12% (2/16 piani totali stimati)

Performance Metrics

Velocity:

  • Total plans completed: 2
  • Average duration: ~7 min
  • Total execution time: 15 min

By Phase:

Phase Plans Total Avg/Plan
01-core-generation-pipeline 2/4 15 min 7 min

Recent Trend:

  • Last 5 plans: 6 min, 9 min
  • Trend: baseline stabilita

Updated after each plan completion

Accumulated Context

Decisions

Decisions are logged in PROJECT.md Key Decisions table. Recent decisions affecting current work:

  • [Setup]: Tutti i 9 critical pitfalls identificati dalla research sono concentrati in Phase 1 — affrontarli subito e' la priorita' assoluta
  • [Setup]: FastAPI root_path SOLO via Uvicorn (--root-path), mai nel costruttore FastAPI() — altrimenti doppio path bug
  • [Setup]: CSV encoding = utf-8-sig (BOM) sempre; CANVA_FIELDS locked come costante prima di qualsiasi codice di generazione
  • [Setup]: Prompt di sistema scritti IN italiano (non inglese + "scrivi in italiano")
  • [Setup]: Per-item error isolation dal primo loop di generazione — un fallimento non blocca il batch
  • [01-01]: root_path SOLO via Uvicorn --root-path nel Dockerfile CMD, VERIFICATO e funzionante
  • [01-01]: API_BASE='/postgenerator/api' nel frontend — Pitfall #9 risolto nella configurazione base
  • [01-01]: SPAStaticFiles montato come ultima operazione in main.py — pattern stabilito
  • [01-01]: fastapi[standard]==0.135.1, anthropic==0.84.0 pinned in requirements.txt
  • [01-01]: docker-compose NO porte esposte, named volume postgenerator-data per persistenza
  • [01-02]: CANVA_FIELDS 33 colonne con _image_keyword (non URL) — URL Unsplash in Phase 4
  • [01-02]: Distribuzione L3 split: valore-L3 in Cattura, riprova_sociale-L3 in Coinvolgi
  • [01-02]: PromptService usa ValueError per variabili mancanti — fail esplicito non silenzioso
  • [01-02]: Nicchie 50/50: slot pari=generico, slot dispari=verticale in rotazione

Pending Todos

None.

Blockers/Concerns

  • [Phase 1 RISOLTO in 01-02]: CANVA_FIELDS locked con 33 colonne e assert a load-time
  • [Phase 1]: Validare token usage reale per batch 13 post con claude-sonnet-4-5 contro limite Tier 1 (8,000 OTPM) — necessario inter-request delay configurabile (2-3s) (da affrontare in 01-03)
  • [Phase 1]: Baseline qualita' prompt italiani da validare dopo prima generazione reale (post 01-03)

Session Continuity

Last session: 2026-03-08T01:00:34Z Stopped at: Completato 01-02-PLAN.md — Servizi dominio + prompt .txt italiani Resume file: None