Compila e Dynamic Admin

Questa guida allinea la gestione Compila con il pannello Dynamic Admin (LegacyDynamicTemplateAdminView).

Ambito

• editing schema da Schema Editor;
• anteprima reale in modal Demo;
• allineamento meta/preset domanda;
• stampa Prova scheda da Compila (/api/print_pdf?mode=section).

URL operativi

• Admin template: /legacy-dynamic-template/
• Schema editor: /legacy-dynamic-template/schema-editor/<template_id>
• Compila documento: /<kind>/compila/<istanza_id>
• Prova scheda PDF: /<kind>/api/print_pdf?istanza_id=<id>&mode=section&code=<section_code>

kind tipico: ras oppure dynamic.

Regole Schema Editor (Dynamic Admin)

1. Ordinamento sezioni:
2. drag&drop tree + Aggiorna persiste l’ordine per parent;

3. Ricarica tree rilegge da endpoint dedicato schema_tree.

4. Meta/Preset:

5. la domanda usa merge tra meta campo + preset (meta_preset, preset_*);
6. nel modal Demo, bottone Meta mostra:
7. meta originale;
8. preset risolto;
9. meta finale;

10. payload demo inserimento (key, answer).

11. Domande select:

12. se il tipo è text ma in meta esistono choices, in demo viene resa select/boolean;
13. detail_fields è gestito solo quando presente e con trigger coerente.

Regole Compila (runtime)

• salvataggio risposte su server; cache locale come fallback;
• Ricarica da server ripristina la sezione corrente dal backend;
• Reset pulisce cache locale e richiede nuova selezione sezione.

Regole Prova Scheda PDF

• sotto il titolo scheda principale non compare header colonne;
• per ogni sottoscheda: Titolo sottoscheda -> header colonne -> domande;
• righe della stessa domanda restano un blocco unico:
• niente separatori orizzontali interni tra foto;
• foto impilate verticalmente nella stessa cella immagini;
• numerazione pagine Pag. X/Y senza pagina extra.

Smoke test rapido

Da shell applicativa:

flask legacy_dynamic_smoke --model-id 6

Verifica endpoint chiave editor/schema e fallisce solo su 5xx.

Checklist allineamento dopo modifica schema

1. Aprire Schema Editor e salvare ordine sezioni/sottosezioni.
2. Aprire modal Demo e testare 2-3 domande con Meta.
3. In Compila testare:
4. salvataggio;
5. ricarica server;
6. dettaglio condizionale.
7. Eseguire Prova scheda su almeno una sottosezione con foto.