Artea POS adalah sistem Point of Sale (POS) modern, bebas, dan open-source yang dirancang khusus untuk UMKM (F&B, Retail, Jasa). Aplikasi ini dirancang agar tetap bisa dipakai untuk operasional inti walau internet sedang tidak tersedia, dan tetap mendukung sinkronisasi antar cabang saat online.
"Dari UMKM, Untuk UMKM"
Aplikasi ini pada awalnya dibuat dan dikembangkan secara spesifik untuk memenuhi kebutuhan operasional di lini usaha kami sendiri yang bernama Artea.
Kami memutuskan untuk membagikan kode sumbernya (Open Source) dengan harapan aplikasi ini dapat bermanfaat bagi rekan-rekan UMKM lain yang membutuhkan sistem kasir handal tanpa biaya langganan.
Namun, demi kenyamanan bersama dan manajemen ekspektasi, mohon dipahami bahwa:
- Fitur-fitur di dalamnya dibangun berdasarkan alur kerja (workflow) dan kebutuhan spesifik usaha kami.
- Aplikasi ini mungkin tidak memiliki fitur selengkap aplikasi kasir komersial/berbayar buatan perusahaan besar.
- Pengembangan dan perbaikan bug dilakukan berdasarkan ketersediaan waktu kami.
Kami sangat menghargai jika Anda ingin menggunakannya, dan lebih senang lagi jika Anda mau berkontribusi (Pull Request) untuk membuatnya lebih baik!
- Siap Dipakai Tanpa Internet: Data utama disimpan langsung di perangkat, jadi kasir tetap lancar dipakai untuk operasional inti meski koneksi sedang tidak tersedia.
- Lazy Loading Reports: Mampu menangani ribuan transaksi tanpa lag. Laporan hanya memuat data yang diperlukan.
- Data Archiving: Fitur manajemen memori untuk mengarsipkan data lama ke Excel/PDF dan membersihkan database agar aplikasi tetap ringan selamanya.
- Smart Cart: Dukungan varian produk, modifier (topping/level gula), dan diskon per item.
- Split Bill: Fitur pisah bayar dalam satu meja/pesanan.
- Hold Order (Open Bill): Simpan pesanan sementara (cocok untuk restoran/kafe).
- Shift Management: Kontrol modal awal, kas masuk/keluar (petty cash), dan laporan tutup buku (z-report).
- Sync Otomatis: Data transaksi terkirim otomatis ke Dropbox Admin saat kasir online.
- Manajemen Pusat: Admin dapat memantau omzet semua cabang dari satu dashboard.
- Push Master Data: Ubah harga/produk di Pusat, dan kirim update ke semua cabang dengan satu klik.
- Secure Pairing: Hubungkan perangkat staf ke Cloud tanpa perlu memberikan email/password Dropbox (menggunakan Scan QR/Kode Enkripsi).
- Bluetooth Printer: Cetak struk langsung dari HP Android/Laptop ke printer thermal bluetooth (58mm/80mm).
- Barcode Scanner: Mendukung scanner USB fisik atau menggunakan kamera HP sebagai scanner.
- Responsive UI: Tampilan optimal di HP, Tablet, maupun Laptop/PC.
- Role Management: Akses berbeda untuk Admin, Manager, dan Staf.
- Audit Log: Merekam setiap aktivitas sensitif (Hapus produk, Refund, Edit Stok, Login) untuk mencegah kecurangan.
- Anti-Fraud Input: Validasi ketat untuk mencegah input minus atau manipulasi data.
Artea POS bisa dipasang ke layar utama HP atau desktop agar lebih mudah dibuka seperti aplikasi biasa.
- Buka aplikasi di browser (Chrome/Edge disarankan).
- Biarkan aplikasi selesai dimuat sekali saat online sampai mode offline aktif.
- Klik ikon "Install" di bar alamat browser (biasanya ikon monitor+panah).
- Aplikasi akan terpasang di layar utama HP/Desktop dan dapat dibuka kembali secara offline untuk operasional inti.
# 1. Clone repositori
git clone https://github.com/aiprojek/arteapos.git
# 2. Masuk ke direktori
cd arteapos
# 3. Salin konfigurasi environment
cp .env.example .env
# 4. Instal dependensi
npm install
# 5. Jalankan mode pengembangan
npm run dev
# 6. Build untuk produksi
npm run buildJika Anda mendapatkan error "Plugin Bluetooth belum terinstall" saat menjalankan APK, itu karena folder android tidak terbawa ke GitHub.
SOLUSI:
- Buka file
.gitignoredi root project. - Cari baris
/androidatauandroid/dan hapus baris tersebut. - Lakukan commit dan push folder
androidke GitHub.git add android/ git commit -m "Add android folder for custom native plugins" git push - Jalankan ulang Workflow GitHub Actions.
Hal ini diperlukan karena aplikasi ini menggunakan Custom Native Code (BluetoothPrinterPlugin.java) yang terletak di dalam folder android/app/src/main/java.
Cocok untuk warung, kedai kopi kecil, atau toko kelontong.
- Gunakan mode Lokal.
- Backup data secara rutin (mingguan) ke file JSON melalui menu Pengaturan > Data.
Cocok jika pemilik tidak selalu di toko.
- Pemilik (Admin): Buka aplikasi, masuk ke Pengaturan > Data, hubungkan akun Dropbox.
- Pemilik: Klik "Bagikan Akses (Pairing)" untuk mendapatkan Kode Akses.
- Karyawan (Toko): Buka aplikasi, masuk ke Pengaturan > Data, pilih "Input Kode" dan masukkan kode dari Pemilik.
- Hasil: Setiap transaksi di toko akan otomatis terupload ke Dropbox Pemilik. Pemilik cukup klik tombol "Refresh" di Dashboardnya untuk melihat omzet real-time (tunda beberapa detik).
Dibuat dengan ❤️ menggunakan teknologi web modern yang cepat dan efisien:
- React 18 (UI Library)
- Vite (Build Tool super cepat)
- TypeScript (Keamanan kode)
- Dexie.js (IndexedDB wrapper untuk database offline)
- Dropbox SDK (Penyimpanan Cloud gratis & stabil)
- Tailwind CSS (Styling)
Proyek ini terbuka untuk umum (Open Source). Kami sangat menghargai kontribusi Anda!
- Fork repositori ini.
- Buat branch fitur baru (
git checkout -b fitur-keren). - Commit perubahan Anda.
- Push ke branch tersebut.
- Buat Pull Request.
Didistribusikan di bawah Lisensi GNU General Public License v3.0. Anda bebas menggunakan, memodifikasi, dan mendistribusikan aplikasi ini, bahkan untuk tujuan komersial, selama menyertakan kode sumber asli dan lisensi yang sama.
Dikembangkan oleh AI Projek
Kolaborasi Manusia & Kecerdasan Buatan