Panduan Arsitektur Hexagonal (Ports & Adapters) pada Aplikasi Node.js / Go

Membebaskan Bisnis Logika dari Jeratan Framework

Sering kali kita melihat aplikasi backend di mana objek request Express (req, res) atau query database SQL tertulis langsung di tengah-tengah perhitungan transaksi bisnis. Akibatnya, ketika Anda ingin mengganti database dari MySQL ke MongoDB atau membuat antarmuka CLI baru, seluruh kode harus dirombak total.

Hexagonal Architecture (Ports and Adapters) menyelesaikan masalah ini dengan mengisolasi core domain di pusat sistem:

[ HTTP Adapter (Express/Fastify) ] ---> [ Driving Port (Input Interface) ]
                                                |
                                      [ CORE DOMAIN LOGIC ]
                                                |
[ Driven Port (Output Interface) ] <--- [ Secondary Adapter (Drizzle/MySQL) ]

Core domain Anda hanya berupa fungsi logika murni tanpa dependensi library eksternal apa pun, menjadikannya sangat mudah diuji dengan unit test kilat tanpa perlu menyalakan database palsu!