SIGAP v2.0.0

Catatan Rilis SIGAP v2.0.0 (Rilis Resmi)

Versi: 2.0.0
Kode Versi (Version Code): 1
Application ID: io.github.adlnfkhrzmn.sigapv2
Nama Tampilan: SIGAP v2
Tanggal Rilis: 22 Oktober 2026

---

1. Ikhtisar Rilis

SIGAP v2.0.0 merupakan pembaruan besar aplikasi Point of Sale (POS) offline-first untuk Android. Pembaruan ini membawa kapabilitas otomasi pembayaran QRIS melalui pemantauan notifikasi pembayaran transaksi pedagang (merchant payment notifications), sekaligus mempertahankan keandalan seluruh fitur kasir, inventaris, dan laporan keuangan dari versi sebelumnya.

---

2. Fitur Utama & Peningkatan

A. Otomasi Penyelesaian Pesanan QRIS (Universal Notification Detection)

• Deteksi Notifikasi Universal: Aplikasi mendeteksi dan mengurai notifikasi transaksi pembayaran secara otomatis melalui layanan listener notifikasi Android.
• Dukungan Penyedia Pembayaran: Teruji langsung pada perangkat fisik untuk Shopee Partner, GoPay Merchant, DANA Bisnis, dan ShopeePay. Notifikasi perbankan (seperti BCA) diverifikasi melalui unit test otomatis, sedangkan aplikasi merchant lain didukung melalui pengurai pola teks generik.
• Pencocokan Presisi & Cepat: Memvalidasi nominal Rupiah secara eksak dengan pesanan QRIS aktif pada jendela waktu 5 menit.
• Transaksi Atomik: Penyelesaian pesanan, pencatatan pembayaran, dan pengurangan stok produk diproses dalam satu transaksi database Room yang konsisten.
• Proteksi Duplikasi & Ambiguitas: Mencegah pemrosesan ganda untuk notifikasi yang sama serta menolak transaksi yang tidak valid atau ambigu.
• Otomasi Pembersihan Keranjang: Keranjang kasir dikosongkan secara otomatis segera setelah pesanan QRIS selesai, tanpa mengganggu keranjang transaksi baru yang sedang disusun kasir.

B. Perbaikan Default Identitas Usaha (Fresh Install Defaults)

• Instalasi Baru yang Bersih: Instalasi baru kini tidak lagi memuat data sampel "Kedai Kopi Laju" atau "Jl. Merdeka No. 45, Bandung".
• Nilai Default Kosong: Nama usaha, alamat toko, dan nomor kontak diinisialisasi sebagai string kosong, dengan placeholder informatif "Nama Usaha" pada layar pengaturan.
• Struk Transaksi Bersih: Pemformatan struk belanja, struk retur, dan laporan shift kasir beradaptasi secara elegan tanpa memunculkan label kosong atau data tiruan.
• Preservasi Data Pengguna: Preferensi dan profil usaha yang telah disimpan sebelumnya oleh pengguna lama tetap terlindungi dan tidak tereset.

C. Antarmuka Modern & Ramah Kasir

• Tampilan Responsif: Layout kasir beradaptasi secara dinamis untuk smartphone dan tablet (reflow 2 hingga 5 kolom).
• Palet Warna Nusantara Teal: Tampilan default mengusung tema terang (Light Mode) dengan aksen warna Nusantara Teal yang profesional dan kontras tinggi.
• Audio Kasir: Suara konfirmasi transaksi kasir yang responsif dengan kendali aktif/nonaktif di menu pengaturan.

D. Manajemen Kasir & Finansial Lengkap

• Shift Kasir & Laci Uang: Pencatatan modal awal, penerimaan kas, pengeluaran kas (cash drawer in/out), dan rekonsiliasi uang fisik.
• Metode Pembayaran Fleksibel: Tunai, QRIS otomatis/manual, dan Split Payment (Tunai + QRIS).
• Retur Barang & Pengembalian Dana: Pencatatan retur dengan status audit yang jelas (masuk stok kembali atau barang rusak/scrap).
• Laporan & Pembukuan: Laporan penjualan harian, rekap laba/rugi, dan pencatatan biaya operasional (expenses).
• Backup & Restore Crash-Safe: Pencadangan basis data lokal SQLite dengan mekanisme restore journal durabel untuk mencegah korupsi data.

