# Dataplatform Documentation

Dokumentasi aktif Dataplatform. Arah produk tertinggi ada di PRD. Dokumen lain
menjelaskan implementasi tanpa mengubah arah PRD.

| Dokumen | Isi authoritative |
|---|---|
| [`PRD-DMP-Customer-Engagement-v0.2.md`](PRD-DMP-Customer-Engagement-v0.2.md) | Arah produk, scope MVP, prinsip |
| [`design.md`](design.md) | Stack, arsitektur, module boundaries, flows, roadmap, decision register |
| [`system-rules.md`](system-rules.md) | Aturan runtime: tenancy, RBAC, identity/dedup, merge, campaign, AI |
| [`design-guide.md`](design-guide.md) | Visual system, komponen, React/Inertia rules, aksesibilitas |
| `database-schema.md` | Schema, constraint, aturan migration (dibuat bareng migration pertama) |
| [`log.md`](log.md) | Dev log: apa yang dikerjakan, keputusan, next step |
| [`manual/README.md`](manual/README.md) · [`Buku HTML`](manual/index.html) | Panduan penggunaan semua role, hasil/status, screenshot aktual, dan operasional; menjelaskan implementasi tanpa mengganti authority produk |

## Reading Order

Mulai setiap sesi kerja dengan membaca entri teratas [`log.md`](log.md) untuk status
handoff. Sebelum mengubah kode atau menjalankan mutasi, tulis entri `IN PROGRESS`
berisi scope, baseline, dan rencana verifikasi. Update entri saat checkpoint selesai
atau ada temuan/perubahan arah. Saat berhenti, tulis hasil aktual, pekerjaan tersisa,
perintah untuk melanjutkan, dan status commit/push. Jangan mencatat secret atau PII.
Ini berlaku untuk semua developer/agent agar perpindahan sesi tidak kehilangan konteks.

## Panduan penggunaan dan pemeliharaannya

Panduan lengkap ada di [`manual/README.md`](manual/README.md), dengan versi browser di
[`manual/index.html`](manual/index.html) dan [modul PDF A4 siap cetak](manual/dataplatform-modul-panduan.pdf).
Gambar menggunakan data demo sintetis.
Setiap perubahan fitur, alur, label UI, role/permission, output/status, KPI, integrasi,
atau prosedur operasional **wajib memperbarui bab dan screenshot yang terdampak dalam
pekerjaan yang sama**. Sebelum selesai, build ulang buku, jalankan pemeriksaan link/
gambar, dan catat hasil aktual serta batas uji di log. Perubahan belum selesai bila
panduan masih menjelaskan perilaku lama. Prosedur dan perintah tersedia di
[`manual/12-pemeliharaan.md`](manual/12-pemeliharaan.md); tidak mengklaim pembaruan isi
otomatis tanpa review. Dokumen source tetap Markdown, HTML adalah hasil generate.

1. PRD untuk memahami produk.
2. `design.md` untuk stack dan arsitektur.
3. `system-rules.md` sebelum mengubah perilaku data atau otorisasi.
4. `database-schema.md` sebelum membuat atau mengubah migration.
5. `design-guide.md` sebelum mengubah UI.

## Authority Rules

- PRD menang untuk urusan perilaku produk. Kalau dokumen lain bertentangan, dokumen
  itu yang dikoreksi.
- Setelah kode ada, kode dan migration jadi sumber kebenaran untuk perilaku yang sudah
  diimplementasi. Kalau dokumen dan kode beda, catat dan perbaiki dokumennya dalam
  perubahan yang sama.
- Keputusan produk baru dimasukkan ke dokumen yang memiliki topiknya. Jangan bikin
  dokumen top-level baru kalau topiknya sudah dimiliki dokumen di atas.

## Latar belakang

Dataplatform adalah codebase baru. Konsep diambil dari project lama (Endee DMP), bukan
teknologinya. Stack lama (Livewire, MySQL, installer cPanel) tidak dipakai.