Files
postgenerator/.planning/phases/02-prompt-control-output-review/02-CONTEXT.md
Michele c22d9dde97 docs(02): capture phase context
Phase 02: Prompt Control + Output Review
- Implementation decisions documented
- Phase boundary established
2026-03-08 19:57:36 +01:00

63 lines
2.6 KiB
Markdown

# Phase 2: Prompt Control + Output Review - Context
**Gathered:** 2026-03-08
**Status:** Ready for planning
<domain>
## Phase Boundary
L'utente puo' modificare i prompt LLM direttamente dalla Web UI senza toccare il codice, rigenerare singoli post insoddisfacenti, e rivedere l'anteprima completa di ogni carosello prima di esportare il CSV. Non include nuove capability (Swipe File, Unsplash, storico campagne).
</domain>
<decisions>
## Implementation Decisions
### Prompt Editor UX
- Bottone "Rigenera" visibile direttamente su ogni PostCard nella Output Review (non menu contestuale)
- Ogni prompt ha un pulsante "Reset al default" per ripristinare la versione originale pre-installata
- Accanto all'editor, una sezione mostra la lista delle variabili disponibili (es. {{topic}}, {{obiettivo}}, {{nicchia}}) con descrizione per ciascuna
### Rigenerazione singolo post
- Trigger: bottone diretto sulla card del post nella Output Review
- Prima di rigenerare, un piccolo form permette di inserire un topic diverso o note aggiuntive (non solo "stessi parametri")
### Flusso Output Review
- Post rigenerati hanno un badge/icona visivo (es. freccia circolare) che li distingue dai post originali
- Summary counter in cima alla Output Review: "13 post - X rigenerati - Y modificati manualmente" per overview rapida dello stato del batch
### Claude's Discretion
- Tipo di editor prompt (textarea semplice vs syntax highlight per variabili {{...}})
- Layout navigazione tra prompt (sidebar, tab, accordion)
- Posizionamento Prompt Editor (pagina dedicata vs sezione dashboard)
- Anteprima live del prompt compilato con variabili esempio (implementare se il costo e' basso)
- Feedback visivo durante rigenerazione (spinner, overlay, dimming)
- Undo one-step dopo rigenerazione (implementare se pragmatico)
- Gestione variabili obbligatorie mancanti (blocco salvataggio vs warning)
- Badge "Modificato" vs "Default" sui prompt nella lista
- Card espandibile per dettaglio slide vs card compatta
- CSV scaricato sempre con ultime versioni (approccio piu' pragmatico)
</decisions>
<specifics>
## Specific Ideas
- Il form pre-rigenerazione deve essere leggero (non un dialog modale pesante) — idealmente inline o popover sulla card
- Il summary counter in cima alla Output Review deve aggiornarsi in tempo reale dopo ogni regen
- Le variabili disponibili mostrate nell'editor devono corrispondere esattamente a quelle che PromptService si aspetta per quel tipo di prompt
</specifics>
<deferred>
## Deferred Ideas
None — discussion stayed within phase scope
</deferred>
---
*Phase: 02-prompt-control-output-review*
*Context gathered: 2026-03-08*