Mulai dari sini
Kenapa mulai dari Order
Order adalah pusat struktural sistem ini — dilihat dari ukuran kode (controller Order jauh lebih besar dari controller manapun yang lain), dan dari berapa banyak proses bisnis yang lewat di dalamnya: negosiasi, pembayaran, penugasan driver, pengiriman, verifikasi POD, pembatalan, sampai pencairan dana. Hampir semua bagian lain sistem (invoice, billing, truk, pelacakan) ada untuk melayani Order, bukan sebaliknya. Karena itu dokumen siklus status Order jadi prioritas pertama — bukan berarti domain lain kurang penting, cuma paling banyak terhubung ke sana. Lihat Peta domain untuk gambaran domain lainnya.
Ini potret, bukan spesifikasi
Dokumen-dokumen di sini menjelaskan apa yang benar hari ini, ditelusuri langsung dari kode saat ditulis. Ini bukan aturan yang mengikat bagaimana sistem harus dibangun ke depan.
Kalau ada sesuatu di sini yang terasa aneh atau tidak ideal (nama status yang membingungkan, endpoint yang dipakai untuk keperluan di luar tujuan awalnya, alur lama yang ternyata sudah mati tapi endpoint-nya masih bisa dipanggil, dan semacamnya) — itu memang begitu apa adanya sekarang, bukan rekomendasi supaya tetap begitu selamanya. Dokumentasi yang menjelaskan sesuatu dengan jelas bukan berarti sesuatu itu sudah benar dan tidak perlu diperbaiki.
Kode berubah, dokumen ini bisa (dan akan) ketinggalan zaman sampai ada yang memperbarui — cek "Terakhir diperbarui" di tiap halaman. Kalau ragu, atau kalau dokumen ini dan kode ternyata beda, kode adalah kebenaran akhir, bukan dokumen ini. Tolong dilaporkan/diperbaiki kalau menemukan perbedaannya.
Dua penanda yang dipakai berulang
❓ Belum terverifikasi — bukan dugaan asal, tapi belum ditelusuri sampai tuntas, atau butuh konfirmasi dari tim lain (biasanya mobile, karena kode aplikasinya tidak ada di sini). Jangan dibaca sebagai fakta pasti.
⚠️ Sudah dikonfirmasi, tapi hasil desain yang membingungkan atau bermasalah — layak dipertimbangkan untuk diperbaiki, bukan dianggap normal karena "sudah didokumentasikan jadi berarti sudah benar."
Kalau menemukan istilah yang tidak dijelaskan di sini
Beberapa dokumen menyebut fitur lain sekilas (Agreement, 3PL, rute perencanaan, dst.) tanpa menjelaskannya penuh, karena itu di luar fokus dokumen yang bersangkutan dan belum ada yang menulis dokumennya. Peta domain mengumpulkan semua fitur/domain yang diketahui ada, termasuk yang belum terdokumentasi, supaya "disebut sekilas lalu hilang" itu setidaknya punya satu tempat yang jelas untuk dicek.