# PANDUAN PENGGUNA & BUKU PETUNJUK RESMI SHRIMLEDGER
**Aplikasi Pencatatan Cepat & Cetak Nota Pengepul Udang**  
**UD SUTARDJO — Pesisir Camplong, Sampang, Madura**  
*Versi Panduan: v2.0 (Offline-First Edition)*

---

## DAFTAR ISI
1. [Alur Operasional Standar Pengepul Udang](#1-alur-operasional-standar-pengepul-udang)
2. [Modul 1: Timbangan Bibir Tambak & Multi-Lot](#modul-1-timbangan-bibir-tambak--multi-lot)
3. [Modul 2: Riwayat Transaksi & Arsip Nota](#modul-2-riwayat-transaksi--arsip-nota)
4. [Modul 3: Mitra (Master Kontak Petambak, Nelayan & Buyer)](#modul-3-mitra-master-kontak-petambak-nelayan--buyer)
5. [Modul 4: Cetak Struk POS Thermal & Kwitansi Kertas A4](#modul-4-cetak-struk-pos-thermal--kwitansi-kertas-a4)
6. [Modul 5: Buku Kas Operasional Panen (Petty Cash Lapangan)](#modul-5-buku-kas-operasional-panen-petty-cash-lapangan)
7. [Modul 6: Surat Jalan & Manifest Muatan Truk Pabrik](#modul-6-surat-jalan--manifest-muatan-truk-pabrik)
8. [Modul 7: Acuan Harga Patokan Hari Ini (Price Matrix)](#modul-7-acuan-harga-patokan-hari-ini-price-matrix)
9. [Modul 8: Sinkronisasi Cloud Google Sheets & Mode Offline](#modul-8-sinkronisasi-cloud-google-sheets--mode-offline)
10. [Tanya Jawab & Pemecahan Masalah (FAQ)](#tanya-jawab--pemecahan-masalah-faq)

---

## 1. ALUR OPERASIONAL STANDAR PENGEPUL UDANG

Dalam rantai perdagangan udang vaname dan windu, UD SUTARDJO menghubungkan petambak lokal dengan pabrik pengolahan (*cold storage/eksportir*). Alur standar terbagi menjadi 3 fase:

```
[FASE 1: TAMBAK]       ➔    [FASE 2: KASIR & GUDANG]    ➔    [FASE 3: DISTRIBUSI PABRIK]
- Juru Timbang input keranjang  - Kasir verifikasi nota          - Kru muat box fiber ke armada
- Sampling Size / ABW           - Pembayaran (Lunas/Tempo)       - Sopir bawa Surat Jalan resmi
- Cetak struk thermal di lokasi - Catat kas masuk/operasional    - Timbang ulang di cold storage
```

---

## MODUL 1: TIMBANGAN BIBIR TAMBAK & MULTI-LOT

### 1.1. Konsep Perhitungan Berat (Bruto, Tara, Netto)
* **Bruto**: Berat kotor keseluruhan (Udang + Keranjang plastik/krat).
* **Tara**: Berat wadah kosong. Di UD Sutardjo, tara standar keranjang plastik adalah **2.50 kg**.
* **Netto**: Berat bersih udang murni yang dibayar kepada petambak.
  $$\text{Netto} = \text{Bruto} - \text{Tara}$$
  *Contoh*: Bruto 42.50 kg - Tara 2.50 kg = **Netto 40.00 kg**.

### 1.2. Kategori Komoditas
* **TAMBAK**: Udang hasil budidaya tambak (Vannamei, Windu). Dihitung berdasarkan **Size** (jumlah ekor per 1 kg). Makin kecil angka size, makin besar ukuran udangnya.
* **LAUT**: Udang tangkapan nelayan pesisir. Dihitung berdasarkan **Grade Mutu** (Super, Grade A, Grade B, BS).

### 1.3. Alat Bantu Bibir Tambak
* **Kalkulator Sampling Size**: Timbang sampel udang (misal 1000 gram / 1 kg), hitung jumlah ekornya (misal 53 ekor). Sistem otomatis menentukan klasifikasi terdekat: *Size 50* dan *ABW (Average Body Weight) 18.87 gram/ekor*.
* **Numpad Cepat (Outdoor)**: Keypad angka layar sentuh berukuran ekstra besar (56px) untuk kemudahan input jari yang basah di tambak tanpa keyboard HP.

---

## MODUL 2: RIWAYAT TRANSAKSI & ARSIP NOTA

* **Nota Aktif**: Transaksi panen terbaru yang sedang berjalan hari ini.
* **Diarsipkan**: Nota panen hari-hari sebelumnya yang dipindahkan ke arsip agar daftar kerja tetap bersih, tanpa menghapus riwayat data.
* **Status Pembayaran**:
  - `LUNAS`: Pembayaran tunai/transfer langsung diselesaikan di tambak.
  - `TEMPO`: Pembayaran ditunda menunggu uang cair dari setoran pabrik.
  - `DP`: Pembayaran baru diberikan sebagian sebagai uang muka.
* **Hapus Nota**: Hanya berwenang dilakukan oleh 👑 **Juragan / Owner**.

---

## MODUL 3: MITRA (MASTER KONTAK PETAMBAK, NELAYAN & BUYER)

### 3.1. Fungsi Modul Mitra
Menyimpan database petambak langganan agar saat timbangan dimulai, pengguna tidak perlu mengetik ulang nama, lokasi, dan nomor WhatsApp.

### 3.2. Fitur Utama
1. **Pencarian Cepat**: Ketik beberapa huruf nama atau nomor HP petambak untuk memfilter daftar seketika.
2. **Filter Kategori**:
   - `🦐 PETAMBAK`: Pemilik kolam tambak intensif/tradisional.
   - `🌊 NELAYAN`: Nelayan jaring/perahu pesisir.
   - `🏢 BUYER`: Pabrik pengolahan udang / eksportir (PT Sekar Laut, BMI, dll.).
3. **Rekapitulasi Portofolio Petambak**: Setiap kartu mitra menampilkan frekuensi transaksi panen dan total tonase (kg) yang pernah disetor ke UD Sutardjo.
4. **Edit & Hapus Kontak**: Memperbarui nomor telepon atau menghapus kontak yang sudah tidak aktif dengan sinkronisasi langsung ke Google Sheets `Master_Kontak`.

---

## MODUL 4: CETAK STRUK POS THERMAL & KWITANSI KERTAS A4

### 4.1. Model 1: Struk Modern (POS Thermal Bluetooth)
* Menggunakan printer thermal portabel Bluetooth ukuran kertas **58mm** atau **80mm**.
* Praktis dibawa ke tambak dengan baterai nirkabel.
* Menampilkan rincian keranjang, total netto, harga/kg, subtotal, dan status bayar.

### 4.2. Model 2: Kwitansi Manual (Format Hemat Kertas A4 50:50)
* Format cetak kertas printer kantor (Folio / F4 / A4) bergaris kisi tradisional khas nota manual.
* **Fitur Hemat 50:50 (Landscape Dual)**: Mencetak 2 lembar berdampingan dalam 1 lembar kertas A4 (Lembar 1 untuk Petambak, Lembar 2 untuk Arsip Kantor), sehingga menghemat 50% biaya kertas.

---

## MODUL 5: BUKU KAS OPERASIONAL PANEN (PETTY CASH LAPANGAN)

### 5.1. Tujuan
Mencatat seluruh arus uang fisik yang dibawa tim ke lapangan agar saldo kas di tangan tidak selisih saat serah terima ke Juragan setelah panen selesai.

### 5.2. Pos Pengeluaran (Kas Keluar)
* `❄️ Es Balok`: Pembelian es batu balok/curah untuk pendingin udang di bak pickup.
* `👥 Upah Kuli`: Ongkos tenaga angkut, juru timbang tambak, dan juru sortir.
* `⛽ BBM / Solar`: Bahan bakar truk armada, mobil pickup, atau solar genset tambak.
* `☕ Konsumsi`: Makanan, kopi, dan rokok kru lapangan selama panen.
* `📦 Lainnya`: Biaya darurat lapangan lainnya.

### 5.3. Kas Masuk (Modal Panen & Kas Jalan)
Catat modal tunai yang diberikan Juragan pada awal shift (jam 2 pagi). Sistem otomatis menghitung:
$$\text{Sisa Kas Fisik di Tangan} = \text{Total Modal Masuk} - \text{Total Pengeluaran}$$
* Jika surplus: Status hijau `✓ Kas Fisik Aman (Surplus)`.
* Jika minus: Status merah `⚠️ Kas Minus (Kurang Modal)`.

### 5.4. Ekspor Laporan Microsoft Excel (.xlsx) & Kirim WhatsApp
* **Tombol "Unduh Excel"**: Mengunduh buku kas ke file **`.xlsx` (Microsoft Excel)** asli dengan penataan kolom profesional, angka numerik siap rumus (`=SUM`), dan baris ringkasan saldo fisik di bagian bawah. Bekerja secara *offline* langsung di HP/laptop tanpa perlu internet!
* **Tombol "Kirim WA"**: Mengirim ringkasan mutasi kas dan sisa uang fisik langsung ke chat WhatsApp Juragan dalam 1 kali klik.

### 5.5. Panduan Edukatif (?) Coach Mark
Tekan tombol lingkaran **`(?)`** di pojok kanan atas modal Buku Kas untuk membuka panduan interaktif langsung di layar HP Anda kapan saja saat bertugas di bibir tambak.

---

## MODUL 6: SURAT JALAN & MANIFEST MUATAN TRUK PABRIK

### 6.1. Kegunaan & Dasar Legalitas
Dokumen resmi pengantar muatan hasil panen udang yang dibawa oleh sopir armada ekspedisi/pickup menuju pabrik atau *cold storage* pengolah udang ekspor. Dokumen ini membuktikan legalitas kepemilikan komoditas saat pemeriksaan karantina ikan atau petugas lalu lintas di jalan raya (Suramadu / Pantura).

### 6.2. Parameter Muatan Armada
* **Pabrik / Tujuan Buyer (Fleksibel & Anti-Stuck)**:
  - **Preset Cepat 1-Ketukan**: Pilihan instan pabrik langganan (*Sekar Laut*, *BMI Surabaya*, *Mega Marine*, *CP Prima*, *CS Pabean*, *CS Banyuwangi*). Pengguna bebas beralih pilihan kapan saja tanpa terkunci.
  - **Tombol Hapus / Reset [✕]**: Mengosongkan isian dalam 1 klik jika ingin membatalkan pilihan.
  - **Ketik Manual Bebas**: Memungkinkan pengetikan nama pabrik, eksportir, atau gudang cold storage baru secara leluasa.
* **Nomor Polisi Armada**: No. Polisi truk atau pickup (cth: `M 8123 NA`).
* **Nama Sopir / Pengemudi**: Nama pengemudi yang bertanggung jawab atas muatan.
* **Jumlah Wadah / Box Fiber**: Jumlah boks insulasi es yang dimuat ke bak armada.
* **Pilihan Nota Timbangan**: Memilih nota timbangan panen hari ini untuk digabungkan menjadi total tonase muatan.
* **Tombol Manifest Baru**: Mereset seluruh formulir surat jalan untuk memulai pencatatan muatan baru.

### 6.3. Tanda Tangan Jari Digital (Canvas Touchscreen)
* Tersedia 2 kotak tanda tangan digital: **Pengirim (Checker/Juragan)** dan **Sopir/Pengemudi**.
* Ditandatangani langsung menggunakan sentuhan ujung jari di atas layar HP/tablet.
* Dilengkapi tombol **"Bersihkan"** untuk mengulang tanda tangan jika goresan kurang rapi.
* Gambar tanda tangan otomatis tertanam ke dalam lembar cetak A4 dan format digital.

### 6.4. 4 Tahap Siklus Pengiriman (Delivery Lifecycle)
1. **1. Muat Tambak (Kuning)**: Udang sedang ditimbang dan dimasukkan ke box fiber berinsulasi es di lokasi kolam tambak.
2. **2. Di Perjalanan (Biru)**: Armada telah berangkat melintasi jalur darat menuju cold storage.
3. **3. Tiba Pabrik (Ungu)**: Truk telah sampai di pelataran pabrik dan mengantre timbangan.
4. **4. Selesai Bongkar (Hijau)**: Seluruh udang telah dibongkar, diperiksa QC pabrik, dan nota timbangan pabrik resmi telah keluar.

### 6.5. Rekapitulasi Timbangan Pabrik & Susut Es
Setelah jembatan timbang pabrik mengeluarkan nota netto resmi:
1. Buka kembali surat jalan tersebut di tab **"Riwayat Kirim"**, lalu tekan tombol **"Buka"**.
2. Masukkan angka timbangan pabrik ke kolom **Netto Pabrik (kg)**.
3. Sistem secara otomatis menghitung selisih berat (kg) dan persentase susut es:
   * **≤ 2.0% (Hijau/Aman)**: Susut es normal akibat lelehan air es yang terbuang selama perjalanan.
   * **> 2.0% (Merah/Waspada)**: Susut berlebih! Wajib diperiksa suhu bak armada atau es pendingin.

### 6.6. Cetak Dokumen A4 & Kirim WhatsApp
* **Cetak A4**: Menghasilkan dokumen cetak resmi A4 lengkap dengan kop surat UD Sutardjo, rincian size per keranjang, rekap susut, dan tanda tangan digital kedua belah pihak.
* **Kirim WA**: Mengirimkan teks manifest muatan terverifikasi langsung ke nomor WhatsApp sopir atau staf logistik pabrik.

---

## MODUL 7: ACUAN HARGA PATOKAN HARI INI (PRICE MATRIX)

* Acuan harga beli standar harian per size (Size 30, 40, 50, dst.).
* Saat juru timbang memilih size udang pada keranjang timbangan, harga satuan otomatis terisi sesuai harga patokan hari ini.
* Wewenang mengubah harga patokan terkunci eksklusif untuk 👑 **Juragan / Owner**.

---

## MODUL 8: SINKRONISASI CLOUD GOOGLE SHEETS & MODE OFFLINE

### 8.1. Prinsip Offline-First
ShrimpLedger bekerja 100% tanpa internet di kolam tambak terpencil. Data tersimpan di memori aman HP (**IndexedDB**).

### 8.2. Antrean Sinkronisasi (Sync Queue)
Saat koneksi internet terhubung kembali:
1. Indikator di pojok kanan atas berubah menjadi hijau `Tersinkron`.
2. Seluruh nota yang tertunda otomatis diunggah ke Google Sheets (`Transaksi_Header`, `Transaksi_Detail`, `Buku_Kas`, dll.).
3. Pengguna dapat menekan tombol **"Sinkron Cloud"** kapan saja untuk memicu sinkronisasi manual.

---

## TANYA JAWAB & PEMECAHAN MASALAH (FAQ)

**Q: Bagaimana jika printer Bluetooth tidak terdeteksi?**  
A: Pastikan Bluetooth HP aktif, printer dalam kondisi menyala (*pairing mode*), lalu tekan tombol *Cetak Thermal*. Pilih nama perangkat printer Anda (cth: MPT-II, RPP02N).

**Q: Apakah data saya hilang jika browser ditutup?**  
A: Tidak. Seluruh data transaksi, kontak, dan catatan kas disimpan di memori lokal database HP (*IndexedDB*) dan tidak akan hilang meski HP dimatikan atau koneksi mati.

**Q: Siapa yang berhak menghapus data transaksi?**  
A: Hak menghapus dan merevisi harga patokan dibatasi secara sistem hanya untuk peran 👑 **Juragan / Owner**.

---
*Dokumen Panduan Resmi © 2026 UD SUTARDJO — ShrimpLedger Camplong Madura*