lapeeh 1.0.0

package/doc/id/DEPLOYMENT.md

@@ -0,0 +1,171 @@
+# Deployment Guide
+
+Panduan ini akan membantu Anda membawa aplikasi lapeeh dari `localhost` ke Server Production (VPS/Cloud).
+
+## Persiapan Pra-Deploy
+
+Sebelum deploy, pastikan:
+
+1.  **Environment Variables**: Siapkan nilai `.env` untuk production (JWT Secret yang kuat, dll).
+2.  **Build**: TypeScript harus dikompilasi ke JavaScript.
+
+## Strategi 1: VPS (Ubuntu/Debian) dengan PM2
+
+Ini adalah cara paling umum dan hemat biaya.
+
+### 1. Setup Server
+
+Pastikan Node.js dan NPM sudah terinstall di server.
+
+### 2. Clone & Install
+
+```bash
+git clone https://github.com/username/repo-anda.git
+cd repo-anda
+npm install --production=false # Install devDependencies juga untuk build
+```
+
+### 3. Build Aplikasi
+
+```bash
+npm run build
+```
+
+Ini akan menghasilkan folder `dist/`.
+
+### 4. Setup Konfigurasi Production
+
+```bash
+cp .env.example .env
+nano .env # Isi dengan config production
+```
+
+### 5. Jalankan dengan PM2
+
+lapeeh kini menyertakan konfigurasi otomatis PM2 (`ecosystem.config.js`).
+
+1.  **Install PM2 Global**:
+
+    ```bash
+    npm install -g pm2
+    ```
+
+2.  **Jalankan Aplikasi**:
+
+    ```bash
+    pm2 start ecosystem.config.js
+    ```
+
+    Perintah ini akan:
+
+    - Menjalankan aplikasi dalam mode **Cluster** (menggunakan semua core CPU yang tersedia).
+    - Mengatur `NODE_ENV` ke `production`.
+    - Mengaktifkan auto-restart jika aplikasi crash atau penggunaan memori melebihi 1GB.
+
+3.  **Cek Status**:
+
+    ```bash
+    pm2 status
+    pm2 logs
+    ```
+
+4.  **Simpan Config Startup (Agar jalan saat server reboot)**:
+    ```bash
+    pm2 save
+    pm2 startup
+    ```
+
+### ❓ FAQ: Mengapa Aplikasi Saya Muncul Ganda di PM2?
+
+Jika Anda menjalankan `pm2 list` dan melihat nama aplikasi Anda muncul lebih dari satu kali, **JANGAN KHAWATIR**. Ini adalah fitur, bukan bug.
+
+- **Penyebab**: Konfigurasi `instances: "max"` dan `exec_mode: "cluster"` di `ecosystem.config.js`.
+- **Fungsi**: PM2 mendeteksi jumlah inti CPU (Core) di VPS Anda dan membuat 1 proses worker untuk setiap core.
+- **Keuntungan**: Aplikasi Anda menjadi **Multi-Threaded**.
+
+**Cara mengubah ke Single Instance (Hemat RAM):**
+Jika RAM server Anda terbatas, ubah `ecosystem.config.js`:
+
+```javascript
+module.exports = {
+  apps: [
+    {
+      name: "my-app",
+      // ...
+      instances: 1, // Ubah "max" menjadi 1
+      // ...
+    },
+  ],
+};
+```
+
+Lalu jalankan `pm2 reload ecosystem.config.js`.
+
+### 7. Advanced: Menjalankan Beberapa Aplikasi (Multi-App)
+
+Anda bisa menggabungkannya dalam satu file `ecosystem.config.js`.
+
+### 8. Reverse Proxy (Nginx)
+
+Jangan expose port 8000 langsung. Gunakan Nginx di depannya.
+Config Nginx block:
+
+```nginx
+server {
+    server_name api.domain-anda.com;
+    location / {
+        proxy_pass http://localhost:8000;
+        proxy_http_version 1.1;
+        proxy_set_header Upgrade $http_upgrade;
+        proxy_set_header Connection 'upgrade';
+        proxy_set_header Host $host;
+        proxy_cache_bypass $http_upgrade;
+    }
+}
+```
+
+## Strategi 2: Docker (Container)
+
+lapeeh sudah menyertakan `Dockerfile`.
+
+**Dockerfile Minimal:**
+
+```dockerfile
+FROM node:18-alpine
+
+WORKDIR /app
+
+COPY package*.json ./
+RUN npm install
+
+COPY . .
+RUN npm run build
+
+EXPOSE 8000
+CMD ["npm", "run", "start:prod"]
+```
+
+**Deploy:**
+
+```bash
+docker build -t my-lapeeh-app .
+docker run -p 8000:8000 --env-file .env my-lapeeh-app
+```
+
+## Strategi 3: PaaS (Railway / Render / Vercel)
+
+Platform seperti Railway.app sangat mudah karena mendeteksi `package.json`.
+
+1.  Push kode ke GitHub.
+2.  Connect repo di Railway/Render.
+3.  Set Environment Variables di dashboard mereka.
+4.  Set **Build Command**: `npm run build`.
+5.  Set **Start Command**: `npm run start:prod`.
+
+## Checklist Keamanan Production
+
+- [ ] `NODE_ENV=production` harus diset.
+- [ ] `JWT_SECRET` harus panjang dan acak.
+- [ ] Database credential (jika ada) harus aman.
+- [ ] Rate Limiting aktif (default lapeeh sudah aktif).
+- [ ] Gunakan HTTPS (SSL) via Nginx atau Cloudflare.

