Pengiriman

Modul Pengiriman dipakai untuk melacak pesanan dari disiapkan sampai diterima pelanggan. Akses halaman utama pengiriman: pemilik, manager, kasir, kurir, staf. Khusus Zona Pengiriman: pemilik, manager, kurir, staf — kasir tidak termasuk di halaman ini meski bisa akses halaman pengiriman lainnya.

Memperbarui status pengiriman

Tujuan: mencatat progres pengiriman sampai pesanan diterima pelanggan.

Buka menu Pengiriman.
Status bergerak: Belum Dikirim → Dalam Perjalanan → Tiba di Lokasi → Selesai. Klik tombol aksi pada pesanan untuk memajukan statusnya (“Mulai Kirim”, “Tiba di Lokasi”, “Selesai Diterima”).
Pada dialog update status, isi kendaraan dan catatan jika perlu. Foto bukti pengiriman bersifat opsional — sistem tidak mewajibkannya untuk menandai pengiriman selesai.
Jika pengiriman gagal, klik Tandai Gagal dan konfirmasi sekali lagi (perubahan ini perlu dua langkah agar tidak salah klik).

Hasil yang diharapkan: status pesanan ter-update dan tercermin di Riwayat Pesanan serta papan produksi.

Kesalahan umum:

Salah klik Tandai Gagal? Segera klik Urungkan pada notifikasi yang muncul — tombol ini hanya tersedia sesaat setelah aksi dilakukan, jangan menunggu terlalu lama.
Jangan mengira foto bukti pengiriman wajib diisi — tidak akan memblokir penyelesaian status jika kosong, tapi disarankan tetap diisi untuk bukti.
Pesanan bisa ditugaskan ke banyak kurir/kendaraan sekaligus lewat aksi massal — pastikan memilih kurir yang benar sebelum menugaskan beramai-ramai.

Memantau rute & lokasi kurir

Tujuan: melihat posisi kurir secara langsung dan mengoptimalkan rute.

Buka menu Peta Rute Pengiriman untuk melihat peta dengan lokasi kurir aktif (diperbarui otomatis secara berkala) dan rute pengiriman per zona.
Gunakan panel optimasi rute untuk mendapat saran urutan pengiriman yang lebih efisien.

Melihat manifes & laporan

Tujuan: merekap pengiriman harian per kurir/zona dan menilai kinerja.

Buka menu Manifes Pengiriman untuk melihat daftar pengiriman hari ini/tanggal pilihan, dikelompokkan per zona, kurir, atau waktu — lengkap dengan ringkasan selesai/berjalan/belum/gagal per kelompok.
Buka menu Laporan Pengiriman untuk melihat kinerja per kurir (total pesanan, selesai, gagal, tingkat keberhasilan, rata-rata durasi) atau per zona. Bisa difilter per rentang tanggal dan diekspor ke CSV.

Mengatur zona pengiriman

Tujuan: membagi area pengiriman jadi zona-zona dengan aturan pencocokan alamat otomatis.

Buka menu Zona Pengiriman.
Klik tambah zona baru: isi nama, kode, deskripsi, urutan tampil, dan kata kunci area (kata-kata yang dipakai sistem untuk mencocokkan alamat pelanggan ke zona ini secara otomatis).
Aktifkan/nonaktifkan zona sesuai kebutuhan, atau edit/hapus zona yang sudah ada.

Hasil yang diharapkan: alamat pengiriman baru otomatis tercocokkan ke zona yang sesuai berdasarkan kata kunci yang diatur di sini.

Sumber: src/pages/pengiriman/page.tsx, src/pages/pengiriman/rute/page.tsx, src/pages/pengiriman/manifes/page.tsx, src/pages/pengiriman/laporan/page.tsx, src/pages/zona-pengiriman/page.tsx, src/features/delivery/delivery-hooks.ts, src/lib/role-access.ts.