











{"author":"Faiq Najib Al-Aziz","body":"\nSaya pernah menulis kode yang rasanya masuk akal saat itu. Logikanya jelas, alurnya rapi, nama variabelnya deskriptif. Tiga bulan kemudian saya buka lagi file yang sama, lalu mikir, _\"ini tadi mau ngapain sih?\"_ Ya, ternyata saya sendiri juga bisa bingung sama kode buatan sendiri hehe.\n\nDi proyek GPS _tracker_ yang pernah saya tangani, satu _function_ mengurus semuanya: baca database, ubah status dan posisi kendaraan, kirim notifikasi, lalu bikin laporan. Praktis? Awalnya mungkin. Setelah kodenya tumbuh, ya mulai terasa.\n\n## Mengenali \"_Spaghetti Code_\"\n\n_Spaghetti code_ bukan istilah teknis formal. Istilah ini menggambarkan **kode yang saling terikat dan sulit dipisahkan**, seperti mie spaghetti yang sulit diambil sehelai tanpa menarik yang lain.\n\nKira-kira begini bentuk _function_-nya (pseudocode):\n\n```\nfunction handleUpdatePosition(request):\n    // Langsung query ke database\n    vehicle = db.query(\"SELECT * FROM vehicles WHERE id = ?\", request.vehicleId)\n\n    if not vehicle:\n        return error(\"Vehicle not found\")\n\n    // Business logic campur di sini\n    if vehicle.status == \"inactive\":\n        vehicle.status = \"active\"\n        vehicle.lastActivation = now()\n\n    // Update posisi\n    db.query(\"UPDATE positions SET lat = ?, lng = ?, time = ? WHERE vehicleId = ?\",\n             request.lat, request.lng, now(), request.vehicleId)\n\n    // Kirim notifikasi langsung dari sini\n    if vehicle.hasAlert:\n        email.send(vehicle.ownerEmail, \"Alert: \" + vehicle.name)\n        sms.send(vehicle.ownerPhone, \"Alert from \" + vehicle.name)\n\n    // Generate laporan langsung\n    report = generateDailyReport(vehicle)\n    db.query(\"INSERT INTO reports ...\", report)\n\n    return success(vehicle)\n```\n\nBisa dilihat? Satu _function_ nangkap **semua**, baca database, olah logika bisnis, kirim email, kirim SMS, _generate_ laporan. Saat itu kelihatannya praktis. Tapi coba bayangkan:\n\n- **Kalau mau ganti cara kirim notifikasi**: harus edit _function_ ini\n- **Kalau mau _test_ logika bisnis**: harus _setup_ database dan _email server_\n- **Kalau mau ganti database**: harus ubah semua _query_ yang tersebar di mana-mana\n- **Kalau ada bug di laporan**: harus _trace_ lewat _function_ yang sudah panjang ini\n\n```\n┌─────────────────────────────────────────────────┐\n│              Spaghetti Flow                      │\n│                                                  │\n│  Request ──► [Database + Logic + Email + Report] │\n│                         │                        │\n│                         ▼                        │\n│              Semua menyatu.                      │\n│              Ubah satu, risiko semua goyah.      │\n└─────────────────────────────────────────────────┘\n```\n\n## Clean Architecture, Versi Ringkasnya\n\nRobert C. Martin (_Uncle Bob_) memopulerkan istilah \"Clean Architecture\". Kalau diringkas, idenya begini: **logika bisnis jangan bergantung pada detail teknis seperti database, _framework_, atau API.** Biar kedengarannya tidak lebih rumit dari yang perlu.\n\nLogika bisnis biasanya lebih stabil daripada detail teknis. Contohnya aturan menghitung jarak, menentukan kendaraan aktif, dan menetapkan batas kecepatan. Database, _framework_, dan cara mengirim email adalah **detail** yang bisa berubah.\n\n### Aturan Ketergantungan (_Dependency Rule_)\n\n```\n┌──────────────────────────────────────────────────────┐\n│                                                      │\n│   ┌─────────────────────────────────────────────┐   │\n│   │              Entity                          │   │\n│   │   Aturan bisnis inti. Paling dalam.          │   │\n│   │   Tidak tergantung apapun.                   │   │\n│   │                                              │   │\n│   │   ┌──────────────────────────────────────┐  │   │\n│   │   │          Use Case                     │  │   │\n│   │   │   Apa yang sistem lakukan.            │  │   │\n│   │   │   Tergantung ke Entity, bukan ke DB.  │  │   │\n│   │   │                                       │  │   │\n│   │   │   ┌───────────────────────────────┐  │  │   │\n│   │   │   │     Infrastructure             │  │  │   │\n│   │   │   │   Database, API, Email, SMS.   │  │  │   │\n│   │   │   │   Detail teknis. Paling luar.  │  │  │   │\n│   │   │   └───────────────────────────────┘  │  │   │\n│   │   └──────────────────────────────────────┘  │   │\n│   └─────────────────────────────────────────────┘   │\n│                                                      │\n│   Arah panah: luar ──► dalam                       │\n│   Luar tergantung pada dalam. Dalam TIDAK tergantung │\n│   pada luar.                                        │\n└──────────────────────────────────────────────────────┘\n```\n\n**Panah hanya boleh mengarah ke dalam.** _Entity_ tidak tahu tentang database, dan _Use Case_ tidak tahu cara mengirim email. _Infrastructure_ menangani detail teknis.\n\nKalau kontrak _repository_ tetap sama, mengganti MySQL dengan PostgreSQL tidak mengharuskan perubahan pada _Entity_ atau _Use Case_. Implementasi di _Infrastructure_ yang berubah.\n\n### Tiga Layer yang Penting\n\nNah, biasanya pembagian tanggung jawabnya dijelaskan lewat tiga _layer_ ini:\n\n**1. Entity, Aturan Bisnis Inti**\n\nIni berisi aturan bisnis inti yang tidak bergantung pada teknologi tertentu. Di proyek GPS _tracker_, contohnya:\n\n```\nclass Vehicle:\n    id, name, status, currentSpeed, speedLimit\n\n    function isSpeeding():\n        return currentSpeed \u003e speedLimit\n\n    function activate():\n        if status == \"inactive\":\n            status = \"active\"\n            lastActivation = now()\n```\n\nDi sini tidak ada _database query_, _HTTP request_, atau _framework_. Isinya aturan bisnis: apakah kendaraan _speeding_ dan bagaimana mengaktifkannya.\n\n**2. Use Case, Apa yang Sistem Lakukan**\n\n_Use case_ mendefinisikan **apa** yang dilakukan sistem, tanpa peduli **bagaimana** detailnya.\n\n```\nclass UpdatePositionUseCase:\n    function execute(vehicleId, lat, lng):\n        // 1. Cari kendaraan\n        vehicle = vehicleRepository.findById(vehicleId)\n        if not vehicle:\n            return error(\"Vehicle not found\")\n\n        // 2. Update posisi\n        vehicle.updatePosition(lat, lng)\n\n        // 3. Simpan\n        vehicleRepository.save(vehicle)\n\n        // 4. Kalau speeding, trigger alert\n        if vehicle.isSpeeding():\n            alertService.sendSpeedAlert(vehicle)\n```\n\n_Use case_ memanggil `vehicleRepository` dan `alertService`, tetapi **tidak tahu** apakah implementasinya memakai MySQL atau PostgreSQL, atau mengirim alert lewat email atau SMS. Yang diketahuinya hanya _\"cari kendaraan\"_, _\"simpan\"_, dan _\"kirim alert\"_.\n\nSelama kontrak _repository_ tidak berubah, database dapat diganti tanpa mengubah _use case_.\n\n**3. Infrastructure, Detail Teknis**\n\nDi sinilah detail implementasi berada: database, API, _framework_, dan _email service_.\n\n```\nclass MySQLVehicleRepository:\n    function findById(id):\n        row = db.query(\"SELECT * FROM vehicles WHERE id = ?\", id)\n        return Vehicle(id: row.id, name: row.name, ...)\n\n    function save(vehicle):\n        db.query(\"UPDATE vehicles SET lat = ?, lng = ? WHERE id = ?\",\n                 vehicle.lat, vehicle.lng, vehicle.id)\n```\n\n```\nclass EmailAlertService:\n    function sendSpeedAlert(vehicle):\n        email.send(\n            to: vehicle.ownerEmail,\n            subject: \"Speed Alert: \" + vehicle.name,\n            body: vehicle.name + \" is going \" + vehicle.currentSpeed\n        )\n```\n\nIni bagian yang **boleh berubah**. Kalau mau ganti MySQL ke PostgreSQL, ubah di sini. Kalau mau ganti email ke WhatsApp, ubah di sini. _Entity_ dan _Use Case_ tidak tersentuh.\n\n## Coba Terapkan ke Contoh GPS Tracker\n\nBerikut versi \"clean\" dari kode _spaghetti_ di awal:\n\n### Before: Spaghetti\n\nSatu _function_ menangani semuanya: membaca database, menjalankan logika, mengirim notifikasi, dan membuat laporan.\n\n### After: Clean\n\n```\n// === Entity: Vehicle ===\n// (aturan bisnis murni, tidak tergantung apapun)\n\nclass Vehicle:\n    function updatePosition(lat, lng):\n        this.lat = lat\n        this.lng = lng\n        this.lastUpdate = now()\n\n    function isSpeeding():\n        return this.currentSpeed \u003e this.speedLimit\n\n// === Use Case: UpdatePosition ===\n// (apa yang dilakukan, tanpa peduli bagaimana)\n\nclass UpdatePositionUseCase:\n    function execute(vehicleId, lat, lng):\n        vehicle = repository.findById(vehicleId)\n        if not vehicle:\n            return error(\"Not found\")\n\n        vehicle.updatePosition(lat, lng)\n        repository.save(vehicle)\n\n        if vehicle.isSpeeding():\n            alertService.sendSpeedAlert(vehicle)\n\n        return success(vehicle)\n\n// === Infrastructure ===\n// (detail teknis, boleh berubah kapanpun)\n\nclass MySQLVehicleRepository:\n    function findById(id):\n        return db.query(\"SELECT ...\")\n\n    function save(vehicle):\n        db.query(\"UPDATE ...\")\n\nclass EmailAlertService:\n    function sendSpeedAlert(vehicle):\n        email.send(...)\n```\n\n### Apa yang Berubah?\n\n| Aspek | Spaghetti | Clean |\n|-------|-----------|-------|\n| _Test_ logika bisnis | Perlu _setup_ DB + _email_ | Cuma _test_ `Vehicle` class |\n| Ganti database | Ubah semua _query_ di mana-mana | Ubah cuma _repository_ |\n| Ganti cara _alert_ | Cari di seluruh _codebase_ | Ubah cuma `AlertService` |\n| _Onboarding_ _developer_ baru | Baca satu _function_ panjang | Baca per _layer_, mulai dari _Entity_ |\n| Efek samping perubahan | _Domino effect_ | Terisolasi per _layer_ |\n\nSetiap _layer_ bisa diuji sendiri: `Vehicle` tanpa database, `UpdatePositionUseCase` dengan _mock repository_, dan `MySQLVehicleRepository` secara terpisah.\n\n## Kalau Proyeknya Kecil Gimana?\n\nMungkin kamu sedang berpikir, _\"Ini kan buat proyek gede. Skripsi saya cuma aplikasi kecil.\"_ Bisa jadi. Untuk aplikasi kecil, Clean Architecture memang gampang jadi _overkill_. Tapi memisahkan logika bisnis dari urusan teknis tetap ada gunanya, apalagi kalau nanti kodenya perlu dites atau detail implementasinya berubah.\n\nSaat menjelaskan rancangan skripsi, dosen mungkin bertanya _\"kenapa kamu _design_ sistem seperti ini?\"_ Jawaban _\"karena logika bisnis saya tidak tergantung pada database\"_ lebih jelas daripada _\"karena tutorial yang saya ikuti seperti itu\"_.\n\n### Kapan Tidak Perlu Repot-repot\n\nClean Architecture bukan _silver bullet_. Ada saatnya tidak perlu:\n\n- **Prototype**: kalau kamu cuma mau _proof of concept_, tulis saja cepat. Jangan _overthink_.\n- **_Script_ kecil**: kalau cuma 50 baris untuk _scrape data_, tidak perlu _layer-layeran_.\n- **Belajar dasar dulu**: kalau belum nyaman dengan OOP atau _design pattern_, pelajari itu dulu. Clean Architecture butuh fondasi tersebut.\n\nJadi, pakai kalau kompleksitas proyeknya memang sudah minta begitu. Jangan cuma karena namanya kedengaran keren, nanti keburu sibuk bikin _layer_ sebelum masalahnya ada hehe.\n\n## Yang Saya Catat\n\n### _Spaghetti code_ bisa kejadian\n\n_Spaghetti code_ bisa muncul ketika kode terus tumbuh tanpa pembagian tanggung jawab yang jelas. Tidak perlu langsung panik atau menghakimi kode lama. Mulai saja dengan mencari bagian mana yang saling menempel.\n\n### Bedakan \"apa\" dan \"bagaimana\"\n\nLogika bisnis menjawab apa yang sistem lakukan. Database, _API_, dan _framework_ adalah cara teknis untuk menjalankannya. Buat saya, pemisahan itu inti idenya.\n\n### Kalau susah dites, cek lagi pembagiannya\n\nKesulitan menulis _unit test_ bisa jadi tanda pembagian tanggung jawabnya perlu dilihat lagi. Di contoh ini, _Entity_ dan _Use Case_ bisa dites tanpa menghubungi database atau layanan email.\n\n### Ini alat, bukan aturan wajib\n\nClean Architecture itu _tool_, bukan agama (saya ulang biar tidak ada yang bikin _layer_ demi _layer_). Pahami idenya, lalu pakai kalau memang cocok dengan proyeknya.\n\n## Nah, Terus Gimana?\n\nJadi, yang penting bukan banyaknya _layer_ atau _pattern_ yang _fancy_. Tujuannya supaya tanggung jawab tidak campur aduk, dan supaya beberapa bulan lagi kita masih bisa paham kode sendiri. Saya sendiri pernah gagal di bagian terakhir itu hehe.\n\nKalau penasaran seperti apa penerapannya di proyek nyata, termasuk migrasi PHP ke Go dengan 370+ _endpoint_, saya pernah menulis [catatan terpisah](/writing/2026/legacy-php-to-go-migration/).\n\nKalau ingin membahas penerapannya atau mencari bantuan, [hubungi saya](/contact/) atau lihat [layanan](/services/) yang saya tawarkan.\n\n---\n\n_Tag: [catatan](/tags/catatan/) · [arsitektur](/tags/arsitektur/)_\n","body_clean":"Saya pernah menulis kode yang rasanya masuk akal saat itu. Logikanya jelas, alurnya rapi, nama variabelnya deskriptif. Tiga bulan kemudian saya buka lagi file yang sama, lalu mikir, \u0026ldquo;ini tadi mau ngapain sih?\u0026rdquo; Ya, ternyata saya sendiri juga bisa bingung sama kode buatan sendiri hehe.\nDi proyek GPS tracker yang pernah saya tangani, satu function mengurus semuanya: baca database, ubah status dan posisi kendaraan, kirim notifikasi, lalu bikin laporan. Praktis? Awalnya mungkin. Setelah kodenya tumbuh, ya mulai terasa.\nMengenali \u0026ldquo;Spaghetti Code\u0026rdquo; #Spaghetti code bukan istilah teknis formal. Istilah ini menggambarkan kode yang saling terikat dan sulit dipisahkan, seperti mie spaghetti yang sulit diambil sehelai tanpa menarik yang lain.\nKira-kira begini bentuk function-nya (pseudocode):\nfunction handleUpdatePosition(request): // Langsung query ke database vehicle = db.query(\u0026#34;SELECT * FROM vehicles WHERE id = ?\u0026#34;, request.vehicleId) if not vehicle: return error(\u0026#34;Vehicle not found\u0026#34;) // Business logic campur di sini if vehicle.status == \u0026#34;inactive\u0026#34;: vehicle.status = \u0026#34;active\u0026#34; vehicle.lastActivation = now() // Update posisi db.query(\u0026#34;UPDATE positions SET lat = ?, lng = ?, time = ? WHERE vehicleId = ?\u0026#34;, request.lat, request.lng, now(), request.vehicleId) // Kirim notifikasi langsung dari sini if vehicle.hasAlert: email.send(vehicle.ownerEmail, \u0026#34;Alert: \u0026#34; + vehicle.name) sms.send(vehicle.ownerPhone, \u0026#34;Alert from \u0026#34; + vehicle.name) // Generate laporan langsung report = generateDailyReport(vehicle) db.query(\u0026#34;INSERT INTO reports ...\u0026#34;, report) return success(vehicle) Bisa dilihat? Satu function nangkap semua, baca database, olah logika bisnis, kirim email, kirim SMS, generate laporan. Saat itu kelihatannya praktis. Tapi coba bayangkan:\nKalau mau ganti cara kirim notifikasi: harus edit function ini Kalau mau test logika bisnis: harus setup database dan email server Kalau mau ganti database: harus ubah semua query yang tersebar di mana-mana Kalau ada bug di laporan: harus trace lewat function yang sudah panjang ini ┌─────────────────────────────────────────────────┐ │ Spaghetti Flow │ │ │ │ Request ──► [Database + Logic + Email + Report] │ │ │ │ │ ▼ │ │ Semua menyatu. │ │ Ubah satu, risiko semua goyah. │ └─────────────────────────────────────────────────┘ Clean Architecture, Versi Ringkasnya #Robert C. Martin (Uncle Bob) memopulerkan istilah \u0026ldquo;Clean Architecture\u0026rdquo;. Kalau diringkas, idenya begini: logika bisnis jangan bergantung pada detail teknis seperti database, framework, atau API. Biar kedengarannya tidak lebih rumit dari yang perlu.\nLogika bisnis biasanya lebih stabil daripada detail teknis. Contohnya aturan menghitung jarak, menentukan kendaraan aktif, dan menetapkan batas kecepatan. Database, framework, dan cara mengirim email adalah detail yang bisa berubah.\nAturan Ketergantungan (Dependency Rule) #┌──────────────────────────────────────────────────────┐ │ │ │ ┌─────────────────────────────────────────────┐ │ │ │ Entity │ │ │ │ Aturan bisnis inti. Paling dalam. │ │ │ │ Tidak tergantung apapun. │ │ │ │ │ │ │ │ ┌──────────────────────────────────────┐ │ │ │ │ │ Use Case │ │ │ │ │ │ Apa yang sistem lakukan. │ │ │ │ │ │ Tergantung ke Entity, bukan ke DB. │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────────────────────────┐ │ │ │ │ │ │ │ Infrastructure │ │ │ │ │ │ │ │ Database, API, Email, SMS. │ │ │ │ │ │ │ │ Detail teknis. Paling luar. │ │ │ │ │ │ │ └───────────────────────────────┘ │ │ │ │ │ └──────────────────────────────────────┘ │ │ │ └─────────────────────────────────────────────┘ │ │ │ │ Arah panah: luar ──► dalam │ │ Luar tergantung pada dalam. Dalam TIDAK tergantung │ │ pada luar. │ └──────────────────────────────────────────────────────┘ Panah hanya boleh mengarah ke dalam. Entity tidak tahu tentang database, dan Use Case tidak tahu cara mengirim email. Infrastructure menangani detail teknis.\nKalau kontrak repository tetap sama, mengganti MySQL dengan PostgreSQL tidak mengharuskan perubahan pada Entity atau Use Case. Implementasi di Infrastructure yang berubah.\nTiga Layer yang Penting #Nah, biasanya pembagian tanggung jawabnya dijelaskan lewat tiga layer ini:\n1. Entity, Aturan Bisnis Inti\nIni berisi aturan bisnis inti yang tidak bergantung pada teknologi tertentu. Di proyek GPS tracker, contohnya:\nclass Vehicle: id, name, status, currentSpeed, speedLimit function isSpeeding(): return currentSpeed \u0026gt; speedLimit function activate(): if status == \u0026#34;inactive\u0026#34;: status = \u0026#34;active\u0026#34; lastActivation = now() Di sini tidak ada database query, HTTP request, atau framework. Isinya aturan bisnis: apakah kendaraan speeding dan bagaimana mengaktifkannya.\n2. Use Case, Apa yang Sistem Lakukan\nUse case mendefinisikan apa yang dilakukan sistem, tanpa peduli bagaimana detailnya.\nclass UpdatePositionUseCase: function execute(vehicleId, lat, lng): // 1. Cari kendaraan vehicle = vehicleRepository.findById(vehicleId) if not vehicle: return error(\u0026#34;Vehicle not found\u0026#34;) // 2. Update posisi vehicle.updatePosition(lat, lng) // 3. Simpan vehicleRepository.save(vehicle) // 4. Kalau speeding, trigger alert if vehicle.isSpeeding(): alertService.sendSpeedAlert(vehicle) Use case memanggil vehicleRepository dan alertService, tetapi tidak tahu apakah implementasinya memakai MySQL atau PostgreSQL, atau mengirim alert lewat email atau SMS. Yang diketahuinya hanya \u0026ldquo;cari kendaraan\u0026rdquo;, \u0026ldquo;simpan\u0026rdquo;, dan \u0026ldquo;kirim alert\u0026rdquo;.\nSelama kontrak repository tidak berubah, database dapat diganti tanpa mengubah use case.\n3. Infrastructure, Detail Teknis\nDi sinilah detail implementasi berada: database, API, framework, dan email service.\nclass MySQLVehicleRepository: function findById(id): row = db.query(\u0026#34;SELECT * FROM vehicles WHERE id = ?\u0026#34;, id) return Vehicle(id: row.id, name: row.name, ...) function save(vehicle): db.query(\u0026#34;UPDATE vehicles SET lat = ?, lng = ? WHERE id = ?\u0026#34;, vehicle.lat, vehicle.lng, vehicle.id) class EmailAlertService: function sendSpeedAlert(vehicle): email.send( to: vehicle.ownerEmail, subject: \u0026#34;Speed Alert: \u0026#34; + vehicle.name, body: vehicle.name + \u0026#34; is going \u0026#34; + vehicle.currentSpeed ) Ini bagian yang boleh berubah. Kalau mau ganti MySQL ke PostgreSQL, ubah di sini. Kalau mau ganti email ke WhatsApp, ubah di sini. Entity dan Use Case tidak tersentuh.\nCoba Terapkan ke Contoh GPS Tracker #Berikut versi \u0026ldquo;clean\u0026rdquo; dari kode spaghetti di awal:\nBefore: Spaghetti #Satu function menangani semuanya: membaca database, menjalankan logika, mengirim notifikasi, dan membuat laporan.\nAfter: Clean #// === Entity: Vehicle === // (aturan bisnis murni, tidak tergantung apapun) class Vehicle: function updatePosition(lat, lng): this.lat = lat this.lng = lng this.lastUpdate = now() function isSpeeding(): return this.currentSpeed \u0026gt; this.speedLimit // === Use Case: UpdatePosition === // (apa yang dilakukan, tanpa peduli bagaimana) class UpdatePositionUseCase: function execute(vehicleId, lat, lng): vehicle = repository.findById(vehicleId) if not vehicle: return error(\u0026#34;Not found\u0026#34;) vehicle.updatePosition(lat, lng) repository.save(vehicle) if vehicle.isSpeeding(): alertService.sendSpeedAlert(vehicle) return success(vehicle) // === Infrastructure === // (detail teknis, boleh berubah kapanpun) class MySQLVehicleRepository: function findById(id): return db.query(\u0026#34;SELECT ...\u0026#34;) function save(vehicle): db.query(\u0026#34;UPDATE ...\u0026#34;) class EmailAlertService: function sendSpeedAlert(vehicle): email.send(...) Apa yang Berubah? # Aspek Spaghetti Clean Test logika bisnis Perlu setup DB + email Cuma test Vehicle class Ganti database Ubah semua query di mana-mana Ubah cuma repository Ganti cara alert Cari di seluruh codebase Ubah cuma AlertService Onboarding developer baru Baca satu function panjang Baca per layer, mulai dari Entity Efek samping perubahan Domino effect Terisolasi per layer Setiap layer bisa diuji sendiri: Vehicle tanpa database, UpdatePositionUseCase dengan mock repository, dan MySQLVehicleRepository secara terpisah.\nKalau Proyeknya Kecil Gimana? #Mungkin kamu sedang berpikir, \u0026ldquo;Ini kan buat proyek gede. Skripsi saya cuma aplikasi kecil.\u0026rdquo; Bisa jadi. Untuk aplikasi kecil, Clean Architecture memang gampang jadi overkill. Tapi memisahkan logika bisnis dari urusan teknis tetap ada gunanya, apalagi kalau nanti kodenya perlu dites atau detail implementasinya berubah.\nSaat menjelaskan rancangan skripsi, dosen mungkin bertanya \u0026ldquo;kenapa kamu design sistem seperti ini?\u0026rdquo; Jawaban \u0026ldquo;karena logika bisnis saya tidak tergantung pada database\u0026rdquo; lebih jelas daripada \u0026ldquo;karena tutorial yang saya ikuti seperti itu\u0026rdquo;.\nKapan Tidak Perlu Repot-repot #Clean Architecture bukan silver bullet. Ada saatnya tidak perlu:\nPrototype: kalau kamu cuma mau proof of concept, tulis saja cepat. Jangan overthink. Script kecil: kalau cuma 50 baris untuk scrape data, tidak perlu layer-layeran. Belajar dasar dulu: kalau belum nyaman dengan OOP atau design pattern, pelajari itu dulu. Clean Architecture butuh fondasi tersebut. Jadi, pakai kalau kompleksitas proyeknya memang sudah minta begitu. Jangan cuma karena namanya kedengaran keren, nanti keburu sibuk bikin layer sebelum masalahnya ada hehe.\nYang Saya Catat #Spaghetti code bisa kejadian #Spaghetti code bisa muncul ketika kode terus tumbuh tanpa pembagian tanggung jawab yang jelas. Tidak perlu langsung panik atau menghakimi kode lama. Mulai saja dengan mencari bagian mana yang saling menempel.\nBedakan \u0026ldquo;apa\u0026rdquo; dan \u0026ldquo;bagaimana\u0026rdquo; #Logika bisnis menjawab apa yang sistem lakukan. Database, API, dan framework adalah cara teknis untuk menjalankannya. Buat saya, pemisahan itu inti idenya.\nKalau susah dites, cek lagi pembagiannya #Kesulitan menulis unit test bisa jadi tanda pembagian tanggung jawabnya perlu dilihat lagi. Di contoh ini, Entity dan Use Case bisa dites tanpa menghubungi database atau layanan email.\nIni alat, bukan aturan wajib #Clean Architecture itu tool, bukan agama (saya ulang biar tidak ada yang bikin layer demi layer). Pahami idenya, lalu pakai kalau memang cocok dengan proyeknya.\nNah, Terus Gimana? #Jadi, yang penting bukan banyaknya layer atau pattern yang fancy. Tujuannya supaya tanggung jawab tidak campur aduk, dan supaya beberapa bulan lagi kita masih bisa paham kode sendiri. Saya sendiri pernah gagal di bagian terakhir itu hehe.\nKalau penasaran seperti apa penerapannya di proyek nyata, termasuk migrasi PHP ke Go dengan 370+ endpoint, saya pernah menulis catatan terpisah.\nKalau ingin membahas penerapannya atau mencari bantuan, hubungi saya atau lihat layanan yang saya tawarkan.\nTag: catatan · arsitektur\n","canonical":"https://najib.id/writing/2026/clean-architecture-intro/","description":"Catatan santai soal Clean Architecture, pakai contoh dari proyek GPS tracker yang pernah saya kerjakan.","language":"id","lastmod":"2026-11-11T23:31:00Z","publishedAt":"2026-04-15T00:00:00Z","readingTime":7,"section":"writing","series":null,"tags":["catatan","arsitektur"],"title":"Clean Architecture: Dari Spaghetti Code ke Kode yang Bisa Dibaca Ulang","type":"writing","url":"https://najib.id/writing/2026/clean-architecture-intro/","wordCount":1438}
