# Dokumentasi Flow — POS Web Manager Frontend

> **Catatan:** Folder ini sengaja di-gitignore (`docs/flows/` di `.gitignore`) — dokumentasi ini untuk konsumsi lokal tim, tidak dipush ke repo. Setiap orang yang butuh bisa generate ulang/update via AI assistant kapan saja, jadi tidak perlu sinkron lewat git.

Dokumen ini menjelaskan **bagaimana tiap modul bekerja end-to-end**: input apa yang ditangkap di form, validasi apa yang jalan di frontend, endpoint apa yang dipanggil, dan respons apa yang diharapkan. Tujuannya supaya tim bisa cepat paham codebase (yang sebagian besar dibangun dengan bantuan AI) dan mengambil keputusan teknis tanpa harus membaca ulang seluruh kode setiap kali.

## Mulai dari sini

👉 **[00-overview.md](00-overview.md)** — arsitektur, konvensi umum, pola axios interceptor, mode dummy vs backend asli. **Baca ini dulu** sebelum modul lain, karena semua modul mengasumsikan konteks ini.

## Daftar modul

| Modul | File | Status integrasi BE |
|---|---|---|
| [01-auth.md](01-auth.md) | Login, Register, Forgot/Reset/Change Password | ✅ Terhubung |
| [02-dashboard.md](02-dashboard.md) | Dashboard ringkasan | ✅ Terhubung (komposit dari endpoint reports) |
| [03-master-data.md](03-master-data.md) | Cabang, Kategori, Satuan, Modifier, Meja, Pelanggan | ✅ Terhubung |
| [04-products.md](04-products.md) | Produk (paling kompleks — 5 endpoint per save) | ✅ Terhubung |
| [05-inventory.md](05-inventory.md) | Bahan Baku, Stok Produk | ✅ Terhubung |
| [06-discounts.md](06-discounts.md) | Diskon | ✅ Terhubung |
| [07-sales.md](07-sales.md) | Laporan, Transaksi, Shift Log (read-only) | ✅ Terhubung |
| [08-users-roles.md](08-users-roles.md) | Pengguna & Peran (permission matrix) | ✅ Terhubung |
| [09-settings.md](09-settings.md) | Info Toko, Pembayaran, Pajak, Printer | ✅ Terhubung (Printer = belum ada UI) |

## Hal yang masih belum selesai / butuh perhatian (per Juni 2026)

- **Settings → Printer**: service API sudah siap (`/v1/printers`), UI belum dibangun ([09-settings.md](09-settings.md))
- **Role → tab "Mobile Apps"**: disembunyikan karena backend belum enforce permission di rute kasir mobile ([08-users-roles.md](08-users-roles.md))
- **Modifier → "Ambil dari Bahan Baku"**: disembunyikan, backend belum simpan data potong stok per opsi modifier ([03-master-data.md](03-master-data.md))
- **Branch → "Tampilan Sisi Pelanggan"** (banner promosi, video bumper): disembunyikan, belum diimplementasikan di QR/POS frontend ([03-master-data.md](03-master-data.md))
- **Refresh token otomatis**: endpoint ada (`authService.refresh`) tapi tidak dipanggil otomatis di mana pun saat ini ([01-auth.md](01-auth.md))

Semua dokumen ditulis berdasarkan pembacaan langsung source code per 2026-06-25 — kalau ada perbedaan dengan perilaku aktual di production, source code yang menang, dokumen ini perlu di-update.
