# Un gestionale per sapere se la struttura sta guadagnando.

> Una struttura residenziale per anziani autosufficienti, 25 ospiti e solo rette private. Il titolare ci ha chiesto una cosa precisa: una foto onesta del presente, cioè sapere se la struttura guadagna.

- Settore: Strutture residenziali
- Ambito: Sviluppo software
- Stato: In corso
- URL: https://cloudfactory.it/lavori/gestionale-struttura-residenziale/

## In breve

Per una struttura residenziale per anziani autosufficienti stiamo costruendo un gestionale in Laravel 13 e Filament 5. Il database stesso impedisce due soggiorni aperti sullo stesso letto, le tariffe si concordano per soggiorno e il primo periodo tariffario si crea da solo. Il piano è diviso in dieci lotti, fino a una dashboard costruita su chiusure mensili congelate, per competenza e per cassa. È la stessa struttura in cui avevamo già realizzato la rete.

- **25** ospiti autosufficienti
- **15** camere, per 25 posti letto
- **10** lotti di sviluppo nel piano
- **2** lotti in produzione da maggio 2026

## Contesto

La struttura ospita 25 persone autosufficienti in 15 camere, tra singole e doppie, per 25 posti letto. Le rette sono solo private: nessuna convenzione, nessun rimborso pubblico. Il cliente ci conosceva già, perché la rete dell'edificio l'abbiamo progettata e installata noi.

## Il problema

Con le sole rette private, il risultato della struttura dipende da poche variabili: quanti letti sono occupati, a quale tariffa, quanto costa la gestione. Ma tra ingressi a metà mese, camere doppie, depositi e pagamenti, capire se un mese è andato bene voleva dire rimettere insieme dati sparsi. E un mese già chiuso che si può ancora modificare rende inaffidabile anche il confronto con il passato.

## Cosa abbiamo fatto

1. **Regole nel database, non solo nell'interfaccia.** Su ogni letto può esserci un solo soggiorno aperto: lo garantisce un vincolo del database, così nemmeno un errore del codice o un'importazione possono assegnare lo stesso letto a due ospiti.
2. **Tariffe concordate per soggiorno.** La retta si concorda per ogni soggiorno, con tariffe diverse per camera singola e doppia. Quando si apre un soggiorno, il primo periodo tariffario si crea da solo; i cambi successivi si aggiungono come nuovi periodi.
3. **Dieci lotti, uno alla volta.** Motore delle tariffe, fatturazione mensile, contatti e depositi, pagamenti e note, costi, chiusure mensili, dashboard, ruoli e impostazioni. Ogni lotto va in produzione quando è completo, senza aspettare gli altri.
4. **Mesi chiusi che non cambiano.** Ogni mese si chiude con una fotografia congelata, letta in due modi: per competenza, cioè quello che il mese ha prodotto, e per cassa, cioè quello che è entrato davvero.
5. **Rilasci senza interruzioni.** Database MariaDB e rilasci con Laravel Forge senza tempi di fermo. L'accesso al pannello è limitato a due domini email aziendali.

## Com'è andata

I primi due lotti sono in produzione da maggio 2026, gli altri sono in lavorazione. Il passo successivo è una simulazione del punto di pareggio a gradini: quanti letti occupati servono, e a quali tariffe, perché la struttura stia in attivo.

## Strumenti

Laravel 13, Filament 5, MariaDB, Laravel Forge

## Domande frequenti

### Perché non un software per RSA già pronto?

Perché molti pacchetti sono pensati per strutture convenzionate, con tariffe regionali e flussi verso l'ASL. Qui ci sono solo rette private e una domanda precisa del titolare: la struttura guadagna?

### Cosa vuol dire competenza e cassa?

Per competenza si guarda quanto ha prodotto il mese, anche se non è ancora stato incassato; per cassa quanto è entrato davvero. Servono entrambe: la prima dice se la struttura guadagna, la seconda se ha la liquidità per pagare.

### Perché un pareggio a gradini?

Perché i costi non crescono in modo continuo: oltre una certa soglia di ospiti cambiano personale e spese, e il punto di pareggio si sposta. Una simulazione a gradini rende visibili queste soglie.

---

Cloudfactory S.r.l., Roma. Contatti: hello@cloudfactory.it
