Ambiente di sviluppo¶
Come si sviluppa BcOK oggi. Questa pagina è pubblica: descrive l'impostazione generale. Come preparare, usare e tenere in ordine l'ambiente è nella documentazione di Pandora Cantiere (repository privato, vedi Dettagli).
In breve¶
- Si sviluppa in locale, su siti Local, con dati inventati: nessuna copia del database di produzione e nessun dato personale reale sul PC di sviluppo.
- Il database lo costruisce un plugin di sviluppo, Pandora Cantiere, che non va mai in produzione. Con un comando ricrea da zero un database completo e realistico (il seed); con un altro lo riporta in pochi secondi allo stato iniziale (il reset).
- Ogni prova parte da dati noti e ripetibili, con gli stessi ID su ogni sito e a ogni reset. Così un bug si riproduce, si corregge e si verifica sugli stessi dati, e gli scenari si possono citare per ID in una issue.
Cosa contiene il database di sviluppo¶
- Configurazione come in produzione: ruoli, tassonomie, modelli dei servizi, pagine, opzioni e plugin attivi. Si esporta dalla produzione con un plugin dedicato, solo da un amministratore e senza credenziali.
- Dati inventati: alcune sedi con funzioni diverse, utenti per ogni ruolo, aziende, persone, servizi e carnet, richieste e segnalazioni, planning e prenotazioni (anche dalle Booking API), comunicazioni di Virtuoso. Ogni dato rappresenta uno scenario preciso: un carnet scaduto, una persona revocata, un cliente di due sedi, una prenotazione rifiutata…
- Il seed crea i dati come l'interfaccia di BcOK, con le stesse richieste REST e come l'utente che lo farebbe davvero: passano dagli stessi controlli dei plugin, e ogni livello verifica da solo il risultato. Quando cambia un comportamento dei plugin, il seed se ne accorge.
- Gli scenari crescono nel tempo: se ne aggiunge uno per ogni bug corretto e per ogni caso d'uso nuovo.
Protezioni¶
- Seed e reset non partono mai in produzione: c'è un doppio controllo, sul tipo di ambiente e sull'indirizzo del sito.
- Nessuna credenziale di produzione fuori dalla produzione: chiavi locali o di test per i servizi esterni (es. Stripe in modalità test).
- Nessuna email esce: in locale email e PEC finiscono in una casella di raccolta (Mailpit).
- Con dati inventati anche gli agenti AI possono leggere il database, riprodurre un bug e ripristinare i dati, senza dati personali da proteggere.
Più siti in parallelo¶
Per lavorare su più cose insieme (un bugfix su un branch, una prova che non deve disturbare il resto) si clona il sito di sviluppo in Local e si rifà il seed sul clone. Ogni sito ha i suoi dati e il suo reset; plugin e tema sono copie git separate, ognuna sul suo branch.
Più avanti¶
Rinviati a un progetto a sé, senza una data:
- Un ambiente di staging pubblico con gli stessi dati inventati, per chi sviluppa applicazioni sulle Booking API.
- Strumenti per far lavorare gli agenti AI sul sito locale in modo controllato.
Dettagli¶
Nel repository privato Ottomedia/pandora-cantiere (accesso per il team Ottomedia):
- README: preparare un sito, comandi, livelli del seed e scenari, reset, più siti in parallelo, aggiornare la configurazione.
- docs/progetto.md: obiettivo, decisioni e piano di lavoro; docs/diario.md: diario delle sessioni.
Per velocizzare Local con un database grande: Miglioramenti al setup di Local.