lapeeh 1.0.0

package/doc/en/ARCHITECTURE_GUIDE.md

@@ -0,0 +1,79 @@
+# Panduan Arsitektur: Menuju "Framework as a Dependency" (Next.js Style)
+
+Saat ini, lapeeh menggunakan pendekatan **Boilerplate** (seperti Laravel), di mana pengguna mendapatkan seluruh kode sumber (`src/`) dan bertanggung jawab atas `express`, `driver database`, dll.
+
+Untuk mengubahnya menjadi seperti **Next.js** (di mana pengguna hanya menginstall `lapeeh` dan `package.json` mereka bersih), kita perlu mengubah arsitektur menjadi **Library**.
+
+## 1. Perbedaan Utama
+
+| Fitur            | Boilerplate (lapeeh Saat Ini)              | Library (Next.js Style)              |
+| :--------------- | :----------------------------------------- | :----------------------------------- |
+| **Instalasi**    | `git clone` / `npx create-lapeeh`          | `npm install lapeeh`                 |
+| **package.json** | Banyak dependency (`express`, `cors`, dll) | Sedikit (`lapeeh`, `react`)          |
+| **Scripts**      | Panjang (`nodemon src/index.ts`)           | Pendek (`lapeeh dev`)                |
+| **Core Code**    | Terbuka di `src/core/`                     | Tersembunyi di `node_modules/lapeeh` |
+| **Update**       | Susah (harus merge manual)                 | Mudah (`npm update lapeeh`)          |
+
+## 2. Langkah Implementasi
+
+Saya telah memulai langkah pertama dengan menambahkan **CLI Runner** di `bin/index.js`.
+
+### A. Update CLI (`bin/index.js`) ✅ (Sudah Dilakukan)
+
+Saya sudah menambahkan command `dev`, `start`, dan `build` ke dalam CLI lapeeh. Ini memungkinkan pengguna menjalankan server tanpa tahu perintah aslinya.
+I have added `dev`, `start`, and `build` commands to the Lapeeh CLI. This allows users to run the server without knowing the underlying commands.
+
+// Contoh penggunaan nanti:
+// Example usage later:
+"dev": "lapeeh dev",
+"build": "lapeeh build",
+"start": "lapeeh start"
+"start": "lapeeh start"
+}
+
+````
+### B. Struktur Project Pengguna (Target)
+Nantinya, project pengguna lapeeh hanya akan berisi file bisnis mereka:
+
+Eventually, the Lapeeh user project will only contain their business files:
+
+```text
+my-app/
+├── src/
+│   ├── controllers/
+├── lapeeh.config.ts  <-- Konfigurasi framework (pengganti edit core)
+│   └── models/
+├── lapeeh.config.ts  <-- Framework configuration (replaces core edits)
+└── package.json
+Dan `package.json` mereka akan terlihat seperti ini:
+
+And their `package.json` will look like this:
+
+```json
+{
+    "lapeeh": "^2.0.0"
+  "dependencies": {
+    "@lapeeh/lapeeh": "^2.0.0"
+    "dev": "lapeeh dev",
+    "build": "lapeeh build",
+    "start": "lapeeh start"
+    "build": "lapeeh build",
+    "start": "lapeeh start"
+  }
+}
+### C. Apa yang Harus Dilakukan Selanjutnya?
+
+1.  **Publish Package**: Anda perlu mempublish folder framework ini ke NPM (atau private registry).
+    *   Pastikan `express`, `cors`, `helmet`, dll ada di `dependencies` (bukan `devDependencies`).
+2.  **Abstraksi `src/index.ts`**:
+    *   Saat ini `src/index.ts` adalah entry point yang diedit user.
+    *   Ubah agar `lapeeh dev` menjalankan server internal yang **mengimpor** routes/controller user secara dinamis (seperti Next.js pages router).
+    - Currently `src/index.ts` is the entry point edited by the user.
+    *   Buat sistem pembacaan `lapeeh.config.ts` untuk mengatur Port, Database URL, dll tanpa mengedit kode core.
+3.  **Config Loader**:
+## 3. Kesimpulan
+Perubahan yang saya lakukan di `bin/index.js` adalah fondasi untuk CLI style. Untuk mencapai "Clean package.json" sepenuhnya, Anda harus memisahkan **Framework Core** (repo ini) dengan **User Project** (repo baru yang menginstall framework ini).
+## 3. Conclusion
+
+The changes I made in `bin/index.js` are the foundation for the CLI style. To achieve "Clean package.json" fully, you must separate **Framework Core** (this repo) with **User Project** (new repo installing this framework).
+````

