Audit dokumentasi · Panduan per peran · Bukti

Dokumentasi yang
bisa dipakai.
Bukan sekadar rencana.

Panduan Pemilik/Manajer dan Kasir untuk MCorner v0.7.7, disusun dari source, tes, dan alur yang benar-benar dijalankan di lingkungan lokal. Setiap klaim menyebut versi, environment, dan batasnya.

v0.7.7 · commit ffb06aa7 9 Nov 2026 · WITA 93/93 tes lulus 18 bukti visual

Data pada tangkapan layar adalah fiktif. Dokumen ini bukan pernyataan bahwa aplikasi siap menerima uang atau keputusan HR sungguhan.

Status paket
v0.7.7
Lokal · preview
Commit aplikasi
ffb06aa7
Schema
0010 · shift templates
Environment
127.0.0.1 · D1/R2 lokal
Tanggal audit
9 November 2026
93Tes lulus
12Temuan
4Panduan
11/24UAT dijalankan
Disusun dari snapshot tanpa riwayat Git. Bukan sertifikasi produksi.
01 — Ringkasan

Apa yang berubah.

Sebelumnya belum ada panduan pengguna per peran, dan status antar dokumen saling bertentangan. Seri ini menambahkan panduan prioritas, audit yang dapat ditelusuri, dan bukti eksekusi nyata.

93Tes otomatis11 file · 13,7 detik · Node 26.11.1
18ScreenshotPOS 390×844 · Workspace 1280×900
12Temuan2 tinggi · 5 sedang · 4 rendah · 1 info
6Konflik dokumenStatus, deploy, PWA, dan penjadwalan
/

Workspace

Ringkasan, presensi, jadwal, dana, akuntansi, tim, audit, versi.

/portal

Portal karyawan

Jadwal pribadi, check-in/out foto & GPS, slip gaji, pengajuan.

/pos

POS

Tagihan meja, pesanan, tiket dapur/bar, tunai, shift kasir, laporan.

/order

HP Tamu

QR kunjungan dari kasir; pesanan masuk ke tagihan yang sama.

PeranPemilikSupervisorKasirPelayanDapurBarFinanceHRKaryawanDeveloper
Manajer café = Supervisor. Tidak ada peran manager terpisah di kode. Developer adalah identitas teknis; pengujian dilakukan lewat Uji sebagai akun bisnis di preview.
02 — Panduan

Langkah yang bisa diikuti.

Label tombol ditulis persis seperti aplikasi. Tab di bawah memuat alur Kasir, pekerjaan Pemilik/Manajer, dan langkah awal. Klik gambar untuk memperbesar.

Sebelum mulai: akun Kasir, master bahan/menu/meja siap, terminal diketahui, dan uang awal laci sudah dihitung. Tanpa shift kasir, tagihan tidak bisa dibuat.
01

Buka shift kasir

Shift Kasir → Buka shift, isi terminal dan modal awal laci. Modal awal bukan pendapatan.

Hasil: lencana POS-01 · shift terbuka
02

Buka tagihan meja

+ Tagihan / meja → pilih Meja / layanan (atau Bawa pulang) → simpan. QR kunjungan muncul untuk meja.

Satu meja = satu tagihan terbuka. Master meja saja tidak membuka tagihan.
03

Pilih tagihan, tambah menu

Pada Pilih tagihan, pilih tagihan aktif. Ketuk menu → pilih varian/ekstra → Tambah · Rp ….

Keranjang terikat pada satu tagihan, maksimal 20 baris.
04

Kirim pesanan

Periksa catatan, lalu Terima & kirim pesanan. Tiket dapur/bar, stok, dan jurnal terbentuk.

Keranjang kosong; pesanan menjadi batch yang tidak bisa diedit.
05

Selesaikan tiket

Tab Dapur & Bar: Mulai kerjakan → Tandai siap → Sudah diantar.

Urutan tidak bisa dilompati. Pelayan hanya mengonfirmasi pengantaran.
06

Terima pembayaran tunai

Bayar tunai → pilih patungan → isi jumlah dan uang diterima → Catat penerimaan tunai.

Contoh uji: tagihan Rp44.000, tunai Rp50.000, kembali Rp6.000.
07

