@elia97/create-db-dashboard

CLI per generare una dashboard web per il monitoraggio e la gestione di database PostgreSQL, con rendering completamente lato server (server-side rendering, SSR).

Nota di sicurezza: Questo pacchetto è progettato per essere utilizzato esclusivamente in ambienti privati o su reti LAN. Tutto il rendering avviene lato server e non vengono esposti dati sensibili al client, ma non sono implementate misure di sicurezza avanzate (autenticazione, rate limiting, ecc.). In locale o in LAN, il rischio è minimo; tuttavia, non esporre la dashboard direttamente su Internet senza prima aggiungere opportune protezioni.

Destinatari e finalità

Questo progetto è rivolto a sviluppatori, studenti e professionisti che desiderano uno strumento rapido e personalizzabile per monitorare database PostgreSQL in ambienti di sviluppo, test o laboratorio. L'obiettivo principale è didattico: il codice è pensato per essere letto, modificato e adattato facilmente.

Come si usa

Creazione di un nuovo progetto

npx @elia97/create-db-dashboard nome-progetto
cd nome-progetto
npm install
npm start

• Dopo npm install la build viene eseguita automaticamente (grazie allo script prepare).
• Se non specifichi nome-progetto, verrà usato my-db-dashboard come nome di default.

Aggiunta di una nuova entità (pagina per una tabella)

Dopo esserti spostato nella cartella del progetto:

npx @elia97/create-db-dashboard create nomeTabella

Caratteristiche

• Dashboard web moderna per PostgreSQL
• Visualizzazione stato, tabelle, dimensioni, query lente/bloccate
• Struttura pronta per essere personalizzata
• Comandi CLI semplici e veloci

Sicurezza e architettura

• Tutto il rendering delle pagine avviene lato server (SSR), senza logica sensibile lato client.
• Il progetto non implementa autenticazione, autorizzazione o protezioni avanzate.
• In ambienti locali o LAN, la superficie d'attacco è minima, ma non pubblicare la dashboard su Internet senza prima integrare meccanismi di sicurezza adeguati.
• Per utilizzi in produzione o su reti pubbliche, si raccomanda di aggiungere autenticazione, HTTPS, e altre best practice di sicurezza.

Licenza e scopo

Questo progetto è rilasciato con licenza UNLICENSED ed è destinato esclusivamente a scopo personale, didattico o di laboratorio. L'autore declina ogni responsabilità per usi impropri o in ambienti di produzione pubblici.