Engineering Handbook

Panduan cara kerja engineering di platform HAER — lintas repo, dari kode sampai produksi. Ditujukan untuk tim internal (engineer & coding agent), bukan admin/operator produk.

Repos covered

Handbook ini mencakup lima repo inti. Tiap repo punya halaman dokumentasinya sendiri di section Per Repo (klik nama; link GitHub ada di dalam):

• haer-platform-web — frontend web (Next.js / Turborepo).
• haer-platform-api — backend transaksional utama (NestJS + TypeORM).
• haer-claims-mobile — app mobile klaim & benefit (Expo / React Native).
• haer-platform-bgjobs — background workers (Go): notifikasi, import, sync.
• haer-connector — integration layer + AI (Python / FastAPI).

Peta lengkap & cara mereka nyambung ada di Architecture & Systems.

How to read this handbook

• Baru gabung? Mulai dari How We Work lalu Onboarding.
• Mau ngerti alur ngirim kode → Engineering Process.
• Butuh aturan teknis org-wide → Technical Standards.
• Kerja di repo tertentu → langsung ke halaman repo-nya di section Per Repo.
• Nyari istilah domain → Domain & Glossary.

Isinya dibagi dua: Platform (berlaku ke semua repo) dan Per Repo (setup, konvensi, migrasi, deploy spesifik tiap repo).

Source of truth (CI-enforced)

Handbook ini ringkasan yang mudah dibaca. Kebenaran yang di-enforce tetap di tiap repo:

• AGENTS.md di masing-masing repo (CLAUDE.md = symlink) — kontrak per-repo.
• ../CLAUDE.md (workspace) — aturan lintas-folder, git workflow, HR standards.
• README.md + .env.example tiap repo — setup & config yang benar (port, kredensial).

Kalau konflik: AGENTS.md repo terkait menang, lalu workspace CLAUDE.md.

Status

Draft awal. Beberapa bagian (values/culture, incident/on-call, tech-debt, security disclosure) ditandai [Draft] atau [Usulan] — itu belum jadi proses resmi, tolong dikoreksi. Bagian yang bersumber dari file repo sudah akurat per tanggal tulis; kalau ubah aturan, ubah file sumber dulu baru rangkum di sini biar nggak drift.