Struk & cetak ulang

Riwayat → Lihat / cetak struk. Cetak / simpan PDF membuka dialog cetak browser.

Cetak ulang tidak membuat pembayaran baru.
08

Tutup tagihan, lalu tutup shift

Tutup tagihan hanya bila lunas, tidak ada pesanan tamu menunggu, dan semua tiket selesai. Lalu Hitung & tutup shift.

Tutup shift ditolak bila masih ada tagihan terbuka.
Batas: QRIS belum aktif, tidak ada penerimaan tunai offline, printer langsung belum terkonfigurasi, dan refund sesudah bayar belum ada. Void hanya sebelum produksi dan sebelum pembayaran.
03 — Audit

Dokumen vs kenyataan.

28 Markdown diperiksa terhadap source, 10 migrasi, tes, dan UI lokal. Masalah terbesar bukan isi teknis, melainkan status yang saling bertentangan.

DokumenStatusCatatan
Kesimpulan audit: isi teknis modul umumnya cocok. Yang perlu diperbaiki lebih dulu adalah status di README dan architecture/README, banner pada plan, serta satu sumber kebenaran untuk perintah deploy.
04 — Temuan

Dua belas hal
yang perlu diputuskan.

Empat di antaranya adalah perilaku UI, bukan salah tulis dokumen. Tidak ada perbaikan kode yang dilakukan dalam tugas dokumentasi ini.

05 — Ketertelusuran

Klaim, bukti, celah.

R01–R23 dipetakan ke modul dan bukti. Status "AB" berarti aktif tetapi belum diverifikasi di perangkat/produksi — bukan berarti fitur tidak ada.

AT Aktif-terverifikasi AB Aktif-belum-diverifikasi P Parsial R Direncanakan
Bukti terkuat: R01–R04, R07, R08, R15, R18 — peran, QR kunjungan, batch/stasiun, stok, shift kasir, delegasi, dan template shift. Belum boleh disebut selesai: QRIS, POS offline, arus kas/tutup periode, backup/restore, dan approval berjenjang.
06 — Bukti

Yang benar-benar dijalankan.

93 tes lulus pada Node 26.11.1 (proyek mem-pin 24). Alur kasir lengkap dijalankan lewat browser; 11 dari 24 skenario UAT sudah lulus, sisanya belum diuji atau terblokir perangkat.

BuktiHasilCatatan
npm test93/93 lulus11 file · 13,7 detik · Node 26.11.1
Alur kasir end-to-endLulusShift → tagihan → pesanan → tiket → bayar 44.000/50.000 → struk → tutup → shift (variance 0)
Template & jadwal shiftLulus08:00–16:00 WITA · jadwal 10 Nov · dibuat lewat UI
UAT perangkat / kamera / printerBelumTidak ada perangkat fisik pada audit ini
QRIS / offline POSTidak berlakuBelum diimplementasikan
IDModul / skenarioStatus
07 — Batas & lanjutan

Jangan janjikan lebih.

Paket ini tidak menyatakan aplikasi selesai atau siap produksi. Semua status mengacu pada versi, commit, dan environment yang diperiksa.

Belum diverifikasi

  • PWA di Android/iOS fisik
  • Kamera, GPS, dan izin perangkat
  • Printer dan cetak langsung
  • QRIS provider & settlement
  • POS tunai offline
  • Backup/restore drill

Tidak dilakukan

  • Deploy atau migrasi remote
  • Perubahan src/, dependency, config
  • Transaksi atau akun nyata
  • Penyalinan kredensial / .env
  • Perbaikan kode untuk F-01/02/09/10

Berikutnya

  • Perbaiki README & architecture/README
  • Beri banner status pada plan & backlog
  • Samakan perintah deploy
  • Perbarui panduan portal v0.7.4
  • Panduan Employee, Finance, Waiter, Kitchen/Bar, Developer, Guest
  • Dokumentasi teknis & UAT penuh
Dokumen sumber lengkap ada di docs/qa/ dan docs/user-guide/. Riwayat perubahan: docs/DOCUMENTATION-CHANGELOG.md. Semua gambar memakai data fiktif.