package/doc/id/FAQ.md

@@ -0,0 +1,69 @@
+# Frequently Asked Questions (FAQ)
+
+Kumpulan pertanyaan umum dan solusi untuk masalah yang sering dihadapi.
+
+## Database
+
+### Q: Database apa yang didukung?
+
+**A:**
+lapeeh bersifat **Database Agnostic**. Anda bisa menggunakan PostgreSQL, MySQL, MongoDB, atau database apapun. Framework tidak membatasi pilihan database Anda. Kami menyediakan wrapper `db` generik yang bisa Anda konfigurasi sesuai kebutuhan.
+
+## Redis & Caching
+
+### Q: Saya tidak ingin pakai Redis di local, ribet installnya.
+
+**A:**
+Tenang, lapeeh otomatis mendeteksi jika Redis tidak berjalan dan akan menggunakan **In-Memory Mock** (simulasi Redis di RAM). Aplikasi tetap jalan normal tanpa error. Anda tidak perlu config apa-apa.
+
+### Q: Bagaimana cara clear cache Redis?
+
+**A:**
+Jika punya akses CLI Redis: `redis-cli FLUSHALL`.
+Atau via kode:
+
+```typescript
+import { redis } from "@/core/redis";
+await redis.flushall();
+```
+
+## Fitur & Kustomisasi
+
+### Q: Bagaimana cara handle File Upload?
+
+**A:**
+Gunakan `multer`. Framework sudah menyiapkannya di `src/routes/auth.ts` sebagai contoh (upload avatar).
+Anda bisa copy logic konfigurasi `multer` tersebut ke route lain.
+
+### Q: Bagaimana cara menambah middleware global baru?
+
+**A:**
+Buka `src/core/server.ts`. Di sana ada bagian `// Global Middlewares`. Tambahkan middleware Express Anda di situ:
+
+```typescript
+app.use(myCustomMiddleware);
+```
+
+### Q: Saya ingin mengubah port server.
+
+**A:**
+Cukup ubah variabel `PORT` di file `.env`. Defaultnya adalah `8000`.
+
+## Troubleshooting
+
+### Q: Error `EADDRINUSE: address already in use :::8000`
+
+**A:**
+Artinya port 8000 sedang dipakai program lain (atau instance lapeeh sebelumnya yang nyangkut).
+**Solusi:**
+
+1. Matikan terminal.
+2. Jalankan perintah kill (framework biasanya memberi saran commandnya saat error muncul).
+   - Windows: `taskkill /F /IM node.exe` (Hati-hati ini mematikan semua node process).
+   - Atau cari PID nya: `netstat -ano | findstr :8000`.
+
+### Q: Error `Unique constraint failed` saat seeding
+
+**A:**
+Data yang mau dimasukkan sudah ada (misal email `sa@sa.com`).
+Jalankan `npm run db:reset` untuk menghapus semua data dan mulai dari nol.

package/doc/id/FEATURES.md