E. Fitur Pelaporan Masalah (In-App Bug Reporting)

• Pelaporan Mandiri via Email: Formulir pelaporan masalah terintegrasi di menu Pengaturan > Tentang Aplikasi > Laporkan Bug.
• Pengiriman Transparan: Menggunakan Android Intent standar (ACTION_SENDTO dengan skema mailto:) ke adlanfakhruzzaman@gmail.com tanpa SDK pihak ketiga dan tanpa izin INTERNET tambahan.
• Perlindungan Privasi: Data keuangan, transaksi, basis data, dan isi notifikasi tidak pernah disertakan. Pengguna memiliki kendali penuh untuk meninjau dan mengirim laporan.
• Opsi Cadangan (Fallback): Menyediakan tombol salin teks ke clipboard dan pemilih aplikasi berbagi jika perangkat belum memiliki klien email default.

---

3. Kompatibilitas Sistem & Keamanan

• Minimum Android: Android 8.0 (API Level 26, Oreo)
• Target Android: Android 14 (API Level 34, Upside Down Cake)
• Arsitektur Perangkat: Mendukung arsitektur arm64-v8a, armeabi-v7a, x86, dan x86_64.
• Kebutuhan Izin Khusus: Izin Notification Listener diperlukan khusus untuk fitur deteksi pembayaran QRIS otomatis.
• Google Play Protect: Memuat panduan penanganan peringatan keamanan Play Protect untuk instalasi mandiri (sideload) sesuai dokumentasi pengembang resmi Google.

SIGAP POS v1.1.0

SIGAP POS v1.1.0

SIGAP v1.1.0 membawa peningkatan pada operasional kasir, pencatatan keuangan, pengelolaan retur, dan keamanan data transaksi.

Fitur Baru dan Peningkatan

• Manajemen Shift dan Kas: Pencatatan sesi kasir, pergerakan uang masuk dan keluar dari laci kas, serta rekonsiliasi saldo kas.
• Pembayaran: Mendukung pembayaran gabungan tunai dan QRIS serta alur pembayaran QRIS yang menunggu konfirmasi.
• Pembatalan dan Retur: Pembatalan transaksi, retur produk per item, pencatatan barang yang dikembalikan ke stok atau menjadi scrap, serta perhitungan refund proporsional berdasarkan harga efektif item.
• Pengeluaran dan Laba Rugi: Pencatatan biaya operasional dan laporan laba rugi dengan indikator estimasi apabila data HPP historis belum lengkap.
• Riwayat dan Laporan: Filter tanggal Hari Ini, Kemarin, 7 Hari Terakhir, dan Custom.
• Spreadsheet: Ekspor penjualan lebih lengkap, validasi relasional impor yang ketat, penolakan CSV ringkasan yang tidak memiliki rincian harga item, serta template impor produk dan lembar kerja stock opname.

Informasi Aplikasi

• Versi: 1.1.0
• Version Code: 2
• Minimum Android: 8.0 (API 26)
• Target SDK: 34
• Application ID: io.github.adlnfkhrzmn.sigap

Verifikasi Integritas APK

SHA-256:

1cd255abc749bd25a46610a9d12fcd954c9cf0fca62f98fd040741acb0267573

Pastikan checksum APK yang diunduh cocok dengan nilai tersebut sebelum memasang aplikasi.

Screenshot Aplikasi

Kasir	Produk
Riwayat Transaksi	Laporan Laba Rugi
Biaya Operasional	Pengaturan

SIGAP POS v1.0.0

Catatan Rilis SIGAP POS - Versi 1.0.0

Dokumen ini memuat catatan rilis resmi untuk peluncuran perdana aplikasi kasir SIGAP POS (point-of-sale) Android versi 1.0.0.

---

Ringkasan Rilis

• Versi Aplikasi: 1.0.0
• Kode Versi (Version Code): 1
• ID Paket (Application ID): io.github.adlnfkhrzmn.sigap
• Persyaratan Sistem: Minimum Android 8.0 (API level 26 / Oreo) atau versi yang lebih baru
• Target SDK: Android 14 (API level 34)
• Ukuran Berkas APK: 13.288.129 bytes (~13,29 MB)
• Nama Berkas Rilis: SIGAP.apk

