# Jejaksales — Dokumentasi Lengkap & Panduan Alur Penggunaan **part of bamahadigital.com** --- ## 1. Ringkasan Eksekutif (Executive Summary) **Jejaksales** adalah aplikasi SaaS *B2B Field Sales & Pipeline Tracking* yang dirancang khusus untuk perusahaan distributor, manufaktur, agroindustri, logistik, dan jasa B2B di Indonesia. Sistem ini memisahkan peran secara tegas antara **Portal Web** dan **Aplikasi Mobile (Android/iOS)**: - **Portal Web (`/` & `/docs`):** Digunakan oleh pemilik bisnis/Admin untuk **mendaftarkan perusahaan baru (Free Trial 7 Hari)**, mengatur master produk & kategori fleksibel, mengelola kuota kursi (*seat*) tim, memantau dashboard eksekutif, menyetujui diskon, mengunduh PDF penawaran resmi, dan mengelola tagihan langganan. - **Aplikasi Mobile Android & iOS (Flutter):** Digunakan oleh tim **Sales Lapangan, Supervisor, dan Manajer** untuk **Login operasional harian** (tanpa menu registrasi trial di HP), membuat jadwal kunjungan, melakukan **Check-in GPS Anti-Fake GPS + Foto Kamera Langsung ber-Watermark**, mengisi **Notulen Multi-Produk (Offline-First)**, memantau **Pipeline Deal**, dan mengirim **Surat Penawaran PDF via WhatsApp (GOWA)**. --- ## 2. Alur Penggunaan End-to-End (6 Langkah Utama) ### Langkah 1 — Pendaftaran Perusahaan & Aktivasi Free Trial 7 Hari (di Web) 1. Buka halaman depan **Web Jejaksales** lalu klik tombol **Coba Gratis 7 Hari** (jendela pendaftaran terbuka). 2. Isi **Nama Perusahaan (PT/CV)**, **Nama Admin**, **Email Kantor**, dan **Nomor WhatsApp**. 3. Pilih kanal pengiriman kode verifikasi (**WhatsApp GOWA** atau **Email SMTP**) lalu klik **Lanjut & Kirim Kode**. 4. Masukkan **6 digit kode OTP** beserta **Password Admin**, lalu klik **Aktifkan Free Trial**. 5. Sistem otomatis membuat *workspace* perusahaan Anda beserta kategori industri & kategori produk bawaan, dengan status **Trial Paket Business Pro selama 7 hari**. ### Langkah 2 — Konfigurasi Perusahaan, Produk & Hirarki Tim (Oleh Admin PT) 1. **Profil PT & RBAC (`Profil PT & RBAC`):** - Lengkapi Nama Resmi PT, NPWP, Alamat, Kota, Telepon, Tarif PPN default (`11%`), dan unggah **Logo Perusahaan** (akan tampil di kop Surat Penawaran PDF resmi). - Atur **Radius Maksimal Check-in GPS** (default `150 meter`). - Atur **Batas Diskon Berjenjang**: - `D0` (default `5%`): diskon `<= D0` langsung berstatus **Siap dikirim** tanpa menunggu approval. - `D1` (default `10%`): diskon `> D0` hingga `D1` membutuhkan persetujuan **Supervisor** (`approve_spv`). - Di atas `D1` (`> 10%`): membutuhkan persetujuan **Manajer** (`approve_mgr`). - Sesuaikan matriks hak akses (*Role-Based Access Control*) untuk role `Sales`, `Supervisor`, dan `Manajer`. 2. **Master Produk & Kategori (`Produk & Kategori`):** - Tambahkan kategori industri pelanggan dan kategori produk sesuai bisnis Anda. - Tambahkan daftar produk beserta **SKU**, **Satuan fleksibel** (`kg`, `ton`, `liter`, `unit`, `paket`, `kontrak`, dll.), dan **Harga Jual Standar (List Price)**. 3. **Kelola User & Kuota Seat (`User & Kuota Seat`):** - Tambahkan akun untuk **Manajer**, **Supervisor**, dan **Sales Lapangan**. - Pilih **Atasan Langsung (`boss_id`)** untuk setiap Sales (misalnya menunjuk Supervisor wilayahnya) agar alur monitoring tim dan approval diskon berjalan otomatis sesuai hirarki. 4. **Target Penjualan (`Target`):** - Manajer/Admin menetapkan target omzet PO tahunan perusahaan serta target bulanan per masing-masing Sales. ### Langkah 3 — Pendataan Akun Pelanggan B2B, Lokasi GPS & PIC 1. Buka menu **Akun B2B / Pelanggan** (di Web maupun Aplikasi Android). 2. Klik **Tambah Pelanggan Baru**: - Isi Nama Perusahaan Pelanggan, Kota/Wilayah, dan Kategori Industri. - Isi minimal **1 Lokasi** (misal: *Kantor Pusat*, *Pabrik Cikarang*, *Kebun Estate Siak 1*). Di aplikasi Android, Sales dapat menekan tombol **Tag GPS / Tandai GPS Sekarang** untuk mengunci koordinat lokasi secara presisi. - Isi minimal **1 Kontak PIC** lengkap dengan Jabatan, Nomor WhatsApp, dan **Peran Keputusan** (*Pengambil keputusan*, *Pemberi rekomendasi*, atau *Pengguna*). ### Langkah 4 — Jadwal & Check-in Kunjungan di Aplikasi Android (Anti-Fake GPS & Kamera Watermark) 1. Sales membuka aplikasi **Jejaksales Mobile** di HP Android/iOS lalu **Login** dengan email & password kantor. 2. Buka tab **Kunjungan**, tekan tombol **+ Jadwal**, pilih Pelanggan, Lokasi, PIC, Tipe Pertemuan (*Kunjungan Lapangan* atau *Meeting Online*), Tanggal, Jam, dan Tujuan Kunjungan. 3. Saat tiba di lokasi pelanggan, tekan tombol **Check-in GPS & Foto**: - **3-Tier GPS Acquisition:** Aplikasi mengunci sinyal GPS akurasi tinggi (satelit), otomatis *fallback* ke jaringan Wi-Fi/Seluler (*Fused Location*) bila di dalam gedung (*indoor*), atau posisi terakhir perangkat. - **Deteksi Fake GPS (`isMocked`):** Jika HP menggunakan aplikasi lokasi palsu (*mock location*), sistem otomatis **memblokir check-in**. - **Validasi Radius & Kalibrasi GPS:** Sistem menghitung jarak Haversine ke titik lokasi pelanggan. Jika lokasi pelanggan baru pertama kali dikunjungi atau perlu dikalibrasi, centang **"Simpan / Kalibrasi GPS saat ini sebagai koordinat lokasi pelanggan"**. - **Foto Kamera Langsung Ber-Watermark:** Sales wajib memotret langsung dari kamera belakang (tidak bisa memilih dari galeri). Aplikasi otomatis mengompres foto dan membubuhkan *watermark* permanen berisi **Nama PT Pelanggan, Tanggal & Jam WIB, serta Koordinat GPS**. ### Langkah 5 — Check-out Notulen Multi-Produk & Sinkronisasi Offline 1. Selesai rapat/kunjungan, Sales menekan tombol **Check-out Notulen** pada kunjungan yang sedang `Berlangsung`. 2. Isi formulir hasil kunjungan: - Pilih **Jenis Pertemuan** (*Perkenalan*, *Presentasi teknis*, *Follow-up*, *Negosiasi*, *Tender*). - Pilih **Stage Pipeline Hasil** (*Identifikasi*, *Presentasi teknis*, *Sampel / trial*, *Penawaran*, *Negosiasi / tender*, *PO*, atau *Kalah*). - **Multi-Produk:** Pilih satu atau beberapa produk sekaligus yang dibahas dalam pertemuan tersebut beserta estimasi volume dan nilai Rupiah masing-masing. - Isi **Ringkasan Kesepakatan / Notulen**, informasi kompetitor (opsional), serta **Tindak Lanjut & Tanggal Follow-up** berikutnya. 3. **Aturan Anti-Downgrade Pipeline:** Jika sebuah peluang produk sudah berada di tahap *Negosiasi / tender*, lalu kunjungan berikutnya dicatat sebagai *Presentasi teknis*, sistem menjaga agar tahap peluang **tidak turun mundur** (*anti-downgrade*), melainkan hanya memperbarui nilai dan waktu aktivitas terakhir. 4. **Mode Offline-First (Blank-Spot Ready):** Jika sales berada di area perkebunan/pabrik tanpa sinyal internet, pembuatan jadwal, check-in beserta file foto watermark, dan check-out notulen otomatis disimpan ke dalam **Antrean Offline SQLite** di HP dan langsung dikirim berurutan (*FIFO*) begitu sinyal internet kembali. ### Langkah 6 — Surat Penawaran PDF Resmi, Approval Diskon, WhatsApp GOWA & Closing PO 1. Buka menu **Penawaran & PDF** (di Web atau menu **Lainnya -> Penawaran Resmi** di Android). 2. Pilih Pelanggan, PIC, item produk, kuantitas, harga satuan, persentase diskon, opsi PPN 11%, dan termin pembayaran. 3. Saat diterbitkan: - Jika `Diskon <= D0`: status langsung **Siap dikirim** dan file **PDF Resmi ber-kop perusahaan** otomatis dibuat. - Jika `Diskon > D0`: status menjadi **Menunggu**, dan notifikasi persetujuan otomatis dikirim ke **Supervisor** (`<= D1`) atau **Manajer** (`> D1`) melalui aplikasi dan WhatsApp GOWA. 4. Supervisor/Manajer membuka menu **Persetujuan Diskon**, meninjau margin/detail, lalu menekan **Setujui** atau **Tolak** (wajib isi alasan jika ditolak). 5. Setelah berstatus **Siap dikirim**, Sales dapat: - Menekan **Buka PDF** untuk mengunduh/melihat dokumen PDF resmi. - Menekan **Kirim WA** untuk mengirimkan file PDF penawaran beserta pesan pengantar langsung ke nomor WhatsApp PIC pelanggan melalui integrasi **GOWA (Go WhatsApp Multi-Device)**. - Membuat **Revisi Penawaran** (`-R1`, `-R2`, dst.) jika ada perubahan harga/kuantitas hasil negosiasi. 6. **Closing PO / Kalah di Pipeline:** - Ketika pelanggan menerbitkan Purchase Order, buka tab **Pipeline**, pilih peluang terkait, ubah stage menjadi **PO**, lalu masukkan **Nomor PO** dan **Nilai PO Aktual**. Omzet PO otomatis menambah realisasi target bulanan & tahunan di Dashboard! --- ## 3. Rumus Perhitungan Kuota Kursi (Seat) & Langganan SaaS Jejaksales menggunakan model harga **Per Akun Sales Aktif** dengan **Bonus Kursi Manajemen Gratis** (untuk Admin, Supervisor, dan Manajer): $$\text{Kuota Manajemen Gratis} = \text{Base Free Mgmt} + \left\lfloor \frac{\text{Jumlah Seat Sales}}{\text{5}} \right\rfloor \times \text{Bonus per 5 Sales}$$ | Paket | Harga Bulanan / Sales | Harga Tahunan / Sales | Min. Seat Sales | Base Free Mgmt | Bonus per 5 Sales | Contoh 5 Seat Sales | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | **Starter** | Rp 39.000 | Rp 390.000 | 3 Sales | 1 akun | +1 per 5 Sales | **5 Sales + 2 Manajemen Gratis** | | **Business Pro** | Rp 65.000 | Rp 650.000 | 5 Sales | 2 akun | +2 per 5 Sales | **5 Sales + 4 Manajemen Gratis** | - **Cara Perpanjangan / Pembayaran:** 1. Admin Perusahaan membuka menu **Langganan & Invoice**, memilih paket, jumlah kursi Sales, dan siklus tagihan (Bulanan / Tahunan). 2. Sistem menerbitkan Invoice resmi beserta nominal transfer bank. 3. Admin mengunggah foto/PDF bukti transfer pada invoice tersebut. 4. **Superadmin Platform (`bamahadigital.com`)** memverifikasi pembayaran melalui panel Superadmin, dan masa aktif langganan perusahaan otomatis diperpanjang beserta notifikasi WhatsApp/Email. - **Mode Masa Tenggang (Read-Only):** Jika masa Trial 7 Hari atau langganan berakhir, data perusahaan **tidak dihapus** — seluruh user tetap bisa login dan melihat laporan/PDF dalam mode *Read-Only* sampai invoice perpanjangan diverifikasi.