@@ -0,0 +1,169 @@
+# Fitur & Konsep Inti
+
+Dokumen ini menjelaskan fitur-fitur utama lapeeh Framework dan cara penggunaannya secara mendalam.
+
+3. **Explicit is Better than Implicit**: Tidak ada "sihir" yang terlalu gelap. Kode controller Anda adalah kode Express biasa yang Anda mengerti.
+
+## 1. Validasi Data (Simple & Powerful)
+
+Framework ini menyediakan utility `Validator` yang terinspirasi dari gaya validasi modern yang ekspresif, menggunakan `zod` di belakang layar namun dengan API yang lebih string-based dan mudah dibaca.
+
+**Lokasi:** `@lapeeh/utils/validator`
+
+### Penggunaan Dasar
+
+```typescript
+import { Validator } from "@lapeeh/utils/validator";
+
+export async function createProduct(req: Request, res: Response) {
+  const validator = await Validator.make(req.body, {
+    name: "required|string|min:3",
+    price: "required|number|min:1000",
+    email: "required|email|unique:user,email", // Cek unik di tabel user kolom email
+    category_id: "required|exists:category,id", // Cek exist di tabel category kolom id
+    photo: "required|image|max:2048", // Validasi file upload (Max 2MB)
+  });
+
+  if (validator.fails()) {
+    return sendError(res, 400, "Validation failed", validator.errors());
+  }
+
+  const data = validator.validated();
+  // Lanjut proses simpan...
+}
+```
+
+### Aturan Tersedia (Rules)
+
+- `required`: Wajib diisi.
+- `string`, `number`, `boolean`: Tipe data.
+- `email`: Format email valid.
+- `min:X`, `max:X`: Panjang string atau nilai number.
+- `unique:table,column`: Pastikan nilai belum ada di database (Async).
+- `exists:table,column`: Pastikan nilai ada di database (Async).
+- `image`: File harus berupa gambar (jpg, png, webp, dll).
+- `mimes:types`: File harus tipe tertentu (misal: `mimes:pdf,docx`).
+
+## 2. High Performance Response (Fastify-Like)
+
+Untuk endpoint yang membutuhkan performa tinggi (misalnya list data besar), gunakan serialisasi berbasis schema. Ini jauh lebih cepat daripada `res.json` standar Express.
+
+**Lokasi:** `@/utils/response`, `@/core/serializer`
+
+### Langkah Implementasi
+
+1. **Definisikan Schema Output**
+   Sesuaikan dengan field yang ingin ditampilkan ke user.
+
+   ```typescript
+   const productSchema = {
+     type: "object",
+     properties: {
+       id: { type: "string" }, // BigInt otomatis jadi string
+       name: { type: "string" },
+       price: { type: "number" },
+     },
+   };
+   ```
+
+2. **Buat Serializer (Cached)**
+   Simpan di luar handler function agar dicompile sekali saja.
+
+   ```typescript
+   import { getSerializer, createResponseSchema } from "@/core/serializer";
+
+   const productSerializer = getSerializer(
+     "product-single",
+     createResponseSchema(productSchema)
+   );
+   ```
+
+3. **Kirim Response**
+
+   ```typescript
+   import { sendFastSuccess } from "@lapeeh/utils/response";
+
+   // Di dalam controller
+   sendFastSuccess(res, 200, productSerializer, {
+     status: "success",
+     message: "Data retrieved",
+     data: productData,
+   });
+   ```
+
+## 3. Authentication & Authorization (RBAC)
+
+Sistem autentikasi menggunakan JWT (JSON Web Token) dan mendukung Role-Based Access Control.
+
+### Middleware Auth
+
+- `requireAuth`: Memastikan user login (mengirim header `Authorization: Bearer <token>`).
+- `requireAdmin`: Memastikan user login DAN memiliki role `admin` atau `super_admin`.
+
+**Contoh di Route:**
+
+```typescript
+import { requireAuth, requireAdmin } from "@/middleware/auth";
+
+router.get("/profile", requireAuth, getProfile); // Login only
+router.delete("/users/:id", requireAuth, requireAdmin, deleteUser); // Admin only
+```
+
+### Helper RBAC (Role Based Access Control)
+
+Anda bisa mengecek permission secara granular di dalam controller:
+
+```typescript
+// (Contoh implementasi, logic ada di AuthController/RbacController)
+if (req.user.role !== "manager") {
+  return sendError(res, 403, "Forbidden");
+}
+```
+
+## 4. Caching & Redis
+
+Framework ini memiliki integrasi Redis "Zero-Config".
+
+- Jika `REDIS_URL` ada di `.env` dan server Redis berjalan, framework akan connect.
+- Jika tidak ada atau gagal connect, framework otomatis fallback ke **In-Memory Mock**. Ini membuat development di local tidak wajib install Redis.
+
+**Mengakses Redis:**
+
+```typescript
+import { redis } from "@/core/redis";
+
+// Set cache (1 jam)
+await redis.set("my-key", "value", "EX", 3600);
+
+// Get cache
+const val = await redis.get("my-key");
+```
+
+## 5. Keamanan (Security)
+
+Secara default, framework sudah menerapkan:
+
+- **Helmet**: Mengamankan HTTP headers.
+- **CORS**: Mengizinkan akses lintas domain (configurable).
+- **Rate Limiting**: Membatasi jumlah request per IP untuk mencegah DDoS/Brute Force.
+  - Konfigurasi ada di `src/middleware/rateLimit.ts`.
+  - Default: 100 request / 15 menit.
+
+## 6. Import Path Aliases
+
+Gunakan `@/` untuk import module agar kode lebih bersih.
+
+- `@/core` -> `src/core`
+- `@/controllers` -> `src/controllers`
+- `@/utils` -> `src/utils`
+- `@/middleware` -> `src/middleware`
+
+**Contoh:**
+
+```typescript
+import { db } from "@/core/database"; // ✅ Rapi
+
+// vs
+
+import { db } from "../../../core/database"; // ❌ Berantakan
+```

