Bengkel Pintar ERP
Dokumentasi flow diagram, PRD, dan skenario operasional sistem manajemen bengkel multi-cabang. Setiap modul dilengkapi diagram alur, mockup UI, dan panduan penggunaan. v1.1 — dashboard widget system, corporate pricing, akuntansi profesional, real-time WebSocket.
20+
Modul
50+
Flow Diagram
22
Skenario
8
Role Pengguna
📝 Changelog v1.1 (Update terbaru)
📊 Dashboard Widget System
- 20+ widget self-contained: KPI cards, charts, lists, finance
- Layout per role disimpan di DB (
DashboardLayout) - Admin editor drag-drop di
/settings/dashboard - AR Aging widget + TrendChart dengan target line & forecast EOM
- Sensitive widget marker ($) untuk finance widgets
- Detail: Dashboard docs
👥 Customer Type & Corporate Pricing
- 6 customer type: regular / istimewa / internal / corporate / vip / member
- 3 tabel custom pricing: Part / Jasa / Paket
- Corporate fields: NPWP, PIC, contractStart/End, paymentTermDays, creditLimit
- Tempo close untuk AR posting + dueDate
- Detail: CRM docs
💳 Kasir & Direct Sale
- DirectSale module — penjualan langsung tanpa SPK + struk PDF
- closeAsTempo() untuk pembayaran kredit corporate
- Tanpa PPN checkbox per transaksi (WO/Quotation/PO)
- Thousand separator penuh untuk semua input nominal
- Detail: Kasir docs
📦 Inventory: Saldo Awal & Opname
- Form Saldo Awal Stok dengan editable buyPrice
- Form Stock Opname rekonsiliasi fisik vs sistem
- Kolom "Nilai Stok" di tabel inventory
- Validasi non-negatif di keypress level
- Detail: Inventory docs
💰 Akuntansi Profesional
- Saldo Awal akun (opening balance JournalEntry)
- Periode Fiskal: open / closed / locked
- Budget per akun × bulan × departemen × cabang
- AR Aging buckets, postARInvoice, postARReceive
- Detail: Finance docs
🔧 WO Real-time & Field Baru
- WebSocket multi-role: KARU konfirmasi → SA & mekanik update tanpa refresh
- Field
dueDate&noPpndi WO - Booking pre_wo wajib mekanik, regular tidak perlu
- Bay maintenance auto-filter dari stall picker
- Detail: WO docs · Operator docs
🔐 RBAC Updates
- Resource baru:
settings.dashboard,inventory.opening,inventory.opname,settings.ai - Auto-link user ke custom role saat create
- LEGACY_ALLOWED diperbarui untuk manager (akses settings.dashboard)
- Detail: RBAC docs
🎨 UI Conventions
- Sticky filter bar + table header rule (universal)
- DataListShell pattern (Acumatica-style)
- Persisted sidebar collapsed state per role (localStorage)
- Kasir layout dapat brand label "Bengkel Pintar"
🏢 Multi Cabang
Setiap cabang beroperasi secara mandiri dengan data terpisah. Kantor pusat dapat memonitor seluruh cabang secara real-time.
👥 Role-Based Access
6 role pengguna: Super Admin, Admin Cabang, Kasir, Mekanik, Kepala Mekanik, Gudang — setiap role memiliki akses terbatas sesuai fungsinya.
🔄 Approval Berjenjang
Transaksi di atas threshold tertentu memerlukan approval berjenjang. Flow approval dapat dikonfigurasi per cabang dan per tipe transaksi.
📱 Responsive UI
Interface dibangun dengan Next.js + Tailwind CSS. Mendukung akses dari desktop maupun tablet untuk semua role operasional.
Core Operations
Work Order
Alur pengelolaan pekerjaan servis dari antrian hingga selesai dan serah terima kendaraan
CRM / Pelanggan
Customer master, vehicles, follow-up, loyalty tier, reminders, reviews, corporate pricing — 8 sub-fitur
Kasir & POS
Pembayaran, split payment, cetak invoice & manajemen receipt pelanggan
Quotation / SPK
Surat Penawaran Kerja, estimasi biaya, dan konversi ke Work Order
Operator & Mekanik
Job tracking mekanik, progress pengerjaan, dan time logging per item servis
Inventory & Procurement
Finance & HR
Finance & Kas
Kas masuk/keluar, rekap pendapatan, hutang/piutang, dan laporan keuangan
HCM / Karyawan
Data karyawan, jadwal shift, absensi, komisi mekanik, dan manajemen performa
KPI / Performa
Pengukuran KPI multi-role (mekanik, kasir, gudang), input harian, agregasi bulanan, output ke komisi
Aset Management
Aset bengkel (peralatan, kendaraan operasional), depresiasi, dan pemeliharaan
Analytics
System & Admin
Approval Workflow
Multi-level approval (Rule → Level → Approver), threshold per cabang, audit trail. Pakai untuk PO, discount, payroll, dst.
RBAC & Akses
Role-based access control, permission matrix, dan manajemen akses per cabang
Master Data
Master jasa, paket, kategori part, merk kendaraan, metode bayar, departments, settings (12+ master)
Autentikasi
Argon2 hashing, JWT (access+refresh), WS Ticket via Redis, anti-brute-force, password reset flow
Skenario Operasional
Panduan langkah-demi-langkah untuk alur kerja nyata di bengkel. Setiap skenario menunjukkan siapa yang melakukan apa, kapan, dan bagaimana tampilannya di sistem.
Walk-in Customer
Pelanggan datang langsung tanpa booking — dari antrian hingga pembayaran dan serah terima
Booking Service
Pelanggan booking online, konfirmasi jadwal, check-in, servis, hingga invoice
Alur Parts Request
Mekanik request sparepart, approval gudang, pengeluaran stok, dan PO ke supplier jika habis
End-to-End Flow
Alur lengkap dari booking ke WO, servis, parts, QC, invoice, dan pembayaran
Skenario per Modul
16 skenario fokus per modul: Work Order, Kasir, Inventory, Finance, KPI, dst — dengan UI mockup & sequence diagram. Akses via sidebar.
Tech Stack
Frontend (Admin & Landing)
Next.js 15 + React 19, TypeScript strict, Tailwind CSS, native fetch + JWT, WebSocket native via ticket flow
Backend (API)
Hono on Bun (TypeScript), Prisma 7 (driverAdapters), pg, BullMQ workers, node-cron, pino logger, Argon2 password hashing
Storage
PostgreSQL 14+ (eksternal/managed), Redis 7 (shared state, pub/sub, queue broker), MinIO S3-compatible (object storage)
Infrastructure
Docker Compose multi-service, Caddy reverse proxy + active health-check, PgBouncer transaction pool, zero-downtime rolling deploy
Arsitektur Scaling (Multi-Instance Ready)
Topology Production
API & Worker scalable (rolling deploy zero-downtime). Cron service replicas=1 (anti duplicate trigger). Shared state via Redis.
flowchart TB
C[Caddy Reverse Proxy
active health-check
:4100] --> A1[API #1
:4000] C --> A2[API #2
:4000] C --> A3[API #N] A1 --> R[(Redis
:6379
pub/sub + queue
+ ticket store)] A2 --> R A3 --> R A1 --> PB[PgBouncer
txn pool] A2 --> PB A3 --> PB PB --> PG[(PostgreSQL
eksternal)] CRON[Cron Service
replicas=1
node-cron + DB-driven] --> R CRON --> PB W1[Worker #1
BullMQ consumer] --> R W2[Worker #2
scalable] --> R W1 --> PB W1 --> M[(MinIO
S3 object storage)] A1 --> M A2 --> M style C fill:#dbeafe,stroke:#3b82f6 style R fill:#fee2e2,stroke:#dc2626 style PB fill:#fef3c7,stroke:#d97706 style CRON fill:#f0fdf4,stroke:#16a34a
active health-check
:4100] --> A1[API #1
:4000] C --> A2[API #2
:4000] C --> A3[API #N] A1 --> R[(Redis
:6379
pub/sub + queue
+ ticket store)] A2 --> R A3 --> R A1 --> PB[PgBouncer
txn pool] A2 --> PB A3 --> PB PB --> PG[(PostgreSQL
eksternal)] CRON[Cron Service
replicas=1
node-cron + DB-driven] --> R CRON --> PB W1[Worker #1
BullMQ consumer] --> R W2[Worker #2
scalable] --> R W1 --> PB W1 --> M[(MinIO
S3 object storage)] A1 --> M A2 --> M style C fill:#dbeafe,stroke:#3b82f6 style R fill:#fee2e2,stroke:#dc2626 style PB fill:#fef3c7,stroke:#d97706 style CRON fill:#f0fdf4,stroke:#16a34a
Redis (Shared State)
- Rate-limit cross-instance (atomic INCR + EXPIRE)
- WebSocket ticket store (SETEX + GETDEL one-time)
- WS pub/sub channel
ws:events— event sampai ke semua instance - BullMQ queue broker (pdf, excel, email, whatsapp)
- Cron reload signal channel
cron:reload
Cron Service Terpisah
- Replicas tepat 1 — anti duplicate trigger saat API scale
- DB-driven schedule (tabel
CronJob,CronRun) - Hot-reload via Redis signal (perubahan UI admin langsung efektif)
- Configurable via Admin → Settings → Cron Jobs
- Default jobs auto-seed: stock-alert, booking-reminder, payroll-generate, dst
Worker Queue (BullMQ)
- Offload CPU-heavy: PDF render (PDFKit), Excel build (XLSX)
- Async background: email, WhatsApp, retry strategies
- Scalable, drain-safe rolling deploy
- At-least-once delivery, idempotent handler
Zero-Downtime Deploy
deploy.sh: build → infra up → migrate → rolling api → rolling worker → recreate cron- Caddy auto-route via DNS re-resolve (no manual config)
- Healthcheck-driven: container baru harus healthy sebelum container lama dimatikan
- Worker drain in-flight job sebelum exit (BullMQ
worker.close())