564 kata

3 menit

Mengenal Konsep Design System: Clean Architecture

2026-03-11

System Design

Software Architecture

/

Blogging

/

Backend

/

System Design

Clean Architecture: Cara Biar Project Tidak Jadi “Spaghetti Code”#

Sering pusing karena project kamu kelihatan tidak efisien, susah di-maintain, dan semua logic tercampur di satu tempat?

File controller penuh dengan query database, business logic bercampur dengan validasi, bahkan kadang helper random ikut nimbrung di situ juga.

Kalau projectnya masih kecil dan kita kerjakan sendiri, mungkin masih bisa diatasi. Kamu masih ingat semua alur kodenya di kepala.

Namun bagaimana jika project tersebut dikerjakan bersama tim?

Mulai muncul pertanyaan seperti:

“Logic ini ada di mana ya?”
“Kalau ubah fitur ini nanti efeknya ke mana saja?”
“Kenapa function ini dipanggil dari tiga tempat berbeda?”

Akhirnya kita sebagai developer harus bolak-balik bertanya ke orang lain yang handle kode tsb hanya untuk memahami struktur project.

Dan di sinilah konsep Clean Architecture mulai terasa penting.

Clean Architecture membantu kita membuat sistem yang terstruktur, mudah dipahami, dan lebih mudah di-maintain dalam jangka panjang.

Apa Itu Clean Architecture?#

Clean Architecture adalah konsep arsitektur software yang diperkenalkan oleh Robert C. Martin (Uncle Bob).

Tujuan utamanya sederhana:

Memisahkan tanggung jawab dalam aplikasi agar setiap bagian memiliki peran yang jelas.

Dengan pemisahan ini kita mendapatkan beberapa keuntungan:

Code lebih mudah dipahami
Mudah melakukan testing
Tidak bergantung pada framework
Lebih mudah melakukan perubahan di masa depan

Masalah Umum Tanpa Arsitektur yang Jelas#

Kita coba lihat contoh struktur project yang sering terjadi.

1
controllers/
2
    userController.js
3
    orderController.js
4

5
models/
6
    userModel.js
7
    orderModel.js
8

9
routes/

Masalahnya?

Sering kali controller berisi:

Query database
Validasi
Business logic
Response API

Contohnya:

1
async function createUser(req, res) {
2
   const user = await db.query("INSERT INTO users ...")
3

4
   if(user.age < 18){
5
       return res.json({error: "Too young"})
6
   }
7

8
   sendEmail(user.email)
9

10
   return res.json(user)
11
}

Semua logic tercampur di satu tempat.

Akibatnya:

Susah di test
Susah di reuse
Susah di maintain

Semakin besar project, semakin terasa dampaknya.

Konsep Dasar Clean Architecture#

Clean Architecture biasanya dibagi menjadi beberapa layer:

1
Entities
2
Use Cases
3
Interface Adapters
4
Frameworks & Drivers

Atau jika disederhanakan:

1
Domain
2
Usecase
3
Repository
4
Handler / Controller

Mari kita bahas satu per satu.

1. Entities (Domain)#

Ini adalah inti dari aplikasi.

Berisi:

Struct / Model
Business rules utama

Contoh:

1
type User struct {
2
    ID    string
3
    Name  string
4
    Email string
5
}

Layer ini tidak boleh bergantung pada database, framework, atau API.

Tujuannya supaya domain logic tetap bersih.

2. Usecase (Business Logic)#

Layer ini berisi logic aplikasi.

Contohnya:

Create user
Login
Calculate price
Process order

Contoh sederhana:

1
type UserUsecase struct {
2
    repo UserRepository
3
}
4

5
func (u *UserUsecase) CreateUser(user User) error {
6
    return u.repo.Create(user)
7
}

Usecase hanya tahu apa yang harus dilakukan, bukan bagaimana implementasinya.

3. Repository#

Repository adalah layer yang bertugas berkomunikasi dengan database.

Contoh:

1
type UserRepository interface {
2
    Create(user User) error
3
    FindByEmail(email string) (*User, error)
4
}

Implementasinya bisa berbeda:

PostgreSQL
MySQL
MongoDB
bahkan API

Usecase tidak perlu tahu.

4. Handler / Controller#

Layer ini menangani request dari luar.

Contoh:

HTTP API
CLI
gRPC

Contoh sederhana:

1
func (h *UserHandler) CreateUser(c *fiber.Ctx) error {
2
    var req CreateUserRequest
3

4
    if err := c.BodyParser(&req); err != nil {
5
        return err
6
    }
7

8
    err := h.usecase.CreateUser(req.ToDomain())
9

10
    return c.JSON("success")
11
}

Controller hanya bertugas:

menerima request
memanggil usecase
mengembalikan response

Prinsip Penting Clean Architecture#

Ada satu aturan utama:

Dependency harus mengarah ke dalam (inward).

Artinya:

1
Controller -> Usecase -> Domain

Bukan sebaliknya.

Domain tidak boleh tahu tentang:

database
framework
HTTP
library eksternal

Dengan begitu, domain tetap stabil walaupun teknologi berubah.

Contoh Struktur Project#

Contoh struktur project:

1
internal/
2

3
    domain/
4
        user.go
5

6
    repository/
7
        user_repository.go
8
        user_repository_impl.go
9

10
    usecase/
11
        user_usecase.go
12

13
    handler/
14
        user_handler.go