Versi 1
| Field | Isi |
|---|---|
| Dokumen ID | VBS-LAP-029 |
| Deskripsi | Laporan kandang peternakan ayam: ringkasan recording per batch/mesin per cabang, termasuk mode perbandingan antar mesin |
| Nomor Revisi | 1 |
| Tanggal | 2026-10-04 |
| Keterangan | Dokumentasi baseline dari dokumentasi fitur demo dan kode FE |
1. Ringkasan
a. In scope
- User membuka laporan kandang dari daftar Laporan Produksi pada brand peternakan ayam.
- User memfilter periode, cabang, dan batch masuk ayam.
- User melihat recording harian per batch: umur, pakan, produksi, deplesi, penjualan, FCR, egg mass, egg weight, feed intake, dan hen day.
- User mengaktifkan tampilan perbandingan antar mesin.
- User kembali ke daftar laporan produksi.
b. Catatan
c. Kesimpulan
- [FE] -
- [BE] -
2. Functional Requirement
| Kode | Deskripsi |
|---|---|
| FR-01 | Kartu laporan kandang di hub produksi hanya tampil jika jenis usaha brand adalah Peternakan Ayam |
| FR-02 | Halaman /brand/:id/laporan-kandang menampilkan recording kandang sesuai filter periode, cabang, dan batch |
| FR-03 | Mode normal menampilkan baris per tanggal/batch dengan metrik produksi dan efisiensi |
| FR-04 | Mode perbandingan mesin menampilkan metrik bersebelahan per nama mesin |
| FR-05 | Sistem mengelompokkan hasil normal per cabang berdasarkan work center |
3. Use Case List
| Kode | Deskripsi |
|---|---|
| UC-01 | Membuka laporan kandang dari daftar produksi |
| UC-02 | Melihat laporan kandang mode normal |
| UC-03 | Melihat laporan perbandingan mesin |
4. Use Case Scenario
UC-01 : Membuka laporan kandang dari daftar produksi
| Aktor | User peternakan / produksi |
| Deskripsi | User membuka laporan kandang dari hub laporan produksi |
| Prekondisi | User sudah login; brand aktif bertipe Peternakan Ayam |
| Alur utama | 1. User membuka menu Laporan lalu tab Produksi. 2. Sistem menampilkan kartu Laporan Kandang. 3. User memilih kartu tersebut. 4. Sistem membuka halaman laporan kandang dengan pesan "Lengkapi filter untuk menampilkan data". |
| Alur negatif | - Jika jenis usaha bukan Peternakan Ayam, kartu tidak muncul di hub. - Halaman tetap dapat dibuka lewat alamat langsung tanpa cek jenis usaha di halaman. |
| Bisnis rule | - Kartu hub tidak memakai permission hash khusus kandang; cukup jenis usaha Peternakan Ayam. - Tombol kembali mengarah ke hub laporan produksi. |
| Postkondisi | Halaman laporan kandang terbuka |
| Trigger | User mengklik kartu Laporan Kandang |
| Kode FR | FR-01 |
UC-02 : Melihat laporan kandang mode normal
| Aktor | User peternakan / produksi |
| Deskripsi | User melihat recording kandang per batch dalam periode tertentu |
| Prekondisi | Halaman laporan kandang terbuka |
| Alur utama | 1. User mengisi periode dan cabang; dapat memilih batch masuk ayam. 2. User menekan tombol tampilkan. 3. Sistem menampilkan per cabang: batch, tanggal, umur hari, pakan kg, produksi kg, produksi butir, qty ayam, qty mati, qty terjual, FCR, egg mass, egg weight, feed intake, persen hen day, dan nama kandang. |
| Alur negatif | - Jika periode kosong, muncul alert "Periode Tidak Boleh Kosong". - Jika data kosong atau gagal, muncul "Data yg anda filter tidak ditemukan silahkan ganti filter". |
| Bisnis rule | - Filter memakai tanggal start produksi. - Nama cabang diambil dari work center yang terkait gudang. - Tombol Excel di filter dinonaktifkan meskipun fungsi ekspor ada di kode. |
| Postkondisi | Tabel laporan kandang mode normal tampil |
| Trigger | User menekan tombol tampilkan |
| Kode FR | FR-02 FR-03 FR-05 |
UC-03 : Melihat laporan perbandingan mesin
| Aktor | User peternakan / produksi |
| Deskripsi | User membandingkan metrik recording antar batch/mesin |
| Prekondisi | Filter periode sudah diisi |
| Alur utama | 1. User mengaktifkan opsi "Lihat Laporan Perbandingan Mesin". 2. User menekan tombol tampilkan. 3. Sistem menampilkan kolom deskripsi metrik dan satu kolom per nama mesin, mencakup ayam, pakan, hasil, dan efisiensi. |
| Alur negatif | - Jika periode kosong, muncul alert "Periode Tidak Boleh Kosong". - Jika data kosong, muncul pesan data tidak ditemukan. |
| Bisnis rule | - Mode perbandingan menambah pengelompokan group mesin pada permintaan data. - Metrik mencakup quantity awal, sold, deplesi, pakan, produksi butir/kg, FCR, feed intake, egg mass, egg weight, dan persen hen day. |
| Postkondisi | Tabel perbandingan mesin tampil |
| Trigger | User mengaktifkan perbandingan lalu menampilkan laporan |
| Kode FR | FR-04 |
5. Data Flow Diagram
DFD-01 — Alur data laporan kandang
6. Sequence Diagram
SD-01 — UC-01 : Membuka laporan kandang dari daftar produksi
SD-02 — UC-02 : Melihat laporan kandang mode normal
SD-03 — UC-03 : Melihat laporan perbandingan mesin
7. Table Schema
8. API Schema
| Endpoint | Status | Perubahan |
|---|---|---|
GET /recording-ternak/laporan-kandang | existing | - |
GET /gudang | existing | - |