BAB 1: THE CORE ARCHITECTURE (SASIS UTAMA)

Fondasi utama dari Gandiwa Stack dirancang untuk mengemulasikan kapasitas produksi perangkat lunak berskala Enterprise menggunakan paradigma Distributed Edge-Native Infrastructure. Kami memutus ketergantungan pada arsitektur monolitik konvensional dan server VPS tradisional yang rentan terhadap kegagalan operasional (downtime) saat terjadi lonjakan beban data massal. Dengan memindahkan seluruh lapisan komputasi ke jaringan tepi global, Gandiwa Stack berhasil mencapai efisiensi operasional absolut melalui eliminasi kompleksitas manajemen infrastruktur tradisional tanpa mengorbankan integritas, keamanan, dan kecepatan pemrosesan data.

1.1 Distributed Edge-Runtime Execution (V8 Isolates Engine)

Logika penanganan API (Application Programming Interface) pada Gandiwa Stack dieksekusi sepenuhnya di luar lingkungan runtime Node.js konvensional. Kami mengadopsi arsitektur Serverless Ephemeral Micro-Runtimes berbasis V8 Isolates yang berjalan di atas infrastruktur Cloudflare Workers.

Eliminasi Total Cold-Starts: V8 Isolates memotong kebutuhan booting instans kontainer virtual, memampukan setiap instruksi kode masuk dieksekusi secara instan tanpa jeda pemanasan peladen tradisional.
Reduksi Latensi Geografis: Komputasi didistribusikan secara dinamis ke ratusan edge nodes global yang paling dekat dengan lokasi fisik pengguna (baik operator instans, sekolah, maupun guru). Pendekatan ini memangkas jarak tempuh paket data jaringan (Round Trip Time / RTO) ke level satu digit milidetik, menciptakan performa aplikasi yang responsif dan kebal terhadap pemutusan koneksi sepihak.
Efisiensi Alokasi Memori: Dengan menetapkan disiplin alokasi memori 128 MB per request sebagai ambang batas arsitektur, sistem ini memaksa penyusunan algoritma penulisan kode yang sangat bersih, modular, dan terbebas dari ancaman kebocoran memori (memory leaks).

1.2 Global Content Delivery Engine (Stateless App Shell Isolation)

Distribusi dan penyajian seluruh aset antarmuka pengguna statis (Frontend UI Component Library) dikelola secara eksklusif oleh peladen Cloudflare Workers/Pages Lapisan ini bertindak sebagai perisai terdepan yang menangani permintaan ribuan pengguna secara serentak tanpa melibatkan proses komputasi peladen internal.

Skalabilitas Distribusi Statis: Setiap berkas HTML, konfigurasi CSS, dan aset interaktif berbasis JavaScript dikompresi ke format mutakhir dan didistribusikan ke simpul caching global di level Edge. Pengguna akan menerima lembar aplikasi (App Shell) dalam waktu milidetik sejak ketukan pertama.
Kebijakan Unlimited Egress Transfer: Pemanfaatan jalur pengantaran konten ini mengeliminasi overhead latensi distribusi aset dengan memanfaatkan jaringan CDN global Cloudflare sebagai lapisan pengantaran terdepan, memastikan throughput transfer data tidak menjadi bottleneck pada skenario ekspansi skala nasional. Keunggulan ini memberikan ruang tak terbatas untuk ekspansi aplikasi berskala nasional.
CI/CD Build Pipeline Integration: Infrastruktur ini terhubung langsung dengan repositori GitHub via GitHub Actions, memastikan setiap pembaruan kode melalui proses kompilasi otomatis dan dirilis secara global tanpa memicu waktu henti aplikasi (Zero Downtime Deployment).

1.3 Cloud-Native Enterprise Database (Isolated Multi-Tenant Security)

Penyimpanan data relasional dan transaksional tingkat tinggi pada Gandiwa Stack memercayakan Supabase yang ditenagai oleh klaster mesin PostgreSQL terkelola. Pangkalan data ini dioptimasi secara spesifik untuk menangani hubungan data yang kompleks dengan keamanan berlapis.

Strict Row Level Security (RLS): Kebijakan keamanan disuntikkan langsung di level baris pangkalan data. Setiap kueri data yang masuk wajib melampirkan token JWT (JSON Web Token) yang terenkripsi dari sisi klien. Sistem PostgreSQL akan menolak secara mutlak setiap upaya akses yang tidak sesuai identitas, memastikan data antar-klien (Cross-Tenant) terisolasi secara sempurna dan kebal dari kebocoran data tak disengaja.
Connection Pooling Terdesentralisasi: Untuk memitigasi kemacetan antrean kueri saat puluhan ribu pengguna melakukan otentikasi masuk secara bersamaan (seperti jam masuk sekolah atau ujian CBT massal), pangkalan data ini dikonfigurasi dengan connection pooler canggih. Infrastruktur ini mampu mengelola ribuan koneksi simultan secara stabil dengan latensi ultra-rendah.
Real-time Data Streaming: Memanfaatkan ekstensi real-time replication untuk menyiarkan perubahan status data pangkalan secara langsung ke antarmuka pengguna tanpa memicu proses pemanggilan kueri berulang (polling HTTP) yang boros daya peladen.

1.4 Type-Safe Relational Mapping (Zero-Node Dependencies Bridge)

Gandiwa Stack menetapkan aturan kaku dengan melarang keras penggunaan ORM tradisional yang berat (seperti Prisma). Sebagai gantinya, kami mengimplementasikan Drizzle ORM sebagai jembatan relasional eksklusif antara komputasi Edge Runtime dan basis data PostgreSQL.

