Banyak perusahaan skala besar masih mengoperasikan aplikasi monolitik warisan (legacy monolith) yang dibangun di atas platform PHP (Laravel lawas, WordPress kustom, Magento 1) atau Java Spring Boot beberapa tahun silam. Sistem monolitik ini biasanya menyimpan seluruh logika bisnis krusial perseroan, namun semakin sulit dirawat: waktu build membengkak, coupling antar-modul sangat ketat, dan kinerja rendering antarmuka di perangkat mobile jauh tertinggal dari standar Core Web Vitals modern.
Ketika manajemen memutuskan untuk melakukan modernisasi ke arsitektur headless modern berbasis Next.js App Router, godaan terbesar tim engineering adalah melakukan perombakan total dari nol (Big Bang Rewrite).
Pengalaman industri menunjukkan bahwa metode Big Bang Rewrite sangat berisiko: proyek memakan waktu 12 hingga 24 bulan, rilis fitur baru bisnis terpaksa dibekukan (feature freeze), estimasi biaya meleset, dan saat peluncuran sistem baru dilakukan serentak, bug tak terduga kerap melumpuhkan operasional.
Pendekatan paling aman dan terbukti adalah menerapkan Strangler Fig Pattern.
Evolusi Strangler Fig Pattern:
Fase 1: Inisiasi Proxy Edge
Klien ──► [Edge Proxy Router (Cloudflare / NGINX)]
│ (100% Trafik Awal)
▼
[Legacy Monolith PHP/Java]
Fase 2: Migrasi Rute Bertahap (Inkremental)
Klien ──► [Edge Proxy Router]
├─► Rute /blog, /katalog, /produk ──► [Aplikasi Headless Next.js Baru]
└─► Rute /checkout, /akun, /erp ──► [Legacy Monolith PHP/Java]
Fase 3: Pembongkaran Akhir (Decommissioning)
Klien ──► [Edge Proxy Router]
│ (100% Trafik Beralih Penuh)
▼
[Ekosistem Headless Next.js & Microservices Baru]
(Legacy Monolith Dinonaktifkan dengan Aman!)
Prinsip Kerja Strangler Fig Pattern #
Pola ini dinamai berdasarkan pohon ara pencekik (Strangler Fig) di alam tropis yang tumbuh mengelilingi pohon inang perlahan-lahan dari luar hingga akhirnya menggantikan pohon inang tersebut sepenuhnya.
Dalam arsitektur software, implementasi dilakukan dengan:
- Menempatkan lapisan perute cerdas (Edge Proxy Router) di depan sistem lama.
- Membangun aplikasi baru di samping sistem lama.
- Memindahkan satu demi satu fungsi atau rute URL dari monolitik ke aplikasi baru.
- Pengguna akhir tidak menyadari perpindahan ini karena URL publik tetap sama persis.
- Setelah seluruh fungsionalitas berpindah, monolitik lama dapat dimatikan dengan aman.
Lapisan Perutean: Konfigurasi NGINX / Cloudflare Reverse Proxy #
Kunci utama dari Strangler Fig adalah router yang mampu membagi trafik berdasarkan pola URL (path-based routing).
Contoh konfigurasi NGINX pada server gateway:
upstream legacy_monolith {
server 10.0.0.10:8080; # Server PHP / Java Monolith Lama
keepalive 32;
}
upstream modern_nextjs {
server 10.0.0.20:3000; # Server Next.js Baru
keepalive 32;
}
server {
listen 443 ssl http2;
server_name www.perusahaan.co.id;
# 1. Rute yang sudah dimigrasikan ke Next.js (Fase 1 & 2)
location / {
# Fallback bawaan: arahkan ke Next.js untuk beranda dan halaman publik
proxy_pass http://modern_nextjs;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location /blog {
proxy_pass http://modern_nextjs;
proxy_set_header Host $host;
}
location /produk {
proxy_pass http://modern_nextjs;
proxy_set_header Host $host;
}
# 2. Rute kompleks yang masih berada di Monolith Lama
location /checkout {
proxy_pass http://legacy_monolith;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
location /portal-klien {
proxy_pass http://legacy_monolith;
proxy_set_header Host $host;
}
location /admin-panel {
proxy_pass http://legacy_monolith;
proxy_set_header Host $host;
}
}
Dengan konfigurasi di atas, tim dapat meluncurkan halaman katalog dan blog menggunakan Next.js App Router untuk meraup skor Core Web Vitals 90+ dan peringkat SEO tinggi, sementara modul checkout transaksi yang rumit tetap diproses oleh kode monolitik yang sudah stabil.
Menjembatani Autentikasi dan Berbagi Sesi Pengguna #
Tantangan terbesar ketika pengguna berpindah antara halaman Next.js dan halaman monolitik lama adalah sinkronisasi sesi login (session sharing).
Jika pengguna login di monolitik lama (misalnya session cookie PHP PHPSESSID), halaman Next.js harus mampu mengenali identitas pengguna tersebut tanpa memaksa login ulang:
Pola Token Exchange Adapter #
- Saat pengguna login di halaman
/login(monolitik), sistem lama menerbitkan JWT terenkripsi yang disimpan dalam cookie lintas domain dengan atributHttpOnly; Secure; SameSite=Lax. - Middleware Next.js membaca cookie JWT tersebut untuk memvalidasi sesi dan merender komponen header pengguna (nama akun, status member).
- Jika backend monolitik belum mendukung JWT, buat endpoint internal kecil di monolitik (
/api/internal/verify-session) yang dipanggil oleh server Next.js melalui jalur privat untuk memvalidasi cookie lama.
Contoh middleware Next.js untuk autentikasi transisi:
// middleware.ts pada Next.js
import { NextResponse } from 'next/server';
import type { NextRequest } from 'next/request';
export async function middleware(request: NextRequest) {
const sessionToken = request.cookies.get('app_session_token')?.value;
// Verifikasi sesi ke adapter autentikasi internal jika rute privat diakses
if (request.nextUrl.pathname.startsWith('/dashboard-baru')) {
if (!sessionToken) {
return NextResponse.redirect(new URL('/login', request.url));
}
// Validasi token via internal call
const verifyRes = await fetch('http://10.0.0.10:8080/api/internal/session-check', {
headers: { Authorization: `Bearer ${sessionToken}` },
});
if (!verifyRes.ok) {
return NextResponse.redirect(new URL('/login', request.url));
}
}
return NextResponse.next();
}
Tahapan Migrasi Inkremental yang Dianjurkan #
Untuk memastikan kesuksesan transisi tanpa mengganggu arus pendapatan perseroan, ikuti urutan fase migrasi berikut:
- Fase 1: Halaman Konten Statis dan Pemasaran
Migrasikan Beranda, Tentang Kami, Studi Kasus, dan Blog. Halaman-halaman ini bersifat read-heavy, minim mutasi data, dan memberikan dampak SEO terbesar. - Fase 2: Katalog Produk dan Halaman Detail (PDP)
Katalog produk membutuhkan performa rendering cepat. Ambil data katalog dari API headless yang disediakan oleh database atau monolitik lama. - Fase 3: Keranjang Belanja dan Alur Checkout
Pindahkan antarmuka keranjang belanja. Pada tahap ini, integrasi payment gateway dapat langsung diarahkan ke microservice pembayaran baru. - Fase 4: Manajemen Akun dan Portal Pelanggan
Migrasikan riwayat pesanan, profil, dan pengaturan pengguna. - Fase 5: Decommissioning Monolith
Ketika seluruh rute publik sudah 100% ditangani oleh Next.js dan backend baru, matikan server monolitik lama dan arsipkan basis datanya.
Pola Strangler Fig membuktikan bahwa modernisasi arsitektur enterprise tidak harus menjadi pertaruhan hidup-mati berisiko tinggi, melainkan proses evolusi terencana yang memberikan nilai bisnis nyata sejak hari pertama rilis.
