Release Notes — WUIC Framework v1.1.0

Data: 13 maggio 2026 Versione precedente pubblicata: 1.0.20 (12 maggio 2026) Backend: .NET 10 + IIS / Linux nginx Frontend: Angular 21

Salto a minor: questa release introduce due capability strutturali che cambiano il modello di deployment del framework.

• Multi-tenant: una singola istanza del framework instrada dati e metadata di N aziende su N connessioni DB diverse. Configurazione tenant-by-tenant sulle colonne Aziende.Connessione_DB_Dati / Aziende.CONNESSIONE_DB_Meta; routing trasparente a livello applicativo via TenantContext (AsyncLocal, sopravvive a Task/scheduler).
• Menu localizzabile per lingua: le voci di menu (mm_display_string_menu) non contengono più label italiane hard-coded ma chiavi stabili namespaced menu.<scope>.<slug>, risolte runtime dalla pipe translate di Angular contro _wuic_translations. Switch lingua dal selettore utente cambia tutte le voci senza F5.

🌐 Multi-tenant management

Una singola installazione del framework può ora servire più aziende ("tenant") con dati e metadata fisicamente isolati su DB diversi, senza richiedere repliche dell'applicazione né reverse-proxy partizionati per host.

Modello dati. L'instradamento tenant→connessioni è definito su due colonne del DB metadati primario:

• Aziende.Connessione_DB_Dati — nome di una entry in ConnectionStrings per il DB applicativo del tenant
• Aziende.CONNESSIONE_DB_Meta — nome di una entry in ConnectionStrings per il DB metadati del tenant

Le colonne contengono il nome della entry, non la stringa letterale. Rotazione credenziali via editing appsettings.<env>.json, senza toccare il DB.

Attivazione. Flag in appsettings.json (sezione AppSettings):

"multiConnectionEnabled": "true"

Con flag false (default) il comportamento resta single-tenant, identico alle release precedenti. Con flag true ogni richiesta HTTP autenticata risolve l'AziendaId dall'utente loggato e instrada GetOpenConnection alle connection string del tenant corrispondente.

Routing transparente. Tutti i punti di accesso a DB del framework (MetaService.*, scheduler, scaffolding, AsmxProxy CRUD, callback custom) consultano TenantScope.CurrentAziendaId via AsyncLocal, propagato dal middleware HTTP post-authenticate. Job background e callback custom dichiarano il tenant esplicitamente con using (TenantScope.Push(aziendaId)) { ... } quando partono fuori dal contesto di request.

Cache tenant-aware. Le chiavi Application[] server-side e i cache locali metadata vengono automaticamente suffissate per AziendaId quando il flag è attivo, evitando bleed di metadata tra tenant.

Login routing. Tabella _login_index(username_hash, id_azienda) sul DB primario mappa username → tenant per il fallback di MetaService.login: dopo autenticazione, il cookie k-user porta azienda_id come parte del payload e il middleware crea il TenantScope corretto a ogni richiesta successiva.

Scaffold propagation. L'azione "Scaffold tabella" propaga in modo idempotente le metadata della tabella a tutti i tenant elencati in Aziende. La propagazione gira con TenantScope esplicito su ogni target ed è idempotente: ri-eseguibile, applica solo le modifiche mancanti.

File preconfigurati nel pacchetto:

• appsettings.multi-tenant.mssql.json / appsettings.multi-tenant.mysql.json — environment self-contained con 6 connection string esempio (1 primary + 5 tenant) e multiConnectionEnabled=true. Attivare con ASPNETCORE_ENVIRONMENT=multi-tenant.mssql.
• dbms/scripts/multi_tenant_aziende_connessioni_mssql.sql / _mysql.sql — DDL per aggiungere le due colonne a Aziende su DB esistenti.

🗺️ Menu localizzabile in base alla lingua

Le voci di menu vengono ora tradotte dinamicamente seguendo la lingua dell'utente, senza bisogno di duplicare i record _metadati__menu per locale.

Architettura. Il campo mm_display_string_menu di _metadati__menu contiene una chiave stabile namespaced (menu.admin.roles, menu.crm.opportunities, menu.fleet.vehicles, ...). Il template del componente menu Angular applica la pipe translate su item.label e la chiave viene risolta runtime dal dizionario _wuic_translations filtrato per lingua corrente.

Schema chiave.

menu.<scope>.<slug>
   │       └── slug snake_case (es. column_styles, opportunities)
   └── scope = root | admin | demo | crm | fleet | invoice

• menu.root.* — parent top-level (Amministrazione, Application, Home, ...)
• menu.admin.* — 36 voci di sistema condivise (Ruoli, Designer, Stili colonna, Workflow Designer, ...)
• menu.demo.* — demo content WideWorldImporters
• menu.crm.* / menu.fleet.* / menu.invoice.* — voci specifiche del dominio del tenant

Vantaggio rispetto al modello precedente.

• Il vecchio modello usava il testo italiano della label come chiave di traduzione (Aziende, Customers, Ruoli). Questo causava case-mismatch silenziosi (Ruoli vs ruoli, Stili Tabella vs Stili tabella) perché la pipe translate è case-sensitive, mentre _wuic_translations ha collation case-insensitive: ogni MERGE che entrava prima fissava la casing per sempre, e le INSERT successive case-divergenti diventavano no-op silenziosi.
• Il nuovo modello con chiavi stabili è case-determinate (tutto lowercase per convenzione), namespacing per scope, e non collide più con altre risorse che potrebbero usare lo stesso testo italiano (es. button label "Ruoli" in un dropdown è una key diversa da menu.admin.roles).

