Overview

Free app

Le free app sono tre applicazioni complete costruite su WUIC e distribuite gratis dalla pagina Download del sito: FatturazioneElettronica (fatturazione elettronica italiana con SDI), CrmApp (CRM B2B) e FlottaMezzi (gestione della flotta). Girano su Windows con SQL Server: altri database non sono supportati.

Binario gratuito o sorgenti con licenza

Ogni versione di una free app esce in due zip:

ZipContenutoLicenza WUIC
<App>-iis-v<versione>-with-dbs.zipapplicazione gia' compilata (cartella di publish per IIS), i due backup db/data.bak e db/metadata.bak, INSTALL.mdnon serve: il binario porta una licenza host binding che autorizza il framework solo per quell'applicazione cosi' come e' distribuita
<App>-src-v<versione>.zipsorgenti dell'applicazione (C#, client Angular, report, configurazione), gli stessi due backup, INSTALL-src.mdserve per eseguire l'applicazione ricompilata

Chi ricompila perde la licenza host binding: la chiave che firma l'assembly non e' nello zip, quindi il binario prodotto passa al controllo normale della licenza con l'impronta della macchina. Serve una licenza WUIC che copra SQL Server (tier Prezzo di lancio o Enterprise; il tier Standard copre solo MySQL e PostgreSQL). Senza licenza l'applicazione gira in modalita' Trial (al massimo 20 record per query). Prezzi: wuic-framework.com/pricing.

Nello zip sorgenti il framework non c'e' in forma di codice: il csproj usa il pacchetto NuGet WuicCore e wwwroot/package.json il pacchetto npm wuic-framework-lib, entrambi alla versione esatta con cui la free app e' stata rilasciata.

Installare il binario

INSTALL.md dentro lo zip -iis- descrive i passi: ripristino dei due backup, utente SQL, sito IIS e stringhe di connessione in appsettings.json. Non servono licenze ne' compilazioni.

Installare i sorgenti

Su una macchina Windows di sviluppo, da PowerShell:

Snippet 1PowerShell
& ([scriptblock]::Create((irm https://wuic-framework.com/install.ps1))) -Src -App FatturazioneElettronica

(-App CrmApp o -App FlottaMezzi per le altre due). Lo script:

1. installa con winget cio' che manca fra .NET SDK 10, Node.js LTS, SQL Server Express e git;

2. scarica lo zip sorgenti della versione corrente dal feed del sito (/downloads/releases.json, sezione freeapps) e ne controlla lo SHA-256;

3. lo estrae in C:\dev\<App> (-InstallDir per un'altra cartella);

4. crea un repository git con il ramo vendor/<app> (i sorgenti del fornitore cosi' come sono) e il ramo di lavoro main creato da li';

5. ripristina i due database dai backup e scrive le stringhe di connessione (autenticazione Windows) in appsettings.json e appsettings.Development.json;

6. esegue dotnet restore e npm install.

Con lo zip gia' scaricato: -PackageUrl <percorso dello zip> (in quel caso non c'e' uno SHA-256 del feed con cui confrontarlo). INSTALL-src.md nello zip riporta gli stessi passi da fare a mano.

Lo zip sorgenti ha la stessa forma di quello del framework:

FileA cosa serve
<App>.code-workspace, .vscode/launch.json, .vscode/tasks.jsonaprire il progetto in VS Code e avviare backend e client con F5 (Fullstack: <App> + Chrome)
llm-workspace/, AGENTS.mdskill curate, template e plugin WUIC Assistant; AGENTS.md ha una sezione Project-specific con tabelle, route, oggetti del DB dati e trappole della app
scripts/wuic-meta.ps1riga di comando del ciclo di vita dei metadati
wuic-app.jsonmanifest della versione: chiave, versione, framework, release del ciclo di vita, SHA-256 di ogni file del fornitore

Primo accesso

I database delle free app escono con l'utente amministratore admin, password admin. Le credenziali sono pubbliche: cambia la password al primo accesso (menu Cambio password) e cambia o disattiva gli utenti demo prima di inserire dati veri.

Per i sorgenti, la licenza si applica come per il framework (pagina Licensing): machineFingerprint da GET /api/Meta/LicenseStatus, poi license-payload e license-signature in Amministrazione > Editor AppSettings, sezione License.

Come si personalizza

  • Metadati (route, colonne, menu, template, permessi, workflow, dashboard): dall'applicazione, con i designer e l'Editor, come in ogni app WUIC. Il backup dei metadati contiene la release del ciclo di vita registrata dal fornitore (fe-<versione>, crm-<versione>, flotta-<versione>): e' la base con cui la pagina Ciclo di vita app e scripts/wuic-meta.ps1 confrontano lo stato dell'installazione (pagina Ciclo di vita dei metadati).
  • Report: i file Reports/<route>/*.mrt, modificabili con il Report designer.
  • Codice (controller e servizi C#, componenti Angular in wwwroot/src): solo dallo zip sorgenti, con la licenza descritta sopra.

Il ramo vendor

install.ps1 -Src -App crea il repository con due rami: vendor/<app> contiene i sorgenti del fornitore senza modifiche, main e' il ramo su cui lavori. Tieni vendor/<app> intatto: e' la base comune fra la tua versione e quella del fornitore. Il .gitignore dello zip lascia fuori dal repository bin, obj, node_modules e i backup .bak.

Aggiornamento

FatturazioneElettronica binaria (zip -iis-) si aggiorna dalla 1.7.28 alla 1.8.0 con la cartella upgrade\ dello zip nuovo, tenendo dati e personalizzazioni: la procedura e' nella pagina Aggiornare una free app. Non estrarre lo zip nuovo sopra l'installazione e non ripristinare i suoi backup: sono per un'installazione nuova.

Per CrmApp e FlottaMezzi e per chi ha installato i sorgenti una procedura non c'e' ancora. Nel frattempo: non modificare il ramo vendor/<app>, conserva lo zip della versione installata e lascia nel database dei metadati la release del fornitore. wuic-app.json elenca lo SHA-256 di ogni file del fornitore della versione installata.