engineering docs

Blueprint delivery Aori

Empat dokumen di direktori ini adalah satu set kanonis untuk pengembangan Aori sebagai SaaS multi-tenant dan multi-database. Dokumen ini tidak menggantikan source code: route, controller, service, Prisma schema, dan kontrak yang telah diterapkan tetap menjadi bukti implementasi terakhir.

Urutan membaca

  1. Baca Roadmap eksekusi untuk fase, dependency, checklist, status, blocker, dan definition of done.
  2. Baca Overview blueprint untuk vocabulary, owner database, tenant boundary, authorization, entitlement, dan aturan distributed consistency.
  3. Baca Study kasus untuk menguji keputusan terhadap alur bisnis nyata serta invariant yang tidak boleh dilanggar.

Aturan pembaruan

  • Setiap perubahan code, kontrak, schema, route, atau keputusan arsitektur wajib memperbarui bagian relevan pada roadmap dan Change Log-nya.
  • Perubahan ownership, boundary, atau vocabulary juga wajib memperbarui overview.
  • Perubahan lifecycle atau invariant bisnis wajib memperbarui study.
  • Jangan menandai pekerjaan selesai hanya karena model, endpoint, atau halaman telah ada. Boundary API, authorization, entitlement bila relevan, validasi, lifecycle, invalidation, dan dokumentasi harus dinilai bersama.

Instruksi operasional agent dan contributor berada di AGENTS.md pada root repository.