Versi 1
| Field | Isi |
|---|---|
| Dokumen ID | VBS-LAP-008 |
| Deskripsi | Laporan laba rugi dengan banyak mode: bulanan, multi periode bulanan, tahunan, kuartal, perbandingan periode bulanan dan tahunan, per cabang, per cluster, serta perbandingan antar cabang dan antar cluster, beserta hitung ulang, penelusuran ke buku besar, dan ekspor Excel |
| 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 laba rugi dari hub laporan akuntansi
- User memilih mode laporan: Bulanan, Multi Periode Bulanan, Perbandingan Periode Bulanan, Tahunan, Perbandingan Periode Tahunan, Kuartal, Cluster, Perbandingan Cluster, Cabang, serta mode perbandingan cabang, perbandingan multi cabang, dan perbandingan multi cluster bagi user yang berhak
- User memilih periode sesuai mode: satu bulan, rentang bulan maksimal 12 bulan, satu tahun, atau dua bulan atau dua tahun pembanding
- User memilih cabang atau cluster yang dianalisis atau dibandingkan
- User mengatur parameter tampilan: nomor akun, jenis rekening, atau rincian rekening
- User melihat pendapatan, harga pokok, biaya, dan laba bertingkat kelompok sampai rekening
- User menghitung ulang laba rugi bila data belum terbaru
- User membuka rincian buku besar akun dari nilai laba rugi
- User yang berhak mengekspor laba rugi ke Excel sesuai mode
- User mereset filter
b. Catatan
c. Kesimpulan
- [FE] -
- [BE] -
2. Functional Requirement
| Kode | Deskripsi |
|---|---|
| FR-01 | Sistem menampilkan laba rugi bulanan dan multi periode bulanan dengan rentang maksimal 12 bulan |
| FR-02 | Sistem menampilkan laba rugi tahunan dan per kuartal untuk satu tahun |
| FR-03 | Sistem membandingkan laba rugi dua bulan atau dua tahun |
| FR-04 | Sistem menampilkan laba rugi per cabang dan per cluster terpilih |
| FR-05 | Sistem membandingkan laba rugi dua cabang, dua cluster, multi cabang, atau multi cluster sesuai hak akses |
| FR-06 | User dapat mengatur parameter tampilan nomor akun, jenis rekening, dan rincian rekening |
| FR-07 | User dapat memaksa hitung ulang laba rugi |
| FR-08 | User dapat membuka rincian buku besar akun dari nilai laba rugi |
| FR-09 | User dengan hak akses Excel dapat mengekspor laba rugi sesuai mode |
| FR-10 | User dapat mereset filter |
3. Use Case List
| Kode | Deskripsi |
|---|---|
| UC-01 | Menampilkan laba rugi bulanan atau multi periode |
| UC-02 | Menampilkan laba rugi tahunan atau kuartal |
| UC-03 | Membandingkan laba rugi dua periode |
| UC-04 | Menampilkan laba rugi per cabang atau per cluster |
| UC-05 | Membandingkan laba rugi antar cabang atau antar cluster |
| UC-06 | Mengatur parameter tampilan akun |
| UC-07 | Menghitung ulang laba rugi |
| UC-08 | Membuka buku besar akun dari laba rugi |
| UC-09 | Mengekspor laba rugi ke Excel |
| UC-10 | Mereset filter laba rugi |
4. Use Case Scenario
UC-01 : Menampilkan laba rugi bulanan atau multi periode
| Aktor | User brand dengan akses laporan laba rugi |
| Deskripsi | User melihat laba rugi untuk satu bulan atau beberapa bulan |
| Prekondisi | User sudah login dan berada di konteks brand |
| Alur utama | 1. User memilih mode Bulanan atau Multi Periode Bulanan. 2. User memilih bulan atau rentang bulan. 3. User menekan Lihat Laporan. 4. Sistem meminta perhitungan laba rugi seluruh cabang dan cluster. 5. Sistem menampilkan nilai per bulan untuk setiap kelompok, sub kelompok, jenis rekening, dan rekening. |
| Alur negatif | - Jika rentang belum dipilih, muncul notifikasi "Periode Harus dipilih!". - Jika rentang lebih dari 12 bulan, muncul notifikasi "Laporan Laba Rugi hanya di bisa dilakukan di 12 Bulan". - Jika data kosong, tampil pesan filter tidak ditemukan. |
| Bisnis rule | - Rentang default adalah bulan berjalan. - Server dapat mengirim pesan informasi yang ditampilkan sebagai notifikasi sukses. - Laporan memuat kelompok akun 4 sampai 9. |
| Postkondisi | Laba rugi tampil |
| Trigger | User menekan Lihat Laporan |
| Kode FR | FR-01 |
UC-02 : Menampilkan laba rugi tahunan atau kuartal
| Aktor | User brand dengan akses laporan laba rugi |
| Deskripsi | User melihat laba rugi satu tahun atau per kuartal |
| Prekondisi | Halaman laporan laba rugi terbuka |
| Alur utama | 1. User memilih mode Tahunan atau Kuartal. 2. User memilih tahun. 3. User menekan Lihat Laporan. 4. Sistem menampilkan laba rugi tahunan atau empat kuartal. |
| Alur negatif | - Jika tahun belum dipilih, muncul notifikasi "Periode Harus dipilih!". - Jika hasil kosong, muncul notifikasi "Data tidak ditemukan". |
| Bisnis rule | - Mode tahunan dan kuartal memakai pemilih tahun, bukan bulan. |
| Postkondisi | Laba rugi tahunan atau kuartal tampil |
| Trigger | User menekan Lihat Laporan |
| Kode FR | FR-02 |
UC-03 : Membandingkan laba rugi dua periode
| Aktor | User brand dengan akses laporan laba rugi |
| Deskripsi | User membandingkan dua bulan atau dua tahun |
| Prekondisi | Halaman laporan laba rugi terbuka |
| Alur utama | 1. User memilih mode Perbandingan Periode Bulanan atau Perbandingan Periode Tahunan. 2. User memilih periode pertama dan kedua. 3. User menekan Lihat Laporan. 4. Sistem menampilkan kedua periode berdampingan. |
| Alur negatif | - Jika salah satu periode kosong, muncul notifikasi "Periode Harus dipilih!". |
| Bisnis rule | - Mode tahunan memakai pemilih tahun, mode bulanan memakai pemilih bulan. - Berganti mode mengosongkan periode pembanding, cabang, dan cluster. |
| Postkondisi | Perbandingan laba rugi tampil |
| Trigger | User menekan Lihat Laporan |
| Kode FR | FR-03 |
UC-04 : Menampilkan laba rugi per cabang atau per cluster
| Aktor | User brand dengan akses laporan laba rugi |
| Deskripsi | User melihat laba rugi untuk cabang atau cluster tertentu |
| Prekondisi | Halaman laporan laba rugi terbuka |
| Alur utama | 1. User memilih mode Cabang atau Cluster. 2. User memilih cabang atau cluster dan rentang bulan. 3. User menekan Lihat Laporan. 4. Sistem menampilkan laba rugi untuk cabang atau cluster tersebut. |
| Alur negatif | - Jika cabang kosong, muncul notifikasi "Cabang Harus diisi!". - Jika cluster kosong, muncul notifikasi "Cluster Produksi Harus diisi!". - Validasi periode sama dengan UC-01. |
| Bisnis rule | - Dropdown cluster memuat cluster aktif dan tidak aktif. |
| Postkondisi | Laba rugi per cabang atau cluster tampil |
| Trigger | User menekan Lihat Laporan |
| Kode FR | FR-04 |
UC-05 : Membandingkan laba rugi antar cabang atau antar cluster
| Aktor | User brand dengan permission perbandingan cabang atau cluster |
| Deskripsi | User membandingkan kinerja beberapa cabang atau cluster |
| Prekondisi | User memiliki permission mode perbandingan yang dipilih |
| Alur utama | 1. User memilih mode Perbandingan Cabang, Perbandingan Multi Cabang, Perbandingan Cluster, atau Perbandingan Multi Cluster. 2. User memilih dua cabang atau cluster, atau beberapa sekaligus untuk mode multi. 3. User memilih rentang bulan dan menekan Lihat Laporan. 4. Sistem menampilkan kolom laba rugi per cabang atau cluster. |
| Alur negatif | - Jika cabang pembanding kosong, muncul notifikasi "Cabang Harus diisi!". - Jika cluster pembanding kosong, muncul notifikasi "Cluster Harus diisi!". - Jika rentang lebih dari 12 bulan, muncul notifikasi "Laporan Laba Rugi hanya di bisa dilakukan di 12 Bulan". |
| Bisnis rule | - Mode Perbandingan Cabang hanya muncul untuk permission perbandingan cabang. - Mode Perbandingan Multi Cabang dan Multi Cluster hanya muncul untuk permission masing-masing. - Mode Perbandingan Cluster tersedia untuk semua user laporan laba rugi. |
| Postkondisi | Perbandingan antar cabang atau cluster tampil |
| Trigger | User menekan Lihat Laporan |
| Kode FR | FR-05 |
UC-06 : Mengatur parameter tampilan akun
| Aktor | User brand dengan akses laporan laba rugi |
| Deskripsi | User menentukan tingkat detail akun |
| Prekondisi | Halaman laporan laba rugi terbuka |
| Alur utama | 1. User membuka Parameter Tampilkan. 2. User mencentang nomor akun, jenis rekening, atau rincian rekening. 3. User menekan Lihat Laporan. |
| Alur negatif | - Jika user mencentang jenis rekening saat rincian rekening aktif (atau sebaliknya), pilihan lain otomatis dilepas. |
| Bisnis rule | - Default parameter adalah nomor akun dan rincian rekening. - Jenis rekening dan rincian rekening tidak dapat aktif bersamaan. |
| Postkondisi | Tampilan mengikuti parameter |
| Trigger | User mengubah parameter |
| Kode FR | FR-06 |
UC-07 : Menghitung ulang laba rugi
| Aktor | User brand dengan akses laporan laba rugi |
| Deskripsi | User memaksa perhitungan ulang laba rugi |
| Prekondisi | Filter mode sudah lengkap |
| Alur utama | 1. User menekan tombol Kalkulasi Ulang. 2. Sistem menghapus hasil hitung tersimpan di aplikasi. 3. Sistem meminta server menghitung ulang termasuk akun bernilai nol. 4. Sistem menampilkan hasil terbaru. |
| Alur negatif | - Validasi sama dengan Lihat Laporan sesuai mode. |
| Bisnis rule | - Hitung ulang mengikuti mode dan filter yang sedang aktif. |
| Postkondisi | Laba rugi terbaru tampil |
| Trigger | User menekan Kalkulasi Ulang |
| Kode FR | FR-07 |
UC-08 : Membuka buku besar akun dari laba rugi
| Aktor | User brand dengan akses laporan laba rugi |
| Deskripsi | User menelusuri asal nilai akun |
| Prekondisi | Laba rugi tampil dengan rincian rekening |
| Alur utama | 1. User menekan nilai akun. 2. Sistem membuka rincian buku besar akun di tab baru dengan periode terkait, dan cabang atau cluster bila mode perbandingan cabang atau cluster. |
| Alur negatif | - Jika baris tidak memiliki id akun, tidak ada halaman yang dibuka. |
| Bisnis rule | - Pada mode perbandingan cabang, filter cabang ikut dikirim ke rincian buku besar. |
| Postkondisi | Rincian buku besar akun terbuka |
| Trigger | User menekan nilai akun |
| Kode FR | FR-08 |
UC-09 : Mengekspor laba rugi ke Excel
| Aktor | User brand dengan hak akses Excel laporan laba rugi |
| Deskripsi | User mengunduh laba rugi sesuai mode aktif |
| Prekondisi | Laba rugi sudah tampil |
| Alur utama | 1. User menekan Export sebagai Excel. 2. Sistem mengambil data mode aktif. 3. Sistem menyusun workbook tahunan, kuartal, perbandingan periode, perbandingan cabang, perbandingan cluster, atau multi periode sesuai mode. 4. Browser mengunduh file Excel. |
| Alur negatif | - Jika filter kosong, muncul notifikasi "Gagal Print, Filter yang anda pilih tidak ditemukan!". |
| Bisnis rule | - Tombol ekspor hanya tampil untuk user dengan permission Excel laporan laba rugi. - Mode bulanan, cabang, dan cluster memakai format ekspor multi periode. |
| Postkondisi | File Excel terunduh |
| Trigger | User menekan Export sebagai Excel |
| Kode FR | FR-09 |
UC-10 : Mereset filter laba rugi
| Aktor | User brand dengan akses laporan laba rugi |
| Deskripsi | User mengembalikan filter ke kondisi awal |
| Prekondisi | Halaman laporan laba rugi terbuka |
| Alur utama | 1. User menekan tombol reset. 2. Sistem mengembalikan periode ke bulan berjalan, mengosongkan tahun, periode pembanding, cabang, dan cluster. 3. Laporan dikosongkan. |
| Alur negatif | - |
| Bisnis rule | - Setelah reset, parameter tampilan diisi nomor akun, jenis rekening, dan rincian rekening. |
| Postkondisi | Filter kembali default |
| Trigger | User menekan tombol reset |
| Kode FR | FR-10 |
5. Data Flow Diagram
DFD-01 — Laporan laba rugi
6. Sequence Diagram
SD-01 — UC-01 : Menampilkan laba rugi bulanan atau multi periode
SD-02 — UC-02 : Menampilkan laba rugi tahunan atau kuartal
SD-03 — UC-03 : Membandingkan laba rugi dua periode
SD-04 — UC-04 : Menampilkan laba rugi per cabang atau per cluster
SD-05 — UC-05 : Membandingkan laba rugi antar cabang atau antar cluster
SD-06 — UC-06 : Mengatur parameter tampilan akun
SD-07 — UC-07 : Menghitung ulang laba rugi
SD-08 — UC-08 : Membuka buku besar akun dari laba rugi
SD-09 — UC-09 : Mengekspor laba rugi ke Excel
SD-10 — UC-10 : Mereset filter laba rugi
7. Table Schema
8. API Schema
| Endpoint | Status | Perubahan |
|---|---|---|
GET /kelompok/with-includes | existing | - |
POST /calculation-request/hitung-fe | existing | - |