100% Edge-Runtime Compatibility: Berbeda dengan ORM lama yang membutuhkan dependensi mesin biner Node.js dan pustaka C++ yang berat, Drizzle dirancang murni menggunakan standar JavaScript modern. Hal ini memampukan seluruh skema relasional dijalankan langsung dari dalam Cloudflare Workers.
Kestabilan Kueri Kritis & Type-Safety: Setiap mutasi data finansial, skor pencapaian, rekapitulasi kehadiran, hingga bank soal ujian divalidasi secara ketat pada level kompilasi bahasa (strongly-typed). Kesalahan penulisan tipe data akan dicegat sebelum kueri dikirim, menjamin toleransi kesalahan nol (Zero-Bug Tolerance) di sistem produksi.
Proteksi SQL Injection Sejak Akar: Drizzle memperlakukan kueri menggunakan mekanisme Prepared Statements secara otomatis. Penyusupan karakter kode asing berbahaya dari luar akan dianggap sebagai teks mentah biasa, menutup rapat celah eksploitasi keamanan siber paling umum di industri web.

1.5 Kompatibilitas Protokol & Standar Validasi Rigid

Menjaga agar Gandiwa Stack tetap ringan, anti-timeout, dan beroperasi stabil di dalam parameter disiplin arsitektur Edge-Native memerlukan penegakan protokol penulisan kode yang sangat kaku:

Substitusi Modul Terlarang Node.js: Penggunaan modul bawaan Node.js seperti fs, path, atau crypto dilarang keras karena tidak kompatibel dengan lingkungan komputasi tepi. Pengembang diwajibkan beralih ke Web Standard API seperti Native fetch(), Web Crypto API, and Cloudflare R2 Storage API.
End-to-End Schema Validation via Zod: Sebelum data menyentuh lapisan Drizzle ORM, seluruh muatan data (payload) wajib melewati filter validasi skema E2E dari Zod. Langkah ini memastikan tidak ada data sampah, format anomali, atau parameter ilegal yang dapat mengganggu performa indeks pangkalan data Supabase.

FAQ , BAB 1: THE CORE ARCHITECTURE

Q: Mengapa Gandiwa Stack secara mutlak melarang Prisma ORM? A: Prisma ORM membutuhkan query engine berbasis biner Rust/C++ yang tidak dapat dikompilasi ke dalam lingkungan V8 Isolates Cloudflare Workers. Ketika Next.js dikompilasi menggunakan @cloudflare/next-on-pages, seluruh dependensi biner Node.js ditolak pada tahap build. Drizzle ORM dipilih sebagai pengganti karena seluruh logikanya ditulis menggunakan JavaScript murni standar, membuatnya 100% kompatibel dengan Edge Runtime tanpa memerlukan satu pun dependensi native.

Q: Apa perbedaan fundamental antara V8 Isolates dan Node.js runtime dalam konteks Cloudflare Workers? A: Node.js runtime menjalankan satu proses yang membutuhkan booting penuh setiap kali instans baru diinisialisasi, menghasilkan cold start antara 200–400 milidetik. V8 Isolates adalah konteks JavaScript yang terisolasi di dalam satu proses V8 yang sudah berjalan, memungkinkan eksekusi instan tanpa fase pemanasan. Setiap Isolate dibatasi konsumsi memori sebesar 128 MB and memiliki masa hidup yang sangat singkat , mulai hidup saat request masuk dan dibuang segera setelah respons dikirim.

Q: Bagaimana Drizzle ORM mencegah serangan SQL Injection secara arsitektural? A: Drizzle ORM mengkompilasi seluruh kueri menggunakan mekanisme Prepared Statements secara otomatis. Dalam pola ini, struktur kueri SQL dikompilasi terlebih dahulu oleh mesin PostgreSQL, sementara nilai parameter dari pengguna dikirim secara terpisah as data literal. Mesin database memperlakukan seluruh input pengguna sebagai teks mentah tanpa menginterpretasikannya sebagai instruksi SQL, menutup rapat celah injeksi pada tingkat paling fundamental.

Q: Apa fungsi Zod dalam rantai pemrosesan data Gandiwa Stack dan di mana ia dieksekusi? A: Zod berperan sebagai gerbang validasi skema ujung-ke-ujung (end-to-end schema validation) yang dieksekusi di dalam Cloudflare Workers sebelum data menyentuh lapisan Drizzle ORM. Setiap payload API diverifikasi terhadap definisi skema Zod yang ketat , mencakup tipe data, format string, nilai numerik, and keberadaan field wajib. Jika satu parameter tidak sesuai, Zod melempar pengecualian yang langsung mengakhiri siklus pemrosesan request tanpa membebani koneksi database.

Q: Bagaimana Gandiwa Stack menangani modul Node.js bawaan yang tidak kompatibel dengan Edge Runtime? A: Gandiwa Stack menetapkan peta substitusi wajib: modul fs and path digantikan oleh Cloudflare R2 Storage API via native fetch(), modul crypto digantikan oleh Web Crypto API (globalThis.crypto), and manipulasi JWT yang biasanya menggunakan library jsonwebtoken wajib digantikan oleh library jose yang dirancang murni menggunakan Web Standard tanpa dependensi Node.js.

Rujukan Arsitektur & Navigasi

Integrasi Lintas-Penyewa: Pelajari bagaimana logika otentikasi lintas-penyewa dan token asimetris diatur dalam Ecosystem Integration Core di Bab 2.
Ketahanan Sistem Luring: Pelajari tentang pangkalan data lokal, batasan memori, dan toleransi kegagalan dalam Performance & Local-First Engineering di Bab 3.