Sinkronasi Data

KeikoPOS adalah aplikasi offline-first — semua fitur tetap jalan tanpa internet. Data disimpan lokal di SQLite, lalu disinkronkan ke server saat online.

Mode Operasi

Stand Alone (Offline)

• Data disimpan di database lokal per device
• Semua fitur jalan normal tanpa internet
• Cocok untuk 1 toko, 1 device

Cloud VPS (Online)

• Data disinkronkan ke server Ktor (multi-tenant)
• Banyak device bisa pakai data yang sama
• Tiap tenant (perusahaan) punya database terpisah di server

Cara Kerja Sinkronasi

1. Device menyimpan semua perubahan lokal dulu (cepat, tidak nunggu internet)
2. Saat online, sistem kirim perubahan ke server secara bertahap
3. Server terima → data dari device lain ikut ter-update
4. Perubahan dicatat dengan rowVersion — cuma data yang berubah yang dikirim (delta sync), hemat kuota

Setting Server

1. Buka Tools → Setting
2. Isi URL Server (contoh: https://keikopos.snr.my.id)
3. Login dengan akun yang terdaftar di server
4. Sinkronasi berjalan otomatis di latar belakang

Tips

• Pastikan device tetap login ke server yang sama — jangan ganti-ganti
• Kalau koneksi lambat, delta sync tetap ringan karena cuma kirim perubahan
• Cek status sinkronasi di Dashboard — kalau ada data pending, pastikan online
• Backup tetap disarankan walau pakai server (cadangan lokal)

Troubleshooting

Masalah	Solusi
Data tidak sinkron	Cek koneksi internet & URL server
Device A tidak lihat data device B	Pastikan keduanya login di server yang sama
Sinkronasi lambat	Cek kualitas koneksi — delta sync akan lanjut otomatis