Versi 1
| Field | Isi |
|---|---|
| Dokumen ID | VBS-LAP-028 |
| Deskripsi | Hub laporan produksi dan laporan produksi rinci: konsumsi bahan baku, biaya realisasi, dan hasil jadi per invoice produksi, lengkap dengan ekspor |
| Nomor Revisi | 1 |
| Tanggal | 2026-10-04 |
| Keterangan | Dokumentasi baseline dari dokumentasi fitur demo dan kode FE |
1. Ringkasan
a. In scope
- User membuka daftar Laporan Produksi dan hanya melihat kartu yang diizinkan.
- User membuka produksi rinci, memfilter periode, cabang, jenis SPK, bahan, dan hasil.
- User memilih mode tampilan bahan baku, biaya realisasi, atau hasil jadi.
- User melihat baris produksi dikelompokkan per cabang dan nomor invoice.
- User mengekspor produksi rinci ke Excel sesuai hak akses.
b. Catatan
c. Kesimpulan
- [FE] -
- [BE] -
2. Functional Requirement
| Kode | Deskripsi |
|---|---|
| FR-01 | Hub /brand/:id/laporan-produksi menampilkan kartu laporan sesuai izin dan jenis usaha |
| FR-02 | Produksi rinci (/produksi-rinci) menampilkan data produksi berdasarkan periode dan filter |
| FR-03 | User dapat memilih mode tampilan bahan baku, biaya realisasi, atau hasil jadi |
| FR-04 | Mode bahan baku menampilkan nama barang, varian, qty resep, qty realisasi, satuan, tipe, dan total |
| FR-05 | Mode biaya realisasi menampilkan nama biaya, nominal, dan jenis biaya |
| FR-06 | Mode hasil jadi menampilkan nama barang, varian, qty, satuan, keterangan, HPP, dan total |
| FR-07 | User dengan izin Excel dapat mengekspor produksi rinci ke file Excel multi lembar |
3. Use Case List
| Kode | Deskripsi |
|---|---|
| UC-01 | Membuka daftar laporan produksi |
| UC-02 | Melihat produksi rinci per mode tampilan |
| UC-03 | Mengekspor produksi rinci ke Excel |
4. Use Case Scenario
UC-01 : Membuka daftar laporan produksi
| Aktor | User dengan akses laporan produksi |
| Deskripsi | User memilih laporan produksi yang ingin dibuka |
| Prekondisi | User sudah login dan brand aktif |
| Alur utama | 1. User membuka menu Laporan lalu tab Produksi. 2. Sistem menampilkan kartu laporan yang diizinkan. 3. User memilih kartu Produksi Rinci. 4. Sistem membuka halaman produksi rinci dalam kondisi kosong dengan pesan "Lengkapi filter untuk menampilkan data". |
| Alur negatif | - Jika user tidak punya izin kartu, kartu tidak ditampilkan. - Jika tidak ada kartu, muncul "Tidak memiliki akses". |
| Bisnis rule | - Kartu Produksi Rinci memakai izin #lap-produksi-rinci.- Kartu Laporan Kandang hanya muncul jika jenis usaha brand adalah Peternakan Ayam (dokumen terpisah VBS-LAP-029). - Tombol kembali di produksi rinci mengarah ke hub laporan produksi. |
| Postkondisi | Halaman laporan terpilih terbuka |
| Trigger | User membuka tab Produksi pada menu Laporan |
| Kode FR | FR-01 |
UC-02 : Melihat produksi rinci per mode tampilan
| Aktor | User produksi / akuntansi |
| Deskripsi | User melihat rincian produksi dalam mode bahan baku, biaya, atau hasil jadi |
| Prekondisi | User dapat membuka halaman produksi rinci |
| Alur utama | 1. User mengisi periode dan cabang. 2. User dapat menambah filter jenis SPK, bahan, dan hasil. 3. User menekan tombol tampilkan. 4. User memilih radio mode bahan baku, biaya realisasi, atau hasil jadi. 5. Sistem menampilkan baris dikelompokkan per cabang dan nomor invoice sesuai mode. |
| Alur negatif | - Jika periode kosong, muncul alert "Periode Tidak Boleh Kosong". - Jika data kosong setelah filter, muncul "Data yg anda filter tidak ditemukan silahkan ganti filter". |
| Bisnis rule | - Mode default adalah hasil jadi. - Filter memakai tanggal start produksi. - Jenis SPK mencakup made by order, peternakan, without BOM, with BOM, dan long term. - Prop filter cluster di halaman belum diaktifkan meski disebut di dokumentasi fitur. |
| Postkondisi | Tabel produksi rinci sesuai mode tampil |
| Trigger | User menekan tombol tampilkan dan/atau mengganti mode |
| Kode FR | FR-02 FR-03 FR-04 FR-05 FR-06 |
UC-03 : Mengekspor produksi rinci ke Excel
| Aktor | User dengan izin Excel |
| Deskripsi | User mengunduh produksi rinci sebagai file Excel |
| Prekondisi | User memiliki izin #lap-produksi-rinci aksi excel |
| Alur utama | 1. User menekan tombol export Excel. 2. Sistem menyusun lembar Produksi, Bahan Baku, Biaya Realisasi, dan Hasil Jadi. 3. Browser mengunduh "Laporan Produksi Rinci.xlsx". |
| Alur negatif | - Jika periode kosong, muncul notifikasi "Periode Tidak Boleh Kosong". - Jika data belum ada, muncul "Data tidak ditemukan". |
| Bisnis rule | - Ekspor dibuat di browser dari data yang sudah dimuat. - Header file memuat nama brand dan periode. |
| Postkondisi | File Excel terunduh |
| Trigger | User menekan tombol export Excel |
| Kode FR | FR-07 |
5. Data Flow Diagram
DFD-01 — Alur data laporan produksi
6. Sequence Diagram
SD-01 — UC-01 : Membuka daftar laporan produksi
SD-02 — UC-02 : Melihat produksi rinci per mode tampilan
SD-03 — UC-03 : Mengekspor produksi rinci ke Excel
7. Table Schema
8. API Schema
| Endpoint | Status | Perubahan |
|---|---|---|
POST /laporan-produksi/produksi-rinci | existing | - |
GET /gudang | existing | - |
POST /sku/get-bulk-sku | existing | - |
GET /satuan | existing | - |