package/doc/id/GETTING_STARTED.md

@@ -0,0 +1,91 @@
+# Getting Started with lapeeh Framework
+
+Selamat datang di dokumentasi resmi **lapeeh Framework**. Panduan ini akan membantu Anda memulai instalasi, konfigurasi, dan pemahaman dasar tentang struktur proyek.
+
+## Persyaratan Sistem
+
+Sebelum memulai, pastikan sistem Anda memenuhi persyaratan berikut:
+
+- **Node.js**: Versi 18.x atau lebih baru.
+- **Package Manager**: NPM (bawaan Node.js).
+
+## Instalasi
+
+Cara termudah untuk memulai adalah menggunakan CLI generator `npx`.
+
+### 1. Buat Project Baru
+
+Jalankan perintah berikut di terminal Anda:
+
+```bash
+# Setup Interaktif Standar
+npx lapeeh@latest init nama-project-anda
+```
+
+### 2. Setup Awal
+
+Setelah project dibuat, masuk ke direktori project dan jalankan setup wizard:
+
+```bash
+cd nama-project-anda
+npm run first
+```
+
+Script ini akan melakukan hal-hal berikut secara otomatis:
+
+1.  Menyalin `.env.example` ke `.env`.
+2.  Menginstall semua dependency (`npm install`).
+3.  Membuat **JWT Secret** yang aman.
+
+### 3. Jalankan Server Development
+
+```bash
+npm run dev
+```
+
+Server akan berjalan di `http://localhost:8000` (atau port yang Anda tentukan di `.env`).
+
+## Struktur Direktori
+
+Berikut adalah struktur folder standar lapeeh Framework:
+
+```
+my-app/
+├── bin/                  # Script CLI untuk npx
+├── doc/                  # Dokumentasi proyek
+├── scripts/              # Script utility (Generator, Compiler)
+├── src/                  # Source code utama aplikasi
+│   ├── controllers/      # Logika bisnis (Handler request)
+│   ├── core/             # Konfigurasi inti (Redis, Server)
+│   ├── middleware/       # Middleware Express (Auth, RateLimit)
+│   ├── routes/           # Definisi routing API
+│   ├── utils/            # Helper function (Response, Validator)
+│   └── index.ts          # Entry point aplikasi
+├── .env                  # Variabel lingkungan (Rahasia)
+├── package.json          # Dependensi & Script NPM
+└── tsconfig.json         # Konfigurasi TypeScript
+```
+
+## Konfigurasi Environment (.env)
+
+File `.env` menyimpan konfigurasi penting. Berikut adalah variabel kunci:
+
+```ini
+# Server
+PORT=8000
+NODE_ENV=development
+
+# Security
+JWT_SECRET="rahasia-super-panjang-dan-acak"
+ACCESS_TOKEN_EXPIRES_IN=3600 # 1 jam
+
+# Redis (Opsional - otomatis mock jika tidak ada)
+REDIS_URL="redis://localhost:6379"
+NO_REDIS=false # Set true untuk memaksa mode mock
+```
+
+## Langkah Selanjutnya
+
+- Pelajari cara menggunakan **[CLI Tools](CLI.md)** untuk mempercepat development.
+- Pahami **[Fitur & Konsep Inti](FEATURES.md)** framework.
+- Ikuti **[Tutorial Studi Kasus](TUTORIAL.md)** untuk membangun fitur nyata.

package/doc/id/INTRODUCTION.md

