lapeh 2.6.17 → 3.0.2

package/doc/id/DEPLOYMENT.md

@@ -1,245 +1,171 @@
-# 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
-
-Lapeh 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 (misal: `my-app` ada 2 atau 4 baris), **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.
-  - Jika VPS punya 2 vCPU -> Muncul 2 proses.
-  - Jika VPS punya 4 vCPU -> Muncul 4 proses.
-- **Keuntungan**: Aplikasi Anda menjadi **Multi-Threaded**. Request yang masuk akan dibagi rata ke semua proses, meningkatkan performa 2x-4x lipat dibanding mode biasa.
-
-**Cara mengubah ke Single Instance (Hemat RAM):**
-Jika RAM server Anda terbatas (misal 512MB/1GB) dan ingin menghemat resource, 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)
-
-Jika Anda memiliki beberapa aplikasi Node.js dalam satu VPS (misalnya: Backend API, Frontend React SSR, dan API Lapeh), Anda bisa menggabungkannya dalam satu file `ecosystem.config.js`.
-
-Berikut adalah contoh konfigurasi **Real World** untuk menjalankan 3 aplikasi sekaligus:
-
-```javascript
-module.exports = {
-  apps: [
-    // 1. APLIKASI LAIN (Contoh: Backend MERN)
-    {
-      name: "api-mern-news",
-      cwd: "/var/www/html/node/api-mern-news",
-      script: "dist/src/index.js",
-      env: {
-        NODE_ENV: "production",
-        PORT: 4000,
-      },
-    },
-
-    // 2. APLIKASI LAIN (Contoh: Frontend React/Next.js)
-    {
-      name: "web-mern-news",
-      cwd: "/var/www/html/node/web-mern-news",
-      script: "npm",
-      args: "start", // Menjalankan 'npm start'
-      env: {
-        NODE_ENV: "production",
-        PORT: 3001,
-      },
-    },
-
-    // 3. APLIKASI LAPEH FRAMEWORK
-    {
-      name: "api-lapeh-project",
-      cwd: "/var/www/html/node/my-lapeh-project",
-
-      // PENTING: Gunakan binary Lapeh dari node_modules lokal
-      script: "./node_modules/lapeh/bin/index.js",
-
-      // Argument 'start' untuk mode produksi
-      args: "start",
-
-      // Mode Cluster (Gunakan semua Core CPU)
-      instances: "max",
-      exec_mode: "cluster",
-
-      // Restart jika memori bocor > 1GB
-      max_memory_restart: "1G",
-
-      // Matikan watch di production
-      watch: false,
-
-      env: {
-        NODE_ENV: "production",
-        PORT: 8001,
-      },
-    },
-  ],
-};
-```
-
-**Tips:**
-
-1.  Sesuaikan `cwd` (Current Working Directory) dengan lokasi folder proyek Anda di VPS.
-2.  Pastikan port tidak bentrok antar aplikasi (contoh di atas: 4000, 3001, 8001).
-3.  Simpan file ini di root folder proyek utama atau di folder khusus konfigurasi server Anda.
-4.  Jalankan semua aplikasi sekaligus dengan: `pm2 start ecosystem.config.js`.
-
-### 8. 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.
+# 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 (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
+
+Lapeh 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 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`.
+
+**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`.
+
+## Checklist Keamanan Production
+
+- [ ] `NODE_ENV=production` harus diset.
+- [ ] `JWT_SECRET` harus panjang dan acak.
+- [ ] Database credential (jika ada) harus aman.
+- [ ] Rate Limiting aktif (default Lapeh sudah aktif).
+- [ ] Gunakan HTTPS (SSL) via Nginx atau Cloudflare.

package/doc/id/GETTING_STARTED.md

@@ -1,115 +1,91 @@
-# 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
-# Setup Interaktif Standar
-npx lapeh@latest init nama-project-anda
-```
-
-**Opsi Setup Cepat (Flags):**
-
-- **Setup Lengkap** (Termasuk data dummy, disarankan untuk belajar):
-  ```bash
-  npx lapeh@latest init nama-project-anda --full
-  ```
-
-- **Setup Default** (Melewati pertanyaan, menggunakan PostgreSQL):
-  ```bash
-  npx lapeh@latest init nama-project-anda --y
-  ```
-
-### 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.
+# 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.
+- **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 lapeh@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: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
+├── 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=4000
+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/PACKAGES.md

@@ -58,7 +58,6 @@ Package ini hanya dipakai saat koding, tidak ikut terinstall di server productio
 | **`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. |
 
 ---