RAS Gallery Sottoschede - Template 6

Questo documento descrive dove viene configurata la gallery per le sottoschede del template RAS Safecondo e quali record sono stati attivati sul template:

• legacy_dynamic_template.legacy_model_id = 6
• nome = RAS
• versione = 1.1.0

Scopo

La gallery e' una feature di schema authoring, non di runtime tecnico.

Questo significa:

• il template decide se una sottoscheda supporta gallery
• il tecnico usa la gallery solo dove lo schema l'ha abilitata
• il runtime compila non deve accendere o spegnere la gallery caso per caso

Livello di configurazione

Il settaggio viene fatto a livello di sottoscheda del template, nella tabella:

• legacy_dynamic_template_schema

Il campo usato e':

• schema_json

Dentro schema_json, il nodo rilevante e':

• meta

Esempio:

{
  "parent_code": "SEC_SCHEDA_5_25",
  "meta": {
    "gallery_enabled": true,
    "gallery_max_items": 20,
    "gallery_note_enabled": true,
    "gallery_caption_enabled": true,
    "gallery_print_flag_enabled": true,
    "gallery_print_default": false
  }
}

Quindi il livello corretto e':

• non il documento compilato
• non la risposta del tecnico
• non la scheda padre intera
• si', la sottoscheda del template

Meta gallery usati

Per le sottoschede abilitate sono stati impostati questi valori:

{
  "gallery_enabled": true,
  "gallery_max_items": 20,
  "gallery_note_enabled": true,
  "gallery_caption_enabled": true,
  "gallery_print_flag_enabled": true,
  "gallery_print_default": false
}

Significato operativo:

• gallery_enabled: la sottoscheda espone la gallery
• gallery_max_items: massimo 20 immagini
• gallery_note_enabled: abilita una nota generale della gallery
• gallery_caption_enabled: abilita la didascalia per ogni immagine
• gallery_print_flag_enabled: abilita il controllo di stampa
• gallery_print_default: le immagini non vengono stampate di default

Dove viene letto nel codice

Schema editor / normalizzazione

• app/modules/documentale/views.py
• app/modules/documentale/views.py
• app/modules/documentale/views.py

Runtime risposta

Nel payload risposta della sottoscheda, i dati della gallery vivono in:

• detail.gallery

Riferimenti:

• app/modules/documentale/views.py
• app/modules/documentale/views.py

Shape sintetica:

{
  "detail": {
    "gallery": {
      "items": [
        {
          "key": "stored/object/key.jpg",
          "caption": "Didascalia foto",
          "include_in_print": true
        }
      ],
      "note": "Nota generale della gallery",
      "print_on_sheet": true
    }
  }
}

Stampa / payload RAS

Il print engine legge:

• i meta della sottoscheda dallo schema
• i dati gallery dalla risposta runtime

Riferimenti:

• app/services/print_engine/adapters/ras.py
• app/services/print_engine/adapters/ras.py
• app/services/print_engine/adapters/ras.py

Script usato per l'attivazione

L'aggiornamento del template e' stato applicato con:

• scripts/enable_ras_template6_gallery.py

Lo script:

• cerca il template con legacy_model_id = 6
• legge le righe di legacy_dynamic_template_schema
• aggiorna solo le sottoschede target
• scrive i meta gallery in schema_json.meta

Sottoschede attivate

Le sottoschede con gallery attiva sul template RAS 1.1.0 sono 21:

1. SEC_PORTICI_9 - PORTICI
2. SEC_SUPERFICIE_FACCIATA_12 - SUPERFICIE FACCIATA
3. SEC_ACCESSO_AL_TETTO_26 - ACCESSO AL TETTO
4. SEC_BALCONI_13 - BALCONI
5. SEC_FINESTRE_14 - FINESTRE
6. SEC_ACCESSI_CORRIMANO_PARAPETTI_GRADINI_16 - ACCESSI - CORRIMANO / PARAPETTI - GRADINI
7. SEC_ILLUMINAZIONE_PARTI_ELETTRICHE_18 - ILLUMINAZIONE - PARTI ELETTRICHE
8. SEC_CABINA_ASCENSORE_21 - CABINA ASCENSORE
9. SEC_LOCALE_TECNICO_ASCENSORE_22 - LOCALE TECNICO ASCENSORE
10. SEC_SERVOSCALA_23 - SERVOSCALA
11. SEC_SOTTOTETTO_27 - SOTTOTETTO
12. SEC_TETTO_28 - TETTO
13. SEC_LINEA_VITA_29 - LINEA VITA
14. SEC_CANCELLO_31 - CANCELLO
15. SEC_RAMPA_CORSELLO_GARAGE_33 - RAMPA - CORSELLO - GARAGE
16. SEC_LOCALI_INTERRATI_E_CANTINE_36 - LOCALI INTERRATI E CANTINE
17. SEC_ILLUMINAZIONE_PARTI_ELETTRICHE_37 - ILLUMINAZIONE - PARTI ELETTRICHE
18. SEC_IMPIANTO_ELETTRICO_E_DI_TERRA_40 - IMPIANTO ELETTRICO E DI TERRA
19. SEC_CENTRALE_TERMICA_45 - CENTRALE TERMICA
20. SEC_VASCHE_48 - VASCHE
21. SEC_LOCALE_TECNICO_49 - LOCALE TECNICO

Stato finale del template

Risultato verificato dopo l'aggiornamento:

• sottoschede totali: 64
• gallery attiva: 21
• gallery disattiva: 43

Le sottoschede del blocco SCHEDA RISCHI SPECIFICI sono state lasciate spente.

Regola da tenere ferma

La gallery si abilita nel template.

Il tecnico runtime:

• puo' caricare immagini
• puo' inserire didascalie
• puo' inserire note
• puo' decidere cosa stampare

ma solo nelle sottoschede gia' abilitate dallo schema.