Case Torri
Case Torri, cooperativa che affitta stanze e appartamenti condivisi agli studenti universitari di Bologna, aveva bisogno di un catalogo di annunci che cambia ogni settimana. Abbiamo sviluppato un portale su misura in Next.js con pannello di gestione e API separati: lo staff pubblica in autonomia e le pagine si aggiornano pochi istanti dopo il salvataggio.
Chi cerca una stanza arriva quasi sempre da Google o da un link condiviso in chat, guarda le foto, controlla la zona e poi telefona, scrive su WhatsApp o chiede un appuntamento. Lo staff, intanto, deve pubblicare un annuncio, cambiare le foto o ritirare una stanza affittata in pochi minuti, senza chiedere a noi.
• Annunci da capire al primo sguardo: foto, zona e prezzo devono essere chiari subito, anche da telefono e con molte immagini per scheda.
• Un catalogo che cambia spesso: stanze che si liberano e si affittano di continuo; lo staff deve aggiornarle da solo e il sito deve mostrarlo subito.
• Link condivisi che non devono rompersi: se un annuncio cambia titolo, il vecchio indirizzo girato su chat e social non può finire su una pagina di errore.
• Gestione separata dal sito pubblico: il pannello dello staff non deve essere esposto insieme alle pagine che vedono gli studenti.
Le pagine degli appartamenti vengono generate in anticipo e servite come HTML statico, quindi si aprono subito. Quando lo staff modifica un annuncio, il backend manda al sito un avviso firmato: il sito verifica la firma e rigenera solo le pagine coinvolte. Il portale resta statico e veloce, ma aggiornato pochi istanti dopo il salvataggio.
• Sito pubblico: Next.js, pagine generate in anticipo e rigenerate su avviso, con metadati e dati strutturati per ogni appartamento.
• Pannello di gestione: applicazione separata per lo staff (annunci, foto, disponibilità).
• API: backend separato che avvisa il sito con una firma HMAC a ogni modifica.
• Indirizzi: storico degli indirizzi di ogni annuncio, con redirect permanente al nuovo.
• Server: container separati su Proxmox per sito e API, dietro Cloudflare, con runbook di rilascio.
Gli interventi: analisi di cosa descrive un annuncio e progettazione del modello dei dati; sito pubblico con elenco degli appartamenti, filtri, mappa, galleria fotografica e richiesta di appuntamento; pannello di amministrazione e API; file robots che dichiara cosa possono leggere motori di ricerca e crawler AI; misura dei clic su telefono e WhatsApp, attiva solo dopo il consenso ai cookie; migrazione dei servizi su container della nostra infrastruttura, con uno script che rigenera le pagine dopo ogni rilascio.
I Risultati
Lo staff pubblica e modifica gli annunci in autonomia, e la modifica è visibile sul sito subito dopo il salvataggio. Le schede sono pagine statiche, quindi restano veloci anche con molte foto. I contatti da telefono e WhatsApp si misurano nel rispetto del consenso dell'utente. Gli indirizzi condivisi in passato continuano a funzionare anche dopo un cambio di titolo. Sito e API girano in container separati su un'infrastruttura gestita con backup.
Non pubblichiamo numeri: per questo progetto non abbiamo raccolto in modo strutturato dati di traffico e di richieste prima e dopo. Raccontiamo solo ciò che possiamo verificare.
Lo schema di aggiornamento con avviso firmato è diventato uno standard interno: lo riusiamo nei progetti in cui il pannello di gestione è separato dal sito pubblico.
Fonte: documentazione tecnica del progetto e runbook di rilascio.