@@ -0,0 +1,62 @@
+# Pengenalan lapeeh Framework
+
+## Apa itu lapeeh?
+
+**lapeeh** adalah framework Backend untuk Node.js yang dibangun di atas **Express** dan **TypeScript**.
+
+Jika Anda pernah menggunakan framework modern lainnya, Anda akan merasa sangat familiar. lapeeh mengambil filosofi kemudahan & struktur rapi, namun tetap mempertahankan fleksibilitas dan kecepatan Express.
+
+Nama "lapeeh" diambil dari bahasa Minang yang berarti "Lepas" atau "Bebas", melambangkan kebebasan developer untuk membangun aplikasi dengan cepat tanpa terbebani konfigurasi yang rumit.
+
+## Mengapa lapeeh Dibuat?
+
+Di ekosistem Node.js, developer sering mengalami "Decision Fatigue" (Kelelahan memilih):
+
+- "Pakai ORM apa? Prisma, TypeORM, atau Drizzle?"
+- "Validasi pakai Joi, Zod, atau express-validator?"
+- "Struktur foldernya gimana? MVC? Clean Architecture?"
+- "Auth-nya gimana?"
+
+lapeeh menjawab semua itu dengan **Opinionated Defaults**:
+
+1.  **Database**: Agnostic (Bebas pilih: Prisma, TypeORM, Drizzle, dll).
+2.  **Validasi**: Zod (Validasi skema yang kuat dan mudah dibaca).
+3.  **Struktur**: MVC Modular (Controller, Model, Route terpisah tapi kohesif).
+4.  **Auth**: JWT + RBAC (Role Based Access Control) siap pakai.
+
+## Perbandingan dengan Framework Lain
+
+| Fitur              | Express (Raw)                  | NestJS                             | lapeeh Framework                      |
+| :----------------- | :----------------------------- | :--------------------------------- | :------------------------------------ |
+| **Learning Curve** | Rendah (tapi bingung struktur) | Tinggi (Angular-style, Decorators) | **Sedang** (Express + Struktur Jelas) |
+| **Boilerplate**    | Kosong                         | Sangat Banyak                      | **Pas (Ready to use)**                |
+| **Type Safety**    | Manual                         | Strict                             | **Strict (TypeScript Native)**        |
+| **Kecepatan Dev**  | Lambat (setup manual)          | Sedang                             | **Cepat (CLI Generator)**             |
+| **Fleksibilitas**  | Sangat Tinggi                  | Kaku                               | **Tinggi**                            |
+
+## Filosofi "The lapeeh Way"
+
+1.  **Developer Experience (DX) First**: CLI tools, error message yang jelas, dan hot-reload adalah prioritas.
+2.  **Performance by Default**: Serialisasi JSON cepat (Fastify-style) dan Redis caching terintegrasi.
+3.  **Explicit is Better than Implicit**: Tidak ada "sihir" yang terlalu gelap. Kode controller Anda adalah kode Express biasa yang Anda mengerti.
+4.  **Production Ready**: Security (Helmet, Rate Limit) dan Scalability (Docker, Cluster) bukan pikiran belakangan, tapi bawaan.
+
+## Siklus Hidup Request (Request Lifecycle)
+
+Bagaimana lapeeh menangani satu permintaan dari user?
+
+1.  **Request Masuk** (`GET /api/users`)
+2.  **Security Middleware**: Helmet (Headers), CORS, Rate Limiter.
+3.  **Global Middleware**: Request Logger, Body Parser (JSON).
+4.  **Routing**: Mencocokkan URL di `src/routes/`.
+5.  **Auth Middleware** (Opsional): Cek token JWT & Role.
+6.  **Validator** (Opsional): Validasi input body/query.
+7.  **Controller**: Logika bisnis utama dijalankan.
+    - Panggil Database (via `db` adapter).
+    - Panggil Cache (Redis).
+8.  **Serializer**: Data diformat & disanitasi (misal: hide password).
+9.  **Response**: JSON dikirim kembali ke user.
+
+---
+
+**Selanjutnya:** Pelajari struktur folder di [Struktur Proyek](STRUCTURE.md).

package/doc/id/PACKAGES.md

