Swimlane per role untuk satu siklus Pre-Order, siklus status PO, contoh satu PO yang dipenuhi dua petani, dan sembilan titik overlap yang ditemukan di kode dan database produksi per 29 September 2026.
Angka dalam lingkaran adalah urutan jalur utama satu PO. Kotak garis putus-putus adalah aktivitas yang berjalan terus di sepanjang siklus. Kolom berarsir adalah zona tempat beberapa role bekerja bersamaan pada PO yang sama. Label O1–O9 merujuk ke daftar overlap di bagian 4.
Transisi persis seperti di controller. Alokasi hanya diterima saat PO disetujui atau sebagian_terpenuhi.
stateDiagram-v2 direction TB [*] --> draft: Buyer simpan [*] --> diajukan: Buyer ajukan langsung draft --> diajukan: Ajukan, nomor PO terbit draft --> dibatalkan: Buyer batalkan diajukan --> dibatalkan: Buyer batalkan atau petugas tolak diajukan --> disetujui: Petugas setujui disetujui --> sebagian_terpenuhi: Serah terima pertama, alokasi lain belum disetujui --> dalam_proses: Semua alokasi sudah diterima sebagian_terpenuhi --> dalam_proses: Alokasi terakhir diterima dalam_proses --> dikirim: Pengiriman dibuat dikirim --> selesai: Buyer konfirmasi selesai --> [*] dibatalkan --> [*]
Contoh PO 100 kg. Urutan kejadian di gudang dan di meja manager menentukan nasib PO.
sequenceDiagram
autonumber
participant B as Buyer
participant K as Petugas
participant M as Manager
participant A as Petani A
participant C as Petani B
participant G as Gudang
participant S as Status PO
B->>K: Ajukan PO 100 kg
K->>B: Disetujui, notif WA
M->>A: Alokasi 60 kg, notif WA
alt Manager lebih cepat
M->>C: Alokasi 40 kg
A->>G: Antar 60 kg
G->>S: sebagian_terpenuhi
C->>G: Antar 40 kg
G->>S: dalam_proses, 100 kg
else Gudang lebih cepat
A->>G: Antar 60 kg
G->>S: dalam_proses, 60 kg
M--xC: Alokasi 40 kg ditolak
end
par Pengiriman berjalan
S->>B: dikirim
and Buyer bisa langsung menutup
B->>S: selesai, barang belum tentu tiba
end
par terakhir sudah terjadi di produksi pada dua PO. Lihat O6.Tempat dua aktivitas, dua role, atau dua PO menyentuh data yang sama pada waktu yang sama. Sebagian memang dirancang begitu. Sebagian lain bisa menghasilkan data yang tidak konsisten.
Petani terus menambah data tanam dan laporan kondisi, lewat web maupun bot WhatsApp (n8n). Data tanam baru masuk berstatus menunggu dan baru bisa dialokasikan setelah diverifikasi. Kapasitas yang bisa dialokasikan ke PO berubah selama PO berjalan.
Manager boleh menambah alokasi selama PO disetujui atau sebagian_terpenuhi. Gudang bisa sudah menerima panen petani A saat manager baru mengalokasikan petani B.
Status dihitung dari jumlah alokasi, bukan kuantitas PO. Jika semua alokasi yang ada sudah diserahterimakan, PO langsung dalam_proses walaupun total alokasi masih di bawah pesanan. Setelah itu alokasi baru ditolak dan PO dikirim kurang.
Setiap alokasi hanya bisa diserahterimakan sekali dan langsung ditandai selesai berapa pun kg yang diterima. Petani yang dialokasikan 60 kg lalu menyerahkan 40 kg tidak bisa menyusulkan sisanya. Sisa 20 kg juga tidak kembali ke kebutuhan PO, karena sisa kebutuhan dihitung dari kg alokasi.
Sisa estimasi panen per lahan dihitung dari semua alokasi komoditas yang sama, lintas PO. PO yang dialokasikan lebih dulu mengambil kapasitas, tanpa antrian atau prioritas. Catatan: jika lahan tidak punya data tanam terverifikasi, pengecekan kapasitas dilewati di server. Pembatasnya hanya dropdown di form.
Status PO dan status pengiriman tidak saling mengunci. Buyer bisa menandai selesai begitu PO dikirim, walaupun pengiriman masih disiapkan.
Pengiriman hanya bisa dibuat saat PO dalam_proses dan belum punya pengiriman. Pengiriman bertahap (dua truk atau dua jadwal) belum didukung. Total kg diambil otomatis dari semua serah terima.
Setujui/tolak PO dan verifikasi tanam terbuka untuk semua role petugas dan manager, termasuk gudang dan distribusi. Notifikasi PO baru hanya dikirim ke petugas lapang. Sistem tidak menentukan siapa yang seharusnya menyetujui.
Middleware koperasi.scope hanya memastikan user punya koperasi_id dan tidak memfilter data. Daftar PO sudah difilter, tapi halaman detail, setujui, tolak, dan alokasi menerima PO koperasi mana pun jika ID-nya diketahui. Daftar verifikasi tanam juga menampilkan tanam semua koperasi.