Knowledge Base MarchCell POS Troubleshooting

Troubleshooting & Maintenance

K
Knowledge Base
17 Januari 2026
2 views
Troubleshooting
Artikel untuk: MarchCell POS
aplikasi kasir berbasis web yang dirancang untuk membantu operasional toko Anda. Aplikasi ini mencakup fitur penjualan produk (fisik), pencatatan layanan jasa (Transfer & STNK), manajemen stok, serta pelaporan keuangan otomatis.

Artikel ini berisi solusi masalah umum dan perawatan data.

# Masalah Umum dan Pemeliharaan Data

Halaman ini berisi solusi untuk kendala teknis yang sering ditemui serta panduan backup data.

## 1. Backup Database
Aplikasi ini menggunakan database **SQLite** yang tersimpan dalam satu file fisik.
* **Lokasi File:** Di dalam folder aplikasi utama.
* **Nama File:** `database.sqlite`

**Cara Backup:**
Cukup **Copy & Paste** file `database.sqlite` tersebut ke tempat aman (Google Drive / Flashdisk) secara berkala.
> **Peringatan:** Saat melakukan update aplikasi (menimpa file coding), JANGAN menimpa file `database.sqlite` ini agar data transaksi tidak hilang.

## 2. Error: "Module Not Found"
Jika saat dijalankan muncul pesan error merah bertuliskan `Cannot find module...`, itu berarti instalasi pustaka belum sempurna.

**Solusi:**
1.  Hapus folder bernama `node_modules`.
2.  Buka CMD/Terminal di folder aplikasi.
3.  Ketik ulang: `npm install`.

## 3. Reset Password Administrator
Jika Anda lupa password admin dan tidak bisa login:
1.  Buka database menggunakan aplikasi **DB Browser for SQLite** (Gratis).
2.  Buka tabel `users`.
3.  Anda bisa melihat data user di sana. Karena password dienkripsi, solusi tercepat adalah meminta *Developer* meresetnya melalui database seed, atau mengganti hash password dengan hash standar baru.

## 4. Aplikasi Tidak Bisa Dibuka (Windows)
Jika `http://localhost:3000` tidak bisa diakses:
* Pastikan jendela hitam (CMD) **tidak ditutup**. Jendela itu harus tetap terbuka agar server berjalan.
* Cek apakah ada aplikasi lain yang menggunakan port 3000.
Terakhir diupdate: 17 Januari 2026