Katsira POS — Retail Management Platform

Platform kasir modern untuk UMKM & retail: dashboard web + aplikasi mobile offline-first, mencakup POS engine, inventory, CRM/loyalty, hingga multi-outlet reporting. Dibangun solo dari nol dengan arsitektur dual-app dan sinkronisasi offline-online.

Ringkasan Proyek

• Kategori: Personal Project
• Peran: Full-Stack Engineer (solo)
• Tech Stack: Next.js 16, React 19, TypeScript, Tailwind CSS, Expo React Native, Zustand, NativeWind, Expo SQLite, PostgreSQL, Drizzle ORM, better-auth, Midtrans, Cloudflare R2

---

Latar Belakang / Ide Awal

Sedia POS lahir dari pengamatan sederhana: banyak UMKM dan toko retail kecil masih mencatat transaksi dan stok secara manual. Sistem kasir yang ada di pasaran seringkali terlalu mahal atau terlalu bergantung pada koneksi internet yang stabil — padahal di lapangan, koneksi yang tidak stabil adalah kendala harian.

Pengembangan proyek ini didorong oleh dua hal:

1. Dorongan Bisnis: Membangun sistem POS yang andal di kondisi lapangan nyata — tetap dapat mencatat transaksi saat offline, lalu sinkron secara otomatis saat koneksi kembali terhubung.
2. Dorongan Teknis: Merancang dan membangun sistem full-stack berskala besar secara mandiri, mencakup skema database domain retail yang kompleks, arsitektur dual-app (web dan mobile), hingga strategi offline-sync end-to-end.

Sedia POS (Katsira) dirancang bukan sekadar sebagai proyek latihan, melainkan sebagai sistem siap pakai untuk operasional toko ritel sungguhan.

---

Masalah yang Ingin Diselesaikan

• Pencatatan transaksi dan stok masih manual sehingga rawan selisih.
• Sulit memantau performa penjualan lintas outlet secara real-time.
• Manajemen pelanggan, loyalty, dan karyawan belum terintegrasi dalam satu sistem.
• Operasional kasir terganggu saat koneksi internet tidak stabil.
• Katalog produk online belum terhubung rapi dengan sistem POS internal.

---

Keputusan & Trade-off Arsitektur

1. Dual-App Terpisah (Next.js untuk web, Expo React Native untuk mobile):
   Kasir di lapangan membutuhkan performa native dan akses penuh ke penyimpanan lokal untuk mode offline, sedangkan dashboard web berfokus pada fleksibilitas reporting dan manajemen multi-outlet.
2. SQLite Lokal pada Mobile:
   Menjamin operasional kasir tidak terhenti saat koneksi putus. Penanganan kendala dilakukan dengan membangun mekanisme queue, status sinkronisasi (pending/synced/error), dan retry otomatis.
3. Pembatasan Scope Awal:
   Fitur integrasi akuntansi eksternal dan multi-currency sengaja ditunda untuk memprioritaskan keandalan modul inti (transaksi, inventori, dan offline-sync).
4. Abstraction Layer untuk Payment Gateway:
   Metode pembayaran dirancang menggunakan lapisan abstraksi sejak awal untuk mempermudah penambahan channel pembayaran (Cash, QRIS, Transfer, Virtual Account) tanpa mengubah alur checkout utama.

---

Fitur Utama

1. POS Engine
   Alur transaksi kasir yang cepat dan fleksible: cart, checkout, split payment, hold order, hingga cetak/share receipt.

2. Payment
   Mendukung pembayaran cash, QRIS, transfer, dan virtual account melalui integrasi Midtrans.

3. Inventory
   Manajemen produk, kategori, varian, stock tracking, inventory log, hingga stock opname untuk meminimalkan selisih stok.

4. CRM & Loyalty
   Manajemen data pelanggan, member tier, dan pencatatan poin transaksi untuk meningkatkan retention rate.

5. HR & Access Control
   Role/permission dinamis, PIN kasir, dan alur otorisasi manager untuk tindakan sensitif.

6. Multi-Outlet
   Pengelolaan banyak cabang dan pemfilteran laporan per outlet dalam satu sistem pusat.

7. Supplier & Purchasing
   Manajemen supplier dan siklus purchase order yang terstruktur.

8. Digital Catalog
   Katalog produk publik per outlet yang terhubung langsung dengan sistem POS internal tanpa input ganda.

9. Reporting
   Dashboard KPI, laporan penjualan, top product, profit/loss, dan opsi ekspor data.

10. Backup & Restore
    Ekspor data operasional ke cloud storage secara teratur untuk keamanan data bisnis.

---

Tantangan Teknis & Solusi

• Reliabilitas transaksi saat offline:
  Diimplementasikan menggunakan local queue berbasis SQLite dengan tracking status sinkronisasi (pending, synced, error) serta alur retry otomatis.
• Konsistensi role & permission lintas platform:
  Menggunakan session enrichment pada auth callback untuk menyatukan system role dan employee permissions.
• Integrasi pembayaran campuran (manual & gateway):
  Menerapkan abstraction layer pada modul pembayaran beserta sistem polling status khusus untuk transaksi terintegrasi Midtrans.
• Manajemen aset dan URL file di cloud:
  Menggunakan utilitas resolver key/URL, signed URL fallback, dan proxy endpoint untuk menjaga konsistensi pada frontend.

---

Pembelajaran & Pencapaian

• Merancang skema database domain retail yang kompleks (transaksi, inventori, loyalty, SDM, purchasing).
• Menerapkan arsitektur offline-first pada aplikasi mobile dengan strategi queue dan retry mechanism.
• Mengelola arsitektur dual-app (web Next.js + mobile Expo) yang terhubung ke satu centralized database.
• Mengintegrasikan payment gateway (Midtrans) dan cloud storage (Cloudflare R2) secara end-to-end.