lapeh 2.3.6 → 2.3.8

package/doc/DEPLOYMENT.md

@@ -1,122 +0,0 @@
-# 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/doc/FAQ.md

@@ -1,81 +0,0 @@
-# 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/doc/FEATURES.md

@@ -1,165 +0,0 @@
-# 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/doc/GETTING_STARTED.md

@@ -1,108 +0,0 @@
-# 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/doc/INTRODUCTION.md

@@ -1,60 +0,0 @@
-# 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).

package/doc/PACKAGES.md

@@ -1,66 +0,0 @@
-# Referensi Package & Dependencies
-
-Dokumen ini menjelaskan fungsi dari setiap library (package) yang terinstall di Lapeh 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 & ORM
-
-| Package | Deskripsi | Kenapa Kita Pakai? |
-| :--- | :--- | :--- |
-| **`@prisma/client`** | Query builder & ORM. | Type-safe query database. Autocomplete-nya sangat membantu developer. |
-| **`pg`** | Driver PostgreSQL. | Driver native untuk koneksi ke database Postgres. |
-| **`@prisma/adapter-*`** | Adapter serverless. | (Opsional) Persiapan untuk deployment ke environment serverless (seperti Vercel/Neon). |
-
-## 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. |
-| **`prisma`** | Prisma CLI. | Alat untuk migrasi database (`prisma migrate`) dan generate client. |
-| **`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.

package/doc/PERFORMANCE.md

@@ -1,91 +0,0 @@
-# Panduan Performa & Skalabilitas Lapeh Framework
-
-Dokumen ini menjelaskan cara memaksimalkan performa aplikasi Lapeh Anda menggunakan fitur-fitur canggih seperti Fast-Serialization dan Clustering.
-
-## 1. High Performance Serialization (Fastify-Style)
-
-Express secara default menggunakan `JSON.stringify()` yang lambat karena harus memeriksa tipe data setiap field secara runtime. Lapeh mengadopsi teknik **Schema Based Serialization** (seperti Fastify) yang bisa meningkatkan throughput JSON hingga **2x-3x lipat**.
-
-### Cara Penggunaan
-
-Gunakan `sendFastSuccess` di controller Anda untuk endpoint yang membutuhkan performa tinggi (misalnya: list data yang besar).
-
-```typescript
-import { Request, Response } from "express";
-import { getSerializer, createResponseSchema } from "../core/serializer";
-import { sendFastSuccess } from "../utils/response";
-
-// 1. Definisikan Schema Output (JSON Schema Standard)
-const userSchema = {
-  type: "object",
-  properties: {
-    id: { type: "integer" },
-    name: { type: "string" },
-    email: { type: "string" },
-    // Password tidak dimasukkan, jadi otomatis tidak akan terkirim (aman!)
-  }
-};
-
-// 2. Compile Serializer (Otomatis dicache oleh framework)
-const userListSerializer = getSerializer("user-list", createResponseSchema({
-  type: "array",
-  items: userSchema
-}));
-
-export async function getUsers(req: Request, res: Response) {
-  const users = await prisma.users.findMany();
-
-  // 3. Kirim response super cepat
-  return sendFastSuccess(res, 200, userListSerializer, {
-    status: "success",
-    message: "Data fetched",
-    data: users
-  });
-}
-```
-
----
-
-## 2. Horizontal Scaling (Load Balancer & Cluster)
-
-Lapeh dirancang untuk siap di-scale secara horizontal (menambah jumlah server, bukan memperbesar spesifikasi server).
-
-### Arsitektur Cluster
-- **Nginx**: Bertindak sebagai Load Balancer yang membagi trafik ke server-server aplikasi.
-- **Redis**: Menyimpan Session, Rate Limit, dan Cache agar bisa diakses oleh semua server (Shared State).
-- **App Instances**: Beberapa instance aplikasi Lapeh yang berjalan paralel.
-
-### Cara Menjalankan Cluster (Docker)
-
-Kami telah menyediakan konfigurasi siap pakai di `docker-compose.cluster.yml`.
-
-1. **Build & Run Cluster**:
-   ```bash
-   docker-compose -f docker-compose.cluster.yml up --build
-   ```
-
-2. **Akses Aplikasi**:
-   Buka `http://localhost:8080`.
-   Nginx akan otomatis membagi request Anda ke `app-1` atau `app-2`.
-
-3. **Cek Status**:
-   ```bash
-   docker-compose -f docker-compose.cluster.yml ps
-   ```
-
-### Konfigurasi Rate Limiter Terdistribusi
-Middleware `src/middleware/rateLimit.ts` telah diupdate untuk menggunakan Redis Store.
-Ini artinya jika User A terkena limit di Server 1, dia juga akan terblokir di Server 2.
-
-```typescript
-// src/middleware/rateLimit.ts
-store: redis ? new RedisStore({ sendCommand: ... }) : undefined
-```
-
----
-
-## 3. Tips Optimasi Lainnya
-
-- **Gunakan `.lean()` / Select**: Saat query database, selalu pilih field yang dibutuhkan saja.
-- **Compression**: Aktifkan gzip/brotli di Nginx (sudah ada di config default Nginx umumnya).
-- **Keep-Alive**: Gunakan koneksi database yang persistent (sudah dihandle oleh Prisma).