Area amministratore
Manuale amministratore
Guida operativa per usare il portale HOME SERVICES By CHANEL.
1. Accesso al pannello amministratore
Indirizzo area admin
Aprire il sito e cliccare su Admin, oppure visitare direttamente:
https://hschanel.com/admin.html
Se il dominio non e ancora collegato, usare l'indirizzo Render:
https://hsc-422z.onrender.com/admin.html
Login
1. Inserire la password amministratore.
2. Premere Entra.
3. Dopo il login si apre il pannello di gestione.
La password non e scritta nel sito pubblico: viene configurata nelle variabili ambiente del servizio Render come ADMIN_PASSWORD.
2. Struttura del pannello
L'area amministratore contiene queste sezioni:
Calendario: vista globale delle prenotazioni e richieste.
Prenotazioni: inserimento, conferma, pagamento ed eliminazione prenotazioni.
Movimenti: gestione incassi, spese, filtri ed esportazione.
Backup dati: esportazione e importazione dei dati del portale.
In alto sono mostrati anche i riepiloghi: numero prenotazioni, richieste in attesa, incassi, importi da pagare e saldo.
3. Calendario amministratore
Il calendario amministratore mostra tutte le prenotazioni dei quattro appartamenti: BOARA-15, BOARA-16, BASSANO e SANTO DOMINGO.
Colori del calendario
Libero: nessuna prenotazione o richiesta.
Richiesto: richiesta ricevuta ma non ancora confermata.
Prenotato: prenotazione confermata.
Filtro appartamento
Il menu Filtro permette di vedere tutti gli appartamenti oppure un singolo appartamento.
Dettagli giorno
Cliccando su un giorno del calendario, a destra appare il pannello Dettagli giorno con cliente, contatti, appartamento, periodo, arrivo/soggiorno/partenza, persone, stato, pagamento, note e importo.
Giorno di arrivo e partenza
Se un cliente parte lo stesso giorno in cui un altro cliente arriva, il calendario amministratore mostra entrambi: uno come Partenza e uno come Arrivo.
4. Nuova prenotazione dall'amministratore
La sezione Nuova prenotazione serve per inserire manualmente una prenotazione o una richiesta.
Campi disponibili: appartamento, arrivo, partenza, numero persone, ospite, email, prefisso, cellulare, stato, incasso previsto, annotazioni e pagamento.
Premere Salva prenotazione. Il sistema controlla automaticamente se lo stesso appartamento e lo stesso periodo sono gia occupati.
Regola anti doppia prenotazione
Non e possibile prenotare lo stesso appartamento nello stesso periodo per due clienti diversi. E' invece possibile avere un cliente che parte il giorno 10 e un nuovo cliente che arriva il giorno 10.
5. Elenco prenotazioni
La tabella mostra periodo, appartamento, cliente, persone, prezzo, annotazioni, pagamento, stato e azioni.
Accetta
Visibile solo per le richieste. Quando si preme Accetta, la richiesta diventa prenotazione confermata e, se SMTP e configurato, parte una email al cliente.
Segna pagato / Segna da pagare
Permette di cambiare lo stato pagamento.
Esporta e crea incasso
Il pulsante Esporta Excel prenotazioni scarica l'elenco completo. Il pulsante Crea incasso genera un movimento collegato alla prenotazione e non viene piu mostrato quando il movimento e gia presente.
Elimina
Elimina la prenotazione e libera il periodo. Usare con attenzione.
6. Movimenti, incassi e spese
La sezione Movimenti serve per controllare la contabilita.
Nel modulo Spese e incassi compilare tipo, appartamento, date, nome persona, numero persone, importo, pagamento, descrizione e annotazioni.
Quando l'amministratore inserisce una prenotazione con importo maggiore di zero, il sistema crea anche un movimento di incasso.
7. Filtri movimenti
La tabella movimenti puo essere filtrata per appartamento, data ingresso, data uscita, nome persona, importo minimo e stato pagamento.
Il pulsante Azzera filtri rimuove tutti i filtri.
8. Esportazione movimenti
Sono disponibili Esporta CSV e Esporta Excel. L'esportazione rispetta i filtri impostati.
8.1 Database indirizzi
La sezione Indirizzi crea automaticamente una rubrica clienti partendo da richieste e prenotazioni. Per ogni contatto vengono salvati nome in maiuscolo, email, cellulare, indirizzo, citta, nazione, appartamenti collegati, primo e ultimo soggiorno, numero prenotazioni e annotazioni.
Premere Esporta Excel indirizzi per scaricare la rubrica in formato Excel.
8.2 Log amministratore
La sezione Log registra richieste cliente, accettazioni prenotazioni, aggiornamenti dati e ripristini backup.
9. Backup e ripristino dati
Prima di ogni aggiornamento importante e buona pratica scaricare un backup.
Backup automatico settimanale
Il server crea automaticamente un backup al giorno nella cartella persistente /var/data/backups. I file sono sette, uno per ogni giorno della settimana: backup-lunedi.json, backup-martedi.json, backup-mercoledi.json, backup-giovedi.json, backup-venerdi.json, backup-sabato.json e backup-domenica.json.
Alla settimana successiva il file dello stesso giorno viene sovrascritto, cosi lo spazio occupato resta limitato. Il fuso orario predefinito e Europe/Rome.
Il pulsante Scarica backup automatico permette di salvare sul computer il backup selezionato.
Ripristinare un backup automatico
Nella parte alta del pannello amministratore, scegliere un file nel menu Backup automatico e premere Ripristina backup automatico. Il portale chiede conferma e poi la password dedicata Restore prima di sostituire i dati attuali.
Esportare backup dati
Entrare nell'area amministratore e premere Esporta backup dati. Il browser scarica un file JSON.
Importare backup dati
Premere Importa backup dati e selezionare il file JSON salvato. Il ripristino sostituisce i dati presenti con quelli del backup.
Regola pratica consigliata
Fare un backup prima di ogni deploy, dopo molte prenotazioni e almeno una volta a settimana.
10. Persistenza dati su Render
Per non perdere prenotazioni e movimenti, Render deve usare un Disk persistente.
DATA_DIR=/var/data
Il Disk deve essere collegato con mount path:
/var/data
Controllo tecnico
Dopo il login admin, aprire:
https://hsc-422z.onrender.com/api/admin/storage
Il risultato corretto deve indicare dataDir: "/var/data" e renderDiskDetected: true.
11. Email di conferma prenotazione
Quando una richiesta viene accettata, il sistema puo inviare una email di conferma al cliente.
SMTP_HOST= SMTP_PORT=465 SMTP_USER= SMTP_PASS= SMTP_FROM=
Esempio Gmail:
SMTP_HOST=smtp.gmail.com SMTP_PORT=465 SMTP_USER=nome@gmail.com SMTP_PASS=password-app-gmail SMTP_FROM=HOME SERVICES By CHANEL <nome@gmail.com>
Per Gmail serve una password per app, non la password normale dell'account.
12. Calendario pubblico e disponibilita
Il calendario pubblico mostra ai visitatori lo stato degli appartamenti senza dati personali. Nome cliente, email, cellulare, importi e note sono visibili solo all'amministratore.
13. Prenotazioni dal portale pubblico
Il visitatore puo inviare una richiesta compilando appartamento, arrivo, partenza, numero persone, nomi persone, email, prefisso, cellulare e annotazioni.
La richiesta arriva come Richiesto e deve essere accettata dall'amministratore.
14. Lingue disponibili
Il portale pubblico supporta italiano, spagnolo, inglese e russo. L'area amministratore resta in italiano.
15. Dominio hschanel.com
Il dominio deve essere collegato a Render tramite DNS, non tramite redirect mascherato.
www CNAME hsc-422z.onrender.com @ A 216.24.57.1
Non usare redirect mascherato, URL frame o cloak.
16. Procedura consigliata prima di ogni aggiornamento
1. Entrare in admin.
2. Premere Esporta backup dati.
3. Verificare che il file JSON sia stato scaricato.
4. Fare il deploy.
5. Controllare che prenotazioni e movimenti siano ancora presenti.
6. Se mancano dati, usare Importa backup dati.
17. Procedura di pubblicazione aggiornamenti
cd "/c/Users/studi/Documents/Codex/2026-05-27/devo-sviluppare-un-portale-con-home" git add . git commit -m "Aggiornamento portale" git push origin render-deploy
Se Render non pubblica automaticamente, usare Manual Deploy e Deploy latest commit.
18. Problemi comuni
Ho perso le prenotazioni dopo un deploy
Controllare /api/admin/storage, verificare DATA_DIR e importare l'ultimo backup JSON.
Il cliente non riceve email
Controllare configurazione SMTP e log Render.
Il dominio mostra connessione negata
Probabile redirect mascherato: eliminare redirect/iframe e configurare DNS diretto su Render.
Il calendario pubblico sembra occupato nel giorno di partenza
E' normale: il calendario mostra una movimentazione. Il sistema permette comunque un nuovo arrivo lo stesso giorno della partenza se i periodi non si sovrappongono.
19. Buone pratiche
Fare backup regolari.
Non condividere la password admin.
Controllare periodicamente i movimenti.
Inserire annotazioni utili per arrivo, orari e richieste speciali.
Prima di ogni deploy, esportare il backup.
20. Riepilogo rapido
Controllare disponibilita, inserire o accettare prenotazioni, verificare pagamenti, registrare movimenti, esportare CSV/Excel, fare backup e verificare che Render usi /var/data.