wiki/nutapos-architecture.md
Nutapos Architecture
Summary: Catatan arsitektur tingkat tinggi yang disimpulkan dari dokumen desain, termasuk pemisahan layanan, sinkronisasi Android ke cloud, dan perilaku multi-device.
Sources:
Last updated: 2026-04-17
---
Source menggambarkan Nutapos sebagai aplikasi kasir Android yang terintegrasi dengan Nutacloud untuk pelaporan online dan manajemen backoffice (source: data-source.md).
Komponen arsitektur utama
Bagian server setup menunjukkan tiga surface layanan utama dalam konfigurasi environment historis:
- layanan API untuk pendaftaran dan login Cloud User dari perangkat Android (source: data-source.md)
- lapisan WebService untuk sinkronisasi dari app ke cloud dan untuk alur request atau download data kembali ke app (source: data-source.md)
- aplikasi web BackOffice untuk Cloud User dalam mengelola data bisnis dan laporan (source: data-source.md)
Bagian production juga menyebut aplikasi Customer Service untuk operasi internal (source: data-source.md).
Model sinkronisasi
Flow sinkronisasi Android ke cloud dijelaskan cukup eksplisit:
- setelah pendaftaran atau login Cloud User, sinkronisasi berjalan otomatis di background (source: data-source.md)
- perubahan data di device otomatis dibaca dan dikirim ke web service Nutacloud (source: data-source.md)
- ketika satu outlet memiliki lebih dari satu device, data dapat diforward melalui Firebase agar device lain menerima update (source: data-source.md)
- device juga mengecek apakah ada data yang perlu di-pull dari server (source: data-source.md)
Ini mengindikasikan model sinkronisasi hybrid push-pull antara device Android dan layanan cloud.
Lokalitas data
Source secara eksplisit menyebut proses download data dari cloud MySQL ke Android SQLite pada flow login. Ini mengindikasikan adanya penyimpanan data lokal di device untuk menjaga kelancaran operasional, sambil tetap melakukan sinkronisasi ke cloud untuk pelaporan dan koordinasi terpusat (source: data-source.md).
Catatan environment
Source memuat bagian development, staging, dan production. Bagian ini berguna sebagai bukti bahwa sistem memiliki pemisahan environment, tetapi wiki ini tidak menyalin kredensial sensitif atau detail akses langsung dari dokumen mentah (source: data-source.md).
Implikasi arsitektur
Secara keseluruhan, produk ini tampak diorganisasi berdasarkan prinsip berikut:
- operasi lokal di device untuk kecepatan dan usability outlet
- pelaporan berbasis cloud dan pengelolaan data master terpusat
- koordinasi multi-device opsional di dalam outlet yang sama
- tooling internal terpisah untuk workflow customer service