Skip to Content
Engineering HandbookDeploy & Operations

Deploy & Operations

Deploy topology

  • haer-platform-web + haer-claims-api — dideploy via compose stack produksi.
  • haer-platform-api + haer-platform-bgjobs + haer-connector — dideploy via Coolify (di luar compose produksi utama).
  • Detail deploy tiap repo ada di halaman repo-nya (section Per Repo). Target & pipeline pasti di repo deploy + config Coolify.

Nilai/host/secret deploy ada di tim DevOps (deploy), bukan di handbook ini.

Versioning & release

  • haer-platform-web di-version oleh release-please (push ke main). Seluruh Turborepo satu versi.
  • Title squash-merge harus Conventional Commits; feat!: / BREAKING CHANGE: → major bump.
  • dev = integrasi, main = release. release-please cuma jalan di main.

Observability

  • LGTM stack (Loki / Grafana / Tempo / Mimir) + OTel Collector.
  • haer-platform-api kirim telemetry saat OTEL_ENABLED.
  • connector — trace jalur AI/LLM lewat Langfuse (skor confidence + reviewer feedback).
  • Debug prod: mulai dari log/trace di Grafana, korrelasikan lewat trace id.

Incident & on-call

[Usulan — belum jadi proses resmi.] Draft default biar ada titik mulai; sesuaikan dengan kapasitas tim.

  • Severity: SEV1 (produksi down / data-loss), SEV2 (fitur inti rusak, ada workaround), SEV3 (minor / kosmetik).
  • Saat incident: satu orang jadi incident lead (koordinasi + komunikasi), yang lain mitigasi. Komunikasi ditulis (channel incident), bukan lisan.
  • Postmortem blameless untuk SEV1/SEV2: timeline, root cause, dampak, action item. Fokus ke sistem, bukan nyalahin orang.
  • On-call: rotasi & jam respons TBD — tentukan kalau volume incident udah cukup buat butuh rotasi formal.

Tech-debt

[Draft]

  • Debt yang disengaja ditandai di kode (mis. komentar ponytail: / TODO dengan konteks) + di-track sebagai issue.
  • Bayar debt saat nyentuh area terkait; jangan numpuk diam-diam. Debt besar diangkat di planning, bukan diselundupin.

Security disclosure

[Draft]

  • Nemu vuln (internal/eksternal): laporkan privat ke Tech Lead / Security, jangan buka issue publik dengan detail exploit.
  • Path & kontak resmi TBD — tetapkan channel disclosure privat + SLA respons.

Source: memory operasional + repo deploy. Bagian [Usulan]/[Draft] perlu keputusan tim sebelum jadi aturan.

Environments & Localhaer-platform-web