AppMint

AppMint è una suite modulare che permette di costruire — senza scrivere codice — quattro tipi di applicazioni interne attivabili agli utenti finali da un Configuratore APP a 5 tab (Tipo & info / Backend / Maschera / Campi extra / Riepilogo).

**DB CRUD** — punta una connessione PostgreSQL o MariaDB salvata, sceglie schema e tabella, configura colonne (label, widget text/textarea/number/checkbox/date/datetime/select/fk), ricerca, filtri, ordinamenti, FK con label dinamica. Il risultato è un'app full-CRUD con UI auto-generata che lavora sui dati reali (nessuna duplicazione).

**Script runner** — esegue file `.py` `.sh` `.bat` `.cmd` `.ps1` `.exe` `.jar` `.sql` con form parametri, output stdout/stderr in streaming live (SSE), audit completo su DB, log file rotanti. Pattern "1 utente = 1 processo" con bottone Kill esplicito e watchdog `max_runtime_seconds`. Console processi admin per kill e replay.

**REST caller** — chiama endpoint HTTP esterni con auth `none` / `bearer` / `basic` / `api-key-header`, parametri dinamici dal form utente, risposta mostrata nell'UI.

**SQL caller** — esegue template SQL parametrici read-only su una connessione salvata.

Ogni app generata appare nella sidebar dinamica raggruppata per `category`, gestita con permessi stile Django (user_apps + group_apps con read/create/update/delete/run, unione OR fra utente e gruppi). Layout maschera a 2 colonne con `col_span` e "attacca al precedente", regole IF condizionali in JavaScript lato browser (visible/required/readonly/secret/label) per UX dinamica senza round-trip server.

**Bottoni configurabili** — al posto del classico "Esegui" auto-renderizzato, l'app espone bottoni personalizzati con azioni multiple: `run_main`, `script_runner`, `rest_call`, `sql_query`, `open_link`, `open_app` (cross-app deep-link), `reset_form`, `custom_js`. Ogni bottone ha JSON di configurazione con placeholder `{{key}}` per valori del form.

**REST API esterna** `/api/v1/*` autenticata con header `X-API-Key` (chiave per utente, hash SHA-256 in DB) — espone meta, list, run di ogni app generata. **MCP server** stdio con framing LSP, integrabile in `DexAssistant/servers.json` per esporre CRUD e run come tool MCP.

**Persistenza**: SQLite (admin DB + sessions) per i metadati AppMint (utenti, gruppi, app, permessi, connessioni). Le password PG sono cifrate at-rest con AES-256-GCM (chiave da env o `<DATA_DIR>/.secret-key` auto-generato). Cartella dati centralizzata via `ADMIN_DB_DIR` (consigliata fuori dal progetto per backup/portabilità).

**Sicurezza**: bcrypt cost 12 sulle password utente, force-change password al primo accesso, sessioni firmate persistenti su SQLite (HttpOnly + SameSite=Lax + Secure in production), validazione regex `^[A-Za-z_][A-Za-z0-9_$]*$` su tutti gli identifier SQL prima di interpolazione, parametri `$N` ovunque, `ORDER BY` validato contro la lista colonne note, middleware `requireLogin/requireAdmin/requireAppPermission`.

**HTTPS nativo** opzionale (cert/key da `.env` con script `npm run cert:self-signed`) oppure reverse proxy con Caddy/Nginx/IIS davanti al servizio Node. Multi-language IT/EN, tema dark/light persistito in localStorage. Stack: Node.js >= 18, Express, better-sqlite3, pg + mysql2/promise, bcryptjs, AES-256-GCM. Deploy come servizio Windows con NSSM via gli script `deploy-service.bat` / `undeploy-service.bat` inclusi.