SANGE Studio passa a Next.js: architettura e tre serate fino al rilascio
Ho migrato il sito SANGE Studio da HTML statico a Next.js tra l'11 e il 13 novembre 2026, dedicando circa tre o quattro ore al giorno dopo il lavoro. URL esistenti e contenuti in 12 lingue sono rimasti disponibili; bozze, anteprime e pubblicazione si gestiscono ora dal browser. Ecco l'architettura, i servizi Cloudflare e il percorso fino al rilascio.
Ho migrato il sito SANGE Studio da HTML statico a Next.js tra l'11 e il 13 novembre 2026, dedicando circa tre o quattro ore al giorno dopo il lavoro. URL esistenti e contenuti in 12 lingue sono rimasti disponibili; bozze, anteprime e pubblicazione si gestiscono ora dal browser. Ecco l'architettura, i servizi Cloudflare e il percorso fino al rilascio.
Perché migrare?
Il sito precedente usava HTML, CSS, JavaScript e script Python per generare pagine in anticipo. Poteva già presentare applicazioni, documenti legali e articoli, ma ogni modifica richiedeva di mantenere coerenti elenchi, traduzioni e sitemap. Con 12 lingue, i controlli erano numerosi.
Ho separato i dati degli articoli dalla generazione delle pagine e portato il blog in un database. Il flusso desiderato è scrivere, salvare una bozza, controllare l'aspetto e infine pubblicare.
Il compito di Next.js
Next.js è un framework per sviluppare applicazioni web con React. Qui fornisce pagine pubbliche e interfaccia amministrativa. Il server legge i dati e restituisce HTML contenente il testo: rendering lato server, o SSR. I lettori continuano a usare gli stessi URL; chi scrive gestisce bozze e stati di pubblicazione invece di singoli file HTML.
I servizi Cloudflare
Cloudflare offre distribuzione e protezione dei siti, esecuzione di applicazioni e archiviazione. Quattro servizi hanno compiti distinti.
Workers: eseguire il programma
Cloudflare Workers esegue codice sulla rete Cloudflare. L'infrastruttura è gestita dal servizio: non devo predisporre una macchina server e mantenere il sistema operativo. Workers recupera articoli, costruisce pagine ed elabora richieste dall'editor.
D1: conservare articoli e traduzioni
Cloudflare D1 è un database: organizza informazioni e permette di recuperarle secondo condizioni. Conserva titoli, testi, lingue, bozze, versioni pubblicate e cronologia. Può restituire gli articoli pubblicati in inglese o la versione giapponese di un articolo.
R2: conservare immagini caricate
Cloudflare R2 archivia file. D1 contiene i dati degli articoli, R2 le immagini caricate dal pannello. Immagini precedenti e CSS continuano a essere distribuiti come file statici.
Access: limitare l'amministrazione
Cloudflare Access controlla chi può entrare in un'applicazione web. Leggere non richiede accesso, modificare sì. L'applicazione verifica inoltre autenticazione e legittimità delle richieste di salvataggio.
Come si collegano i componenti
Il diagramma è in giapponese. I lettori entrano nel sito pubblico; gli amministratori passano da Access. Entrambe le interfacce usano Workers, collegato a D1, R2 e file statici.
Aprendo un articolo, Workers legge il testo pubblicato da D1 e restituisce la pagina. Le immagini arrivano da R2 o dai file statici. Dopo l'accesso tramite Access, le modifiche passano da Workers a D1.
OpenNext prepara Next.js per Workers. Non tutte le pagine sono nel database: presentazioni delle applicazioni e documenti legali usano dati estratti dal vecchio HTML e si aggiornano ancora tramite Git, un sistema di controllo versione. L'editing nel browser riguarda soprattutto il blog.
Separare bozze e pubblicazione
Il pannello permette di creare articoli, salvare bozze, visualizzare anteprime, pubblicare, tradurre e gestire immagini. Salvare una bozza non cambia ciò che il lettore vede. Solo la pubblicazione, dopo la revisione, sostituisce la versione pubblica.
La cronologia viene conservata e una versione precedente può diventare una nuova bozza. Ogni lingua ha bozza e stato propri. Il testo supporta HTML e Markdown, una vista formattata per titoli, immagini e tabelle, modifica del sorgente e anteprima dei contenuti salvati.
Tempo impiegato
Il lavoro è durato tre giorni, dall'11 al 13 novembre 2026, circa tre o quattro ore ogni sera: in totale nove–dodici ore. È una stima, non una misura cronometrata. Articoli, traduzioni, immagini e design esistevano già; non era la costruzione di un intero sito da zero. Le singole fasi non sono state misurate separatamente.
| Data | Lavoro principale |
|---|---|
| 11 novembre | Analisi del sito e dei dati multilingue; progettazione |
| 12 novembre | Pagine pubbliche, editor e verifiche locali |
| 13 novembre | Preparazione produzione, rilascio, separazione amministrazione e controlli |
Otto passi fino al rilascio
L'illustrazione giapponese riassume i passaggi seguenti.
1. Inventariare il sito
Ho verificato 300 URL pubblici, pagine 404 in 12 lingue e sette articoli con 84 versioni linguistiche. URL, testi, immagini e metadati per i motori di ricerca hanno formato la lista di controllo.
2. Progettare struttura e dati
D1 gestisce articoli e traduzioni, R2 nuove immagini e Workers la logica. Ho definito bozze, versioni pubbliche, cronologia e stati per lingua, separando salvataggio e pubblicazione.
3. Preparare l'ambiente locale
Docker Compose offre un ambiente separato dalla produzione. Docker esegue programmi insieme all'ambiente necessario. Ho potuto provare salvataggi e caricamenti senza cambiare gli articoli pubblici. Sviluppo su Windows e build di produzione su Linux.
4. Realizzare pagine e funzioni
Ho importato i contenuti e implementato visualizzazione, modifica e pubblicazione, mantenendo titoli, immagini, tabelle e pagine per lingua. Link e segnalibri restano utilizzabili; i vecchi URL di selezione della lingua hanno ricevuto reindirizzamenti.
5. Eseguire test e verificare l'ambiente di collaudo
Test automatici e ambiente separato hanno coperto salvataggio, pubblicazione, traduzioni, immagini, URL, lingue e sitemap. Ho controllato anche il rifiuto delle operazioni non autorizzate e l'isolamento delle bozze dai contenuti pubblicati.
6. Preparare la produzione
D1 e R2 di produzione sono stati separati dai test, gli articoli importati e Access configurato. L'autenticazione è stata verificata sulla build di produzione prima del rilascio.
7. Fare backup e passare gradualmente
Ho salvato i dati e verificato la coerenza. Prima ho collegato e provato l'amministrazione, poi spostato il sito pubblico sul nuovo Worker. La configurazione precedente è rimasta disponibile per tornare indietro. In seguito l'amministrazione è passata a un dominio dedicato.
8. Controllare gli URL reali
Dopo il passaggio ho verificato pagine, 404 localizzati, URL canonici, sitemap, immagini, database e protezione amministrativa. Successivamente ho aggiornato Node.js e dipendenze, ricompilato, testato e distribuito. Sono stati ricontrollati 300 URL pubblici e 61 file statici.
Risultati e aspetti da misurare
Il blog dispone ora di editing dal browser conservando URL e contenuti multilingue. Bozze, traduzioni, immagini e versioni pubbliche fanno parte dello stesso flusso. Gli effetti su posizionamento e velocità devono ancora essere misurati: il sito precedente forniva già il testo in HTML. La modifica concreta riguarda editing e gestione dei dati.
L'infrastruttura gestita non elimina aggiornamenti applicativi, permessi e backup. Continuerò a migliorare l'editor scrivendo e traducendo nuovi articoli.
Architettura e registri di migrazione aggiornati al 13 novembre 2026. I servizi rimandano alla documentazione ufficiale di Cloudflare.
Commenti 0
Non indica nazionalità o residenza. Le VPN possono influire.
Nessun contenuto ancora.