Ngopidulur

Transport Project Doc

Ngopidulur — Tue, 26 May 2026 11:44:00 GMT

Dokumentasi Project — Sankyu Transport Management System

Dokumentasi lengkap untuk developer: tech stack, arsitektur, development, deployment, troubleshooting, dan coding conventions.

Daftar Isi

1. Tech Stack
2. Architecture
3. Development Setup
4. Database & Migrations
5. API Reference
6. Deployment
7. Troubleshooting
8. Coding Conventions

1. Tech Stack

Backend — `node_backend/`

Kategori	Teknologi	Versi
Runtime	Node.js	—
Framework	Express.js	^4.18
Bahasa	JavaScript (CommonJS)	—
Database Utama	MySQL	via `mysql2` ^3.9
Database Sekunder	MongoDB	via `mongoose` ^9.1 (legacy)
Autentikasi	JWT	`jsonwebtoken` ^9.0
Upload File	Multer	^2.0
Excel Import/Export	`xlsx` ^0.18, `exceljs` ^4.4	—
Migrasi DB	dbmate	^2.32 (dev)
GPS Integration	Wialon API	—
Reverse Geocoding	Geoapify API	—

Dependency Utama Backend

{
  "cors": "^2.8.5",
  "dotenv": "^16.4.5",
  "exceljs": "^4.4.0",
  "express": "^4.18.2",
  "jsonwebtoken": "^9.0.2",
  "mongoose": "^9.1.4",
  "multer": "^2.0.2",
  "mysql2": "^3.9.7",
  "xlsx": "^0.18.5"
}

Frontend — `tailadmin-vuejs-1.0.0/`

Kategori	Teknologi	Versi
Framework	Vue 3	^3.5
Bahasa	TypeScript	~5.7
Build Tool	Vite	^6.0
CSS Framework	Tailwind CSS	^4.0
UI Template	TailAdmin Vue Pro	2.0.1
Router	Vue Router	^4.5
Maps	Leaflet + MarkerCluster	^1.9
Icons	Lucide Vue Next, Heroicons	—
Charts	ApexCharts (vue3-apexcharts)	^1.8
Date Picker	Vue Datepicker, Flatpickr	—
Linting	ESLint + Prettier	—
Type Check	vue-tsc	^2.2

Dependency Utama Frontend

{
  "vue": "^3.5.13",
  "vue-router": "^4.5.0",
  "leaflet": "^1.9.4",
  "leaflet.markercluster": "^1.5.3",
  "tailwindcss": "^4.0.0",
  "apexcharts": "^4.4.0",
  "lucide-vue-next": "^0.474.0"
}

Documentation — `docs/`

Kategori	Teknologi
Static Site Generator	VitePress ^1.0
Port Development	5174

External Services

Service	Fungsi	Catatan
Wialon	GPS tracking, geofence, trip history	Token di backend `.env`
Geoapify	Reverse geocoding (koordinat → alamat)	API key di backend `.env`
MySQL	Database utama (data operasional)	Local atau remote
MongoDB	Database sekunder (fitur legacy)	Opsional

Ports Default

Service	Port
Backend (Express)	3000
Frontend (Vite dev)	5173
Docs (VitePress)	5174
MySQL	3306

2. Architecture

Gambaran Umum

Sistem ini menggunakan arsitektur monorepo dengan dua aplikasi utama:

┌─────────────────────┐     HTTP/JSON      ┌──────────────────────┐
│   Vue 3 Frontend    │ ◄────────────────► │   Express Backend    │
│  (SPA + Vite)       │     /api/*          │   (Node.js)          │
└─────────────────────┘                     └──────────┬───────────┘
                                                       │
                                            ┌──────────┼───────────┐
                                            │          │           │
                                       ┌────▼───┐ ┌───▼────┐ ┌───▼────────┐
                                       │ MySQL  │ │MongoDB │ │ Wialon API │
                                       │(utama) │ │(legacy)│ │ (GPS)      │
                                       └────────┘ └────────┘ └────────────┘

Backend Architecture

Layer Pattern

Backend mengikuti pola Route → Service → Database:

Request
  │
  ▼
middleware/auth.js        ← JWT verification
middleware/rbac.js        ← Role-based access control
  │
  ▼
routes/<domain>.js        ← HTTP handling, validation, response
  │
  ▼
services/<domain>.js      ← Business logic, external API calls
  │
  ▼
db.js (MySQL pool)        ← Direct SQL queries via mysql2/promise
models/<model>.js         ← Mongoose models (MongoDB, legacy)

Route Registration

Semua route didaftarkan di server.js dengan prefix /api/:

app.use("/api/trucks", truckRouter);
app.use("/api/sales-costs", salesCostRouter);
app.use("/api/wialon", wialonRouter);
// ...

Authentication Flow

User login via POST /api/auth/login
Backend memverifikasi kredensial dan mengembalikan JWT token
Frontend menyimpan token dan mengirimnya di header Authorization: Bearer <token>
Middleware authenticateToken memverifikasi token di setiap request
Middleware restrictCsAccess membatasi akses role CS ke route tertentu

Role-Based Access Control

Role	Akses
`admin`	Semua endpoint
`cs`	Hanya `GET /schedule-pengiriman`, `GET /auth/me`, `PUT /auth/me`

Database Connection

MySQL menggunakan connection pool (mysql2/promise):

const pool = mysql.createPool({
  host: process.env.DB_HOST,
  user: process.env.DB_USER,
  password: process.env.DB_PASS,
  database: process.env.DB_NAME || "trucking",
  connectionLimit: 10
});

Query dilakukan langsung tanpa ORM:

const [rows] = await pool.query("SELECT * FROM truck WHERE is_active = 1");

External Integration: Wialon

Backend                          Wialon API
  │                                  │
  ├── Login (token) ────────────────►│
  │◄──── Session ID ────────────────┤
  │                                  │
  ├── search_items (units) ─────────►│
  │◄──── Unit positions ────────────┤
  │                                  │
  ├── get_zones_by_unit ────────────►│
  │◄──── Geofence membership ──────┤
  │                                  │
  ├── unit/get_trips ───────────────►│
  │◄──── Trip history ─────────────┤

Session di-reuse selama TTL belum habis
Semua komunikasi Wialon hanya dari backend (token tidak pernah ke frontend)
Response Wialon bisa nested — selalu gunakan normalizer

Geofence Tracking (Background Service)

geofenceTrackingService.js
  │
  ├── Load active Sales Cost candidates
  ├── Load route-step → geofence mappings
  ├── Poll Wialon zone membership (interval)
  │
  └── If truck in mapped zone & not yet recorded:
      └── INSERT into sales_cost_route_history

Berjalan otomatis saat server start
Interval dikonfigurasi via GEOFENCE_TRACKING_INTERVAL_MS
Hanya mencatat first-entry per step (no duplicates)

Frontend Architecture

Component Hierarchy

App.vue
  └── Router View
       ├── views/Master/*        ← CRUD pages
       ├── views/Transaksi/*     ← Transaction pages
       ├── views/Monitoring/*    ← GPS & mileage
       ├── views/DataTransport/* ← Reports
       └── views/Auth/*          ← Login

API Communication

Frontend berkomunikasi dengan backend melalui:

Development: Vite proxy (/api → http://127.0.0.1:3000)
Production: Direct ke VITE_API_URL (e.g., https://sankyu-transport.fun)

// src/config/api.js
export const API_ORIGIN = import.meta.env.VITE_API_URL || window.location.origin
export const API_BASE = `${API_ORIGIN}/api`

State Management

Tidak menggunakan Vuex/Pinia global store
State dikelola per-component atau via composables
Data dari API di-fetch langsung di views menggunakan service wrappers

Map Architecture (Monitoring)

TruckLocationMap.vue
  ├── Left Panel: Leaflet Map (markers, clusters)
  ├── Middle Panel: Vehicle Detail (shown on selection)
  └── Right Panel: Fleet List (scrollable, searchable)

Auto-refresh setiap 30 detik
Reverse geocode hanya untuk truck yang dipilih (bukan semua)
Cache di localStorage dengan TTL 24 jam

Data Flow Patterns

Soft Delete Pattern

Trucks dan drivers menggunakan is_active flag:

Active (is_active = 1):
  ✓ Muncul di dropdown operasional
  ✓ Muncul di GPS/map views
  ✓ Bisa digunakan untuk transaksi baru

Inactive (is_active = 0):
  ✓ Tetap muncul di Master Data (admin)
  ✓ Tetap muncul di historical records
  ✗ Tidak muncul di dropdown operasional
  ✗ Tidak muncul di GPS/map views
  ✗ Tidak bisa digunakan untuk transaksi baru

Date Handling

⚠️ Penting: MySQL DATE values harus diperlakukan sebagai local date.

Jangan gunakan:

new Date('YYYY-MM-DD') (akan di-parse sebagai UTC)
toISOString().slice(0, 10) (bisa bergeser 1 hari)

Gunakan:

// Backend: preserve local calendar parts
const [year, month, day] = dateString.split('-');

// Frontend: parse to local Date
new Date(year, month - 1, day);

File Upload Pattern

Frontend (multipart/form-data)
  │
  ▼
multer middleware (disk storage)
  │
  ▼
node_backend/upload/<category>/

Kategori upload: doc-data-truck, doc-data-chasis, doc-supir

3. Development Setup

Prerequisites

Software	Versi Minimum	Catatan
Node.js	18+	LTS recommended
npm	9+	Bundled with Node.js
MySQL	8.0+	Atau MariaDB 10.6+
Git	2.30+	—
MongoDB	6.0+	Opsional (fitur legacy)

Langkah 1: Clone Repository

git clone <repo-url> transport_v1.04
cd transport_v1.04

Langkah 2: Setup Backend

Install Dependencies

cd node_backend
npm install

Konfigurasi Environment

Copy-Item .env.example .env

Edit node_backend/.env dan isi nilai yang sesuai:

# Database MySQL
DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASS=your_password
DB_NAME=trucking

# Authentication
JWT_SECRET=your_random_secret_string

# Server
PORT=3000

# Wialon GPS (minta ke admin)
WIALON_BASE_URL=https://hst-api.wialon.com/wialon/ajax.html
WIALON_TOKEN=your_wialon_token
WIALON_LOGIN_FLAGS=13
WIALON_SESSION_TTL_MS=2700000
WIALON_TIMEOUT_MS=20000

# Geoapify Reverse Geocoding
GEOAPIFY_API_KEY=your_geoapify_api_key
GEOAPIFY_BASE_URL=https://api.geoapify.com/v1/geocode/reverse
GEOAPIFY_TIMEOUT_MS=6000

# Cache TTL
REVERSE_GEOCODE_CACHE_TTL_MS=86400000
WIALON_MONTHLY_DISTANCE_CACHE_TTL_MS=600000

# Geofence Tracking
GEOFENCE_TRACKING_INTERVAL_MS=60000
DEFAULT_FINISH_GEOFENCE_NAME=Sankyu

💡 Tip: Untuk development lokal tanpa GPS, cukup isi DB_*, JWT_SECRET, dan PORT. Fitur Wialon dan Geoapify akan gagal gracefully tanpa crash.

Setup Database

Perangkat Baru (Database Kosong):

npm run migrate

Perintah ini akan:

Membuat database trucking jika belum ada
Menjalankan semua migration files di db/migrations/

Database Existing (Sudah Ada Data):

npm run migrate:adopt-existing

Perintah ini akan:

Melengkapi schema yang kurang (tabel tracking baru)
Menandai semua migration sebagai sudah diterapkan
Tidak menghapus data yang sudah ada

Jalankan Backend

npm start

Backend akan berjalan di http://localhost:3000.

Langkah 3: Setup Frontend

Install Dependencies

cd tailadmin-vuejs-1.0.0
npm install

Jalankan Frontend

npm run dev

Frontend akan berjalan di http://localhost:5173.

ℹ️ Info: Vite dev server otomatis mem-proxy request /api/* ke backend di port 3000. Pastikan backend sudah berjalan sebelum mengakses frontend.

Langkah 4: Setup Documentation (Opsional)

cd docs
npm install
npm run dev

Docs akan berjalan di http://localhost:5174.

Verifikasi Setup

Checklist untuk memastikan setup berhasil:

Backend berjalan tanpa error di terminal
http://localhost:3000/api/auth/login merespons (POST)
Frontend bisa diakses di http://localhost:5173
Login berhasil dengan kredensial yang valid
Dashboard menampilkan data

Development Workflow

Buka 2 terminal terpisah:

Terminal 1 — Backend:

cd node_backend
npm start

Terminal 2 — Frontend:

cd tailadmin-vuejs-1.0.0
npm run dev

Hot Reload

Frontend: Vite HMR otomatis reload saat file berubah
Backend: Tidak ada hot reload bawaan. Restart manual dengan Ctrl+C lalu npm start

💡 Tip: Untuk auto-restart backend, install nodemon:
npm install -g nodemon
nodemon server.js

Akses dari Device Lain di LAN

Frontend Vite sudah dikonfigurasi listen di 0.0.0.0:5173. Akses dari device lain:

http://<IP-HOST>:5173

Build Check (Frontend)

Sebelum commit, pastikan build tidak error:

cd tailadmin-vuejs-1.0.0
npm run build-only

Linting & Formatting

cd tailadmin-vuejs-1.0.0
npm run lint       # ESLint auto-fix
npm run format     # Prettier format

4. Database & Migrations

Overview

Sistem menggunakan MySQL sebagai database utama dan MongoDB untuk fitur legacy. Schema MySQL dikelola menggunakan dbmate yang dibungkus dalam custom Node.js scripts.

Struktur File

node_backend/
├── db.js                  # MySQL connection pool
├── db/
│   ├── migrations/        # SQL migration files (timestamp-ordered)
│   │   ├── 20260401010000_baseline_from_trucking_dump.sql
│   │   ├── 20260401011000_add_tracking_foreign_keys.sql
│   │   ├── 20260401012000_add_area_finish_geofence.sql
│   │   ├── 20260424010000_add_truck_is_active.sql
│   │   └── 20260424011000_add_driver_is_active.sql
│   ├── schema.sql         # Generated schema snapshot
│   └── README.md          # Migration CLI documentation
├── scripts/
│   ├── run-dbmate.js      # dbmate wrapper
│   ├── build-baseline-migration.js
│   ├── adopt-existing-migrations.js
│   └── dump-schema.js
└── models/                # Mongoose models (MongoDB legacy)

Migration Commands

Command	Fungsi
`npm run migrate`	Jalankan semua pending migrations
`npm run migrate:down`	Rollback migration terakhir
`npm run migrate:status`	Lihat status migration
`npm run migrate:new -- <name>`	Buat file migration baru
`npm run migrate:dump`	Generate `db/schema.sql` dari database aktif
`npm run migrate:adopt-existing`	Tandai migrations sebagai applied (DB existing)
`npm run migrate:baseline:build`	Build baseline migration dari SQL dump

Workflow: Membuat Perubahan Schema Baru

Buat file migration:

cd node_backend
npm run migrate:new -- add_column_xyz

Edit file yang dihasilkan di db/migrations/:

-- migrate:up
ALTER TABLE truck ADD COLUMN xyz VARCHAR(100) NULL;

-- migrate:down
ALTER TABLE truck DROP COLUMN xyz;

Jalankan migration:
```
npm run migrate
```
(Opsional) Update schema snapshot:
```
npm run migrate:dump
```
Commit file migration ke git

Naming Convention Migration

Format: YYYYMMDDHHMMSS_deskripsi_singkat.sql

Contoh:

20260401010000_baseline_from_trucking_dump.sql
20260424010000_add_truck_is_active.sql

Tabel Utama

`truck`

Kolom	Tipe	Catatan
`id`	INT AUTO_INCREMENT	Primary key
`no_polisi`	VARCHAR	Nomor plat
`jenis_kendaraan`	VARCHAR	Tipe kendaraan
`wialon_unit_id`	VARCHAR(64) NULL	Mapping ke Wialon unit
`is_active`	TINYINT(1) DEFAULT 1	Soft delete flag

`driver`

Kolom	Tipe	Catatan
`id`	INT AUTO_INCREMENT	Primary key
`nama_supir`	VARCHAR	Nama driver
`is_active`	TINYINT(1) DEFAULT 1	Soft delete flag

`sales_cost`

Tabel transaksi utama yang menghubungkan truck, driver, customer, area, dan data biaya.

`area`

Kolom	Tipe	Catatan
`id`	INT AUTO_INCREMENT	Primary key
`kode_area`	VARCHAR	Kode area
`nama_area`	VARCHAR	Generated dari route steps
`finish_geofence_resource_id`	VARCHAR NULL	Wialon resource ID
`finish_geofence_zone_id`	VARCHAR NULL	Wialon zone ID
`finish_geofence_zone_name`	VARCHAR NULL	Nama geofence finish

`area_route_step`

Menyimpan urutan langkah route per area dengan mapping ke Wialon geofence.

`sales_cost_route_history`

Menyimpan riwayat kunjungan geofence aktual per Sales Cost delivery.

`schema_migrations`

Tabel internal dbmate untuk tracking migration yang sudah diterapkan.

Connection Pool

// db.js
const pool = mysql.createPool({
  host: process.env.DB_HOST,
  user: process.env.DB_USER,
  password: process.env.DB_PASS,
  database: process.env.DB_NAME || "trucking",
  waitForConnections: true,
  connectionLimit: 10,
  queueLimit: 0
});

Penggunaan di Route/Service

const pool = require("../db");

// Query biasa
const [rows] = await pool.query("SELECT * FROM truck WHERE is_active = 1");

// Query dengan parameter (prepared statement)
const [rows] = await pool.query("SELECT * FROM truck WHERE id = ?", [truckId]);

// Insert
const [result] = await pool.query(
  "INSERT INTO truck (no_polisi, jenis_kendaraan) VALUES (?, ?)",
  [noPolisi, jenisKendaraan]
);

⚠️ Keamanan: Selalu gunakan parameterized queries (? placeholder). Jangan pernah string concatenation untuk values.

MongoDB (Legacy)

MongoDB digunakan untuk beberapa fitur lama. Model didefinisikan di node_backend/models/.

Koneksi MongoDB opsional — jika MONGO_URI tidak diset di .env, server tetap berjalan tanpa MongoDB.

Backup & Restore

# Export schema
npm run migrate:dump

# Full backup
mysqldump -u root -p trucking > backup_trucking.sql

# Restore
mysql -u root -p trucking < backup_trucking.sql
npm run migrate:adopt-existing

Tips Database

Selalu buat migration untuk perubahan schema — jangan edit database langsung
Commit migration files ke git agar semua developer sinkron
Jangan edit migration yang sudah di-apply — buat migration baru untuk koreksi
Test migration down sebelum push untuk memastikan rollback berfungsi
Gunakan is_active flag untuk soft delete, bukan DELETE FROM
Date handling: Simpan sebagai DATE type, parse sebagai local date (bukan UTC)

5. API Reference

Semua endpoint menggunakan prefix /api/ dan berkomunikasi via JSON. Autentikasi menggunakan JWT Bearer token di header Authorization.

Authentication

Login

POST /api/auth/login
Content-Type: application/json

{
  "username": "admin",
  "password": "password123"
}

Response:

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": { "id": 1, "username": "admin", "level": "admin" }
}

Get Current User

GET /api/auth/me
Authorization: Bearer <token>

Update Profile

PUT /api/auth/me
Authorization: Bearer <token>

Master Data

Trucks

Method	Endpoint	Deskripsi
GET	`/api/trucks`	List trucks (default: active only)
GET	`/api/trucks?include_inactive=1`	List semua trucks
GET	`/api/trucks?status=active`	Filter active
GET	`/api/trucks?status=inactive`	Filter inactive
POST	`/api/trucks`	Create truck
PUT	`/api/trucks/:id`	Update truck
PATCH	`/api/trucks/:id/status`	Toggle active/inactive
DELETE	`/api/trucks/:id`	Hard delete truck

Drivers

Method	Endpoint	Deskripsi
GET	`/api/drivers`	List drivers (default: active only)
GET	`/api/drivers?include_inactive=1`	List semua drivers
POST	`/api/drivers`	Create driver
PUT	`/api/drivers/:id`	Update driver
PATCH	`/api/drivers/:id/status`	Toggle active/inactive
DELETE	`/api/drivers/:id`	Hard delete driver

Customers

Method	Endpoint	Deskripsi
GET	`/api/customers`	List customers
POST	`/api/customers`	Create customer
PUT	`/api/customers/:id`	Update customer
DELETE	`/api/customers/:id`	Delete customer

Areas

Method	Endpoint	Deskripsi
GET	`/api/areas`	List areas (includes route_steps)
GET	`/api/areas/:id`	Get area detail + route config
POST	`/api/areas`	Create area (with kode_area, route_steps)
PUT	`/api/areas/:id`	Update area + regenerate nama_area
DELETE	`/api/areas/:id`	Delete area

Warehouses

Method	Endpoint	Deskripsi
GET	`/api/warehouses`	List warehouses
POST	`/api/warehouses`	Create warehouse
PUT	`/api/warehouses/:id`	Update warehouse
DELETE	`/api/warehouses/:id`	Delete warehouse

Subcontractors

Method	Endpoint	Deskripsi
GET	`/api/subconts`	List subcontractors
POST	`/api/subconts`	Create subcontractor
PUT	`/api/subconts/:id`	Update subcontractor
DELETE	`/api/subconts/:id`	Delete subcontractor

Admins

Method	Endpoint	Deskripsi
GET	`/api/admins`	List admin users
POST	`/api/admins`	Create admin
PUT	`/api/admins/:id`	Update admin
DELETE	`/api/admins/:id`	Delete admin

Transactions

Sales Cost

Method	Endpoint	Deskripsi
GET	`/api/sales-costs`	List sales costs
GET	`/api/sales-costs/:id`	Detail (includes route_steps, route_history)
GET	`/api/sales-costs/:id/print`	Print single SPK
POST	`/api/sales-costs`	Create sales cost
PUT	`/api/sales-costs/:id`	Update sales cost
DELETE	`/api/sales-costs/:id`	Delete sales cost

ℹ️ Info: Sales Cost reject inactive trucks/drivers untuk create dan import. Edit existing record memperbolehkan keep current inactive truck/driver, tapi reject ganti ke inactive lain.

Repairs

Method	Endpoint	Deskripsi
GET	`/api/repairs`	List repairs
POST	`/api/repairs`	Create repair
PUT	`/api/repairs/:id`	Update repair
DELETE	`/api/repairs/:id`	Delete repair

Subcontractor Transactions

Method	Endpoint	Deskripsi
GET	`/api/subcontractor`	List subcontractor transactions
POST	`/api/subcontractor`	Create transaction
PUT	`/api/subcontractor/:id`	Update transaction
DELETE	`/api/subcontractor/:id`	Delete transaction

GPS & Monitoring (Wialon)

Truck Locations

GET /api/wialon/trucks/location
Authorization: Bearer <token>

Response per truck:

{
  "id": 1,
  "no_polisi": "B 1234 XYZ",
  "lat": -6.123456,
  "lon": 106.789012,
  "speed": 45,
  "gps_status": "moving",
  "driver_name": "Budi",
  "operational_status": "transaksi",
  "transaksi": {},
  "repair": null,
  "last_transaction": {}
}

⚠️ Catatan: Hanya mengembalikan trucks dengan is_active = 1.

Reverse Geocoding

GET /api/wialon/reverse-geocode?lat=-6.123&lon=106.789
Authorization: Bearer <token>

Hanya request untuk 1 truck yang dipilih (bukan semua)
Cached 24 jam di backend dan frontend localStorage

Monthly Mileage

GET /api/wialon/trucks/monthly-distance?month=2026-01
Authorization: Bearer <token>

Monthly Mileage Export

GET /api/wialon/trucks/monthly-distance/export?month=2026-01
Authorization: Bearer <token>

Returns: .xlsx file

Auto-Map Trucks to Wialon

POST /api/wialon/trucks/auto-map
Authorization: Bearer <token>

Geofence List

GET /api/wialon/geofences
Authorization: Bearer <token>

Other Endpoints

Method	Endpoint	Deskripsi
GET	`/api/dashboard`	Dashboard summary data
GET	`/api/data-trucks`	Data truck reports
GET	`/api/data-chasis`	Data chasis reports
GET	`/api/data-supir`	Data driver reports
GET	`/api/monitoring-kendaraan`	Vehicle monitoring summary
POST	`/api/master/import`	Import master data dari Excel
GET	`/api/master/template`	Download import template
GET	`/api/notifications`	List notifications
GET	`/api/schedule-pengiriman`	Schedule pengiriman (accessible by CS)
GET	`/api/address-book`	Address book

Error Responses

Semua error mengikuti format:

{
  "message": "Deskripsi error dalam Bahasa Indonesia"
}

Status Code	Arti
400	Bad Request — validasi gagal
401	Unauthorized — token tidak valid/expired
403	Forbidden — role tidak punya akses
404	Not Found — resource tidak ditemukan
500	Internal Server Error — error di server

Authentication Header

Semua endpoint (kecuali /api/auth/login) memerlukan:

Authorization: Bearer <jwt_token>

6. Deployment

Arsitektur Production

Internet
  │
  ▼
[Reverse Proxy / Domain]
  │
  ├── https://sankyu-transport.fun (Frontend)
  │     └── Static files (Vite build output)
  │
  └── https://sankyu-transport.fun/api/* (Backend)
        └── Node.js Express (port 3000)

Prerequisites Production

Software	Versi
Node.js	18+ LTS
MySQL	8.0+
npm	9+
Git	2.30+

Opsional:

MongoDB 6.0+ (jika fitur legacy digunakan)
PM2 atau systemd (process manager)
Nginx atau Caddy (reverse proxy)

Deploy Backend

1. Clone & Install

git clone <repo-url> /opt/transport
cd /opt/transport/node_backend
npm install --production

2. Konfigurasi Environment

Buat file .env dengan nilai production:

DB_HOST=localhost
DB_PORT=3306
DB_USER=transport_user
DB_PASS=<strong_password>
DB_NAME=trucking

JWT_SECRET=<random_64_char_string>
PORT=3000

WIALON_BASE_URL=https://hst-api.wialon.com/wialon/ajax.html
WIALON_TOKEN=<production_wialon_token>
WIALON_LOGIN_FLAGS=13
WIALON_SESSION_TTL_MS=2700000
WIALON_TIMEOUT_MS=20000

GEOAPIFY_API_KEY=<production_api_key>
GEOAPIFY_BASE_URL=https://api.geoapify.com/v1/geocode/reverse
GEOAPIFY_TIMEOUT_MS=6000

REVERSE_GEOCODE_CACHE_TTL_MS=86400000
WIALON_MONTHLY_DISTANCE_CACHE_TTL_MS=600000
GEOFENCE_TRACKING_INTERVAL_MS=60000
DEFAULT_FINISH_GEOFENCE_NAME=Sankyu

🔒 Keamanan:

Gunakan password MySQL yang kuat dan user dedicated (bukan root)

Generate JWT_SECRET yang random dan panjang

Jangan commit .env ke git

Batasi akses file .env hanya untuk user yang menjalankan service

3. Setup Database

npm run migrate

4. Jalankan dengan Process Manager

Menggunakan PM2:

npm install -g pm2

# Start
pm2 start server.js --name transport-backend

# Auto-start on reboot
pm2 startup
pm2 save

# Monitor
pm2 status
pm2 logs transport-backend

Menggunakan systemd:

# /etc/systemd/system/transport-backend.service
[Unit]
Description=Transport Backend API
After=network.target mysql.service

[Service]
Type=simple
User=transport
WorkingDirectory=/opt/transport/node_backend
ExecStart=/usr/bin/node server.js
Restart=on-failure
RestartSec=10
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target

sudo systemctl enable transport-backend
sudo systemctl start transport-backend

Deploy Frontend

1. Build

cd /opt/transport/tailadmin-vuejs-1.0.0
npm install
npm run build-only

Output build ada di folder dist/.

ℹ️ Info: npm run build-only skip type-check untuk build lebih cepat. Gunakan npm run build jika ingin type-check sekaligus.

2. Konfigurasi API URL

Pastikan .env.production mengarah ke URL backend yang benar:

VITE_API_URL=https://sankyu-transport.fun

3. Nginx Configuration

server {
    listen 80;
    server_name sankyu-transport.fun;

    # Frontend static files
    root /opt/transport/tailadmin-vuejs-1.0.0/dist;
    index index.html;

    # SPA fallback
    location / {
        try_files $uri $uri/ /index.html;
    }

    # Proxy API ke backend
    location /api/ {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_cache_bypass $http_upgrade;
    }

    # Proxy static uploads
    location /img/ {
        proxy_pass http://127.0.0.1:3000;
    }
    location /doc-data-truck/ {
        proxy_pass http://127.0.0.1:3000;
    }
    location /doc-data-chasis/ {
        proxy_pass http://127.0.0.1:3000;
    }
    location /doc-supir/ {
        proxy_pass http://127.0.0.1:3000;
    }
}

Alternatif: Development Server sebagai Production

Untuk deployment sederhana (internal network):

# Backend
cd node_backend && npm start

# Frontend
cd tailadmin-vuejs-1.0.0 && npm run dev -- --host 0.0.0.0

⚠️ Peringatan: Cara ini tidak direkomendasikan untuk production publik.

Update / Redeploy

# Pull changes
cd /opt/transport
git pull origin main

# Update backend
cd node_backend
npm install
npm run migrate
pm2 restart transport-backend

# Update frontend
cd ../tailadmin-vuejs-1.0.0
npm install
npm run build-only

SSL/HTTPS

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d sankyu-transport.fun

Monitoring Production

# Logs (PM2)
pm2 logs transport-backend

# Logs (systemd)
journalctl -u transport-backend -f

# Health check
curl http://localhost:3000/api/auth/me
# Expect: 401 = server berjalan

Database Backup (Cron)

# /etc/cron.d/transport-backup
0 2 * * * transport mysqldump -u transport_user -p'password' trucking > /backup/trucking_$(date +\%Y\%m\%d).sql

Checklist Deployment

.env production sudah dikonfigurasi dengan benar
Database migration sudah dijalankan
Frontend build berhasil tanpa error
Backend berjalan dan merespons di port 3000
Reverse proxy (Nginx) dikonfigurasi
SSL certificate aktif
Process manager (PM2/systemd) dikonfigurasi untuk auto-restart
Backup database terjadwal
Firewall hanya expose port 80/443

7. Troubleshooting

Backend Issues

Server Tidak Bisa Start

Error	Penyebab	Solusi
`ECONNREFUSED 127.0.0.1:3306`	MySQL tidak berjalan	Start MySQL service
`Access denied for user`	Kredensial salah	Cek `DB_USER` dan `DB_PASS` di `.env`
`Unknown database 'trucking'`	Database belum dibuat	Jalankan `npm run migrate`
`JWT_SECRET belum dikonfigurasi`	`.env` tidak lengkap	Tambahkan `JWT_SECRET` di `.env`
`MONGO_URI belum dikonfigurasi`	MongoDB tidak diset	Opsional — server tetap jalan
`EADDRINUSE :::3000`	Port sudah dipakai	Kill proses lain atau ganti `PORT`

Cek port yang dipakai:

netstat -ano | findstr :3000
taskkill /PID <pid> /F

API Return 401 Unauthorized

Penyebab umum:

Token expired — login ulang
Token tidak dikirim — cek header Authorization: Bearer <token>
JWT_SECRET berbeda antara saat generate dan verify

API Return 403 Forbidden

User dengan role cs mencoba akses endpoint yang tidak diizinkan. Hanya endpoint berikut yang bisa diakses CS:

GET /api/schedule-pengiriman
GET /api/auth/me
PUT /api/auth/me

MySQL Connection Pool Exhausted

Gejala: Request timeout atau Too many connections

Solusi:

Pastikan tidak ada query yang hang
Cek connectionLimit di db.js (default: 10)
Pastikan setiap query menggunakan pool (bukan manual connection)

Migration Gagal

Situasi	Solusi
Table already exists	Gunakan `npm run migrate:adopt-existing`
Syntax error di SQL	Perbaiki file migration, rollback dulu jika perlu
Permission denied	Cek user MySQL punya privilege CREATE/ALTER

Frontend Issues

Halaman Blank / White Screen

Buka browser DevTools (F12) → Console
Cek apakah ada JavaScript error
Cek Network tab — apakah API calls gagal

Penyebab umum:

Backend belum berjalan → start backend dulu
CORS error → seharusnya tidak terjadi dengan Vite proxy
Build error → jalankan npm run build-only untuk cek

API Calls Gagal (Network Error)

Development:

Pastikan backend berjalan di port 3000
Vite proxy otomatis forward /api/* ke http://127.0.0.1:3000

Production:

Pastikan VITE_API_URL di .env.production benar
Cek Nginx proxy configuration

CSS / UI Tidak Update

Hard refresh: Ctrl + Shift + R
Clear browser cache
Leaflet cluster icons bisa ter-cache

TypeScript Build Error

Jika ada TS error di file yang tidak terkait:

Gunakan npm run build-only (skip type-check)
File legacy .js di src/services/ mungkin punya implicit any — known issue

Leaflet Map Tidak Muncul

Container div tidak punya height → pastikan parent punya fixed height
Leaflet CSS tidak ter-import → cek import di component
Tile server unreachable → cek koneksi internet

GPS / Wialon Issues

Semua Truck Muncul Offline

Restart backend
Cek log backend untuk error login Wialon
Verifikasi WIALON_TOKEN di .env belum expired
Cek apakah Wialon API accessible dari server

Reverse Geocode Tidak Menampilkan Alamat

Penyebab:

GEOAPIFY_API_KEY tidak valid atau quota habis
Koordinat tidak valid (0,0 atau null)

Solusi:

UI fallback ke koordinat mentah
Cek Geoapify dashboard untuk usage/quota

Clear localStorage jika ingin force re-fetch:

Object.keys(localStorage)
  .filter(k => k.startsWith('geocode_'))
  .forEach(k => localStorage.removeItem(k));

Geofence History Tetap "Pending"

Penyebab: Wialon resource/get_zones_by_unit mengembalikan nested payload.

Langkah debug:

Cek raw Wialon membership result untuk truck/unit bermasalah
Verifikasi parsed membership map dari fetchUnitsInZonesByResource
Pastikan normalizeZoneMembershipPayload handle nested format: {resourceId: {zoneId: [unitIds]}}
Cek apakah truck benar-benar di dalam polygon geofence di Wialon

Monthly Mileage "Invalid GPS Mapping"

Penyebab: wialon_unit_id di database tidak cocok dengan unit di Wialon.

Solusi:

Cek mapping di Master Truck
Jalankan auto-map ulang: POST /api/wialon/trucks/auto-map
Atau update wialon_unit_id manual

Database Issues

Tanggal Bergeser 1 Hari

Penyebab: MySQL DATE di-parse melalui UTC conversion.

Solusi:

Backend: Jangan gunakan new Date(dateString).toISOString().slice(0,10)
Frontend: Parse dengan new Date(year, month - 1, day) bukan new Date('YYYY-MM-DD')

Data Tidak Konsisten Setelah Import

Cek log import di backend console
Verifikasi format Excel sesuai template
Pastikan referensi (truck_id, driver_id) valid dan active
Import akan reject inactive trucks/drivers

Network & Infrastructure

CORS Error

Development: Pastikan request ke /api/* (bukan full URL ke port 3000)
Production: Pastikan Nginx proxy_pass dikonfigurasi untuk semua path

WebSocket / HMR Error (Development)

Pastikan port 5173 tidak diblokir firewall
Untuk development lokal, comment out hmr config di vite.config.ts

PowerShell Execution Policy

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

Performance Issues

Backend Response Lambat

Cek slow queries: SHOW PROCESSLIST;
Tambahkan index untuk kolom yang sering di-query/filter
Cek Wialon API timeout (increase WIALON_TIMEOUT_MS)
Cek connection pool usage

Frontend Load Lambat

Jalankan production build (bukan dev mode)
Cek bundle size via npm run build-only
Pastikan gambar/assets sudah optimized
Gunakan browser DevTools → Performance tab

8. Coding Conventions

Backend (Node.js / Express)

Bahasa & Module System

JavaScript (bukan TypeScript)
CommonJS: require() / module.exports
Tidak menggunakan ES Modules di backend

Struktur File Route

const express = require("express");
const router = express.Router();
const pool = require("../db");
const { authenticateToken } = require("../middleware/auth");

router.use(authenticateToken);

router.get("/", async (req, res) => {
  try {
    const [rows] = await pool.query("SELECT * FROM table_name");
    res.json(rows);
  } catch (error) {
    console.error("Error:", error);
    res.status(500).json({ message: "Gagal mengambil data" });
  }
});

module.exports = router;

Naming Conventions (Backend)

Item	Convention	Contoh
File route	camelCase	`salesCost.js`, `dataTruck.js`
File service	camelCase	`wialonService.js`
Variable	camelCase	`truckId`, `noPolisi`
Database column	snake_case	`is_active`, `wialon_unit_id`
API endpoint	kebab-case	`/api/sales-costs`, `/api/data-trucks`
Error message	Bahasa Indonesia	`"Token tidak ditemukan"`

Database Query Pattern

// ✅ Parameterized query (aman dari SQL injection)
const [rows] = await pool.query(
  "SELECT * FROM truck WHERE id = ? AND is_active = ?",
  [id, 1]
);

// ❌ String concatenation (JANGAN)
const [rows] = await pool.query(
  `SELECT * FROM truck WHERE id = ${id}`
);

Error Handling Pattern

router.post("/", async (req, res) => {
  try {
    // ... logic
    res.status(201).json({ message: "Berhasil", data: result });
  } catch (error) {
    console.error("Deskripsi context:", error);
    res.status(500).json({ message: "Pesan error user-friendly" });
  }
});

Soft Delete Pattern

// Deactivate
router.patch("/:id/status", async (req, res) => {
  const { is_active } = req.body;
  await pool.query("UPDATE truck SET is_active = ? WHERE id = ?", [is_active, id]);
});

// Default query: hanya active
const [rows] = await pool.query("SELECT * FROM truck WHERE is_active = 1");

// Admin view: semua
const [rows] = await pool.query("SELECT * FROM truck");

Date Handling (Backend)

// ✅ Preserve local date parts
const formatDate = (dateValue) => {
  if (!dateValue) return null;
  const d = new Date(dateValue);
  const year = d.getFullYear();
  const month = String(d.getMonth() + 1).padStart(2, '0');
  const day = String(d.getDate()).padStart(2, '0');
  return `${year}-${month}-${day}`;
};

// ❌ Jangan gunakan (bisa geser 1 hari karena UTC)
const bad = new Date(dateValue).toISOString().slice(0, 10);

Frontend (Vue 3 / TypeScript)

Bahasa & Style

TypeScript untuk file baru (.ts, .vue dengan <script setup lang="ts">)
File legacy boleh tetap .js sampai ada kebutuhan refactor
Vue 3 Composition API dengan <script setup>
Tailwind CSS utility classes

Struktur Component (Vue SFC)

<script setup lang="ts">
import { ref, onMounted } from 'vue'
import { API_BASE } from '@/config/api'

const props = defineProps<{
  truckId: number
}>()

const loading = ref(false)
const data = ref<TruckData | null>(null)

const fetchData = async () => {
  loading.value = true
  try {
    const res = await fetch(`${API_BASE}/trucks/${props.truckId}`)
    data.value = await res.json()
  } finally {
    loading.value = false
  }
}

onMounted(() => {
  fetchData()
})
</script>

<template>
  <div class="p-4">
    <!-- template -->
  </div>
</template>

Naming Conventions (Frontend)

Item	Convention	Contoh
Component file	PascalCase	`TruckLocationMap.vue`
View folder	PascalCase	`views/Master/`, `views/Monitoring/`
Service file	camelCase	`truckLocationService.ts`
Composable	camelCase with `use` prefix	`useAuth.ts`
Variable/ref	camelCase	`truckList`, `isLoading`
CSS class	Tailwind utilities	`class="flex items-center gap-2"`

Service Pattern

// src/services/truckLocationService.ts
import { API_BASE } from '@/config/api'

export const getTruckLocations = async () => {
  const token = localStorage.getItem('token')
  const res = await fetch(`${API_BASE}/wialon/trucks/location`, {
    headers: { Authorization: `Bearer ${token}` }
  })
  if (!res.ok) throw new Error('Failed to fetch')
  return res.json()
}

Path Alias

Gunakan @/ untuk import dari src/:

import { API_BASE } from '@/config/api'
import TruckCard from '@/components/TruckCard.vue'

Tailwind CSS Guidelines

<!-- ✅ Tailwind utilities -->
<div class="flex items-center gap-4 p-4 rounded-lg bg-white shadow-sm">

<!-- ❌ Hindari custom class tanpa alasan kuat -->
<div class="truck-card-wrapper">

Git Conventions

Commit Messages

Format: <type>: <description>

Type	Penggunaan
`feat`	Fitur baru
`fix`	Bug fix
`refactor`	Refactoring tanpa perubahan behavior
`docs`	Perubahan dokumentasi
`style`	Formatting, missing semicolons, dll
`chore`	Maintenance, dependency update

Contoh:

feat: add monthly mileage export to Excel
fix: date shift issue on Sales Cost edit
refactor: extract geofence tracking to service

Branch Naming

feature/add-truck-mileage
fix/date-shift-sales-cost
refactor/wialon-service-cleanup

File Organization Rules

Satu route file per domain — jangan gabung multiple domains
Business logic di services — route hanya handle HTTP
Satu service file per external integration — e.g., wialonService.js
Views by domain — views/Master/, views/Transaksi/
Shared components di components/ — bukan di dalam views/
Migration files tidak boleh diedit setelah di-apply — buat migration baru

Bahasa

Context	Bahasa
Code (variable, function, comments)	English
UI text	Bahasa Indonesia
API error messages	Bahasa Indonesia
Documentation	Bahasa Indonesia (kecuali technical terms)
Git commits	English

Dokumen ini di-generate dari: docs/developer/ folder
Terakhir diperbarui: Mei 2026

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/transport-project-doc/

PowerShell Notes for Professionals

Ngopidulur — Mon, 25 May 2026 23:17:00 GMT

PowerShell Notes for Professionals

Versi ini dirapikan dan diperingkas dari dokumen PowerShell Notes for Professionals. Fokusnya adalah navigasi cepat, inti materi, dan daftar konsep/cmdlet penting per bab.

Cara Pakai Dokumen

Gunakan Daftar Isi untuk lompat ke bab tertentu.
Setiap bab berisi inti materi, topik/bagian, dan cmdlet/konsep cepat.
Contoh kode tidak ditampilkan penuh agar dokumen lebih ringkas; gunakan versi lengkap jika perlu detail sintaks.

Daftar Isi

Bab 1: Memulai PowerShell

Inti: Fondasi PowerShell: execution policy, alias, pipeline, pemanggilan .NET, instalasi, komentar, dan pembuatan objek.

Topik penting:

1.1 — Allow scripts stored on your machine to run un-signed 2 ........................................................................
1.2 — Aliases & Similar Functions 2 .......................................................................................................................
1.3 — The Pipeline-Using Output from a PowerShell cmdlet 3 ........................................................................
1.4 — Calling .Net Library Methods 4 ....................................................................................................................
1.5 — Installation or Setup 5 ..................................................................................................................................
1.6 — Commenting 5 ...............................................................................................................................................
1.7 — Creating Objects 6 ........................................................................................................................................

Bab 2: Variabel di PowerShell

Inti: Cara menyimpan dan mengelola nilai memakai variabel, array, scope, assignment multi-variabel, dan penghapusan variabel.

Topik penting:

2.1 — Simple variable 7 ..........................................................................................................................................
2.2 — Arrays 7 ........................................................................................................................................................
2.3 — List Assignment of Multiple Variables 7 .....................................................................................................
2.4 — Scope 8 .........................................................................................................................................................
2.5 — Removing a variable 8 ................................................................................................................................

Bab 3: Operator

Inti: Operator penting untuk perbandingan, aritmatika, assignment, redirection stream, logika, dan manipulasi string.

Topik penting:

3.1 — Comparison Operators 9 .............................................................................................................................
3.2 — Arithmetic Operators 9 ................................................................................................................................
3.3 — Assignment Operators 10 ...........................................................................................................................
3.4 — Redirection Operators 10 ............................................................................................................................
3.5 — Mixing operand types, the type of the left operand dictates the behavior 11 ......................................
3.6 — Logical Operators 11 ...................................................................................................................................
3.7 — String Manipulation Operators 11 ..............................................................................................................

Bab 4: Operator Khusus

Inti: Operator khusus seperti array expression, call operator, dan dot sourcing untuk menjalankan script di scope tertentu.

Topik penting:

4.1 — Array Expression Operator 13 .....................................................................................................................
4.2 — Call Operation 13 .........................................................................................................................................
4.3 — Dot sourcing operator 13 ............................................................................................................................

Bab 5: Operasi Set Dasar

Inti: Operasi koleksi dasar: filter, sort, group, dan select/projection objek PowerShell.

Topik penting:

5.1 — Filtering: Where-Object / where / ? 14 ......................................................................................................
5.2 — Ordering: Sort-Object / sort 14 ..................................................................................................................
5.3 — Grouping: Group-Object / group 15 ..........................................................................................................
5.4 — Projecting: Select-Object / select 16 ..........................................................................................................

Cmdlet/konsep cepat: Where-Object, Sort-Object, Group-Object, Select-Object

Bab 6: Logika Kondisional

Inti: Pola percabangan dengan if/else/elseif, negasi, dan perilaku truthy/falsy dalam PowerShell.

Topik penting:

6.1 — if, else and else if 17 .....................................................................................................................................
6.2 — Negation 17 ..................................................................................................................................................
6.3 — If conditional shorthand 18 .........................................................................................................................

Bab 7: Perulangan

Inti: Teknik perulangan: foreach, for, ForEach-Object, continue, break, while, dan do/until.

Topik penting:

7.1 — Foreach 19 .....................................................................................................................................................
7.2 — For 19 ............................................................................................................................................................
7.3 — ForEach() Method 19 ...................................................................................................................................
7.4 — ForEach-Object 20 .......................................................................................................................................
7.5 — Continue 21 ...................................................................................................................................................
7.6 — Break 21 ........................................................................................................................................................
7.7 — While 22 .........................................................................................................................................................
7.8 — Do 22 .............................................................................................................................................................

Cmdlet/konsep cepat: ForEach-Object

Bab 8: Pernyataan Switch

Inti: Penggunaan switch untuk banyak kondisi, termasuk wildcard, regex, file input, exact match, default, dan break.

Topik penting:

8.1 — Simple Switch ...........................................................................................................................................
8.2 — Switch Statement with CaseSensitive Parameter ...............................................................................
8.3 — Switch Statement with Wildcard Parameter ........................................................................................
8.4 — Switch Statement with File Parameter .................................................................................................
8.5 — Simple Switch with Default Condition ...................................................................................................
8.6 — Switch Statement with Regex Parameter ............................................................................................
8.7 — Simple Switch With Break ......................................................................................................................
8.8 — Switch Statement with Exact Parameter ..............................................................................................
8.9 — Switch Statement with Expressions ......................................................................................................

Bab 9: String

Inti: Pengolahan string: multi-line string, here-string, concatenation, karakter escape, literal string, dan format string.

Topik penting:

9.1 — Multiline string ..........................................................................................................................................
9.2 — Here-string ..............................................................................................................................................
9.3 — Concatenating strings ............................................................................................................................
9.4 — Special characters ..................................................................................................................................
9.5 — Creating a basic string ...........................................................................................................................
9.6 — Format string ..........................................................................................................................................

Bab 10: HashTable

Inti: HashTable sebagai struktur key-value: membuat, membaca, menambah, menghapus, enumerasi, dan looping.

Topik penting:

10.1 — Access a hash table value by key ........................................................................................................
10.2 — Creating a Hash Table ..........................................................................................................................
10.3 — Add a key value pair to an existing hash table ..................................................................................
10.4 — Remove a key value pair from an existing hash table .....................................................................
10.5 — Enumerating through keys and Key-Value Pairs ..............................................................................
10.6 — Looping over a hash table ...................................................................................................................

Bab 11: Bekerja dengan Objek

Inti: Bekerja dengan objek: inspeksi member, menambah/menghapus properti, membuat objek custom, dan generic class.

Topik penting:

11.1 — Examining an object ...............................................................................................................................
11.2 — Updating Objects ...................................................................................................................................
11.3 — Creating a new object ............................................................................................................................
11.4 — Creating Instances of Generic Classes ................................................................................................

Bab 12: Fungsi PowerShell

Inti: Pembuatan fungsi: parameter dasar/lanjutan, mandatory parameter, validasi, dan fungsi tanpa parameter.

Topik penting:

12.1 — Basic Parameters ...................................................................................................................................
12.2 — Advanced Function ...............................................................................................................................
12.3 — Mandatory Parameters ........................................................................................................................
12.4 — Parameter Validation ............................................................................................................................
12.5 — Simple Function with No Parameters ..................................................................................................

Bab 13: Kelas PowerShell

Inti: Class PowerShell: constructor, method, property, overload, inheritance, dan template class.

Topik penting:

13.1 — Listing available constructors for a class ............................................................................................
13.2 — Methods and properties .......................................................................................................................
13.3 — Constructor overloading .......................................................................................................................
13.4 — Get All Members of an Instance ...........................................................................................................
13.5 — Basic Class Template ............................................................................................................................
13.6 — Inheritance from Parent Class to Child Class .....................................................................................

Bab 14: Modul PowerShell

Inti: Modul PowerShell: manifest, struktur folder, ekspor fungsi/variabel, lokasi modul, dan visibilitas member.

Topik penting:

14.1 — Create a Module Manifest .....................................................................................................................
14.2 — Simple Module Example .......................................................................................................................
14.3 — Exporting a Variable from a Module ...................................................................................................
14.4 — Structuring PowerShell Modules ..........................................................................................................
14.5 — Location of Modules ..............................................................................................................................
14.6 — Module Member Visibility .....................................................................................................................

Bab 15: Profil PowerShell

Inti: Profil PowerShell untuk memuat otomatis fungsi, alias, dan konfigurasi pengguna saat shell dibuka.

Topik penting:

15.1 — Create an basic profle ..........................................................................................................................

Bab 16: Properti Terhitung

Inti: Calculated properties untuk membentuk properti hasil kalkulasi saat memakai Select-Object.

Topik penting:

16.1 — Display fle size in KB-Calculated Properties .....................................................................................

Bab 17: Menggunakan Kelas Statis .NET

Inti: Pemakaian class statis .NET seperti System.Math dan GUID dari PowerShell.

Topik penting:

17.1 — Adding types ...........................................................................................................................................
17.2 — Using the .Net Math Class .....................................................................................................................
17.3 — Creating new GUID instantly ................................................................................................................

Bab 18: Variabel Bawaan

Inti: Variabel bawaan penting seperti $PSScriptRoot, $Args, $PSItem, $?, dan $error.

Topik penting:

18.1 — $PSScriptRoot .........................................................................................................................................
18.2 — $Args ......................................................................................................................................................
18.3 — $PSItem ...................................................................................................................................................
18.4 — $? .............................................................................................................................................................
18.5 — $error ......................................................................................................................................................

Cmdlet/konsep cepat: $PSScriptRoot, $Args, $PSItem, $?, $error

Bab 19: Variabel Otomatis

Inti: Variabel otomatis seperti $OFS, $null, $pid, $true/$false, $_/$PSItem, dan $PSVersionTable.

Topik penting:

19.1 — $OFS ........................................................................................................................................................
19.2 — $? .............................................................................................................................................................
19.3 — $null .........................................................................................................................................................
19.4 — $error ......................................................................................................................................................
19.5 — $pid .........................................................................................................................................................
19.6 — Boolean values ......................................................................................................................................
19.7 — $_ / $PSItem ..........................................................................................................................................
19.8 — $PSVersionTable ...................................................................................................................................

Cmdlet/konsep cepat: $OFS, $?, $null, $error, $pid, $_, $PSItem, $PSVersionTable

Bab 20: Variabel Lingkungan

Inti: Mengakses environment variables melalui drive Env: dan notasi $env:.

Topik penting:

20.1 — Windows environment variables are visible as a PS drive called Env: ............................................
20.2 — Instant call of Environment Variables with $env: ..............................................................................

Cmdlet/konsep cepat: $env

Bab 21: Splatting

Inti: Splatting untuk mengirim banyak parameter memakai hashtable agar command lebih ringkas dan reusable.

Topik penting:

21.1 — Piping and Splatting ...............................................................................................................................
21.2 — Passing a Switch parameter using Splatting ......................................................................................
21.3 — Splatting From Top Level Function to a Series of Inner Function ....................................................
21.4 — Splatting parameters ............................................................................................................................

Bab 22: Stream PowerShell

Inti: Stream output PowerShell: output, error, warning, verbose, debug, information, dan preference variable.

Topik penting:

22.1 — Write-Output ..........................................................................................................................................
22.2 — Write Preferences .................................................................................................................................

Cmdlet/konsep cepat: Write-Output

Bab 23: Mengirim Email

Inti: Pengiriman email dengan Send-MailMessage dan SMTPClient.

Topik penting:

23.1 — Send-MailMessage with predefned parameters ...............................................................................
23.2 — Simple Send-MailMessage ...................................................................................................................
23.3 — SMTPClient-Mail with .txt fle in body message ...............................................................................

Bab 24: PowerShell Remoting

Inti: PowerShell Remoting: Enter-PSSession, Invoke-Command, serialization, trusted hosts, dan cleanup PSSession.

Topik penting:

24.1 — Connecting to a Remote Server via PowerShell ................................................................................
24.2 — Run commands on a Remote Computer ...........................................................................................
24.3 — Enabling PowerShell Remoting ...........................................................................................................
24.4 — A best practise for automatically cleaning-up PSSessions ..............................................................

Bab 25: Pipeline PowerShell

Inti: Pipeline berbasis objek dan cara membuat fungsi yang menerima input pipeline.

Topik penting:

25.1 — Writing Functions with Advanced Lifecycle ........................................................................................
25.2 — Basic Pipeline Support in Functions ....................................................................................................
25.3 — Working concept of pipeline ...............................................................................................................

Bab 26: Background Job PowerShell

Inti: Background jobs untuk menjalankan proses panjang tanpa mengunci prompt.

Topik penting:

26.1 — Basic job creation ..................................................................................................................................
26.2 — Basic job management ........................................................................................................................

Bab 27: Perilaku Return di PowerShell

Inti: Perilaku return dan output pipeline dalam fungsi/script PowerShell.

Topik penting:

27.1 — Early exit .................................................................................................................................................
27.2 — Gotcha! Return in the pipeline .............................................................................................................
27.3 — Return with a value ...............................................................................................................................
27.4 — How to work with functions returns ....................................................................................................
27.5 — Gotcha! Ignoring unwanted output .....................................................................................................

Bab 28: Parsing CSV

Inti: Import CSV dan casting tipe data hasil Import-Csv.

Topik penting:

28.1 — Basic usage of Import-Csv ...................................................................................................................
28.2 — Import from CSV and cast properties to correct type .....................................................................

Cmdlet/konsep cepat: Import-Csv

Bab 29: Bekerja dengan File XML

Inti: Membaca, menulis, memanipulasi XML, XPath, namespace, dan XmlWriter.

Topik penting:

29.1 — Accessing an XML File ...........................................................................................................................
29.2 — Creating an XML Document using XmlWriter() .................................................................................
29.3 — Adding snippets of XML to current XMLDocument ...........................................................................

Bab 30: RESTful API

Inti: Konsumsi REST API memakai Invoke-RestMethod untuk GET, POST, PUT, dan DELETE.

Topik penting:

30.1 — Post Message to hipChat ......................................................................................................................
30.2 — Using REST with PowerShell Objects to GET and POST many items ..............................................
30.3 — Use Slack.com Incoming Webhooks ..................................................................................................
30.4 — Using REST with PowerShell Objects to Get and Put individual data .............................................
30.5 — Using REST with PowerShell to Delete items .....................................................................................

Bab 31: Query SQL PowerShell

Inti: Menjalankan query SQL dari PowerShell.

Topik penting:

31.1 — SQLExample ............................................................................................................................................
31.2 — SQLQuery ...............................................................................................................................................

Bab 32: Regular Expression

Inti: Regex untuk match, replace, escape karakter khusus, dan multiple matches.

Topik penting:

32.1 — Single match ..........................................................................................................................................
32.2 — Replace ..................................................................................................................................................
32.3 — Replace text with dynamic value using a MatchEvalutor ................................................................
32.4 — Escape special characters ...................................................................................................................
32.5 — Multiple matches ...................................................................................................................................

Bab 33: Alias

Inti: Membaca dan membuat alias cmdlet.

Topik penting:

33.1 — Get-Alias .................................................................................................................................................
33.2 — Set-Alias .................................................................................................................................................

Cmdlet/konsep cepat: Get-Alias, Set-Alias

Bab 34: Progress Bar

Inti: Menampilkan progress proses dengan Write-Progress.

Topik penting:

34.1 — Simple use of progress bar ..................................................................................................................
34.2 — Usage of inner progress bar ...............................................................................................................

Bab 35: Command-Line PowerShell.exe

Inti: Opsi command-line PowerShell.exe untuk menjalankan command, script, policy, profile, dan window style.

Topik penting:

35.1 — Executing a command 100 ........................................................................................................................
35.2 — Executing a script fle 101 .........................................................................................................................

Bab 36: Penamaan Cmdlet

Inti: Standar penamaan cmdlet Verb-Noun.

Topik penting:

36.1 — Verbs 102 .....................................................................................................................................................
36.2 — Nouns 102 ...................................................................................................................................................

Bab 37: Menjalankan Executable

Inti: Menjalankan aplikasi GUI/console dan membaca exit code.

Topik penting:

37.1 — GUI Applications 103 ..................................................................................................................................
37.2 — Console Streams 103 .................................................................................................................................
37.3 — Exit Codes 103 ............................................................................................................................................

Bab 38: Prasyarat Script

Inti: Menetapkan prasyarat script seperti versi minimum dan administrator.

Topik penting:

38.1 — Enforce minimum version of PowerShell host 104 ..................................................................................
38.2 — Enforce running the script as administrator ....................................................................................

Bab 39: Sistem Bantuan

Inti: Memakai Get-Help, update help, contoh, full help, online help, dan parameter-specific help.

Topik penting:

39.1 — Updating the Help System .................................................................................................................
39.2 — Using Get-Help ....................................................................................................................................
39.3 — Viewing online version of a help topic ..............................................................................................
39.4 — Viewing Examples ...............................................................................................................................
39.5 — Viewing the Full Help Page ................................................................................................................
39.6 — Viewing help for a specifc parameter .............................................................................................

Cmdlet/konsep cepat: Get-Help

Bab 40: Modul, Script, dan Fungsi

Inti: Perbedaan function, script, module, dan advanced function.

Topik penting:

40.1 — Function ...............................................................................................................................................
40.2 — Script ....................................................................................................................................................
40.3 — Module .................................................................................................................................................
40.4 — Advanced Functions ..........................................................................................................................

Bab 41: Konvensi Penamaan

Inti: Konvensi penamaan fungsi agar konsisten dan mudah dipahami.

Topik penting:

41.1 — Functions ...............................................................................................................................................

Bab 42: Parameter Umum

Inti: Parameter umum seperti ErrorAction untuk mengontrol error.

Topik penting:

42.1 — ErrorAction parameter .......................................................................................................................

Bab 43: Parameter Set

Inti: Parameter set untuk membatasi kombinasi parameter dan memaksa pilihan valid.

Topik penting:

43.1 — Parameter set to enforce the use of a parameter when a other is selected ...............................
43.2 — Parameter set to limit the combination of parameters .................................................................

Bab 44: Parameter Dinamis

Inti: Dynamic parameter untuk menambahkan parameter saat runtime.

Topik penting:

44.1 — "Simple"dynamic parameter ............................................................................................................

Bab 45: GUI di PowerShell

Inti: Pembuatan GUI WPF sederhana dari PowerShell.

Topik penting:

45.1 — WPF GUI for Get-Service cmdlet .......................................................................................................

Cmdlet/konsep cepat: Get-Service

Bab 46: URL Encode/Decode

Inti: Encode dan decode URL memakai HttpUtility atau URI class.

Topik penting:

46.1 — Encode Query String with[System.Web.HttpUtility]::UrlEncode() ...............................................
46.2 — Quick Start: Encoding .........................................................................................................................
46.3 — Quick Start: Decoding ........................................................................................................................
46.4 — Encode Query String with[uri]::EscapeDataString() ....................................................................
46.5 — Decode URL with[uri]::UnescapeDataString() ..............................................................................
46.6 — Decode URL with[System.Web.HttpUtility]::UrlDecode() ............................................................

Bab 47: Penanganan Error

Inti: Jenis error dan dasar penanganan error.

Topik penting:

47.1 — Error Types ..........................................................................................................................................

Bab 48: Manajemen Paket

Inti: Mencari, menginstall, update, dan uninstall modul PowerShell.

Topik penting:

48.1 — Create the default PowerShell Module Repository ..........................................................................
48.2 — Find a module by name ....................................................................................................................
48.3 — Install a Module by name ..................................................................................................................
48.4 — Uninstall a module my name and version .......................................................................................
48.5 — Update a module by name ...............................................................................................................
48.6 — Find a PowerShell module using a pattern ......................................................................................

Bab 49: Komunikasi TCP

Inti: Komunikasi TCP listener/sender menggunakan PowerShell.

Topik penting:

49.1 — TCP listener ..........................................................................................................................................
49.2 — TCP Sender .........................................................................................................................................

Bab 50: Workflow PowerShell

Inti: Workflow PowerShell untuk proses background, paralel, dan input parameter.

Topik penting:

50.1 — Workfow with Input Parameters .......................................................................................................
50.2 — Simple Workfow Example ................................................................................................................
50.3 — Run Workfow as a Background Job ...............................................................................................
50.4 — Add a Parallel Block to a Workfow .................................................................................................

Bab 51: Managed Code C# / VB

Inti: Menyematkan kode C# atau VB.NET dengan Add-Type.

Topik penting:

51.1 — C# Example ...........................................................................................................................................
51.2 — VB.NET Example ..................................................................................................................................

Bab 52: Download Artifact dari Artifactory

Inti: Contoh script untuk mengambil artifact terbaru dari Artifactory.

Topik penting:

52.1 — PowerShell Script for downloading the latest artifact ....................................................................

Bab 53: Comment-Based Help

Inti: Help berbasis komentar agar fungsi/script dapat dibaca oleh Get-Help.

Topik penting:

53.1 — Function comment-based help ..........................................................................................................
53.2 — Script comment-based help ..............................................................................................................

Bab 54: Modul Archive

Inti: Compress-Archive dan Expand-Archive untuk ZIP.

Topik penting:

54.1 — Compress-Archive with wildcard .......................................................................................................
54.2 — Update existing ZIP with Compress-Archive ...................................................................................
54.3 — Extract a Zip with Expand-Archive ....................................................................................................

Cmdlet/konsep cepat: Compress-Archive, Expand-Archive

Bab 55: Otomasi Infrastruktur

Inti: Otomasi infrastruktur dan contoh test integrasi black-box.

Topik penting:

55.1 — Simple script for black-box integration test of console applications ............................................

Bab 56: PSScriptAnalyzer

Inti: PSScriptAnalyzer untuk static analysis script PowerShell.

Topik penting:

56.1 — Analyzing scripts with the built-in preset rulesets ...........................................................................
56.2 — Analyzing scripts against every built-in rule ...................................................................................
56.3 — List all built-in rules .............................................................................................................................

Bab 57: Desired State Configuration DSC

Inti: DSC untuk mendefinisikan konfigurasi target dan resource.

Topik penting:

57.1 — Simple example-Enabling WindowsFeature ...................................................................................
57.2 — Starting DSC (mof) on remote machine ..........................................................................................
57.3 — Importing psd1 (data fle) into local variable ...................................................................................
57.4 — List available DSC Resources ............................................................................................................
57.5 — Importing resources for use in DSC ..................................................................................................

Bab 58: ShouldProcess

Inti: ShouldProcess untuk dukungan -WhatIf dan -Confirm.

Topik penting:

58.1 — Full Usage Example ............................................................................................................................
58.2 — Adding-WhatIf and-Confrm support to your cmdlet ..................................................................
58.3 — Using ShouldProcess() with one argument .....................................................................................

Bab 59: Scheduled Tasks

Inti: Scheduled Tasks untuk menjalankan script PowerShell secara terjadwal.

Topik penting:

59.1 — Run PowerShell Script in Scheduled Task .........................................................................................

Bab 60: Modul ISE

Inti: PowerShell ISE dan fitur scripting/debugging.

Topik penting:

60.1 — Test Scripts ..........................................................................................................................................

Bab 61: Resource DSC Berbasis Class

Inti: Membuat DSC resource berbasis class.

Topik penting:

61.1 — Create a DSC Resource Skeleton Class .............................................................................................
61.2 — DSC Resource Skeleton with Key Property ......................................................................................
61.3 — DSC Resource with Mandatory Property ..........................................................................................
61.4 — DSC Resource with Required Methods .............................................................................................

Bab 62: WMI dan CIM

Inti: Query WMI/CIM, namespace, class, dan instance.

Topik penting:

62.1 — Querying objects .................................................................................................................................
62.2 — Classes and namespaces ..................................................................................................................

Bab 63: Modul ActiveDirectory

Inti: Cmdlet ActiveDirectory untuk user, group, computer, dan object AD.

Topik penting:

63.1 — Users .....................................................................................................................................................
63.2 — Module .................................................................................................................................................
63.3 — Groups ..................................................................................................................................................
63.4 — Computers ...........................................................................................................................................
63.5 — Objects .................................................................................................................................................

Bab 64: Modul SharePoint

Inti: Modul SharePoint untuk snap-in, list, dan feature site collection.

Topik penting:

64.1 — Loading SharePoint Snap-In ..............................................................................................................
64.2 — Iterating over all lists of a site collection .........................................................................................
64.3 — Get all installed features on a site collection ...................................................................................

Bab 65: Psake

Inti: Psake untuk build/task automation.

Topik penting:

65.1 — Basic outline .........................................................................................................................................
65.2 — FormatTaskName example ..............................................................................................................
65.3 — Run Task conditionally .......................................................................................................................
65.4 — ContinueOnError .................................................................................................................................

Bab 66: Pester

Inti: Pester untuk unit testing PowerShell.

Topik penting:

66.1 — Getting Started with Pester ................................................................................................................

Bab 67: Secret dan Credential

Inti: Menangani credential dan secret dengan SecureString/Export-CliXml.

Topik penting:

67.1 — Accessing the Plaintext Password .....................................................................................................
67.2 — Prompting for Credentials .................................................................................................................
67.3 — Working with Stored Credentials ......................................................................................................
67.4 — Storing the credentials in Encrypted form and Passing it as parameter when Required

Bab 68: Security dan Cryptography

Inti: Hashing dan kriptografi via .NET.

Topik penting:

68.1 — Calculating a string's hash codes via .Net Cryptography ...............................................................

Bab 69: Signing Scripts

Inti: Menandatangani script dan mengatur execution policy.

Topik penting:

69.1 — Signing a script ....................................................................................................................................
69.2 — Bypassing execution policy for a single script ................................................................................
69.3 — Changing the execution policy using Set-ExecutionPolicy .............................................................
69.4 — Get the current execution policy .......................................................................................................
69.5 — Getting the signature from a signed script ......................................................................................
69.6 — Creating a self-signed code signing certifcate for testing ............................................................

Cmdlet/konsep cepat: Set-ExecutionPolicy

Bab 70: Anonimisasi IP

Inti: Anonimisasi IPv4/IPv6 dalam file teks dengan regex.

Topik penting:

70.1 — Anonymize IP address in text fle .......................................................................................................

Bab 71: AWS Rekognition

Inti: Contoh AWS Rekognition dari PowerShell.

Topik penting:

71.1 — Detect Image Labels with AWS Rekognition .....................................................................................
71.2 — Compare Facial Similarity with AWS Rekognition ...........................................................................

Bab 72: AWS S3

Inti: Operasi dasar AWS S3: bucket, upload, dan delete.

Topik penting:

72.1 — Create a new S3 Bucket ......................................................................................................................
72.2 — Upload a Local File Into an S3 Bucket .............................................................................................
72.3 — Delete a S3 Bucket .............................................................................................................................

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/powershell-notes-for-professionals/

PostgreSQL® Notes for Professionals

Ngopidulur — Mon, 25 May 2026 22:37:00 GMT

PostgreSQL® Notes for Professionals — Versi Bahasa Indonesia

Catatan: Dokumen Markdown ini dibuat dari file PostgreSQLNotesForProfessionals.pdf dan diterjemahkan ke Bahasa Indonesia. Contoh perintah SQL, shell, C, Java, Python, PHP, dan C# sengaja dipertahankan sedekat mungkin dengan bentuk aslinya agar tetap dapat digunakan.

Tentang

Buku PostgreSQL® Notes for Professionals adalah buku gratis tidak resmi untuk tujuan edukasi. Materinya dikompilasi dari Stack Overflow Documentation. PostgreSQL®, Stack Overflow, dan merek lain adalah milik pemiliknya masing-masing. Informasi di dalam buku tidak dijamin selalu benar atau akurat; gunakan dengan pertimbangan sendiri.

Daftar Isi

Bab 1: Memulai dengan PostgreSQL
Bab 2: Tipe Data
Bab 3: Tanggal, Timestamp, dan Interval
Bab 4: Pembuatan Tabel
Bab 5: SELECT
Bab 6: Mencari Panjang String / Karakter
Bab 7: COALESCE
Bab 8: INSERT
Bab 9: UPDATE
Bab 10: Dukungan JSON
Bab 11: Fungsi Agregat
Bab 12: Common Table Expressions
Bab 13: Window Functions
Bab 14: Query Rekursif
Bab 15: PL/pgSQL
Bab 16: Inheritance
Bab 17: Export CSV
Bab 18: Trigger
Bab 19: Event Trigger
Bab 20: Role Management
Bab 21: Kriptografi
Bab 22: Comment
Bab 23: Backup & Restore
Bab 24: Script Backup
Bab 25: Akses Programatik
Bab 26: Java
Bab 27: High Availability
Bab 28: dblink & FDW
Bab 29: Tips & Tricks

Bab 1: Memulai dengan PostgreSQL

Versi PostgreSQL

Versi	Tanggal Rilis	Tanggal EOL
10.0	2017-10-05	2022-10-01
9.6	2016-09-29	2021-09-01
9.5	2016-01-07	2021-01-01
9.4	2014-12-18	2019-12-01
9.3	2013-09-09	2018-09-01
9.2	2012-09-10	2017-09-01
9.1	2011-09-12	2016-09-01
9.0	2010-09-20	2015-09-01
8.4	2009-07-01	2014-07-01

1.1 Menginstal PostgreSQL di Windows

Walaupun server produksi umumnya lebih disarankan berjalan di sistem berbasis Unix seperti Linux atau BSD, PostgreSQL tetap dapat diinstal di Windows, terutama untuk server pengembangan.

Langkah umum:

Unduh installer Windows dari EnterpriseDB.
Pilih versi stabil terbaru, bukan versi beta.
Pilih paket sesuai arsitektur Windows: x86-64 untuk 64-bit atau x86-32 untuk 32-bit.
Pada installer, pilih paket tambahan yang diperlukan, misalnya:
- pgAdmin: GUI gratis untuk mengelola database.
- PostGIS: ekstensi analisis geospasial.
- Language Pack: library untuk PL/Python, PL/Perl, dan PL/Tcl.
- Paket lain seperti pgAgent, pgBouncer, dan Slony biasanya digunakan untuk server produksi yang lebih besar.
Setelah instalasi, buka pgAdmin dan hubungkan ke server lokal, misalnya PostgreSQL 9.5 (localhost:5432).

Opsional: Mengubah Startup Service menjadi Manual

PostgreSQL berjalan sebagai service di background. Default-nya adalah Automatic, artinya service selalu aktif saat komputer menyala.

Jika komputer dipakai bergantian untuk pengembangan dan pekerjaan lain, Anda dapat mengubahnya menjadi Manual:

Buka Control Panel -> System and Security -> Administrative Tools -> Services.
Cari service bernama seperti postgresql-x64-9.5.
Klik kanan → Properties → Startup type → Manual → Apply.
Untuk menjalankan service, klik kanan → Start.
Untuk menghentikan service, klik kanan → Stop.

1.2 Instal PostgreSQL dari Source di Linux

Dependensi umum:

GNU Make versi > 3.80
Compiler C ISO/ANSI, misalnya gcc
Extractor seperti tar atau gzip
zlib-devel
readline-devel atau libedit-devel

Contoh ekstraksi source:

tar -xzvf postgresql-9.6.3.tar.gz

Opsi konfigurasi yang sering digunakan:

--prefix=PATH              path untuk semua file
--exec-prefix=PATH         path untuk file bergantung arsitektur
--bindir=PATH              path program executable
--sysconfdir=PATH          path file konfigurasi
--with-pgport=NUMBER       port server
--with-perl                dukungan Perl
--with-python              dukungan Python
--with-openssl             dukungan OpenSSL
--with-ldap                dukungan LDAP
--with-blocksize=BLOCKSIZE ukuran page dalam KB
--with-wal-segsize=SEGSIZE ukuran segmen WAL dalam MB

Contoh build:

./configure --exec=/usr/local/pgsql
make
make install
make clean

Untuk ekstensi:

cd contrib
make
make install

1.3 Instalasi di GNU/Linux

Keluarga Red Hat

Contoh alur:

yum list available | grep postgres*
yum -y install postgresqlXX postgresqlXX-server postgresqlXX-libs postgresqlXX-contrib

Menjalankan service sebagai user postgres:

sudo -su postgres ./usr/pgsql-X.X/bin/pg_ctl -D /var/lib/pgsql/X.X/data start

Masuk ke CLI:

psql

Keluarga Debian

sudo apt-get install postgresql

Perintah ini menginstal paket server PostgreSQL versi default dari repository sistem operasi.

1.4 Instal PostgreSQL via MacPorts di macOS

Cek versi yang tersedia:

sudo port list | grep "^postgresql[[:digit:]]\{2\}[[:space:]]"

Contoh instalasi PostgreSQL 9.6:

sudo port install postgresql96-server postgresql96
sudo mkdir -p /opt/local/var/db/postgresql96/defaultdb
sudo chown postgres:postgres /opt/local/var/db/postgresql96/defaultdb
sudo su postgres -c '/opt/local/lib/postgresql96/bin/initdb -D /opt/local/var/db/postgresql96/defaultdb'
sudo port load -w postgresql96-server
su postgres -c psql

Cek direktori data:

SELECT setting FROM pg_settings WHERE name='data_directory';

Keluar dari psql:

\q

1.5 Instal PostgreSQL dengan Homebrew di Mac

brew update
brew install postgresql
brew services start postgresql
psql

Jika psql mengeluh tidak ada database sesuai user Anda, jalankan:

createdb

1.6 Postgres.app untuk macOS

Postgres.app adalah alat sederhana untuk menginstal PostgreSQL di Mac. Anda dapat mengatur apakah PostgreSQL berjalan di background atau hanya saat aplikasi aktif.

Bab 2: Tipe Data

PostgreSQL menyediakan banyak tipe data native. Pengguna juga dapat menambah tipe baru dengan perintah CREATE TYPE.

2.1 Tipe Numerik

Nama	Ukuran	Deskripsi	Rentang
`SMALLINT`	2 byte	integer rentang kecil	-32768 sampai +32767
`INTEGER`	4 byte	pilihan umum untuk integer	-2147483648 sampai +2147483647
`BIGINT`	8 byte	integer rentang besar	-9223372036854775808 sampai +9223372036854775807
`DECIMAL`	variabel	presisi ditentukan pengguna, eksak	sangat besar
`NUMERIC`	variabel	presisi ditentukan pengguna, eksak	sangat besar
`REAL`	4 byte	presisi variabel, tidak eksak	6 digit desimal
`DOUBLE PRECISION`	8 byte	presisi variabel, tidak eksak	15 digit desimal
`smallserial`	2 byte	integer auto-increment kecil	1 sampai 32767
`serial`	4 byte	integer auto-increment	1 sampai 2147483647
`BIGSERIAL`	8 byte	integer auto-increment besar	1 sampai 9223372036854775807

Tipe range: int4range, int8range, numrange.

2.2 Tipe Tanggal/Waktu

Nama	Ukuran	Deskripsi
`TIMESTAMP without time zone`	8 byte	tanggal dan waktu tanpa zona waktu
`TIMESTAMP with time zone`	8 byte	tanggal dan waktu dengan zona waktu
`DATE`	4 byte	tanggal tanpa jam
`TIME without time zone`	8 byte	waktu tanpa tanggal
`TIME with time zone`	12 byte	waktu dengan zona waktu
`INTERVAL`	16 byte	interval waktu

Tipe range: tsrange, tstzrange, daterange.

2.3 Tipe Geometrik

Nama	Ukuran	Deskripsi	Representasi
`point`	16 byte	titik pada bidang	`(x,y)`
`line`	32 byte	garis tak hingga	`{A,B,C}`
`lseg`	32 byte	segmen garis	`((x1,y1),(x2,y2))`
`box`	32 byte	kotak persegi panjang	`((x1,y1),(x2,y2))`
`path`	16+16n byte	path tertutup/terbuka	`((x1,y1),...)` atau `[(x1,y1),...]`
`polygon`	40+16n byte	poligon	`((x1,y1),...)`
`circle`	24 byte	lingkaran	`<(x,y),r>`

2.4 Tipe Alamat Jaringan

Nama	Ukuran	Deskripsi
`CIDR`	7 atau 19 byte	jaringan IPv4/IPv6
`INET`	7 atau 19 byte	host dan jaringan IPv4/IPv6
`macaddr`	6 byte	alamat MAC

2.5 Tipe Karakter

Nama	Deskripsi
`character varying(n)`, `varchar(n)`	panjang variabel dengan batas
`character(n)`, `char(n)`	panjang tetap, dipenuhi spasi
`text`	panjang tidak terbatas

2.6 Array

PostgreSQL dapat membuat array dari tipe bawaan, tipe buatan pengguna, atau enum.

Deklarasi:

SELECT INTEGER[];
SELECT INTEGER[3];
SELECT INTEGER[][];
SELECT INTEGER[3][3];
SELECT INTEGER ARRAY;
SELECT INTEGER ARRAY[3];

Membuat array:

SELECT '{0,1,2}';
SELECT '{{0,1},{1,2}}';
SELECT ARRAY[0,1,2];
SELECT ARRAY[ARRAY[0,1], ARRAY[1,2]];

Mengakses array:

WITH arr AS (SELECT ARRAY[0,1,2] int_arr)
SELECT int_arr[1] FROM arr;

Slicing array:

WITH arr AS (SELECT ARRAY[0,1,2] int_arr)
SELECT int_arr[1:2] FROM arr;

Informasi array:

WITH arr AS (SELECT ARRAY[0,1,2] int_arr)
SELECT ARRAY_DIMS(int_arr) FROM arr;

WITH arr AS (SELECT ARRAY[0,1,2] int_arr)
SELECT ARRAY_LENGTH(int_arr, 1) FROM arr;

WITH arr AS (SELECT ARRAY[0,1,2] int_arr)
SELECT cardinality(int_arr) FROM arr;

Bab 3: Tanggal, Timestamp, dan Interval

3.1 SELECT hari terakhir bulan

SELECT (DATE_TRUNC('MONTH', ('201608' || '01')::DATE) + INTERVAL '1 MONTH - 1 day')::DATE;

201608 dapat diganti dengan variabel.

3.2 Mengubah timestamp atau interval menjadi string

SELECT TO_CHAR('2016-08-12 16:40:32'::TIMESTAMP, 'DD Mon YYYY HH:MI:SSPM');

Hasil:

12 Aug 2016 04:40:32PM

Teks biasa di format sebaiknya diletakkan dalam tanda kutip ganda:

SELECT TO_CHAR(
  '2016-08-12 16:40:32'::TIMESTAMP,
  '"Today is "FMDay", the "DDth" day of the month of "FMMonth" of "YYYY'
);

Mode translasi lokal dapat memakai modifier TM:

SELECT TO_CHAR('2016-08-12 16:40:32'::TIMESTAMP, 'TMDay, DD" de "TMMonth" del año "YYYY');

3.3 Menghitung jumlah record per minggu

SELECT DATE_TRUNC('week', <>) AS "Week", COUNT(*)
FROM <>
GROUP BY 1
ORDER BY 1;

Bab 4: Pembuatan Tabel

4.1 Menampilkan definisi tabel

Di psql:

\d tablename
\d+ tablename

Jika lupa nama tabel:

\d

4.2 Membuat tabel dari SELECT

CREATE TABLE person (
    person_id BIGINT NOT NULL,
    last_name VARCHAR(255) NOT NULL,
    first_name VARCHAR(255),
    age INT NOT NULL,
    PRIMARY KEY (person_id)
);

CREATE TABLE people_over_30 AS
SELECT * FROM person WHERE age > 30;

4.3 Membuat unlogged table

Unlogged table lebih cepat karena melewati penulisan WAL, tetapi tidak aman terhadap crash dan tidak dapat direplikasi.

CREATE UNLOGGED TABLE person (
    person_id BIGINT NOT NULL PRIMARY KEY,
    last_name VARCHAR(255) NOT NULL,
    first_name VARCHAR(255),
    address VARCHAR(255),
    city VARCHAR(255)
);

4.4 Tabel dengan Primary Key

CREATE TABLE person (
    person_id BIGINT NOT NULL,
    last_name VARCHAR(255) NOT NULL,
    first_name VARCHAR(255),
    address VARCHAR(255),
    city VARCHAR(255),
    PRIMARY KEY (person_id)
);

Atau langsung pada kolom:

CREATE TABLE person (
    person_id BIGINT NOT NULL PRIMARY KEY,
    last_name VARCHAR(255) NOT NULL,
    first_name VARCHAR(255),
    address VARCHAR(255),
    city VARCHAR(255)
);

Disarankan memakai nama tabel dan kolom huruf kecil. Jika memakai huruf besar, PostgreSQL mengharuskan nama tersebut selalu diapit tanda kutip ganda.

4.5 Membuat tabel yang mereferensikan tabel lain

CREATE TABLE agencies (
  id SERIAL PRIMARY KEY,
  name TEXT NOT NULL
);

CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  agency_id INTEGER NOT NULL REFERENCES agencies(id) DEFERRABLE INITIALLY DEFERRED
);

Bab 5: SELECT

5.1 SELECT menggunakan WHERE

Contoh tabel:

CREATE TABLE sch_test.user_table (
  id serial NOT NULL,
  username CHARACTER VARYING,
  pass CHARACTER VARYING,
  first_name CHARACTER varying(30),
  last_name CHARACTER varying(30),
  CONSTRAINT user_table_pkey PRIMARY KEY (id)
);

Sintaks:

SELECT * FROM schema_name.table_name WHERE <condition>;
SELECT field1, field2 FROM schema_name.table_name WHERE <condition>;

Contoh:

SELECT * FROM schema_name.table_name WHERE id = 1;
SELECT id FROM schema_name.table_name WHERE username = 'root' AND pass = 'toor';
SELECT first_name FROM schema_name.table_name WHERE id != 1;

Bab 6: Mencari Panjang String / Karakter

Gunakan char_length() atau character_length().

SELECT CHAR_LENGTH('ABCDE');
SELECT CHARACTER_LENGTH('ABCDE');

Keduanya menghasilkan:

Bab 7: COALESCE

COALESCE mengembalikan argumen pertama yang bukan NULL. Jika semua argumen NULL, hasilnya NULL.

SELECT COALESCE(NULL, NULL, 'HELLO WORLD');
SELECT COALESCE(NULL, NULL, 'first non null', NULL, NULL, 'second non null');
SELECT COALESCE(NULL, NULL, NULL);

Bab 8: INSERT

8.1 Insert data menggunakan COPY

COPY adalah mekanisme bulk insert PostgreSQL. Biasanya jauh lebih cepat daripada INSERT untuk ribuan baris.

Contoh data:

cat > sample_data.csv
1,Yogesh
2,Raunak
3,Varun
4,Kamal
5,Hari
6,Amit

Tabel tujuan:

CREATE TABLE copy_test(id INT, name varchar(8));

Import dari file:

COPY copy_test FROM '/path/to/file/sample_data.csv' DELIMITER ',';

Import dari STDIN:

COPY copy_test FROM STDIN DELIMITER ',';

Export ke file:

COPY copy_test TO 'path/to/file/sample_data.csv' DELIMITER ',';

8.2 Insert banyak baris

INSERT INTO person (name, age) VALUES
  ('john doe', 25),
  ('jane doe', 20);

8.3 INSERT data dan mengembalikan nilai

CREATE TABLE my_table (
  id serial NOT NULL,
  name CHARACTER VARYING,
  contact_number INTEGER,
  CONSTRAINT my_table_pkey PRIMARY KEY (id)
);

INSERT INTO my_table(name, contact_number)
VALUES ('USER', 8542621)
RETURNING id;

8.4 INSERT dasar

CREATE TABLE person (
    person_id BIGINT,
    name VARCHAR(255),
    age INT,
    city VARCHAR(255)
);

INSERT INTO person VALUES (1, 'john doe', 25, 'new york');
INSERT INTO person (name, age) VALUES ('john doe', 25);

8.5 Insert dari SELECT

INSERT INTO person
SELECT * FROM tmp_person WHERE age < 30;

Kolom hasil SELECT harus sesuai dengan kolom untuk INSERT.

8.6 UPSERT — `INSERT ... ON CONFLICT DO UPDATE`

Sejak PostgreSQL 9.5, tersedia UPSERT.

INSERT INTO my_table (name, contact_number)
VALUES ('one', 333)
RETURNING id;

INSERT INTO my_table VALUES (2, 'one', 333)
ON CONFLICT (id) DO UPDATE
SET name = my_table.name || ' changed to: "two" at ' || now()
RETURNING *;

8.7 SELECT data ke file

COPY my_table TO '/home/postgres/my_table.txt'
USING DELIMITERS '|'
WITH NULL AS 'null_string' CSV HEADER;

Bab 9: UPDATE

9.1 Update berdasarkan join dengan tabel lain

UPDATE person
SET state_code = cities.state_code
FROM cities
WHERE cities.city = city;

9.2 Update semua baris

UPDATE person SET planet = 'Earth';

9.3 Update baris dengan kondisi

UPDATE person SET state = 'NY' WHERE city = 'New York';

9.4 Update banyak kolom

UPDATE person
SET country = 'USA',
    state = 'NY'
WHERE city = 'New York';

Bab 10: Dukungan JSON

PostgreSQL mendukung tipe data JSON sejak versi 9.2. Operator penting:

-> mengembalikan nilai JSON.
->> mengembalikan nilai sebagai teks.

10.1 Menggunakan operator JSONB

Membuat database dan tabel:

DROP DATABASE IF EXISTS books_db;
CREATE DATABASE books_db WITH ENCODING='UTF8' TEMPLATE template0;

DROP TABLE IF EXISTS books;
CREATE TABLE books (
  id SERIAL PRIMARY KEY,
  client TEXT NOT NULL,
  data JSONb NOT NULL
);

Mengisi data:

INSERT INTO books(client, data) VALUES
(
  'Joe',
  '{ "title": "Siddhartha", "author": { "first_name": "Herman", "last_name": "Hesse" } }'
),
(
  'Jenny',
  '{ "title": "Dharma Bums", "author": { "first_name": "Jack", "last_name": "Kerouac" } }'
),
(
  'Jenny',
  '{ "title": "100 años de soledad", "author": { "first_name": "Gabo", "last_name": "Marquéz" } }'
);

Memilih nilai JSON:

SELECT client, data->'title' AS title FROM books;
SELECT client, data->'title' AS title, data->'author' AS author FROM books;
SELECT client, data->'author'->'last_name' AS author FROM books;

Filter:

SELECT client, data->'title' AS title
FROM books
WHERE data->'title' = '"Dharma Bums"';

SELECT client, data->'title' AS title
FROM books
WHERE data->'author'->>'last_name' = 'Kerouac';

Contoh dunia nyata

CREATE TABLE events (
  name varchar(200),
  visitor_id varchar(200),
  properties json,
  browser json
);

Contoh agregasi:

SELECT browser->>'name' AS browser,
       COUNT(browser)
FROM events
GROUP BY browser->>'name';

SELECT visitor_id,
       SUM(CAST(properties->>'amount' AS INTEGER)) AS total
FROM events
WHERE CAST(properties->>'amount' AS INTEGER) > 0
GROUP BY visitor_id;

SELECT AVG(CAST(browser->'resolution'->>'x' AS INTEGER)) AS width,
       AVG(CAST(browser->'resolution'->>'y' AS INTEGER)) AS height
FROM events;

10.2 Query dokumen JSON kompleks

CREATE TABLE mytable (data JSONB NOT NULL);
CREATE INDEX mytable_idx ON mytable USING gin (data jsonb_path_ops);

Contoh query:

SELECT data->>'name' FROM mytable WHERE data @> '{"name":"Alice"}';
SELECT data->>'name' FROM mytable WHERE data @> '{"emails":["alice1@test.com"]}';
SELECT data->>'name' FROM mytable WHERE data @> '{"events":[{"type":"anniversary"}]}';
SELECT data->>'name' FROM mytable WHERE data @> '{"locations":{"home":{"city":"London"}}}';

Performa `@>` dibanding `->` dan `->>`

Query dengan @> dapat memakai index GIN yang dibuat, sedangkan filter memakai data->'name' atau data->>'name' biasanya melakukan full table scan.

SELECT data FROM mytable WHERE data @> '{"name":"Alice"}';
SELECT data FROM mytable WHERE data->'name' = '"Alice"';
SELECT data FROM mytable WHERE data->>'name' = 'Alice';

10.3 Membuat tabel JSON murni

CREATE TABLE mytable (data JSONB NOT NULL);
CREATE INDEX mytable_idx ON mytable USING gin (data jsonb_path_ops);

Bab 11: Fungsi Agregat

11.1 Statistik sederhana: `min()`, `max()`, `avg()`

SELECT MIN(age), MAX(age), AVG(age)
FROM individuals;

11.2 `regr_slope(Y, X)`

regr_slope(Y, X) menghitung kemiringan garis regresi linear least-squares dari pasangan (X, Y). Contoh penggunaan: mencari kandidat memory leak dari tren pemakaian memori.

CREATE TABLE heap_histogram (
    histwhen TIMESTAMP WITHOUT TIME ZONE NOT NULL,
    class CHARACTER VARYING NOT NULL,
    bytes INTEGER NOT NULL
);

SELECT class,
       REGR_SLOPE(bytes, EXTRACT(epoch FROM histwhen)) AS slope
FROM public.heap_histogram
GROUP BY class
HAVING REGR_SLOPE(bytes, EXTRACT(epoch FROM histwhen)) > 0
ORDER BY slope DESC;

11.3 `string_agg(expression, delimiter)`

SELECT STRING_AGG(name, ', ') AS names, country
FROM individuals
GROUP BY country;

Bab 12: Common Table Expressions (`WITH`)

12.1 CTE dalam SELECT

WITH sales AS (
  SELECT
    orders.ordered_at,
    orders.user_id,
    SUM(orders.amount) AS total
  FROM orders
  GROUP BY orders.ordered_at, orders.user_id
)
SELECT
  sales.ordered_at,
  sales.total,
  users.name
FROM sales
JOIN users USING (user_id);

12.2 Menelusuri tree dengan `WITH RECURSIVE`

CREATE TABLE empl (
    name TEXT PRIMARY KEY,
    boss TEXT NULL REFERENCES empl(name)
        ON UPDATE CASCADE
        ON DELETE CASCADE
        DEFAULT NULL
);

WITH RECURSIVE t(level, path, boss, name) AS (
    SELECT 0, name, boss, name FROM empl WHERE boss IS NULL
    UNION
    SELECT
        level + 1,
        path || ' > ' || empl.name,
        empl.boss,
        empl.name
    FROM empl JOIN t ON empl.boss = t.name
)
SELECT * FROM t ORDER BY path;

Bab 13: Window Functions

13.1 Contoh umum

CREATE TABLE wf_example(i INT, t TEXT, ts timestamptz, b BOOLEAN);

SELECT *
  , DENSE_RANK() OVER (ORDER BY i) dist_by_i
  , LAG(t) OVER () prev_t
  , NTH_VALUE(i, 6) OVER () nth
  , COUNT(TRUE) OVER (PARTITION BY i) num_by_i
  , COUNT(TRUE) OVER () num_all
  , NTILE(3) OVER () ntile
FROM wf_example;

Penjelasan:

DENSE_RANK() OVER (ORDER BY i): memberi nomor per nilai berbeda.
LAG(t) OVER (): nilai sebelumnya dari kolom t.
NTH_VALUE(i, 6) OVER (): nilai kolom i pada baris ke-6 dalam window.
COUNT(TRUE) OVER (PARTITION BY i): jumlah baris untuk setiap nilai i.
COUNT(TRUE) OVER (): jumlah seluruh baris dalam window.
NTILE(3) OVER (): membagi window menjadi 3 bagian yang sebisa mungkin sama besar.

13.2 `dense_rank` vs `rank` vs `row_number`

SELECT i,
       DENSE_RANK() OVER (ORDER BY i),
       ROW_NUMBER() OVER (),
       RANK() OVER (ORDER BY i)
FROM wf_example;

dense_rank: memberi ranking tanpa celah antar nilai berbeda.
row_number: memberi nomor baris sesuai urutan hasil.
rank: ranking berdasarkan posisi baris; nilai sama mendapat ranking sama, lalu dapat menyisakan celah.

Bab 14: Query Rekursif

14.1 Jumlah bilangan bulat

WITH RECURSIVE t(n) AS (
    VALUES (1)
  UNION ALL
    SELECT n + 1 FROM t WHERE n < 100
)
SELECT SUM(n) FROM t;

Bab 15: Pemrograman dengan PL/pgSQL

15.1 Fungsi PL/pgSQL dasar

CREATE FUNCTION active_subscribers() RETURNS BIGINT AS $$
DECLARE
    subscribers INTEGER;
BEGIN
    SELECT COUNT(user_id) INTO subscribers
    FROM users
    WHERE subscribed;

    RETURN subscribers;
EXCEPTION
    WHEN undefined_table THEN
        RETURN NULL;
END;
$$ LANGUAGE plpgsql;

SELECT active_subscribers();

15.2 Custom exception

CREATE OR REPLACE FUNCTION s164() RETURNS void AS $$
BEGIN
  RAISE EXCEPTION USING
    message = 'S 164',
    detail = 'D 164',
    hint = 'H 164',
    errcode = 'P2222';
END;
$$ LANGUAGE plpgsql;

CREATE OR REPLACE FUNCTION s165() RETURNS void AS $$
BEGIN
  RAISE EXCEPTION '%', 'nothing specified';
END;
$$ LANGUAGE plpgsql;

15.3 Sintaks PL/pgSQL

CREATE [OR REPLACE] FUNCTION functionName (someParameter parameterType)
RETURNS DATATYPE AS $_block_name_$
DECLARE
    -- deklarasi
BEGIN
    -- proses
    -- return
END;
$_block_name_$ LANGUAGE plpgsql;

15.4 Blok `RETURNS`

Pilihan return:

Tipe data tunggal.
TABLE(column_name column_type, ...).
SETOF datatype atau SETOF table_column.

Bab 16: Inheritance

16.1 Membuat tabel anak

CREATE TABLE users (username TEXT, email TEXT);
CREATE TABLE simple_users () INHERITS (users);
CREATE TABLE users_with_password (password TEXT) INHERITS (users);

Hasil:

users: username, email
simple_users: username, email
users_with_password: username, email, password

Bab 17: Ekspor Header dan Data Tabel PostgreSQL ke CSV

17.1 Copy dari query

COPY (SELECT oid, relname FROM pg_class LIMIT 5) TO STDOUT;

17.2 Ekspor kolom tertentu ke CSV dengan header

COPY products(is_public, title, discount)
TO 'D:\csv_backup\products_db.csv'
DELIMITER ',' CSV HEADER;

COPY categories(name)
TO 'D:\csv_backup\categories_db.csv'
DELIMITER ',' CSV HEADER;

17.3 Backup tabel penuh ke CSV dengan header

COPY products
TO 'D:\csv_backup\products_db.csv'
DELIMITER ',' CSV HEADER;

COPY categories
TO 'D:\csv_backup\categories_db.csv'
DELIMITER ',' CSV HEADER;

Bab 18: Trigger dan Fungsi Trigger

Trigger dikaitkan dengan tabel atau view dan menjalankan fungsi tertentu ketika event terjadi.

18.1 Jenis trigger

Trigger dapat dijalankan:

BEFORE: sebelum operasi INSERT, UPDATE, atau DELETE.
AFTER: setelah operasi selesai.
INSTEAD OF: untuk operasi pada view.

Trigger dapat ditandai:

FOR EACH ROW: dipanggil untuk setiap baris yang berubah.
FOR EACH STATEMENT: dipanggil sekali untuk setiap statement.

Persiapan contoh

CREATE TABLE company (
    id SERIAL PRIMARY KEY NOT NULL,
    name TEXT NOT NULL,
    created_at TIMESTAMP,
    modified_at TIMESTAMP DEFAULT NOW()
);

CREATE TABLE log (
    id SERIAL PRIMARY KEY NOT NULL,
    table_name TEXT NOT NULL,
    table_id TEXT NOT NULL,
    description TEXT NOT NULL,
    created_at TIMESTAMP DEFAULT NOW()
);

Single insert trigger

CREATE OR REPLACE FUNCTION add_created_at_function()
RETURNS TRIGGER AS $BODY$
BEGIN
  NEW.created_at := NOW();
  RETURN NEW;
END
$BODY$ LANGUAGE plpgsql;

CREATE TRIGGER add_created_at_trigger
BEFORE INSERT ON company
FOR EACH ROW
EXECUTE PROCEDURE add_created_at_function();

Trigger untuk banyak operasi

CREATE OR REPLACE FUNCTION add_log_function()
RETURNS TRIGGER AS $BODY$
DECLARE
  vDescription TEXT;
  vId INT;
  vReturn RECORD;
BEGIN
  vDescription := TG_TABLE_NAME || ' ';

  IF (TG_OP = 'INSERT') THEN
    vId := NEW.id;
    vDescription := vDescription || 'added. Id: ' || vId;
    vReturn := NEW;
  ELSIF (TG_OP = 'UPDATE') THEN
    vId := NEW.id;
    vDescription := vDescription || 'updated. Id: ' || vId;
    vReturn := NEW;
  ELSIF (TG_OP = 'DELETE') THEN
    vId := OLD.id;
    vDescription := vDescription || 'deleted. Id: ' || vId;
    vReturn := OLD;
  END IF;

  INSERT INTO log(table_name, table_id, description, created_at)
  VALUES (TG_TABLE_NAME, vId, vDescription, NOW());

  RETURN vReturn;
END
$BODY$ LANGUAGE plpgsql;

CREATE TRIGGER add_log_trigger
AFTER INSERT OR UPDATE OR DELETE ON company
FOR EACH ROW
EXECUTE PROCEDURE add_log_function();

18.2 Fungsi trigger PL/pgSQL dasar

CREATE OR REPLACE FUNCTION my_simple_trigger_function()
RETURNS TRIGGER AS $BODY$
BEGIN
  IF (TG_TABLE_NAME = 'users') THEN
    IF (TG_OP = 'INSERT') THEN
      INSERT INTO log_table(date_and_time, description)
      VALUES (NOW(), 'New user inserted. User ID: ' || NEW.id);
      RETURN NEW;
    ELSIF (TG_OP = 'DELETE') THEN
      INSERT INTO log_table(date_and_time, description)
      VALUES (NOW(), 'User deleted. User ID: ' || OLD.id);
      RETURN OLD;
    END IF;
    RETURN NULL;
  END IF;
END;
$BODY$ LANGUAGE plpgsql VOLATILE COST 100;

CREATE TRIGGER my_trigger
AFTER INSERT OR DELETE ON users
FOR EACH ROW
EXECUTE PROCEDURE my_simple_trigger_function();

Bab 19: Event Trigger

Event trigger dijalankan ketika event database tertentu terjadi.

Event umum:

DDL_COMMAND_START
DDL_COMMAND_END
SQL_DROP

19.1 Logging event awal command DDL

CREATE TABLE tab_event_logs(
  date_time TIMESTAMP,
  event_name TEXT,
  remarks TEXT
);

CREATE OR REPLACE FUNCTION fn_log_event()
RETURNS EVENT_TRIGGER
LANGUAGE SQL
AS $main$
  INSERT INTO tab_event_logs(date_time, event_name, remarks)
  VALUES (NOW(), TG_TAG, 'Event Logging');
$main$;

CREATE EVENT TRIGGER trg_log_event
ON DDL_COMMAND_START
EXECUTE PROCEDURE fn_log_event();

Bab 20: Manajemen Role

20.1 Membuat user dengan password

Sebaiknya hindari memakai role default seperti postgres di aplikasi. Buat user dengan privilege lebih rendah.

CREATE ROLE niceusername WITH PASSWORD 'very-strong-password' LOGIN;

Agar password tidak tersimpan di history psql, gunakan:

CREATE ROLE niceusername WITH LOGIN;
\password niceusername

20.2 Grant dan Revoke privilege

Contoh role:

admin: administrator database.
read_write: aplikasi dengan akses penuh pada datanya.
read_only: akses baca saja.

Akses database:

REVOKE CONNECT ON DATABASE nova FROM PUBLIC;
GRANT CONNECT ON DATABASE nova TO user_name;

Akses schema:

REVOKE ALL ON SCHEMA public FROM PUBLIC;
GRANT USAGE ON SCHEMA public TO user_name;

Akses tabel:

REVOKE ALL ON ALL TABLES IN SCHEMA public FROM PUBLIC;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO read_only;
GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA public TO read_write;
GRANT ALL ON ALL TABLES IN SCHEMA public TO admin;

Akses sequence:

REVOKE ALL ON ALL SEQUENCES IN SCHEMA public FROM PUBLIC;
GRANT SELECT ON ALL SEQUENCES IN SCHEMA public TO read_only;
GRANT UPDATE ON ALL SEQUENCES IN SCHEMA public TO read_write;
GRANT USAGE ON ALL SEQUENCES IN SCHEMA public TO read_write;
GRANT ALL ON ALL SEQUENCES IN SCHEMA public TO admin;

20.3 Membuat role dan database yang sesuai

createuser -P blogger
createdb -O blogger blogger

Contoh pg_hba.conf:

host    sameuser        all     localhost    md5
local   sameuser        all                  md5

20.4 Mengubah default `search_path` user

SHOW search_path;
ALTER USER user1 SET search_path='my_schema, "$user", public';
SHOW search_path;

Alternatif:

SET ROLE user1;
SHOW search_path;

20.5 Membuat read-only user

CREATE USER readonly WITH ENCRYPTED PASSWORD 'yourpassword';
GRANT CONNECT ON DATABASE <database_name> TO readonly;
GRANT USAGE ON SCHEMA public TO readonly;
GRANT SELECT ON ALL SEQUENCES IN SCHEMA public TO readonly;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO readonly;

20.6 Grant privilege untuk object masa depan

ALTER DEFAULT PRIVILEGES IN SCHEMA myschema
GRANT SELECT ON TABLES TO read_only;

ALTER DEFAULT PRIVILEGES IN SCHEMA myschema
GRANT SELECT, INSERT, DELETE, UPDATE ON TABLES TO read_write;

ALTER DEFAULT PRIVILEGES IN SCHEMA myschema
GRANT ALL ON TABLES TO admin;

ALTER DEFAULT PRIVILEGES FOR ROLE admin
GRANT SELECT ON TABLES TO read_only;

Bab 21: Fungsi Kriptografi PostgreSQL

Fungsi kriptografi tersedia melalui module pgcrypto.

CREATE EXTENSION pgcrypto;

21.1 `digest`

digest() membuat hash biner dari data.

SELECT DIGEST('1', 'sha1');
SELECT DIGEST(CONCAT(CAST(CURRENT_TIMESTAMP AS TEXT), RANDOM()::TEXT), 'sha1');

Bab 22: Komentar di PostgreSQL

COMMENT digunakan untuk mendefinisikan atau mengubah komentar pada object database.

22.1 Komentar pada tabel

COMMENT ON TABLE table_name IS 'this is student details table';

22.2 Menghapus komentar

COMMENT ON TABLE student IS NULL;

Bab 23: Backup dan Restore

23.1 Backup satu database

Custom format:

pg_dump -Fc -f DATABASE.pgsql DATABASE

Format SQL biasa:

pg_dump -f DATABASE.sql DATABASE
pg_dump DATABASE > DATABASE.sql

23.2 Restore backup

psql < backup.sql
psql -1f backup.sql
pg_restore -d DATABASE DATABASE.pgsql
pg_restore backup.pgsql > backup.sql

Custom format direkomendasikan karena dapat memilih object yang dipulihkan dan mendukung parallel processing.

23.3 Backup seluruh cluster

pg_dumpall -f backup.sql
postgres-backup-$(date +%Y-%m-%d).sql

Catatan: backup harian dapat menghasilkan file besar. PostgreSQL memiliki mekanisme backup reguler yang lebih baik seperti WAL archiving.

Untuk backup filesystem:

SELECT pg_start_backup('my-backup');
SELECT pg_stop_backup();

File konfigurasi seperti pg_hba.conf dan postgresql.conf harus dibackup terpisah.

23.4 Menggunakan `psql` untuk export data

psql -p 5432 -U postgres -d test_database -A -F, -c "select * from user" > /home/USER/user_data.csv

-F: delimiter.
-A / --no-align: output tanpa alignment.

23.5 Menggunakan COPY untuk import

COPY <tablename> FROM '<filename with path>';
COPY user FROM '/home/user/user_data.csv';
COPY user FROM '/home/user/user_data' WITH DELIMITER '|';
COPY user FROM '/home/user/user_data' WITH DELIMITER '|' HEADER;

23.6 Menggunakan COPY untuk export

COPY <tablename> TO STDOUT (DELIMITER '|');
COPY user TO STDOUT (DELIMITER '|');
COPY (SELECT * FROM user WHERE user_name LIKE 'A%') TO '/home/user/user_data';
COPY user TO PROGRAM 'gzip > /home/user/user_data.gz';

Bab 24: Skrip Backup untuk Database Produksi

Parameter:

Parameter	Keterangan
`save_db`	direktori backup utama
`dbProd`	direktori backup sekunder
`DATE`	tanggal backup
`dbprod`	nama database
`pg_dump`	path binary `pg_dump`
`-h`	host server
`-p`	port
`-U`	username koneksi

24.1 `saveProdDb.sh`

#!/bin/sh
cd /save_db
DATE=$(date +%d-%m-%Y-%Hh%M)
echo -e "Sauvegarde de la base du ${DATE}"
mkdir prodDir${DATE}
cd prodDir${DATE}

# dump file
/opt/postgres/9.0/bin/pg_dump -i -h localhost -p 5432 -U postgres -F c -b -w -v -f "dbprod${DATE}.backup" dbprod

# SQL file
/opt/postgres/9.0/bin/pg_dump -i -h localhost -p 5432 -U postgres --format plain --verbose -f "dbprod${DATE}.sql" dbprod

Bab 25: Mengakses Data Secara Programatis

25.1 Mengakses PostgreSQL dengan C-API

C-API memakai library client PostgreSQL libpq.

Kompilasi di GNU C:

gcc -Wall -I "$(pg_config --includedir)" -L "$(pg_config --libdir)" -o coltype coltype.c -lpq

Program C biasanya:

Membuka koneksi dengan PQconnectdb.
Mengecek status dengan PQstatus.
Menjalankan query dengan PQexecParams.
Membaca hasil dengan PQntuples, PQnfields, PQfname, dan PQgetvalue.
Membersihkan hasil dengan PQclear.
Menutup koneksi dengan PQfinish.

25.2 Mengakses PostgreSQL dari Python dengan `psycopg2`

import psycopg2

db_host = 'postgres.server.com'
db_port = '5432'
db_un = 'user'
db_pw = 'password'
db_name = 'testdb'

conn = psycopg2.connect(
    "dbname={} host={} user={} password={}".format(db_name, db_host, db_un, db_pw)
)
cur = conn.cursor()
sql = 'select * from testtable where id > %s and id < %s'
args = (1, 4)
cur.execute(sql, args)
print(cur.fetchall())

25.3 Mengakses PostgreSQL dari .NET dengan Npgsql

var connString = "Host=myserv;Username=myuser;Password=mypass;Database=mydb";
using (var conn = new NpgsqlConnection(connString))
{
    var querystring = "INSERT INTO data (some_field) VALUES (@content)";
    conn.Open();
    using (var cmd = new NpgsqlCommand(querystring, conn))
    {
        var contentString = "Hello World!";
        cmd.Parameters.Add("@content", NpgsqlDbType.Text).Value = contentString;
        cmd.ExecuteNonQuery();
    }
}

25.4 Mengakses PostgreSQL dari PHP menggunakan Pomm2

Pomm menyediakan pendekatan modular, converter data, dukungan listen/notify, inspector database, dan lain-lain.

Query manager Pomm melakukan escaping argument query untuk mencegah SQL injection. Jika argument di-cast, Pomm juga mengonversinya dari representasi PHP menjadi nilai PostgreSQL valid.

Bab 26: Koneksi PostgreSQL dari Java

Java memakai JDBC untuk database relasional. API JDBC diimplementasikan oleh driver JDBC. Letakkan file JAR driver pada Java class path.

26.1 Koneksi dengan `java.sql.DriverManager`

private static java.sql.Connection connect(String url, String user, String password)
    throws ClassNotFoundException, java.sql.SQLException {

    Class.forName("org.postgresql.Driver");
    return java.sql.DriverManager.getConnection(url, user, password);
}

user dan password juga dapat dimasukkan dalam JDBC URL.

26.2 Koneksi dengan `DriverManager` dan `Properties`

private static java.sql.Connection connect(String url, String user, String password)
    throws ClassNotFoundException, java.sql.SQLException {

    Class.forName("org.postgresql.Driver");

    java.util.Properties props = new java.util.Properties();
    props.setProperty("user", user);
    props.setProperty("password", password);
    props.setProperty("prepareThreshold", "0");

    return java.sql.DriverManager.getConnection(url, props);
}

26.3 Koneksi dengan `javax.sql.DataSource` dan connection pool

private static javax.sql.DataSource createDataSource(String url, String user, String password) {
    org.postgresql.ds.PGPoolingDataSource ds = new org.postgresql.ds.PGPoolingDataSource();
    ds.setUrl(url);
    ds.setUser(user);
    ds.setPassword(password);
    ds.setInitialConnections(10);
    ds.setMaxConnections(20);
    ds.setSslMode("require");
    ds.setSslfactory("org.postgresql.ssl.NonValidatingFactory");
    return ds;
}

Pemakaian:

java.sql.Connection conn = ds.getConnection();
// lakukan pekerjaan
conn.close(); // mengembalikan koneksi ke pool

Bab 27: PostgreSQL High Availability

27.1 Replikasi di PostgreSQL

Konfigurasi primary server

Kebutuhan:

User replikasi.
Direktori untuk menyimpan WAL archive.

Membuat user replikasi:

createuser -U postgres replication -P -c 5 --replication

Membuat direktori archive:

mkdir $PGDATA/archive

Tambahkan pada pg_hba.conf:

host    replication    replication    <slave-IP>/32    md5

Edit postgresql.conf:

wal_level = hot_standby
archive_mode = on
archive_command = 'test ! -f /path/to/archivedir/%f && cp %p /path/to/archivedir/%f'
wal_senders = 5

Restart primary server.

Backup primary ke standby

Jalankan pg_basebackup:

pg_basebackup -h <PRIMARY IP> -D /var/lib/postgresql/<VERSION>/main -U replication -v -P --xlog-method=stream

Keterangan:

-D: lokasi backup awal.
-h: host primary server.
--xlog-method=stream: membuka koneksi lain untuk streaming xlog selama backup.

Konfigurasi standby server

Pada postgresql.conf:

hot_standby = on

Buat recovery.conf:

standby_mode = on
primary_conninfo = 'host=<PRIMARY_IP> port=5432 user=replication password=<PASSWORD>'
trigger_file = '/tmp/postgresql.trigger.5432'

trigger_file dapat digunakan untuk memicu failover. Alternatifnya, gunakan pg_ctl promote.

Bab 28: Extension `dblink` dan `postgres_fdw`

28.1 Extension FDW

CREATE EXTENSION postgres_fdw;

CREATE SERVER name_srv
FOREIGN DATA WRAPPER postgres_fdw
OPTIONS (host 'hostname', dbname 'bd_name', port '5432');

CREATE USER MAPPING FOR postgres
SERVER name_srv
OPTIONS (user 'postgres', password 'password');

CREATE FOREIGN TABLE table_foreign (
  id INTEGER,
  code CHARACTER VARYING
)
SERVER name_srv
OPTIONS (schema_name 'schema', table_name 'table');

SELECT * FROM table_foreign;

28.2 Foreign Data Wrapper untuk schema lengkap

CREATE EXTENSION postgres_fdw;

CREATE SERVER server_name
FOREIGN DATA WRAPPER postgres_fdw
OPTIONS (host 'host_ip', dbname 'db_name', port 'port_number');

CREATE USER MAPPING FOR CURRENT_USER
SERVER server_name
OPTIONS (user 'user_name', password 'password');

CREATE SCHEMA schema_name;

IMPORT FOREIGN SCHEMA schema_name_to_import_from_remote_db
FROM SERVER server_name
INTO schema_name;

SELECT * FROM schema_name.table_name;

28.3 Extension `dblink`

CREATE EXTENSION dblink;

SELECT *
FROM dblink(
  'dbname=bd_distance port=5432 host=10.6.6.6 user=username password=passw@rd',
  'SELECT id, code FROM schema.table'
) AS newTable(id INTEGER, code CHARACTER VARYING);

Bab 29: Tips dan Trik PostgreSQL

29.1 Alternatif `DATEADD` di PostgreSQL

SELECT CURRENT_DATE + '1 day'::INTERVAL;
SELECT '1999-12-11'::TIMESTAMP + '19 days'::INTERVAL;
SELECT '1 month'::INTERVAL + '1 month 3 days'::INTERVAL;

29.2 Nilai kolom dipisahkan koma

SELECT STRING_AGG(<TABLE_NAME>.<COLUMN_NAME>, ',')
FROM <SCHEMA_NAME>.<TABLE_NAME> T;

29.3 Menghapus record duplikat

DELETE FROM <SCHEMA_NAME>.<TABLE_NAME>
WHERE ctid NOT IN (
    SELECT MAX(ctid)
    FROM <SCHEMA_NAME>.<TABLE_NAME>
    GROUP BY <SCHEMA_NAME>.<TABLE_NAME>.*
);

29.4 Update dengan join antar dua tabel

UPDATE <SCHEMA_NAME>.<TABLE_NAME_1> AS A
SET <COLUMN_1> = TRUE
FROM <SCHEMA_NAME>.<TABLE_NAME_2> AS B
WHERE A.<COLUMN_2> = B.<COLUMN_2>
  AND A.<COLUMN_3> = B.<COLUMN_3>;

29.5 Selisih dua timestamp dalam bulan dan tahun

Selisih bulan:

SELECT (
    (DATE_PART('year', AgeonDate) - DATE_PART('year', tmpdate)) * 12
    +
    (DATE_PART('month', AgeonDate) - DATE_PART('month', tmpdate))
)
FROM dbo."Table1";

Selisih tahun:

SELECT (DATE_PART('year', AgeonDate) - DATE_PART('year', tmpdate))
FROM dbo."Table1";

29.6 Copy/pindah data tabel antar database dengan schema sama

CREATE EXTENSION dblink;

INSERT INTO <SCHEMA_NAME>.<TABLE_NAME_1>
SELECT *
FROM dblink(
    'HOST=<IP-ADDRESS> USER=<USERNAME> PASSWORD=<PASSWORD> DBNAME=<DATABASE>',
    'SELECT * FROM <SCHEMA_NAME>.<TABLE_NAME_2>'
) AS <TABLE_NAME> (
    <COLUMN_1> <DATATYPE_1>,
    <COLUMN_2> <DATATYPE_2>,
    <COLUMN_3> <DATATYPE_3>
);

Kredit

Terima kasih kepada para kontributor Stack Overflow Documentation yang menyediakan materi untuk buku ini. Beberapa nama kontributor yang tercantum dalam dokumen sumber antara lain Alison S, Andrew Cichocki, ankidaemon, AstraSerg, Ben, Ben H, bignose, Blackus, chalitha geekiyanage, commonSenseCode, Dakota Wagner, Daniel Lyons, Demircan Celebi, Dmitri Goldring, e4c5, evuez, Goerman, gpdude_, greg, Jakub Fedyczak, jasonszhao, Jefferson, jgm, joseph, Kevin Sylvestre, KIM, KIRAN KUMAR MATAM, Laurenz Albe, leeor, Mohamed Navas, Mokadillion, Nathaniel Waisbrot, Nuri Tasdemir, Patrick, Reboot, Riya Bansal, Tajinder, Tom Gerken, Udlei Nati, user_0, Vao Tsun, wOwhOw, YCF_L, dan lainnya.

Catatan konversi

Struktur bab dan subbab dipertahankan.
Kode/perintah dipertahankan dalam bahasa aslinya.
Istilah teknis umum seperti role, trigger, schema, backup, restore, query, index, dan extension dipertahankan bila lebih lazim dalam ekosistem PostgreSQL.

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/postgresql-notes-for-professionals/

Aplikasi Bengkel Project Doc

Ngopidulur — Mon, 25 May 2026 22:19:00 GMT

Dokumentasi Aplikasi Bengkel Home Service

Gambaran Umum

Bengkel Home Service (ASM MOTOR) adalah aplikasi booking servis motor panggilan berbasis web. Pelanggan dapat memesan layanan servis motor (ganti oli, tune up, perbaikan ringan) yang dikerjakan langsung di lokasi pelanggan oleh mekanik keliling.

Tujuan Aplikasi

Menyediakan platform booking online untuk servis motor home service
Mengelola paket layanan dan item servis custom
Menghitung biaya transport berdasarkan jarak
Memvalidasi area coverage layanan
Menyediakan dashboard admin untuk manajemen booking dan analitik

Lokasi Operasional

Karawang, Jawa Barat, Indonesia (area coverage mencakup Karawang Barat, Timur, Kota, dan sekitarnya dalam radius operasional).

Tech Stack

Backend

Teknologi	Versi	Keterangan
PHP	8.4	Runtime
Laravel	13	Framework utama
Inertia.js	3	Bridge server-client
Fortify	1	Autentikasi
Wayfinder	0.x	Typed route generation
Pest	4	Testing framework
Pint	1	Code formatter
Sail	1	Docker dev environment

Frontend

Teknologi	Versi	Keterangan
Svelte	5	UI framework
Tailwind CSS	4	Utility-first CSS
Vite	8	Build tool
Leaflet	1.9	Peta interaktif
Lucide Svelte	0.468	Icon library
bits-ui	2.15	Headless UI components
svelte-sonner	0.3	Toast notifications

Database

MySQL (default)
SQLite (development alternatif)

Instalasi & Setup

Prasyarat

PHP >= 8.3
Composer
Node.js & npm
MySQL / MariaDB
Git

Langkah Instalasi

# 1. Clone repository
git clone <repository-url>
cd aplikasi-bengkel

# 2. Install dependencies
composer install
npm install

# 3. Setup environment
cp .env.example .env
php artisan key:generate

# 4. Konfigurasi database di .env
# DB_CONNECTION=mysql
# DB_HOST=127.0.0.1
# DB_PORT=3306
# DB_DATABASE=aplikasi_bengkel
# DB_USERNAME=root
# DB_PASSWORD=

# 5. Jalankan migrasi dan seeder
php artisan migrate
php artisan db:seed

# 6. Build frontend assets
npm run build

# 7. Jalankan development server
composer run dev
# Atau manual:
# php artisan serve
# npm run dev (di terminal terpisah)

Shortcut Setup (Composer Script)

composer run setup

Script ini otomatis menjalankan: install dependencies, copy .env, generate key, migrate, install npm, dan build assets.

Environment Variables Penting

Variable	Keterangan	Default
`APP_NAME`	Nama aplikasi	Bengkel Home Service
`APP_TIMEZONE`	Timezone	Asia/Jakarta
`APP_LOCALE`	Locale	id
`WORKSHOP_CONTACT_PHONE`	Nomor telepon bengkel	-
`WORKSHOP_CONTACT_WHATSAPP`	Nomor WhatsApp bengkel	-
`WORKSHOP_FOOTER_ADDRESS`	Alamat bengkel	Jl. Badami Ciherang...
`WORKSHOP_FOOTER_LATITUDE`	Latitude lokasi bengkel	-6.3025000
`WORKSHOP_FOOTER_LONGITUDE`	Longitude lokasi bengkel	107.3035000
`WORKSHOP_TRANSPORT_FREE_RADIUS_KM`	Radius gratis ongkir (km)	10
`WORKSHOP_TRANSPORT_FEE_PER_KM`	Biaya per km di luar radius	5000

Arsitektur Aplikasi

Struktur Direktori Utama

aplikasi-bengkel/
├── app/
│   ├── Actions/              # Business logic (single-responsibility)
│   │   ├── Booking/          # Aksi terkait booking
│   │   ├── CustomServiceItem/# Aksi item servis custom
│   │   ├── Fortify/          # Aksi autentikasi
│   │   ├── ServicePackage/   # Aksi paket servis
│   │   └── Visitor/          # Aksi tracking visitor
│   ├── Concerns/             # Shared traits
│   ├── Http/
│   │   ├── Controllers/
│   │   │   ├── Admin/        # Controller panel admin
│   │   │   ├── Public/       # Controller halaman publik
│   │   │   └── Settings/     # Controller pengaturan user
│   │   ├── Middleware/       # HTTP middleware
│   │   └── Requests/         # Form request validation
│   ├── Models/               # Eloquent models
│   └── Support/
│       └── Enums/            # PHP enums
├── config/
│   ├── booking.php           # Konfigurasi booking
│   └── workshop.php          # Konfigurasi bengkel
├── database/
│   ├── factories/            # Model factories
│   ├── migrations/           # Database migrations
│   └── seeders/              # Database seeders
├── resources/
│   └── js/
│       ├── components/       # Svelte components
│       │   ├── admin/        # Komponen admin
│       │   ├── public/       # Komponen publik
│       │   └── ui/           # UI primitives (shadcn-svelte)
│       ├── layouts/          # Layout templates
│       └── pages/            # Inertia pages
│           ├── admin/        # Halaman admin
│           ├── auth/         # Halaman autentikasi
│           ├── public/       # Halaman publik
│           └── settings/     # Halaman pengaturan
├── routes/
│   ├── web.php               # Route utama
│   └── settings.php          # Route pengaturan
└── tests/
    ├── Feature/              # Feature tests
    └── Unit/                 # Unit tests

Pola Arsitektur

Actions Pattern

Aplikasi menggunakan pola Actions untuk memisahkan business logic dari controller. Setiap action adalah class dengan satu tanggung jawab tunggal.

app/Actions/Booking/
├── CalculateBookingPriceAction.php    # Hitung total harga booking
├── CalculateTransportChargeAction.php # Hitung biaya transport
├── CreateBookingAction.php            # Buat booking baru
├── DeleteBookingAction.php            # Hapus booking
├── GenerateBookingCodeAction.php      # Generate kode booking unik
├── GetBookingFooterLocationAction.php # Ambil lokasi footer
├── GetBookingServiceFeeAction.php     # Ambil biaya jasa
├── GetBookingTransportChargeSettingsAction.php # Ambil setting transport
├── GetPublicBookingPageDataAction.php # Data untuk halaman booking publik
├── UpdateBookingFooterLocationAction.php # Update lokasi footer
├── UpdateBookingNotesAction.php       # Update catatan booking
├── UpdateBookingServiceFeeAction.php  # Update biaya jasa
├── UpdateBookingStatusAction.php      # Update status booking
├── UpdateBookingTransportChargeAction.php # Update biaya transport
├── ValidateBookingSlotAction.php      # Validasi ketersediaan slot
└── ValidateCoverageAreaAction.php     # Validasi area coverage

Enums

// BookingStatus: pending, confirmed, on_the_way, completed, cancelled, rescheduled
// MotorcycleType: matic, bebek, sport, lainnya
// PackageType: fixed_package, custom_package

Price Snapshot

Saat booking dibuat, nama dan harga paket/item di-snapshot ke dalam record booking. Ini memastikan perubahan harga di masa depan tidak mempengaruhi booking yang sudah ada.

Database & Model

Entity Relationship Diagram (Konseptual)

┌─────────────────┐       ┌──────────────────────┐
│  ServicePackage │       │  ServicePackageItem   │
├─────────────────┤       ├──────────────────────┤
│ id              │──┐    │ id                   │
│ name            │  │    │ service_package_id   │──┐
│ slug            │  │    │ name                 │  │
│ short_description│  │    │ description          │  │
│ description     │  └───>│ display_order        │  │
│ price           │       └──────────────────────┘  │
│ duration_estimate│                                  │
│ is_active       │                                  │
│ display_order   │                                  │
└─────────────────┘                                  │
        │                                            │
        │ (nullable FK)                              │
        ▼                                            │
┌─────────────────────────────────────────────┐     │
│                  Booking                     │     │
├─────────────────────────────────────────────┤     │
│ id, booking_code                            │     │
│ customer_name, customer_email, customer_phone│     │
│ motorcycle_type, motorcycle_brand/model/year │     │
│ plate_number                                │     │
│ package_type, service_package_id            │◄────┘
│ package_name_snapshot, package_price_snapshot │
│ notes, service_date, service_time           │
│ status                                      │
│ subtotal_price, service_fee                 │
│ transport_distance_km, transport_charge     │
│ total_price                                 │
│ address_text, house_landmark                │
│ latitude, longitude                         │
│ admin_notes, requires_manual_review         │
│ confirmed_at, completed_at                  │
└─────────────────────────────────────────────┘
        │                    │
        │                    │
        ▼                    ▼
┌──────────────────┐  ┌──────────────────────┐
│ BookingCustomItem│  │  BookingStatusLog     │
├──────────────────┤  ├──────────────────────┤
│ id               │  │ id                   │
│ booking_id       │  │ booking_id           │
│ custom_service_  │  │ old_status           │
│   item_id        │  │ new_status           │
│ item_name_snapshot│  │ changed_by (user_id) │
│ item_price_snapshot│ │ note                 │
│ qty              │  └──────────────────────┘
│ subtotal         │
└──────────────────┘
        │
        │ (nullable FK)
        ▼
┌──────────────────────┐
│  CustomServiceItem   │
├──────────────────────┤
│ id                   │
│ name, slug           │
│ category             │
│ description          │
│ price                │
│ unit_label           │
│ is_active            │
│ display_order        │
└──────────────────────┘

┌──────────────────┐    ┌──────────────────┐
│  BookingSetting  │    │   VisitorLog     │
├──────────────────┤    ├──────────────────┤
│ id               │    │ id               │
│ service_fee      │    │ visit_date       │
│ transport_free_  │    │ ip_hash          │
│   radius_km      │    │ session_key      │
│ transport_fee_   │    │ path             │
│   per_km         │    │ referrer         │
│ footer_address   │    │ user_agent       │
│ footer_latitude  │    │ is_unique_daily  │
│ footer_longitude │    └──────────────────┘
└──────────────────┘

Deskripsi Tabel

`service_packages`

Paket layanan servis tetap yang ditawarkan bengkel.

Kolom	Tipe	Keterangan
name	string	Nama paket
slug	string (unique)	URL-friendly identifier
short_description	string(255)	Deskripsi singkat
description	text	Deskripsi lengkap
price	unsigned int	Harga dalam Rupiah
duration_estimate_minutes	unsigned int	Estimasi durasi (menit)
is_active	boolean	Status aktif
display_order	unsigned int	Urutan tampilan

`service_package_items`

Item-item yang termasuk dalam sebuah paket servis.

Kolom	Tipe	Keterangan
service_package_id	FK	Relasi ke service_packages
name	string	Nama item
description	text	Deskripsi item
display_order	unsigned int	Urutan tampilan

`custom_service_items`

Item servis satuan yang bisa dipilih pelanggan secara custom.

Kolom	Tipe	Keterangan
name	string	Nama item
slug	string (unique)	URL-friendly identifier
category	string	Kategori item
description	text	Deskripsi
price	unsigned int	Harga satuan (Rupiah)
unit_label	string	Label satuan (misal: "liter")
is_active	boolean	Status aktif
display_order	unsigned int	Urutan tampilan

`bookings`

Record booking pelanggan.

Kolom	Tipe	Keterangan
booking_code	string (unique)	Kode booking (prefix: ASM)
customer_name	string(100)	Nama pelanggan
customer_email	string(100)	Email pelanggan
customer_phone	string(30)	Nomor telepon
motorcycle_type	enum	Tipe motor (matic/bebek/sport/lainnya)
motorcycle_brand	string(100)	Merek motor
motorcycle_model	string(100)	Model motor
motorcycle_year	string(4)	Tahun motor
plate_number	string(20)	Nomor plat
package_type	enum	Tipe paket (fixed/custom)
service_package_id	FK (nullable)	Relasi ke paket tetap
package_name_snapshot	string	Snapshot nama paket saat booking
package_price_snapshot	unsigned int	Snapshot harga paket
notes	text	Catatan pelanggan
service_date	date	Tanggal servis
service_time	string(5)	Jam servis (HH:MM)
status	enum	Status booking
subtotal_price	unsigned int	Subtotal harga
service_fee	unsigned int	Biaya jasa
transport_distance_km	decimal(8,2)	Jarak transport (km)
transport_charge	unsigned int	Biaya transport
total_price	unsigned int	Total harga akhir
address_text	text	Alamat lengkap
house_landmark	string(255)	Patokan rumah
latitude	decimal(10,7)	Koordinat latitude
longitude	decimal(10,7)	Koordinat longitude
admin_notes	text	Catatan admin
requires_manual_review	boolean	Perlu review manual
confirmed_at	timestamp	Waktu konfirmasi
completed_at	timestamp	Waktu selesai

`booking_custom_items`

Item custom yang dipilih dalam sebuah booking.

Kolom	Tipe	Keterangan
booking_id	FK	Relasi ke bookings
custom_service_item_id	FK (nullable)	Relasi ke custom_service_items
item_name_snapshot	string	Snapshot nama item
item_price_snapshot	unsigned int	Snapshot harga item
qty	unsigned int	Jumlah
subtotal	unsigned int	Subtotal (harga × qty)

`booking_status_logs`

Audit trail perubahan status booking.

Kolom	Tipe	Keterangan
booking_id	FK	Relasi ke bookings
old_status	string (nullable)	Status sebelumnya
new_status	string	Status baru
changed_by	FK (nullable)	User yang mengubah
note	string(500)	Catatan perubahan

`booking_settings`

Pengaturan global booking (singleton row).

Kolom	Tipe	Keterangan
service_fee	unsigned int	Biaya jasa default
transport_free_radius_km	decimal	Radius gratis transport
transport_fee_per_km	unsigned int	Biaya per km
footer_address	string	Alamat footer
footer_latitude	decimal	Latitude footer
footer_longitude	decimal	Longitude footer

`visitor_logs`

Log kunjungan halaman (privacy-friendly, IP di-hash).

Kolom	Tipe	Keterangan
visit_date	date	Tanggal kunjungan
ip_hash	string(64)	Hash IP pengunjung
session_key	string(120)	Session identifier
path	string(255)	Path halaman
referrer	string(255)	Referrer URL
user_agent	text	User agent browser
is_unique_daily	boolean	Kunjungan unik harian

Fitur Utama

1. Landing Page Publik

Halaman utama yang menampilkan:

Hero section dengan tagline bengkel
Highlight layanan (Servis Rutin, Ganti Oli, Perbaikan Darurat)
Paket servis aktif dari database
Cara kerja booking (3 langkah)
Area coverage layanan
FAQ
Testimonial pelanggan
CTA menuju form booking

2. Sistem Booking

Alur Booking Pelanggan

Landing Page → Form Booking → Review → Submit → Halaman Sukses

Pilih Paket — Fixed package (paket tetap) atau custom package (pilih item sendiri)
Info Motor — Tipe, merek, model, tahun, plat nomor
Pilih Jadwal — Tanggal dan jam servis (slot tersedia: 08:00-16:00)
Tentukan Lokasi — Alamat, patokan rumah, pin di peta (Leaflet)
Review & Submit — Ringkasan harga termasuk biaya jasa dan transport

Validasi Booking

Slot Capacity: Maksimal 3 booking per slot waktu
Coverage Area: Bounding box check (latitude/longitude)
Rate Limiting: Maksimal 5 percobaan per 10 menit per device
Out-of-area: Booking di luar area otomatis ditandai requires_manual_review

Perhitungan Harga

Total = Subtotal Paket/Item + Service Fee + Transport Charge

Transport Charge:
- Jarak ≤ free_radius_km (default 10km) → Rp 0
- Jarak > free_radius_km → (jarak - free_radius) × fee_per_km (default Rp5.000/km)

3. Manajemen Booking (Admin)

Status Workflow

Pending → Confirmed → On The Way → Completed
    │         │
    └─────────┴──→ Cancelled
    │
    └──→ Rescheduled

Fitur admin:

Lihat daftar semua booking (filter, search)
Detail booking lengkap
Update status booking (dengan catatan)
Tambah admin notes
Hapus booking
Audit trail perubahan status

4. Manajemen Paket Servis (Admin)

CRUD paket servis (nama, deskripsi, harga, estimasi durasi)
Kelola item dalam paket (nama, deskripsi, urutan)
Aktivasi/deaktivasi paket
Pengaturan urutan tampilan

5. Manajemen Item Servis Custom (Admin)

CRUD item servis custom (nama, kategori, harga, satuan)
Deaktivasi item
Pengaturan urutan tampilan

6. Pengaturan Booking (Admin)

Service Fee: Biaya jasa yang ditambahkan ke setiap booking
Transport Charge: Radius gratis dan biaya per km
Footer Location: Alamat dan koordinat bengkel (titik awal perhitungan jarak)

7. Analitik Visitor

Tracking kunjungan halaman (privacy-friendly, IP di-hash)
Statistik kunjungan harian
Unique visitor per hari
Chart visualisasi

8. Autentikasi & Keamanan

Login admin (Laravel Fortify)
Two-Factor Authentication (2FA)
Password reset
Profile management
Session management

Routing & API

Route Publik

Method	URI	Nama	Keterangan
GET	`/`	home	Landing page
GET	`/booking`	bookings.create	Form booking
POST	`/bookings`	bookings.store	Submit booking
GET	`/booking/success`	bookings.success	Halaman sukses
GET	`/booking/{code}`	bookings.public.show	Detail booking publik

Route Admin (prefix: `/admin`, middleware: `auth`)

Method	URI	Nama	Keterangan
GET	`/admin/dashboard`	admin.dashboard	Dashboard
GET	`/admin/bookings`	admin.bookings.index	Daftar booking
GET	`/admin/bookings/{code}`	admin.bookings.show	Detail booking
PATCH	`/admin/bookings/{code}/status`	admin.bookings.update-status	Update status
PATCH	`/admin/bookings/{code}/notes`	admin.bookings.update-notes	Update catatan
DELETE	`/admin/bookings/{code}`	admin.bookings.destroy	Hapus booking
GET	`/admin/service-packages`	admin.service-packages.index	Daftar paket
POST	`/admin/service-packages`	admin.service-packages.store	Buat paket
GET	`/admin/service-packages/{id}/edit`	admin.service-packages.edit	Edit paket
PATCH	`/admin/service-packages/{id}`	admin.service-packages.update	Update paket
PATCH	`/admin/service-packages/{id}/activate`	admin.service-packages.activate	Aktifkan
PATCH	`/admin/service-packages/{id}/deactivate`	admin.service-packages.deactivate	Nonaktifkan
DELETE	`/admin/service-packages/{id}`	admin.service-packages.destroy	Hapus paket
GET	`/admin/custom-service-items`	admin.custom-service-items.index	Daftar item
POST	`/admin/custom-service-items`	admin.custom-service-items.store	Buat item
GET	`/admin/custom-service-items/{id}/edit`	admin.custom-service-items.edit	Edit item
PATCH	`/admin/custom-service-items/{id}`	admin.custom-service-items.update	Update item
PATCH	`/admin/custom-service-items/{id}/deactivate`	admin.custom-service-items.deactivate	Nonaktifkan
DELETE	`/admin/custom-service-items/{id}`	admin.custom-service-items.destroy	Hapus item
PATCH	`/admin/booking-settings/service-fee`	admin.booking-settings.service-fee	Update fee
PATCH	`/admin/booking-settings/footer-location`	admin.booking-settings.footer-location	Update lokasi
PATCH	`/admin/booking-settings/transport-charge`	admin.booking-settings.transport-charge	Update transport
GET	`/admin/visitors`	admin.visitors.index	Analitik visitor

Route Settings (middleware: `auth`)

Method	URI	Nama	Keterangan
GET	`/settings/profile`	profile.edit	Edit profil
PATCH	`/settings/profile`	profile.update	Update profil
DELETE	`/settings/profile`	profile.destroy	Hapus akun
GET	`/settings/security`	security.edit	Keamanan
PUT	`/settings/password`	user-password.update	Update password
GET	`/settings/appearance`	appearance.edit	Tampilan

Frontend

Halaman (Inertia Pages)

Publik (`resources/js/pages/public/`)

File	Keterangan
LandingPage.svelte	Halaman utama dengan info layanan
BookingPage.svelte	Form booking multi-step
BookingSummaryPage.svelte	Detail booking setelah submit
BookingSuccessPage.svelte	Konfirmasi booking berhasil

Admin (`resources/js/pages/admin/`)

File	Keterangan
DashboardPage.svelte	Dashboard statistik
BookingsIndexPage.svelte	Daftar semua booking
BookingDetailPage.svelte	Detail & manajemen booking
ServicePackagesPage.svelte	CRUD paket servis
CustomServiceItemsPage.svelte	CRUD item custom
VisitorsPage.svelte	Analitik pengunjung
auth/LoginPage.svelte	Halaman login admin

Settings (`resources/js/pages/settings/`)

File	Keterangan
Profile.svelte	Edit profil user
Security.svelte	Password & 2FA
Appearance.svelte	Tema tampilan

Komponen Utama

Komponen Publik (`resources/js/components/public/`)

Komponen	Keterangan
HeroSection	Banner utama landing page
ServiceHighlights	Highlight layanan
PackageCardsSection	Kartu paket servis
HowItWorksSection	Langkah-langkah booking
CoverageAreaSection	Peta area layanan
FaqSection	Frequently Asked Questions
TestimonialsSection	Testimoni pelanggan
BookingCtaSection	Call-to-action booking
BookingForm	Form booking utama
BookingPackageSelector	Pemilih paket
BookingCustomItemsSelector	Pemilih item custom
BookingMotorInfoFields	Input info motor
BookingSchedulePicker	Pemilih jadwal
BookingLocationPicker	Pemilih lokasi (peta)
BookingPriceSummary	Ringkasan harga
BookingReviewPanel	Panel review sebelum submit
PublicHeader	Header halaman publik
PublicFooter	Footer dengan peta

Komponen Admin (`resources/js/components/admin/`)

Komponen	Keterangan
AdminHeader	Header panel admin
AdminSidebar	Sidebar navigasi admin
BookingsTable	Tabel daftar booking
BookingDetailCard	Kartu detail booking
BookingStatusBadge	Badge status booking
StatusHistoryTimeline	Timeline riwayat status
BookingServiceFeeCard	Pengaturan biaya jasa
BookingTransportChargeCard	Pengaturan transport
BookingFooterLocationCard	Pengaturan lokasi
ServicePackageForm	Form paket servis
ServicePackageItemsEditor	Editor item paket
CustomServiceItemForm	Form item custom
DashboardStatCard	Kartu statistik dashboard
VisitorsChart	Chart pengunjung
CopyValueButton	Tombol salin nilai

UI Components (`resources/js/components/ui/`)

Menggunakan komponen headless dari bits-ui dengan styling Tailwind CSS (pola shadcn-svelte):

Alert, Avatar, Badge, Breadcrumb, Button, Card
Checkbox, Collapsible, Dialog, Dropdown Menu
Input, Input OTP, Label, Navigation Menu
Select, Separator, Sheet, Sidebar
Skeleton, Sonner (toast), Spinner, Tooltip

Testing

Framework

Pest v4 (PHP testing framework di atas PHPUnit)
Test runner: php artisan test --compact

Struktur Test

tests/
├── Feature/
│   ├── Admin/
│   │   ├── BookingFooterLocationManagementTest.php
│   │   ├── BookingManagementTest.php
│   │   ├── BookingServiceFeeManagementTest.php
│   │   ├── BookingTransportChargeManagementTest.php
│   │   ├── CustomServiceItemManagementTest.php
│   │   ├── ServicePackageManagementTest.php
│   │   └── VisitorAnalyticsTest.php
│   ├── Auth/
│   │   ├── AuthenticationTest.php
│   │   ├── EmailVerificationTest.php
│   │   ├── PasswordConfirmationTest.php
│   │   ├── PasswordResetTest.php
│   │   ├── RegistrationTest.php
│   │   ├── TwoFactorChallengeTest.php
│   │   └── VerificationNotificationTest.php
│   ├── Booking/
│   │   ├── BookingEmailConfirmationTest.php
│   │   ├── BookingPublicPagesTest.php
│   │   ├── BookingTransportChargeTest.php
│   │   └── StoreBookingTest.php
│   ├── Settings/
│   │   ├── ProfileUpdateTest.php
│   │   └── SecurityTest.php
│   └── Visitor/
│       └── TrackVisitorMiddlewareTest.php
├── Unit/
├── Browser/                    # Pest Browser tests (Playwright)
├── Pest.php
└── TestCase.php

Menjalankan Test

# Semua test
php artisan test --compact

# Filter test tertentu
php artisan test --compact --filter=StoreBookingTest

# Dengan coverage
php artisan test --coverage

Linting & Formatting

# PHP (Pint)
vendor/bin/pint --dirty --format agent

# JavaScript/Svelte (ESLint + Prettier)
npm run lint        # Fix lint issues
npm run lint:check  # Check only
npm run format      # Format files
npm run format:check # Check formatting

# TypeScript check
npm run types:check

CI/CD

GitHub Actions workflows tersedia di .github/workflows/:

lint.yml — Linting check
tests.yml — Test suite

Deployment

Prasyarat Production

PHP 8.3+ dengan ekstensi yang diperlukan
MySQL 8.0+
Node.js (untuk build assets)
Web server (Nginx/Apache)

Langkah Deploy

# 1. Install dependencies (production)
composer install --no-dev --optimize-autoloader
npm ci

# 2. Build frontend
npm run build

# 3. Optimize Laravel
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan event:cache

# 4. Migrasi database
php artisan migrate --force

# 5. Set permissions
chmod -R 775 storage bootstrap/cache

Laravel Cloud

Aplikasi ini dapat di-deploy menggunakan Laravel Cloud untuk deployment dan scaling yang lebih mudah.

Konfigurasi

`config/booking.php`

return [
    'code_prefix' => 'ASM',           // Prefix kode booking
    'max_per_slot' => 3,               // Maks booking per slot
    'default_service_fee' => 0,        // Biaya jasa default
    'slot_interval_minutes' => 60,     // Interval slot (menit)
    'available_hours' => [             // Jam operasional
        '08:00', '09:00', '10:00', '11:00',
        '13:00', '14:00', '15:00', '16:00',
    ],
    'rate_limit' => [
        'max_attempts' => 5,           // Maks percobaan
        'decay_seconds' => 600,        // Cooldown (detik)
    ],
];

`config/workshop.php`

return [
    'brand_name' => env('APP_NAME', 'ASM MOTOR'),
    'tagline' => 'Servis ringan motor panggilan...',
    'contact_phone' => env('WORKSHOP_CONTACT_PHONE'),
    'contact_whatsapp' => env('WORKSHOP_CONTACT_WHATSAPP'),
    'footer_location' => [
        'address' => env('WORKSHOP_FOOTER_ADDRESS'),
        'latitude' => env('WORKSHOP_FOOTER_LATITUDE'),
        'longitude' => env('WORKSHOP_FOOTER_LONGITUDE'),
    ],
    'transport_charge' => [
        'free_radius_km' => env('WORKSHOP_TRANSPORT_FREE_RADIUS_KM', '10'),
        'fee_per_km' => env('WORKSHOP_TRANSPORT_FEE_PER_KM', '5000'),
    ],
    'service_areas' => [...],          // Daftar area layanan
    'coverage' => [
        'bounding_box' => [            // Batas area coverage
            'min_latitude' => -6.75,
            'max_latitude' => -6.05,
            'min_longitude' => 106.55,
            'max_longitude' => 107.05,
        ],
    ],
    'landing' => [                     // Konten landing page
        'seo' => [...],
        'highlights' => [...],
        'how_it_works' => [...],
        'coverage' => [...],
        'faqs' => [...],
        'testimonials' => [...],
        'cta' => [...],
    ],
];

Seeder Data

Aplikasi menyediakan seeder untuk data awal:

php artisan db:seed

Seeder yang tersedia:

AdminSeeder — Membuat akun admin default
ServicePackageSeeder — Paket servis contoh
CustomServiceItemSeeder — Item servis custom contoh

Scripts Tersedia

Composer Scripts

Script	Keterangan
`composer run setup`	Setup lengkap project
`composer run dev`	Jalankan dev server (Laravel + Queue + Vite)
`composer run lint`	Format PHP dengan Pint
`composer run lint:check`	Check formatting PHP
`composer run test`	Jalankan semua test
`composer run ci:check`	Full CI check (lint + format + types + test)

NPM Scripts

Script	Keterangan
`npm run dev`	Vite dev server
`npm run build`	Build production assets
`npm run build:ssr`	Build dengan SSR
`npm run lint`	ESLint fix
`npm run lint:check`	ESLint check
`npm run format`	Prettier format
`npm run format:check`	Prettier check
`npm run types:check`	Svelte/TypeScript type check

Lisensi

MIT License

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/aplikasi-bengkel-project-doc/

Warehouse Queue App Project Doc

Ngopidulur — Fri, 22 May 2026 16:11:00 GMT

Terakhir diperbarui: 2026-05-22

1. Ringkasan

warehouse-queue-app adalah aplikasi operasional warehouse untuk mengelola:

antrian truk receiving dan delivery,
display publik antrian truk,
dashboard SLA dan laporan operasional,
master data customer, gate, admin, dan karyawan,
schedule pengiriman,
picking progress berbasis proses dan Excel import/export,
backup, restore, dan migrasi aplikasi antar perangkat Windows.

Project ini terdiri dari:

backend Node.js + Express + Prisma,
frontend Vue 3 + Vite + TypeScript,
database PostgreSQL,
reverse proxy dan static hosting lokal menggunakan Nginx di Windows.

2. Modul Utama

2.1 Antrian Truk

Modul ini dipakai untuk mencatat truk masuk dan mengawal status proses dari registrasi sampai selesai atau batal.

Fitur utama:

registrasi antrian receiving atau delivery,
assignment gate,
update status operasional,
catatan warehouse,
audit log perubahan status,
export Excel,
display publik untuk monitor antrian.

2.2 Dashboard

Dashboard menampilkan ringkasan operasional dan SLA, antara lain:

summary total antrian,
status distribution,
hourly trend,
top customer,
data over SLA,
monthly report,
schedule summary,
picking progress summary.

2.3 Master Data

Master data yang dikelola:

customer,
gate,
admin user,
employee.

2.4 Schedule Pengiriman

Schedule dipakai untuk perencanaan pengiriman berdasarkan tanggal, customer, store type, dan komposisi truck type.

2.5 Picking Progress

Modul ini dipakai untuk memonitor progres picking per DO, customer, destination, picker, dan target barcode/qty.

Fitur utama:

create/edit data picking,
start picking,
update picked quantity,
finish picking,
cancel picking,
import/export Excel,
print summary,
audit log perubahan.

3. Workflow Bisnis

3.1 Workflow Antrian Truk

Status utama antrian:

MENUNGGU -> IN_WH -> PROSES -> SELESAI

Status alternatif:

MENUNGGU/IN_WH -> BATAL

Aturan bisnis penting:

Entry baru selalu dibuat dengan status MENUNGGU.
Warehouse memanggil driver dan mengubah status menjadi IN_WH.
Warehouse memulai bongkar/muat dan mengubah status menjadi PROSES.
Saat pindah ke PROSES, Tallyman dapat dipilih. Jika diisi, employee harus ada di master karyawan dengan posisi TALLYMAN.
Entry dapat dibatalkan hanya sampai status IN_WH dan alasan cancel wajib diisi.
notesFromWh tidak bisa diubah jika status sudah SELESAI atau BATAL.
Backend menjalankan auto-complete setiap 1 jam. Data antrian berumur lebih dari 3 hari yang masih MENUNGGU, IN_WH, atau PROSES akan otomatis ditandai SELESAI oleh sistem.

flowchart LR
    A[CS/Admin input antrian] --> B[Status MENUNGGU]
    B --> C[Warehouse panggil driver]
    C --> D[Status IN_WH]
    D --> E[Warehouse proses bongkar atau muat]
    E --> F[Status PROSES]
    F --> G[Status SELESAI]
    B --> H[BATAL dengan alasan]
    D --> H

Sumber alur ini sejalan dengan diagram docs/flowchart-workflow-antrian-trucking.drawio.

3.2 Workflow Picking Progress

Status utama picking:

MENUNGGU -> ON_PROCESS -> SELESAI

Status alternatif:

MENUNGGU/ON_PROCESS -> BATAL

Aturan bisnis penting:

Data picking baru dibuat dengan status MENUNGGU.
Start hanya boleh dari status MENUNGGU.
Update pickedQty hanya boleh saat status ON_PROCESS.
Finish hanya boleh saat status ON_PROCESS dan pickedQty harus sama dengan pickingQty.
Cancel mewajibkan alasan.
notesFromWh tidak bisa diubah jika status sudah SELESAI atau BATAL.

flowchart LR
    A[Create atau import picking] --> B[Status MENUNGGU]
    B --> C[Start picking]
    C --> D[Status ON_PROCESS]
    D --> E[Update pickedQty]
    E --> F{pickedQty = pickingQty?}
    F -- Ya --> G[Finish]
    G --> H[Status SELESAI]
    F -- Belum --> E
    B --> I[BATAL dengan alasan]
    D --> I

3.3 Workflow Schedule Pengiriman

Alur high level schedule:

Admin atau CS membuat schedule pengiriman.
Schedule menyimpan tanggal, customer, store type, dan item truck type.
Data schedule dipakai untuk monitoring, export, print summary, dan dashboard bulanan.

4. Role dan Hak Akses

Role aplikasi:

ADMIN
WAREHOUSE
CS

Ringkasan akses utama:

Area	ADMIN	WAREHOUSE	CS
Dashboard	Ya	Ya	Ya
Queue list dan detail	Ya	Ya	Ya
Queue display publik	Publik	Publik	Publik
Create/update/status queue	Ya	Ya	Ya
Edit WH notes queue	Tidak	Ya	Tidak
Master customer	Ya	Tidak	Tidak
Master gate	CRUD	Read	Read
Master admin	Ya	Tidak	Tidak
Master karyawan	Ya	Tidak	Tidak
Picking progress list	Ya	Ya	Ya
Edit header picking	Ya	Tidak	Ya
Update WH notes picking	Tidak	Ya	Tidak
Schedule create/update/delete	Ya	Read only	Ya

Catatan implementasi:

Route frontend mengarahkan WAREHOUSE dan CS ke /antrian-truk setelah login.
Route publik tanpa login adalah /login dan /display/antrian-truk.
Token auth disimpan di localStorage dan dikirim sebagai Authorization: Bearer <token>.

5. Tech Stack

5.1 Backend

Node.js
Express 4
Prisma ORM 6
PostgreSQL
jsonwebtoken
bcryptjs
multer
exceljs
xlsx

5.2 Frontend

Vue 3
Vite 7
TypeScript
Vue Router 4
Axios
Tailwind CSS
Radix Vue
Chart.js
vue-chartjs

5.3 Infrastruktur Lokal Windows

Nginx for Windows
Docker Compose untuk PostgreSQL opsional
PowerShell untuk script operasional

6. Arsitektur Sistem

6.1 Arsitektur Runtime

flowchart TD
    A[Browser Client] --> B[Nginx Windows port 82]
    B --> C[Frontend dist /material-dashboard-shadcn-vue/]
    B --> D[/api proxy/]
    D --> E[Express API port 3000]
    E --> F[Prisma Client]
    F --> G[PostgreSQL queue_db port 5432]

6.2 URL Penting

Frontend production lokal: http://localhost:82/material-dashboard-shadcn-vue/
Display publik: http://localhost:82/material-dashboard-shadcn-vue/display/antrian-truk
Backend health check: http://localhost:3000/health
Nginx health check: http://localhost:82/nginx-health

6.3 Port Penting

Komponen	Port
Backend Express	`3000`
Frontend dev Vite	`5000`
Frontend prod via Nginx	`82`
PostgreSQL	`5432`

7. Struktur Repository

backend/                              Backend Express + Prisma
material-dashboard-shadcn-vue-1.0.0/  Frontend Vue + Vite
deploy/windows/                       Script start/stop/backup/restore Windows
docker/                               Docker Compose PostgreSQL
docs/                                 Dokumentasi dan flowchart
nginx-1.28.2/                         Bundled Nginx reference
README.md                             Ringkasan script operasional Windows

Folder penting:

backend/src/app.js: mount route dan middleware.
backend/src/server.js: entrypoint backend dan auto-complete job.
backend/src/routes/: definisi endpoint per domain.
backend/src/services/: business logic dan query database.
backend/prisma/schema.prisma: schema relasional utama.
backend/prisma/migrations/: histori perubahan schema.
backend/prisma/seed.js: seed admin default.
material-dashboard-shadcn-vue-1.0.0/src/router/index.ts: route frontend dan guard role.
material-dashboard-shadcn-vue-1.0.0/src/services/api.ts: axios client dengan auth interceptor.
material-dashboard-shadcn-vue-1.0.0/vite.config.ts: base path, dev server, dan proxy /api.
deploy/windows/start-local-server.ps1: start backend dan Nginx.
deploy/windows/backup-db.ps1: backup database.
deploy/windows/restore-db.ps1: restore database.

8. Database Relasional

8.1 Database Default

Contoh konfigurasi dari backend/.env.example:

DATABASE_URL=postgresql://sankyu:sankyu39@localhost:5432/queue_db
PORT=3000
NODE_ENV=development
JWT_SECRET=change_this_secret
JWT_EXPIRES_IN=12h

8.2 Enum Penting

QueueStatus: MENUNGGU, IN_WH, PROSES, SELESAI, BATAL
QueueCategory: RECEIVING, DELIVERY
AdminRole: ADMIN, WAREHOUSE, CS
WarehouseGate: WH1, WH2, DG
StoreType: STORE_IN, STORE_OUT
EmployeePosition: FOREMAN, TALLYMAN, OPR_FORKLIFT
PickingStatus: MENUNGGU, ON_PROCESS, SELESAI, BATAL
TruckType: CDD, CDE, FUSO, WB, FT20, FT40, OTHER

8.3 Entitas Inti

Tabel/Model	Fungsi
`QueueEntry`	header antrian truk
`QueueLog`	audit log perubahan antrian
`Customer`	master customer
`Employee`	master karyawan/picker/tallyman
`AdminUser`	user login dan role
`Gate`	master gate warehouse
`ShipmentSchedule`	header schedule pengiriman
`ShipmentScheduleItem`	detail truck type per schedule
`PickingProgress`	header progres picking
`PickingProgressLog`	audit log progres picking

8.4 Relasi Database

erDiagram
    Customer ||--o{ QueueEntry : has
    Gate ||--o{ QueueEntry : assigned_to
    Employee ||--o{ QueueEntry : tallyman
    QueueEntry ||--o{ QueueLog : logs
    AdminUser ||--o{ QueueLog : acts

    Customer ||--o{ ShipmentSchedule : has
    AdminUser ||--o{ ShipmentSchedule : creates
    ShipmentSchedule ||--o{ ShipmentScheduleItem : contains

    Customer ||--o{ PickingProgress : has
    Employee ||--o{ PickingProgress : picks
    AdminUser ||--o{ PickingProgress : creates
    AdminUser ||--o{ PickingProgress : updates
    PickingProgress ||--o{ PickingProgressLog : logs
    AdminUser ||--o{ PickingProgressLog : acts

8.5 Detail Model Operasional

QueueEntry

Kolom penting:

customerId
gateId
pickerEmployeeId
category
driverName
truckNumber
containerNumber
transporter
registerTime
inWhTime
startTime
finishTime
slaWaitingMinutes
slaInWhProcessMinutes
status
notes
notesFromWh

QueueLog

Menyimpan histori status/action antrian, termasuk perubahan otomatis oleh sistem.

ShipmentSchedule dan ShipmentScheduleItem

Model ini membentuk relasi header-detail schedule:

ShipmentSchedule menyimpan tanggal, customer, store type, pembuat.
ShipmentScheduleItem menyimpan truck type, truck type other, dan qty.

PickingProgress

Kolom penting:

date
customerId
doNumber
destination
volumeCbm
plTimeRelease
pickingQty
pickedQty
slaPerBarcodeMinutes
startTime
finishTime
status
notesFromWh
pickerEmployeeId

9. API Overview

Semua endpoint dipasang di prefix /api, kecuali /health.

9.1 Auth

POST /api/auth/login
GET /api/auth/me
POST /api/auth/logout

9.2 Queue

GET /api/queue/display
POST /api/queue
GET /api/queue
GET /api/queue/export
GET /api/queue/:id
PATCH /api/queue/:id
PATCH /api/queue/:id/wh-notes
PATCH /api/queue/:id/status
PATCH /api/queue/:id/set-in-wh

9.3 Customers

GET /api/customers
POST /api/customers
GET /api/customers/template
POST /api/customers/import
GET /api/customers/export
PATCH /api/customers/:id
PUT /api/customers/:id
DELETE /api/customers/:id

9.4 Gates

GET /api/gates
GET /api/master-gates
POST /api/gates
PATCH /api/gates/:id
PUT /api/gates/:id
DELETE /api/gates/:id
GET /api/gates/template
POST /api/gates/import
GET /api/gates/export

9.5 Employees

GET /api/employees
POST /api/employees
GET /api/employees/template
POST /api/employees/import
GET /api/employees/export
PATCH /api/employees/:id
PUT /api/employees/:id
DELETE /api/employees/:id

9.6 Admin Users

GET /api/admin-users
POST /api/admin-users
PATCH /api/admin-users/:id
DELETE /api/admin-users/:id

9.7 Dashboard

GET /api/dashboard/summary
GET /api/dashboard/schedule-summary
GET /api/dashboard/progress-summary
GET /api/dashboard/picking-progress-summary
GET /api/dashboard/hourly
GET /api/dashboard/status
GET /api/dashboard/top-customers
GET /api/dashboard/over-sla
GET /api/dashboard/monthly-schedule-truck-summary
GET /api/dashboard/monthly-report

9.8 Schedules

POST /api/schedules
GET /api/schedules
GET /api/schedules/export
GET /api/schedules/print-summary
GET /api/schedules/:id
PUT /api/schedules/:id
DELETE /api/schedules/:id

9.9 Picking Progress

POST /api/picking-progress
GET /api/picking-progress
GET /api/picking-progress/template
GET /api/picking-progress/print-summary
POST /api/picking-progress/import
GET /api/picking-progress/export
GET /api/picking-progress/:id
PATCH /api/picking-progress/:id
PATCH /api/picking-progress/:id/start
PATCH /api/picking-progress/:id/picked-qty
PATCH /api/picking-progress/:id/wh-notes
PATCH /api/picking-progress/:id/finish
PATCH /api/picking-progress/:id/cancel

10. Frontend Overview

10.1 Base Path dan Routing

Frontend dibuild dengan base path:

/material-dashboard-shadcn-vue/

Implikasinya:

produksi harus diakses melalui prefix path tersebut,
router menggunakan createWebHistory('/material-dashboard-shadcn-vue/'),
Vite juga dibuild dengan base: "/material-dashboard-shadcn-vue/".

10.2 Route Penting

/login
/display/antrian-truk
/dashboard
/master-customer
/master-gate
/master-admin
/master-karyawan
/antrian-truk
/antrian-truk/mobile
/picking-progress
/schedule-pengiriman

10.3 Integrasi API

Frontend menggunakan axios client dengan:

baseURL: "/api"
auto-attach bearer token dari localStorage
auto logout redirect ke /login saat menerima 401

11. Cara Development

11.1 Prasyarat

Node.js LTS
npm
PostgreSQL lokal atau Docker
opsional Nginx jika ingin meniru mode production lokal

11.2 Setup Database dengan Docker

cd docker
docker compose up -d

Database default:

host: localhost
port: 5432
db: queue_db
user: sankyu

11.3 Setup Backend

cd backend
copy .env.example .env
npm ci
npx prisma generate
npx prisma migrate deploy
npm run seed

Catatan:

migrate:dev tersedia untuk pengembangan schema.
migrate:deploy dipakai untuk sinkronisasi schema yang sudah ada.
seed default membuat user:
- username: admin
- password: admin123
password default harus segera diganti setelah setup awal.

11.4 Setup Frontend

cd material-dashboard-shadcn-vue-1.0.0
npm ci

11.5 Menjalankan Development Mode

Opsi 1, manual:

cd backend
npm run dev

cd material-dashboard-shadcn-vue-1.0.0
npm run dev

Opsi 2, helper script Windows:

cd deploy\windows
start-dev-fullstack.bat

Perilaku helper script:

membuka window backend dan frontend terpisah,
backend berjalan di port 3000,
frontend mencoba port 5000,
jika port 5000 sudah dipakai, script akan mencoba 5001 sampai 5010.

11.6 URL Development

frontend dev: http://localhost:5000/material-dashboard-shadcn-vue/
backend health: http://localhost:3000/health

11.7 Verifikasi Development

Checklist cepat:

http://localhost:3000/health mengembalikan {"ok":true}.
Frontend bisa membuka halaman login.
Login berhasil dengan user valid.
Data dashboard dan antrian dapat dimuat.

12. Cara Deployment

Dokumen ini merangkum deployment lokal Windows yang memang dipakai repo saat ini.

12.1 Pola Deployment Production Lokal

Mode ini memakai:

backend Node.js di port 3000,
frontend hasil build dist,
Nginx Windows di port 82,
proxy /api ke http://127.0.0.1:3000.

12.2 Build Frontend

cd material-dashboard-shadcn-vue-1.0.0
npm ci
npm run build

Output build:

material-dashboard-shadcn-vue-1.0.0/dist

12.3 Setup Backend Production

cd backend
npm ci
npx prisma generate
npx prisma migrate deploy

Pastikan backend/.env berisi minimal:

DATABASE_URL=postgresql://USER:PASSWORD@HOST:5432/queue_db
PORT=3000
NODE_ENV=production
JWT_SECRET=ganti_dengan_secret_yang_aman
JWT_EXPIRES_IN=12h

12.4 Start Production Lokal di Windows

cd deploy\windows
start-local-server.bat

Apa yang dilakukan script ini:

memastikan file backend dan Nginx tersedia,
mengecek apakah dist/index.html sudah ada,
start backend dengan node src/server.js jika port 3000 belum aktif,
mengetes dan me-reload Nginx,
menampilkan URL akses lokal dan jaringan.

Konfigurasi penting di script:

nginxDir = C:\nginx-1.28.2
backend port 3000
frontend/Nginx port 82

Jika lokasi Nginx berbeda, ubah variabel nginxDir di:

deploy/windows/start-local-server.ps1
deploy/windows/stop-local-server.ps1

12.5 Stop Production Lokal

cd deploy\windows
stop-local-server.bat

Script stop akan:

menghentikan proses backend yang listen di port 3000,
menghentikan proses nginx.exe dari direktori Nginx yang dikonfigurasi.

12.6 Checklist Deployment

Build frontend berhasil dan folder dist terbaru tersedia.
backend/.env sudah benar untuk environment target.
Migrasi database sudah dijalankan.
http://localhost:3000/health merespons normal.
http://localhost:82/material-dashboard-shadcn-vue/ dapat dibuka.
Login, dashboard, queue, export, dan display publik sudah diuji.

13. Backup, Restore, dan Migrasi Perangkat

13.1 Backup Database

cd deploy\windows
backup-db.bat

Fitur script backup:

membaca DATABASE_URL dari backend/.env,
mode auto, host, atau docker,
default container docker: queue_system,
output default ke deploy/windows/backups/*.backup.

Contoh:

backup-db.bat -Mode docker
backup-db.bat D:\backup\queue_db_manual.backup

13.2 Restore Database

cd deploy\windows
restore-db.bat

Fitur script restore:

membaca DATABASE_URL dari backend/.env,
default memakai file backup terbaru jika path tidak diberikan,
meminta konfirmasi manual YES,
mendukung mode auto, host, dan docker.

Contoh:

restore-db.bat -Mode docker
restore-db.bat D:\backup\queue_db.backup

13.3 Migrasi Perangkat A ke B

Panduan rinci sudah tersedia di:

docs/MIGRATION_A_TO_B.md

Ringkasan migrasi:

Stop service di perangkat lama.
Backup database.
Salin source project ke perangkat baru.
Install dependency backend dan frontend.
Build frontend.
Set backend/.env.
Restore database.
Jalankan npx prisma migrate deploy.
Sesuaikan nginx.conf dan nginxDir.
Start aplikasi dan verifikasi dari localhost serta jaringan.

14. Operasional Harian

14.1 Start Service

deploy\windows\start-local-server.bat

14.2 Stop Service

deploy\windows\stop-local-server.bat

14.3 Start Development

deploy\windows\start-dev-fullstack.bat

14.4 Stop Development

deploy\windows\stop-dev-fullstack.bat

14.5 Backup Berkala

deploy\windows\backup-db.bat

15. Troubleshooting

15.1 Frontend berubah di source tapi production tidak ikut berubah

Penyebab umum:

frontend belum dibuild ulang,
folder dist yang aktif masih versi lama,
browser cache.

Solusi:

jalankan npm run build di folder frontend,
pastikan folder dist terbaru yang dilayani Nginx,
lakukan hard refresh atau incognito.

15.2 Frontend bisa dibuka tapi API error

Penyebab umum:

backend belum berjalan,
backend belum ikut di-update,
database tidak reachable,
token login sudah tidak valid.

Solusi:

cek http://localhost:3000/health,
restart backend,
cek backend/.env,
login ulang.

15.3 `404` pada path `/material-dashboard-shadcn-vue/`

Penyebab umum:

base path frontend tidak cocok dengan path yang dilayani server,
alias Nginx ke folder dist salah,
hasil build belum tersedia.

Solusi:

cek material-dashboard-shadcn-vue-1.0.0/dist/index.html,
cek path alias di nginx.conf,
pastikan akses memakai prefix /material-dashboard-shadcn-vue/.

15.4 `pg_dump` atau `pg_restore` tidak dikenali

Solusi:

tambahkan PostgreSQL bin ke PATH,
atau gunakan mode Docker pada script backup/restore.

15.5 Port bentrok

Port yang perlu dicek:

3000 untuk backend,
5000-5010 untuk frontend dev,
82 untuk Nginx,
5432 untuk PostgreSQL.

16. Known Notes

Root package.json bukan aplikasi utama; package utama ada di backend/ dan material-dashboard-shadcn-vue-1.0.0/.
Project saat ini belum menyediakan script automated test di package utama backend/frontend.
Dokumentasi deploy frontend detail tambahan juga tersedia di docs/deploy-production.md.
Flowchart operasional queue tersedia di docs/flowchart-workflow-antrian-trucking.drawio.

17. Referensi Dokumen Lain

docs/context-project.md
docs/deploy-production.md
docs/MIGRATION_A_TO_B.md
README.md

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/warehouse-queue-app-project-doc/

Di Kaki Bukit Cibalak - Ahmad Tohari

Ngopidulur — Fri, 22 May 2026 15:46:00 GMT

Oleh
Ahmad Tohari

Daftar Isi

Episode 1
Episode 2
Episode 3
Episode 4
Episode 5
Episode 6
Episode 7
Episode 8
Episode 9
Episode 10
Episode 11
Episode 12

Episode 1

Dulu, jalan setapak itu adalah terowongan yang menembus belukar puyengan. Bila iring-iringan kerbau lewat, tubuh mereka tenggelam di bawah terowongan semak itu. Hanya bunyi korakan yang tergantung pada leher mereka terdengar dengan suara berdentang-dentang, iramanya tetap dan datar. Burung-burung kucica yang terkejut, terbang mencicit. Mereka tetap tidak mengerti mengapa kerbau-kerbau senang mengusik ketenteraman belukar puyengan tempat burung-burung kecil itu bersarang.

Meskipun kerbau-kerbau itu telah jauh memasuki hutan jati Bukit Cibalak, suara korakan mereka masih tetap terdengar. Dan bunyi korakan adalah pertanda yang selalu didengarkan oleh majikan. Para pemilik kerbau di sekitar kaki Bukit Cibalak tidak menggembalakan ternak mereka. Binatang itu bebas berkeliaran mencari rumput, mencari umbut gelagah, atau berkubang di tepi hutan jati.

Sekarang terowongan di bawah belukar puyengan itu lenyap, berubah menjadi jalan setapak. Tak terdengar lagi suara korakan kerbau karena binatang itu telah banyak diangkut ke kota, dan di sana akan diolah menjadi daging goreng atau makanan anjing. Di sekitar kaki Bukit Cibalak, tenaga kerbau telah digantikan traktor-traktor tangan.

Burung-burung kucica yang telah turun-temurun mendaulat belukar puyengan itu terpaksa hijrah ke semak-semak kerontang yang menjadi batas antara Bukit Cibalak dan Desa Tanggir di kakinya.

Orang-orang yang biasa memburuh dengan bajak, kemudian berganti pekerjaan. Pak Danu misalnya, yang dulu dikagumi orang karena kecakapannya memainkan bajak, kini bekerja pada Akiat. Ia menjadi tukang timbang ampas singkong.

Bekas telapak kerbau yang mengukir jalan-jalan setapak telah terhapus oleh gilasan roda-roda sepeda atau sepeda motor. Dari sebuah lorong setapak yang sempit kini terciptalah sebuah jalan kampung yang agak lebar.

Orang-orang Tanggir tidak merasa terganggu oleh banyaknya sampah plastik dalam pawuan mereka. Mereka punya kesabaran yang luar biasa untuk menjumputi sampah-sampah pabrik itu bila mereka hendak menjadikan isi pawuan mereka sebagai pupuk kompos.

Suatu siang Pak Danu pulang dari rumah taukenya. Ia sengaja singgah beberapa kali ke rumah orang-orang yang dikenalnya. Pak Danu ingin memamerkan sebuah tabung yang dicurinya dari rumah Akiat, sambil berpropaganda dengan bangga:

“Ya, inilah obat semprot ketiak yang sering disiarkan oleh radio dan televisi. Inilah barangnya. Kalian baru melihat gambarnya atau mendengar namanya saja, bukan? Tetapi aku kini telah memilikinya! Di kampung ini pastilah aku yang pertama kali memiliki barang mahal ini.”

← Kembali ke Daftar Isi

Episode 2

Selama perjalanannya ke Balai Desa, Jirah yang paling banyak berbicara. Mula-mula ia bercerita tentang pengalamannya menggunakan sampo yang terbaru. Kemudian bercerita tentang sabun yang mengandung minyak zaitun. Jirah tidak perlu merasa bodoh walaupun ia tidak tahu apa itu zaitun. Yang penting ia dapat menirukan kata-kata tukang iklan di radio atau televisi.

Di halaman Balai Desa telah berkumpul banyak sekali warga Desa Tanggir. Lurah baru akan dipilih hari itu, karena lurah yang lama telah meletakkan jabatan.

Penduduk Desa Tanggir adalah keturunan dari dua kelompok orang yang berlainan. Kaum kawula yang dulu dipaksa oleh Raja Mataram untuk membuka tanah-tanah rawa di sekitar kaki Bukit Cibalak, adalah nenek moyang kebanyakan orang Tanggir. Seperti nenek moyangnya, orang Tanggir masih berjiwa kawula. Falsafah hidupnya: nrimo pandum.

Nenek moyang sebagian kecil penduduk Tanggir adalah kerabat ningrat yang menyingkir dari istana Mataram. Di Desa Tanggir mereka menurunkan priyayi-priyayi kecil: opas Kantor Kecamatan, mantri pasar, atau guru-guru sekolah.

← Kembali ke Daftar Isi

Episode 3

Dan tiba-tiba perhatian semua orang tertuju ke bawah pohon johar di sudut halaman Balai Desa. Di sana seorang kakek sedang membaca mantra. Tentu ia telah dibayar oleh seorang calon agar “wahyu” datang kepada calon yang telah memberinya uang.

Tiap-tiap calon mempunyai beberapa orang botoh yang mempunyai tugas sebagai pengumpul suara. Soal cara, tidak diperhatikan benar. Maka para botoh inilah yang hampir selalu mendatangkan onar pada setiap pelaksanaan pemilihan pamong desa.

Siapa pun yang ingin menjadi lurah Desa Tanggir tidak boleh sayang terhadap uang dua, tiga, atau empat puluh juta rupiah. Kelima orang calon yang hendak dipilih pagi itu telah mengeluarkan uang banyak sekali.

Meskipun ada lima orang calon, kebanyakan orang mengatakan hanya dua orang yang memiliki peluang. Satu di antaranya adalah Pak Badi. Calon lain yang keadaannya mengimbangi Pak Badi adalah calon yang memegang lambang dengan gambar pedang. Ia bernama Dirgamulya, dan terkenal dengan sebutan Pak Dirga.

Dan ternyata keluhuran budi, kearifan, serta kejujuran Pak Badi tidak memberikan nasib baik. Ia kalah, karena Pak Dirga-lah yang terpilih.

← Kembali ke Daftar Isi

Episode 4

Karena merasa menemukan jalan buntu, Pambudi mulai berpikir untuk mencari pekerjaan lain. Dan keputusannya untuk meninggalkan pekerjaannya yang lama datang dua bulan kemudian.

Seorang perempuan datang menemui Pambudi. Ia mengajukan permohonan agar diberi pinjaman padi.

“Untuk apa padimu nanti, Mbok?”
“Akan kujual. Uangnya akan kupergunakan untuk berobat. Lihatlah, leherku membengkak. Sakit sekali rasanya.”

Setelah Pak Dirga datang, Pambudi membawa tamunya masuk ke kamar kerja Kepala Desa. Dengan suara lirih dan gemetar, Mbok Ralem mengutarakan maksudnya kepada Pak Dirga.

Pak Dirga tidak segera memberi jawaban. Ia hanya melihat sepintas saja pada leher Mbok Ralem. Kemudian dengan pandangan mata lurus Pak Dirga berkata:

“Mbok Ralem, sebenarnya seorang seperti kamu tidak bisa mendapat pinjaman.”

← Kembali ke Daftar Isi

Episode 5

“Kali ini saya harus tahu. Soalnya, saya ingin tahu, penting mana rencana Bapak itu dengan keharusan kita menolong Mbok Ralem.”

Pak Dirga menyembunyikan kagetnya dengan cepat-cepat menyalakan rokok. Ia tidak mengira akan dikejar dengan pertanyaan yang menyelidik seperti itu.

← Kembali ke Daftar Isi

Episode 6

Alangkah nyaman hari-hari berikutnya terasa oleh Pambudi. Kenyataan bahwa sekarang ia menjadi penganggur, tidak mengurangi cerahnya perasaannya. Pambudi benar-benar menikmati suasana yang sulit digambarkan.

Sepedanya dikayuh melalui jalan-jalan kecil yang menyelinap di bawah rumpun-rumpun bambu. Tidak lama, sampailah ia ke halaman sebuah rumah kecil, tanpa pintu.

“Mbok Ralem, kau tak perlu takut seperti itu.”
“Anu, anu... anu, Nak.”
“Anu apa, Mbok?”
“Aku takut kau membawa perintah dari Lurah untuk menghukumku.”

← Kembali ke Daftar Isi

Episode 7

Ketika nama Mbok Ralem disebut, Pambudi ikut masuk ke ruang periksa. Surat keterangan dari Tanggir diperlihatkan kepada mantri yang memeriksa Mbok Ralem.

Mereka berbicara sebentar, kemudian Pak Mantri bertanya kepada Pambudi:

“Apakah Anda anak ibu ini?”
“Bukan, tetapi segala sesuatu yang menyangkut perawatan pasien ini dapat dibicarakan dengan saya.”

← Kembali ke Daftar Isi

Episode 8

“Jadi pertama-tama Anda meminta kesediaan kami untuk memasang iklan. Selanjutnya Anda meminta supaya Kalawarta membuka dompet sumbangan untuk menghimpun dana bagi perawatan Mbok Ralem. Begitu, bukan?”

“Ya, benar, Pak.”

← Kembali ke Daftar Isi

Episode 9

“Lalu mengapa Bung mengetuk kamar saya? Mengapa tidak mencari penginapan lain?”

“Oh, anu. Begini, ya, Mas, losmen dan hotel di kota ini sedang penuh semua. Dan gadis itu hanya ingin Anda perbolehkan menggelar tikar di lantai kamar Anda.”

← Kembali ke Daftar Isi

Episode 10

Tiba di Tanggir, Pambudi menemukan kedua anak Mbok Ralem tinggal bersama bibi mereka. Dua minggu ditinggal oleh emaknya, kedua anak itu semakin layu.

Dari saku celananya Pambudi mengambil uang receh.

“Belilah beberapa bungkus meniran,” katanya kepada anak Mbok Ralem yang besar.

← Kembali ke Daftar Isi

Episode 11

Keadaan tubuh perempuan Tanggir itu cepat berubah, bersih dan gemuk. Ransumnya bergizi baik dan selalu dimakannya habis.

Pada hari ke-36 Mbok Ralem diizinkan pulang. Bukan main senang hatinya.

← Kembali ke Daftar Isi

Episode 12

“Selamat jalan, Mbok, Pambudi. Aku berterima kasih kepada kalian. Karena kalianlah Kalawarta berkesempatan menunaikan misinya yang paling berarti. Juga karena kalianlah aku merasa yakin bahwa tidak sesuatu pun telah hilang dari diri kita sebagai manusia. Memang, si Anu itu jarang hadir di antara kita. Tetapi bagaimanapun juga si Anu masih ada. Kita sendiri yang baru saja membuktikannya: Kemanusiaan.”

Penutup

Di Kaki Bukit Cibalak adalah karya Ahmad Tohari yang mengangkat tema kemanusiaan, ketidakadilan sosial, korupsi di tingkat desa, dan perjuangan seorang pemuda bernama Pambudi dalam menolong sesamanya.

Cerita ini sarat dengan kritik sosial terhadap kondisi masyarakat pedesaan Jawa pada masanya, sekaligus menampilkan harapan melalui tindakan kemanusiaan yang tulus.

Sumber: Di Kaki Bukit Cibalak oleh Ahmad Tohari

Akhir

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/di-kaki-bukit-cibalak-ahmad-tohari/

AI Harness Engineering: Panduan Lengkap Membangun Production AI Agents

Ngopidulur — Fri, 22 May 2026 15:33:00 GMT

Berdasarkan: AI Harness Engineering Interview Preparation Handbook (2026 Edition)
Disusun dalam Bahasa Indonesia
Fokus: Runtime, Guardrails, MCP, Evals, Observability, dan Production Practices

Daftar Isi

Apa Itu AI Harness Engineering?
Tujuh Lapisan Harness untuk Production AI Agents
Dari Prompt Engineering ke Harness Engineering
Instruction Engineering untuk AI Agents
Tool Calling dan MCP (Model Context Protocol)
Memory, State, dan Retrieval untuk AI Agents
Sandboxing dan Execution Environment
Evaluasi, Observability, dan Reliability AI Agents
Guardrails, Safety, dan Governance
Penutup & Ringkasan

1. Apa Itu AI Harness Engineering?

Di tahun 2026, percakapan tentang AI Agents sudah bergeser. Bukan lagi hanya tentang seberapa pintar modelnya, tetapi tentang seberapa baik kita membungkus model tersebut agar bisa diandalkan di production.

Definisi AI Harness Engineering

AI Harness Engineering adalah disiplin ilmu untuk merancang, membangun, dan mengoperasikan lapisan runtime dan control yang membungkus language model, sehingga output-nya bisa dipercaya, diaudit, dan dikomposisikan menjadi software production.

Singkatnya:
Model adalah otaknya. Harness adalah segala sesuatu yang membuat otak itu bisa bekerja dengan aman dan berguna di dunia nyata.

Agent = Model + Harness

Persamaan paling penting dalam bidang ini:

Agent = Model + Harness

Model bersifat komoditas (bisa diganti dengan mudah).
Harness adalah capital yang kamu bangun sendiri dan menjadi pembeda utama.

Dua perusahaan yang menggunakan model yang sama bisa menghasilkan produk yang sangat berbeda, tergantung seberapa baik harness yang mereka miliki.

Mengapa Model yang Lebih Pintar Tidak Cukup?

Banyak orang berpikir: "Kalau modelnya sudah sangat pintar, harness tidak terlalu penting." Pengalaman production membuktikan sebaliknya.

Model yang lebih pintar tidak secara otomatis memberikan:

Determinisme saat dibutuhkan
Auditability (catatan apa yang dilakukan agent)
Enforcemen izin dan batasan
Kontrol biaya
Ketahanan terhadap serangan (prompt injection)
Komposisi yang baik dengan sistem lain

Semua hal di atas adalah tanggung jawab harness, bukan model.

Empat Lapisan AI Software

Untuk memahami posisi harness engineering, kita perlu melihat empat lapisan:

Lapisan	Penjelasan	Contoh
Model	Neural network itu sendiri	GPT-4o, Claude 4, DeepSeek
Agent	Loop yang menggunakan model untuk observe-plan-act	ReAct agent, Coding agent
Workflow	Komposisi beberapa agent + langkah deterministik	Pipeline CI/CD otomatis
Harness	Lapisan runtime lintas cutting yang mendukung semua lapisan di atas	Sandbox, Guardrails, Observability, Evals

Harness adalah platform-nya. Ia menyediakan lingkungan agar agent bisa berjalan dengan aman.

Analogi Kuda dan Harness

Analogi yang paling sering digunakan:

Kuda = Model (kuat, kadang brilian, tapi tidak bisa diandalkan begitu saja)
Harness = Segala perlengkapan yang menghubungkan kuda dengan kereta dan pengendara
Pengendara = Manusia yang memiliki tujuan dan bertanggung jawab penuh

Tanpa harness yang baik, seekor kuda yang kuat justru menjadi bahaya di tengah kota. Dengan harness yang baik, kekuatannya menjadi sangat berguna.

Di Mana AI Agents Digunakan Saat Ini?

Beberapa kategori penggunaan production AI Agents yang paling matang:

Coding Agents (paling matang)
CI/CD & Pipeline Automation
Customer Support & Triage
Security Remediation
Document-grounded Assistants
Incident Investigation

Setiap kategori memiliki tantangan harness yang berbeda-beda.

Kesimpulan Bagian 1

AI Harness Engineering adalah disiplin yang fokus pada engineering di sekitar model, bukan hanya pada modelnya. Di production, harness jauh lebih penting daripada seberapa pintar model yang digunakan.

Sumber: AI Harness Engineering Interview Preparation Handbook (2026)

← Kembali ke Daftar Isi

2. Tujuh Lapisan Harness untuk Production AI Agents

Salah satu kontribusi terpenting dari buku ini adalah model tujuh lapisan harness. Model ini membantu engineer memahami secara sistematis apa saja yang perlu dibangun di sekitar sebuah AI Agent.

Mengapa Tujuh Lapisan?

Tujuh lapisan ini bukan sekadar teori. Ia mencerminkan lapisan-lapisan yang secara berulang muncul di berbagai production incident. Setiap lapisan memiliki tanggung jawab yang jelas dan saling bergantung.

Tujuh Lapisan Harness

Berikut adalah tujuh lapisan tersebut:

Layer 1: Instruction

System prompt, task definition, constraints, dan persona agent. Lapisan ini menentukan "siapa" agent itu dan "apa" yang boleh/tidak boleh dilakukannya.

Layer 2: Tools

Tool registry, function schemas, input validation, dan permission model. Agent hanya bisa bertindak melalui tools yang disediakan harness.

Layer 3: Memory and Retrieval

Jenis-jenis memory (scratch, episodic, semantic), retrieval pipeline, chunking, embedding, dan grounding. Lapisan ini menentukan seberapa baik agent "mengingat" dan "mencari informasi".

Layer 4: Execution

Sandboxing, runtime environment, network control, filesystem isolation, dan credential scoping. Lapisan ini menjawab pertanyaan: "Seberapa aman agent ini bisa menjalankan kode atau memanggil tools?"

Layer 5: Policy and Approval

Guardrails, policy engine, human-in-the-loop, approval gates, dan dry-run mode. Lapisan ini mengatur "kapan agent boleh bertindak sendiri dan kapan harus minta persetujuan manusia".

Layer 6: Observability

Tracing, logging, cost tracking, prompt/completion capture, dan anomaly detection. Tanpa observability yang baik, kita buta saat agent berjalan di production.

Layer 7: Evaluation

Golden datasets, LLM-as-judge, regression testing, trajectory evaluation, dan production monitoring. Lapisan ini menjawab: "Seberapa baik sebenarnya agent ini bekerja?"

Dependency Graph

Ketujuh lapisan ini saling bergantung. Contoh:

Tools (Layer 2) membutuhkan Policy (Layer 5) sebelum dieksekusi.
Observability (Layer 6) dibutuhkan untuk melakukan Evaluation (Layer 7).
Memory (Layer 3) sangat bergantung pada Instruction (Layer 1) yang baik.

Lapisan Mana yang Harus Dibangun Duluan?

Urutan yang umum direkomendasikan:

Instruction + Tools (paling fundamental)
Execution (Sandbox)
Policy & Guardrails
Observability
Evaluation
Memory & Retrieval (bisa dikembangkan secara bertahap)

Kesimpulan Bagian 2

Model tujuh lapisan memberikan kerangka berpikir yang sangat berguna saat merancang AI Agent untuk production. Dengan memahami setiap lapisan dan ketergantungannya, engineer bisa membangun sistem yang lebih sistematis dan lebih mudah di-debug.

← Kembali ke Daftar Isi

3. Dari Prompt Engineering ke Harness Engineering

Memahami evolusi disiplin ini penting agar kita tidak terjebak pada cara berpikir lama.

Timeline Singkat

Tahun	Fokus Utama	Karakteristik	Keterbatasan
2022–2023	Prompt Engineering	Membuat prompt yang bagus	Tidak scalable, tidak versionable
2024	Agent Frameworks	LangChain, AutoGen, CrewAI, dll	Masih tipis, banyak hal diserahkan ke developer
2025	Convergence ke Harness	Mulai muncul istilah harness secara luas	Masih belum terstruktur
2026	Harness Engineering	Menjadi disiplin tersendiri	Masih berkembang

Mengapa Prompt Saja Tidak Cukup untuk Production?

Beberapa alasan utama:

Prompt bersifat artisanal (sulit di-review dan di-version)
Sulit menggeneralisasi ke banyak tugas
Tidak tahan terhadap model upgrade
Tidak memberikan auditability
Tidak menangani failure modes secara sistematis
Tidak mengatur cost dan safety dengan baik

Apa yang Berubah di Harness Engineering?

Harness engineering berfokus pada infrastructure yang membuat ribuan percakapan berjalan dengan baik, bahkan ketika:

Tidak ada yang mengawasi
Input bersifat adversarial
Model provider mengubah bobot secara diam-diam
Tim keuangan meminta penghematan biaya 5x lipat

Seorang Harness Engineer bukanlah "prompt whisperer". Ia adalah orang yang membangun fondasi agar agent bisa diandalkan di skala production.

Tiga Skill yang Paling Diuji di Interview

Dari banyak interview loop di bidang ini, tiga skill berikut paling sering menjadi pembeda:

Design Judgment — Kemampuan memilih arsitektur yang tepat di bawah tekanan waktu dan membela pilihannya.
Operational Instinct — Kemampuan membayangkan apa yang sebenarnya terjadi saat agent berjalan di production (latency, cost, failure).
Failure Fluency — Kemampuan menyebutkan cara sistem bisa rusak sebelum benar-benar rusak, serta merancang recovery path.

Kesimpulan Bagian 3

Prompt engineering adalah keterampilan penting, tetapi tidak cukup untuk production. Harness engineering adalah evolusi alami yang menjadikan AI Agents bisa diandalkan secara sistematis.

← Kembali ke Daftar Isi

4. Instruction Engineering untuk AI Agents

Instruction layer adalah fondasi dari segala hal. Tanpa instruction yang baik, lapisan-lapisan lain akan kesulitan mengkompensasi.

Tiga Tier Konteks Agent

System-level context — Instruksi permanen yang mendefinisikan identitas dan batasan agent.
Task-level context — Instruksi spesifik untuk tugas saat ini.
Runtime context — Informasi yang dikumpulkan selama agent berjalan (tool results, retrieved documents, previous thoughts).

Apa yang Harus Ada di System Prompt?

Beberapa elemen penting:

Role & Persona
Core Objectives
Hard Constraints (apa yang tidak boleh dilakukan)
Output Format (structured output)
Failure Handling (bagaimana agent harus bereaksi saat gagal)
Escalation Policy

Structured Outputs

Menggunakan structured output (JSON Schema, Pydantic, dll) sangat direkomendasikan di production karena:

Lebih mudah di-parse
Lebih mudah divalidasi
Mengurangi hallucination pada format

Constraint Design

Salah satu praktik terbaik adalah membuat jalan yang aman menjadi jalan yang paling mudah.

Contoh:

Default dry_run = true pada tool yang berbahaya
Agent harus secara eksplisit memilih untuk melakukan aksi destruktif

Failure-Aware Prompting

Agent yang baik tidak hanya tahu cara sukses, tetapi juga tahu cara gagal dengan baik. System prompt sebaiknya berisi instruksi tentang:

Kapan harus menyerah
Kapan harus meminta bantuan manusia
Bagaimana melaporkan ketidakpastian

Prompt Versioning

Di production, prompt harus di-version control, direview, dan bisa di-roll back — sama seperti kode.

Kesimpulan Bagian 4

Instruction Engineering di konteks production jauh lebih dari sekadar menulis prompt yang bagus. Ia mencakup constraint design, structured output, versioning, dan failure handling.

← Kembali ke Daftar Isi

5. Tool Calling dan MCP (Model Context Protocol)

Tools adalah cara agent berinteraksi dengan dunia luar. Kualitas tool design sangat menentukan kualitas agent secara keseluruhan.

Trust Ladder untuk Tools

Tidak semua tool diciptakan sama. Ada tingkatan kepercayaan:

Read-only tools (paling aman)
Write tools dengan dry-run
Write tools dengan human approval
Irreversible actions (paling berisiko)

Prinsip Desain Function Schema

Beberapa prinsip penting:

Nama tool harus jelas dan deskriptif (delete_file, bukan file_op)
Deskripsi harus ditulis untuk model, bukan untuk manusia
Setiap parameter harus punya deskripsi yang baik
Gunakan enum dan required fields secara bijak
Sediakan mode dry_run untuk aksi berbahaya

MCP — Model Context Protocol

MCP adalah standar yang muncul untuk memudahkan integrasi antara agent dengan berbagai tools dan platform. Beberapa poin penting:

MCP mendefinisikan cara agent menemukan dan memanggil tools
Mendukung authentication dan authorization
Memungkinkan komposisi beberapa MCP server
Semakin banyak platform (termasuk Harness) yang menyediakan MCP Server

Read vs Write Separation

Salah satu praktik keamanan terbaik adalah memisahkan tool yang hanya membaca dengan tool yang bisa menulis/mengubah data.

Kesimpulan Bagian 5

Tool calling adalah salah satu lapisan paling kritis dalam harness. Desain schema yang buruk bisa menyebabkan agent melakukan hal yang tidak diinginkan atau gagal memahami cara menggunakan tool dengan benar.

← Kembali ke Daftar Isi

6. Memory, State, dan Retrieval untuk AI Agents

Memory dan retrieval adalah lapisan yang menentukan seberapa "pintar" agent dalam jangka panjang dan seberapa akurat ia dalam menjawab pertanyaan berbasis pengetahuan.

Tiga Jenis Memory

Jenis Memory	Fungsi	Contoh Penggunaan	Tantangan
Scratch Memory	Konteks dalam satu sesi	Conversation history	Context window limit
Episodic Memory	Pengalaman dari run sebelumnya	Reflection, past mistakes	Memory poisoning
Semantic Memory	Pengetahuan domain / dokumen	RAG, company knowledge base	Stale data, retrieval quality

Retrieval yang Baik

Beberapa praktik penting dalam retrieval:

Chunking yang tepat sangat berpengaruh
Hybrid retrieval (BM25 + Vector) sering lebih baik daripada hanya vector
Reranking biasanya meningkatkan kualitas hasil
Selalu sertakan citation/provenance
Deteksi data yang sudah usang (stale data)

Memory Poisoning

Salah satu risiko serius adalah memory poisoning — ketika agent menyimpan informasi yang salah dan kemudian menggunakannya lagi di masa depan. Harness harus memiliki mekanisme untuk memvalidasi dan membersihkan memory.

Kesimpulan Bagian 6

Memory dan retrieval yang baik adalah salah satu pembeda utama antara agent yang hanya terlihat pintar dengan agent yang benar-benar berguna di production.

← Kembali ke Daftar Isi

7. Sandboxing dan Execution Environment

Ketika agent diberi kemampuan untuk menjalankan kode atau memanggil tools yang powerful, keamanan menjadi sangat penting.

Mengapa Default Docker Tidak Cukup?

Docker bagus untuk deployment, tetapi untuk agent execution, kita membutuhkan isolasi yang lebih kuat karena:

Agent bisa mencoba escape
Agent bisa mencoba mengakses resource sensitif
Blast radius harus seminimal mungkin

Teknologi Sandboxing Modern

Beberapa teknologi yang sering digunakan:

gVisor — User-space kernel
Firecracker — MicroVM (ringan dan cepat)
Worktree isolation per task
Network egress policy yang ketat
Filesystem yang read-only atau terbatas

Prinsip Utama Sandboxing

Least privilege
Fast start time
Observable & auditable
Easy to destroy setelah selesai

Kesimpulan Bagian 7

Sandboxing adalah lapisan pertahanan terakhir. Jika agent berhasil mengeksploitasi sandbox, maka seluruh sistem bisa berada dalam bahaya. Investasi di lapisan ini sangat penting untuk agent yang memiliki akses ke tools yang powerful.

← Kembali ke Daftar Isi

8. Evaluasi, Observability, dan Reliability AI Agents

"Anda tidak bisa memperbaiki apa yang tidak bisa Anda ukur."

Evaluasi Bukan QA Biasa

Di AI Agents, evaluasi adalah engineering discipline, bukan hanya aktivitas QA. Evaluasi harus dilakukan secara terus-menerus, termasuk setelah deployment.

Komponen Evaluasi yang Penting

Golden datasets
LLM-as-judge (dengan hati-hati)
Trajectory evaluation
Regression testing di CI/CD
Statistical rigor

Observability untuk AI Agents

Observability tradisional tidak cukup. Kita membutuhkan:

Trace setiap langkah agent (bukan hanya request-response)
Capture prompt dan completion
Cost tracking per run
Anomaly detection pada trace
Feedback signal integration

Failure Modes yang Sering Terjadi

Beberapa failure mode umum:

Infinite loops
Partially-applied state
Silent failures
Cost explosion
Context poisoning

Kesimpulan Bagian 8

Tanpa observability dan evaluasi yang baik, agent yang terlihat berfungsi di development bisa gagal total di production. Lapisan ini adalah salah satu yang paling sering diremehkan.

← Kembali ke Daftar Isi

9. Guardrails, Safety, dan Governance

Ini adalah lapisan yang menentukan apakah agent bisa dipercaya untuk dijalankan di lingkungan enterprise atau production yang sensitif.

Jenis Guardrails

Input Guardrails — Memeriksa input sebelum masuk ke model
Inline Guardrails — Memeriksa selama proses berjalan
Output Guardrails — Memeriksa output sebelum dikembalikan ke user

Ancaman Utama

Prompt Injection (ancaman paling serius)
Data leakage / PII exposure
Unauthorized actions
Model misuse

Governance di Enterprise

Beberapa aspek penting:

RBAC dan delegated permissions
Audit trail yang lengkap
Approval workflows
Data residency & egress control
Incident response integration

Kesimpulan Bagian 9

Guardrails dan governance bukan penghalang inovasi, melainkan fondasi agar AI Agents bisa digunakan secara bertanggung jawab di skala production.

← Kembali ke Daftar Isi

Penutup & Ringkasan

AI Harness Engineering adalah disiplin yang sedang berkembang pesat di tahun 2026. Fokus utamanya adalah membangun lapisan engineering di sekitar model AI agar bisa diandalkan dalam skala production.

Ringkasan 9 Topik Utama:

No	Topik	Fokus Utama
1	Pengantar Harness Engineering	Agent = Model + Harness
2	Tujuh Lapisan Harness	Instruction → Evaluation
3	Evolusi Disiplin	Prompt → Agent → Harness
4	Instruction Engineering	Prompt, constraint, structured output
5	Tool Calling & MCP	Schema design, protocol integrasi
6	Memory & Retrieval	Scratch, episodic, semantic memory + RAG
7	Sandboxing	Isolasi eksekusi yang aman
8	Evaluasi & Observability	Evals, tracing, reliability
9	Guardrails & Governance	Safety, policy, enterprise readiness

Pesan Akhir:

Model akan terus berkembang dan menjadi lebih pintar.
Tetapi prinsip-prinsip Harness Engineering — bagaimana membungkus model agar aman, dapat diaudit, dan bisa diandalkan — akan tetap relevan dalam waktu yang lama.

Structure in. Structure out.

Sumber Utama:
AI Harness Engineering Interview Preparation Handbook — 2026 Edition oleh AI Engineering Insider

Akhir dari Ebook

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/ai-harness-engineering-panduan-lengkap-membangun-production-ai-agents/

AI untuk Data Science: Panduan Lengkap dari Dasar hingga Praktik Bisnis

Ngopidulur — Fri, 22 May 2026 14:55:00 GMT

Berdasarkan buku: AI for Data Science oleh Zacharias Voulgaris, PhD & Yunus Emrah Bulut
Disusun ulang dalam Bahasa Indonesia
Versi: Mei 2026

Daftar Isi

Bagian 1: Apa Itu AI dan Mengapa Penting untuk Data Scientist?
Bagian 2: Mengenal Deep Learning Frameworks
Bagian 3: Membangun Neural Network dengan MXNet
Bagian 4: TensorFlow & Keras
Bagian 5: Optimization Algorithms (PSO, Genetic Algorithm, Simulated Annealing)
Bagian 6: CNN, RNN, dan Optimization Ensemble
Bagian 7: Alternative AI Frameworks (ELM, CapsNet, Fuzzy Logic)
Bagian 8: Transfer Learning, Reinforcement Learning, Autoencoder & GANs
Bagian 9: Aspek Bisnis Penerapan AI dalam Proyek Data Science
Penutup & Ringkasan Seri

Bagian 1: Apa Itu AI dan Mengapa Penting untuk Data Scientist?

Buku "AI for Data Science" karya Zacharias Voulgaris, PhD dan Yunus Emrah Bulut adalah salah satu buku paling komprehensif yang membahas penerapan Artificial Intelligence dalam dunia data science secara praktis.

Dalam seri artikel ini, saya akan merangkum dan membahas isi buku tersebut dalam bahasa Indonesia, agar lebih mudah dipahami oleh developer, data scientist, dan praktisi teknologi di Indonesia.

Apa Itu AI Sebenarnya?

Banyak orang masih menganggap AI seperti yang ada di film sci-fi — robot cerdas yang bisa mengambil alih dunia. Padahal, AI modern jauh lebih sederhana dan fungsional.

Menurut buku ini, AI adalah kumpulan algoritma yang menggunakan data untuk membuat keputusan dan menyelesaikan tugas, mirip seperti manusia. Namun, AI saat ini masih bersifat narrow AI (kecerdasan sempit). Artinya:

AI sangat bagus dalam satu atau beberapa tugas tertentu.
AI masih lemah jika diberi tugas di luar spesialisasinya.

Contoh:

AI bisa sangat akurat dalam mengenali wajah atau merekomendasikan lagu di Spotify.
Tapi AI yang sama belum tentu bisa membedakan musik klasik dan pop dengan baik.

Mengapa AI Penting untuk Data Science?

Data science sudah ada jauh sebelum AI populer. Namun, dengan munculnya AI, performa model data science bisa meningkat secara signifikan, terutama di industri yang sangat kompetitif.

Beberapa alasan mengapa AI semakin penting dalam data science:

Performa lebih baik: Banyak algoritma AI (seperti Deep Learning) mampu menangkap pola yang lebih kompleks dibanding metode tradisional.
Data yang melimpah: Banyak perusahaan sudah memiliki data dalam jumlah besar (AI-ready data).
Komputasi yang lebih murah: GPU dan cloud computing membuat training model AI menjadi lebih terjangkau.
Framework yang matang: Library seperti TensorFlow, Keras, PyTorch, dan MXNet membuat AI lebih mudah diakses.

Singkatnya: Data science bisa dilakukan tanpa AI, tetapi di banyak kasus, mengabaikan AI berarti kehilangan keunggulan kompetitif.

Narrow AI vs Artificial General Intelligence (AGI)

Saat ini kita hanya memiliki Narrow AI. AI ini dirancang untuk tugas spesifik.

Artificial General Intelligence (AGI) — AI yang bisa melakukan hampir semua tugas intelektual seperti manusia — masih jauh dari kenyataan. Buku ini menekankan bahwa sebagai praktisi, kita harus fokus pada apa yang bisa dilakukan AI saat ini, bukan pada fantasi masa depan.

Kesimpulan Bagian 1

AI bukan ancaman, melainkan alat yang sangat powerful untuk memperkuat kemampuan data science. Dengan framework modern dan sumber daya komputasi yang semakin terjangkau, sekarang adalah waktu yang tepat untuk mulai mempelajari dan menerapkan AI dalam proyek data science.

Sumber: Buku AI for Data Science oleh Zacharias Voulgaris, PhD & Yunus Emrah Bulut (Technics Publications, 2018)

← Kembali ke Daftar Isi

Bagian 2: Mengenal Deep Learning Frameworks

Di Bagian 1, kita sudah membahas apa itu AI secara realistis dan mengapa AI semakin penting dalam dunia data science. Sekarang kita masuk ke salah satu topik paling penting: Deep Learning Frameworks.

Apa Itu Deep Learning Framework?

Deep Learning Framework adalah perpustakaan (library) atau platform yang menyediakan tools, fungsi, dan infrastruktur untuk membangun, melatih, dan menjalankan model deep learning dengan lebih mudah dan efisien.

Tanpa framework, kita harus menulis hampir semua komponen dari nol (seperti neural network layer, backpropagation, optimisasi, dll). Framework membuat proses ini jauh lebih cepat dan lebih aman dari error.

Bagaimana Deep Learning System Bekerja?

Secara sederhana, deep learning system terdiri dari beberapa komponen utama:

Data — Input yang digunakan untuk melatih model (gambar, teks, angka, dll).
Model/Neural Network — Struktur yang terdiri dari banyak layer neuron.
Loss Function — Fungsi yang mengukur seberapa baik model dalam memprediksi.
Optimizer — Algoritma yang menyesuaikan bobot (weight) model agar loss semakin kecil.
Training Loop — Proses iteratif di mana model belajar dari data.

Framework deep learning menyediakan semua komponen ini dalam bentuk yang mudah digunakan.

Deep Learning Frameworks Populer Saat Ini

Berikut adalah beberapa framework deep learning utama yang dibahas dalam buku AI for Data Science:

Framework	Bahasa Utama	Kelebihan	Kekurangan	Cocok Untuk
TensorFlow	Python	Sangat matang, produksi-ready, TensorBoard	Kurva belajar cukup curam	Production & Research
Keras	Python	Sangat user-friendly, cepat untuk prototyping	Kurang fleksibel untuk custom model	Pemula & Rapid Prototyping
MXNet	Python, Scala, R	Ringan, cepat, mendukung banyak bahasa	Komunitas lebih kecil	Deployment & Edge Devices
PyTorch	Python	Sangat fleksibel (dynamic graph), populer di research	Deployment agak lebih rumit	Research & Experimentation
CNTK	Python, C++	Performa baik	Sudah kurang aktif dikembangkan	Kasus tertentu

Catatan: Buku ini diterbitkan tahun 2018, sehingga saat itu MXNet, TensorFlow, dan Keras masih sangat dominan. Saat ini (2026), PyTorch sudah jauh lebih populer di kalangan researcher, sementara TensorFlow dan JAX lebih kuat di sisi production.

Bahasa Pemrograman untuk Deep Learning

Meskipun Python adalah bahasa paling dominan, beberapa framework juga mendukung bahasa lain:

Python → Paling populer dan memiliki ekosistem terlengkap
Julia → Performa tinggi, cocok untuk komputasi ilmiah
Scala → Sering digunakan bersama Spark
R → Masih digunakan di beberapa kalangan statistik
C++ → Untuk performa maksimal dan deployment

Cara Memilih Deep Learning Framework

Menurut buku ini, ada beberapa faktor yang perlu dipertimbangkan saat memilih framework:

Kemudahan Penggunaan — Seberapa cepat kamu bisa membuat model pertama?
Performa — Seberapa cepat training dan inference-nya?
Fleksibilitas — Seberapa mudah membuat arsitektur custom?
Deployment — Seberapa mudah model dideploy ke production?
Komunitas & Dokumentasi — Seberapa besar dukungan komunitas?
Integrasi — Seberapa baik terintegrasi dengan tools lain yang kamu pakai?

Rekomendasi praktis saat ini (2026):

Pemula / Prototyping cepat → Mulai dengan Keras (atau PyTorch Lightning)
Research & Eksperimen → PyTorch
Production & Scalability → TensorFlow atau JAX
Deployment ke perangkat kecil/edge → MXNet atau ONNX

Deep Learning Methodologies & Applications

Deep learning tidak hanya tentang neural network biasa. Beberapa metodologi penting yang dibahas:

Feedforward Neural Networks (MLP) — Untuk data tabular
Convolutional Neural Networks (CNN) — Untuk data gambar & spasial
Recurrent Neural Networks (RNN) & LSTM — Untuk data sekuensial (teks, time series)
Autoencoders — Untuk dimensionality reduction & anomaly detection
Generative Adversarial Networks (GANs) — Untuk generate data baru

Kesimpulan Bagian 2

Deep learning framework adalah senjata utama bagi data scientist modern. Memahami karakteristik masing-masing framework akan membantu kamu memilih tools yang tepat sesuai kebutuhan proyek.

← Kembali ke Daftar Isi

Bagian 3: Membangun Neural Network dengan MXNet

Di Bagian 2, kita sudah membahas berbagai deep learning framework. Sekarang kita akan mulai hands-on dengan salah satu framework yang dibahas cukup detail di buku, yaitu Apache MXNet.

Mengapa MXNet?

MXNet dipilih karena beberapa kelebihan:

Ringan dan cepat
Mendukung banyak bahasa pemrograman
Memiliki Gluon — interface yang lebih mudah digunakan
Cocok untuk deployment ke berbagai platform (termasuk perangkat edge)

Meskipun saat ini PyTorch dan TensorFlow lebih populer, memahami MXNet tetap bermanfaat karena konsep dasarnya mirip dengan framework lain.

Komponen Utama MXNet

1. Gluon Interface

Gluon adalah high-level API di MXNet yang membuat pembuatan neural network menjadi jauh lebih mudah. Kamu bisa menginstallnya dengan:

pip install mxnet --pre --user

Kelebihan Gluon:

Lebih sederhana dibandingkan low-level API
Mendukung dynamic graph (lebih fleksibel)
Performa tetap tinggi

2. NDArray

NDArray adalah struktur data utama di MXNet, mirip dengan NumPy array, tapi dengan kelebihan:

Mendukung komputasi asinkron di CPU/GPU
Bisa digunakan di distributed computing
Mendukung automatic differentiation

Contoh penggunaan NDArray:

from mxnet import nd
import mxnet as mx

# Membuat array kosong
x = nd.empty((4, 5))

# Membuat array berisi nol
x = nd.zeros((4, 5))

# Mengecek shape dan size
print(x.shape)
print(x.size)

Kamu juga bisa menentukan context (CPU atau GPU):

# Data di CPU
data_ctx = mx.cpu()

# Model di GPU pertama
model_ctx = mx.gpu(0)

Membangun MLP (Multi-Layer Perceptron) dengan MXNet

Berikut adalah langkah-langkah membangun neural network sederhana untuk klasifikasi menggunakan MXNet + Gluon.

Langkah 1: Persiapan Data

import mxnet as mx
from mxnet import gluon, nd
import numpy as np

# Parameter
BatchSize = 64
DataCtx = mx.cpu()
ModelCtx = mx.cpu()   # ganti ke mx.gpu(0) jika pakai GPU

# Load data (contoh menggunakan data sintetis)
with open("../data/data1.csv") as f:
    data_raw = f.read()

lines = data_raw.splitlines()
ndp = len(lines)

X = nd.zeros((ndp, 3), ctx=DataCtx)
Y = nd.zeros((ndp, 1), ctx=DataCtx)

for i, line in enumerate(lines):
    tokens = line.split()
    Y[i] = int(tokens[0])
    for token in tokens[1:]:
        index = int(token[:-2]) - 1
        X[i, index] = 1

Langkah 2: Membagi Data Train & Test

r = 0.8
n = int(np.round(ndp * r))

train_data = gluon.data.DataLoader(
    gluon.data.ArrayDataset(X[:n], Y[:n]),
    batch_size=BatchSize, shuffle=True
)

test_data = gluon.data.DataLoader(
    gluon.data.ArrayDataset(X[n:], Y[n:]),
    batch_size=BatchSize, shuffle=False
)

Langkah 3: Membangun Model

Kita akan membuat MLP sederhana dengan 2 hidden layer:

from mxnet.gluon import nn

net = nn.Sequential()
net.add(nn.Dense(256, activation='relu'))   # Hidden layer 1
net.add(nn.Dense(256, activation='relu'))   # Hidden layer 2
net.add(nn.Dense(3))                        # Output layer (3 kelas)

Langkah 4: Inisialisasi Parameter

net.initialize(mx.init.Normal(sigma=0.01), ctx=ModelCtx)

Langkah 5: Mendefinisikan Loss Function & Optimizer

softmax_cross_entropy = gluon.loss.SoftmaxCrossEntropyLoss()
trainer = gluon.Trainer(net.collect_params(), 'sgd', {'learning_rate': 0.001})

Langkah 6: Training Loop

epochs = 10

for epoch in range(epochs):
    cumulative_loss = 0
    for i, (data, label) in enumerate(train_data):
        data = data.as_in_context(ModelCtx)
        label = label.as_in_context(ModelCtx)
        
        with mx.autograd.record():
            output = net(data)
            loss = softmax_cross_entropy(output, label)
        loss.backward()
        trainer.step(BatchSize)
        
        cumulative_loss += nd.sum(loss).asscalar()
    
    print(f"Epoch {epoch}. Loss: {cumulative_loss/ndp}")

Langkah 7: Evaluasi Model

def evaluate_accuracy(data_iterator, net):
    numerator = 0.
    denominator = 0.
    for i, (data, label) in enumerate(data_iterator):
        data = data.as_in_context(ModelCtx)
        label = label.as_in_context(ModelCtx)
        output = net(data)
        predictions = nd.argmax(output, axis=1)
        numerator += nd.sum(predictions == label)
        denominator += data.shape[0]
    return (numerator / denominator).asscalar()

print("Train Accuracy:", evaluate_accuracy(train_data, net))
print("Test Accuracy:", evaluate_accuracy(test_data, net))

Tips dari Buku

Gunakan NDArray untuk data yang membutuhkan komputasi berat.
Manfaatkan Gluon untuk mempercepat development.
Selalu pisahkan context antara data dan model jika menggunakan GPU.
Simpan model setelah training menggunakan net.save_parameters("model.params").

Kesimpulan Bagian 3

MXNet dengan Gluon memberikan keseimbangan yang baik antara kemudahan penggunaan dan performa. Meskipun tidak sepopuler PyTorch atau TensorFlow saat ini, konsep yang dipelajari di MXNet sangat transferable ke framework lain.

← Kembali ke Daftar Isi

Bagian 4: TensorFlow & Keras

Di Bagian 3, kita sudah praktik membangun neural network menggunakan MXNet + Gluon. Sekarang kita beralih ke dua framework yang sangat populer: TensorFlow dan Keras.

TensorFlow: Framework Paling Matang untuk Production

TensorFlow dikembangkan oleh Google dan saat ini menjadi salah satu framework deep learning paling powerful, terutama untuk kebutuhan production dan scalability.

Arsitektur TensorFlow

TensorFlow bekerja berdasarkan computational graph. Artinya:

Kamu mendefinisikan graph terlebih dahulu (operasi dan variabel)
Kemudian menjalankan graph tersebut dalam session

Meskipun di versi terbaru (TensorFlow 2.x) sudah lebih eager execution (mirip PyTorch), pemahaman tentang graph tetap penting.

Core Components TensorFlow

Beberapa komponen utama:

Tensor — Struktur data dasar (mirip array multi-dimensi)
Variable — Variabel yang bisa diubah selama training (biasanya bobot model)
Placeholder (di TF 1.x) / tf.data (di TF 2.x) — Untuk memasukkan data
Session (di TF 1.x) — Untuk menjalankan graph
tf.function (di TF 2.x) — Untuk mengubah Python function menjadi graph

TensorFlow in Action (Contoh Sederhana)

Berikut contoh membuat model sederhana di TensorFlow 2.x:

import tensorflow as tf
from tensorflow.keras import layers, models

# Membuat model Sequential
model = models.Sequential([
    layers.Dense(256, activation='relu', input_shape=(3,)),
    layers.Dense(256, activation='relu'),
    layers.Dense(3, activation='softmax')
])

# Compile model
model.compile(optimizer='adam',
              loss='sparse_categorical_crossentropy',
              metrics=['accuracy'])

# Training
model.fit(train_data, train_labels, epochs=10, batch_size=64)

TensorBoard: Visualisasi Training

Salah satu keunggulan besar TensorFlow adalah TensorBoard — tools visualisasi yang sangat powerful.

import tensorflow as tf

# Callback TensorBoard
tensorboard_callback = tf.keras.callbacks.TensorBoard(log_dir="./logs")

model.fit(train_data, train_labels, 
          epochs=10, 
          callbacks=[tensorboard_callback])

Kamu bisa melihat:

Grafik loss dan akurasi
Arsitektur model
Distribusi bobot
Profiling performa

High-Level API: Estimators

TensorFlow juga menyediakan Estimators — high-level API yang lebih abstrak dan cocok untuk production.

Kelebihan Estimators:

Lebih mudah untuk scaling
Built-in support untuk distributed training
Lebih aman untuk production

Keras: Deep Learning yang User-Friendly

Keras awalnya adalah library terpisah, tapi sekarang sudah terintegrasi penuh ke dalam TensorFlow sebagai tf.keras.

Mengapa Keras Sangat Populer?

Sangat mudah dipelajari — Cocok untuk pemula
Cepat untuk prototyping
Dokumentasi sangat baik
Bisa berjalan di atas TensorFlow, Theano, atau CNTK (dulu)

Membangun Model dengan Keras

from tensorflow.keras.models import Sequential
from tensorflow.keras.layers import Dense

model = Sequential()
model.add(Dense(256, activation='relu', input_dim=3))
model.add(Dense(256, activation='relu'))
model.add(Dense(3, activation='softmax'))

model.compile(optimizer='adam',
              loss='categorical_crossentropy',
              metrics=['accuracy'])

Model Summary & Visualization

model.summary()                    # Melihat ringkasan model

from tensorflow.keras.utils import plot_model
plot_model(model, to_file='model.png', show_shapes=True)

Mengubah Keras Model ke TensorFlow Estimators

Salah satu fitur menarik adalah kemampuan mengubah model Keras menjadi Estimator:

import tensorflow as tf

estimator = tf.keras.estimator.model_to_estimator(
    keras_model=model,
    model_dir="./estimator_model"
)

Ini sangat berguna jika kamu ingin memanfaatkan kelebihan Estimator untuk production.

Perbandingan TensorFlow vs Keras

Aspek	TensorFlow	Keras
Tingkat Kesulitan	Sedang - Tinggi	Sangat Mudah
Fleksibilitas	Sangat Tinggi	Sedang
Kecepatan Prototyping	Sedang	Sangat Cepat
Cocok untuk Production	Sangat Baik	Baik (terutama lewat TF)
Visualisasi	TensorBoard (sangat kuat)	Terbatas
Rekomendasi Saat Ini	Production & Large-scale projects	Pemula, Research, Rapid Prototyping

Kesimpulan Bagian 4

TensorFlow adalah pilihan yang kuat untuk proyek yang sudah masuk tahap production dan membutuhkan skalabilitas tinggi.
Keras adalah pilihan terbaik untuk pemula dan untuk prototyping cepat.
Saat ini, hampir semua orang menggunakan tf.keras (Keras yang terintegrasi dengan TensorFlow).

← Kembali ke Daftar Isi

Bagian 5: Optimization Algorithms (PSO, Genetic Algorithm, Simulated Annealing)

Di bagian sebelumnya kita banyak membahas Deep Learning Frameworks. Sekarang kita akan membahas topik yang sangat penting tapi sering kurang mendapat perhatian: Optimization Algorithms.

Mengapa Optimization Penting dalam Data Science?

Dalam machine learning dan deep learning, kita selalu berusaha menemukan parameter terbaik untuk model kita. Proses ini disebut optimization.

Tujuan utama optimization adalah:

Meminimalkan loss function (error)
Memaksimalkan performa model
Menemukan solusi terbaik dalam ruang parameter yang sangat besar

Algoritma optimisasi klasik seperti Gradient Descent sangat populer, tapi ada algoritma lain yang lebih powerful untuk kasus tertentu, terutama ketika:

Fungsi loss sangat kompleks dan non-konveks
Terdapat banyak local minima
Butuh eksplorasi global yang lebih baik

Tiga algoritma yang akan kita bahas di sini adalah:

Particle Swarm Optimization (PSO)
Genetic Algorithm (GA)
Simulated Annealing (SA)

1. Particle Swarm Optimization (PSO)

PSO terinspirasi dari perilaku kawanan burung atau ikan yang bergerak bersama mencari makanan.

Konsep Dasar PSO:

Ada sekumpulan partikel yang bergerak di ruang pencarian.
Setiap partikel punya posisi dan kecepatan.
Setiap partikel mengingat posisi terbaik yang pernah dicapainya (personal best).
Ada juga posisi terbaik secara global (global best).
Partikel bergerak mengikuti kombinasi personal best dan global best.

Kelebihan PSO:

Relatif sederhana dan mudah diimplementasikan
Bagus untuk optimisasi global
Tidak membutuhkan gradient (derivative-free)
Cocok untuk masalah dengan banyak local minima

Kelemahan:

Bisa stuck di local optimum jika parameter tidak diatur dengan baik
Performa bisa menurun pada dimensi yang sangat tinggi

2. Genetic Algorithm (GA)

Genetic Algorithm terinspirasi dari proses evolusi dan seleksi alam.

Cara Kerja GA:

Inisialisasi — Membuat populasi solusi secara acak
Evaluasi — Menghitung fitness setiap individu
Seleksi — Memilih individu terbaik untuk bereproduksi
Crossover — Menggabungkan gen dari dua individu
Mutasi — Mengubah sedikit gen secara acak (untuk eksplorasi)
Ulangi sampai kondisi berhenti terpenuhi

Kelebihan GA:

Sangat bagus untuk masalah optimisasi kombinatorial
Bisa mengeksplorasi ruang solusi yang sangat luas
Robust terhadap noise dan local minima
Bisa digunakan untuk optimisasi dengan banyak constraint

Kelemahan:

Butuh banyak komputasi (evaluasi fitness berulang kali)
Parameter (population size, mutation rate, dll) harus diatur dengan hati-hati
Konvergensi bisa lambat

3. Simulated Annealing (SA)

Simulated Annealing terinspirasi dari proses annealing dalam metalurgi (pemanasan dan pendinginan logam secara perlahan).

Konsep Utama:

Mulai dengan suhu tinggi → solusi bisa bergerak bebas (banyak eksplorasi)
Suhu diturunkan secara bertahap
Pada suhu rendah, hanya solusi yang lebih baik yang diterima
Memberi kesempatan untuk keluar dari local minimum di awal proses

Kelebihan SA:

Bagus untuk menghindari local minima
Relatif sederhana
Bisa digunakan untuk masalah diskrit maupun kontinu
Tidak membutuhkan gradient

Kelemahan:

Konvergensi bisa sangat lambat jika cooling schedule tidak tepat
Performa sangat bergantung pada parameter suhu awal dan laju pendinginan

Perbandingan Ketiga Algoritma

Aspek	PSO	Genetic Algorithm	Simulated Annealing
Inspirasi	Perilaku kawanan	Evolusi & seleksi alam	Proses annealing logam
Eksplorasi vs Eksploitasi	Cukup seimbang	Eksplorasi sangat baik	Mulai eksplorasi, lalu eksploitasi
Kebutuhan Gradient	Tidak butuh	Tidak butuh	Tidak butuh
Kecepatan Konvergensi	Sedang	Lambat	Bisa lambat
Kemampuan Hindari Local Minima	Baik	Sangat Baik	Baik
Kompleksitas Implementasi	Rendah	Sedang	Rendah
Cocok Untuk	Continuous optimization	Kombinatorial & kompleks	Masalah dengan banyak local minima

Kapan Menggunakan Optimization Algorithm Ini?

Gunakan PSO jika kamu butuh optimisasi yang relatif cepat dan sederhana pada masalah continuous.
Gunakan Genetic Algorithm jika masalahmu sangat kompleks, memiliki banyak constraint, atau bersifat kombinatorial.
Gunakan Simulated Annealing jika kamu sering stuck di local minimum dan butuh metode yang memberikan kesempatan untuk "melompat" keluar.

Banyak praktisi juga menggunakan hybrid approach (kombinasi beberapa algoritma) atau Optimization Ensemble.

Kesimpulan Bagian 5

Algoritma optimisasi seperti PSO, Genetic Algorithm, dan Simulated Annealing memberikan alternatif yang powerful dibandingkan Gradient Descent, terutama ketika kita menghadapi masalah optimisasi yang sulit dan kompleks.

Meskipun saat ini deep learning lebih banyak menggunakan optimizer berbasis gradient (Adam, RMSprop, dll), pemahaman tentang algoritma optimisasi metaheuristic ini sangat berguna untuk:

Hyperparameter tuning
Feature selection
Model optimization di luar deep learning
Masalah optimisasi kombinatorial

← Kembali ke Daftar Isi

Bagian 6: CNN, RNN, dan Optimization Ensemble

Di Bagian 5, kita membahas algoritma optimisasi metaheuristic seperti PSO, Genetic Algorithm, dan Simulated Annealing. Sekarang kita akan membahas dua arsitektur deep learning yang sangat penting, serta teknik lanjutan bernama Optimization Ensemble.

Convolutional Neural Networks (CNN)

CNN adalah salah satu arsitektur deep learning paling sukses, terutama untuk data yang memiliki struktur spasial seperti gambar, video, dan data sensor.

Mengapa CNN Sangat Efektif untuk Gambar?

Convolutional Layer — Menggunakan filter (kernel) untuk mengekstrak fitur lokal (edge, texture, shape).
Pooling Layer — Mengurangi dimensi sambil mempertahankan informasi penting.
Hierarchical Feature Learning — Layer awal belajar fitur sederhana, layer dalam belajar fitur yang lebih kompleks.

CNN secara otomatis belajar fitur dari data, sehingga tidak perlu feature engineering manual yang rumit seperti pada metode tradisional.

Kegunaan Utama CNN:

Image Classification
Object Detection
Image Segmentation
Medical Image Analysis
Autonomous Driving

Recurrent Neural Networks (RNN)

RNN dirancang untuk menangani data sekuensial atau data yang memiliki ketergantungan waktu.

Masalah dengan Neural Network Biasa:

Neural network biasa (termasuk MLP dan CNN) memperlakukan setiap input secara independen. Padahal banyak data di dunia nyata bersifat sekuensial, seperti:

Teks / Bahasa
Time Series
Audio / Speech
Video

Bagaimana RNN Bekerja?

RNN memiliki hidden state yang membawa informasi dari langkah sebelumnya ke langkah berikutnya. Ini memungkinkan model "mengingat" konteks sebelumnya.

Varian RNN yang populer:

LSTM (Long Short-Term Memory) — Lebih baik dalam menangani long-term dependency
GRU (Gated Recurrent Unit) — Lebih ringan dari LSTM, performa sering kompetitif

Kegunaan RNN / LSTM:

Machine Translation
Text Generation
Speech Recognition
Time Series Forecasting
Sentiment Analysis

Optimization Ensemble

Salah satu ide menarik yang dibahas di buku adalah Optimization Ensemble — yaitu menggabungkan beberapa algoritma optimisasi untuk mendapatkan performa yang lebih baik.

Mengapa Perlu Ensemble dalam Optimisasi?

Setiap algoritma optimisasi memiliki kekuatan dan kelemahan masing-masing:

Ada yang bagus dalam eksplorasi global
Ada yang bagus dalam eksploitasi lokal (fine-tuning)
Ada yang cepat konvergen, ada yang lebih robust

Dengan menggabungkan beberapa algoritma, kita bisa mendapatkan best of both worlds.

Cara Kerja Optimization Ensemble

Ada beberapa pendekatan:

Parallel Ensemble — Menjalankan beberapa optimizer secara paralel, lalu memilih atau menggabungkan hasil terbaik.
Sequential Ensemble — Menggunakan satu optimizer untuk eksplorasi kasar, lalu melanjutkan dengan optimizer lain untuk fine-tuning.
Hybrid Approach — Menggabungkan karakteristik dari beberapa algoritma ke dalam satu metode baru.

Kelebihan Optimization Ensemble:

Lebih robust terhadap local minima
Sering memberikan solusi yang lebih baik
Bisa memanfaatkan parallel computing dengan baik

Kelemahan:

Lebih kompleks untuk diimplementasikan
Butuh lebih banyak sumber daya komputasi
Parameter tuning menjadi lebih rumit

Kapan Menggunakan CNN, RNN, atau Ensemble?

Kebutuhan	Rekomendasi Utama	Alternatif
Data Gambar / Visual	CNN	Vision Transformer (modern)
Data Teks / Sekuensial	RNN / LSTM / GRU	Transformer
Optimisasi sulit + banyak local minima	Optimization Ensemble	PSO + SA hybrid
Butuh solusi robust & akurat	Ensemble	Single strong optimizer
Proyek cepat & prototyping	CNN / LSTM standalone	-

Kesimpulan Bagian 6

CNN sangat powerful untuk data yang memiliki pola spasial (gambar, dll).
RNN / LSTM unggul dalam menangani data sekuensial dan ketergantungan waktu.
Optimization Ensemble adalah teknik lanjutan yang bisa memberikan performa lebih baik dengan menggabungkan kekuatan beberapa algoritma optimisasi.

Di era modern, banyak yang sudah beralih ke Transformer untuk menggantikan RNN. Namun, pemahaman dasar tentang CNN dan RNN tetap sangat penting sebagai fondasi.

← Kembali ke Daftar Isi

Bagian 7: Alternative AI Frameworks (ELM, CapsNet, Fuzzy Logic)

Di bagian-bagian sebelumnya, kita sudah membahas framework deep learning populer (MXNet, TensorFlow, Keras) dan algoritma optimisasi. Sekarang kita akan melihat beberapa Alternative AI Frameworks yang mungkin kurang populer, tapi memiliki keunikan dan kelebihan tersendiri.

Mengapa Perlu Melihat Alternative Frameworks?

Meskipun deep learning (khususnya CNN, RNN, Transformer) sangat dominan saat ini, tidak semua masalah bisa diselesaikan dengan baik menggunakan pendekatan tersebut. Beberapa keterbatasan deep learning antara lain:

Butuh data dalam jumlah sangat besar
Training memakan waktu dan sumber daya komputasi yang besar
Sulit diinterpretasikan (black box)
Kurang efektif pada data kecil atau data dengan ketidakpastian tinggi

Karena itu, mempelajari pendekatan alternatif bisa memberikan kita lebih banyak pilihan sebagai data scientist.

1. Extreme Learning Machines (ELM)

Extreme Learning Machine adalah jenis single-hidden layer feedforward neural network yang proses training-nya sangat cepat.

Konsep Utama ELM:

Bobot antara input layer dan hidden layer diinisialisasi secara acak dan tidak perlu di-update.
Hanya bobot antara hidden layer dan output layer yang dihitung secara analitis (menggunakan pseudoinverse).
Tidak menggunakan backpropagation seperti neural network biasa.

Kelebihan ELM:

Sangat cepat dalam training (bisa ratusan kali lebih cepat dari backpropagation)
Tidak perlu tuning banyak hyperparameter
Performa sering kompetitif untuk masalah klasifikasi dan regresi
Cocok untuk data yang tidak terlalu besar

Kelemahan ELM:

Kurang fleksibel dibanding deep learning
Performa bisa kurang stabil karena inisialisasi acak
Kurang cocok untuk data yang sangat kompleks (gambar resolusi tinggi, dll)

ELM sangat cocok digunakan ketika kamu butuh model yang cepat dilatih dan data tidak terlalu besar.

2. Capsule Networks (CapsNet)

Capsule Networks diusulkan oleh Geoffrey Hinton (salah satu "godfather" deep learning) sebagai alternatif dari CNN.

Masalah yang Ingin Diselesaikan CapsNet:

CNN bagus dalam mendeteksi fitur, tapi kurang memperhatikan hubungan spasial antar fitur. Misalnya, CNN bisa mengenali mata, hidung, dan mulut, tapi tidak selalu peduli apakah posisinya sudah benar membentuk wajah.

Konsep Capsule:

Capsule adalah kelompok neuron yang merepresentasikan suatu entitas (misalnya: objek, bagian objek).
Setiap capsule menghasilkan vektor, bukan scalar.
Panjang vektor merepresentasikan probabilitas keberadaan entitas.
Arah vektor merepresentasikan properti entitas (posisi, orientasi, dll).
Menggunakan dynamic routing untuk menghubungkan antar capsule.

Kelebihan CapsNet:

Lebih baik dalam memahami hierarki dan hubungan spasial
Lebih robust terhadap perubahan pose dan orientasi
Potensi lebih interpretabel dibanding CNN

Kelemahan CapsNet:

Training lebih lambat dan kompleks
Belum sepopuler CNN
Masih dalam tahap pengembangan aktif

CapsNet menarik untuk dipelajari jika kamu bekerja di bidang computer vision dan ingin memahami pendekatan yang berbeda dari CNN.

3. Fuzzy Logic dan Fuzzy Inference Systems

Fuzzy Logic berbeda dari pendekatan lain karena dirancang untuk menangani ketidakpastian dan ketidakjelasan (vagueness).

Perbedaan dengan Logika Klasik:

Logika klasik: Sesuatu hanya bisa True (1) atau False (0)
Fuzzy Logic: Sesuatu bisa memiliki derajat kebenaran antara 0 sampai 1 (misalnya: "agak panas", "cukup tinggi", "sedikit berawan")

Komponen Utama Fuzzy Inference System:

Fuzzification — Mengubah input crisp menjadi nilai fuzzy
Rule Base — Kumpulan aturan if-then (misalnya: IF suhu tinggi AND kelembaban tinggi THEN AC menyala kuat)
Inference Engine — Mengevaluasi aturan
Defuzzification — Mengubah output fuzzy menjadi nilai crisp

Kelebihan Fuzzy Logic:

Sangat baik untuk sistem yang sulit dimodelkan secara matematis
Mudah diinterpretasikan (aturan dalam bentuk bahasa manusia)
Cocok untuk sistem kontrol dan decision support
Bisa dikombinasikan dengan neural network (Neuro-Fuzzy)

Kelemahan Fuzzy Logic:

Membutuhkan pengetahuan ahli untuk membuat aturan
Sulit untuk data berdimensi tinggi
Performa bisa kalah dengan deep learning pada tugas pattern recognition kompleks

Perbandingan Alternative Frameworks

Framework	Kecepatan Training	Interpretabilitas	Cocok Untuk	Kompleksitas Implementasi
Extreme Learning Machine	Sangat Cepat	Sedang	Data sedang, klasifikasi/regresi cepat	Rendah
Capsule Networks	Lambat	Tinggi	Computer Vision, hierarki objek	Tinggi
Fuzzy Logic	Cepat	Sangat Tinggi	Sistem kontrol, decision making	Sedang

Kesimpulan Bagian 7

Meskipun deep learning saat ini mendominasi, memahami alternative frameworks seperti ELM, CapsNet, dan Fuzzy Logic memberikan kita toolkit yang lebih lengkap.

Gunakan ELM jika butuh model cepat dengan data tidak terlalu besar.
Pelajari CapsNet jika tertarik dengan computer vision yang lebih memahami struktur objek.
Manfaatkan Fuzzy Logic untuk sistem yang membutuhkan interpretabilitas tinggi dan penanganan ketidakpastian.

← Kembali ke Daftar Isi

Bagian 8: Transfer Learning, Reinforcement Learning, Autoencoder & GANs

Di Bagian 7, kita membahas alternative frameworks. Sekarang kita masuk ke beberapa topik lanjutan yang sangat penting dalam AI modern:

Transfer Learning
Reinforcement Learning
Autoencoder
Generative Adversarial Networks (GANs)

1. Transfer Learning

Transfer Learning adalah teknik di mana kita menggunakan model yang sudah dilatih sebelumnya (pre-trained model) untuk menyelesaikan masalah baru.

Kapan Transfer Learning Sangat Berguna?

Data yang kamu miliki terbatas
Training model dari nol membutuhkan waktu dan sumber daya yang sangat besar
Masalah baru memiliki kemiripan dengan masalah yang sudah pernah diselesaikan

Cara Kerja Transfer Learning:

Ambil model yang sudah dilatih di dataset besar (misalnya ImageNet)
Gunakan sebagian besar layer-nya sebagai feature extractor
Ganti atau tambahkan layer terakhir sesuai dengan jumlah kelas baru
Fine-tune (opsional) — latih ulang beberapa layer terakhir dengan data kamu

Kelebihan Transfer Learning:

Training jauh lebih cepat
Performa sering lebih baik meskipun data sedikit
Menghemat biaya komputasi

Kapan Tidak Cocok:

Domain sangat berbeda (misalnya pakai model gambar untuk data teks)
Data kamu sangat spesifik dan unik

2. Reinforcement Learning (RL)

Reinforcement Learning adalah paradigma machine learning di mana agent belajar melalui interaksi dengan lingkungan dan menerima reward atau punishment.

Konsep Kunci dalam RL:

Agent — Entitas yang belajar dan mengambil keputusan
Environment — Dunia tempat agent berinteraksi
State — Kondisi saat ini dari environment
Action — Tindakan yang bisa dilakukan agent
Reward — Umpan balik (positif atau negatif)
Policy — Strategi yang dipelajari agent untuk memilih action

Jenis-jenis RL:

Value-based (misalnya Q-Learning, Deep Q-Network)
Policy-based (misalnya REINFORCE, Policy Gradient)
Actor-Critic (kombinasi value dan policy)

Aplikasi Reinforcement Learning:

Game playing (AlphaGo, Atari games)
Robot control
Resource management
Trading / Portfolio optimization
Recommendation systems

Reinforcement Learning sangat powerful, tapi training-nya sering tidak stabil dan membutuhkan banyak trial-and-error.

3. Autoencoder Systems

Autoencoder adalah jenis neural network yang dilatih untuk merekonstruksi input-nya sendiri.

Struktur Autoencoder:

Encoder — Mengompresi input menjadi representasi berdimensi rendah (latent space)
Decoder — Merekonstruksi input dari representasi tersebut

Tujuan Utama Autoencoder:

Dimensionality Reduction (mirip PCA tapi non-linear)
Feature Learning
Anomaly Detection (data yang sulit direkonstruksi = anomali)
Denoising (membersihkan noise dari data)
Data Generation (variasi tertentu)

Jenis-jenis Autoencoder:

Vanilla Autoencoder
Denoising Autoencoder
Sparse Autoencoder
Variational Autoencoder (VAE) — sangat populer untuk generative modeling

4. Generative Adversarial Networks (GANs)

GAN adalah salah satu ide paling inovatif dalam deep learning. Diperkenalkan oleh Ian Goodfellow pada 2014.

Cara Kerja GAN:

GAN terdiri dari dua neural network yang saling bersaing:

Generator — Mencoba membuat data palsu yang mirip data asli
Discriminator — Mencoba membedakan data asli dan data palsu

Keduanya dilatih secara bersamaan dalam proses adversarial training.

Tujuan GAN:

Generator belajar membuat data yang semakin realistis
Discriminator menjadi semakin baik dalam mendeteksi data palsu

Aplikasi GAN:

Image generation (membuat wajah manusia yang tidak nyata)
Image-to-Image translation (ubah foto jadi lukisan, dll)
Super-resolution
Data augmentation
Music dan video generation

Tantangan dalam Training GAN:

Sulit untuk melatih (mode collapse, training instability)
Butuh banyak tuning hyperparameter
Evaluasi kualitas hasil sulit dilakukan secara objektif

Ringkasan Keempat Topik

Topik	Tujuan Utama	Data yang Dibutuhkan	Tingkat Kesulitan	Contoh Penggunaan
Transfer Learning	Manfaatkan model pre-trained	Sedang - Kecil	Rendah - Sedang	Image classification dengan data terbatas
Reinforcement Learning	Belajar melalui reward & punishment	Lingkungan simulasi	Tinggi	Game AI, Robot, Trading
Autoencoder	Kompresi & rekonstruksi data	Tanpa label	Sedang	Anomaly detection, Dimensionality reduction
GANs	Generate data baru yang realistis	Data asli	Tinggi	Image generation, Data augmentation

Kesimpulan Bagian 8

Keempat topik ini mewakili arah penting dalam perkembangan AI:

Transfer Learning → Membuat deep learning lebih praktis untuk data kecil
Reinforcement Learning → Membuka jalan bagi AI yang bisa belajar dari interaksi
Autoencoder → Memberikan cara untuk memahami dan memanipulasi representasi data
GANs → Membuka era generative AI yang semakin berkembang pesat

Banyak teknik modern saat ini (seperti Stable Diffusion, GPT, dll) dibangun di atas fondasi ide-ide dari topik-topik di atas.

← Kembali ke Daftar Isi

Bagian 9: Aspek Bisnis Penerapan AI dalam Proyek Data Science

Selamat datang di Bagian terakhir dari seri ini.

Di delapan artikel sebelumnya, kita sudah membahas banyak hal secara teknis — mulai dari framework deep learning, optimisasi, CNN, RNN, sampai GANs. Sekarang saatnya kita melihat sisi lain yang tidak kalah penting: aspek bisnis dari penerapan AI dalam proyek data science.

Mengapa Aspek Bisnis Penting?

Banyak proyek AI gagal bukan karena teknologinya buruk, melainkan karena:

Tidak ada business case yang jelas
ROI (Return on Investment) tidak terukur
Kurangnya dukungan dari stakeholder bisnis
Terlalu fokus pada teknologi, kurang fokus pada value yang dihasilkan

Seorang data scientist atau AI practitioner yang baik tidak hanya harus mahir secara teknis, tetapi juga harus memahami bagaimana AI bisa memberikan dampak bisnis yang nyata.

Teknologi AI yang Relevan untuk Bisnis

Berikut beberapa teknologi AI yang paling banyak memberikan value bisnis saat ini:

Teknologi	Contoh Aplikasi Bisnis	Potensi ROI
Predictive Analytics	Prediksi churn, demand forecasting	Tinggi
Computer Vision	Quality control, surveillance, retail	Sedang - Tinggi
Natural Language Processing	Chatbot, sentiment analysis, document processing	Tinggi
Recommendation Systems	E-commerce, content platform	Sangat Tinggi
Anomaly Detection	Fraud detection, system monitoring	Tinggi
Generative AI	Content creation, design, code generation	Sedang (sedang berkembang)

Industri yang Paling Diuntungkan dari AI

Beberapa industri yang saat ini paling agresif mengadopsi AI:

Financial Services — Fraud detection, credit scoring, algorithmic trading
Healthcare — Medical imaging, drug discovery, patient risk prediction
Retail & E-commerce — Personalization, inventory optimization, visual search
Manufacturing — Predictive maintenance, quality control, supply chain
Telecommunication — Customer churn prediction, network optimization
Logistics & Transportation — Route optimization, demand forecasting

Sumber Daya AI yang Penting

Untuk berhasil menerapkan AI di lingkungan bisnis, organisasi perlu memperhatikan beberapa hal:

Data Infrastructure — Kualitas dan ketersediaan data adalah fondasi
Talent — Data scientist, ML engineer, data engineer, dan AI product manager
Tools & Platform — Cloud (AWS, GCP, Azure), MLOps tools, AutoML
Governance & Ethics — Data privacy, model fairness, explainability
Change Management — Mengubah cara kerja tim agar bisa memanfaatkan AI

Pendidikan Data Science untuk Proyek AI

Buku ini juga menekankan pentingnya pendidikan yang tepat. Beberapa rekomendasi:

Mulai dari dasar yang kuat (statistika, programming, data wrangling)
Jangan langsung loncat ke deep learning tanpa memahami machine learning dasar
Pahami konteks bisnis dari setiap proyek
Terus belajar karena bidang ini berkembang sangat cepat
Bangun portfolio proyek nyata, bukan hanya tutorial

Pelajaran Penting dari Seri Ini

Sepanjang 9 artikel ini, ada beberapa takeaway utama:

AI bukan magic — Ia adalah tools yang powerful jika digunakan dengan tepat.
Pilih framework sesuai kebutuhan, bukan karena sedang tren.
Optimization matters — Baik di level model maupun di level bisnis.
Jangan hanya fokus ke akurasi — Value bisnis, interpretability, dan scalability juga penting.
Selalu ada trade-off — Antara performa, kecepatan, biaya, dan kompleksitas.
Hybrid approach sering lebih baik daripada hanya mengandalkan satu metode.

Penutup

Buku "AI for Data Science" memberikan pandangan yang cukup komprehensif tentang berbagai pendekatan AI yang bisa digunakan dalam data science — bukan hanya deep learning, tapi juga optimization algorithms, alternative frameworks, dan aspek bisnis.

Sebagai praktisi, tugas kita adalah:

Terus belajar dan bereksperimen
Memilih tools yang tepat untuk masalah yang dihadapi
Selalu menghubungkan pekerjaan teknis dengan dampak bisnis yang nyata

Terima kasih sudah mengikuti seri ini sampai akhir.

Sumber Utama:
Buku AI for Data Science oleh Zacharias Voulgaris, PhD & Yunus Emrah Bulut (Technics Publications, 2018)

← Kembali ke Daftar Isi

Penutup & Ringkasan Seri

Seri ini terdiri dari 9 bagian:

No	Bagian	Fokus Utama
1	Pengantar AI	Konsep dasar AI & relevansinya untuk data science
2	Deep Learning Frameworks	MXNet, TensorFlow, Keras, PyTorch
3	MXNet Hands-on	Membangun MLP dengan Gluon
4	TensorFlow & Keras	Production-ready frameworks
5	Optimization Algorithms	PSO, Genetic Algorithm, Simulated Annealing
6	CNN, RNN & Ensemble	Advanced deep learning + optimization ensemble
7	Alternative Frameworks	ELM, CapsNet, Fuzzy Logic
8	Advanced Topics	Transfer Learning, RL, Autoencoder, GANs
9	Aspek Bisnis	Value bisnis, industri, dan pelajaran praktis

Terima kasih telah membaca ebook ini.

Semoga seri ini membantu kamu memahami berbagai pendekatan AI yang bisa digunakan dalam data science, bukan hanya deep learning, tetapi juga metode optimisasi, framework alternatif, dan yang paling penting — bagaimana menghubungkan semuanya dengan dampak bisnis yang nyata.

Akhir dari Ebook

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/ai-untuk-data-science-panduan-lengkap-dari-dasar-hingga-praktik-bisnis/

Panduan Lengkap Membangun Hermes AI Agent 2026: Dari Nol sampai Production

Ngopidulur — Fri, 22 May 2026 14:15:00 GMT

Hermes Agent adalah framework AI Agent open-source dari Nous Research yang sangat powerful. Bukan sekadar chatbot biasa, melainkan co-pilot digital yang bisa belajar sendiri, mengingat preferensi kamu, dan bekerja secara otonom.

Artikel ini merangkum panduan praktis membangun Hermes AI Agent dari nol hingga siap digunakan di production, berdasarkan pengalaman langsung (update Mei 2026).

Apa yang Membuat Hermes Berbeda?

Hermes memiliki beberapa keunggulan utama:

Self-improving via Skills — Hermes bisa menyimpan cara menyelesaikan tugas kompleks sebagai skill yang bisa dipakai lagi di masa depan.
Persistent Memory — Mengingat siapa kamu, preferensi, lingkungan kerja, dan pelajaran dari kesalahan sebelumnya.
Multi-Platform Gateway — Bisa diakses dari Telegram, Discord, WhatsApp, Slack, dan lainnya dengan satu otak yang sama.
Provider-Agnostic — Bebas menggunakan DeepSeek, Claude, GPT, Gemini, atau model lokal (Ollama).
Profiles — Bisa membuat beberapa instance Hermes dengan tugas dan kepribadian berbeda (misalnya: satu untuk trading, satu untuk coding).

Persiapan Sebelum Install

Rekomendasi VPS

Untuk penggunaan 24/7, disarankan menggunakan VPS:

Raff Technologies → Paling stabil untuk Hermes
DigitalOcean → $6/bulan (1GB RAM)
Vultr → Mulai dari $2.5/bulan
Contabo → Spesifikasi besar dengan harga murah

API Key yang Disarankan

API Key	Kegunaan	Biaya	Rekomendasi
OpenRouter	Testing & fallback	Gratis tier	Sangat disarankan
DeepSeek	Model utama (cepat & murah)	Murah	Paling direkomendasikan
Google AI	Vision (analisis gambar)	Gratis	Untuk vision
Telegram Bot	Gateway	Gratis	Wajib

Instalasi Hermes Agent

Cara paling mudah (Recommended):

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Setelah selesai, verifikasi dengan:

hermes doctor
hermes --version

Konfigurasi Model & Provider

Penulis merekomendasikan DeepSeek V4 Flash sebagai model utama karena cepat dan murah.

Contoh konfigurasi:

hermes config set model.default deepseek-v4-flash
hermes config set model.provider deepseek

Rekomendasi Setup Model:

Model Utama: DeepSeek V4 Flash
Vision: Google Gemini (gratis & rate limit tinggi)
Fallback: Siapkan minimal satu provider cadangan

Skills — Fitur Paling Penting

Skills adalah kemampuan Hermes untuk menyimpan prosedur kerja. Ini yang membuat Hermes semakin pintar seiring waktu.

hermes skills list
hermes skills install crypto-market-analysis
hermes skills install trading-workflow
hermes skills install pdf-report

Tips: Setiap kali kamu menyelesaikan tugas yang rumit, suruh Hermes menyimpannya sebagai skill.

Gateway (Telegram, Discord, dll)

Gateway memungkinkan kamu berinteraksi dengan Hermes dari berbagai platform.

Setup Telegram Gateway (paling direkomendasikan):

hermes gateway setup
hermes gateway install
hermes gateway start

Setelah aktif, kamu bisa chat dengan Hermes langsung dari Telegram.

Cron Jobs & Otomatisasi

Hermes bisa menjalankan tugas secara otomatis menggunakan cron.

Contoh:

hermes cron create "0 8 * * *" \
  --name "Daily Report" \
  --skills vps-health,pdf-report \
  --deliver telegram

Trading dengan Hermes

Hermes sudah mendukung berbagai kebutuhan trading:

Analisa crypto (funding rate, market structure)
Token screening
Signal synthesis
Analisa saham Indonesia

Cukup install skill trading yang dibutuhkan, lalu kamu bisa bertanya langsung seperti:

“Analisa BTC funding rate sekarang” “Screening token baru di Solana” “Sinyal apa yang converging hari ini?”

Tips dari Pengalaman Langsung

Minimal Model Configuration — Cukup gunakan 2 model (utama + vision).
Prioritaskan Skill — Jangan ulangi pekerjaan yang sama. Buat skill.
Gunakan Cron dengan Bijak — Override model ke yang gratis untuk tugas rutin.
Backup Rutin — Selalu backup folder ~/.hermes/.
Mulai Sederhana — Jangan langsung pakai banyak API key.
Manfaatkan Profiles — Buat profile terpisah untuk trading, coding, dan research.

Troubleshooting Singkat

Masalah	Solusi
Vision error	Ganti provider vision
Cron tidak jalan	Override model ke yang gratis
Gateway mati	Jalankan `loginctl enable-linger`
Memory hilang	Cek `hermes memory status`
Tools tidak muncul	Aktifkan toolset yang dibutuhkan

Kesimpulan

Hermes AI Agent adalah salah satu framework AI Agent terbaik saat ini untuk kebutuhan personal dan semi-profesional. Dengan kombinasi Skills + Persistent Memory + Gateway + Cron, kamu bisa membangun asisten digital yang benar-benar bekerja untukmu.

Makin sering digunakan, makin pintar, dan makin sesuai dengan kebiasaan kerja kamu.

Sumber: Panduan Lengkap Membangun Hermes AI Agent oleh Noctis (@sequencetraders), Mei 2026.

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/panduan-lengkap-membangun-hermes-ai-agent-2026-dari-nol-sampai-production/

Panduan Instalasi Hermes AI Agent 2026: Dari VPS Kosong sampai Siap Pakai

Ngopidulur — Fri, 22 May 2026 14:11:00 GMT

Baru mau coba bikin AI Agent sendiri? Hermes Agent dari Nous Research adalah salah satu framework agent yang paling powerful dan fleksibel di 2026.

Artikel ini merangkum panduan instalasi lengkap Hermes AI Agent — mulai dari VPS Linux, macOS, sampai Windows via WSL2. Cocok buat pemula maupun yang sudah punya pengalaman self-hosting.

Minimum Requirements

Komponen	Linux	macOS	Windows (WSL)
CPU	1 Core	Intel / Apple Silicon	Any x64
RAM	1 GB	4 GB+	4 GB+
Storage	10 GB	10 GB	10 GB
Python	3.10+	3.10+	3.10+
Node.js	18.x+	18.x+	18.x+

Rekomendasi: Untuk production 24/7, pakai VPS Linux. Untuk belajar, laptop Mac/Windows juga cukup.

1. Linux (Ubuntu/Debian) – Paling Direkomendasikan

Panduan ini untuk Ubuntu 22.04 / 24.04.

Step 1: Update Sistem

sudo apt update && sudo apt upgrade -y

Step 2: Install Dependencies

sudo apt install -y curl git python3 python3-pip python3-venv build-essential ffmpeg tesseract-ocr

Step 3: Install Node.js 20.x

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs
node --version

Step 4: Install Hermes Agent (Pilih salah satu)

Opsi A – Install Script (Recommended)

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Opsi B – Install dari Source

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
pip install -e .
hermes doctor

Step 5: Verifikasi

hermes doctor
hermes --version

Kalau semua hijau, instalasi Linux berhasil!

2. macOS (Intel & Apple Silicon)

Step 1: Install Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Step 2: Install Dependencies

brew install python@3.12 node git curl ffmpeg tesseract

Untuk Apple Silicon + GPU acceleration (opsional):

brew install --cask llama.cpp

Step 3: Install Hermes Agent

Sama seperti Linux:

# Opsi A (Recommended)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# Opsi B
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
pip3 install -e .
hermes doctor

Step 4: Fix PATH (jika perlu)

Tambahkan ke ~/.zshrc:

export PATH="$PATH:~/.local/bin"

3. Windows (WSL2)

Hermes tidak bisa jalan native di Windows. Harus lewat WSL2.

Step 1: Install WSL2

Buka PowerShell sebagai Administrator, lalu jalankan:

wsl --install -d Ubuntu-24.04

Cek versi:

wsl --version

Penting: Pastikan pakai WSL2, bukan WSL1.

Step 2: Install di dalam WSL

Masuk ke terminal Ubuntu, lalu jalankan langkah yang sama seperti Linux di atas.

Step 3: Setup Gateway (Akses dari Windows)

hermes gateway setup   # Pilih Telegram
hermes gateway start

Sekarang kamu bisa chat dengan Hermes lewat Telegram dari HP atau Windows.

4. Verifikasi & First Run

Setelah instalasi, lakukan langkah berikut:

# 1. Cek kesehatan sistem
hermes doctor

# 2. Cek versi
hermes --version

# 3. First chat (tanpa setup)
hermes chat -q "Halo, siapa kamu?"

# 4. Masuk mode interaktif
hermes

Kalau muncul error API key, daftar gratis di openrouter.ai lalu masukkan ke file:

echo 'OPENROUTER_API_KEY=sk-or-v1-...' >> ~/.hermes/.env

5. Konfigurasi Awal

Gunakan setup wizard (paling mudah):

hermes setup           # Setup lengkap
hermes setup model     # Hanya model & provider
hermes setup gateway   # Setup Telegram / Discord

File Penting:

~/.hermes/config.yaml → Konfigurasi utama
~/.hermes/.env → API Keys (jangan di-share!)
~/.hermes/skills/ → Skill yang terinstall
~/.hermes/sessions/ → Riwayat percakapan

6. Troubleshooting

Masalah	Penyebab	Solusi
`hermes doctor` error	Missing dependencies	Install ulang dependencies via apt/brew
`command not found: hermes`	PATH belum include `~/.local/bin`	`export PATH=$PATH:~/.local/bin`
Python version error	Python < 3.10	Install Python 3.10+ via pyenv / apt
Node.js not found	Node.js belum terinstall	Install Node.js 20.x via NodeSource
Gateway tidak jalan	WSL2 systemd disabled	Enable systemd di `/etc/wsl.conf`
`No module named _tkinter`	Tkinter missing	`sudo apt install python3-tk`

Masih bermasalah? Tanya di X: @sequencetraders atau buka issue di GitHub NousResearch/hermes-agent.

Kesimpulan

Hermes AI Agent adalah framework yang sangat powerful untuk membuat agent otonom. Dengan panduan ini, kamu bisa install Hermes di hampir semua platform dalam waktu kurang dari 15 menit.

Rekomendasi setup 2026:

Production / 24/7 → VPS Linux + Coolify + Cloudflare Tunnel
Development → MacBook / Windows + WSL2
Testing cepat → Gunakan OpenRouter gratis dulu

Sudah berhasil install Hermes?
Share screenshot hermes doctor kamu di komentar, atau ceritakan kendala yang kamu hadapi!

Mau saya buatkan panduan lanjutan? Misalnya:

Setup Hermes + DeepSeek + Telegram Gateway
Cara bikin custom skill
Deploy Hermes di Mini PC (Beelink / T9 Plus)

Tinggal bilang di komentar!

Sumber: Panduan Instalasi Hermes AI Agent oleh Noctis (@sequencetraders), 16 Mei 2026.

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/panduan-instalasi-hermes-ai-agent-2026-dari-vps-kosong-sampai-siap-pakai/

Mengapa LLM China Layak Diperhitungkan di 2026

Ngopidulur — Fri, 22 May 2026 13:47:00 GMT

Banyak developer masih ragu dengan LLM asal China. Padahal data Mei 2026 membuktikan sebaliknya.

DeepSeek V4 Flash bisa kamu pakai gratis, Qwen3.6 Plus mencetak SWE-bench 78.8 dengan context window 1 juta token, dan secara keseluruhan LLM China 10–50× lebih murah dari GPT/Claude dengan performa coding & reasoning yang sering lebih unggul.

Artikel ini merangkum poin-poin penting dari panduan “Mengapa LLM China Layak Diperhitungkan” karya Noctis (@sequencetraders).

DeepSeek V4 Flash & Pro — Pilihan Utama Developer

DeepSeek V4 Flash: MoE 284B total (13B aktif), context 1 juta token. Gratis via Nous Portal. Harga via OpenRouter hanya $0.112 / $0.224 per 1M token.
DeepSeek V4 Pro: Lebih kuat untuk coding kompleks & debugging. Diskon 75% sampai 31 Mei 2026.

Kelebihan utama: coding superior, tool calling stabil, reasoning effort multi-level (high/xhigh), dan cache hit super murah.

Kekurangan: text-only dan output cenderung literal.

Tips Hermes Agent: Gunakan Flash sebagai main agent + delegasikan task berat ke Pro.

Qwen3.6 Plus (Alibaba) — Multimodal & Agentic Terbaik

Model hybrid terbaru Alibaba ini unggul di:

SWE-bench Verified 78.8
Context window 1 juta token
Native multimodal (Qwen-VL + Qwen-Audio)
Tool calling & structured output sangat reliable
Batch inference diskon 50% via DashScope

Harga mulai ~¥0.2 per juta token (sangat kompetitif).

Perbandingan LLM China vs Barat (Mei 2026)

Aspek	LLM China	LLM Barat	Keterangan
Coding	DeepSeek V4 Pro / Qwen3.6	Claude 4, GPT-4o	China sering unggul
Context Window	1 juta token	128K–200K	China jauh lebih besar
Biaya	$0 – $0.87	$2.50 – $15	China 10-50× lebih murah
Tool Calling	Stabil	Sangat stabil	Setara untuk agent
Refusal	Hampir tidak ada	Sering	China lebih fleksibel
Open Weight	Hampir semua	Terbatas	China lebih terbuka

Teknik Optimalisasi Prompt DeepSeek

DeepSeek sangat literal — ikuti instruksi secara eksplisit.

Formula Optimal:

Reasoning Effort: high atau xhigh
Temperature: 0.1 – 0.3
Prompt terstruktur + format output jelas (JSON / tabel / bullet)
Gunakan Chain-of-Thought

Contoh Prompt Efektif untuk DeepSeek V4

DeepSeek sangat literal dan patuh terhadap instruksi. Semakin jelas, terstruktur, dan eksplisit prompt yang kamu berikan, semakin akurat hasilnya. Berikut beberapa contoh prompt yang sudah dioptimalkan untuk berbagai use case.

1. Debugging Kode (Multi-langkah)

Recommended Settings:

Reasoning Effort: high atau xhigh
Temperature: 0.1

Analisis kode berikut langkah demi langkah:

1. Identifikasi bug atau masalah performa
2. Jelaskan root cause secara teknis
3. Berikan solusi perbaikan (kode yang sudah diperbaiki)
4. Sarankan cara mencegah masalah serupa di masa depan

Kode:
```python
[paste kode kamu di sini]

Output hanya dalam format berikut:

Bug yang ditemukan:
Root Cause:
Solusi:
Pencegahan:


### 2. Code Review & Refactoring

**Recommended Settings:**
- Reasoning Effort: `high`
- Temperature: `0.2`

```markdown
Lakukan code review pada kode di bawah ini dengan standar berikut:
- Keamanan
- Performa
- Readability
- Best practice modern

Kode:
```javascript
[paste kode]


### 3. Membuat Laporan / Dokumentasi Terstruktur

**Recommended Settings:**
- Reasoning Effort: `medium`
- Temperature: `0.1`

```markdown
Buat laporan analisis sistem dengan format persis seperti ini:

**Judul Laporan:** [isi sendiri]
**Tanggal:** [hari ini]
**Ringkasan Eksekutif:** (maksimal 3 kalimat)
**Temuan Utama:**
- Poin 1
- Poin 2
**Rekomendasi:**
1. ...
2. ...

Data yang dianalisis:
[paste data / log / hasil monitoring]

4. Membuat Spesifikasi Fitur / Internal Tool

Recommended Settings:

Reasoning Effort: high
Temperature: 0.3

Kamu adalah Senior Backend Engineer di perusahaan logistik.

Buat spesifikasi fitur "Warehouse Queue Management" dengan struktur berikut:

1. Deskripsi Singkat Fitur
2. User Stories (minimal 4)
3. API Endpoints (method, path, request body, response)
4. Database Schema (tabel + field penting)
5. Error Handling & Edge Cases
6. Non-Functional Requirements

Kebutuhan bisnis:
- Truk bisa antri loading/unloading
- Ada prioritas berdasarkan jenis barang
- Real-time status update

5. Analisis Dokumen / Codebase Panjang

Recommended Settings:

Reasoning Effort: high
Temperature: 0.1

Baca dan analisis seluruh konteks yang diberikan.

Tugas:
1. Buat ringkasan arsitektur keseluruhan (maksimal 5 poin)
2. Identifikasi 3 modul/file yang paling kompleks
3. Sarankan 3 improvement prioritas tinggi beserta alasannya

Setelah selesai, tanyakan bagian mana yang ingin saya dalami lebih lanjut.

6. Membuat Skill untuk Hermes Agent

Recommended Settings:

Reasoning Effort: high
Temperature: 0.2

Buat skill baru untuk Hermes Agent bernama "generate-kaizen-report".

Skill ini harus:
- Menerima input: nama proyek, tanggal, daftar improvement
- Menghasilkan laporan Kaizen dalam format markdown yang rapi
- Otomatis menambahkan section: Latar Belakang, Tindakan, Hasil, Rekomendasi Lanjutan
- Gunakan bahasa Indonesia formal

Berikan struktur file + contoh pemanggilan skill-nya.

7. Prompt Harian (Simple tapi Tetap Terstruktur)

Recommended Settings:

Reasoning Effort: low atau medium
Temperature: 0.1

Ekstrak semua action item dari meeting notes di bawah ini.

Format output:
- [ ] Task description - Owner - Deadline (jika ada)

Meeting Notes:
[paste notes]

Cara Oprek Hermes Agent dengan Model China

8 titik yang bisa kamu modifikasi:

Reasoning Effort — high/xhigh untuk coding & OSINT
Personality — Buat custom via memory
Max Iterations — Naikkan ke 90 untuk task berat
Delegation — Main agent Flash + sub-agent Pro/Qwen
MCP Servers — Tambah tool eksternal
Checkpoints — Aktifkan auto snapshot + rollback
Profiles — Pisah: coding, osint, writing
Skills — Buat skill reusable

Kombinasi terbaik: Profile terpisah + Reasoning high + Delegasi + Checkpoints aktif.

Kapan Pakai Model Apa?

Use Case	Rekomendasi Utama	Alternatif
Coding & Debugging	DeepSeek V4 Pro	DeepSeek V4 Flash
Agent Workflow	Qwen3.6 Plus / DeepSeek	MiniMax M2
Dokumen Panjang	Qwen3.6 Plus / DeepSeek V4	—
Multimodal (Vision)	Qwen-VL	Gemini 2.5
Budget Minimal	DeepSeek V4 Flash (gratis)	Qwen batch
OSINT / Research	DeepSeek (minim refusal)	Qwen

Strategi Hybrid Hemat:

70% task → DeepSeek V4 Flash (gratis)
Coding berat → DeepSeek V4 Pro
Agent + Multimodal → Qwen3.6 Plus
Vision → Gemini
Creative writing → Claude/GPT (hanya kalau perlu)

Kesimpulan

LLM China 2026 bukan lagi sekadar alternatif murah. Mereka adalah tools yang sangat kompetitif, terutama untuk coding, reasoning, dan workflow agentik.

Dengan strategi hybrid DeepSeek + Qwen + Gemini, kamu bisa menekan biaya AI bulanan hingga 90% tanpa mengorbankan kualitas.

Sudah coba DeepSeek V4 Flash atau Qwen3.6 Plus?
Share pengalamanmu di komentar atau ceritakan use case kamu — saya bisa bantu buatkan prompt yang sudah dioptimasi.

Mau versi prompt DeepSeek untuk task spesifik (internal tool, analisis codebase, atau automation)? Langsung tulis di komentar!

Sumber: Panduan “Mengapa LLM China Layak Diperhitungkan” oleh Noctis (@sequencetraders), Mei 2026. Data dari OpenRouter & platform resmi per 16 Mei 2026.

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/mengapa-llm-china-layak-diperhitungkan-di-2026/

Ngopidulur Astro Blog Doc

Ngopidulur — Thu, 21 May 2026 23:20:00 GMT

Dokumentasi Project: ngopidulur-astro

Blog pribadi statis menggunakan Frosti theme + Astro 6 + Decap CMS

Daftar Isi

Overview
Tech Stack
Struktur Project
Konfigurasi
Content Management (Decap CMS)
Menulis Artikel
Development
Deployment
Perubahan yang Dilakukan
Troubleshooting

Overview

Project ini adalah blog pribadi statis yang dibangun menggunakan:

Frosti v3.3.3 — template blog untuk Astro
Astro v6.3.6 — framework web untuk content-driven websites
Decap CMS — open-source, Git-based CMS untuk mengelola konten via browser

Blog ini menghasilkan file HTML statis saat di-build, sehingga sangat cepat dan bisa di-deploy di hosting manapun.

Tech Stack

Teknologi	Versi	Fungsi
Astro	^6.3.6	Framework utama
Tailwind CSS	^3.4.18	Styling utility-first
daisyUI	^4.12.24	Komponen UI (tema light/dark)
MDX	^5.0.6	Markdown + komponen interaktif
Expressive Code	^0.41.3	Syntax highlighting code blocks
KaTeX	^0.16.25	Render rumus matematika
Pagefind	^1.4.0	Search engine statis (client-side)
@astrojs/rss	^4.0.18	Generate RSS feed
@astrojs/sitemap	^3.7.2	Generate sitemap.xml
Decap CMS	3.3.3 (pinned, lokal)	Admin UI untuk kelola konten
Biome	^2.3.8	Linter & formatter
Sharp	^0.34.5	Image optimization

Struktur Project

ngopidulur-astro/
├── public/                    # File statis (langsung di-serve)
│   ├── admin/                 # Decap CMS
│   │   ├── config.yml         # Konfigurasi CMS (collections, fields)
│   │   ├── index.html         # Entry point CMS
│   │   └── decap-cms.js       # Decap CMS bundle (pinned 3.3.3, lokal)
│   ├── image/                 # Gambar untuk artikel
│   ├── pagefind/              # Search index (auto-generated dari `pnpm search:index`)
│   ├── favicon.ico
│   ├── logo.png
│   ├── profile.png            # Avatar user
│   └── profile2.png           # Logo hero homepage
├── src/
│   ├── components/            # Komponen Astro
│   │   ├── mdx/               # Komponen untuk MDX (alerts, collapse, dll)
│   │   ├── sidebar/           # Sidebar components (profile, search, TOC)
│   │   ├── widgets/           # Widget (pagination, theme toggle, dll)
│   │   ├── Header.astro
│   │   ├── Footer.astro
│   │   ├── Navbar.astro
│   │   ├── PostCard.astro
│   │   └── Sidebar.astro
│   ├── content/
│   │   └── blog/              # Artikel blog (Markdown/MDX)
│   ├── i18n/                  # Internationalization
│   │   └── translations.yaml  # Teks UI multi-bahasa
│   ├── interface/             # TypeScript interfaces
│   ├── integration/           # Custom Astro integrations
│   ├── layouts/
│   │   └── BaseLayout.astro   # Layout utama
│   ├── pages/                 # Halaman-halaman situs
│   │   ├── blog/              # Blog routes (list, detail, category, tag)
│   │   ├── og/                # Auto-generated OG images
│   │   ├── admin.astro        # Decap CMS admin page
│   │   ├── index.astro        # Homepage
│   │   ├── about.astro        # About page
│   │   ├── project.astro      # Project page
│   │   ├── rss.xml.ts         # RSS feed
│   │   └── robots.txt.ts      # Robots.txt
│   ├── plugins/
│   │   └── remark-reading-time.ts  # Plugin estimasi waktu baca
│   ├── styles/
│   │   ├── global.scss        # Global styles
│   │   └── waline.scss        # Comment system styles
│   ├── utils/                 # Utility functions
│   ├── config.ts              # Membaca frosti.config.yaml
│   └── content.config.ts      # Definisi content collections
├── frosti.config.yaml         # KONFIGURASI UTAMA SITUS
├── astro.config.mjs           # Konfigurasi Astro
├── tsconfig.json              # TypeScript config (exclude pagefind & decap-cms.js)
├── biome.json                 # Linter/formatter config
├── package.json               # Dependencies & scripts
└── dist/                      # Output build (jangan edit manual)

Konfigurasi

File Konfigurasi Utama: `frosti.config.yaml`

Semua pengaturan situs ada di file ini:

site:
  tab: Frosti              # Teks di browser tab
  title: 💠 Frosti         # Judul situs
  description: ...         # Deskripsi SEO
  language: en             # Bahasa (en/zh/dll)
  favicon: /favicon.ico
  theme:
    light: winter          # Tema terang (daisyUI)
    dark: dracula          # Tema gelap (daisyUI)
    code: github-dark      # Tema code block (Shiki)
  date_format: ddd MMM DD YYYY
  blog:
    pageSize: 8            # Artikel per halaman
  menu: [...]              # Navigasi menu sidebar/navbar

user:
  name: Rifky Awalul Huda  # Nama yang ditampilkan
  site: "https://..."       # URL situs
  avatar: /profile.png      # Path avatar
  sidebar:
    social: [...]           # Social links di sidebar
  footer:
    social: [...]           # Social links di footer

Penting: Setelah edit frosti.config.yaml, restart dev server (Ctrl+C lalu npm run dev lagi) karena file ini dibaca via fs.readFileSync yang tidak hot-reload.

Catatan Konfigurasi yang Sedang Dipakai

Menu Friend, Contact, dan Examples sudah dihapus dari site.menu. Halaman friend.astro juga dihapus dari codebase.
Kategori sidebar yang aktif: Tulisan Random, Teknologi, Documentation.
Social icon sidebar dan footer saat ini memakai Facebook, GitHub, LinkedIn, dan X.
Format icon yang benar mengikuti pola collection:name, misalnya ri:linkedin-line atau ri:facebook-line.
user.site saat ini mengarah ke profil LinkedIn.

Astro Config: `astro.config.mjs`

Integrasi yang aktif:

expressiveCode — syntax highlighting
mdx — support file .mdx
icon — icon library (Iconify)
terser — JS minification
sitemap — auto-generate sitemap.xml
playformCompress — compress output

Markdown plugins:

remarkMath + rehypeKatex — rumus matematika
remarkReadingTime — estimasi waktu baca
rehypeExternalLinks — tambah ↗ di link eksternal

Content Management (Decap CMS)

Apa itu Decap CMS?

Decap CMS adalah admin UI berbasis web yang memungkinkan kamu membuat dan mengedit artikel blog langsung dari browser, tanpa perlu buka code editor. Perubahan disimpan langsung sebagai file Markdown di repository.

Cara Akses (Lokal)

Buka terminal pertama, jalankan proxy server:
```
npx decap-server
```
Buka terminal kedua, jalankan dev server:
```
npm run dev
```
Buka browser: http://localhost:4321/admin
Langsung masuk tanpa login (local mode)

Konfigurasi CMS: `public/admin/config.yml`

backend:
  name: git-gateway       # Backend untuk production (Netlify)
  branch: main

local_backend: true       # Enable untuk development lokal (tanpa auth)

media_folder: "public/image"   # Folder upload gambar
public_folder: "/image"        # Path gambar di situs

collections:
  - name: "blog"
    label: "Blog Posts"
    folder: "src/content/blog"
    create: true
    fields:
      - title (string, required)
      - description (string, required)
      - pubDate (datetime, required)
      - updated (datetime, optional)
      - image (image, optional)
      - badge (string, optional) — set "Pin" untuk pin artikel
      - draft (boolean, optional) — true = tidak tampil di list
      - categories (list, optional)
      - tags (list, optional)
      - body (markdown)

Catatan: File .md vs .mdx di CMS

Decap CMS hanya menampilkan file dengan ekstensi .md (dikonfigurasi via extension: "md" di config.yml). File .mdx tidak muncul di CMS dan memang sengaja dikelola terpisah.

Konvensi:

File .md — Artikel biasa, dikelola via Decap CMS (/admin) atau langsung edit file.
File .mdx — Artikel yang menggunakan komponen interaktif (import custom components seperti <Collapse>, <Info>, <LinkCard>, dll). Dikelola langsung via code editor karena Decap CMS tidak bisa merender syntax JSX/import.

Kenapa tidak membuat collection kedua untuk MDX?

Di sisi Astro, semua post (.md dan .mdx) sudah satu content collection blog. Memisahkan di CMS membingungkan.
Decap CMS tetap tidak bisa mengedit syntax MDX (import/JSX) dengan benar.
Duplikasi konfigurasi fields tanpa manfaat nyata.

Jadi jika ada post yang hanya muncul di situs tapi tidak di CMS, kemungkinan besar itu file .mdx — dan itu memang by design.

Catatan Production

Untuk deploy dengan Decap CMS aktif:

Deploy ke Netlify dan aktifkan Netlify Identity
Hapus/comment local_backend: true di config.yml
User bisa login via email di /admin

Menulis Artikel

Via Decap CMS (Recommended)

Buka /admin di browser
Klik "Blog Posts" → "New Blog Post"
Isi field-field yang tersedia
Klik "Publish"
File Markdown otomatis dibuat di src/content/blog/

Via File Manual

Buat file .md di src/content/blog/ dengan format:

---
title: "Judul Artikel"
description: "Deskripsi singkat"
pubDate: 2025-01-15
image: "/image/cover.jpg"
categories:
  - Documentation
tags:
  - astro
  - tutorial
draft: false
---

Isi artikel di sini menggunakan Markdown...

Frontmatter Fields

Field	Tipe	Wajib	Keterangan
title	string	✅	Judul artikel
description	string	✅	Deskripsi untuk SEO
pubDate	date	✅	Tanggal publikasi
updated	date	❌	Tanggal update terakhir
image	string	❌	Path cover image
badge	string	❌	Set "Pin" untuk pin di atas
draft	boolean	❌	true = hidden dari list
categories	string[]	❌	Kategori artikel
tags	string[]	❌	Tag artikel

Development

Prerequisites

Node.js >= 18
pnpm (recommended) atau npm
Untuk pnpm v10+: jalankan pnpm approve-builds saat install pertama untuk approve build scripts dari esbuild, sharp, swup, dan @parcel/watcher.

Commands

Project ini pakai pnpm. Semua command bisa dijalankan via pnpm <script>. Kalau pakai npm, ganti pnpm dengan npm run.

# Running Decap Server (terminal 1)
npx decap-server
# Akses CMS: http://localhost:4321/admin

# Install dependencies
pnpm install

# Development server (http://localhost:4321) — terminal 2
pnpm dev

# Build untuk production (build + generate Pagefind index)
pnpm build

# Preview build result
pnpm preview

# Type checking
pnpm check

# Linting (Biome)
pnpm lint

# Format code (Biome)
pnpm format

# Generate search index lalu copy ke public/
pnpm search:index

Pertama Kali Setup

pnpm install
pnpm approve-builds        # Approve build scripts (pilih semua dengan 'a')
pnpm search:index          # Generate Pagefind search index
pnpm dev                   # Start dev server

Workflow Harian

pnpm dev                   # Start dev server
# Edit artikel via /admin atau langsung di file
# Ctrl+C untuk stop

Setelah Tambah/Edit Artikel

Search index Pagefind tidak auto-update saat dev. Setelah konten berubah signifikan, regenerate index:

pnpm build
npx cpy-cli "dist/pagefind/**" "public/pagefind"

Deployment

Opsi 1: Netlify (Recommended — gratis + Decap CMS)

Push repo ke GitHub
Connect repo di netlify.com
Build command: npm run build
Publish directory: dist
Aktifkan Netlify Identity untuk Decap CMS login
Hapus local_backend: true di public/admin/config.yml

Opsi 2: Shared Hosting / cPanel

Persiapan sebelum build

Edit frosti.config.yaml: ganti user.site ke domain produksi (misal https://ngopidulur.my.id). Pastikan ada https:// dan tanpa trailing slash.
Edit public/admin/config.yml: comment baris local_backend: true (# local_backend: true). Decap CMS local backend cuma untuk dev.

Build dan compress

Di lokal:

pnpm install
pnpm search:index
pnpm build

Lalu compress isi dist/:

Compress-Archive -Path dist\* -DestinationPath dist.zip -Force

Upload dan extract

Login ke cPanel → File Manager.
Navigate ke public_html/ (atau folder subdomain).
PENTING — sebelum upload baru, hapus folder lama yang berpotensi konflik:

Lewat cPanel Terminal, jalankan:
```
cd ~/public_html
rm -rf blog _astro admin image og pagefind
```
Kalau cPanel kamu tidak punya Terminal, hapus folder-folder ini lewat File Manager.
Upload dist.zip ke public_html/.
Extract via File Manager (atau Terminal: unzip -o dist.zip).
Hapus dist.zip setelah extract sukses.

Pasang `.htaccess`

Buat file .htaccess di public_html/ dengan isi:

RewriteEngine On

# Force HTTPS
RewriteCond %{HTTPS} !=on
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

# Custom 404
ErrorDocument 404 /404.html

# Pretty URLs
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+?)/?$ $1.html [L]

DirectoryIndex index.html

# Compression
<IfModule mod_deflate.c>
  AddOutputFilterByType DEFLATE text/html text/css text/javascript application/javascript application/json image/svg+xml
</IfModule>

# Cache
<IfModule mod_expires.c>
  ExpiresActive On
  ExpiresByType image/jpeg "access plus 1 year"
  ExpiresByType image/png "access plus 1 year"
  ExpiresByType image/webp "access plus 1 year"
  ExpiresByType text/css "access plus 1 year"
  ExpiresByType application/javascript "access plus 1 year"
  ExpiresByType font/woff2 "access plus 1 year"
</IfModule>

# Security
<IfModule mod_headers.c>
  Header set X-Content-Type-Options "nosniff"
  Header set X-Frame-Options "SAMEORIGIN"
  Header set Referrer-Policy "strict-origin-when-cross-origin"
</IfModule>

Catatan penting

⚠️ Decap CMS /admin tidak akan berfungsi penuh di shared hosting tanpa Netlify Identity atau OAuth proxy. Untuk update konten, edit di lokal lalu re-deploy.
Setelah deploy, test halaman kategori (/blog/category/Teknologi) dan tag (/blog/tag/...). Kalau muncul 404, baca section Troubleshooting di bawah.

Opsi 3: Vercel / Cloudflare Pages

Connect GitHub repo
Build command: npm run build
Output directory: dist
Untuk Decap CMS, perlu setup external OAuth client

Perubahan yang Dilakukan

Integrasi Decap CMS (Mei 2025)

File baru:

public/admin/config.yml — Konfigurasi Decap CMS dengan field mapping ke blog collection
public/admin/index.html — Entry point HTML untuk Decap CMS (CDN)
src/pages/admin.astro — Astro page route untuk /admin

Tujuan: Menambahkan admin UI berbasis web untuk mengelola artikel blog tanpa perlu edit file Markdown secara manual.

Percobaan CMS yang Tidak Jadi

Selama proses setup, beberapa CMS dicoba tapi tidak kompatibel:

Storyblok — Berbayar (tidak ada free tier yang mudah diakses)
Keystatic — Belum support Astro 6 (peer dependency conflict, crash di production)

Kedua percobaan ini sudah di-revert sepenuhnya. Tidak ada sisa kode dari Storyblok atau Keystatic di project.

Penyesuaian UI dan Konfigurasi (Mei 2026)

Homepage

src/pages/index.astro: section Features diganti menjadi Blog Terbaru.
Homepage sekarang menampilkan maksimal 6 post terbaru dari collection blog.
Layout daftar post di homepage diubah menjadi grid card ringkas 3 kolom di desktop dan tetap responsif di layar kecil.

About page

src/pages/about.astro: tombol sosial pertama di section profil diubah dari GitHub menjadi LinkedIn.
Link sosial yang dipakai di halaman About sudah menyesuaikan profil LinkedIn dan Facebook terbaru.

Navigasi

frosti.config.yaml: menu Friend dan Contact dihapus dari site.menu.
Halaman src/pages/friend.astro masih ada di codebase, tetapi tidak lagi muncul di navigasi utama.

Footer dan social icons

src/components/Footer.astro tetap menjadi komponen footer utama yang dipakai oleh src/layouts/BaseLayout.astro.
Data social footer tetap dibaca dari frosti.config.yaml melalui src/config.ts.
Icon ri:cup-line di konfigurasi social footer diganti menjadi ri:facebook-line.
Icon LinkedIn di konfigurasi memakai format yang benar: ri:linkedin-line.

Maintenance & Code Quality (Mei 2026)

Update dependency untuk kompatibilitas Astro 6

@astrojs/rss di-update ke ^4.0.18 (fix error z.function().returns is not a function).
@astrojs/sitemap di-update ke ^3.7.2 (fix error Cannot read properties of undefined (reading 'reduce')).

Fix prioritas High dari hasil code review

Decap CMS pinned & lokal: dependency dari CDN (https://unpkg.com/decap-cms@^3.3.3) di src/pages/admin.astro dan public/admin/index.html diganti ke file lokal public/admin/decap-cms.js (versi 3.3.3 di-pin). Mencegah breaking change upstream dan mengurangi attack surface.
Race condition di search page: src/pages/blog/search.astro di-refactor agar tidak append script tag duplikat saat user navigate via View Transitions. Ada pengecekan window.PagefindUI dan attribute data-pagefind-loader untuk reuse instance.
A11y/SEO homepage: src/pages/index.astro heading <h1> ditambah lagi (sr-only agar tetap visual-friendly), gambar hero profile2.png ditambah width, height, dan fetchpriority="high" untuk cegah CLS dan prioritaskan loading.

Schema content collection lebih toleran

src/content.config.ts: field updated sekarang menerima string kosong "" dari Decap CMS dan otomatis convert ke undefined. Mencegah error Expected type "date", received "object" saat post baru dibuat lewat CMS tanpa mengisi tanggal update.

TypeScript config

tsconfig.json: tambah exclude untuk public/admin/decap-cms.js (5.3 MB minified) dan public/pagefind/**. Mencegah astro check out-of-memory saat scan vendor files.

Cleanup file tidak terpakai

Dihapus 14 file yang sudah tidak terpakai:
- Static assets duplikat: favicon1.ico, profile1.png, image/l.png, image/r.png, image/image2.jpg, image/uploaded-screenshot.png.
- Frosti updater scripts: frosti.update.sh, .updateignore, src/i18n/en.sh, src/i18n/zh.sh.
- Halaman friend dan komponen pendukungnya: src/pages/friend.astro, src/components/mdx/FriendCard.astro, src/components/mdx/Showcase.astro, src/components/mdx/LinkCard.astro.

Setup MCP Astro Docs (global Kiro)

File ~/.kiro/settings/mcp.json ditambah server astro-docs dengan autoApprove: ["search_astro_docs"]. AI agent sekarang punya akses ke dokumentasi Astro versi terbaru via MCP tanpa konfirmasi manual.

Troubleshooting

Config tidak update setelah edit `frosti.config.yaml`

Penyebab: File dibaca via fs.readFileSync saat module di-import, tidak terdeteksi oleh Vite hot-reload. Solusi: Restart dev server (Ctrl+C → npm run dev).

Decap CMS minta login di localhost

Penyebab: local_backend: true belum di-set, atau npx decap-server belum jalan. Solusi:

Pastikan local_backend: true ada di public/admin/config.yml
Jalankan npx decap-server di terminal terpisah sebelum akses /admin

`/admin` page not found

Penyebab: Astro dev server tidak auto-resolve index.html di subfolder public/. Solusi: Gunakan route src/pages/admin.astro (sudah dibuat). Akses via http://localhost:4321/admin.

Build error setelah install package baru

Solusi: Jalankan npm run check untuk melihat error. Pastikan astro.config.mjs tidak ada import yang broken.

Search tidak berfungsi

Penyebab: Search index belum di-generate. Solusi: Jalankan pnpm search:index (atau npm run search:index) sebelum pnpm dev. Setelah build, copy index ke public/:

npx cpy-cli "dist/pagefind/**" "public/pagefind"

Search page error: "Cannot import non-asset file"

Penyebab: Pagefind UI di-import via dynamic import() yang diproses Vite, padahal file ada di public/. Solusi: Sudah di-fix. src/pages/blog/search.astro sekarang load /pagefind/pagefind-ui.js via document.createElement("script") agar bypass Vite.

Decap CMS error: "data does not match collection schema (updated: Expected date, received object)"

Penyebab: Decap CMS menyimpan field datetime kosong sebagai string "", sementara schema Zod lama strict. Solusi: Sudah di-fix di src/content.config.ts. Field updated sekarang menerima "" dan otomatis convert ke undefined. Tidak perlu action manual.

`astro check` JavaScript heap out of memory

Penyebab: Astro mencoba scan file vendor besar di public/ (decap-cms.js, file Pagefind). Solusi: Sudah di-fix di tsconfig.json via exclude. Kalau muncul lagi setelah tambah file vendor baru, tambahkan ke exclude array.

Build error: `z.function(...).returns is not a function`

Penyebab: @astrojs/rss versi lama tidak kompatibel dengan Zod yang dibawa Astro 6. Solusi: Sudah di-fix dengan update ke @astrojs/rss@^4.0.18. Kalau ketemu di package lain, update ke versi terbaru.

pnpm install gagal: `[ERR_PNPM_IGNORED_BUILDS]`

Penyebab: pnpm v10+ memblokir postinstall scripts secara default. Solusi: Jalankan pnpm approve-builds, pilih semua dengan a lalu Enter, lalu pnpm install lagi.

Deploy cPanel: kategori atau tag muncul 404 setelah upload

Gejala: Halaman seperti /blog/category/Teknologi atau /blog/tag/php muncul 404, padahal halaman lain (homepage, detail post) jalan normal.

Penyebab: Saat extract dist.zip di cPanel, folder seperti blog/category/, blog/tag/ sudah ada dari deploy sebelumnya tapi dengan permission/ownership yang rusak. Extract membuat folder tujuan tapi gagal extract index.html di dalamnya. Folder kosong = 404.

Indikator: Saat extract via Terminal cPanel muncul error seperti:

checkdir error: cannot create blog/category/Teknologi
Permission denied
unable to process blog/category/Teknologi/index.html.

Solusi: Hapus folder bermasalah dulu sebelum re-extract.

Via cPanel Terminal:

cd ~/public_html
rm -rf blog/category blog/tag
# atau lebih bersih: rm -rf blog
unzip -o dist.zip

Kalau rm -rf juga gagal dengan permission denied:

chmod -R 755 blog/category blog/tag 2>/dev/null
rm -rf blog/category blog/tag

Kalau tetap denied, kontak support hosting untuk reset ownership folder ke akun cPanel kamu.

Pencegahan: Sebelum upload deploy baru, selalu hapus folder lama dulu. Jangan extract overwrite di atas folder lama.

Deploy cPanel: situs blank putih atau asset tidak load

Penyebab umum:

index.html tidak ada di root public_html/ (mungkin nested di public_html/dist/)
Folder _astro/ tidak lengkap (file CSS/JS hilang)
USER_SITE di frosti.config.yaml salah saat build

Solusi:

Pastikan index.html ada langsung di public_html/, bukan di subfolder
Cek Console browser (F12) untuk error 404 spesifik
Build ulang dengan USER_SITE yang benar di frosti.config.yaml

Referensi

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/ngopidulur-astro-blog-doc/

Harness Engineering: OpenAI Bangun 1 Juta Baris Kode Tanpa Menulis Satu Baris Kode Manual

Ngopidulur — Thu, 21 May 2026 22:17:00 GMT

Era Baru Rekayasa Perangkat Lunak Telah Tiba

Bayangkan ini: sebuah tim kecil hanya 7 orang berhasil membangun produk software berukuran 1 juta baris kode dalam waktu lima bulan — tanpa menulis satu baris kode pun secara manual.

Semua kode, mulai dari logika aplikasi, tes otomatis, konfigurasi CI/CD, dokumentasi, hingga tooling internal, ditulis sepenuhnya oleh Codex, agen coding AI dari OpenAI.

Ini bukan sekadar eksperimen kecil. Produk tersebut sudah digunakan ratusan pengguna internal setiap hari dan telah melewati tahap alpha testing eksternal. Ia dirilis, di-deploy, rusak, diperbaiki, dan terus berkembang.

OpenAI menyebut pendekatan ini sebagai “Harness Engineering” — seni merancang sistem, aturan, dan infrastruktur agar agen AI bisa bekerja secara mandiri dan andal dalam skala besar.

Artikel ini akan membahas secara lengkap apa yang mereka pelajari, tantangan yang dihadapi, dan pelajaran penting bagi developer Indonesia yang ingin mengikuti jejak ini.

1. Dimulai dari Repositori Git yang Benar-Benar Kosong

Pada akhir Agustus 2025, tim memulai dengan repositori kosong.

Scaffold awal (struktur folder, konfigurasi CI, aturan formatting, package manager, dan framework aplikasi) dibuat oleh Codex CLI menggunakan GPT-5. Bahkan file AGENTS.md yang menjadi “panduan kerja” bagi agen juga ditulis oleh Codex sendiri.

Tidak ada kode manusia sama sekali sejak commit pertama.

Lima bulan kemudian, repositori telah berisi sekitar 1 juta baris kode dan lebih dari 1.500 pull request berhasil digabungkan. Rata-rata throughput mencapai 3,5 PR per engineer per hari — dan angka ini justru meningkat seiring bertambahnya tim.

Filosofi inti tim: “No manually-written code.” Manusia tidak boleh menulis kode. Titik.

2. Peran Engineer Berubah Total

Dengan tidak adanya coding manual, peran engineer berubah drastis.

Tugas utama bukan lagi menulis kode, melainkan:

Merancang lingkungan kerja yang memungkinkan agen bekerja efektif
Menentukan tujuan tingkat tinggi (intent)
Membangun sistem umpan balik (feedback loop)
Membuat segala sesuatu terbaca dan dapat ditegakkan oleh agen

Ketika ada masalah, engineer tidak langsung “memperbaiki kode”. Mereka bertanya: “Kapabilitas apa yang kurang? Bagaimana kita membuatnya jelas bagi agen?”

Manusia bekerja hampir 100% melalui prompt. Mereka mendeskripsikan tugas, menjalankan agen, lalu membiarkan agen membuka pull request, mereview sendiri, dan mengulang hingga selesai.

3. Meningkatkan “Keterbacaan” Aplikasi untuk Agen

Salah satu bottleneck terbesar adalah kapasitas QA manusia. Karena waktu manusia terbatas, tim OpenAI membuat aplikasi, log, dan metrik langsung bisa dibaca dan dipahami oleh Codex.

Beberapa langkah yang dilakukan:

Aplikasi bisa dijalankan per git worktree (isolasi sempurna)
Integrasi Chrome DevTools Protocol → agen bisa mengambil screenshot, snapshot DOM, dan menavigasi UI
Observabilitas penuh (log + metrik) diekspos ke agen melalui LogQL dan PromQL
Agen bisa bekerja sendirian hingga 6 jam tanpa intervensi manusia

Hasilnya: agen tidak hanya menulis kode, tetapi juga bisa mereproduksi bug, memvalidasi perbaikan, dan bahkan merekam video demonstrasi.

4. Pengetahuan Repositori Jadi “Sistem Catatan Utama”

Salah satu pelajaran paling penting:

“Berikan Codex peta, bukan buku panduan 1.000 halaman.”

Mereka pernah mencoba file AGENTS.md yang sangat besar. Gagal total. File itu justru membingungkan agen, cepat usang, dan sulit diverifikasi.

Solusi yang mereka terapkan:

AGENTS.md hanya berisi ~100 baris sebagai daftar isi
Semua pengetahuan mendalam disimpan di folder docs/ yang terstruktur rapi
Ada dokumen arsitektur, core beliefs, quality score, reliability, security, dan execution plans
Semua rencana (plans) diperlakukan sebagai artefak resmi yang versi-controlled

Mereka juga menjalankan agen “doc-gardening” secara rutin untuk membersihkan dokumentasi usang.

5. Arsitektur yang Ketat = Kecepatan Tanpa Kekacauan

Karena codebase 100% dihasilkan agen, mereka membangun arsitektur yang sangat ketat sejak awal:

Setiap domain bisnis dibagi menjadi lapisan tetap (Types → Config → Repo → Service → Runtime → UI)
Dependensi hanya boleh mengalir ke satu arah
Cross-cutting concerns (auth, telemetry, feature flags) masuk melalui interface tunggal
Semua aturan ditegakkan oleh linter custom yang dibuat Codex sendiri

Mereka menyebutnya “taste invariants” — aturan rasa dan kualitas yang ditegakkan secara otomatis.

Dengan agen, aturan ketat justru menjadi pengganda kekuatan, bukan penghambat.

6. Otonomi Agen yang Semakin Tinggi

Baru-baru ini, Codex di repositori ini mencapai level otonomi yang mengesankan. Hanya dengan satu prompt, agen sekarang bisa:

Memvalidasi kondisi codebase
Mereproduksi bug + merekam video
Menulis perbaikan
Memvalidasi perbaikan dengan menjalankan aplikasi
Merekam video hasil perbaikan
Membuka pull request
Merespons feedback
Memperbaiki build failure
Menggabungkan perubahan sendiri

Hanya ketika butuh judgment manusia, agen akan mengeskalasi.

7. Masalah Baru: “AI Slop” dan Garbage Collection

Otonomi tinggi membawa masalah baru: agen cenderung mereplikasi pola yang sudah ada — termasuk pola buruk.

Awalnya tim menghabiskan setiap Jumat untuk membersihkan “AI slop”. Tidak sustainable.

Solusi: Mereka membuat “Golden Principles” dan proses garbage collection otomatis. Agen latar belakang secara rutin memindai penyimpangan, memperbarui kualitas kode, dan membuka PR refactoring yang ditargetkan.

Technical debt dibayar secara terus-menerus dalam jumlah kecil, bukan ditumpuk lalu dibersihkan sekaligus.

Kesimpulan & Pelajaran Utama

OpenAI sudah membuktikan bahwa masa depan software engineering bukan tentang menulis kode lebih cepat, melainkan tentang merancang sistem yang membuat agen AI bisa bekerja secara mandiri dan berkualitas tinggi.

Beberapa takeaways penting:

Manusia bukan lagi penulis kode, melainkan perancang lingkungan dan aturan.
Keterbacaan untuk agen sama pentingnya dengan keterbacaan untuk manusia.
Arsitektur ketat + dokumentasi terstruktur adalah prasyarat kecepatan, bukan penghalang.
Garbage collection otomatis untuk AI-generated code menjadi kebutuhan wajib.
Disiplin tetap diperlukan — hanya saja sekarang disiplin itu diterapkan di scaffolding, bukan di setiap baris kode.

Apa Artinya Ini untuk Developer Indonesia?

Bagi developer, startup, dan perusahaan teknologi di Indonesia, pesan ini sangat relevan:

Mulai sekarang, biasakan menulis kode yang “agent-friendly” (terstruktur, terdokumentasi, dan memiliki batas yang jelas).
Investasikan waktu untuk membangun harness (tools, linter, dokumentasi, dan feedback loop) — ini akan memberikan leverage jauh lebih besar di masa depan.
Jangan takut dengan aturan ketat. Justru aturan yang jelas memungkinkan agen (dan tim) bergerak lebih cepat.

Siapa tahu, dalam 1–2 tahun ke depan, banyak produk Indonesia juga akan dibangun dengan pendekatan serupa.

Sumber Asli: Harness engineering: leveraging Codex in an agent-first world Oleh Ryan Lopopolo (OpenAI) – 11 Februari 2026

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/harness-engineering-openai-bangun-1-juta-baris-kode-tanpa-menulis-satu-baris-kode-manual/

Prompt AI Code Reviewer Terbaik 2026

Ngopidulur — Thu, 21 May 2026 22:10:00 GMT

Pernahkah Anda meminta AI untuk mereview kode, tapi hasilnya hanya “kode ini bagus” atau “ada sedikit masalah”?

Atau justru terlalu panjang, tidak terstruktur, dan sulit ditindaklanjuti?

Saya juga sering mengalami hal yang sama. Makanya saya memutuskan untuk menyempurnakan prompt Code Review AI secara menyeluruh. Hasilnya? Review yang jauh lebih tajam, terstruktur, dan benar-benar membantu developer memperbaiki kodenya.

Di artikel ini, saya akan membagikan prompt versi upgrade yang sudah saya sempurnakan, beserta alasan mengapa prompt ini jauh lebih efektif dibandingkan prompt biasa.

Mengapa Kebanyakan Prompt Code Review Kurang Efektif?

Banyak orang masih menggunakan prompt sederhana seperti:

“You are an expert code reviewer. Review this code and give suggestions.”

Hasilnya biasanya:

Terlalu umum
Tidak ada prioritas (mana yang harus diperbaiki dulu?)
Tidak memberikan contoh kode perbaikan
Tidak seimbang (hanya kritik, jarang memuji)
Tidak terstruktur, sehingga sulit dibaca

Padahal code review yang baik harus jelas, actionable, dan seimbang.

Prompt AI Code Reviewer yang Sudah Saya Sempurnakan

Setelah melakukan beberapa iterasi dan pengujian, berikut adalah prompt terbaik yang saya gunakan saat ini:

You are an expert AI Code Reviewer with deep expertise across multiple programming languages (Python, JavaScript/TypeScript, Java, C#, Go, Rust, PHP, etc.), modern frameworks, clean code principles, security, and performance engineering.**Your Mission**  Provide thorough, constructive, balanced, and highly actionable code reviews that genuinely help developers improve code quality, security, performance, maintainability, and reliability. Always be professional, encouraging, and specific. Never be condescending.**Analysis Process (Follow Strictly)**When the user shares code:1. **Detect Context** — Automatically identify the programming language, framework/library (if obvious), and infer the purpose of the code. Note any assumptions you make. If the goal or full context is unclear, state your assumptions and ask clarifying questions at the end.2. **Comprehensive Multi-Dimensional Review** — Analyze the code across the following categories, **prioritizing by severity** (Critical → High → Medium → Low).### Review Categories**1. Code Quality & Maintainability**- Code smells, anti-patterns, and design issues (duplication, god classes, tight coupling, long methods, etc.)- Naming conventions, consistency, and descriptiveness- Code organization, modularity, and separation of concerns- Readability and cognitive complexity- Opportunities for refactoring with clear before/after examples**2. Bug Detection & Correctness**- Logical errors, incorrect assumptions, and potential runtime failures- Unhandled edge cases, boundary conditions, and off-by-one errors- Null/undefined handling, exception handling, and error propagation- Concurrency issues (race conditions, deadlocks, thread safety) when applicable- Data flow and state management problems**3. Security Analysis**- Common vulnerabilities (OWASP Top 10, injection, XSS, CSRF, insecure deserialization, etc.)- Input validation, sanitization, and output encoding- Authentication, authorization, and access control logic- Hardcoded secrets, weak cryptography, insecure configurations, and dependency risks- Language- and framework-specific security issues**4. Performance & Scalability**- Time and space complexity analysis (Big O where relevant)- Performance bottlenecks, inefficient algorithms, or suboptimal data structures- Resource leaks (memory, file handles, database connections, etc.)- Optimization opportunities (caching, batching, lazy loading, vectorization, etc.)- Scalability considerations for high-load or large-scale scenarios**5. Best Practices & Standards**- Adherence to language-specific style guides and idioms (PEP 8, Google Style Guide, Airbnb, etc.)- Error handling, logging, and observability best practices- Testability and suggestions for unit/integration tests (including edge cases)- Documentation quality (docstrings, comments, type hints, README notes)- Dependency management and potential outdated/vulnerable packages (if manifest is visible)**Output Format (Use This Exact Structure)**## Overall Assessment- One-paragraph summary of what the code does well + overall impression- Overall rating: Excellent / Good / Needs Improvement / Requires Significant Refactoring## Key Findings(Organized by category, sorted by severity descending)For **every issue** use this format:- **Severity**: Critical / High / Medium / Low- **Category**: Code Quality | Bug | Security | Performance | Best Practices- **Location**: Line X–Y or function `functionName()`- **Issue**: Clear, concise description- **Impact**: Why this matters (risk, maintainability cost, performance penalty, etc.)- **Recommendation**: Specific actionable fix + code example (use ```diff or before/after blocks)## Positive Aspects- Highlight well-written sections, good patterns, and strengths## Prioritized Recommendations- Top 3–5 most important actions the developer should take next (with clear priority)## Questions & Clarifications (if needed)- Any assumptions made or additional context required**Additional Strict Rules**- Always provide **concrete code examples** for suggestions (diff blocks are preferred).- Be balanced: criticize constructively and explicitly praise good practices.- If the code is only a snippet, review what is provided but clearly state limitations.- Tailor every recommendation to the detected language and apparent use case.- Never invent issues that do not exist. Base all findings on actual code.- If no major issues are found, still offer meaningful improvements for excellence.- Keep the tone supportive and developer-friendly.

Apa yang Membuat Prompt Ini Jauh Lebih Baik?

Berikut beberapa peningkatan utama yang saya tambahkan:

Aspek

Prompt Biasa

Prompt Upgrade (Versi Saya)

Keuntungan

Struktur Output

Acak

Sangat terstruktur & konsisten

Mudah dibaca

Prioritas

Tidak ada

Ada tingkat keparahan (Critical–Low)

Developer tahu mana yang urgent

Contoh Kode

Jarang

Selalu ada diff/before-after

Lebih actionable

Keseimbangan

Sering hanya kritik

Ada bagian "Positive Aspects"

Lebih memotivasi

Kedalaman Analisis

Superficial

5 kategori mendalam + security & performance

Review lebih komprehensif

Rekomendasi

Umum

Top 3–5 Prioritized Recommendations

Fokus pada hal terpenting

Cara Menggunakan Prompt Ini

Copy seluruh prompt di atas
Paste ke ChatGPT, Claude, Grok, atau AI lain
Langsung paste kode yang ingin direview
AI akan otomatis mengikuti format yang sudah saya tetapkan

Tips Pro:

Jika kode cukup panjang, tambahkan konteks di awal (misalnya: “Ini adalah bagian dari aplikasi Next.js yang menangani autentikasi”)
Minta AI untuk fokus pada aspek tertentu jika diperlukan (contoh: “Fokus pada security dan performance”)

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/prompt-ai-code-reviewer-terbaik-2026/

Filament PHP: Cara Tercepat Membangun Admin Panel & Aplikasi Laravel di 2026

Ngopidulur — Thu, 21 May 2026 13:41:00 GMT

Pernahkah kamu merasa lelah menghabiskan berbulan-bulan hanya untuk membuat admin panel yang cantik dan fungsional? Atau mungkin kamu sudah mencoba beberapa solusi admin panel Laravel, tapi hasilnya tetap kurang memuaskan — baik dari segi tampilan, kecepatan development, maupun maintainability?

Jika iya, maka Filament PHP mungkin adalah jawaban yang selama ini kamu cari.

Filament adalah open-source UI framework yang dibangun di atas Laravel dan Livewire, yang memungkinkan developer membangun admin panel dan aplikasi full-stack dengan kecepatan luar biasa tanpa mengorbankan kualitas dan fleksibilitas.

Apa Itu Filament PHP?

Filament adalah framework modern untuk membangun admin panel dan aplikasi Laravel dengan sangat cepat. Ia menggunakan pendekatan deklaratif dalam PHP, sehingga kamu bisa membuat antarmuka yang kompleks hanya dengan menulis sedikit kode.

Filament bukan sekadar admin panel biasa. Ia adalah full-stack solution yang memungkinkan kamu membangun aplikasi web yang utuh — mulai dari dashboard, manajemen data, form kompleks, hingga fitur real-time — dalam waktu yang jauh lebih singkat dibandingkan cara tradisional.

Tagline resminya sangat jelas: “Build Laravel apps & admin panels fast”

Mengapa Filament Sangat Populer di Kalangan Developer Laravel?

Berikut alasan mengapa Filament menjadi salah satu pilihan utama developer Laravel di tahun 2026:

Developer Experience (DX) yang Sangat Baik Banyak developer menyebut Filament sebagai “game changer”. Kamu bisa membuat resource admin (List, Create, Edit, View) hanya dalam hitungan menit.
Tampilan Modern & Profesional Filament menggunakan Tailwind CSS, sehingga tampilannya sudah sangat cantik dan responsif sejak awal. Tidak perlu repot desain dari nol.
Performa yang Terus Meningkat Di versi terbaru (Filament 4 & 5), performa tabel meningkat signifikan — hingga 2–3x lebih cepat dibandingkan versi sebelumnya.
Sangat Fleksibel & Extensible Kamu bisa dengan mudah menyesuaikan hampir semua bagian, membuat custom page, widget, atau bahkan plugin sendiri.
Komunitas yang Sangat Aktif Didukung oleh komunitas Laravel yang besar, banyak plugin siap pakai, dan dokumentasi yang sangat lengkap.

Fitur Unggulan Filament

Filament dilengkapi dengan berbagai fitur powerful yang siap pakai:

FiturDeskripsiTablesTabel interaktif dengan filter, sorting, bulk action, dan pagination yang sangat powerfulFormsForm reaktif yang kompleks dengan validasi, dependency antar field, dan layout fleksibelInfolistsMenampilkan detail record secara rapi dan terstrukturNotificationsNotifikasi real-time untuk feedback penggunaDashboard WidgetsWidget dinamis untuk menampilkan metrik dan statistikAction ModalsModal interaktif untuk konfirmasi dan input dataAuthorizationIntegrasi penuh dengan Laravel Policies & Gates

Semua fitur ini bisa dikonfigurasi langsung di dalam file PHP — tanpa perlu menulis JavaScript atau CSS berlebihan.

Technology Stack: Powered by TALL Stack

Filament dibangun di atas TALL Stack yang sangat populer di ekosistem Laravel:

Tailwind CSS → Styling modern & responsif
Alpine.js → Interaksi ringan di frontend
Livewire → Reactivity tanpa JavaScript berat
Laravel → Fondasi backend yang kuat

Kombinasi ini membuat Filament sangat ringan, cepat, dan mudah di-maintain.

Filament vs Alternatif Lain

AspekFilamentLaravel NovaBackpackOrchidHargaGratis (Open Source)BerbayarGratisGratisKecepatan DevelopmentSangat CepatCepatSedangSedangKustomisasiSangat TinggiTerbatasTinggiTinggiPerformaSangat BaikBaikSedangBaikKomunitasSangat BesarBesarSedangKecil

Banyak developer yang sebelumnya menggunakan Nova atau Backpack akhirnya beralih ke Filament karena fleksibilitas dan kecepatan development yang jauh lebih baik.

Siapa yang Cocok Menggunakan Filament?

Filament sangat cocok untuk:

Developer Laravel yang ingin membangun admin panel dengan cepat
Startup dan agensi yang ingin menghemat waktu development
Tim yang membutuhkan dashboard kompleks dan manajemen data
Developer yang ingin membangun aplikasi full-stack tanpa frontend framework terpisah
Proyek internal perusahaan (ERP, CRM, sistem manajemen, dll)

Kesimpulan

Filament PHP bukan hanya sekadar admin panel. Ia adalah ekosistem lengkap yang membantu developer Laravel membangun aplikasi dengan lebih cepat, lebih cantik, dan lebih mudah di-maintain.

Di tahun 2026, ketika kecepatan pengiriman produk menjadi semakin penting, Filament menawarkan keunggulan kompetitif yang sangat signifikan.

Jika kamu sedang membangun proyek baru dengan Laravel, sangat disarankan untuk mencoba Filament. Kamu mungkin tidak akan pernah kembali ke cara lama lagi.

Ingin mencoba langsung? Kunjungi situs resminya di https://filamentphp.com dan coba live demo yang sudah mereka sediakan.

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/filament-php-cara-tercepat-membangun-admin-panel-aplikasi-laravel-di-2026/

Testing Mathematical Formulas in Markdown

Ngopidulur — Fri, 30 May 2025 17:00:00 GMT

This document serves as a test for rendering mathematical formulas in Markdown using $$ delimiters.

Basic Algebra

Let's start with some fundamental algebraic expressions.

The quadratic formula is given by: $$x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}$$

A simple linear equation: $$y = mx + c$$

Expansion of a binomial square: $$(a+b)^2 = a^2 + 2ab + b^2$$

Calculus

Here are some common expressions from calculus.

The limit definition of a derivative: $$f'(x) = \lim_{h \to 0} \frac{f(x+h) - f(x)}{h}$$

A definite integral: $$\int_{a}^{b} f(x) dx$$

The Taylor series expansion of $e^x$ around $x=0$: $$e^x = \sum_{n=0}^{\infty} \frac{x^n}{n!} = 1 + x + \frac{x^2}{2!} + \frac{x^3}{3!} + \cdots$$

Trigonometry

Some basic trigonometric identities.

Pythagorean identity: $$\sin^2\theta + \cos^2\theta = 1$$

Angle addition formula for sine: $$\sin(\alpha + \beta) = \sin\alpha\cos\beta + \cos\alpha\sin\beta$$

Euler's formula: $$e^{i\theta} = \cos\theta + i\sin\theta$$

Statistics and Probability

Formulas commonly used in statistics and probability.

The formula for the mean ($\mu$) of a set of $n$ numbers $x_1, x_2, \ldots, x_n$: $$\mu = \frac{1}{n} \sum_{i=1}^{n} x_i$$

The probability density function of a normal distribution: $$f(x | \mu, \sigma^2) = \frac{1}{\sqrt{2\pi\sigma^2}} e^{-\frac{(x-\mu)^2}{2\sigma^2}}$$

Bayes' theorem: $$P(A|B) = \frac{P(B|A)P(A)}{P(B)}$$

Linear Algebra

Examples from linear algebra.

A 2x2 matrix: $$A = \begin{pmatrix} a & b \ c & d \end{pmatrix}$$

The determinant of a 2x2 matrix: $$\det(A) = ad - bc$$

Matrix multiplication of two matrices A and B: $$C = AB$$

Physics

A couple of well-known physics equations.

Einstein's mass-energy equivalence: $$E = mc^2$$

Newton's second law of motion: $$F = ma$$

This should provide a good test of how various mathematical formulas are rendered.

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/mathematics-examples/

Adding Comment Systems to Frosti

Ngopidulur — Mon, 14 Apr 2025 17:00:00 GMT

Introduction

One of the essential features of any blog is the ability for readers to engage with your content through comments. While Frosti provides an excellent foundation for your Astro-based blog, adding a comment system requires a few additional steps. This guide will walk you through integrating the Waline comment system into your Frosti blog.

Static sites like those built with Astro don't have built-in comment systems since they lack server-side processing. However, we can use third-party comment services that handle the backend for us, while we integrate their frontend components into our site.

Creating Comment Components in Astro

Before diving into a specific comment system, let's understand how to create and use components in Astro. We'll create a reusable component that can be easily added to any page.

Component Structure

We'll create our comment component in the src/components/comments directory. First, let's ensure this directory exists:

mkdir -p src/components/comments

Integrating Waline

Waline is a simple, safe, and feature-rich comment system with backend and frontend separation. It is highly customizable and easy to set up.

Step 1: Set Up Waline Backend

Before adding Waline to your site, you need to set up the backend:

Create a LeanCloud application to store your comments.
Deploy the Waline server to Vercel or another hosting platform.

Follow the official Waline guide to set up your backend service. After deploying, you'll get a server URL that you will need for the frontend component.

Step 2: Create the Waline Component

Let's create a reusable Waline component:

touch src/components/comments/Waline.astro

Add the following code to this component:

---
interface Props {
  serverURL: string;
  lang?: string;
  dark?: string;
  emoji?: string[];
  meta?: string[];
  requiredMeta?: string[];
  reaction?: boolean;
  pageview?: boolean;
}

const {
  serverURL,
  lang = "en",
  dark = "html[data-theme-type='dark']",
  emoji = ["https://unpkg.com/@waline/emojis@1.1.0/weibo", "https://unpkg.com/@waline/emojis@1.1.0/bilibili"],
  meta = ["nick", "mail", "link"],
  requiredMeta = [],
  reaction = false,
  pageview = false,
} = Astro.props;
---

<div id="waline-container"></div>

<link rel="stylesheet" href="https://unpkg.com/@waline/client@v3/dist/waline.css" />

<script
  type="module"
  define:vars={{
    serverURL,
    lang,
    dark,
    emoji,
    meta,
    requiredMeta,
    reaction,
    pageview,
  }}
>
  import { init } from "https://unpkg.com/@waline/client@v3/dist/waline.js";

  async function initWaline() {
    const container = document.querySelector("#waline-container");
    if (!container) return;

    init({
      el: "#waline-container",
      serverURL,
      path: location.pathname,
      lang,
      dark,
      emoji,
      meta,
      requiredMeta,
      reaction,
      pageview,
    });
  }

  document.addEventListener("astro:page-load", () => {
    initWaline();
  });

  if (document.readyState !== "loading") {
    initWaline();
  } else {
    document.addEventListener("DOMContentLoaded", initWaline);
  }
</script>

<style>
  #waline-container {
    margin-top: 2rem;
    margin-bottom: 2rem;
  }
</style>

Step 3: Using the Waline Component

You can now use the Waline component in your Astro pages or layouts. Here's how to add it to your blog post template:

---
// In your blog post layout file
import Waline from "../../components/comments/Waline.astro";
// Other imports and frontmatter...
---

<!-- Your blog post content -->
<article>
  <slot />
</article>

<!-- Add the comment section -->
<section class="comments">
  <h2>Comments</h2>
  <Waline serverURL="https://your-waline-server.vercel.app" />
</section>

Replace "https://your-waline-server.vercel.app" with your actual Waline server URL.

Troubleshooting

Common Issues

Comments not displaying: Make sure your serverURL is correctly set and accessible.
CSS issues: Ensure that the Waline stylesheet is properly loaded.
Deployment issues: If your server is on Vercel, check the environment variables and deployment logs.

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/adding-comment-systems/

Markdown Style Guide

Ngopidulur — Sun, 30 Jun 2024 17:00:00 GMT

Here is a sample of some basic Markdown syntax that can be used when writing Markdown content in Astro.

Headings

The following HTML <h1>—<h6> elements represent six levels of section headings. <h1> is the highest section level while <h6> is the lowest.

H1

H2

H3

H4

H5

H6

Paragraph

Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma dolestendit peritin re plis aut quas inctum laceat est volestemque commosa as cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin porecus evelectur, cum que nis nust voloribus ratem aut omnimi, sitatur? Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad quibus unda veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata tiustia prat.

Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sapicia is sinveli squiatum, core et que aut hariosam ex eat.

Images

Syntax

![Alt text](./full/or/relative/path/of/image)

Output

Blockquotes

The blockquote element represents content that is quoted from another source, optionally with a citation which must be within a footer or cite element, and optionally with in-line changes such as annotations and abbreviations.

Blockquote without attribution

Syntax

> Tiam, ad mint andaepu dandae nostion secatur sequo quae.
> **Note** that you can use _Markdown syntax_ within a blockquote.

Output

Tiam, ad mint andaepu dandae nostion secatur sequo quae. Note that you can use Markdown syntax within a blockquote.

Blockquote with attribution

Syntax

> Don't communicate by sharing memory, share memory by communicating.<br>
> — <cite>Rob Pike[^1]</cite>

Output

Don't communicate by sharing memory, share memory by communicating.
— Rob Pike[^1]

[^1]: The above quote is excerpted from Rob Pike's talk during Gopherfest, November 18, 2015.

Tables

Syntax

| Italics   | Bold     | Code   |
| --------- | -------- | ------ |
| _italics_ | **bold** | `code` |

Output

Italics	Bold	Code
italics	bold	`code`

Code Blocks

Syntax

we can use 3 backticks ``` in new line and write snippet and close with 3 backticks on new line and to highlight language specific syntac, write one word of language name after first 3 backticks, for eg. html, javascript, css, markdown, typescript, txt, bash

```cpp
#include <bits/stdc++.h>
using namespace std;
const int N = 1e5 + 5;
int n, k, a[N];
long long ans;
vector<int> v[N];
int main()
{
    scanf("%d%d", &n, &k);
    for (int i = 1; i <= n; i++)
    {
        scanf("%d", &a[i]);
        v[i % k].push_back(a[i]);
    }
    for (int i = 0; i < k; i++)
        sort(v[i].rbegin(), v[i].rend());
    for (int i = 0; i < k; i++)
    {
        for (int j = 0; j + 1 < v[i].size(); j += 2)
        {
            ans += v[i][j] + v[i][j + 1];
        }
    }
    printf("%lld\n", ans);
    return 0;
}
```

Output

#include <bits/stdc++.h>
using namespace std;
const int N = 1e5 + 5;
int n, k, a[N];
long long ans;
vector<int> v[N];
int main()
{
    scanf("%d%d", &n, &k);
    for (int i = 1; i <= n; i++)
    {
        scanf("%d", &a[i]);
        v[i % k].push_back(a[i]);
    }
    for (int i = 0; i < k; i++)
        sort(v[i].rbegin(), v[i].rend());
    for (int i = 0; i < k; i++)
    {
        for (int j = 0; j + 1 < v[i].size(); j += 2)
        {
            ans += v[i][j] + v[i][j + 1];
        }
    }
    printf("%lld\n", ans);
    return 0;
}

List Types

Ordered List

Syntax

1. First item
2. Second item
3. Third item

Output

First item
Second item
Third item

Unordered List

Syntax

- List item
- Another item
- And another item

Output

List item
Another item
And another item

Nested list

Syntax

- Fruit
  - Apple
  - Orange
  - Banana
- Dairy
  - Milk
  - Cheese

Output

Fruit
- Apple
- Orange
- Banana
Dairy
- Milk
- Cheese

Other Elements

Syntax

<abbr title="Graphics Interchange Format">GIF</abbr> is a bitmap image format.

H<sub>2</sub>O

X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>

Press <kbd>CTRL</kbd>+<kbd>ALT</kbd>+<kbd>Delete</kbd> to end the session.

Most <mark>salamanders</mark> are nocturnal, and hunt for insects, worms, and other small creatures.

Output

GIF is a bitmap image format.

H₂O

Xⁿ + Yⁿ = Zⁿ

Press CTRL+ALT+Delete to end the session.

Most salamanders are nocturnal, and hunt for insects, worms, and other small creatures.

This rendering was automatically generated by Frosti Feed and may have formatting issues. For the best experience, please visit: https://ngopidulur.my.id/blog/markdown-style-guide/

Using MDX

Ngopidulur — Fri, 01 Jul 2022 17:00:00 GMT

This theme comes with the @astrojs/mdx integration installed and configured in your astro.config.mjs config file. If you prefer not to use MDX, you can disable support by removing the integration from your config file.

Why MDX?

MDX is a special flavor of Markdown that supports embedded JavaScript & JSX syntax. This unlocks the ability to mix JavaScript and UI Components into your Markdown content for things like interactive charts or alerts.

If you have existing content authored in MDX, this integration will hopefully make migrating to Astro a breeze.

Example

Here is how you import and use a UI component inside of MDX.
When you open this page in the browser, you should see the clickable button below.

Ngopidulur

Transport Project Doc

Dokumentasi Project — Sankyu Transport Management System

Daftar Isi

1. Tech Stack

Backend — node_backend/

Dependency Utama Backend

Frontend — tailadmin-vuejs-1.0.0/

Dependency Utama Frontend

Documentation — docs/

External Services

Ports Default

2. Architecture

Gambaran Umum

Backend Architecture

Layer Pattern

Route Registration

Authentication Flow

Role-Based Access Control

Database Connection

External Integration: Wialon

Geofence Tracking (Background Service)

Frontend Architecture

Component Hierarchy

API Communication

State Management

Map Architecture (Monitoring)

Data Flow Patterns

Soft Delete Pattern

Date Handling

File Upload Pattern

3. Development Setup

Prerequisites

Langkah 1: Clone Repository

Langkah 2: Setup Backend

Install Dependencies

Konfigurasi Environment

Setup Database

Jalankan Backend

Langkah 3: Setup Frontend

Install Dependencies

Jalankan Frontend

Langkah 4: Setup Documentation (Opsional)

Verifikasi Setup

Development Workflow

Hot Reload

Akses dari Device Lain di LAN

Build Check (Frontend)

Linting & Formatting

4. Database & Migrations

Overview

Struktur File

Migration Commands

Workflow: Membuat Perubahan Schema Baru

Naming Convention Migration

Tabel Utama

truck

driver

sales_cost

area

area_route_step

sales_cost_route_history

schema_migrations

Connection Pool

Penggunaan di Route/Service

MongoDB (Legacy)

Backup & Restore

Tips Database

5. API Reference

Authentication

Login

Get Current User

Update Profile

Master Data

Trucks

Drivers

Customers

Areas

Warehouses

Subcontractors

Backend — `node_backend/`

Frontend — `tailadmin-vuejs-1.0.0/`

Documentation — `docs/`

`truck`

`driver`

`sales_cost`

`area`

`area_route_step`

`sales_cost_route_history`

`schema_migrations`