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

Sei nuovo? Inizia dalla guida Quick Start per avere il sistema operativo in meno di 5 minuti.

Sezione Descrizione
Quick Start Installazione rapida e primo avvio
API Reference Tutti i 46 endpoint documentati
Funzionalità Scanner MRZ, Alloggiati Web, Dashboard e altro
CLI Interfaccia a riga di comando
Deployment Deploy su Vercel, VPS e ambienti di produzione

Funzionalità principali

Scanner MRZ

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

Alloggiati Web

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

Dashboard Analytics

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

Progressive Web App

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

CLI

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

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[Template Engine] B -->|SMTP| G[Email]

Scopri di più nella sezione Architettura del Sistema.