---

Fitur Utama pada Versi 1.0.0

1. Kasir Cepat dan Manajemen Keranjang

• Pencarian Produk Instan: Memilih dan memasukkan produk ke keranjang kasir secara cepat dengan pencarian nama produk atau kode SKU secara real-time.
• Navigasi Kategori Dinamis: Mengelompokkan dan memfilter katalog produk di kasir menggunakan tombol chip kategori dengan pengguliran horizontal dan filter "Semua".
• Pengaturan Kuantitas dan Catatan: Menyesuaikan jumlah item pesanan dengan tombol kuantitas (+/-) serta menambahkan catatan pesanan khusus per item.
• Validasi Ketersediaan Stok: Membatasi penambahan jumlah belanja agar tidak melampaui sisa stok barang dan memberi penanda visual apabila stok habis.
• Suara Bip Kasir: Menghasilkan konfirmasi audio singkat setiap kali produk berhasil dimasukkan ke keranjang kasir (dapat diaktifkan atau dinonaktifkan melalui menu Pengaturan).

2. Diskon Per-Produk

• Dua Pilihan Jenis Diskon: Mendukung penerapan diskon persentase (0%–100%) maupun potongan nominal tetap Rupiah (Rp) pada setiap item belanja.
• Kalkulasi Transparan: Menghitung potongan harga per unit secara presisi dengan pembulatan standar, menampilkan harga asli tercoret, harga setelah diskon, dan total penghematan pada rincian transaksi.

3. Pemindai Barcode dan SKU Kamera

• Pemindaian On-Device: Mengintegrasikan kamera belakang perangkat untuk memindai barcode fisik produk secara langsung tanpa memerlukan koneksi internet.
• Pencocokan Katalog Lokal: Mencocokkan barcode hasil pemindaian langsung ke database produk di perangkat.
• Penanganan Barcode Baru: Jika barcode belum terdaftar di katalog toko, aplikasi menyediakan opsi untuk membuka formulir pendaftaran produk baru dengan kode barcode terisi otomatis tanpa melakukan penyimpanan otomatis sebelum pengguna mengonfirmasi seluruh data produk.
• Input Manual: Menyediakan opsi pengetikan nomor barcode secara manual apabila perangkat tidak memiliki kamera atau barcode fisik mengalami kerusakan.

4. Katalog Produk dan Pengelolaan Kategori

• Manajemen Katalog Lengkap: Menambah, memperbarui, dan menghapus data produk (nama, kategori, harga jual, harga modal opsional, stok awal, batas peringatan stok menipis, nomor SKU/barcode, dan ikon atau foto produk).
• Pengelolaan Kategori: Menambah kategori baru, mengubah nama kategori, serta menghapus kategori dengan opsi memindahkan produk-produk terkait ke kategori lain secara aman.
• Indikator Stok: Penanda visual informatif untuk stok barang yang menipis dan stok habis.

5. Pembayaran Tunai dan QRIS Dinamis Lokal

• Pembayaran Tunai: Menghitung total belanja, nominal pembayaran, dan uang kembalian secara otomatis, dilengkapi tombol cepat pecahan uang pas dan pecahan nominal Rupiah umum.
• QRIS Dinamis Lokal: Menghasilkan kode QR dinamis berisi nominal belanja sesuai isi keranjang yang dibuat secara lokal di perangkat dari gambar QRIS statis merchant yang diimpor dari galeri.
• Penguncian Pesanan (Pending QRIS): Mengunci pesanan aktif selama kasir menunggu pelanggan menyelesaikan pembayaran agar stok produk tidak digunakan ganda pada pesanan lain.

6. Riwayat Transaksi dan Struk Penjualan