@@ -0,0 +1,63 @@
+# Referensi Package & Dependencies
+
+Dokumen ini menjelaskan fungsi dari setiap library (package) yang terinstall di lapeeh Framework, sehingga Anda mengerti kegunaan "alat-alat" yang ada di dalam kotak peralatan Anda.
+
+## Core Framework (Fondasi)
+
+Package-package ini adalah nyawa dari framework ini.
+
+| Package       | Deskripsi                         | Kenapa Kita Pakai?                                                                                      |
+| :------------ | :-------------------------------- | :------------------------------------------------------------------------------------------------------ |
+| **`express`** | Web Framework untuk Node.js.      | Standar industri, ringan, dan komunitasnya terbesar.                                                    |
+| **`dotenv`**  | Memuat variabel dari file `.env`. | Agar konfigurasi rahasia (DB password, API Key) tidak di-hardcode.                                      |
+| **`cors`**    | Cross-Origin Resource Sharing.    | Mengizinkan frontend (React/Vue) dari domain berbeda untuk mengakses API kita.                          |
+| **`helmet`**  | Middleware keamanan HTTP headers. | Melindungi aplikasi dari serangan umum (XSS, Clickjacking) dengan mengatur header HTTP secara otomatis. |
+
+## Database Driver
+
+| Package  | Deskripsi          | Kenapa Kita Pakai?                                |
+| :------- | :----------------- | :------------------------------------------------ |
+| **`pg`** | Driver PostgreSQL. | Driver native untuk koneksi ke database Postgres. |
+
+## Authentication & Security
+
+| Package                  | Deskripsi         | Kenapa Kita Pakai?                                    |
+| :----------------------- | :---------------- | :---------------------------------------------------- |
+| **`jsonwebtoken`**       | Implementasi JWT. | Standar token untuk autentikasi stateless (API).      |
+| **`bcryptjs`**           | Hashing password. | Mengamankan password user di database (satu arah).    |
+| **`express-rate-limit`** | Pembatas request. | Mencegah serangan DDoS ringan atau Brute Force login. |
+
+## Utilities & Helper
+
+| Package                   | Deskripsi                  | Kenapa Kita Pakai?                                                             |
+| :------------------------ | :------------------------- | :----------------------------------------------------------------------------- |
+| **`zod`**                 | Schema validation library. | Memvalidasi input user (req.body) dengan syntax yang kuat dan mudah dibaca.    |
+| **`fast-json-stringify`** | Serializer JSON cepat.     | Mengubah object ke JSON string 2x-3x lebih cepat dari `JSON.stringify` bawaan. |
+| **`uuid`**                | Generator ID unik.         | Membuat string acak unik (UUID v4).                                            |
+| **`slugify`**             | String formatter.          | Mengubah "Judul Artikel Keren" menjadi `judul-artikel-keren` (URL friendly).   |
+| **`multer`**              | Middleware upload file.    | Menangani `multipart/form-data` untuk upload gambar/dokumen.                   |
+| **`winston`**             | Logger library.            | Mencatat log aplikasi (error/info) ke file atau console dengan format rapi.    |
+
+## Realtime & Caching
+
+| Package            | Deskripsi                 | Kenapa Kita Pakai?                                                                            |
+| :----------------- | :------------------------ | :-------------------------------------------------------------------------------------------- |
+| **`socket.io`**    | Library WebSocket.        | Fitur komunikasi real-time dua arah (chat, notifikasi live).                                  |
+| **`ioredis`**      | Client Redis yang robust. | Driver terbaik untuk Redis di Node.js.                                                        |
+| **`ioredis-mock`** | Simulasi Redis di memori. | Memungkinkan development tanpa perlu install Redis server asli (sangat berguna untuk pemula). |
+
+## Development Tools (DevDependencies)
+
+Package ini hanya dipakai saat koding, tidak ikut terinstall di server production.
+
+| Package          | Deskripsi             | Fungsi                                                                        |
+| :--------------- | :-------------------- | :---------------------------------------------------------------------------- |
+| **`typescript`** | Compiler TS.          | Mengubah kode `.ts` menjadi `.js`.                                            |
+| **`nodemon`**    | Auto-restarter.       | Restart server otomatis setiap kita save file.                                |
+| **`eslint`**     | Linter (Polisi Kode). | Mencari potensi error dan variabel yang tidak terpakai.                       |
+| **`@types/*`**   | Definisi Tipe.        | Memberikan intellisense (saran kode) untuk library JavaScript biasa.          |
+| **`tsc-alias`**  | Path resolver.        | Mengubah alias `@/core` menjadi path relatif `../core` saat build production. |
+
+---
+
+Dengan memahami daftar ini, Anda tahu persis apa yang terjadi di balik layar aplikasi Anda. Tidak ada "Bloatware", setiap package punya tujuan spesifik.