Quick Start
Avvia Il Carrubo in meno di 5 minuti seguendo questa guida rapida.
Prerequisiti
Prima di iniziare, assicurati di avere installato:
| Requisito | Versione minima | Note |
|---|---|---|
| Node.js | >= 18.0.0 | Consigliata l’ultima LTS |
| npm | >= 9.0.0 | Incluso con Node.js |
| Account Supabase | — | Piano gratuito sufficiente per sviluppo |
::: callout[tip]
Puoi verificare le versioni installate con node -v e npm -v nel terminale.
:::
Installazione
Clona il repository
git clone https://github.com/cristianobleve/il-carrubo-edit.git
cd il-carrubo-edit
Questo scarica l’intero codice sorgente del progetto nella directory il-carrubo-edit.
Installa le dipendenze
npm install
Installa tutti i pacchetti necessari definiti in package.json, inclusi Express, il client Supabase, i parser MRZ e tutte le altre dipendenze.
Configura le variabili d’ambiente
cp .env.example .env
Apri il file .env e inserisci le credenziali minime richieste:
SUPABASE_URL=https://tuo-progetto.supabase.co
SUPABASE_KEY=la-tua-anon-key
SUPABASE_SERVICE_ROLE_KEY=la-tua-service-role-key
SUPABASE_DB_URL=postgresql://postgres:password@db.tuo-progetto.supabase.co:5432/postgres
API_KEY=una-chiave-api-sicura
::: callout[warning]
Non committare mai il file .env nel repository. È già incluso nel .gitignore.
:::
Consulta la guida completa sulle Variabili d’Ambiente per tutte le opzioni disponibili.
Avvia il server di sviluppo
npm run dev
Il server si avvia con nodemon per il ricaricamento automatico. Vedrai la GUI del terminale basata su blessed con log in tempo reale, statistiche e stato del sistema.
Apri l’applicazione
Apri il browser all’indirizzo:
http://localhost:3000
Dovresti vedere la pagina di login de Il Carrubo. Usa le credenziali configurate nel tuo progetto Supabase per accedere.
Prossimi passi
| Guida | Descrizione |
|---|---|
| Installazione & Setup | Guida dettagliata con setup Supabase e database |
| Variabili d’Ambiente | Tutte le variabili di configurazione |
| Architettura | Come è strutturato il sistema |
| API Reference | Documentazione completa delle API |
::: callout[note]
Per ambienti di produzione, consulta la guida al Deployment per configurazioni ottimizzate, SSL e deploy su Vercel.
:::