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.

Pubblicato Aggiornato
  • Next.js
  • Cloudflare
  • Supporto multilingue
  • Sviluppo web
  • Migrazione del sito web

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

Architettura dei servizi, illustrazione originale in giapponese

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

Rilascio in otto passi, originale in giapponese

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.

Alternative a WordPress ispirate alle vulnerabilità PHP

Confronta se continuare con WordPress o passare a un sito statico o a un CMS gestito. Spiegheremo il WAF di Cloudflare, il modulo di richiesta e gli esempi di prezzi per uso generale e aziendale con illustrazioni.

Commenti 0

Non indica nazionalità o residenza. Le VPN possono influire.

Nessun contenuto ancora.

Nome, messaggio e paese di connessione saranno pubblici dopo approvazione. Non inserire dati personali.