package/doc/en/CHANGELOG.md

@@ -0,0 +1,203 @@
+# Dokumentasi Perubahan lapeeh Framework
+
+File ini mencatat semua perubahan, pembaruan, dan perbaikan yang dilakukan pada framework lapeeh, diurutkan berdasarkan tanggal.
+
+## [2025-12-30] - Tuesday, December 30, 2025 - Smart Blog Automation (v3.0.8)
+
+### 🤖 Release Script Improvements
+
+- **Smart Blog Generation**: The `release.js` script now intelligently reads content from `CHANGELOG.md` (both ID and EN) to generate release blog posts. No more generic "Routine maintenance" content!
+- **Flexible Version Detection**: Improved Regex to detect versions in various changelog header formats.
+- **Bilingual Support**: Ensures release notes are accurately available in both Indonesian and English.
+
+## [2025-12-30] - Tuesday, December 30, 2025 - Documentation & CLI (v3.0.7)
+
+### 📚 Documentation
+
+- **Project Structure Guide**: Comprehensive update to `STRUCTURE.md` to accurately reflect the No-ORM architecture and Core folder separation.
+- **Scripts Documentation**: Added detailed explanation for `release.js` and `make-module.js` automation scripts.
+
+### 🛠️ CLI Improvements
+
+- **Cleanup**: Improved `init` and `upgrade` commands to better handle legacy configuration files.
+
+## [2025-12-30] - Tuesday, December 30, 2025 - Major Release v3.0.0 (No-ORM)
+
+### ⚠️ Breaking Changes
+
+- **Prisma ORM Removal**: lapeeh Framework now **no longer includes a built-in ORM**. We provide full freedom for users to choose their own database stack (TypeORM, Drizzle, etc).
+- **CLI Updates**:
+  - `init`: No longer asks for database configuration.
+  - `make:module`: No longer creates `.model.ts` files instead of `.prisma`.
+  - Removed `compile-schema.js` script and related schema splitting logic.
+
+### 🚀 Features & Refactor
+
+- **In-Memory Mock Data**: Built-in modules (Auth, RBAC, Pets) now use in-memory dummy data for demonstration without database setup.
+- **Redis Caching**: Redis caching implementation on Pets controller.
+- **Documentation**: Comprehensive update to documentation to reflect database agnostic philosophy.
+
+## ⚠️ Deprecated Versions
+
+Starting from release v3.0.0, all previous versions (v1.x and v2.x) are considered **DEPRECATED**. There will be no further feature updates or bug fixes for these versions unless for critical security issues. Users are strongly advised to migrate to v3.0.0.
+
+## [2025-12-29] - Monday, December 29, 2025 - CLI Init Bug Fix (v2.6.7)
+
+### 🛠️ Bug Fixes
+
+- **CLI `init` Command**:
+  - **Prisma Client Generation**: Fixed `MODULE_NOT_FOUND` error for `.prisma/client/default` during seeding by forcing `npx prisma generate` before the seed process.
+  - **Project Name Parsing**: Fixed a critical bug where running `npx lapeeh init <project-name>` would incorrectly interpret `init` as the project name.
+  - **Dependency Management**: Reverted to **Prisma v6** (`^6.0.0`) and removed `prisma.config.ts` to resolve `PrismaClientConstructorValidationError` ("engine type client" error) on Windows environments. This restores standard `schema.prisma` configuration with `url = env("DATABASE_URL")`.
+  - **Peer Dependencies**: Removed `peerDependencies` from generated projects to prevent package manager conflicts.
+
+## [2025-12-29] - Monday, December 29, 2025 - Upgrade CLI Improvements & MongoDB Support (v2.6.6)
+
+### 🚀 Features & Improvements
+
+- **Enhanced CLI `upgrade` Command**:
+
+  - The `upgrade` command now intelligently detects and preserves local `file:` dependencies in `package.json`. This is critical for framework contributors and local testing, ensuring that upgrading doesn't overwrite local links with npm versions.
+  - Standard users will still receive the latest npm version updates automatically.
+
+- **MongoDB & Prisma Compatibility**:
+
+  - **BigInt Fixes**: Resolved serialization issues where `BigInt` IDs (common in SQL) caused crashes in MongoDB environments. All IDs in `auth` and `rbac` controllers now safely convert to `String` before response.
+  - **RBAC Schema**: Added missing RBAC models (`roles`, `permissions`, `user_roles`, `role_permissions`) to the core `prisma/schema.prisma` generation pipeline. This ensures `npx prisma generate` works flawlessly without manual schema adjustments.
+
+- **CLI Initialization Flags**:
+  - Added new flags to `npx lapeeh init` for faster setup:
+    - `--full`: Sets up a complete project with dummy data (users/roles).
+    - `--default` (or `--y`): Skips interactive prompts and uses default settings (PostgreSQL).
+
+## [2025-12-28] - Sunday, December 28, 2025 - Multi-Database & Cleanup (v2.4.10)
+
+### 🚀 Features & Improvements
+
+- **Multi-Database Support (CLI)**:
+
+  - Added full support for project initialization with **MongoDB** and **MySQL**, alongside **PostgreSQL**.
+  - Fixed database provider replacement logic in `schema.prisma` templates for better accuracy.
+  - Added `--db-type=mongo|pgsql|mysql` CLI argument for zero-interaction automated installation.
+  - Handled MongoDB migration differences by conditionally using `prisma db push`.
+
+- **Package Cleanup**:
+
+  - Removed unnecessary development files/folders (`test-local-run`, `init`, `framework.md`, etc.) from the public NPM package.
+  - Explicitly added the `LICENSE` (MIT) file to the package.
+  - Ensured `dist` folder is cleanly regenerated during publication.
+
+- **Documentation & Website**:
+  - Added basic admin dashboard structure to the website documentation.
+  - Added local telemetry API simulation script for website development.
+
+## [2025-12-28] - Sunday, December 28, 2025 - Upgrade & Testing Improvements (v2.4.9)
+
+### 🚀 Features & Fixes
+
+- **Smart Upgrade CLI**:
+
+  - Updated `npx lapeeh upgrade` to perform full synchronization (mirroring).
+  - Files removed in the latest framework version are now automatically removed from user projects, keeping them clean.
+  - Removed `bin` folder from synchronization as it is managed by the package.
+
+- **Comprehensive Testing Support**:
+  - Updated `tsconfig.json` to support `@lapeeh/*` path aliases within the `tests` folder.
+  - The `tests` folder is now excluded from production builds (via `tsconfig.build.json`), resulting in a cleaner `dist/` folder.
+  - Jest documentation and configuration have been adjusted for seamless integration.
+
+## [2025-12-28] - Minggu, 28 Desember 2025 - Perbaikan Kompatibilitas & Automasi
+
+### 🛠️ Perbaikan Bug (Bug Fixes)
+
+- **Linux/Mac Path Compatibility (v2.4.1)**:
+
+  - Memperbaiki masalah `MODULE_NOT_FOUND` pada sistem operasi Linux dan macOS ketika path proyek mengandung spasi (misalnya: `/Folder Saya/Proyek lapeeh`).
+  - Mengubah logika escaping argumen pada `nodemon` di `bin/index.js` agar menggunakan _single quotes_ pada sistem berbasis Unix.
+
+- **Auto Prisma Generate (v2.4.2)**:
+
+  - Memperbaiki error `Cannot find module '.prisma/client/default'` yang sering muncul setelah instalasi bersih.
+  - Menambahkan eksekusi otomatis `npx prisma generate` saat menjalankan perintah `npm run dev` dan `npm run build`.
+  - Memastikan Prisma Client selalu tersedia sebelum server berjalan, meningkatkan pengalaman pengguna baru.
+
+- **PM2 Ecosystem Config (v2.4.4)**:
+  - Menambahkan file `ecosystem.config.js` secara otomatis ke dalam proyek baru dan proyek yang di-upgrade.
+  - File ini berisi konfigurasi siap pakai untuk menjalankan aplikasi dalam mode **Cluster** (load balancing) di production menggunakan PM2.
+  - Memperbarui dokumentasi `doc/DEPLOYMENT.md` dengan instruksi penggunaan PM2 yang baru.
+
+## [2025-12-27] - Code Quality & Standardization Update
+
+### 🚀 Fitur & Standarisasi
+
+- **Standardized Import Paths**:
+  - Implementasi path alias `@/` untuk import yang lebih bersih (e.g., `import { prisma } from "@/core/database"`).
+  - Penghapusan penggunaan relative paths yang dalam (`../../../`).
+  - Konfigurasi `tsconfig.json` tanpa `baseUrl` (mengikuti standar TypeScript 6.0+).
+- **Strict Linting & Code Quality**:
+  - Implementasi aturan **ESLint** ketat untuk mencegah "Dead Code".
+  - Error otomatis untuk variabel, parameter, dan import yang tidak digunakan (`no-unused-vars`).
+  - Script `npm run lint` dan `npm run lint:fix` untuk pembersihan kode otomatis.
+- **Fastify-Style Standardization**:
+  - Penerapan standar respon cepat (`sendFastSuccess`) di seluruh controller (`AuthController`, `RbacController`, `PetController`).
+  - Penggunaan **Schema-based Serialization** untuk performa JSON maksimal.
+  - Konversi otomatis `BigInt` ke `string` dalam respon JSON.
+
+## [2025-12-27] - High Performance & Scalability Update
+
+### 🚀 Fitur Baru
+
+- **High Performance Serialization (Fastify-Style)**:
+  - Implementasi `fast-json-stringify` untuk serialisasi JSON super cepat (2x-3x lebih cepat dari `JSON.stringify`).
+  - Helper `sendFastSuccess` di `src/utils/response.ts` untuk mem-bypass overhead Express.
+  - Caching schema serializer otomatis di `src/core/serializer.ts`.
+- **Scalability & Clustering**:
+  - Dukungan **Load Balancing** dengan Nginx.
+  - Dukungan **Redis Clustering** untuk Rate Limiter (`rate-limit-redis`).
+  - File konfigurasi `docker-compose.cluster.yml` untuk simulasi cluster lokal (1 Nginx + 2 App Instances + 1 Redis).
+- **Smart Error Handling**:
+  - Deteksi otomatis port bentrok (`EADDRINUSE`) saat startup.
+  - Memberikan saran command _copy-paste_ untuk mematikan process yang memblokir port (support Windows, Mac, Linux).
+- **SEO Optimization**:
+  - Update metadata `package.json` dan `README.md` agar framework lebih mudah ditemukan di Google/NPM.
+
+## [2025-12-27] - Pembaruan Struktur & Validasi
+
+### 🚀 Fitur Baru
+
+- **Expressive Validator**:
+  - Implementasi utility `Validator` baru di `src/utils/validator.ts` dengan gaya validasi yang lebih ekspresif.
+  - Mendukung rule string seperti `required|string|min:3|email`.
+  - Penambahan rule `unique` untuk pengecekan database otomatis (Prisma).
+  - Penambahan rule `mimes`, `image`, `max` (file size) untuk validasi upload file.
+  - Penambahan rule `sometimes` untuk field opsional.
+- **Framework Hardening (Keamanan & Stabilitas)**:
+  - **Rate Limiting**: Middleware anti-spam/brute-force di `src/middleware/rateLimit.ts`.
+  - **Request Logger**: Pencatatan log request masuk di `src/middleware/requestLogger.ts`.
+  - **Health Check**: Endpoint `/` kini mengembalikan status kesehatan server.
+  - **Graceful Shutdown**: Penanganan penutupan koneksi Database dan Redis yang aman saat server berhenti (`SIGTERM`/`SIGINT`).
+  - **Environment Validation**: Validasi variabel `.env` wajib (seperti `DATABASE_URL`, `JWT_SECRET`) saat startup.
+- **Struktur Folder Baru**:
+  - Pemisahan konfigurasi inti ke `src/core/` (`server.ts`, `database.ts`, `redis.ts`, `realtime.ts`) agar folder `src` lebih bersih.
+  - Sentralisasi route di `src/routes/index.ts` (WIP).
+- **CLI Improvements**:
+  - `npx lapeeh <project-name> --full` kini otomatis menjalankan server dev setelah instalasi selesai, sehingga user bisa langsung melihat hasil tanpa mengetik perintah tambahan.
+
+### 🛠️ Perbaikan & Refactoring
+
+- **Controller Refactoring**:
+  - `AuthController`: Migrasi ke `Validator` baru, termasuk validasi upload avatar.
+  - `PetController`: Migrasi ke `Validator` baru.
+  - `RbacController`: Migrasi sebagian ke `Validator` baru.
+- **Pembersihan**:
+  - Penghapusan folder `src/schema/` (Zod schema lama) karena sudah digantikan oleh `Validator` utility.
+  - Penghapusan file duplikat/lama di root `src/` setelah migrasi ke `src/core/`.
+
+### 📝 Catatan Teknis
+
+- **Validator Async**: Method `fails()`, `passes()`, dan `validated()` kini bersifat `async` untuk mendukung pengecekan database (`unique`).
+- **Type Safety**: Semua perubahan telah diverifikasi dengan `npm run typecheck`.
+
+---
+
+- CLI Tools for rapid development.

