Versi 1

Field	Isi
Dokumen ID	VBS-LAP-030
Deskripsi	Laporan rincian penyusutan aset tahunan: nilai perolehan, persentase susut, nominal susut bulanan, jumlah bulan susut, dan total penyusutan tahun berjalan per aset
Nomor Revisi	1
Tanggal	2026-10-04
Keterangan	Dokumentasi baseline dari dokumentasi fitur demo dan kode FE

1. Ringkasan

a. In scope

• User membuka Rincian Penyusutan Aset dari menu Master, kelompok Aset.
• User memilih tahun laporan dan memfilter cabang.
• User melihat per aset: jenis aset, nama aset, nomor invoice, kuantitas, harga satuan, tanggal, total nilai perolehan, persentase susut tahunan, nominal susut bulanan, jumlah bulan susut, jumlah bulan susut sebelumnya, total susut tahun sebelumnya, dan total penyusutan tahun ini.
• User melihat riwayat jurnal penyusutan sebuah aset melalui popup pergerakan aset.
• User mengekspor laporan ke Excel, termasuk versi berbahasa Mandarin bila diminta lewat parameter halaman.

b. Catatan

c. Kesimpulan

• [FE] -
• [BE] -

2. Functional Requirement

Kode	Deskripsi
FR-01	Sistem menampilkan rincian penyusutan aset untuk satu tahun laporan
FR-02	User dapat memfilter laporan berdasarkan cabang
FR-03	Sistem menghitung nominal susut bulanan, jumlah bulan susut, dan total penyusutan tahun ini per aset
FR-04	User dapat melihat daftar jurnal penyusutan per aset
FR-05	User dengan izin Excel dapat mengekspor laporan ke Excel

3. Use Case List

Kode	Deskripsi
UC-01	Menampilkan rincian penyusutan aset per tahun
UC-02	Memfilter rincian penyusutan per cabang
UC-03	Melihat pergerakan jurnal penyusutan aset
UC-04	Mengekspor rincian penyusutan aset ke Excel

4. Use Case Scenario

UC-01 : Menampilkan rincian penyusutan aset per tahun

Aktor	User akuntansi / aset
Deskripsi	User melihat perhitungan penyusutan seluruh aset untuk tahun tertentu
Prekondisi	User sudah login, brand aktif, dan memiliki akses menu Rincian Penyusutan Aset
Alur utama	1. User membuka menu Master lalu Rincian Penyusutan Aset. 2. User memilih tahun laporan. 3. User menekan tombol tampilkan. 4. Sistem menampilkan rincian penyusutan per aset.
Alur negatif	- Jika tahun kosong, muncul alert "Periode Tidak Boleh Kosong". - Jika filter belum diterapkan, halaman menampilkan "Lengkapi filter untuk menampilkan data". - Jika data tidak ada atau permintaan gagal, muncul notifikasi "Tidak Ada Penyusutan Ditemukan pada Periode Terkait!".
Bisnis rule	- Rentang data selalu satu tahun penuh: 1 Januari sampai 31 Desember tahun terpilih. - Persentase susut tahunan diambil dari kategori aset, jika kosong dianggap 25%. - Nominal susut bulanan = harga beli per unit x kuantitas x persen susut / 1200. - Jumlah bulan susut tahun ini = 12 untuk tahun lampau, atau sampai bulan sebelum bulan berjalan untuk tahun berjalan, dimulai dari bulan mulai susut aset. - Jumlah bulan susut dibatasi sisa umur manfaat, yaitu 100 / persen susut x 12 bulan dikurangi bulan yang sudah berjalan. - Total penyusutan tahun ini = jumlah bulan susut x nominal susut bulanan.
Postkondisi	Rincian penyusutan tahunan tampil
Trigger	User menekan tombol tampilkan
Kode FR	FR-01 FR-03

UC-02 : Memfilter rincian penyusutan per cabang

Aktor	User akuntansi / aset
Deskripsi	User membatasi laporan ke cabang tertentu
Prekondisi	Halaman Rincian Penyusutan Aset terbuka
Alur utama	1. User membuka panel filter tambahan. 2. User memilih satu atau beberapa cabang. 3. User menekan tombol tampilkan. 4. Sistem menampilkan penyusutan aset untuk cabang terpilih.
Alur negatif	- Jika tidak ada penyusutan pada cabang tersebut, muncul notifikasi "Tidak Ada Penyusutan Ditemukan pada Periode Terkait!". - Jika user menekan reset, filter kembali kosong dan laporan dikosongkan.
Bisnis rule	- Filter cabang dapat multi pilihan.
Postkondisi	Rincian penyusutan cabang terpilih tampil
Trigger	User menerapkan filter cabang
Kode FR	FR-02

UC-03 : Melihat pergerakan jurnal penyusutan aset

Aktor	User akuntansi / aset
Deskripsi	User melihat jurnal penyusutan yang sudah tercatat untuk satu aset
Prekondisi	Laporan sudah tampil
Alur utama	1. User mengklik ikon mata pada kolom jenis aset. 2. Sistem membuka popup "Lihat Pergerakan Aset". 3. Popup menampilkan tanggal jurnal, nomor invoice, dan nominal penyusutan. 4. User menutup popup.
Alur negatif	- Jika aset belum memiliki jurnal penyusutan, tabel popup kosong.
Bisnis rule	- Data popup diambil dari data laporan yang sudah dimuat, tanpa permintaan baru ke server.
Postkondisi	User mengetahui riwayat jurnal penyusutan aset
Trigger	User mengklik ikon lihat
Kode FR	FR-04

UC-04 : Mengekspor rincian penyusutan aset ke Excel

Aktor	User dengan izin Excel rincian penyusutan aset
Deskripsi	User mengunduh rincian penyusutan dalam format Excel
Prekondisi	User memiliki izin Excel
Alur utama	1. User menekan tombol export Excel. 2. Jika tabel masih kosong, sistem memuat data terlebih dahulu. 3. Sistem menyusun workbook dengan kolom yang sama dengan tabel. 4. Browser mengunduh file "Laporan Rincian Penyusutan Aset.xlsx".
Alur negatif	- Jika filter belum ada, muncul alert "Silahkan Filter Terlebih dahulu data yang ingin ditampilkan". - Jika data kosong, muncul notifikasi "Data tidak ditemukan".
Bisnis rule	- Tombol tampil bila user memiliki izin excel pada #lap-rincian-penyusutan-aset. - Jika halaman dibuka dengan parameter bahasa cn, judul kolom Excel memakai bahasa Mandarin.
Postkondisi	File Excel terunduh
Trigger	User menekan tombol export Excel
Kode FR	FR-05

5. Data Flow Diagram

DFD-01 — Alur data rincian penyusutan aset

6. Sequence Diagram

SD-01 — UC-01 : Menampilkan rincian penyusutan aset per tahun

SD-02 — UC-02 : Memfilter rincian penyusutan per cabang

SD-03 — UC-03 : Melihat pergerakan jurnal penyusutan aset

SD-04 — UC-04 : Mengekspor rincian penyusutan aset ke Excel

7. Table Schema

8. API Schema

Endpoint	Status	Perubahan
POST /laporan-barang-rinci/rincian-aset-penyusutan-report	existing	-