# 📘 Smart Order & Restaurant OS — Dokumentasi Teknis

Dokumentasi lengkap untuk pengembangan dan implementasi sistem **Smart Order & Restaurant Operating System** (Laravel Modular – Microservice Ready).

---

## Daftar Dokumen

| No | Dokumen | Deskripsi |
|----|---------|-----------|
| 1 | [Visi & Prinsip Desain](01-VISION-AND-PRINCIPLES.md) | Tujuan sistem, prinsip arsitektur, nilai bisnis |
| 2 | [Arsitektur Tingkat Tinggi](02-ARCHITECTURE-HIGH-LEVEL.md) | Layer, client, application, domain, infrastructure |
| 3 | [Struktur Modul Laravel](03-MODULE-STRUCTURE.md) | Konvensi folder, modul wajib, dependency |
| 4 | [Blueprint Modul (Detail)](04-MODULE-BLUEPRINTS.md) | Setiap modul: entitas, API, event, policy |
| 5 | [Data & Integrasi](05-DATA-AND-INTEGRATION.md) | Database, event, queue, cache |
| 6 | [Keamanan & Governance](06-SECURITY-GOVERNANCE.md) | RBAC, audit, approval, soft delete |
| 7 | [Roadmap Implementasi](07-ROADMAP-IMPLEMENTATION.md) | Phase 1–4, milestone, deliverable, tech stack |
| 8 | [API Design](08-API-DESIGN.md) | REST, versioning, error, pagination |
| 9 | [Konsep Skema Database](09-DATABASE-SCHEMA-CONCEPTS.md) | Tabel inti, relasi, indeks |
| 10 | [Strategi Testing](10-TESTING-STRATEGY.md) | Unit, feature, E2E, performance |
| 11 | [Strategi Deployment](11-DEPLOYMENT-STRATEGY.md) | Env, CI/CD, monitoring |
| 12 | [Evolusi Microservice](12-MICROSERVICE-EVOLUTION.md) | Urutan pemisahan, API boundary |
| 13 | [UI/UX Design System](13-UI-UX-DESIGN-SYSTEM.md) | Token, komponen, halaman, aksesibilitas |
| 14 | [Standar Kualitas](14-QUALITY-STANDARDS.md) | Naming, controller, boundary, event |
| 15 | [**Checklist Fitur & Modul**](15-FEATURE-MODULE-CHECKLIST.md) | Status implementasi per modul & Phase (Sudah / Sebagian / Belum) |
| 16 | [API Order (Referensi)](16-API-ORDER-REFERENCE.md) | Endpoint GET/POST Order (list, show, update status); **OpenAPI:** [openapi.yaml](openapi.yaml), UI di `/api-docs` |
| 17 | [**Peta Meja & Tempat**](17-PETA-MEJA-DAN-TEMPAT.md) | Panduan operator: konfigurasi tempat, meja, editor tata letak, dan penggunaan di POS |
| 18 | [**Payment Gateway Integration**](18-PAYMENT-GATEWAY-INTEGRATION.md) | Arsitektur pembayaran online (Midtrans, QRIS), setup, webhook |
| 19 | [**Multi-Tenant & SaaS**](19-MULTI-TENANT-SAAS.md) | Isolasi data, subscription plan, billing, data privacy |
| 20 | [**Lokalisasi Indonesia**](20-LOKALISASI-INDONESIA.md) | Bahasa, pajak (PPN), mata uang, regulasi UU PDP, target pasar |
| 21 | [**Changelog**](21-CHANGELOG.md) | Catatan perubahan penting per tanggal |
| 22 | [**Analisis Kompetitif**](22-COMPETITIVE-ANALYSIS.md) | Perbandingan vs ESB Order, Majoo, Moka POS, positioning |
| — | [**Verifikasi Docs vs Sistem**](DOCS-VS-SISTEM.md) | Pemetaan dokumen vs status implementasi di codebase |

---

## Cara Pakai

- **Develop:** Mulai dari Phase 1 di [07-ROADMAP-IMPLEMENTATION.md](07-ROADMAP-IMPLEMENTATION.md), ikuti [03-MODULE-STRUCTURE.md](03-MODULE-STRUCTURE.md) dan [04-MODULE-BLUEPRINTS.md](04-MODULE-BLUEPRINTS.md).
- **Status fitur:** Cek [15-FEATURE-MODULE-CHECKLIST.md](15-FEATURE-MODULE-CHECKLIST.md) untuk daftar fitur/modul yang sudah, sebagian, atau belum diimplementasi.
- **Tim baru:** Baca [01-VISION-AND-PRINCIPLES.md](01-VISION-AND-PRINCIPLES.md) dan [02-ARCHITECTURE-HIGH-LEVEL.md](02-ARCHITECTURE-HIGH-LEVEL.md) dulu.
- **Pitching / partner:** Gunakan Visi, Arsitektur, Roadmap, UI/UX Design System, dan [22-COMPETITIVE-ANALYSIS.md](22-COMPETITIVE-ANALYSIS.md).
- **Pasarkan di Indonesia:** Baca [20-LOKALISASI-INDONESIA.md](20-LOKALISASI-INDONESIA.md) dan [22-COMPETITIVE-ANALYSIS.md](22-COMPETITIVE-ANALYSIS.md).
- **Payment gateway:** Lihat [18-PAYMENT-GATEWAY-INTEGRATION.md](18-PAYMENT-GATEWAY-INTEGRATION.md).
- **Naik ke microservice:** Lihat [12-MICROSERVICE-EVOLUTION.md](12-MICROSERVICE-EVOLUTION.md).

---

*Smart Order & Restaurant OS — Lebih rapi, modern, dan siap scale dari ESB Order.*
