Il Carrubo

Il Property Management System full-stack per strutture ricettive.

Il Carrubo è un PMS moderno e completo, progettato per semplificare la gestione di prenotazioni, ospiti, documenti e comunicazioni con le autorità. Costruito con Node.js/Express sul backend, Supabase come database e autenticazione, e un frontend in vanilla JavaScript — leggero, veloce e senza dipendenze pesanti.


Il Carrubo in numeri

Metrica Valore
Endpoint API 46
Pagine Frontend 20+
Prenotazioni Gestite 500+
Documenti Scansionati 1.000+
Uptime 99,9%

Inizia subito

::: callout[tip]
Sei nuovo? Inizia dalla guida Quick Start per avere il sistema operativo in meno di 5 minuti.
:::

Sezione Descrizione
<i class=“fa-solid fa-rocket”></i> Quick Start Installazione rapida e primo avvio
<i class=“fa-solid fa-code”></i> API Reference Tutti i 46 endpoint documentati
<i class=“fa-solid fa-wand-magic-sparkles”></i> Funzionalità Scanner MRZ, Alloggiati Web, Dashboard e altro
<i class=“fa-solid fa-terminal”></i> CLI Interfaccia a riga di comando
<i class=“fa-solid fa-cloud”></i> Deployment Deploy su Vercel, VPS e ambienti di produzione

Funzionalità principali

<i class=“fa-solid fa-camera”></i> Scanner MRZ

Scansione automatica dei documenti d’identità tramite fotocamera o upload. Estrazione dei dati dalla Machine Readable Zone (MRZ) con riconoscimento OCR integrato.

<i class=“fa-solid fa-building-columns”></i> Alloggiati Web

Invio automatico delle schedine alloggiati alla Questura tramite protocollo SOAP. Conforme alla normativa italiana per le strutture ricettive.

<i class=“fa-solid fa-chart-line”></i> Dashboard Analytics

Pannello di controllo con statistiche in tempo reale su prenotazioni, check-in/check-out, occupazione e revenue. Grafici interattivi e report esportabili.

<i class=“fa-solid fa-mobile-screen”></i> Progressive Web App

Installabile su qualsiasi dispositivo come app nativa. Funziona offline per le operazioni critiche e si aggiorna automaticamente.

<i class=“fa-solid fa-terminal”></i> CLI

Interfaccia a riga di comando per operazioni batch, automazione e gestione avanzata del sistema direttamente dal terminale.

<i class=“fa-solid fa-shield-halved”></i> Admin

Pannello di amministrazione per la gestione di utenti, impostazioni, feature flags e manutenzione del sistema.


Architettura a colpo d’occhio

graph LR A[Browser / PWA] -->|HTTP/REST| B[Express Server] B -->|SQL| C[Supabase PostgreSQL] B -->|SOAP| D[Questura] B -->|OCR| E[OCR.Space] B -->|PDF| F[APITemplate.io] B -->|SMTP| G[Email]

Scopri di più nella sezione Architettura del Sistema.