Audit Easy Builder - 2026-08-05

Esito sintetico

Easy Builder resta compatibile con il runtime legacy dynamic e con Compila v3.

L'audit ha confermato: - nessuna migrazione DB richiesta - legacy_dynamic_* resta il contratto runtime - document_check continua a passare da Easy Builder a runtime - answer_semantics e' ora gestibile sia da Easy Builder GUI sia dallo Schema Editor avanzato - Compila v3 legge la semantica ma non la usa ancora per automatismi NC

Fix applicati

Semantica risposta v3 in Easy Builder GUI

Aggiunti sulla domanda: - tipo semantica - NC se - OK se - In attesa se

Il payload Easy Builder salva:

{
  "answer_semantics": {
    "mode": "neutral",
    "nc_when": [],
    "ok_when": [],
    "pending_when": ["In attesa"]
  }
}

La generazione runtime materializza il dato in:

{
  "meta": {
    "answer_semantics": {
      "mode": "neutral",
      "nc_when": [],
      "ok_when": [],
      "pending_when": ["In attesa"]
    }
  }
}

Conservazione in libreria domande

Quando una domanda viene salvata o ripresa dalla libreria, conserva anche answer_semantics.

Regole confermate

• No non significa automaticamente NC
• Si non significa automaticamente OK
• il template deve dichiarare il significato con answer_semantics
• v3 puo' mostrare la semantica e usarla in futuro solo tramite regole esplicite
• il compila legacy non deve dipendere da questo metadato

Validazioni eseguite

• pytest -q tests/test_compila_v3_runtime.py tests/test_tenant_theme_console.py
• node tests/js/schema_editor_answer_semantics_source.test.js
• node tests/js/easy_builder_answer_semantics_source.test.js
• node tests/js/compila_v3_render_source.test.js
• node tests/js/compila_v3_photo_ai_source.test.js
• parse Jinja dei template Easy Builder e Compila v3
• mkdocs build --strict

Miglioramenti consigliati

1. Aggiungere preset Easy Builder gia' configurati:
2. inventario neutro
3. requisito con NC se No

4. pericolo con NC se Si

5. Aggiungere audit pre-pubblicazione:

6. segnalare domande Si/No/In attesa senza semantica

7. non bloccare subito, solo warning

8. Aggiungere preview v3 semantica:

9. badge piu' leggibili

10. evidenza chiara su No neutro

11. In futuro, usare answer_semantics per AI e controlli coerenza, mai per salvare NC senza conferma tecnico.