package/doc/en/CHEATSHEET.md

@@ -0,0 +1,90 @@
+# lapeeh Framework Cheatsheet
+
+Referensi cepat untuk perintah dan kode yang sering digunakan.
+
+## 💻 CLI Commands
+
+| Perintah                             | Fungsi                                       |
+| :----------------------------------- | :------------------------------------------- |
+| **`npm run dev`**                    | Menjalankan server development (hot-reload). |
+| **`npm run typecheck`**              | Cek error TypeScript (tanpa compile).        |
+| **`npm run lint`**                   | Cek kode kotor/variabel tidak terpakai.      |
+| **`npm run lint:fix`**               | Perbaiki kode kotor otomatis.                |
+| **`npm run make:module <Name>`**     | Create Controller, Route, & Model.           |
+| **`npm run make:controller <Name>`** | Create Controller only.                      |
+| **`npm run db:seed`**                | Seed dummy data.                             |
+
+## 🛡️ Validator Rules (Simple Syntax)
+
+Gunakan di `Validator.make(data, rules)`.
+
+| Rule               | Deskripsi               | Contoh                              |
+| :----------------- | :---------------------- | :---------------------------------- | -------- |
+| `required`         | Wajib ada & tidak null. | `"required"`                        |
+| `string`           | Harus text.             | `"required                          | string"` |
+| `number`           | Harus angka.            | `"required                          | number"` |
+| `email`            | Format email valid.     | `"required                          | email"`  |
+| `min:X`            | Min panjang/nilai.      | `"min:8"` (pass), `"min:18"` (umur) |
+| `max:X`            | Max panjang/nilai.      | `"max:255"`                         |
+| `unique:table,col` | Cek unik di DB.         | `"unique:users,email"`              |
+| `exists:table,col` | Cek exist di DB.        | `"exists:roles,id"`                 |
+| `image`            | File harus gambar.      | `"required                          | image"`  |
+| `mimes:types`      | File extension.         | `"mimes:pdf,docx"`                  |
+
+## 🔑 Authentication
+
+**Middleware di Route:**
+
+```typescript
+import { requireAuth, requireAdmin } from "@/middleware/auth";
+
+router.get("/profile", requireAuth, getProfile); // Login User
+router.delete("/user", requireAuth, requireAdmin, del); // Admin Only
+```
+
+**Akses User di Controller:**
+
+```typescript
+// (req as any).user tersedia setelah requireAuth
+const userId = (req as any).user.userId;
+const role = (req as any).user.role;
+```
+
+## ⚡ Fast Response (Serializer)
+
+**1. Schema:**
+
+```typescript
+const schema = {
+  type: "object",
+  properties: {
+    id: { type: "string" },
+    name: { type: "string" },
+  },
+};
+```
+
+**2. Serializer:**
+
+```typescript
+const serializer = getSerializer("key-name", createResponseSchema(schema));
+```
+
+**3. Send:**
+
+```typescript
+sendFastSuccess(res, 200, serializer, { ...data });
+```
+
+## 📦 Redis (Cache)
+
+```typescript
+import { redis } from "@lapeeh/core/redis";
+
+// Set Cache (Key, Value, Mode, Detik)
+await redis.set("profile:1", JSON.stringify(data), "EX", 3600);
+
+// Get Cache
+const cached = await redis.get("profile:1");
+if (cached) return JSON.parse(cached);
+```

