Onboarding Junior Maintainer
Dokumen ini jalur tercepat supaya kamu bisa maintain ADI-JAYA dengan aman.
Kalau mau versi sprint 3 hari, buka Day 1 - Day 3 Onboarding. Untuk item ambigu lintas halaman, pakai Verification Matrix.
1) 🎯 Tujuan sistem (versi praktis)
ADI-JAYA menangani alur project, procurement, approval, dan pembayaran yang sensitif terhadap status + role.
Risiko terbesar:
- perubahan status entity tanpa validasi role,
- perubahan data massal tanpa backfill plan,
- deploy tanpa verifikasi pasca-rilis.
2) 🛡️ Rule of engagement (wajib)
- Jangan ubah data production langsung tanpa tiket + approval.
- Selalu mulai dari branch terpisah.
- Semua perubahan schema/data wajib punya impact analysis, rollback plan, dan verifikasi pasca deploy.
- Jika ragu, tulis perlu verifikasi di Verification Matrix lalu eskalasi.
3) 🧭 Where to find X
- Role & permission → role-access-matrix
- Status legal per domain → state-machine
- Flow bisnis end-to-end → business-flows, end-to-end-process
- API harian (ringkas) → api-reference
- API lengkap untuk audit → api-full-catalog
- Contoh payload → api-examples, request-response-catalog
- Relasi DB cepat → database-viewer
- Inventori tabel lengkap → database-full-catalog
- Perubahan data aman → change-data-playbook, change-example-pack
- Deploy & ops → deployment-runbook, troubleshooting
4) Peta belajar 7 hari
Hari 1: orientasi
Baca: overview, architecture, domain-model, module-map.
Hari 2: API + role
Baca: api-reference, request-response-catalog, role-access-matrix.
Hari 3: data & state
Baca: database-viewer, database-design-full, state-machine.
Hari 4: operasi
Baca: setup-local, deployment-runbook, observability-ops.
Hari 5: simulasi maintenance
Jalankan minimal 3 skenario dari common-maintenance-tasks.
Hari 6: simulasi perubahan data
Ikuti change-data-playbook untuk latihan migration/backfill di staging.
Hari 7: troubleshooting drill
Jalankan 3 kasus dari troubleshooting decision tree.
5) ✅ Definition of done untuk junior
Kamu dianggap siap jaga sistem jika sudah bisa:
- membaca log dan mengaitkan ke modul yang tepat,
- menjelaskan dampak perubahan schema,
- menjalankan deploy check tanpa dibimbing,
- menulis rollback note yang bisa dieksekusi tim lain.
6) 🚫 Anti-pattern yang harus dihindari
- Fix cepat tanpa test/verifikasi.
- Mengubah query bisnis langsung di production.
- Menghapus data karena terlihat duplikat tanpa analisis relasi.
- Menganggap status enum sepele.
7) 📣 Eskalasi
Segera eskalasi ke senior jika:
- menyentuh data finansial / approval final,
- perlu hotfix schema di jam sibuk,
- rollback berpotensi memengaruhi transaksi aktif,
- root cause belum ketemu > 60 menit.