Sentra Series — Enterprise System Master Documentation¶

Kumpulan blueprint, spesifikasi teknis/bisnis, dan desain database sistem manajemen usaha skala produksi (production-ready) untuk pasar Indonesia. Disusun dengan standar rekayasa perangkat lunak modern agar siap diimplementasikan oleh tim pengembang, dipelajari oleh analis bisnis, diuji oleh tim QA, dan dievaluasi oleh pemangku kepentingan.

Setiap sistem mengikuti struktur modular yang sama (9 bab + folder modul fungsional) di atas baseline tech stack, security pattern, dan deployment topology yang seragam.

🗺️ 8 Sistem Domain¶

:material-cart: Retail POS

Multi-branch inventory, tiered pricing (grosir/eceran), loyalty program, offline-first POS, predictive reorder.
:material-food: F&B Restaurant

Kitchen Display System live, recipe BOM + HPP variance, split-bill kompleks, FIFO ingredient batch.
:material-medical-bag: Healthcare / Clinic

HL7 FHIR SatuSehat Kemenkes, BPJS PCare/VClaim, BSrE digital signature, RME immutable.
:material-wrench: Automotive Workshop

Work Order lifecycle, riwayat VIN kendaraan, sparepart auto-reorder & substitute, mechanic pay-per-job.
:material-dumbbell: Membership / Gym

RFID IoT gate + MQTT, anti-passback, in-app wallet ledger anti-fraud, instructor incentive.
:material-car: Rental & Asset Management

Redis bitmask calendar, Redlock anti double-booking, deposit pre-auth, offline inspector handover.
:material-tshirt-crew: Laundry

Weight-based POS (timbangan digital), queue tracking BOH FSM, courier route optimizer.
:material-scissors-cutting: Service Booking (Salon/Bengkel)

Time-slot booking no-conflict, shift auto-scheduling, WhatsApp notification, staff performance.

🔧 Fondasi Bersama (Cross-Cutting)¶

Konten baseline yang berlaku di semua sistem — di-extract supaya tidak duplikasi dan satu source of truth.

Dokumen	Isi
Tech Stack Baseline	PostgreSQL, Redis, NestJS, Next.js, Go, React Native — versi resmi dan alasan pemilihan
Security Patterns	Immutable audit log (hash chain), supervisor PIN, RBAC branch-scoped, SQLCipher, PJSP callback
Deployment Baseline	Topologi Edge → Cloudflare → ALB → K8s → Aurora + Redis cluster
POS Engine Principles	5 pilar: offline-first, split-bill, real-time inventory, cashless, anti-fraud
Diagram Conventions	Penamaan node standar untuk Mermaid diagram
Glossary	Istilah domain (HPP, FEFO, FHIR, BPJS, Redlock, RFID, RME, dll)

👀 Cross-System Layer View¶

Untuk engineer yang bekerja per-spesialisasi dan butuh akses bab spesifik dari semua sistem yang sedang dibangun:

Layer	Index	Untuk
Database	database.md	DB Engineer — ERD + schema dari 8 sistem
API	api.md	Backend Engineer — endpoint spec dari 8 sistem
Modules	modules.md	Domain Engineer — flow modular per sistem
UI Wireframes	ui.md	Frontend Engineer — ASCII wireframes + user stories
Ops	ops.md	DevOps Engineer — security delta + deployment delta + testing

📂 Struktur Per Sistem¶

Setiap folder systems/<slug>/ mengikuti struktur seragam:

systems/<slug>/
├── 00-overview.md            # PRD + Business Flow + Feature List
├── 01-architecture.md        # System Architecture + Tech Stack delta
├── 02-database.md            # ERD + table specs + indexing
├── 03-api.md                 # API endpoints + JSON examples
├── 04-modules/               # Modul fungsional (1 file per modul)
│   ├── _index.md
│   └── <modul>.md            # mis. pos.md, kds.md, work-order.md
├── 05-ui-wireframes.md       # ASCII wireframes + user stories
├── 06-roles-permissions.md   # Role × permission matrix
├── 07-ops.md                 # Security delta + Deployment delta + Testing
├── 08-edge-cases.md          # Edge cases & incident handling
└── 09-scalability-future.md  # Scalability + future improvements

📦 Archive¶

Dokumen monolitik original (sebelum restrukturisasi modular) di-freeze sebagai referensi historis di archive/legacy-monolithic/ di repository.

🤝 Kontribusi¶

Lihat CONTRIBUTING.md di repository untuk:

Cara menambah sistem baru (init_system.py scaffolder)
Cara edit dokumen existing (frontmatter wajib, delta-only convention)
Pre-commit hooks (regen layer index + linter)
Strict audit mode untuk catch duplicate baseline content

Disusun oleh Senior Architect. Dimodularisasi dengan tooling Python linter + MkDocs Material.