lapeh 2.2.7 → 2.2.9

package/api-testing-tujuhbelas/api-testing-enambelas/doc/CONTRIBUTING.md

@@ -0,0 +1,105 @@
+# Panduan Kontribusi (Contributing Guide)
+
+Terima kasih atas ketertarikan Anda untuk berkontribusi pada pengembangan **Lapeh Framework**! 🎉
+
+Proyek ini bersifat **Open Source** dan kami sangat menghargai setiap bentuk kontribusi, baik itu perbaikan bug, penambahan fitur, dokumentasi, maupun sekadar laporan error (issue).
+
+Dokumen ini akan memandu Anda tentang cara berkontribusi dengan benar dan efisien.
+
+## 🚀 Memulai Kontribusi
+
+### 1. Persiapan Lingkungan (Prerequisites)
+Pastikan Anda sudah menginstal:
+- **Node.js** (v18 ke atas)
+- **Git**
+- **Code Editor** (VS Code disarankan, dengan ekstensi ESLint & Prettier)
+
+### 2. Fork & Clone Repository
+1.  **Fork** repository ini ke akun GitHub Anda (tombol "Fork" di pojok kanan atas).
+2.  **Clone** hasil fork ke komputer lokal Anda:
+    ```bash
+    git clone https://github.com/USERNAME_ANDA/lapeh.git
+    cd lapeh
+    ```
+3.  **Tambahkan Remote Upstream** (agar bisa sinkron dengan repo asli):
+    ```bash
+    git remote add upstream https://github.com/robyajo/lapeh.git
+    ```
+
+### 3. Instalasi Dependencies
+```bash
+npm install
+```
+Jangan lupa jalankan setup awal untuk database lokal (pastikan PostgreSQL/MySQL jalan):
+```bash
+cp .env.example .env
+npm run prisma:migrate
+npm run db:seed
+```
+
+## 🛠️ Workflow Pengembangan
+
+### 1. Buat Branch Baru
+Jangan bekerja langsung di branch `main`. Buat branch baru yang deskriptif:
+```bash
+git checkout -b feature/tambah-validasi-email
+# atau
+git checkout -b fix/typo-dokumentasi
+```
+
+### 2. Standar Koding (Coding Standards)
+Kami menerapkan aturan yang ketat demi menjaga kualitas kode.
+- **TypeScript**: Gunakan tipe data eksplisit. Hindari `any` sebisa mungkin.
+- **Linter**: Pastikan tidak ada error ESLint. Variabel tidak terpakai harus dihapus atau diberi prefix `_`.
+- **Formatter**: Kode harus rapi.
+
+Sebelum commit, **WAJIB** jalankan perintah ini untuk memastikan kode Anda bersih:
+```bash
+npm run typecheck  # Cek error TypeScript
+npm run lint       # Cek error Linter
+```
+
+### 3. Commit Message Convention
+Gunakan format **Conventional Commits** agar history mudah dibaca:
+- `feat: ...` untuk fitur baru.
+- `fix: ...` untuk perbaikan bug.
+- `docs: ...` untuk perubahan dokumentasi.
+- `chore: ...` untuk perubahan kecil (config, script).
+- `refactor: ...` untuk perbaikan struktur kode tanpa mengubah fitur.
+
+**Contoh:**
+```text
+feat: add email validation rule to validator
+fix: resolve EADDRINUSE error on windows
+docs: update installation guide
+```
+
+## 📮 Mengirim Pull Request (PR)
+
+1.  **Push** branch Anda ke GitHub:
+    ```bash
+    git push origin feature/nama-fitur
+    ```
+2.  Buka repository fork Anda di GitHub, lalu klik **Compare & pull request**.
+3.  Isi judul dan deskripsi PR dengan jelas:
+    - Jelaskan apa yang Anda ubah.
+    - Sertakan screenshot (jika ada perubahan visual/output).
+    - Referensikan Issue jika ada (contoh: `Closes #123`).
+4.  Tunggu review dari maintainer. Kami mungkin akan meminta revisi kecil.
+5.  Setelah disetujui, kode Anda akan di-merge! 🚀
+
+## 🐛 Melaporkan Bug (Issues)
+
+Jika Anda menemukan bug tapi belum bisa memperbaikinya, silakan buat **Issue** baru.
+- Gunakan judul yang jelas.
+- Jelaskan langkah-langkah untuk mereproduksi bug (Steps to Reproduce).
+- Sertakan log error atau screenshot.
+- Sebutkan versi Node.js dan OS yang digunakan.
+
+## 💡 Ide & Diskusi
+
+Punya ide fitur baru? Jangan ragu untuk membukanya di **GitHub Discussions** atau buat Issue dengan label `enhancement` sebelum mulai koding, agar kita bisa mendiskusikan desainnya terlebih dahulu.
+
+---
+
+Selamat berkontribusi! Kode Anda akan membantu developer lain membangun aplikasi dengan lebih cepat dan menyenangkan. ❤️

