Versi 1
| Field | Isi |
|---|---|
| Dokumen ID | VBS-LAP-004 |
| Deskripsi | Laporan arus kas: kas bersih per kategori aktivitas dan rincian jenis akun dalam periode tertentu, kenaikan atau penurunan kas, saldo kas awal dan akhir, serta unduh 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 arus kas dari hub laporan akuntansi
- User memilih periode tanggal (default bulan berjalan) lalu menampilkan laporan
- User melihat arus kas per kategori aktivitas, rincian nominal per jenis akun, dan kas bersih tiap kategori
- User melihat kenaikan atau penurunan kas, saldo kas awal, dan saldo kas akhir periode
- User yang berhak mengunduh laporan arus kas ke Excel lengkap dengan nama brand dan periode
- User mereset periode ke kondisi awal
b. Catatan
c. Kesimpulan
- [FE] -
- [BE] -
2. Functional Requirement
| Kode | Deskripsi |
|---|---|
| FR-01 | Sistem menghitung dan menampilkan arus kas per kategori dan jenis akun untuk periode yang dipilih |
| FR-02 | Sistem menampilkan kas bersih per kategori sebagai jumlah rincian jenis akun |
| FR-03 | Sistem menampilkan kenaikan atau penurunan kas, saldo kas awal, dan saldo kas akhir |
| FR-04 | User dengan hak akses Excel dapat mengunduh laporan arus kas |
| FR-05 | User dapat mereset periode dan mengosongkan laporan |
3. Use Case List
| Kode | Deskripsi |
|---|---|
| UC-01 | Menampilkan laporan arus kas per periode |
| UC-02 | Melihat kenaikan atau penurunan dan saldo kas |
| UC-03 | Mengunduh laporan arus kas ke Excel |
| UC-04 | Mereset periode laporan |
4. Use Case Scenario
UC-01 : Menampilkan laporan arus kas per periode
| Aktor | User brand dengan akses laporan arus kas |
| Deskripsi | User melihat arus kas per kategori aktivitas pada periode tertentu |
| Prekondisi | User sudah login dan berada di konteks brand |
| Alur utama | 1. User membuka laporan arus kas. 2. User memilih periode tanggal. 3. User menekan Lihat Laporan. 4. Sistem menampilkan loading "Sedang Mengambil Data Arus Kas". 5. Sistem menampilkan setiap kategori arus kas, rincian jenis akun dengan nominal, dan baris "Kas bersih yang diperoleh dari" kategori tersebut. |
| Alur negatif | - Jika form tidak valid, muncul alert "Cek Kembali Form Isian Anda". - Jika periode kosong, muncul alert "Periode Tidak Boleh Kosong". - Jika gagal menghitung atau data kosong, muncul notifikasi "Data yang anda filter tidak ditemukan silahkan ganti filter". |
| Bisnis rule | - Laporan hanya memakai periode, tanpa filter cabang, cluster, atau akun. - Kas bersih per kategori = jumlah nominal seluruh jenis akun di kategori itu. - Perhitungan dilakukan oleh server dengan detail per kategori. |
| Postkondisi | Laporan arus kas tampil |
| Trigger | User menekan Lihat Laporan |
| Kode FR | FR-01 FR-02 |
UC-02 : Melihat kenaikan atau penurunan dan saldo kas
| Aktor | User brand dengan akses laporan arus kas |
| Deskripsi | User melihat ringkasan perubahan kas periode |
| Prekondisi | Laporan arus kas sudah tampil |
| Alur utama | 1. User menggulir ke bagian bawah laporan. 2. Sistem menampilkan baris Kenaikan (penurunan) kas, Saldo Kas Awal, dan Saldo Kas Akhir. |
| Alur negatif | - Jika perhitungan gagal, nilai ringkasan tidak ditampilkan karena laporan kosong. |
| Bisnis rule | - Nilai kenaikan atau penurunan, saldo awal, dan saldo akhir berasal dari hasil hitung server, bukan dihitung ulang di layar. |
| Postkondisi | Ringkasan saldo kas terlihat |
| Trigger | Laporan selesai dimuat |
| Kode FR | FR-03 |
UC-03 : Mengunduh laporan arus kas ke Excel
| Aktor | User brand dengan hak akses Excel laporan arus kas |
| Deskripsi | User mengunduh laporan arus kas yang sedang tampil |
| Prekondisi | Laporan sudah ditampilkan |
| Alur utama | 1. User menekan Unduh File. 2. Sistem menyusun sheet berjudul nama brand, "Laporan Arus Kas", dan periode bulan. 3. Sistem menulis kategori, rincian jenis akun, kas bersih per kategori, kenaikan atau penurunan kas, saldo kas awal, dan saldo kas akhir. 4. Browser mengunduh "Laporan Arus Kas.xlsx". |
| Alur negatif | - Jika periode kosong, muncul alert "Periode Tidak Boleh Kosong". - Jika filter belum diterapkan, muncul alert "Silahkan Filter Terlebih dahulu data yang ingin ditampilkan". - Jika data kosong, muncul notifikasi "Data tidak ditemukan". |
| Bisnis rule | - Tombol Unduh File hanya tampil untuk user dengan permission Excel laporan arus kas. - Header kolom tanggal memakai tanggal akhir periode. |
| Postkondisi | File Excel terunduh |
| Trigger | User menekan Unduh File |
| Kode FR | FR-04 |
UC-04 : Mereset periode laporan
| Aktor | User brand dengan akses laporan arus kas |
| Deskripsi | User mengembalikan periode ke bulan berjalan |
| Prekondisi | Halaman laporan arus kas terbuka |
| Alur utama | 1. User menekan tombol reset. 2. Sistem mengembalikan periode ke bulan berjalan. 3. Laporan dikosongkan dan tampil pesan "Lengkapi filter untuk menampilkan data". |
| Alur negatif | - |
| Bisnis rule | - |
| Postkondisi | Laporan kosong dengan periode default |
| Trigger | User menekan tombol reset |
| Kode FR | FR-05 |
5. Data Flow Diagram
DFD-01 — Laporan arus kas
6. Sequence Diagram
SD-01 — UC-01 : Menampilkan laporan arus kas per periode
SD-02 — UC-02 : Melihat kenaikan atau penurunan dan saldo kas
SD-03 — UC-03 : Mengunduh laporan arus kas ke Excel
SD-04 — UC-04 : Mereset periode laporan
7. Table Schema
8. API Schema
| Endpoint | Status | Perubahan |
|---|---|---|
GET /arus-kas | existing | - |