• Penyaringan Riwayat Transaksi: Menyaring daftar riwayat transaksi berdasarkan periode waktu: Hari Ini, Kemarin, 7 Hari Terakhir, atau rentang tanggal khusus (Custom) melalui dialog kalender.
• Rincian Transaksi Lengkap: Menampilkan informasi nota, waktu transaksi, kasir, rincian produk, potongan diskon, subtotal, total akhir, nominal bayar, dan uang kembalian.
• Pencetakan dan Pembagian Struk: Mencetak nota melalui sistem cetak Android (Android Print Spooler ke printer terhubung atau simpan sebagai dokumen PDF) serta membagikan ringkasan nota dalam format teks ke WhatsApp atau aplikasi lain.

7. Laporan Penjualan Harian

• Ringkasan Indikator Usaha: Menampilkan total omset penjualan kotor, estimasi laba kotor (berdasarkan selisih harga jual dan harga modal yang diisi), jumlah transaksi berhasil, dan total produk terjual.
• Komparasi Metode Bayar: Rekapitulasi perbandingan transaksi Tunai dibandingkan transaksi QRIS serta daftar produk terlaris.

8. Impor, Ekspor, dan Pencadangan Data

• Ekspor dan Impor Katalog Produk: Mendukung ekspor dan impor katalog produk beserta kategorinya menggunakan format berkas Excel (.xlsx) dan CSV (.csv).
• Ekspor Riwayat Penjualan: Mengekspor riwayat transaksi penjualan ke dalam format berkas Excel (.xlsx) atau arsip ZIP berisi berkas CSV.
• Pencadangan dan Pemulihan Mandiri: Menyediakan fitur cadangan (backup) dan pemulihan (restore) database SQLite lokal ke penyimpanan perangkat menggunakan Android Storage Access Framework (SAF).

9. Pengaturan Usaha dan Tampilan

• Identitas Usaha: Pengaturan nama toko, alamat gerai, nomor telepon/WhatsApp, dan catatan penutup nota belanja.
• Personalisasi Tampilan: Dukungan tema Terang (Light), Gelap (Dark), atau Mengikuti Sistem perangkat, serta pilihan palet warna aksen kasir (Teal, Navy, Olive, Slate).

---

Batasan Operasional dan Arsitektur Data

1. Penyimpanan Lokal dan Operasional Offline:
   Catatan transaksi dan katalog produk disimpan secara lokal di perangkat Android. Alur kasir inti beroperasi secara offline-first. Aplikasi tidak meminta izin jaringan android.permission.INTERNET pada manifest aplikasi.
2. Perangkat Kasir Mandiri (Single-Store):
   Dirancang untuk satu toko fisik dengan satu perangkat kasir mandiri. Sinkronisasi multi-cabang berbasis cloud belum tersedia pada rilis ini.
3. Verifikasi Pembayaran QRIS Bersifat Manual:
   SIGAP menghasilkan visual kode QR dinamis secara mandiri di perangkat tanpa integrasi payment gateway perbankan pihak ketiga. SIGAP tidak memotong saldo secara otomatis dan tidak menerima webhook perbankan. Kasir wajib memverifikasi penerimaan dana secara manual melalui aplikasi merchant (seperti GoPay Merchant, Shopee Partner, atau mutasi bank) sebelum menyelesaikan transaksi.
4. Pencetakan Struk Thermal:
   Pencetakan nota saat ini mengandalkan sistem Android Print Spooler atau pembagian teks struk. Integrasi langsung melalui driver Bluetooth printer POS ESC/POS belum tersedia.
5. Perlindungan Data Lokal:
   Pencopotan (uninstall) aplikasi dari perangkat dapat menghapus database lokal transaksi. Pengguna dianjurkan mencadangkan data berkala via menu Pengaturan sebelum melakukan tindakan pemeliharaan perangkat.

---

Integritas Berkas dan Verifikasi Keamanan

Sebelum memasang berkas instalasi pada perangkat Android, pastikan integritas berkas telah diverifikasi:

Parameter	Nilai Resmi
Nama Berkas Rilis	SIGAP.apk
SHA-256 Berkas APK	fa4bba7ac8b7ca0712641e267dfaf2a10294a61c29d72f37c6ca5b7209868ce6
SHA-256 Sertifikat Penandatangan	fd7f2e9f46f9f6422df79e8189d5c35b8d2706ddf306e42f3af780f4fc588673
Algoritma Kunci Sertifikat	RSA 2048-bit
Skema Tanda Tangan APK	APK Signature Scheme v2