Strategia Template Contratti/RAS (Extra vs Non Extra)

Obiettivo

Gestire template distinti per rete extra e reti non extra, con selezione automatica in base a:

• tenant/rete commerciale
• profilo destinatario (amministratore, commerciale, tecnico)
• tipo documento (contratto, RAS)

Matrice template proposta

Contratti

1. contract_ras_admin_extra_v1.docx
2. contract_ras_admin_non_extra_v1.docx
3. contract_ras_commerciale_extra_v1.docx
4. contract_ras_commerciale_non_extra_v1.docx
5. contract_ras_tecnico_extra_v1.docx
6. contract_ras_tecnico_non_extra_v1.docx

RAS

1. ras_extra_v1.docx
2. ras_non_extra_v1.docx

Sorgenti attuali in incoming

• incoming/Cotratti/IDS - Condizioni di contratto per RAS v2.docx (base contrattuale)
• incoming/Cotratti/ras v4.docx (base RAS)

Regole di selezione runtime

1. Determino is_extra da rete commerciale/tenant.
2. Determino subject_type da profilo utente (amministratore|commerciale|tecnico).
3. Determino doc_type (contratto|ras).
4. Seleziono template per chiave:
5. contratto:<subject_type>:<extra|non_extra>
6. ras:<extra|non_extra>
7. Genero PDF e salvo in documentale con metadati:
8. template_code
9. template_version
10. is_extra
11. subject_type

Lock versione template (v1)

• Runtime bloccato su template *_v1.docx.
• Config:
• contracts_ras_template_map.json -> "lock_version": "v1"
• env/config -> CONTRACTS_RAS_TEMPLATE_LOCK_VERSION=v1
• Se il file selezionato non rispetta _*lock_version*.docx, il resolver non lo usa.

Placeholder standard (da usare in tutti i DOCX)

• {{cliente_nome}}
• {{cliente_piva}}
• {{cliente_cf}}
• {{amministratore_nome}}
• {{commerciale_nome}}
• {{tecnico_nome}}
• {{rete_nome}}
• {{tenant_key}}
• {{data_contratto}}
• {{luogo_firma}}
• {{codice_documento}}

Piano esecutivo

1. Congelo i 2 file sorgente e creo varianti nominate.
2. Allineo placeholder nei 8 template.
3. Registro i template nel documentale (categoria contratti/RAS).
4. Aggiungo mapping chiave->template in configurazione applicativa.
5. Aggancio il motore DOCX->PDF (già previsto) alla selezione automatica.
6. Eseguo test end-to-end:
7. admin extra/non extra
8. commerciale extra/non extra
9. tecnico extra/non extra
10. RAS extra/non extra

Dati legali da confermare prima della produzione

• Clausole diverse tra extra e non extra per ciascun profilo.
• Eventuali allegati obbligatori per profilo.
• Regole firma (digitale/manuale) e campi firma.
• Testi privacy/consenso da includere nei contratti.