Merapikan Kode NestJS Anda: Panduan Struktur Folder yang Scalable

Waktu pertama kali membuat proyek NestJS, Anda disambut struktur folder yang sederhana dan bersih. Ada app.controller.ts, app.service.ts, dan app.module.ts. Untuk proyek "Hello World", itu sudah lebih dari cukup.

Tapi apa yang terjadi ketika proyeknya bertumbuh? Bagaimana kalau Anda punya puluhan endpoint, logika bisnis yang rumit, dan bermacam fitur yang saling terkait? Struktur bawaannya akan cepat terasa sesak dan berantakan.

Di sinilah memikirkan arsitektur folder yang scalable sejak awal jadi penting. Artikel ini akan memandu Anda ke pendekatan yang sudah terbukti untuk menjaga proyek tetap bersih dan mudah dirawat: Module-Driven Structure.

Masalah dengan Struktur Datar

Begitu Anda menambah fitur seperti Users, Products, Orders, dan Auth, struktur datar di folder src Anda akan jadi kacau:

src/
├── users.controller.ts
├── products.controller.ts
├── orders.controller.ts
├── auth.controller.ts
├── users.service.ts
├── products.service.ts
├── orders.service.ts
└── ... and so on

Mencari file yang berkaitan dengan satu fitur jadi merepotkan karena komponennya tersebar ke mana-mana. Ini tidak efisien dan menyiksa untuk dirawat.

Solusinya: Module-Driven Structure yang Lebih Rapi

Ide dasarnya adalah mengelompokkan semua file yang berkaitan dengan satu fitur ke dalam module-nya sendiri. Tapi kita bisa melangkah satu tahap lagi demi kejelasan maksimal, yaitu dengan membuat direktori modules khusus.

Pendekatan ini memisahkan dengan rapi antara logika bisnis inti aplikasi Anda dan kode pendukungnya (seperti konfigurasi dan helper umum).

Berikut struktur yang sangat direkomendasikan:

src/
├── modules/           # All business logic and features live here
│   ├── auth/          # Everything about authentication & authorization
│   │   ├── strategies/
│   │   ├── guards/
│   │   ├── dto/
│   │   ├── auth.controller.ts
│   │   ├── auth.module.ts
│   │   └── auth.service.ts
│   │
│   ├── products/      # "Products" feature module
│   │   ├── dto/
│   │   ├── entities/
│   │   ├── products.controller.ts
│   │   ├── products.module.ts
│   │   └── products.service.ts
│   │
│   └── users/         # "Users" feature module
│       ├── dto/
│       ├── entities/
│       ├── users.controller.ts
│       ├── users.module.ts
│       └── users.service.ts
│
├── common/            # Reusable components (pipes, filters, etc.)
│
├── config/            # Configuration management
│
├── database/          # Migrations, seeds, etc.
│
├── app.module.ts      # Root module, where all feature modules are imported
└── main.ts            # Application entry point

Membedah Strukturnya

Mari kita lihat peran masing-masing direktori di level teratas:

1. modules/

Ini jantung aplikasi Anda. Tiap sub-direktori mewakili satu fitur atau domain bisnis yang berdiri sendiri.

• *.module.ts: mendefinisikan module untuk fitur tersebut, meng-import controller-nya dan mendaftarkan provider (service).
• *.controller.ts: menangani routing, menerima request, dan memanggil service.
• *.service.ts: berisi semua logika bisnis yang rumit.
• entities/: (kalau memakai ORM seperti TypeORM) berisi definisi model data atau skema database.
• dto/ (Data Transfer Object): berisi kelas-kelas yang mendefinisikan "bentuk" data yang dikirim antara client dan server. Ini penting untuk validasi.

2. common/

Folder ini adalah "kotak perkakas" proyek Anda. Semua komponen, fungsi, atau kelas yang bisa dipakai ulang di beberapa fitur ditaruh di sini. Contohnya decorator kustom untuk mengambil data user dari sebuah request, atau exception filter untuk menangani error secara konsisten di seluruh aplikasi.

3. config/

Jangan pernah menulis kredensial database atau API key langsung di dalam kode. NestJS punya module @nestjs/config yang sangat baik untuk mengelola environment variable. Folder inilah tempat semua logika konfigurasi itu tinggal.

4. database/

Kalau proyek Anda memakai migrasi atau seeding database, folder ini tempat yang pas untuk menyimpannya secara rapi dan terpisah dari logika aplikasi.

Keuntungan Struktur Ini

1. Kejelasan & Keteraturan: langsung terlihat di mana logika bisnis inti aplikasi Anda berada (modules) dan mana kode pendukungnya.
2. Skalabilitas: menambah fitur baru semudah membuat folder baru di dalam modules, tanpa membuat direktori root jadi penuh.
3. Kemudahan Perawatan: kode lebih gampang dicari, dipahami, dan diperbaiki. Perlu memperbaiki bug di fitur Orders? Cukup buka src/modules/orders/.
4. Kolaborasi Tim: developer yang berbeda bisa menggarap module fitur yang berbeda secara paralel dengan risiko konflik yang lebih kecil.

Kesimpulan

Menerapkan struktur folder yang kokoh sejak awal adalah investasi jangka panjang bagi kesehatan proyek Anda. Dengan mengelompokkan fitur-fitur di dalam direktori modules khusus, Anda mendapat arsitektur yang bersih, scalable, dan sangat mudah dirawat seiring aplikasinya bertumbuh.

Mulai rapikan kode Anda dengan cara ini, dan Anda di masa depan akan berterima kasih! Selamat ngoding!