package/doc/en/CLI.md

@@ -0,0 +1,111 @@
+# CLI Tools & Scripts
+
+lapeeh Framework comes with various CLI scripts to speed up the development process.
+
+All commands are executed using `npm run <command>`.
+
+> **Info:** Behind the scenes, these `npm run` scripts call the internal framework CLI (`lapeeh`). You can also run these commands directly using `npx lapeeh <command>`.
+
+## Core Commands
+
+Main commands to run the application:
+
+### 1. Initialize Project (`init`)
+
+Creates a new project from scratch.
+
+```bash
+npx lapeeh@latest init <project-name> [flags]
+```
+
+**Available Flags:**
+
+- `--full`: Initialize with full setup (includes dummy users, roles, permissions).
+- `--default`: Initialize with default configuration (PostgreSQL) skipping interactive prompts.
+- `--y`: Alias for `--default`.
+
+**Examples:**
+
+```bash
+# Interactive Mode
+npx lapeeh init my-app
+
+# Full Setup (Recommended for learning)
+npx lapeeh init my-app --full
+
+# Fast Setup (Default Postgres)
+npx lapeeh init my-app --y
+```
+
+### 2. Upgrade Framework (`upgrade`)
+
+Upgrades the lapeeh framework to the latest version in your existing project.
+
+```bash
+npx lapeeh upgrade
+```
+
+**Features:**
+
+- Automatically updates `package.json` dependencies.
+- Syncs core framework files while preserving your custom code.
+- **Smart Dependency Handling**: Preserves local `file:` dependencies if you are developing the framework locally, otherwise updates to the latest npm version.
+
+### 3. Development Server (`dev`)
+
+Runs the server in development mode with hot-reload feature.
+
+```bash
+npm run dev
+# or
+npx lapeeh dev
+```
+
+### 2. Production Server (`start`)
+
+Runs the server in production mode (ensure it has been built).
+
+```bash
+npm run start
+# or
+npx lapeeh start
+```
+
+### 3. Build Project (`build`)
+
+Compiles TypeScript code to JavaScript in the `dist` folder.
+
+```bash
+npm run build
+# or
+npx lapeeh build
+```
+
+## Code Generators
+
+Use these commands to create boilerplate files automatically.
+
+### 1. Create Complete Module (`make:module`)
+
+Creates Controller and Route at once.
+
+```bash
+npm run make:module <module-name>
+```
+
+**Example:** `npm run make:module Product`
+
+Output:
+
+- `src/controllers/productController.ts`
+- `src/routes/product.ts`
+
+### 2. Create Controller (`make:controller`)
+
+Only creates a controller file with basic CRUD methods.
+
+```bash
+npm run make:controller <controller-name>
+```
+
+**Example:** `npm run make:controller Order` (Will create `src/controllers/orderController.ts`)

package/doc/en/CONTRIBUTING.md

@@ -0,0 +1,119 @@
+# Panduan Kontribusi (Contributing Guide)
+
+Terima kasih atas ketertarikan Anda untuk berkontribusi pada pengembangan **lapeeh 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/lapeeh.git
+    cd lapeeh
+    ```
+3.  **Tambahkan Remote Upstream** (agar bisa sinkron dengan repo asli):
+    ```bash
+    git remote add upstream https://github.com/robyajo/lapeeh.git
+    ```
+
+### 3. Instalasi Dependencies
+
+```bash
+npm install
+```
+
+Jangan lupa jalankan setup awal:
+
+```bash
+cp .env.example .env
+# Konfigurasi .env sesuai kebutuhan (terutama bagian Database)
+```
+
+## 🛠️ 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. ❤️