Panduan PRD
Setiap feature PRD memakai kerangka yang sama: dua belas section bernomor dengan urutan tetap. Urutannya bukan selera — tiap section menjawab satu pertanyaan, dan jawabannya menumpuk dari alasan (kenapa fitur ini ada) menuju rincian (apa isinya, bagaimana tampilannya, siapa yang boleh apa).
Halaman ini menjelaskan prinsip yang berlaku, lalu tiap section satu per satu, dan ditutup dengan kerangka kosong yang bisa langsung disalin.
Prinsip
- Masalah dulu, baru solusi. Mulai dari siapa yang kesulitan dan kenapa itu layak dikerjakan. Fitur adalah jawabannya, bukan titik berangkatnya.
- Tulis apa dan kenapa, bukan bagaimana. PRD menetapkan hasil dan batasan; cara membangunnya ditentukan saat implementasi. Detail implementasi yang dikunci terlalu awal cepat basi.
- Yang tidak dikerjakan ikut ditulis. Batas yang tidak tertulis akan diisi asumsi masing-masing orang, dan baru ketahuan saat sudah jalan.
- Satu kalimat, satu tafsir. Buang kata yang tidak bisa diukur — cepat, mudah dipakai, sebisa mungkin. Ganti dengan angka, daftar tertutup, atau kondisi yang bisa dicek.
- Kalau tidak bisa diuji, belum selesai ditulis. Tiap kriteria harus bisa dinyatakan lulus atau gagal tanpa perlu berdebat.
- Satu hal, satu nama. Nama yang dipakai di PRD sama dengan yang dipakai di layar, di kode, dan saat berdiskusi. Dua nama untuk satu hal membuat orang mengira ada dua hal.
- Pertanyaan yang belum terjawab ditulis apa adanya. Lebih baik satu baris yang jujur menggantung daripada tebakan yang terdengar pasti.
- Saat keputusan berubah, dokumennya diperbarui lebih dulu. PRD yang tidak dirawat berhenti menjadi rujukan dan berubah menjadi arsip.
Kesepakatan
- Bahasa Indonesia, kecuali istilah yang justru lebih jelas dalam Inggris — endpoint, entity, status, field, datatable. Nama section juga tetap Inggris.
- Kerangkanya tetap. Section yang tidak relevan dilewati, bukan diisi “Tidak berlaku”, dan tidak ada section tambahan di luar yang ada di template.
- Pertanyaan yang belum terjawab ditandai
**Perlu dikonfirmasi**di tempat kejadiannya, bukan dikumpulkan jadi daftar terpisah. - PRD hanya memuat yang sudah diputuskan. Ide yang masih wacana tempatnya di Non-goals, atau belum perlu ditulis sama sekali.
Urutan Menulis
Urutan section disusun agar mudah dibaca, bukan agar mudah ditulis. Saat mengisinya, urutan berikut biasanya paling lancar:
- Problem, lalu Goals & Non-goals — sepakati masalah yang dipecahkan dan sampai mana batas pekerjaannya.
- Business Rules — rumuskan aturan yang mengikat, karena seluruh section setelahnya bersandar padanya.
- Flow dan Status Lifecycle — pastikan prosesnya utuh, dari awal sampai kondisi akhirnya.
- Document Structure, lalu UI Structure — turunkan aturan menjadi field, lalu field menjadi tampilan.
- User Stories dan User Scenarios — nyatakan kebutuhannya sebagai kriteria yang bisa diuji.
- Permissions & Actions, lalu Notifications dan Dependencies — tetapkan siapa boleh melakukan apa, dan apa saja yang terpengaruh.
- Overview terakhir — rangkum setelah isinya jelas, karena saat itu jauh lebih mudah dirumuskan.
Blok Metadata
Setiap PRD dibuka dengan judul, tiga bullet metadata bernilai tebal, lalu garis pemisah:
# Pesanan Pembelian
- Code: **PUR-PO**
- Module: **Purchasing**
- Type: **Transaction**
---| Bagian | Aturan |
|---|---|
| Judul | # <Nama Fitur>, memakai nama fitur yang disepakati untuk bahasa dokumen tersebut |
| Code | Tiga huruf modul, tanda hubung, singkatan fitur — PUR-PO, SET-EMP, ACC-NTF. Unik seluruh docs |
| Module | Nama modul induknya |
| Type | Sifat data yang dikelola fitur, dipilih dari daftar tertutup di bawah |
Tidak ada Status, Priority, Owner, atau API pada metadata.
Daftar Type. Empat nilai ini menentukan bentuk PRD-nya, jadi tentukan lebih dulu sebelum mengisi section lain:
| Type | Untuk | Cirinya |
|---|---|---|
| Transaction | Dokumen yang mencatat kejadian bisnis dan dibuat berulang | Punya status, sering punya baris dan perhitungan |
| Master Data | Data acuan yang dikelola lalu dirujuk fitur lain | Dibuat, diubah, dihapus, dan dicari lewat daftar |
| Configuration | Pengaturan yang mengubah perilaku sistem | Umumnya satu data per lingkup, tidak dibuat berulang |
| System Record | Data yang dihasilkan sistem, bukan diisi pengguna | Dibaca saja; paling jauh dihapus, dicabut, atau ditandai |
Ringkasan Section
| # | Section | Menjawab | Wajib |
|---|---|---|---|
| 1 | Overview | Fitur ini apa, dan hasil yang diharapkan apa? | Ya |
| 2 | Problem | Kenapa fitur ini ada — apa yang rusak tanpanya? | Ya |
| 3 | Goals & Non-goals | Apa yang dikejar, dan apa yang sengaja tidak dikerjakan? | Ya |
| 4 | Business Rules | Aturan apa yang berlaku di mana pun, siapa pun pelakunya? | Ya |
| 5 | Flow | Bagaimana prosesnya berjalan, dan status apa saja yang dilalui? | Ya |
| 6 | Document Structure | Field apa saja yang dimiliki data ini, dan aturan nilainya? | Ya |
| 7 | UI Structure | Field itu tampil dan dioperasikan seperti apa di layar? | Ya |
| 8 | User Stories | Siapa butuh apa, dan kapan dianggap selesai? | Ya |
| 9 | User Scenarios | Seperti apa pemakaian nyatanya dari ujung ke ujung? | Ya |
| 10 | Permissions & Actions | Siapa boleh melakukan apa, dan pada status apa? | Ya |
| 11 | Notifications | Kejadian apa yang memicu notifikasi, ke siapa, dan lewat apa? | Ya |
| 12 | Dependencies | Fitur ini bergantung pada apa, dan memengaruhi apa? | Ya |
Penomoran tidak boleh diubah. Bila sebuah sub-bagian tidak relevan, sub-bagian itu dilewati — nomor section utamanya tetap.
1. Overview
Tujuan. Memberi pembaca pemahaman utuh dalam satu kali baca, tanpa perlu turun ke section lain.
Isi. Dua paragraf. Paragraf pertama mendefinisikan fitur: apa dokumennya, apa posisinya dalam alur bisnis yang lebih besar, dan apa yang membedakannya dari fitur tetangga. Paragraf kedua selalu dibuka Hasil yang diharapkan: … dan menyebut kondisi yang tercapai ketika fitur ini bekerja.
Aturan. Tulis dari sudut pandang bisnis, bukan implementasi. Tidak ada nama tabel database, nama komponen, atau endpoint di sini.
2. Problem
Tujuan. Mencatat kenapa fitur ini dibangun, supaya keputusan desainnya bisa ditimbang ulang di kemudian hari.
Isi. Satu paragraf yang menggambarkan bagaimana pekerjaan ini berjalan tanpa fitur tersebut, ditutup dengan Akibatnya:, lalu bullet berisi akibat konkretnya.
Aturan. Setiap bullet adalah masalah yang dirasakan orang, bukan kekurangan teknis. Tulis “barang yang datang sulit dicocokkan dengan kesepakatan awal”, bukan “belum ada relasi antara tabel penerimaan dan pesanan”.
3. Goals & Non-goals
Tujuan. Mengunci batas pekerjaan, supaya scope tidak melebar diam-diam.
Isi. Dua sub-bagian: ### 3.1 Goals dan ### 3.2 Non-goals, masing-masing berupa bullet.
Aturan.
- Goals ditulis sebagai hasil yang dikejar, bukan daftar fitur. “Selisih jumlah atau harga ketahuan saat barang diterima” — bukan “ada tombol terima barang”.
- Tiap Goal sebaiknya menjawab satu bullet di Problem.
- Non-goals berisi hal yang wajar diharapkan tapi sengaja tidak dikerjakan, beserta gantinya bila ada: “Pengiriman PO ke supplier langsung dari sistem; PO diunduh sebagai PDF lalu dikirim lewat kanal masing-masing toko.”
4. Business Rules
Tujuan. Menjadi sumber kebenaran tunggal fitur ini. Kalau bagian lain di PRD tampak bertentangan, aturan di section inilah yang berlaku.
Isi. Paragraf pembuka baku, lalu bullet bernomor **BR-01**, **BR-02**, dan seterusnya.
Aturan.
- Satu BR berisi satu aturan utuh, ditulis sebagai kalimat yang bisa benar atau salah — bukan deskripsi fitur.
- Aturan berlaku di seluruh aplikasi, pada semua layar dan aksi, siapa pun pelakunya. Aturan yang hanya berlaku di satu layar bukan BR; itu perilaku UI dan tempatnya di UI Structure atau AC.
- Nomor BR tidak pernah dipakai ulang. Kalau sebuah aturan dihapus, nomornya dipensiunkan, bukan diisi aturan baru.
- Business Rules adalah kontrak FE–BE: backend yang menegakkan, frontend memakainya sebagai validasi form.
5. Flow
Tujuan. Menunjukkan bagaimana proses berjalan dari awal sampai berakhir, dan status apa saja yang dilewati.
Isi. Sub-bagian ### 5.1 Main Flowchart dan ### 5.2 Status Lifecycle. Tiap sub-bagian berisi diagram Mermaid, lalu penjelasannya — tanpa heading tambahan di antara diagram dan penjelasan.
5.1 Main Flowchart
Diagram flowchart TD, lalu daftar langkah bernomor yang menjelaskan tiap node.
- Alur terpanjang diletakkan di tengah agar diagram mudah dibaca.
- Aksi yang kembali ke status yang sama (mengubah data, menetapkan PIC) digambar sebagai langkah sendiri dengan panah dua arah
<-->, bukan self-loop. - Ditulis sebagai spesifikasi perilaku sistem, bukan narasi tutorial. Tulis “PO menjadi berlaku dan isinya terkunci permanen”, bukan “staf klik tombol Ajukan lalu menekan konfirmasi”.
- Langkah yang rinciannya milik PRD lain cukup disebut dan ditunjuk, misalnya penerimaan barang yang dijelaskan di PRD Goods Receipt.
5.2 Status Lifecycle
Diagram stateDiagram-v2, lalu tabel status.
| Status | Keterangan | Selanjutnya |
|---|---|---|
| Draf | Sedang disusun, belum berlaku bagi supplier | Diajukan, atau dihapus |
- Kolom Status memuat nama tampilannya, lalu nilai teknisnya dalam backtick di baris kedua, dipisah
<br />— sehingga sel Draf berisi nama Draf di baris pertama dandraftdi baris kedua. - Kolom Selanjutnya menyebut status yang bisa dicapai berikutnya, atau
—untuk status akhir. - Fitur tanpa status tidak punya sub-bagian ini. Bila fitur punya alur lain yang berdiri sendiri, tambahkan sebagai sub-bagian baru dengan pola yang sama.
6. Document Structure
Tujuan. Mendefinisikan isi datanya sendiri — field apa yang dimiliki, tipenya, mana yang wajib, nilai awalnya, dan aturan nilainya. Ketentuan di sini berlaku di mana pun data dibuat atau diubah dan ditegakkan saat penyimpanan, terlepas dari bagaimana field itu ditampilkan.
Isi. Diawali satu paragraf pembuka, lalu satu tabel per sub-bagian dengan kolom tetap:
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| Tanggal Estimasi Diterima | Tanggal | Ya | — | Tidak boleh mendahului Tanggal Pemesanan (BR-07) |
Penamaan sub-bagian.
- Field tingkat dokumen selalu berada di
6.1 General. - Dokumen yang punya baris melanjutkannya dengan
6.2 Line Items, lalu6.3 Calculationsbila ada nilai turunan. - Koleksi turunan ditambahkan sebagai sub-bagian sendiri dan dinamai tunggal:
Address,Payment, bukan Addresses atau Payments. Calculationsmemakai kolom berbeda —Field | Rumus— karena isinya nilai turunan, bukan isian.
Kamus Tipe. Dipakai apa adanya, tidak ditambah istilah baru:
| Tipe | Untuk |
|---|---|
| Teks | Teks bebas, kode, nomor dokumen |
| Angka | Bilangan bulat |
| Desimal | Bilangan pecahan, misalnya kuantitas |
| Mata Uang | Nilai uang |
| Persen | Nilai persentase |
| Enum | Pilihan dari daftar tetap; nilainya disebut di kolom Aturan |
| Boolean | Ya/tidak, aktif/nonaktif |
| Tanggal | Tanggal saja |
| Tanggal & Waktu | Tanggal beserta jamnya |
| Berkas | Lampiran atau gambar |
| Objek | Data terstruktur yang tidak perlu dipecah per field |
Ref. <Entitas> | Rujukan ke data lain: Ref. Supplier, Ref. Karyawan, Ref. Inventaris Produk Toko |
Akhiran , banyak berarti field itu menampung lebih dari satu nilai: Ref. Karyawan, banyak, Berkas, banyak.
Aturan kolom.
- Wajib berisi
Ya,Tidak,—untuk field yang ditetapkan sistem, atau syaratnya bila bersyarat:Ya, bila tipe Custom. - Default berisi nilai awal atau asal-usulnya:
Hari ini,Dibuat saat disimpan,Mengikuti kemasan terpilih. - Aturan menyebut nomor BR yang mendasarinya dalam kurung, dan hanya memuat ketentuan nilai — bukan perilaku layar.
7. UI Structure
Tujuan. Menjembatani “field apa” dengan “field itu tampak dan berperilaku bagaimana”. Section ini hanya mengatur tampilan dan interaksi; aturan isi dan nilainya tetap mengikuti Document Structure.
Isi. Paragraf pembuka, lalu sub-bagian sesuai permukaan yang dimiliki fitur tersebut. Hanya yang dipakai yang ditulis — jangan menyalin daftar sub-bagian yang tidak relevan.
Datatable
Kolom tabel daftar, urut dari kiri ke kanan seperti di layar.
| Kolom | Sortable | Contoh Nilai | Komponen |
|---|---|---|---|
| Nomor PO | Ya | PO/CBI/2026/000042 | Link |
Setiap datatable diawali kolom Pilih (checkbox dan expand toggle bawaan) dan No, lalu kolom fiturnya, dan ditutup kolom Aksi. Bila baris bisa diperluas, rincian isinya ditulis sebagai tabel Expanded Row tepat di bawahnya.
Advance Filter
Filter lanjutan beserta asal pilihannya.
| Field | Kontrol | Sumber Pilihan | Default |
|---|---|---|---|
| Supplier | Multi Select | Master Supplier, bisa dicari | Kosong |
Form & Details
Diawali tiga paragraf bertanda tebal — Buat, Ubah, Detail — yang menjelaskan susunan dan aksi tiap mode. Mode yang tidak ada dilewati. Lalu satu heading #### per bagian form, misalnya #### Umum, #### Produk — Tabel, #### Produk — Form, #### Produk — Calculations.
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| Supplier | Single Select | Master Supplier, bisa dicari | Diganti → Kontak dikosongkan |
Kolom Perilaku memakai pola <pemicu> → <akibat> dan hanya berisi perilaku layar, misalnya field yang dikosongkan atau dihitung ulang saat field lain berubah.
PDF Format
Susunan dokumen cetak, per bagian dari atas ke bawah.
| Bagian | Isi |
|---|---|
| Kop | - Perusahaan: Nama, Kontak, Alamat<br />- Dokumen: Judul, Nomor, Tanggal |
Kolom Isi boleh memuat bullet dan penekanan tebal untuk mengelompokkan isinya. Kolom yang berisi susunan tabel ditulis dipisah pipa yang di-escape: No \| Produk \| Kuantitas.
Permukaan Lain
Fitur yang bukan daftar-dan-form memakai nama yang sesuai kenyataannya, dengan kolom yang paling menjelaskan: Feed untuk daftar kronologis, Grid & Map, Sync Dialog, Lonceng, Dialog Detail.
Kamus Komponen
Dipakai di kolom Komponen, untuk hal yang hanya ditampilkan:
| Komponen | Untuk |
|---|---|
| Text | Teks biasa |
| Number | Angka |
| Date | Tanggal |
| Currency | Nilai uang berformat |
| Badge | Status atau label berwarna |
| Link | Teks yang membuka halaman lain |
| Thumbnail | Gambar kecil |
| Avatar | Foto orang |
| Accordion | Isi yang bisa dibuka-tutup, untuk nilai yang lebih dari satu |
| Action Menu | Kumpulan aksi baris |
| Checkbox | Penanda pilih |
| Expand Toggle | Pembuka baris rincian |
| Add Button | Tombol tambah di dalam sel |
Kamus Kontrol
Dipakai di kolom Kontrol, untuk hal yang bisa diisi atau dipilih:
| Kontrol | Untuk |
|---|---|
| Text Input | Isian teks satu baris |
| Textarea | Isian teks banyak baris |
| Single Select | Memilih satu dari daftar |
| Multi Select | Memilih lebih dari satu |
| Date Picker | Memilih satu tanggal |
| Date Range Picker | Memilih rentang tanggal |
| Date Time Picker | Memilih tanggal beserta jam |
| Number Input | Isian angka |
| Currency Input | Isian nilai uang |
| Percent Input | Isian persentase |
| File Uploader | Mengunggah berkas |
| Toggle | Menyalakan atau mematikan |
| Read-only | Ditampilkan, tidak bisa diubah |
Kosakata di dua kamus ini dipakai ulang, tidak ditambah per fitur. Menyebut hal yang sama dengan dua nama berbeda (dropdown vs Single Select) membuat pembaca mengira keduanya berbeda.
8. User Stories
Tujuan. Menyatakan kebutuhan per peran beserta kriteria yang membuatnya dianggap selesai — dasar pengujian dan penerimaan.
Isi. Satu heading per story, kalimat kebutuhan, lalu tabel kriteria.
### US-04 - Mengajukan PO
Sebagai PIC, saya ingin mengajukan PO, agar PO berlaku dan isinya tidak berubah lagi.
| ID | Kriteria penerimaan |
|---|---|
| AC-04.1 | Tombol Ajukan Pesanan tampil pada PO Draf ... (BR-02). |Aturan.
- Judul story adalah kegiatannya, bukan nama layar. Tanpa prioritas dan tanpa paragraf pengantar.
- Kalimat kebutuhan memakai pola
Sebagai <peran>, saya ingin <kebutuhan>, agar <manfaat>. - Nomor AC mengikuti nomor story: story
US-04memakaiAC-04.1,AC-04.2, dan seterusnya. - Satu AC berisi satu hal yang bisa diperiksa benar atau salahnya, dan menyebut nomor BR bila menegakkan aturan.
- Sebut bunyi tombol yang tampil di layar (“Ajukan Pesanan”), bukan nama aksi versi ringkas yang dipakai di Flow dan Permissions.
- Kasus khusus ditulis sebagai baris AC biasa, dengan pola
<situasi> — <perilaku yang diharapkan>. - Bila perilaku yang benar belum diputuskan, tandai
**Perlu dikonfirmasi**lalu sebutkan apa yang perlu disepakati. Ini satu-satunya teks tebal yang boleh muncul di dalam AC.
9. User Scenarios
Tujuan. Menunjukkan pemakaian nyata dari ujung ke ujung — hal yang tidak terlihat dari User Stories, karena tiap story hanya memotret satu kebutuhan.
Isi. Tabel Role | Scenario, tiga sampai empat baris.
| Role | Scenario |
|---|---|
| Staf Purchasing | Membuat PO restock mingguan ke satu supplier, menetapkan PIC, lalu mengajukan dan mencetak PDF untuk dikirim via WhatsApp |
Aturan.
- Satu baris adalah satu rangkaian langkah, bukan satu aksi. Baris yang hanya mengulang User Story dihapus.
- Sertakan minimal satu skenario yang menembus fitur lain, misalnya PO yang berlanjut ke penerimaan barang dan penagihan.
- Role memakai peran nyata di lapangan (Staf Purchasing, Owner, Admin, Auditor), bukan nama peran teknis di sistem.
10. Permissions & Actions
Tujuan. Menjawab siapa boleh melakukan apa, dan pada kondisi apa aksi itu tersedia.
10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
Lihat List PO<br />(Semua Toko) | purchase:purchase-order:list:any | — |
| Tambah Produk | purchase:purchase-order:update:store <br /> purchase:purchase-order:create:store | Toko aktif |
Aturan.
- Satu aksi per baris. Aksi tidak digabung dengan garis miring; izin yang sama boleh muncul di beberapa baris.
- Izin bertumpuk berarti DAN. Dua izin yang ditulis atas-bawah dengan
<br />keduanya wajib dimiliki. Jangan memakai tanda tambah atau kurung. - Scope dipisah baris. Versi
:any(semua toko) dan:store(toko yang ditugaskan) ditulis sebagai dua baris berbeda. - Label dua baris. Nama aksi yang panjang dipendekkan dengan keterangan di baris kedua:
Lihat List POlalu(Semua Toko). - Kondisi berisi syarat non-izin: toko aktif, pengguna adalah PIC, data belum terhubung. Isi
—bila tanpa syarat, atau jelaskan bila mewarisi izin lain (“Mengikuti izin lihat detail PO”).
10.2 Action by Status
Matriks aksi terhadap status, memakai ✓ untuk tersedia dan — untuk tidak.
| Action | Draf | Diajukan | Dibatalkan |
|---|---|---|---|
Ubah PO<br />(Data Umum) | ✓ | — | — |
Urutan dan penamaan aksinya mengikuti 10.1. Sub-bagian ini dilewati pada fitur tanpa status; bila sumbu pembedanya bukan status, pakai nama yang sesuai seperti 10.2 Action by Device.
11. Notifications
Tujuan. Mencatat kejadian di fitur ini yang memicu notifikasi, agar jelas apa yang dikirim mesin notifikasi, ke siapa, dan ke mana pengguna dibawa saat membukanya.
Isi. Satu tabel dengan kolom Kejadian | Penerima | Judul | Isi | Tujuan, satu baris per kejadian:
Kejadian— aksi atau kondisi pemicunya, dengan rujukan keBR-xxyang mengaturnya.Penerima— siapa yang menerima.Judul— teks judul persis seperti yang tampil di notifikasi.Isi— teks isi persis seperti yang tampil. Bagian yang berubah per kejadian ditulis sebagai variabel dalam kurung kurawal, misalnya{nama perangkat}.Tujuan— halaman yang dibuka saat notifikasi diklik, ditulis sebagai alamat lengkap di dalam aplikasi, misalnya/account/linked-devices; kosong bila tidak ada.
Kanal tidak ditulis: sistem otomatis mengirim ke semua kanal (kotak masuk, dalam aplikasi, dan perangkat) sesuai pengaturan pengguna di PRD Notifikasi. Pengecualian kanal ditulis di Business Rules.
Section ini wajib ada di setiap PRD. Fitur yang tidak memicu notifikasi tetap menuliskannya, cukup dengan satu kalimat: “Fitur ini tidak memicu notifikasi.” Aturan kapan notifikasi dikirim tetap ditulis di Business Rules; tabel ini hanya merangkum hasilnya.
12. Dependencies
Tujuan. Menunjukkan keterkaitan fitur ini dengan bagian lain sistem, agar perubahan di satu tempat bisa ditelusuri dampaknya.
Isi. Sampai tiga kelompok bertanda tebal, masing-masing berisi bullet:
**PRD terkait**— fitur lain yang alurnya bersinggungan, beserta alasan singkatnya.**Master data**— data acuan yang dipakai fitur ini.**Efek ke modul lain**— akibat yang ditimbulkan fitur ini di tempat lain, termasuk yang sengaja tidak terjadi (“PO tidak mengubah stok; stok bertambah saat GR diajukan”).
Kelompok yang kosong dilewati.
Penanda Implementasi
PRD memimpin, jadi sebagian isinya bisa belum ada di kode. Poin yang belum diimplementasi ditandai di akhir poin, di Business Rules, langkah Flow, baris AC, maupun baris field atau UI:
<mark>🚧 Belum: BE</mark>— backend belum.<mark>🚧 Belum: FE</mark>— frontend belum.<mark>🚧 Belum: FE + BE</mark>— keduanya belum.
Poin dianggap belum bila salah satu sisi belum. Label diperkecil saat satu sisi selesai dan dihapus saat keduanya selesai.
Template
Salin isi blok di bawah ke content/<application>/<module>/<feature>.md, lalu isi tiap section mengikuti penjelasan di atas.
Baris <!-- ... --> adalah pengingat isi; hapus setelah section tersebut terisi.
# Nama Indonesia
- Code: **MOD-FIT**
- Module: **Nama Modul**
- Type: **Transaction**
---
## 1. Overview
<!-- Paragraf 1: fitur ini apa dan posisinya dalam alur bisnis. -->
Hasil yang diharapkan: <!-- kondisi yang tercapai ketika fitur ini bekerja. -->
## 2. Problem
<!-- Paragraf: bagaimana pekerjaan ini berjalan tanpa fitur ini. --> Akibatnya:
- <!-- akibat konkret yang dirasakan orang -->
- <!-- akibat konkret yang dirasakan orang -->
## 3. Goals & Non-goals
### 3.1 Goals
- <!-- hasil yang dikejar, bukan daftar fitur -->
### 3.2 Non-goals
- <!-- yang sengaja tidak dikerjakan, beserta gantinya bila ada -->
## 4. Business Rules
Aturan bisnis adalah kumpulan ketentuan dan batasan yang berlaku untuk <!-- Nama Fitur --> di seluruh aplikasi, pada semua layar dan aksi yang melibatkannya, siapa pun yang melakukannya. Aturan ini menjadi sumber kebenaran tunggal: bila bagian lain di PRD ini tampak berbeda, aturan di sinilah yang berlaku.
- **BR-01** <!-- satu aturan utuh, bisa benar atau salah -->
- **BR-02**
## 5. Flow
### 5.1 Main Flowchart
```mermaid
flowchart TD
S([Mulai]) --> N1[1. Langkah Pertama]
N1 --> N2{2. Validasi}
N2 -->|Tidak valid| N1
N2 -->|Valid| N3(3. Status Awal)
N3 --> E([Selesai])
```
1. **Langkah Pertama** — <!-- apa yang terjadi di sistem, bukan apa yang diklik pengguna -->
2. **Validasi** — <!-- apa yang diperiksa dan apa akibat bila gagal -->
3. **Status Awal** — <!-- kondisi data setelah tersimpan dan apa yang mungkin berikutnya -->
### 5.2 Status Lifecycle
<!-- Lewati seluruh sub-bagian ini bila fitur tidak punya status. -->
```mermaid
stateDiagram-v2
[*] --> Draf
Draf --> Diajukan: Ajukan
Diajukan --> [*]
```
| Status | Keterangan | Selanjutnya |
|---|---|---|
| Draf<br />`draft` | | Diajukan |
| Diajukan<br />`submitted` | | — |
## 6. Document Structure
Bagian ini mendefinisikan isi dokumen <!-- Nama Fitur --> itu sendiri: field apa saja yang dimilikinya, tipenya, mana yang wajib, nilai awalnya, dan aturan nilainya. Ketentuan di sini berlaku di mana pun data dibuat atau diubah dan ditegakkan saat penyimpanan, terlepas dari bagaimana field itu ditampilkan.
### 6.1 General
<!-- Dokumen berbaris melanjutkan dengan 6.2 Line Items, lalu 6.3 Calculations. -->
| Field | Tipe | Wajib | Default | Aturan |
|---|---|---|---|---|
| | | | | |
## 7. UI Structure
Bagian ini mendefinisikan cara <!-- Nama Fitur --> ditampilkan dan dioperasikan: <!-- sebutkan permukaan yang ada -->. Bagian ini hanya mengatur tampilan dan interaksi; aturan isi dan nilainya tetap mengikuti Document Structure.
### 7.1 Datatable
| Kolom | Sortable | Contoh Nilai | Komponen |
|---|---|---|---|
| Pilih | — | — | Checkbox, Expand Toggle |
| No | — | 1 | Number |
| | | | |
| Aksi | — | Lihat · Ubah · Hapus | Action Menu |
### 7.2 Advance Filter
| Field | Kontrol | Sumber Pilihan | Default |
|---|---|---|---|
| | | | Kosong |
### 7.3 Form & Details
**Buat** — <!-- susunan dan aksinya -->
**Ubah** — <!-- susunan, syarat ketersediaan, dan aksinya -->
**Detail** — <!-- susunan dan aksi yang muncul sesuai status -->
#### Umum
| Field | Kontrol | Sumber Pilihan | Perilaku |
|---|---|---|---|
| | | | |
## 8. User Stories
### US-01 - Judul Kegiatan
Sebagai <!-- peran -->, saya ingin <!-- kebutuhan -->, agar <!-- manfaat -->.
| ID | Kriteria penerimaan |
|---|---|
| AC-01.1 | |
| AC-01.2 | |
## 9. User Scenarios
| Role | Scenario |
|---|---|
| | |
## 10. Permissions & Actions
### 10.1 Permission by Action
| Action | Permission | Kondisi |
|---|---|---|
| | `modul:fitur:aksi:scope` | — |
### 10.2 Action by Status
<!-- Lewati bila fitur tidak punya status. -->
| Action | Draf | Diajukan |
|---|---|---|
| | ✓ | — |
## 11. Notifications
<!-- Bila fitur tidak memicu notifikasi, ganti tabel dengan satu kalimat: Fitur ini tidak memicu notifikasi. -->
| Kejadian | Penerima | Judul | Isi | Tujuan |
|---|---|---|---|---|
| | | | | |
## 12. Dependencies
**PRD terkait**
- <!-- fitur lain yang alurnya bersinggungan, beserta alasannya -->
**Master data**
- <!-- data acuan yang dipakai fitur ini -->
**Efek ke modul lain**
- <!-- akibat yang ditimbulkan fitur ini di tempat lain -->
Referensi. Bila panduan ini terasa ambigu, lihat Purchase Order — PRD yang paling lengkap mengisi kerangka ini, dari Business Rules hingga PDF Format, dan menjadi acuan saat dokumen ini dan isinya tampak berbeda.