GACC China Export Traceability Standard

Rencana Teknis & Konsep Arsitektur
Aplikasi Ketertelusuran Ekspor Durian

Sistem Ketertelusuran Kebun, Packing House, Daily Auto-Lock Sanitasi, Verifikasi Karantina & Barcoding Shipment

Target Ekspor

Tiongkok (GACC China)

Main Backend

PocketBase Central

Mobile & Admin Tech

Flutter Multiplatform

Public Trace Web

Lightweight SPA HTML5

1. Konsep Utama & Fitur GACC Compliance

Sistem ini dirancang khusus untuk memastikan ketertelusuran penuh (end-to-end traceability) rantai pasok durian—mulai dari kebun (orchard), rumah pengemasan (packing house), verifikasi/validasi pihak otoritas karantina, hingga pelabelan barcode/QR Code untuk pengapalan (shipment) kardus ekspor ke Tiongkok (GACC China).

Fitur Utama Sistem

Ketertelusuran Kebun & Freetext GACC Code: Registrasi Kebun/Packing House mengikuti format resmi GACC China, lokasi GPS Geotag, & pencatatan panen.
Jurnal Sanitasi Harian (Daily Auto-Lock): Pelaporan harian kebersihan & desinfeksi packing house. Laporan tanggal berjalan terkunci otomatis setiap pergantian hari (pukul 23:59:59) untuk mencegah backdating.
Dual-Mode Compression & Interactive Image Zoom: Foto Jurnal Sanitasi maks 100 KB, foto Panen/Mutu maks 300 KB. Seluruh foto di Flutter App mendukung pinch-to-zoom dan fullscreen modal lightbox.
Verifikasi Karantina & Data Locking: Modul khusus verifikator UPT Karantina (Level 700). Data yang disetujui dikunci secara absolut (IS_LOCKED = true) dan tidak dapat diubah/dihapus kembali.
Barcoding Kardus & Public Web Scan: Barcode unik dipasang di setiap kardus ekspor. Dipindai mengarahkan ke SPA Web Publik (trace.ref.ac). Disediakan Internal Barcode Scanner pada aplikasi Flutter.
Offline-First Mobile Mode: Penginputan panen & foto kebun tetap berjalan meski tanpa jaringan internet (SQLite/Isar) dan otomatis tersinkronisasi.
Monetisasi & Subdomain Structure: Lisensi Play Store IAP Rp 480.000/tahun per perusahaan. Subdomain resmi: durian.ref.ac (Landing), trace.ref.ac (Scan), api-durian.ref.ac (PocketBase API).

2. Arsitektur Otorisasi & User Roles (Level 1-1000)

Level Role	Nama Peran	Hak Akses & Tanggung Jawab Operasional
1000	SUPERADMIN	Hak akses penuh sistem, manajemen server PocketBase, & lisensi.
900	PUSAT	Otoritas Karantina Pusat / Kementerian (Monitoring & Reporting Nasional).
800	REGIONAL	Karantina Wilayah / Provinsi.
700	UPT KARANTINA	Petugas Karantina Lapangan (Verifikasi Checklist OPT & Lock Data).
600	ADMIN PERUSAHAAN	Owner / Admin Ekspor Perusahaan (Manajemen Kebun & Packing House).
500	ADMIN PACKING HOUSE	Manajer Packing House (Verifikasi & Approve Jurnal Sanitasi Harian).
400	KARYAWAN PACKING	Staff Sortir, Pengemasan, Barcoding, & Pelapor Jurnal Sanitasi.
300	ADMIN KEBUN	Pengelola Kebun & Manajemen Blok Lahan.
200	KARYAWAN KEBUN	Petani / Operator Panen (Input Lot Panen & Foto Geotag).
100	PUBLIC	Buyer, Bea Cukai China (GACC), & Konsumen (Scan Barcode Web View).

3. Siklus Alur Data Ketertelusuran (Traceability Flow)

Proses ketertelusuran durian ekspor dijalankan melalui 4 tahapan utama berurutan:

Diagram Alur Ketertelusuran Durian Ekspor GACC

Rincian Penjelasan Alur:

Tahap 1 (Modul Kebun - Offline First): Petani mengambil foto durian dengan watermark GPS & timestamp (maks 300 KB). Data panen tersimpan di SQLite lokal jika offline dan tersinkronisasi otomatis saat terhubung internet.
Tahap 2 (Modul Packing House & Jurnal Sanitasi): Petugas mengisi Jurnal Sanitasi Harian (foto maks 100 KB). Jika belum diisi, penerimaan buah & cetak barcode diblokir. Laporan sanitasi dikunci otomatis tiap pukul 23:59:59.
Tahap 3 (Modul Verifikasi Karantina): Petugas Karantina (Level 700) memeriksa checklist OPT & mutu fisik. Setelah disetujui, data dikunci permanen (IS_LOCKED = true).
Tahap 4 (Modul Barcoding & Public Scan): QR Code kardus dicetak dan ditempel. Saat dipindai di Tiongkok, Bea Cukai GACC / Buyer melihat sertifikasi transparan di SPA trace.ref.ac.

4. Spesifikasi Notifikasi FCM (Firebase Cloud Messaging)

Kejadian (Event)	Target Role	Pesan Notifikasi	Deep Link Action
Pengingat Jurnal Sanitasi	Level 400 & 500	🧹 Laporan sanitasi harian belum diisi! Batas waktu 23:59:59.	Form Jurnal Sanitasi Harian
Pendaftaran Panen Baru	Level 300 & 500	📦 Lot Panen #[ID] telah disinkronkan dari Kebun [Nama Kebun].	Detail Lot Panen Kebun
Penerimaan & Sortir Selesai	Level 600 & 700	🚛 Batch Durian #[ID] siap diverifikasi Karantina.	Modul Verifikasi Karantina
Karantina Setuju & Lock	Level 400, 500, 600	🔒 Batch #[ID] disetujui Karantina & data terkunci. Cetak Barcode!	Cetak Barcode Kardus
Karantina Minta Revisi	Level 500 & 600	⚠️ Batch #[ID] memerlukan perbaikan data/sanitasi.	Revisi Checklist OPT
Pengingat Lisensi	Level 600	💳 Lisensi tahunan aplikasi Anda tersisa 30 hari (Rp 480rb/thn).	Paywall Play Store IAP

5. Tipografi & Desain System

Disambiguasi Font (Membedakan I Besar, l Kecil, & 1): Menggunakan font JetBrains Mono / Inter untuk kepastian visual kode registrasi & barcode.
Palet Warna Terpusat:
- 🟡 Durian Gold (Primary): #F5B014
- 🟢 Fresh Leaf Green (Secondary): #2E7D32
- 🪵 Teak Wood Warm Brown (Accent Kayu): #8B4513

6. Rencana Tahapan Eksekusi

Tahap 1: Konfigurasi Schema Collection di PocketBase, FCM Hooks, & Locking Rules.
Tahap 2: Engine Kompresi Foto (100KB & 300KB), Watermarking Geotag, Zoom Viewer, & Offline DB.
Tahap 3: UI Flutter Modular (Pemisahan strict Mobile & Desktop) + Integrasi Paywall Play Store.
Tahap 4: Pembuatan Public Web SPA (trace.ref.ac & durian.ref.ac).
Tahap 5: Pengujian Internal Scanner, Daily Lock Sanitasi, & Audit Karantina (Level 700).

Rencana Teknis & Konsep ArsitekturAplikasi Ketertelusuran Ekspor Durian