5 lingue supportate. it-IT, en-US, fr-FR, es-ES, de-DE. Le traduzioni vivono in _wuic_translations (formato standard: language, resource, translation). Switch lingua dal dropdown utente in alto a destra rilegge il dizionario per la nuova lingua e ridipinge il menu senza F5.

Fallback runtime. Lingua corrente → en-US → it-IT → chiave raw. Se vedi menu.admin.roles letterale a schermo significa che la chiave non è stata seedata in nessuna delle 5 lingue.

Le vecchie chiavi italiane in _wuic_translations non vengono toccate dall'aggiornamento: possono essere consumate da altri punti dell'app (instant('Aziende') in code-behind, list-grid header, page title) e restano valide.

🐛 Bug fix degni di nota

• Form di edit dinamici — Tab e widget nei template md_edit_template in production: in build di produzione i template HTML personalizzati associati a una route via md_edit_template non rendevano correttamente i Tab di PrimeNG 21 (le label apparivano come testo concatenato senza il chrome del componente) e i field-editor mostravano solo placeholder <!----> al posto degli input. Causa: il compilatore runtime usato dal framework per i template dinamici richiede l'enumerazione esplicita dei componenti standalone disponibili nel template, mentre MetadataProviderService.widgetDefinition.dynamicFormImports era incompleto. Aggiunti al baseline TabsModule + Tabs/TabList/Tab/TabPanels/TabPanel, FieldsetModule, DataRepeaterComponent, DataSourceComponent, ImageWrapperComponent. Nessuna azione richiesta lato app consumer una volta aggiornato il pacchetto wuic-framework-lib.

🎁 Free app pronte all'uso

Da questa release tre applicazioni complete sono distribuite gratuitamente sopra il framework — scaricabili dalla sezione "Free apps" della pagina Downloads:

• CrmApp — CRM B2B self-hosted: anagrafica clienti, pipeline opportunità con kanban drag-and-drop, attività (call/meeting/email), dashboard role-based. (Leggi il post)
• FatturazioneElettronica — Editor fatture FatturaPA v1.2, firma CADES-BES, validazione XSD, 4 provider SDI intercambiabili (DirectPec gratuito via PEC, ArubaPec / FatturePec / PecIt commerciali), conservazione a norma, registri IVA e liquidazione. (Leggi il post)
• FlottaMezzi — Anagrafica mezzi/driver, scadenze automatiche (bollo / revisione / assicurazione / tagliando / patente), feed geolocation OBD/GPS, mappa live, aggregazione costi €/km per mezzo e per driver, reportistica TCO. (Leggi il post)

Ogni app è disponibile in tre formati: ZIP IIS con DB tutorial (pronto al restore), ZIP IIS senza DB, ZIP sorgenti.

Modello di licenza. Le free app sono GRATIS così come distribuite — il binario <App>.dll ZIP-ato porta una host-binding-license embedded che autorizza il runtime framework senza key esterne. Solo se si ricompila l'app dai sorgenti (per esempio per aggiungere un controller nuovo o modificare una signature pubblica) serve una licenza WUIC Developer o Professional: la ricompilazione produce un binario con identità diversa, perde il bundling, e il framework cade sul controllo licenza fingerprint standard.

Estendere le free app senza ricompilare il binario è coperto dal bundling: aggiunta metadata via SQL, componenti Angular nel wwwroot, job nella tabella scheduler, custom hook via appsettings.json:customCrudHookClass.

📦 Pacchetti aggiornati

🔧 Aggiornamenti operativi raccomandati per chi aggiorna

1. Per chi vuole attivare il multi-tenant (opt-in): applicare lo script DDL dbms/scripts/multi_tenant_aziende_connessioni_mssql.sql (o _mysql.sql) per aggiungere le colonne Connessione_DB_Dati e CONNESSIONE_DB_Meta ad Aziende. Popolare le righe Aziende con i nomi delle entry ConnectionStrings da appsettings.json. Settare AppSettings.multiConnectionEnabled = "true". Riavviare il backend.
2. Per chi resta single-tenant: nessuna azione richiesta. Senza multiConnectionEnabled=true il routing tenant è disattivo e il comportamento è bit-identico alla 1.0.20.
3. Menu localization — refresh metadata: dopo l'aggiornamento, eseguire una volta POST /api/Meta/AsmxProxy/MetaService.invalidateMetadataRuntime per ricaricare il dizionario menu lato client. In alternativa logout/login dell'utente.
4. Menu localization — migrazione di un progetto esistente: per un progetto che parte da una versione precedente con etichette italiane in _metadati__menu.mm_display_string_menu, applicare due step SQL idempotenti: (a) UPDATE _metadati__menu SET mm_display_string_menu = '<menu.scope.slug>' WHERE mm_display_string_menu = '<vecchia etichetta>' per ogni voce, secondo lo schema menu.<scope>.<slug> documentato sopra; (b) INSERT/MERGE INTO _wuic_translations (language, resource, translation) 5 righe per ogni nuova chiave (una per lingua). Le vecchie righe in _wuic_translations con resource = testo italiano restano in DB e possono essere usate da altri consumer (instant(), list-grid headers).
5. Hot reload backend in dev: se sviluppi con dotnet watch, il task backend: kill dll lockers ora richiede pwsh 7+ (non più Windows PowerShell 5.x). Lo script C# inline per Restart Manager usa sintassi Dictionary<,> corretta solo in PS 7+.