package/api-testing-tujuhbelas/api-testing-enambelas/doc/DEPLOYMENT.md

@@ -0,0 +1,122 @@
+# Deployment Guide
+
+Panduan ini akan membantu Anda membawa aplikasi Lapeh dari `localhost` ke Server Production (VPS/Cloud).
+
+## Persiapan Pra-Deploy
+
+Sebelum deploy, pastikan:
+
+1.  **Environment Variables**: Siapkan nilai `.env` untuk production (DB URL asli, JWT Secret yang kuat).
+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, NPM, dan Database (PostgreSQL/MySQL) 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 Database Production
+
+```bash
+# Setup .env dulu
+cp .env.example .env
+nano .env # Isi dengan config production
+
+# Jalankan migrasi (Hanya deploy schema, jangan reset!)
+npm run prisma:deploy
+```
+
+### 5. Jalankan dengan PM2
+
+Gunakan PM2 agar aplikasi jalan di background dan auto-restart jika crash.
+
+```bash
+npm install -g pm2
+npm run start:prod # Atau: pm2 start dist/src/index.js --name "api-lapeh"
+```
+
+### 6. Reverse Proxy (Nginx)
+
+Jangan expose port 4000 langsung. Gunakan Nginx di depannya.
+Config Nginx block:
+
+```nginx
+server {
+    server_name api.domain-anda.com;
+    location / {
+        proxy_pass http://localhost:4000;
+        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)
+
+Lapeh sudah menyertakan `Dockerfile` (jika belum, buat sederhana saja).
+
+**Dockerfile Minimal:**
+
+```dockerfile
+FROM node:18-alpine
+
+WORKDIR /app
+
+COPY package*.json ./
+RUN npm install
+
+COPY . .
+RUN npm run build
+
+EXPOSE 4000
+CMD ["npm", "run", "start:prod"]
+```
+
+**Deploy:**
+
+```bash
+docker build -t my-lapeh-app .
+docker run -p 4000:4000 --env-file .env my-lapeh-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`.
+
+**Catatan Khusus Vercel (Serverless):**
+Lapeh didesain sebagai _Long-Running Server_ (Express). Deploy ke Vercel dimungkinkan tapi butuh wrapper serverless (seperti `vercel-express`). Untuk performa terbaik, disarankan menggunakan VPS atau Container (Railway/Fly.io).
+
+## Checklist Keamanan Production
+
+- [ ] `NODE_ENV=production` harus diset.
+- [ ] `JWT_SECRET` harus panjang dan acak.
+- [ ] Database tidak boleh terekspos ke publik (gunakan private network atau firewall).
+- [ ] Rate Limiting aktif (default Lapeh sudah aktif).
+- [ ] Gunakan HTTPS (SSL) via Nginx atau Cloudflare.

package/api-testing-tujuhbelas/api-testing-enambelas/doc/FAQ.md

@@ -0,0 +1,81 @@
+# Frequently Asked Questions (FAQ)
+
+Kumpulan pertanyaan umum dan solusi untuk masalah yang sering dihadapi.
+
+## Database
+
+### Q: Bagaimana cara mengganti database dari PostgreSQL ke MySQL?
+**A:**
+1. Buka `prisma/base.prisma.template`.
+2. Ubah `provider = "postgresql"` menjadi `provider = "mysql"`.
+3. Di `.env`, ubah `DATABASE_URL` formatnya menjadi format MySQL (`mysql://user:pass@host:3306/db`).
+4. Hapus folder `prisma/migrations` (jika baru mulai) atau siapkan strategi migrasi.
+5. Jalankan `npm run prisma:migrate`.
+
+### Q: Bagaimana cara membuat relasi antar tabel?
+**A:**
+Definisikan relasi di file `.prisma` masing-masing. Karena file akan digabung, Anda bisa mereferensikan model yang ada di file lain.
+**File `user.prisma`:**
+```prisma
+model User {
+  id    Int    @id
+  posts Post[] // Relasi ke Post
+}
+```
+**File `post.prisma`:**
+```prisma
+model Post {
+  id       Int  @id
+  authorId Int
+  author   User @relation(fields: [authorId], references: [id]) // Relasi ke User
+}
+```
+
+## Redis & Caching
+
+### Q: Saya tidak ingin pakai Redis di local, ribet installnya.
+**A:**
+Tenang, Lapeh 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 `4000`.
+
+## Troubleshooting
+
+### Q: Error `EADDRINUSE: address already in use :::4000`
+**A:**
+Artinya port 4000 sedang dipakai program lain (atau instance Lapeh 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 :4000`.
+
+### 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/api-testing-tujuhbelas/api-testing-enambelas/doc/FEATURES.md

@@ -0,0 +1,165 @@
+# Fitur & Konsep Inti
+
+Dokumen ini menjelaskan fitur-fitur utama Lapeh Framework dan cara penggunaannya secara mendalam.
+
+## 1. Validasi Data (Laravel-Style)
+
+Framework ini menyediakan utility `Validator` yang terinspirasi dari Laravel, menggunakan `zod` di belakang layar namun dengan API yang lebih string-based dan mudah dibaca.
+
+**Lokasi:** `@lapeh/utils/validator`
+
+### Penggunaan Dasar
+
+```typescript
+import { Validator } from "@lapeh/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-Style)
+
+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 "@lapeh/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 { prisma } from "@/core/database"; // ✅ Rapi
+// vs
+import { prisma } from "../../../core/database"; // ❌ Berantakan
+```

package/api-testing-tujuhbelas/api-testing-enambelas/doc/GETTING_STARTED.md

@@ -0,0 +1,108 @@
+# Getting Started with Lapeh Framework
+
+Selamat datang di dokumentasi resmi **Lapeh 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.
+- **Database**: PostgreSQL (Recommended) atau MySQL/MariaDB.
+- **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
+npx lapeh@latest nama-project-anda
+```
+
+Atau untuk setup lengkap (dengan data dummy user & role):
+
+```bash
+npx lapeh@latest nama-project-anda --full
+```
+
+### 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.
+4.  Menjalankan migrasi database (membuat tabel).
+5.  Menjalankan seeder (mengisi data awal).
+
+### 3. Jalankan Server Development
+
+```bash
+npm run dev
+```
+
+Server akan berjalan di `http://localhost:4000` (atau port yang Anda tentukan di `.env`).
+
+## Struktur Direktori
+
+Berikut adalah struktur folder standar Lapeh Framework:
+
+```
+my-app/
+├── bin/                  # Script CLI untuk npx
+├── doc/                  # Dokumentasi proyek
+├── prisma/               # Konfigurasi Database & Schema
+│   ├── migrations/       # File history migrasi database
+│   ├── base.prisma.template # Template konfigurasi database
+│   ├── schema.prisma     # File schema gabungan (Auto-generated)
+│   └── seed.ts           # Script untuk mengisi data awal
+├── scripts/              # Script utility (Generator, Compiler)
+├── src/                  # Source code utama aplikasi
+│   ├── controllers/      # Logika bisnis (Handler request)
+│   ├── core/             # Konfigurasi inti (DB, Redis, Server)
+│   ├── middleware/       # Middleware Express (Auth, RateLimit)
+│   ├── models/           # Definisi Schema Prisma per-fitur
+│   ├── 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=4000
+NODE_ENV=development
+
+# Database (Ganti sesuai kredensial Anda)
+DATABASE_URL="postgresql://user:password@localhost:5432/mydb?schema=public"
+
+# 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/api-testing-tujuhbelas/api-testing-enambelas/doc/INTRODUCTION.md

@@ -0,0 +1,60 @@
+# Pengenalan Lapeh Framework
+
+## Apa itu Lapeh?
+
+**Lapeh** adalah framework Backend untuk Node.js yang dibangun di atas **Express** dan **TypeScript**.
+
+Jika Anda pernah menggunakan **Laravel** (PHP) atau **NestJS** (Node.js), Anda akan merasa sangat familiar. Lapeh mengambil filosofi kemudahan & struktur rapi dari Laravel, namun tetap mempertahankan fleksibilitas dan kecepatan Express.
+
+Nama "Lapeh" diambil dari bahasa Minang yang berarti "Lepas" atau "Bebas", melambangkan kebebasan developer untuk membangun aplikasi dengan cepat tanpa terbebani konfigurasi yang rumit.
+
+## Mengapa Lapeh 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?"
+
+Lapeh menjawab semua itu dengan **Opinionated Defaults**:
+1.  **ORM**: Prisma (Standar industri saat ini).
+2.  **Validasi**: Zod (dengan wrapper syntax ala Laravel).
+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 | Lapeh 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 Lapeh 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 Lapeh 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 (Prisma).
+    - 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).