Onboarding

Prerequisites (tools)

• Node + pnpm 9.1.0 — web (Next.js).
• Node + Expo CLI — mobile (React Native).
• Go (lihat go.mod) — bgjobs.
• Python 3.12 + uv — connector.
• Docker — DB lokal, stack offline.
• Akses Zitadel (auth) & repo GitHub org msa-haer-org.

Versi & port yang pasti selalu ambil dari README.md + .env.example tiap repo (itu source of truth-nya, bukan handbook ini).

Quick start per repo

Cara install & jalanin tiap repo ada di halaman repo-nya masing-masing:

• haer-platform-web
• haer-platform-api
• haer-claims-mobile
• haer-platform-bgjobs
• haer-connector

Prinsip environment lokal (env toggle, stack offline, scratch DB) ada di Environments & Local.

First PR

1. Ambil ticket dengan acceptance criteria jelas.
2. Pastikan dev up-to-date, branch dari dev: git checkout dev && git pull && git checkout -b <type>/<short-desc>.
3. Baca AGENTS.md repo terkait + .ai/instructions/* yang relevan.
4. Implement slice terkecil yang jalan; ikuti konvensi lokal.
5. Tulis test dulu (TDD — lihat Technical Standards).
6. Jalanin required commands lokal (lihat Engineering Process).
7. Buka PR ke dev, isi semua section template.

Quick map

Bingung repo mana buat apa? Lihat Architecture & Systems. Nggak ngerti istilah? Lihat Domain & Glossary.