Peminjaman Asset Karyawan

01Informasi Dokumen

03Quick Overview

Karyawan: pilih asset gudang + keperluan + tujuan + tanggal pinjam–kembali → Ajukan Peminjaman
      │  asset_data → proses                                          status: pengajuan
      │   (atau Batalkan → semua asset → tersedia, status: dibatalkan)
      ▼
Admin: setujui / tolak tiap asset + jadwal serah terima (dalam periode pinjam)
      │  asset ditolak → tersedia                                     status: dikonfirmasi (atau ditolak bila semua ditolak)
      ▼
Karyawan: Terima Asset ─────────────► asset → dipinjam @karyawan + asset_trx_log     status: aktif
      │   (atau Batalkan → asset disetujui → tersedia, status: dibatalkan)
      ▼
Pengingat H-1 / terlambat (banner di aplikasi)
      ▼
Karyawan: Kembalikan Asset ─► header baru jenis pengembalian               status: pengajuan
      ▼
Admin: kondisi + lokasi gudang tiap asset ─► asset → tersedia / rusak @gudang pilihan admin + asset_trx_log
                                            pengembalian: selesai · peminjaman asal: selesai
      ▼
Tab Riwayat Peminjaman: peminjaman selesai + pengembaliannya tampil sebagai 1 entri

04Ringkasan Fitur

Peminjaman Asset memungkinkan karyawan meminjam asset gudang untuk jangka waktu tertentu (mis. dinas, pelatihan) dan mengembalikannya. Berbeda dengan Onboarding/Penambahan yang memindahkan asset secara tetap (terpakai), asset pinjaman berstatus dipinjam dan wajib kembali.

Alur utama: - Pengajuan oleh karyawan: memilih satu atau lebih asset yang tersedia, keperluan (Kantor/Dinas/Pelatihan/Lainnya), tujuan, tanggal pinjam dan tanggal kembali. Asset langsung dikunci. - Konfirmasi admin per asset: setiap asset disetujui atau ditolak (dengan alasan). Jika ada yang disetujui, admin menentukan jadwal serah terima yang harus berada dalam periode pinjam. - Serah terima: karyawan menekan Terima Asset setelah menerima fisik asset → status Aktif, asset tercatat dipinjam karyawan. Karyawan juga bisa Batalkan selama peminjaman masih pengajuan atau dikonfirmasi (sebelum menerima); hasilnya status Dibatalkan dan asset yang dikunci kembali tersedia. - Jatuh tempo: mulai H-1 tanggal kembali, peminjaman tampil sebagai pengingat; lewat tanggal ditandai Terlambat. - Pengembalian: karyawan mengajukan pengembalian seluruh asset pinjaman; admin memeriksa kondisi tiap asset (Normal → kembali tersedia, Rusak → status rusak di gudang). Peminjaman asal otomatis Selesai. - Riwayat (v1.6): tab Riwayat Peminjaman menampilkan peminjaman selesai beserta pengembaliannya sebagai satu entri (jumlah normal/rusak dan tanggal dikembalikan). - Halaman 4 tab (v1.6): Permintaan Peminjaman, Sedang Dipinjam (chip Semua / Jatuh Tempo / Terlambat), Pengembalian, Riwayat Peminjaman.

05Tujuan Fitur

5.1 Tujuan Bisnis (diturunkan dari kode)

• Peminjaman asset tercatat dengan keperluan, tujuan, dan periode yang jelas.
• Admin mengontrol asset mana yang boleh dipinjam dan kapan diserahkan.
• Karyawan bertanggung jawab atas asset setelah menyatakan menerima secara fisik.
• Keterlambatan pengembalian terlihat oleh karyawan dan admin.
• Kondisi asset saat kembali tercatat; asset rusak tidak kembali ke stok tersedia.

5.2 Tujuan Sistem

• Menyimpan pengajuan, keputusan per asset, jadwal serah terima, dan pengembalian.
• Mengunci asset selama proses (proses) dan selama dipinjam (dipinjam).
• Menghitung status jatuh tempo (sisa_hari, terlambat).
• Mencatat asset_trx_log saat serah terima dan saat pengembalian.
• Mengirim notifikasi di setiap perubahan status.

06Aktor

07Hak Akses

08Terminologi

09Business Rules

BR-001 — Peminjaman diajukan oleh karyawan untuk dirinya sendiri

id_karyawan diambil dari JWT; karyawan harus aktif → "Karyawan tidak ditemukan atau tidak aktif."

BR-002 — Data pengajuan wajib lengkap

keperluan (maks 255), tujuan_peminjaman (maks 255), tgl_pinjam, tgl_kembali, asset_ids (min 1, distinct) → pesan pada §24 API-009.

BR-003 — Tanggal pinjam tidak boleh lampau; tanggal kembali ≥ tanggal pinjam

tgl_pinjam after_or_equal:today, tgl_kembali after_or_equal:tgl_pinjam → "Tanggal pinjam tidak boleh sebelum hari ini." / "Tanggal kembali tidak boleh sebelum tanggal pinjam." Tidak ada batas maksimal durasi.

BR-004 — Asset harus tersedia di gudang

getLockedAssets: status_asset = tersedia & pemegang_asset = gudang (FOR UPDATE) → "Satu atau beberapa asset tidak tersedia untuk dipinjam."

BR-005 — Asset tidak boleh sedang di onboarding atau peminjaman lain

hasActiveOnboardingAsset → "…sedang diproses pada onboarding." hasActivePeminjamanAsset (peminjaman pengajuan/dikonfirmasi/aktif, item tidak ditolak) → "…sedang diproses pada peminjaman lain."

BR-006 — Asset langsung dikunci saat diajukan

asset_data.status_asset = proses.

BR-007 — Admin wajib memutuskan seluruh asset

Semua item harus diberi disetujui/ditolak → "Seluruh asset peminjaman wajib dikonfirmasi." Tolak wajib alasan → "Alasan penolakan asset wajib diisi."

BR-008 — Jadwal serah terima wajib jika ada asset disetujui dan harus dalam periode pinjam

→ "Tanggal serah terima wajib diisi." / "Jam serah terima wajib diisi." / "Tanggal serah terima harus berada dalam periode peminjaman."

BR-009 — Hasil keputusan admin

Minimal satu disetujui → dikonfirmasi; semua ditolak → ditolak dengan ket_tolak = "Seluruh asset peminjaman ditolak." Asset ditolak kembali tersedia di gudang; asset disetujui tetap proses.

BR-010 — Konfirmasi admin hanya untuk status pengajuan dan bukan milik offboarding

→ "Peminjaman asset sudah tidak menunggu konfirmasi." / "Pengembalian ini diproses melalui offboarding."

BR-011 — Terima asset hanya saat dikonfirmasi

Karyawan aktif, status dikonfirmasi, asset disetujui masih proses di gudang → asset dipinjam @karyawan, status aktif, asset_trx_log → "Peminjaman asset belum dapat diterima." / "Satu atau beberapa asset belum siap diserahterimakan."

BR-012 — Batalkan hanya saat pengajuan atau dikonfirmasi (v1.6)

Karyawan pemilik dapat membatalkan peminjaman berstatus pengajuan atau dikonfirmasi. Dari pengajuan seluruh asset item (belum diputuskan, status_item NULL) dilepas; dari dikonfirmasi hanya item disetujui (item ditolak sudah dilepas saat konfirmasi). Hanya asset yang masih proses + gudang yang diubah menjadi tersedia @gudang (asset lain tidak disentuh). Header menjadi dibatalkan (bukan lagi ditolak) dengan ket_tolak = "Dibatalkan oleh karyawan.". Tidak ada asset_trx_log karena asset tidak pernah berpindah pemegang. Status lain (aktif, selesai, ditolak, dibatalkan) → "Peminjaman asset sudah tidak dapat dibatalkan."; milik karyawan lain atau baris pengembalian → "Peminjaman asset tidak ditemukan."; karyawan nonaktif → "Karyawan tidak ditemukan atau tidak aktif."

BR-013 — Pengembalian hanya untuk peminjaman aktif, seluruh asset

Semua asset disetujui harus masih dipinjam oleh karyawan; tidak boleh ada pengembalian berjalan; tidak sedang di offboarding → "Hanya peminjaman aktif yang dapat dikembalikan." / "Satu atau beberapa asset tidak sedang dipinjam oleh karyawan." / "Pengembalian asset sedang menunggu konfirmasi." / "Asset sedang diproses pada offboarding."

BR-014 — Admin wajib mengisi kondisi dan lokasi gudang setiap asset yang dikembalikan

normal/rusak; rusak wajib keterangan → "Seluruh kondisi asset pengembalian wajib diisi." / "Keterangan kerusakan asset wajib diisi." (v1.1) Setiap item juga wajib punya id_asset_lokasi_m bertipe gudang pada company yang sama, tepat satu kali per item → "Lokasi gudang tujuan setiap asset wajib dipilih." / "Lokasi gudang tujuan tidak valid." / "Lokasi gudang tujuan asset tidak sesuai."

BR-015 — Dampak pengembalian

Normal → tersedia @gudang; Rusak → rusak @gudang + ket_rusak; keduanya di gudang pilihan admin (asset_data.id_asset_lokasi_m, item id_asset_lokasi_m_tujuan). Pengembalian selesai; peminjaman asal selesai bila tidak ada asset pinjaman yang masih dipegang.

BR-015a — Lokasi dikosongkan saat asset keluar gudang (v1.1)

Saat karyawan menerima asset pinjaman (Terima Asset), asset_data.id_asset_lokasi_m di-set NULL (kolom FK ke asset_lokasi_m; nilai '' ditolak database) karena asset tidak lagi berada di gudang.

BR-016 — Pengingat jatuh tempo

Peminjaman aktif dengan tgl_dikembalikan ≤ besok, asset masih dipegang, dan belum ada pengembalian pengajuan/dikonfirmasi → tampil di Asset Saya (karyawan) dan ringkasan admin. ⚠️ Belum ditemukan: scheduler/push otomatis.

BR-017 — Pengembalian lewat offboarding dipisahkan

Pengembalian yang dibuat oleh proses offboarding (tercatat di asset_trx_offboarding_relasi) disembunyikan dari tab, list, dan detail Pengembalian serta tidak dapat dikonfirmasi lewat menu peminjaman. Keputusan produk (v1.6): pengembalian dari offboarding sengaja tetap tampil di tab Riwayat dan pada bagian pengembalian di detail peminjaman, sehingga satu peminjaman selesai selalu menampilkan seluruh pengembaliannya.

BR-019 — Filter kondisi tab Sedang Dipinjam (v1.6)

Parameter opsional kondisi (semua | jatuh_tempo | terlambat) pada list peminjaman karyawan dan admin hanya efektif bila tab=aktif; di tab lain diabaikan. terlambat: tgl_dikembalikan < hari ini. jatuh_tempo: tgl_dikembalikan hari ini sampai besok (yang sudah terlambat tidak masuk). semua/kosong = semua peminjaman aktif. Filter diterapkan di SQL sebelum paginasi. Nilai lain → 422 "Filter kondisi peminjaman asset tidak valid." Tanpa tab/limit/offset list kembali ke respons lama non-paginasi dan kondisi diabaikan.

BR-020 — Tab Riwayat menggabungkan peminjaman dan pengembalian (v1.6)

tab=riwayat hanya berisi peminjaman selesai, urut tgl_update desc lalu id desc, paginasi sama dengan tab lain. Tiap item memuat pengembalian[] (hanya pengembalian selesai milik peminjaman dan karyawan yang sama, satu query per halaman). Detail peminjaman memuat pengembalian[] untuk semua status pengembalian (urut tgl_input asc). riwayat sengaja tidak ada di filters statis.

BR-018 — Penomoran

ID header/item id_company + YYYYMM + 3 digit; no_trx = KRY05-YYYYMMNNN (sequence yang sama untuk peminjaman & pengembalian).

10Business Flow

1. Karyawan: Asset Saya → Peminjaman → (+) Tambah Peminjaman Asset
   → Pilih Asset (Tambah Asset) → Pilih Keperluan → Tujuan Peminjaman → Tanggal Pinjam–Kembali
   → Ajukan Peminjaman                         [pengajuan · asset proses · notif admin]
2. Admin: Asset Karyawan → Peminjaman → tab Permintaan Peminjaman (chip Pengajuan) → Detail
   → Setujui / Tolak tiap asset (+ alasan) → Konfirmasi
   → Sheet "Konfirmasi Peminjaman Asset": Jadwal Serah Terima + Jam + Catatan → Submit
                                               [dikonfirmasi / ditolak · notif karyawan]
3. Karyawan: banner / Detail → "Siap untuk meminjam Asset?"
   → Terima Asset   [aktif · asset dipinjam · asset_trx_log · notif admin]
   → Batalkan       [dibatalkan "Dibatalkan oleh karyawan." · asset tersedia · notif admin]
      (Batalkan juga tersedia sejak status pengajuan, sebelum admin memutuskan)
4. H-1 tanggal kembali → pengingat jatuh tempo; lewat tanggal → "Terlambat"
5. Karyawan: Detail peminjaman aktif → Kembalikan Asset
                                               [header pengembalian: pengajuan · notif admin]
6. Admin: Peminjaman → tab Pengembalian → Detail → Normal / Rusak tiap asset → Konfirmasi
                                               [pengembalian selesai · asset tersedia/rusak · asset_trx_log
                                                · peminjaman asal selesai · notif karyawan]
7. Riwayat: tab Riwayat Peminjaman menampilkan peminjaman selesai + ringkasan pengembaliannya

11Flow Berdasarkan Role

11.1 Karyawan

1. Asset Saya → menu Peminjaman → halaman Peminjaman Asset dengan 4 tab: Permintaan Peminjaman (chip Pengajuan, Dikonfirmasi, Ditolak, Dibatalkan), Sedang Dipinjam (chip Semua, Jatuh Tempo, Terlambat), Pengembalian (chip Pengajuan, Selesai) dan Riwayat Peminjaman (tanpa chip).
2. Tekan + → Tambah Peminjaman Asset → Ajukan Peminjaman.
3. Selama masih Menunggu Konfirmasi: detail menyediakan Batalkan. Setelah admin mengonfirmasi: banner di Asset Saya / detail → Terima Asset atau Batalkan.
4. Selama aktif: kartu peminjaman aktif di Asset Saya, pengingat jatuh tempo, label Terlambat bila lewat.
5. Kembalikan Asset di detail peminjaman aktif → pantau di tab Pengembalian; setelah selesai peminjaman pindah ke tab Riwayat.

11.2 Admin Asset

1. Asset Karyawan → aksi Peminjaman (juga panel ringkasan "perlu diproses" dan "jatuh tempo").
2. Tab Permintaan Peminjaman → chip Pengajuan → detail → Setujui/Tolak per asset → Konfirmasi → isi jadwal → Submit.
3. Tab Pengembalian → chip Pengajuan → detail → Normal/Rusak per asset → Konfirmasi.
4. Tab Sedang Dipinjam (chip Jatuh Tempo / Terlambat) memantau peminjaman aktif; tab Riwayat Peminjaman (read-only) menelusuri peminjaman yang sudah selesai.

11.3 Approver

Dijalankan Admin Asset (§11.2 langkah 2).

11.4 System

Lock company, penomoran, penguncian/pelepasan asset, validasi jadwal dalam periode, perhitungan sisa_hari/terlambat/dapat_dikembalikan, asset_trx_log, penutupan peminjaman asal, notifikasi setelah commit.

12Flow Diagram

flowchart TD
    A[Karyawan ajukan peminjaman] --> B{Validasi}
    B -->|Gagal| X[Pesan error]
    B -->|OK| C[status pengajuan, asset proses, notif admin]
    C --> D{Admin putuskan per asset}
    C -->|Karyawan Batalkan| H0[status dibatalkan, semua asset tersedia, notif admin]
    D -->|Semua ditolak| E[status ditolak, asset tersedia, notif karyawan]
    D -->|Ada yang disetujui + jadwal| F[status dikonfirmasi, asset ditolak tersedia, notif karyawan]
    F --> G{Karyawan}
    G -->|Batalkan| H[status dibatalkan, asset disetujui tersedia, notif admin]
    G -->|Terima Asset| I[status aktif, asset dipinjam, asset_trx_log, notif admin]
    I --> J{Tanggal kembali}
    J -->|H-1 atau lewat| K[Pengingat jatuh tempo / Terlambat]
    J --> L[Karyawan: Kembalikan Asset]
    K --> L
    L --> M[Header pengembalian status pengajuan, notif admin]
    M --> N[Admin isi kondisi dan pilih lokasi gudang tiap asset]
    N --> O[Asset tersedia atau rusak di gudang, asset_trx_log]
    O --> P[Pengembalian selesai, peminjaman asal selesai, notif karyawan]
    P --> Q[Tab Riwayat: peminjaman selesai + pengembalian]

13Sequence Diagram

13.1 Pengajuan sampai aktif

sequenceDiagram
    actor K as Karyawan
    actor A as Admin
    participant M as Mobile
    participant CK as AssetKaryawanPeminjaman_c
    participant CA as AssetAdminPeminjaman_c
    participant P as AssetPeminjamanKaryawan_m
    participant DB
    participant N as AssetNotification

    K->>M: Pilih asset, keperluan, tujuan, tanggal, Ajukan
    M->>CK: POST /asset/karyawan/peminjaman
    CK->>P: store()
    P->>DB: lock company, cek karyawan, asset tersedia, tidak aktif
    P->>DB: INSERT header + item, UPDATE asset_data proses
    CK->>N: peminjaman.diajukan (admin)
    A->>M: Setujui/Tolak per asset, isi jadwal, Submit
    M->>CA: POST /asset/peminjaman-karyawan/{id}/konfirmasi
    CA->>P: konfirmasiAdmin()
    P->>DB: UPDATE item keputusan, UPDATE header dikonfirmasi + jadwal
    P->>DB: UPDATE asset_data ditolak menjadi tersedia
    CA->>N: peminjaman.disetujui (karyawan)
    K->>M: Terima Asset
    M->>CK: POST /asset/karyawan/peminjaman/{id}/terima
    CK->>P: terimaKaryawan()
    P->>DB: UPDATE asset_data dipinjam @karyawan, header aktif
    P->>DB: INSERT asset_trx_log peminjaman_karyawan
    CK->>N: peminjaman.diterima (admin)

13.2 Pengembalian

sequenceDiagram
    actor K as Karyawan
    actor A as Admin
    participant M as Mobile
    participant CK as AssetKaryawanPeminjaman_c
    participant CA as AssetAdminPengembalian_c
    participant P as AssetPeminjamanKaryawan_m
    participant DB
    participant N as AssetNotification

    K->>M: Kembalikan Asset
    M->>CK: POST /asset/karyawan/peminjaman/{id}/pengembalian
    CK->>P: ajukanPengembalianKaryawan()
    P->>DB: cek aktif, asset masih dipinjam, tidak ada pengembalian/offboarding
    P->>DB: INSERT header pengembalian (id_peminjaman_asal) + item
    CK->>N: pengembalian.diajukan (admin)
    A->>M: Isi Normal/Rusak per asset, Konfirmasi
    M->>CA: POST /asset/pengembalian-karyawan/{id}/konfirmasi
    CA->>P: konfirmasiPengembalianAdmin()
    P->>DB: UPDATE item, UPDATE asset_data tersedia atau rusak @gudang, id_asset_lokasi_m
    P->>DB: INSERT asset_trx_log pengembalian_karyawan
    P->>DB: UPDATE pengembalian selesai, peminjaman asal selesai
    CA->>N: pengembalian.dikonfirmasi (karyawan)

13.3 Pembatalan oleh karyawan (v1.6)

sequenceDiagram
    actor K as Karyawan
    participant M as Mobile
    participant CK as AssetKaryawanPeminjaman_c
    participant P as AssetPeminjamanKaryawan_m
    participant DB
    participant N as AssetNotification

    K->>M: Batalkan (status pengajuan atau dikonfirmasi)
    M->>CK: POST /asset/karyawan/peminjaman/{id}/batalkan
    CK->>P: batalkanKaryawan()
    P->>DB: lock company, header milik karyawan FOR UPDATE
    P->>DB: cek status pengajuan atau dikonfirmasi, karyawan aktif
    P->>DB: UPDATE asset_data proses + gudang menjadi tersedia (item pengajuan: semua, dikonfirmasi: disetujui)
    P->>DB: UPDATE header dibatalkan, ket_tolak
    CK->>N: peminjaman.dibatalkan (admin)

14Status Transaksi

Kolom status (enum status_peminjaman: pengajuan, dikonfirmasi, ditolak, aktif, selesai, dibatalkan (v1.6, via SQL manual); default pengajuan). Di API dikirim sebagai status_approval. Enum ini dipakai bersama baris pengembalian, tetapi kode hanya memakai dibatalkan untuk peminjaman.

14.1 Peminjaman (jenis_status = peminjaman)

14.2 Pengembalian (jenis_status = pengembalian)

14.3 Status item (status_item, enum approval_item)

Migrasi 2026_09_17_000009: nilai lama 1=pengajuan, 2=dikonfirmasi, 3=ditolak, 4=aktif (peminjaman) / selesai (pengembalian).

15State Transition

stateDiagram-v2
    [*] --> pengajuan: Ajukan Peminjaman (Karyawan)
    pengajuan --> dikonfirmasi: Konfirmasi, ada asset disetujui (Admin)
    pengajuan --> ditolak: Konfirmasi, semua ditolak (Admin)
    dikonfirmasi --> aktif: Terima Asset (Karyawan)
    pengajuan --> dibatalkan: Batalkan (Karyawan)
    dikonfirmasi --> dibatalkan: Batalkan (Karyawan)
    aktif --> selesai: Pengembalian dikonfirmasi (Admin)
    ditolak --> [*]
    dibatalkan --> [*]
    selesai --> [*]

Status asset_data: | Dari | Ke | Trigger | |---|---|---| | tersedia @gudang | proses | Ajukan peminjaman | | proses | tersedia @gudang | Asset ditolak admin / peminjaman dibatalkan karyawan (pengajuan: semua item; dikonfirmasi: item disetujui) | | proses @gudang | dipinjam @karyawan | Terima Asset | | dipinjam @karyawan | tersedia @gudang | Pengembalian, kondisi normal | | dipinjam @karyawan | rusak @gudang | Pengembalian, kondisi rusak |

16Struktur Database

17Relasi Database

erDiagram
    ASSET_TRX_PEMINJAMAN_KARYAWAN ||--o{ ASSET_TRX_PEMINJAMAN_KARYAWAN_ITEM : "id_asset_trx_peminjaman"
    ASSET_TRX_PEMINJAMAN_KARYAWAN |o--o{ ASSET_TRX_PEMINJAMAN_KARYAWAN : "id_peminjaman_asal (pengembalian)"
    ASSET_DATA ||--o{ ASSET_TRX_PEMINJAMAN_KARYAWAN_ITEM : "id_asset_data"
    DATA_KARYAWAN ||--o{ ASSET_TRX_PEMINJAMAN_KARYAWAN : "id_karyawan (logis)"
    ASSET_DATA ||--o{ ASSET_TRX_LOG : "id_asset_data"
    ASSET_TRX_PEMINJAMAN_KARYAWAN ||--o{ ASSET_TRX_LOG : "id_transaksi (logis)"
    ASSET_TRX_PEMINJAMAN_KARYAWAN ||--o| ASSET_TRX_OFFBOARDING_RELASI : "id_tabel (logis)"

    ASSET_TRX_PEMINJAMAN_KARYAWAN {
        varchar id_asset_trx_peminjaman_karyawan PK
        varchar no_trx
        date tgl_peminjaman
        date tgl_dikembalikan
        varchar keperluan
        varchar id_karyawan
        enum jenis_status
        varchar id_peminjaman_asal FK
        enum status
        varchar id_company
    }
    ASSET_TRX_PEMINJAMAN_KARYAWAN_ITEM {
        varchar id_asset_trx_peminjaman_item PK
        varchar id_asset_trx_peminjaman FK
        varchar id_asset_data FK
        enum status_item
        varchar ket_tolak
    }
    ASSET_DATA {
        varchar id_asset_data PK
        enum status_asset
        enum pemegang_asset
        varchar id_pemegang_asset
    }
    ASSET_TRX_LOG {
        varchar id_asset_trx_log PK
        varchar id_asset_data FK
        enum jenis_log
        varchar id_transaksi
    }

Semua JOIN mencocokkan id_company. id_peminjaman_asal memiliki ref di DBML (self-reference).

18Data Dictionary

18.1 asset_trx_peminjaman_karyawan

18.2 asset_trx_peminjaman_karyawan_item

18.3 asset_data (field yang dipakai)

status_asset (tersedia → proses → dipinjam → tersedia/rusak), pemegang_asset (gudang ↔ karyawan), id_pemegang_asset, id_asset_lokasi_m (lokasi gudang; dikosongkan saat dipinjam, diisi saat kembali), ket_rusak (diisi saat kembali rusak), kondisi_awal (disalin ke log), nama_asset, kode_asset, merek, deskripsi, tgl_update, user_update.

18.4 asset_trx_log

19Database Index

Dibuat migration 2026_09_17_000006, dibuat ulang 2026_09_17_000009. Index tidak berubah di v1.6 (SQL dibatalkan tidak menyentuh index). Filter kondisi (tgl kembali) dan urutan tab Riwayat (tgl_update) tidak memiliki index khusus (⚠️ belum diukur). Pencarian hasActivePeminjamanAsset/hasActivePengembalianAsset berdasarkan atpki.id_asset_data tidak diawali kolom index (⚠️ belum diukur).

20Backend Architecture

RouteAsset.php (prefix /asset, jwt.api + jwt.ctx)
   ↓
AssetAdminPeminjaman_c + AssetAdminPengembalian_c (admin) / AssetKaryawanPeminjaman_c (karyawan; terima & batalkan lewat prosesSerahTerimaPeminjaman)
   ↓ validateRequest + accessError
AssetPeminjamanKaryawan_m ← Asset_m (lock, sequence, getLockedAssets, findActiveKaryawan, findAssetAdmin, hasActiveOnboardingAsset)
   ↓                      ← AssetOffboardingKaryawan_m::hasActiveOffboardingAsset
DB::transaction (retry 3)
   ↓
ApiResponse + AssetNotification (setelah commit)

21Backend Business Logic

21.1 Ajukan — store

Lock → karyawan aktif → getLockedAssets (tersedia + gudang) → tidak aktif di onboarding/peminjaman → tgl_kembali ≥ tgl_pinjam → ID + KRY05-… → INSERT header (pengajuan, jadwal kosong) → INSERT item (status_item NULL) → UPDATE asset proses → notif peminjaman.diajukan. Response 201.

21.2 Konfirmasi admin — konfirmasiAdmin

Lock → admin → header peminjaman FOR UPDATE → bukan milik offboarding → status pengajuan → semua item diputuskan (tolak wajib alasan) → UPDATE item → bila ada disetujui: jadwal wajib, format valid, di dalam periode pinjam → UPDATE header (dikonfirmasi/ditolak, jadwal atau nol, ket_tolak, user_approval, tgl_approval) → asset ditolak → tersedia @gudang → notif peminjaman.disetujui/ditolak. Response 200 (+jumlah_disetujui, jumlah_ditolak).

21.3 Terima — terimaKaryawan

Lock → header milik karyawan FOR UPDATE → status dikonfirmasi → karyawan aktif → item disetujui → asset harus proses @gudang → UPDATE asset dipinjam @karyawan (id_asset_lokasi_m = NULL) → header aktif → INSERT asset_trx_log peminjaman_karyawan → notif peminjaman.diterima.

21.4 Batalkan — batalkanKaryawan (v1.6)

Lock company → header milik karyawan FOR UPDATE (lockedEmployeeHeader, hanya jenis_status = peminjaman) → status harus pengajuan atau dikonfirmasi → karyawan aktif → ambil asset item: dari pengajuan semua item dengan status_item NULL, dari dikonfirmasi item disetujui (FOR UPDATE) → UPDATE asset_data menjadi tersedia @gudang (id_pemegang_asset = '') hanya yang masih proses + gudang → header dibatalkan, ket_tolak = "Dibatalkan oleh karyawan.", tgl_update, user_update → notif peminjaman.dibatalkan. Tidak ada asset_trx_log. Controller: batalkanPeminjamanSaya → prosesSerahTerimaPeminjaman($diterima = false). Response 200.

21.5 Ajukan pengembalian — ajukanPengembalianKaryawan

Lock → peminjaman milik karyawan aktif → item disetujui → semua asset masih dipinjam oleh karyawan → tidak ada pengembalian pengajuan/dikonfirmasi → tidak di offboarding → INSERT header jenis_status = pengembalian, id_peminjaman_asal, salinan periode/keperluan, pengajuan → INSERT item (salinan item disetujui, status_item NULL) → notif pengembalian.diajukan. Response 201.

21.6 Konfirmasi pengembalian — konfirmasiPengembalianAdmin

Lock → admin → header pengembalian pengajuan → peminjaman asal ada & aktif → semua item diisi kondisi + lokasi gudang (resolveItemLocations) → asset masih dipinjam oleh karyawan → per item: UPDATE item (disetujui = normal / ditolak = rusak + keterangan, id_asset_lokasi_m_tujuan), UPDATE asset (tersedia/rusak @gudang, id_asset_lokasi_m pilihan admin, ket_rusak), siapkan asset_trx_log pengembalian_karyawan → INSERT log → header pengembalian selesai (+user_approval, tgl_approval) → bila tidak ada asset pinjaman yang masih dipegang: peminjaman asal selesai → notif pengembalian.dikonfirmasi. Response 200 (+jumlah_normal, jumlah_rusak).

21.7 Query baca

• Options: asset tersedia @gudang yang tidak ada di peminjaman berjalan (item tidak ditolak) + daftar keperluan.
• List peminjaman: tab Permintaan/Sedang Dipinjam tidak menampilkan selesai, dan aktif hanya jika asset masih dipegang karyawan. Filter tab: pengajuan, dikonfirmasi, ditolak, aktif, dibatalkan, riwayat (v1.6). Tab tanpa nilai (hanya limit/offset) tidak memfilter status, kecuali selesai tetap disembunyikan.
• Kondisi (v1.6): applyKondisiAktifFilter hanya dipanggil bila tab=aktif; terlambat = tgl_dikembalikan < hari ini, jatuh_tempo = hari ini sampai besok; diterapkan di query SQL sebelum limit+1/offset.
• Riwayat (v1.6): peminjamanQuery(includeSelesai) + filter status = selesai, reorder() ke tgl_update desc, id desc; attachRiwayatPengembalian mengambil pengembalian selesai untuk seluruh id di halaman dengan satu query (JOIN item, SUM normal/rusak) dan hanya menempelkan yang id_karyawan-nya sama dengan peminjaman. Pengembalian offboarding tidak dikecualikan.
• Detail peminjaman (v1.6): key pengembalian dari pengembalianForDetail (semua status, urut tgl_input asc, id_karyawan sama) yang memanggil getDetail(..., includeOffboarding = true) per pengembalian.
• List pengembalian: mengecualikan pengembalian milik offboarding (tab/list/detail Pengembalian).
• Detail: menghitung terlambat, tgl_diterima (= tgl_update saat aktif), dapat_dikembalikan (hanya untuk karyawan).
• Jatuh tempo: aktif, tgl_dikembalikan ≤ besok, asset masih dipegang, belum ada pengembalian berjalan; sisa_hari negatif = terlambat.

22Dampak terhadap asset_data

23API Documentation

Terkait: GET /asset/karyawan/onboarding (Asset Saya: peminjaman[], jatuh_tempo[], peminjaman_aktif[]) dan GET /asset/summary (peminjaman_perlu_proses, peminjaman_pending, jatuh_tempo_jumlah, jatuh_tempo). Tolak pengembalian dan perpanjangan: ⚠️ Belum ditemukan. (Batalkan pengajuan tersedia sejak v1.6.)

24Detail Setiap API

Header umum: Authorization: Bearer <token>, Content-Type: application/json, Accept, locale, versi-app. Format response { code, message, data }.

API-001 / API-008 — List Peminjaman

GET /asset/peminjaman-karyawan?tab=pengajuan&limit=20&offset=0          (admin)
GET /asset/karyawan/peminjaman?tab=aktif&kondisi=terlambat&limit=20&offset=0   (karyawan)
GET /asset/karyawan/peminjaman?tab=riwayat&limit=20&offset=0            (karyawan)

Tanpa tab, limit, dan offset respons berupa array (non-paginasi) dan kondisi diabaikan. Kegagalan validasi: HTTP 422, message "Parameter daftar peminjaman asset tidak valid.", errors.kondisi = ["Filter kondisi peminjaman asset tidak valid."] (EN: "Invalid asset loan condition filter."), errors.tab = ["Filter peminjaman asset tidak valid."].

{
  "code": "SUCCESS",
  "message": "Data peminjaman asset berhasil ditemukan.",
  "data": {
    "filters": [
      {"value": "pengajuan", "label": "Pengajuan"},
      {"value": "dikonfirmasi", "label": "Dikonfirmasi"},
      {"value": "ditolak", "label": "Ditolak"},
      {"value": "aktif", "label": "Aktif"},
      {"value": "dibatalkan", "label": "Dibatalkan"}
    ],
    "records": [
      {
        "id": "CMP001202609007",
        "no_trx": "KRY05-202609007",
        "tgl_pengajuan": "2026-09-26",
        "keperluan": "dinas",
        "tujuan_peminjaman": "Presentasi klien di Surabaya",
        "tgl_pinjam": "2026-09-28",
        "tgl_kembali": "2026-10-02",
        "tgl_serah_terima": "2026-09-28",
        "jam_serah_terima": "08:30:00",
        "keterangan_serah_terima": "Ambil di ruang IT",
        "ket_tolak": "",
        "id_karyawan": "KRY0003",
        "nik_karyawan": "EMP-003",
        "nama_karyawan": "Andi Contoh",
        "jenis_status": "peminjaman",
        "id_peminjaman_asal": "",
        "status_approval": "aktif",
        "status_label": "Aktif",
        "tab": "aktif",
        "jumlah_asset": 1,
        "tgl_diterima": "2026-09-28",
        "terlambat": false
      }
    ],
    "pagination": {"limit": 20, "offset": 0, "next_offset": 1, "has_more": false}
  }
}

filters sengaja tidak memuat riwayat (tab Riwayat punya tab utama sendiri di mobile).

Tab riwayat (v1.6). Hanya peminjaman selesai (company login; karyawan login untuk endpoint karyawan), urut tgl_update desc lalu id desc, paginasi limit+1 tanpa COUNT. Setiap record memuat field di atas plus pengembalian[] (urut tgl_approval asc; hanya pengembalian selesai milik peminjaman dan karyawan yang sama; satu query per halaman, tanpa N+1). Pengembalian yang berasal dari offboarding ikut ditampilkan (keputusan produk).

{
  "id": "CMP001202610001",
  "no_trx": "KRY05-202610001",
  "status_approval": "selesai",
  "status_label": "Selesai",
  "tab": "selesai",
  "jumlah_asset": 2,
  "tgl_diterima": "",
  "terlambat": false,
  "pengembalian": [
    {"id": "CMP001202610002", "no_trx": "KRY05-202610002", "tgl_selesai": "2026-10-28", "jumlah_normal": 0, "jumlah_rusak": 1}
  ]
}

(field header lain sama dengan contoh di atas). tgl_selesai = tanggal tgl_approval pengembalian ("" bila kosong); jumlah_normal = item disetujui, jumlah_rusak = item ditolak.

API-002 / API-010 — Detail Peminjaman

GET /asset/peminjaman-karyawan/{id}        (admin)
GET /asset/karyawan/peminjaman/{id}        (karyawan, hanya miliknya)

Field sama dengan record list (tanpa id_karyawan, nik/nama di dalam karyawan) ditambah:

{
  "dapat_dikembalikan": true,
  "karyawan": {"nik": "EMP-003", "nama_karyawan": "Andi Contoh", "cabang": "Kantor Pusat", "divisi": "Sales", "jabatan": "Staff Sales"},
  "assets": [
    {
      "id_item": "CMP001202609021",
      "id_asset_data": "CMP00120260100009",
      "kode_asset": "PRJ-0002",
      "nama_asset": "Proyektor Mini",
      "deskripsi": "Kabel HDMI, tas",
      "kategori_asset": "Proyektor",
      "merek": "MerekY",
      "status_item": "disetujui",
      "ket_tolak": "",
      "id_asset_lokasi_m_tujuan": "",
      "nama_lokasi_tujuan": ""
    }
  ],
  "pengembalian": [
    {
      "id": "CMP001202610002",
      "no_trx": "KRY05-202610002",
      "status_approval": "selesai",
      "status_label": "Selesai",
      "tgl_pengajuan": "2026-10-28",
      "tgl_selesai": "2026-10-28",
      "assets": [
        {
          "id_item": "CMP001202610003",
          "id_asset_data": "CMP00120260100009",
          "nama_asset": "Proyektor Mini",
          "kondisi": "rusak",
          "keterangan_kerusakan": "Lensa tergores",
          "lokasi_tujuan": "Gudang Servis"
        }
      ]
    }
  ]
}

dapat_dikembalikan hanya bernilai true pada endpoint karyawan. 404: "Peminjaman asset tidak ditemukan."

pengembalian[] (v1.6) hanya ada pada detail peminjaman (bukan detail pengembalian), boleh kosong, berisi semua status pengembalian milik peminjaman itu (urut tgl_input asc, id_karyawan sama dengan peminjaman). tgl_selesai berisi tanggal tgl_approval hanya bila status selesai, selain itu "". assets[].kondisi: normal (dari disetujui), rusak (dari ditolak), selain itu ""; keterangan_kerusakan = ket_tolak item; lokasi_tujuan = nama lokasi gudang atau "". Pengembalian dari offboarding ikut tampil. Backend memanggil getDetail per pengembalian (RISK-012).

API-003 — Konfirmasi Peminjaman (Admin)

POST /asset/peminjaman-karyawan/{id}/konfirmasi

{
  "items": [
    {"id_item": "CMP001202609021", "status_item": "disetujui"},
    {"id_item": "CMP001202609022", "status_item": "ditolak", "ket_tolak": "Sedang dijadwalkan servis"}
  ],
  "tgl_serah_terima": "2026-09-28",
  "jam_serah_terima": "08:30",
  "keterangan_serah_terima": "Ambil di ruang IT"
}

Database impact:

UPDATE asset_trx_peminjaman_karyawan_item (status_item, ket_tolak)
UPDATE asset_trx_peminjaman_karyawan (status, jadwal, ket_tolak, user_approval, tgl_approval)
UPDATE asset_data (item ditolak → tersedia @gudang)
INSERT notif_data

{ "code": "UPDATED", "message": "Peminjaman asset berhasil dikonfirmasi.",
  "data": { "id": "CMP001202609007", "no_trx": "KRY05-202609007", "status_approval": "dikonfirmasi",
            "status_label": "Dikonfirmasi", "tab": "dikonfirmasi", "jumlah_disetujui": 1, "jumlah_ditolak": 1 } }

Semua ditolak: "Peminjaman asset berhasil ditolak.", status_approval: ditolak. 422: "Peminjaman asset tidak ditemukan.", "Pengembalian ini diproses melalui offboarding.", "Peminjaman asset sudah tidak menunggu konfirmasi.", "Seluruh asset peminjaman wajib dikonfirmasi.", "Tanggal/Jam serah terima wajib diisi.", "Format jadwal serah terima tidak valid.", "Tanggal serah terima harus berada dalam periode peminjaman." 500: "Terjadi kesalahan saat mengonfirmasi peminjaman asset."

API-004 / API-014 — List Pengembalian

GET /asset/pengembalian-karyawan?tab=pengajuan     (admin)
GET /asset/karyawan/pengembalian?tab=selesai       (karyawan)

tab: pengajuan (pengajuan/dikonfirmasi) | selesai (ditolak/selesai). Filters: Pengajuan, Selesai. Record sama dengan API-001 dengan jenis_status = pengembalian dan id_peminjaman_asal terisi.

API-005 / API-015 — Detail Pengembalian

GET /asset/pengembalian-karyawan/{id}
GET /asset/karyawan/pengembalian/{id}

Struktur seperti API-002; assets[].status_item bernilai normal/rusak (dipetakan dari disetujui/ditolak), ket_tolak = keterangan kerusakan. 404: "Pengembalian asset tidak ditemukan."

API-006 — Konfirmasi Pengembalian (Admin)

POST /asset/pengembalian-karyawan/{id}/konfirmasi

{
  "items": [
    {"id_item": "CMP001202610003", "kondisi": "rusak", "id_asset_lokasi_m": "CMP001202610001", "keterangan_kerusakan": "Lensa tergores"}
  ]
}

Database impact:

UPDATE asset_trx_peminjaman_karyawan_item (status_item, ket_tolak, id_asset_lokasi_m_tujuan)
UPDATE asset_data (tersedia / rusak @gudang, id_asset_lokasi_m, ket_rusak)
INSERT asset_trx_log (pengembalian_karyawan)
UPDATE asset_trx_peminjaman_karyawan (pengembalian → selesai; peminjaman asal → selesai)
INSERT notif_data

{ "code": "UPDATED", "message": "Pengembalian asset berhasil dikonfirmasi.",
  "data": { "id": "CMP001202610001", "no_trx": "KRY05-202610001", "jenis_status": "pengembalian",
            "id_peminjaman_asal": "CMP001202609007", "status_approval": "selesai", "status_label": "Selesai",
            "tab": "selesai", "jumlah_normal": 0, "jumlah_rusak": 1 } }

422: "Pengembalian asset tidak ditemukan.", "Pengembalian asset sudah tidak menunggu konfirmasi.", "Peminjaman asal pengembalian tidak ditemukan.", "Peminjaman asal pengembalian tidak ditemukan atau sudah tidak aktif.", "Seluruh kondisi asset pengembalian wajib diisi.", "Satu atau beberapa asset tidak sedang dipinjam oleh karyawan.", "Lokasi gudang tujuan setiap asset wajib dipilih.", "Lokasi gudang tujuan tidak valid.", "Lokasi gudang tujuan asset tidak sesuai." 500: "Terjadi kesalahan saat mengonfirmasi pengembalian asset."

Detail pengembalian admin (API-005) mulai v1.1 memuat lokasi_gudang[] (gudang milik company), karyawan.id_cabang, dan assets[].id_asset_lokasi_m_tujuan serta nama_lokasi_tujuan (kosong sampai dikonfirmasi). Pesan umum validasi: "Data konfirmasi pengembalian belum lengkap."

API-007 — Opsi Peminjaman

GET /asset/karyawan/peminjaman/options

{
  "code": "SUCCESS",
  "message": "Opsi peminjaman asset berhasil ditemukan.",
  "data": {
    "keperluan": [
      {"value": "kantor", "label": "Kantor"},
      {"value": "dinas", "label": "Dinas"},
      {"value": "pelatihan", "label": "Pelatihan"},
      {"value": "lainnya", "label": "Lainnya"}
    ],
    "assets": [
      {"id_asset_data": "CMP00120260100009", "kode_asset": "PRJ-0002", "nama_asset": "Proyektor Mini",
       "kategori_asset": "Proyektor", "merek": "MerekY", "deskripsi": "Kabel HDMI, tas"}
    ]
  }
}

API-009 — Ajukan Peminjaman

POST /asset/karyawan/peminjaman

{
  "keperluan": "dinas",
  "tujuan_peminjaman": "Presentasi klien di Surabaya",
  "tgl_pinjam": "2026-09-28",
  "tgl_kembali": "2026-10-02",
  "asset_ids": ["CMP00120260100009"]
}

Database impact: INSERT header (pengajuan), INSERT item, UPDATE asset_data (proses), INSERT notif_data.

{ "code": "CREATED", "message": "Pengajuan peminjaman asset berhasil dikirim.",
  "data": { "id": "CMP001202609007", "no_trx": "KRY05-202609007", "status_approval": "pengajuan",
            "status_label": "Menunggu Konfirmasi", "tab": "pengajuan" } }

422: "Karyawan tidak ditemukan atau tidak aktif.", "Satu atau beberapa asset tidak tersedia untuk dipinjam.", "…sedang diproses pada onboarding.", "…sedang diproses pada peminjaman lain.", "Nomor transaksi untuk periode ini sudah mencapai batas." 500: "Terjadi kesalahan saat menyimpan peminjaman asset."

API-011 — Terima Asset

POST /asset/karyawan/peminjaman/{id}/terima

Tanpa body. Database impact: UPDATE asset_data (dipinjam @karyawan), UPDATE header (aktif), INSERT asset_trx_log (peminjaman_karyawan), INSERT notif_data.

{ "code": "UPDATED", "message": "Asset peminjaman berhasil diterima.",
  "data": { "id": "CMP001202609007", "no_trx": "KRY05-202609007", "status_approval": "aktif",
            "status_label": "Aktif", "tab": "aktif", "jumlah_asset": 1 } }

422: "Peminjaman asset tidak ditemukan.", "Peminjaman asset belum dapat diterima.", "Karyawan tidak ditemukan atau tidak aktif.", "Tidak ada asset yang disetujui untuk diterima.", "Satu atau beberapa asset belum siap diserahterimakan." 500: "Terjadi kesalahan saat memproses serah terima asset."

API-012 — Batalkan Peminjaman (v1.6: pengajuan dan dikonfirmasi)

POST /asset/karyawan/peminjaman/{id}/batalkan

Tanpa body. Hanya pemilik transaksi (dari token) dan hanya baris jenis_status = peminjaman. Dari pengajuan seluruh asset item dilepas; dari dikonfirmasi hanya item disetujui. Hanya asset yang masih proses + gudang diubah menjadi tersedia @gudang. Database impact: UPDATE asset_data (tersedia @gudang), UPDATE header (dibatalkan, ket_tolak = "Dibatalkan oleh karyawan.", tgl_update, user_update), INSERT notif_data. Tidak ada asset_trx_log.

{ "code": "UPDATED", "message": "Peminjaman asset berhasil dibatalkan.",
  "data": { "id": "CMP001202609007", "no_trx": "KRY05-202609007", "status_approval": "dibatalkan",
            "status_label": "Dibatalkan", "tab": "dibatalkan" } }

EN: "Asset loan cancelled successfully." Notifikasi peminjaman.dibatalkan ke seluruh admin.

422 (BUSINESS_RULE_VIOLATION): "Peminjaman asset sudah tidak dapat dibatalkan." (status aktif, selesai, ditolak, atau dibatalkan), "Peminjaman asset tidak ditemukan." (milik karyawan lain, id tidak ada, atau id adalah baris pengembalian), "Karyawan tidak ditemukan atau tidak aktif." 500: "Terjadi kesalahan saat memproses serah terima asset."

API-013 — Ajukan Pengembalian

POST /asset/karyawan/peminjaman/{id}/pengembalian

Tanpa body (semua asset disetujui ikut dikembalikan). Database impact: INSERT header pengembalian, INSERT item, INSERT notif_data.

{ "code": "CREATED", "message": "Pengajuan pengembalian asset berhasil dikirim.",
  "data": { "id": "CMP001202610001", "no_trx": "KRY05-202610001", "jenis_status": "pengembalian",
            "id_peminjaman_asal": "CMP001202609007", "status_approval": "pengajuan",
            "status_label": "Menunggu Konfirmasi", "tab": "pengajuan", "jumlah_asset": 1 } }

422: "Peminjaman asset tidak ditemukan.", "Hanya peminjaman aktif yang dapat dikembalikan.", "Tidak ada asset aktif yang dapat dikembalikan.", "Satu atau beberapa asset tidak sedang dipinjam oleh karyawan.", "Pengembalian asset sedang menunggu konfirmasi.", "Asset sedang diproses pada offboarding."

25Mobile Architecture

Page → Bloc (AssetPeminjamanBloc / AssetPeminjamanAdminBloc) → Api (AssetPeminjamanApi / AssetPeminjamanAdminApi) → ApiClient → Backend

26Mobile Screen

26.1 Peminjaman Asset (Karyawan) — 4 tab (v1.6)

Tab utama (AssetPeminjamanTabBar, tanpa badge): Permintaan Peminjaman, Sedang Dipinjam, Pengembalian, Riwayat Peminjaman. Enum AssetPeminjamanPageMode kini {peminjaman, sedangDipinjam, pengembalian, riwayat} (sebelumnya hanya peminjaman/pengembalian). Lebar tiap tab = lebar layar / 4 dengan minimum 88 dp; bila tidak muat (mis. 320 px) bar dapat digulir horizontal dan tab terakhir tetap terjangkau.

Daftar peminjaman di Bloc dipakai bersama tab Permintaan, Sedang Dipinjam, dan Riwayat; _listMatchesMode mencegah data tab lain bocor (mis. daftar aktif tidak tampil di tab Permintaan) dan menampilkan loading sampai daftar tab yang benar dimuat. Pemanggil lama dipetakan oleh _assetPeminjamanModeFrom (router): argumen enum dipakai apa adanya, true → Pengembalian, lainnya → Permintaan Peminjaman. NavigateToAssetPeminjaman menerima mode: atau pengembalian: true; menu Peminjaman di Asset Saya membuka Permintaan Peminjaman.

Kartu Permintaan/Sedang Dipinjam/Pengembalian: nomor, Tanggal Pengajuan / Tanggal Diterima (bila aktif), status (Menunggu Konfirmasi, Dikonfirmasi, Ditolak, Dibatalkan, Aktif, Terlambat), Keperluan, Tanggal Pinjam, Tanggal Kembali, "{jumlah} Asset", info jadwal serah terima, peringatan "Sudah lewat tanggal pengembalian. Silakan kembalikan asset sekarang." Tombol +.

Kartu Riwayat (AssetPeminjamanRiwayatCard): nomor transaksi, periode (Tanggal Pinjam / Tanggal Kembali), "{jumlah} Asset", badge Selesai, dan ringkasan pengembalian: satu pengembalian → "Dikembalikan {tgl} · N normal · M rusak"; lebih dari satu → dijumlahkan dengan tanggal terakhir dan jumlah transaksi ("Dikembalikan terakhir {tgl} · {n} pengembalian · …"). Bila peminjaman tidak punya pengembalian, ringkasan tidak ditampilkan; bila tanggalnya kosong tertulis "Dikembalikan -" (RISK-013). Kunci lokalisasi baru di assets/{id,en}/asset.json: menu.permintaan_peminjaman, menu.sedang_dipinjam, menu.riwayat_peminjaman, label.ringkasan_pengembalian(_banyak), pesan.belum_ada_riwayat_peminjaman, tab.dibatalkan, status.dibatalkan, serta tab.semua/jatuh_tempo/terlambat untuk chip kondisi.

26.2 Tambah Peminjaman Asset

26.3 Detail Peminjaman / Pengembalian (Karyawan)

Header (Tanggal Pengajuan/Diterima, status, Nomor Pengajuan), Data Karyawan (Jabatan, Cabang, Departemen), Detail Peminjaman (Tanggal Pinjam, Tanggal Kembali, Keperluan, Tujuan Peminjaman), Jadwal Serah Terima, daftar asset dengan status Disetujui Admin/Ditolak Admin (+Alasan Penolakan) atau kondisi Normal/Rusak (+Keterangan Kerusakan) untuk pengembalian. - Status pengajuan (v1.6): hanya tombol Batalkan (_EmployeeCancelAction, dialog "Peminjaman yang dibatalkan tidak dapat dipulihkan."). - Status dikonfirmasi: panel "Siap untuk meminjam Asset?" + instruksi, tombol Batalkan dan Terima Asset (dialog konfirmasi). - Status dibatalkan (v1.6): badge Dibatalkan (abu-abu), tanpa tombol aksi. - Detail peminjaman memuat bagian Pengembalian (AssetPeminjamanPengembalianSection): satu kartu per transaksi pengembalian (nomor, status, tanggal, kondisi Normal/Rusak + keterangan kerusakan + lokasi tujuan per asset). Bagian disembunyikan bila pengembalian kosong atau pada detail pengembalian. - dapat_dikembalikan: tombol Kembalikan Asset (dialog "Asset aktif pada peminjaman ini akan diajukan untuk dikembalikan.").

Alur status: AssetAlurStepper.peminjaman (Pengajuan → Konfirmasi → Dipinjam → Pengembalian → Selesai; transaksi pengembalian mulai dari langkah Pengembalian; disembunyikan bila ditolak) dan satu kartu timeline per aset (AssetPeminjamanTimelineCards). Transaksi peminjaman: Pengajuan (keperluan, periode) · Konfirmasi (jadwal serah terima; chip Ditolak per aset) · Dipinjam (tanggal diterima, batas kembali; chip Terlambat) · Pengembalian · Selesai (lokasi gudang). Transaksi pengembalian: Pengembalian (jadwal) · Konfirmasi (kondisi Normal/Rusak; chip Rusak) · Selesai (lokasi gudang). Alasan penolakan tetap di kartu aset. File: Shared/Widgets/AssetAlurWidgets.dart, Shared/Widgets/AssetPeminjamanTimeline.dart.

26.4 Peminjaman Asset (Admin)

Empat tab dan chip sama seperti karyawan (§26.1; kondisi dikirim ke GET /asset/peminjaman-karyawan). "Lihat semua" pada panel jatuh tempo di Asset Karyawan membuka tab Sedang Dipinjam (NavigateToAssetAdminPeminjaman(mode: sedangDipinjam)); aksi Peminjaman dan panel "perlu diproses" membuka Permintaan Peminjaman. Kartu menampilkan karyawan, keperluan, periode, jumlah asset; tab Riwayat memakai AssetPeminjamanRiwayatCard(showKaryawan: true) (+ nama/NIK karyawan).

26.5 Detail Peminjaman (Admin)

Data karyawan (Jabatan, Cabang, Departemen), detail peminjaman, daftar asset. Status pengajuan: tiap asset tombol Setujui/Tolak (+Alasan Penolakan) dan tombol bawah Konfirmasi → sheet Konfirmasi Peminjaman Asset (ringkasan, Jadwal Serah Terima dibatasi periode pinjam, Jam Serah Terima, Catatan Tambahan, Submit). Jadwal hanya diminta bila ada asset disetujui. Admin read-only pada peminjaman selesai (v1.6: kondisi editable kini memeriksa !isSelesai, sehingga form keputusan tidak muncul), label dan warna status Selesai benar di detail admin dan karyawan, serta bagian Pengembalian ikut tampil.

Stepper dan kartu timeline sama seperti §26.3; kartu timeline disembunyikan saat form keputusan admin terbuka.

26.6 Detail Pengembalian (Admin)

Status pengajuan: tiap asset Normal/Rusak (+Keterangan Kerusakan) dropdown Lokasi Tujuan Asset per asset (v1.1; default gudang di cabang karyawan) dan tombol Konfirmasi (langsung dikirim, tanpa sheet). Bila belum ada pilihan lokasi: "Pilih lokasi gudang tujuan untuk seluruh asset.". Setelah selesai: kondisi dan lokasi tujuan read-only.

Stepper dan kartu timeline transaksi pengembalian sama seperti §26.3; kartu timeline disembunyikan saat form kondisi dan lokasi admin terbuka.

26.7 Asset Saya

Banner per peminjaman dikonfirmasi (aksi terima), banner jatuh tempo (label dari sisa_hari), bagian Peminjaman Asset berisi kartu peminjaman aktif.

27Mobile → API

28API → Mobile

29Mapping Mobile → API → Database

30Mapping Database → API → Mobile

31Validation

31.1 Mobile

31.2 Backend — lihat §9 dan §24.

31.3 Database

ENUM jenis_status, status (membutuhkan nilai dibatalkan dari SQL v1.6; pada MariaDB non-strict nilai enum tak dikenal tersimpan kosong, RISK-010), status_item; NOT NULL + default untuk tanggal (CURRENT_DATE, 0000-00-00) dan teks; no_trx tidak unique.

31.4 Ringkasan per Field

32Error Handling

33Audit Trail

34Notification

Pengingat jatuh tempo bukan notifikasi push: hanya daftar/banner (getJatuhTempo). ⚠️ Belum ditemukan: scheduler (Kernel::schedule kosong).

35Security

36Manual Book User/Admin

A. Karyawan — Meminjam Asset

1. Buka Asset Saya → menu Peminjaman → tekan +.
2. Pilih Asset → Tambah Asset → cari dan pilih asset → Pilih. Ulangi bila perlu.
3. Di Form Peminjaman: Pilih Keperluan (Kantor/Dinas/Pelatihan/Lainnya), isi Tujuan Peminjaman, pilih Tanggal Pinjam dan Tanggal Kembali.
4. Tekan Ajukan Peminjaman. Status Menunggu Konfirmasi.
5. Salah mengajukan? Selama masih Menunggu Konfirmasi, buka detail transaksi (tab Permintaan Peminjaman, chip Pengajuan) → Batalkan → konfirmasi. Status menjadi Dibatalkan (chip Dibatalkan) dan asset kembali tersedia.

B. Admin — Menyetujui Peminjaman

1. Asset Karyawan → aksi Peminjaman → tab Permintaan Peminjaman → chip Pengajuan → pilih transaksi.
2. Untuk setiap asset pilih Setujui atau Tolak (isi Alasan Penolakan).
3. Tekan Konfirmasi → isi Jadwal Serah Terima, Jam Serah Terima (dalam periode pinjam) dan Catatan Tambahan → Submit.

C. Karyawan — Menerima Asset

1. Buka notifikasi Peminjaman Asset Disetujui atau banner di Asset Saya.
2. Datang sesuai jadwal serah terima, periksa asset secara fisik.
3. Tekan Terima Asset → konfirmasi. Status Aktif. - Tidak jadi meminjam: tekan Batalkan (tidak dapat dipulihkan). Status menjadi Dibatalkan, bukan Ditolak.

D. Karyawan — Mengembalikan Asset

1. Perhatikan pengingat jatuh tempo di Asset Saya; lewat tanggal akan tertulis Terlambat. Tab Sedang Dipinjam dengan chip Jatuh Tempo / Terlambat menyaring peminjaman aktif.
2. Buka detail peminjaman aktif → Kembalikan Asset → konfirmasi.
3. Serahkan asset ke admin; pantau di tab Pengembalian. Setelah admin mengonfirmasi, peminjaman tampil di tab Riwayat Peminjaman beserta ringkasan pengembaliannya (mis. "Dikembalikan 28 Okt 2026 · 0 normal · 1 rusak").

E. Admin — Menerima Pengembalian

1. Peminjaman → tab Pengembalian → chip Pengajuan → pilih transaksi.
2. Periksa setiap asset: Normal atau Rusak (isi Keterangan Kerusakan).
3. Pilih Lokasi Tujuan Asset (gudang) untuk setiap asset; default-nya gudang di cabang karyawan.
4. Tekan Konfirmasi. Asset normal kembali tersedia, asset rusak berstatus rusak, keduanya di gudang yang dipilih; peminjaman otomatis selesai.

F. Melihat Riwayat Peminjaman (Karyawan & Admin)

1. Buka tab Riwayat Peminjaman. Daftar berisi peminjaman yang sudah selesai (terbaru di atas); admin melihat seluruh karyawan di company, karyawan hanya miliknya.
2. Kartu menampilkan nomor, periode, jumlah asset, badge Selesai, dan ringkasan pengembalian. Pengembalian yang berasal dari proses offboarding juga ikut dihitung di sini.
3. Buka kartu untuk melihat detail; bagian Pengembalian merinci kondisi tiap asset. Detail selesai bersifat baca-saja bagi admin.

37Kondisi Button

38Testing Scenario

Happy Path

Validation

Status

Asset / Jatuh Tempo

API / Security / Network

Pembatalan (v1.6)

List: tab Dibatalkan, kondisi, Riwayat (v1.6)

Mobile (v1.6)

39Temuan Ketidaksesuaian

40Edge Case

41Potential Bug / Technical Risk

RISK-001 — Asset terkunci bila peminjaman tidak pernah diterima (TINGGI)

Lokasi: konfirmasiAdmin, terimaKaryawan, batalkanKaryawan. Masalah: Setelah dikonfirmasi, hanya karyawan yang bisa menerima/membatalkan. Tidak ada kedaluwarsa atau aksi admin. Impact: Asset disetujui tetap proses tanpa batas waktu, tidak bisa dipinjam/diberikan ke orang lain. Recommendation: Pembatalan oleh admin dan/atau kedaluwarsa otomatis (mis. lewat tgl_dikembalikan).

RISK-002 — Pengajuan tidak bisa dibatalkan karyawan (SEDANG) — ✅ DITUTUP v1.6

Karyawan kini dapat membatalkan pada status pengajuan dan dikonfirmasi; asset yang dikunci dilepas (proses → tersedia) dan status menjadi dibatalkan. Syarat deploy: SQL enum dibatalkan (RISK-010).

RISK-003 — Tidak ada pengingat otomatis (SEDANG)

Kernel::schedule kosong; pengingat jatuh tempo hanya muncul ketika aplikasi dibuka. Tidak ada push/notif H-1 atau terlambat.

RISK-004 — Pengembalian tidak bisa ditolak/dibatalkan (SEDANG)

Pengembalian yang salah diajukan tidak bisa dibatalkan karyawan atau ditolak admin; admin harus mengonfirmasi (asset otomatis masuk gudang).

RISK-005 — Pengembalian wajib seluruh asset (RENDAH)

Tidak bisa mengembalikan sebagian; desain atau keterbatasan perlu dikonfirmasi bisnis.

RISK-006 — Tanggal nol 0000-00-00 (SEDANG)

Insert memakai 0000-00-00/00:00:00; ⚠️ Asumsi: gagal pada MySQL strict mode NO_ZERO_DATE.

RISK-007 — Tanpa batas durasi pinjam (RENDAH)

tgl_kembali bebas selama ≥ tgl_pinjam.

RISK-008 — Kapasitas penomoran (RENDAH)

3 digit/bulan/company dipakai bersama peminjaman & pengembalian (header) serta item.

RISK-009 — Notifikasi di luar transaksi (RENDAH)

Kegagalan notif hanya di-log.

RISK-010 — Urutan deploy: SQL enum harus sebelum API v1.6 (TINGGI)

Lokasi: batalkanKaryawan menulis status = 'dibatalkan'; filter tab=dibatalkan. Masalah: Nilai dibatalkan hanya ada di kolom setelah sql-peminjaman-status-dibatalkan.sql dijalankan. Bila API v1.6 dipakai lebih dulu, pada MariaDB non-strict nilai enum tak dikenal tersimpan sebagai string kosong (''), sedangkan mode strict menolak query. Status eksekusi SQL di server tidak dapat diverifikasi dari kode. Impact: Peminjaman yang dibatalkan tidak bisa dikenali statusnya (asset sudah dilepas, header tidak terbaca sebagai dibatalkan). Recommendation: Jalankan SQL (langkah 0–2) lebih dulu dan verifikasi COLUMN_TYPE; pertimbangkan migration atau pemeriksaan pra-rilis.

RISK-011 — Data pembatalan lama tetap ditolak (RENDAH)

Pembatalan sebelum v1.6 tersimpan ditolak + "Dibatalkan oleh karyawan.". Tab Dibatalkan hanya memuat status baru; SQL langkah 3 bersifat opsional.

RISK-012 — Detail peminjaman menjalankan beberapa query per pengembalian (RENDAH)

pengembalianForDetail memanggil getDetail per transaksi pengembalian (sedikitnya query header dan item per pengembalian, selain satu query daftar). Jumlah pengembalian per peminjaman umumnya kecil (satu pengembalian menutup seluruh asset), tetapi pola ini N+1 bila bertambah.

RISK-013 — Kartu Riwayat "Dikembalikan -" (RENDAH)

Bila tgl_approval pengembalian kosong, tgl_selesai bernilai "" dan mobile menampilkan "-" pada ringkasan "Dikembalikan {tgl}".

RISK-014 — Definisi jatuh tempo berbeda antara chip dan dashboard (RENDAH)

Lihat INC-10: chip tidak mengecualikan peminjaman yang pengembaliannya sedang diajukan dan tidak memasukkan yang sudah lewat; dashboard sebaliknya.

42Dependency

Master Company / Data Karyawan / Asset Admin
      ↓
Asset Data (tersedia @gudang)
      ↓
Peminjaman (pengajuan → dikonfirmasi → aktif) ──► Notifikasi
      ↓ Terima Asset → asset_trx_log peminjaman_karyawan
Asset Data (dipinjam @karyawan) ──► Jatuh tempo (Asset Saya, Summary Admin)
      ↓ Pengembalian (header baru)
Asset Data (tersedia / rusak @gudang) ──► asset_trx_log pengembalian_karyawan

Terkait:
  - Onboarding & Request: hasActiveOnboardingAsset dipakai saat pengajuan
  - Offboarding: membuat pengembalian anak (asset_trx_offboarding_relasi); hasActiveOffboardingAsset mencegah pengembalian ganda
  - Asset Saya & Summary Admin: getPendingForEmployee, getPendingForAdmin, getJatuhTempo, getPeminjamanPage (aktif)
  - SQL manual `sql-peminjaman-status-dibatalkan.sql` (enum `dibatalkan`) harus dijalankan sebelum API v1.6

43Source Code Reference

44Developer Notes

• Satu tabel dua jenis baris: selalu filter jenis_status. Pengembalian adalah header baru, bukan update status peminjaman.
• Peminjaman asal ditutup otomatis saat tidak ada lagi asset pinjaman yang dipegang karyawan.
• Makna status_item bergantung jenis baris; getDetail memetakan disetujui/ditolak → normal/rusak untuk pengembalian. Pertahankan pemetaan ini bila mengubah enum.
• Pengembalian offboarding ditandai lewat asset_trx_offboarding_relasi dan selalu dikecualikan dari list/detail/konfirmasi peminjaman (cek Schema::hasTable sebelum dipakai).
• List peminjaman menyembunyikan aktif yang asetnya sudah tidak dipegang karyawan (mis. sudah dikembalikan lewat jalur lain).
• Jadwal serah terima divalidasi di model (bukan di request rule) terhadap periode pinjam.
• sisa_hari dihitung today → tgl_dikembalikan (negatif = terlambat); pengingat mulai H-1.
• Konstanta status memakai PeminjamanStatus enum (konsisten), berbeda dengan modul Request.
• Status dibatalkan (v1.6): hanya untuk baris jenis_status = peminjaman; deploy SQL enum lebih dulu. Hanya asset proses + gudang yang dilepas, tanpa asset_trx_log.
• List peminjaman paginasi: limit+1 tanpa COUNT; kondisi hanya untuk tab=aktif; tab riwayat memakai reorder() ke tgl_update desc dan tidak ada di filters statis.
• Riwayat & detail: pengembalian[] ditempel dari query terpisah (satu query per halaman di list, getDetail per pengembalian di detail). Pengembalian offboarding sengaja ikut (keputusan produk).
• Mobile: AssetPeminjamanPageMode kini empat nilai; pemanggil lama dipetakan di _assetPeminjamanModeFrom. State daftar per tab dijaga _listMatchesMode.
• Technical debt: RISK-001, 003, 004, 010, INC-02/07/10.

45End-to-End Traceability

45.1 Tanggal kembali → pengingat

Karyawan memilih rentang tanggal di Form Peminjaman
  → _returnDate → AssetPeminjamanRequest.tanggalKembali
  → JSON "tgl_kembali" (after_or_equal:tgl_pinjam)
  → store() → asset_trx_peminjaman_karyawan.tgl_dikembalikan
  → getJatuhTempo(): tgl_dikembalikan ≤ besok → "sisa_hari"
  → Asset Saya: banner jatuh tempo; detail: "terlambat" → label "Terlambat"

45.2 Asset → dipinjam → kembali

Karyawan memilih asset (Tambah Pinjam Asset) → asset_ids
  → store(): item + asset_data.status_asset = proses
Admin: Setujui → items[].status_item = disetujui → item.status_item
Karyawan: Terima Asset → terimaKaryawan()
  → asset_data: dipinjam, pemegang_asset = karyawan, id_pemegang_asset = id_karyawan
  → asset_trx_log (peminjaman_karyawan)
Karyawan: Kembalikan Asset → header pengembalian (id_peminjaman_asal)
Admin: Normal → items[].kondisi = normal → item.status_item = disetujui
  → asset_data: tersedia, pemegang_asset = gudang, id_asset_lokasi_m = items[].id_asset_lokasi_m
  → asset_trx_log (pengembalian_karyawan) → peminjaman asal: selesai

45.3 DB → UI

asset_trx_peminjaman_karyawan_item.ket_tolak (baris pengembalian)
  → getDetail() → "assets[].ket_tolak" (status_item = rusak)
  → AssetPeminjamanAsset → "Keterangan Kerusakan" di Detail Pengembalian

45.4 Walkthrough Lengkap dengan Contoh Data

Bagian ini mengikuti satu peminjaman dari awal sampai asset kembali, langkah demi langkah: apa yang dilakukan pengguna di mobile, apa yang dikirim, apa yang diproses API, dan apa yang tersimpan di database. Data bersifat sintetis, tetapi format ID, nama kolom, urutan proses, label status, dan pesan diambil dari kode (AssetPeminjamanKaryawan_m, AssetKaryawanPeminjaman_c, AssetAdminPeminjaman_c, AssetAdminPengembalian_c, AssetNotification).

Skenario: Andi mengajukan pinjaman proyektor dan layar untuk presentasi dinas. Admin menyetujui proyektor dan menolak layar. Andi menerima proyektor, lalu mengembalikannya dalam kondisi rusak.

Data awal

Company CMP001. Pengajuan 22 Oktober 2026, periode ID 202610. Belum ada transaksi peminjaman, log, atau notifikasi pada periode ini.

data_karyawan

asset_data (status_asset = tersedia, pemegang_asset = gudang, id_pemegang_asset = '', kondisi_awal = normal, id_asset_lokasi_m = CMP001202601001 = Gudang Pusat)

Lokasi gudang untuk pengembalian: CMP001202610001 = Gudang Servis (asset_lokasi_m, tipe gudang, company sama).

Penomoran: header dan item id_company + YYYYMM + 3 digit, no_trx = KRY05-YYYYMMNNN. Pengajuan pengembalian memakai urutan yang sama dengan peminjaman (satu tabel, jenis_status berbeda). Log dan notifikasi 5 digit.

Langkah 0 — Karyawan membuka form

Mobile: Asset Saya → Peminjaman → + → /asset_tambah_peminjaman → LoadAssetPeminjamanOptions → AssetPeminjamanApi.getOptions().

Dikirim

GET /asset/karyawan/peminjaman/options
Authorization: Bearer <access_token_andi>

Diproses API: jwt.api + jwt.ctx, lalu AssetPeminjamanKaryawan_m::getOptions: asset tersedia di gudang yang tidak ada di peminjaman berjalan (item yang ditolak tidak mengunci), ditambah daftar keperluan tetap.

Database: hanya SELECT.

Diterima mobile: keperluan[] (kantor, dinas, pelatihan, lainnya) dan assets[] (A9, A10) seperti API-007. Dipakai pada bottom sheet Tambah Pinjam Asset dan Pilih Keperluan.

Langkah 1 — Andi mengajukan peminjaman

Mobile: Andi memilih kedua asset, keperluan Dinas, tujuan "Presentasi klien di Surabaya", dan rentang tanggal 24–28 Okt 2026, lalu Ajukan Peminjaman → AssetPeminjamanApi.store(AssetPeminjamanRequest).

Dikirim

POST /asset/karyawan/peminjaman

{
  "keperluan": "dinas",
  "tujuan_peminjaman": "Presentasi klien di Surabaya",
  "tgl_pinjam": "2026-10-24",
  "tgl_kembali": "2026-10-28",
  "asset_ids": ["CMP00120260100009", "CMP00120260100010"]
}

id_karyawan tidak dikirim: diambil dari JWT.

Diproses API (AssetKaryawanPeminjaman_c::storePeminjamanSaya → AssetPeminjamanKaryawan_m::store, satu DB::transaction) 1. Validasi: keperluan dan tujuan_peminjaman wajib (maks 255); tgl_pinjam format Y-m-d dan tidak boleh sebelum hari ini; tgl_kembali tidak boleh sebelum tgl_pinjam; asset_ids minimal 1, unik. 2. lockCompany("CMP001"); findActiveKaryawan("KRY0003"). 3. getLockedAssets: A9 dan A10 harus tersedia + gudang (FOR UPDATE). 4. hasActiveOnboardingAsset dan hasActivePeminjamanAsset (peminjaman pengajuan/dikonfirmasi/aktif dengan item tidak ditolak): lolos. 5. Generate ID: header urutan 1 → CMP001202610001, no_trx = KRY05-202610001; item mulai urutan 1. 6. INSERT header (status = pengajuan, jadwal kosong), INSERT item (status_item = NULL), UPDATE asset_data → proses. 7. Setelah commit: AssetNotification::send('peminjaman.diajukan', …) ke seluruh admin.

Hasil database

asset_trx_peminjaman_karyawan

asset_trx_peminjaman_karyawan_item

asset_data: A9 dan A10 status_asset tersedia → proses, tgl_update 09:00:00, user_update = EMP-003 - Andi Contoh. Peminjam hanya mengubah status; pemegang_asset tetap gudang.

notif_data (2 baris, satu per admin)

jenis = asset, flag_baca = 0; teks Inggris ada di ket_notif_en.

Diterima mobile (HTTP 201)

{ "code": "CREATED", "message": "Pengajuan peminjaman asset berhasil dikirim.",
  "data": { "id": "CMP001202610001", "no_trx": "KRY05-202610001", "status_approval": "pengajuan",
            "status_label": "Menunggu Konfirmasi", "tab": "pengajuan" } }

Langkah 2 — Admin menyetujui satu asset dan menolak satu asset

Mobile: notifikasi membuka /asset_admin_detail_peminjaman → LoadAssetPeminjamanAdminDetail(id) (GET /asset/peminjaman-karyawan/CMP001202610001). Admin menekan Setujui pada proyektor, Tolak pada layar dengan alasan, lalu Konfirmasi → sheet Konfirmasi Peminjaman Asset (tanggal serah terima dibatasi periode pinjam) → Submit → AssetPeminjamanAdminApi.konfirmasi.

Dikirim

POST /asset/peminjaman-karyawan/CMP001202610001/konfirmasi

{
  "items": [
    { "id_item": "CMP001202610001", "status_item": "disetujui" },
    { "id_item": "CMP001202610002", "status_item": "ditolak", "ket_tolak": "Sedang dijadwalkan servis" }
  ],
  "tgl_serah_terima": "2026-10-24",
  "jam_serah_terima": "08:30",
  "keterangan_serah_terima": "Ambil di ruang IT"
}

Diproses API (AssetAdminPeminjaman_c::konfirmasiPeminjamanKaryawan → konfirmasiAdmin) 1. Validasi items (id unik, status_item ∈ disetujui/ditolak, ket_tolak wajib bila ditolak); format tanggal Y-m-d dan jam H:i. Cek admin. 2. lockCompany; header dikunci FOR UPDATE; harus berstatus pengajuan dan bukan milik offboarding (tidak ada relasi di asset_trx_offboarding_relasi). 3. Seluruh item harus diputuskan ("Seluruh asset peminjaman wajib dikonfirmasi."). 4. UPDATE tiap item: status_item, ket_tolak (kosong untuk disetujui). 5. Karena ada yang disetujui: tanggal dan jam serah terima wajib, formatnya harus valid, dan tanggalnya harus di dalam periode pinjam (24–28 Okt) — 24 Okt lolos. 6. UPDATE header: status = dikonfirmasi, jadwal, ket_tolak = '', user_approval, tgl_approval, tgl_update, user_update. 7. Asset ditolak (A10) dikembalikan: tersedia, gudang, id_pemegang_asset = ''. Asset disetujui (A9) tidak disentuh, tetap proses. 8. Notifikasi peminjaman.disetujui ke peminjam.

Hasil database

Diterima mobile (HTTP 200)

{ "code": "UPDATED", "message": "Peminjaman asset berhasil dikonfirmasi.",
  "data": { "id": "CMP001202610001", "no_trx": "KRY05-202610001", "status_approval": "dikonfirmasi",
            "status_label": "Dikonfirmasi", "tab": "dikonfirmasi", "jumlah_disetujui": 1, "jumlah_ditolak": 1 } }

Langkah 3 — Andi menerima asset

Mobile: banner di Asset Saya atau notifikasi → /asset_detail_peminjaman. Detail (API-010) menampilkan proyektor Disetujui Admin, layar Ditolak Admin + alasan, jadwal serah terima, dan panel "Siap untuk meminjam Asset?" dengan tombol Batalkan dan Terima Asset. Andi menekan Terima Asset (dialog konfirmasi) → AssetPeminjamanApi.terima(id).

Dikirim

POST /asset/karyawan/peminjaman/CMP001202610001/terima

Tanpa body.

Diproses API (prosesSerahTerimaPeminjaman → AssetPeminjamanKaryawan_m::terimaKaryawan) 1. lockCompany; header milik karyawan (FOR UPDATE), status harus dikonfirmasi ("Peminjaman asset belum dapat diterima."). 2. Karyawan aktif; item berstatus disetujui = hanya …001. 3. Asset-nya dikunci dan harus proses + gudang ("Satu atau beberapa asset belum siap diserahterimakan."). 4. UPDATE asset_data A9 → dipinjam, karyawan, id_pemegang_asset = KRY0003, id_asset_lokasi_m = NULL (asset keluar dari gudang). 5. UPDATE header → aktif (tgl_update menjadi tanggal diterima). 6. INSERT asset_trx_log (jenis_log = peminjaman_karyawan) per asset. 7. Notifikasi peminjaman.diterima ke admin.

Hasil database

asset_trx_log (1 baris)

notif_data (2 baris ke admin): CMP00120261000004 (KRY0099) dan CMP00120261000005 (KRY0100), rute asset_admin_detail_peminjaman, "Andi Contoh telah menerima asset peminjaman KRY05-202610001."

Diterima mobile (HTTP 200)

{ "code": "UPDATED", "message": "Asset peminjaman berhasil diterima.",
  "data": { "id": "CMP001202610001", "no_trx": "KRY05-202610001", "status_approval": "aktif",
            "status_label": "Aktif", "tab": "aktif", "jumlah_asset": 1 } }

Selama aktif, Asset Saya menampilkan kartu peminjaman aktif. Pada H-1 sampai tgl_dikembalikan muncul pengingat jatuh tempo (sisa_hari), dan setelah lewat tanggal itu label menjadi Terlambat. Pengingat dihitung saat data dibaca; tidak ada scheduler atau push otomatis.

Langkah 4 — Andi mengajukan pengembalian

Mobile: di detail peminjaman aktif (dapat_dikembalikan = true), Kembalikan Asset (dialog "Asset aktif pada peminjaman ini akan diajukan untuk dikembalikan.") → AssetPeminjamanApi.ajukanPengembalian(id).

Dikirim

POST /asset/karyawan/peminjaman/CMP001202610001/pengembalian

Tanpa body: seluruh asset yang disetujui ikut dikembalikan.

Diproses API (ajukanPengembalianKaryawan) 1. lockCompany; peminjaman milik karyawan harus aktif. 2. Item disetujui = …001; semua asset harus masih dipinjam oleh karyawan ini. 3. Tidak boleh ada pengembalian pengajuan/dikonfirmasi untuk asset itu (hasActivePengembalianAsset), dan asset tidak boleh sedang di offboarding (AssetOffboardingKaryawan_m::hasActiveOffboardingAsset). 4. Generate ID dengan urutan yang sama dengan peminjaman: header urutan 2 → CMP001202610002, no_trx = KRY05-202610002; item urutan 3. 5. INSERT header jenis_status = pengembalian dengan id_peminjaman_asal, periode/keperluan/tujuan disalin dari peminjaman, status = pengajuan; INSERT item (salinan item disetujui, status_item = NULL). 6. asset_data tidak diubah (A9 tetap dipinjam). 7. Notifikasi pengembalian.diajukan ke admin (memakai ID pengembalian).

Hasil database

Header baru CMP001202610002

Item baru: CMP001202610003, id_asset_trx_peminjaman = CMP001202610002, A9, Proyektor Mini, status_item = NULL, id_asset_lokasi_m_tujuan = ''.

notif_data: CMP00120261000006 (KRY0099) dan CMP00120261000007 (KRY0100), id_ref CMP001202610002, rute asset_admin_detail_pengembalian, "Andi Contoh mengajukan pengembalian asset KRY05-202610002."

Diterima mobile (HTTP 201)

{ "code": "CREATED", "message": "Pengajuan pengembalian asset berhasil dikirim.",
  "data": { "id": "CMP001202610002", "no_trx": "KRY05-202610002", "jenis_status": "pengembalian",
            "id_peminjaman_asal": "CMP001202610001", "status_approval": "pengajuan",
            "status_label": "Menunggu Konfirmasi", "tab": "pengajuan", "jumlah_asset": 1 } }

Tombol Kembalikan Asset hilang karena sudah ada pengembalian berjalan.

Langkah 5 — Admin memeriksa pengembalian

Mobile: Peminjaman (admin) → tab Pengembalian → chip Pengajuan → /asset_admin_detail_pengembalian → GET /asset/pengembalian-karyawan/CMP001202610002. Detail memuat lokasi_gudang[] (gudang milik company) untuk dropdown Lokasi Tujuan Asset. Admin memilih Rusak pada proyektor, mengetik "Lensa tergores", memilih Gudang Servis, lalu Konfirmasi (langsung dikirim, tanpa sheet).

Dikirim

POST /asset/pengembalian-karyawan/CMP001202610002/konfirmasi

{
  "items": [
    { "id_item": "CMP001202610003", "kondisi": "rusak",
      "id_asset_lokasi_m": "CMP001202610001", "keterangan_kerusakan": "Lensa tergores" }
  ]
}

Diproses API (AssetAdminPengembalian_c → konfirmasiPengembalianAdmin) 1. Validasi: kondisi ∈ normal/rusak, keterangan_kerusakan wajib bila rusak, id_asset_lokasi_m wajib. Cek admin, lockCompany. 2. Header pengembalian harus pengajuan; peminjaman asal harus ada dan aktif. 3. Semua item wajib diisi kondisi dan lokasi (resolveItemLocations: lokasi harus bertipe gudang, milik company yang sama, tepat satu kali per item). 4. Asset harus masih dipinjam oleh karyawan pemilik transaksi. 5. Per item: UPDATE item (status_item: normal → disetujui, rusak → ditolak; ket_tolak = keterangan kerusakan; id_asset_lokasi_m_tujuan), UPDATE asset_data, siapkan baris log. 6. INSERT asset_trx_log (jenis_log = pengembalian_karyawan). 7. UPDATE header pengembalian → selesai (user_approval, tgl_approval). 8. Bila tidak ada asset pinjaman yang masih dipegang karyawan, peminjaman asal ikut → selesai (di sini A10 tidak pernah dipegang, jadi selesai). 9. Notifikasi pengembalian.dikonfirmasi ke peminjam.

Hasil database

asset_trx_log (1 baris baru)

notif_data: CMP00120261000008 ke KRY0003, id_ref CMP001202610002, rute asset_detail_pengembalian, "Pengembalian asset KRY05-202610002 telah dikonfirmasi admin."

Diterima mobile (HTTP 200)

{ "code": "UPDATED", "message": "Pengembalian asset berhasil dikonfirmasi.",
  "data": { "id": "CMP001202610002", "no_trx": "KRY05-202610002", "jenis_status": "pengembalian",
            "id_peminjaman_asal": "CMP001202610001", "status_approval": "selesai", "status_label": "Selesai",
            "tab": "selesai", "jumlah_normal": 0, "jumlah_rusak": 1 } }

Peminjaman asal berstatus selesai sehingga tidak tampil lagi di tab Permintaan Peminjaman maupun Sedang Dipinjam; peminjaman itu kini dapat ditelusuri di tab Riwayat Peminjaman (lihat variasi di bawah).

Kondisi akhir data

asset_trx_peminjaman_karyawan

asset_trx_peminjaman_karyawan_item

asset_data: A9 → rusak @gudang (Gudang Servis), ket_rusak = Lensa tergores; A10 → tersedia @gudang (tidak pernah berpindah). asset_trx_log: 2 baris. notif_data: 8 baris. A9 yang rusak kini menjadi kandidat modul Perbaikan, Garansi, atau Disposal.

Perhatikan bahwa pada item pengembalian, status_item dipakai ulang untuk kondisi (disetujui = normal, ditolak = rusak); API menerjemahkannya menjadi normal/rusak saat dibaca.

Variasi

Semua asset ditolak. Pada langkah 2, bila kedua item ditolak: tanggal dan jam serah terima tidak diminta, header status = ditolak, ket_tolak = "Seluruh asset peminjaman ditolak.", jadwal tetap 0000-00-00/00:00:00, kedua asset kembali tersedia, notifikasi peminjaman.ditolak ke peminjam, message "Peminjaman asset berhasil ditolak.".

Karyawan membatalkan setelah dikonfirmasi. Pada langkah 3, tombol Batalkan → POST /asset/karyawan/peminjaman/{id}/batalkan (tanpa body). Syarat status pengajuan atau dikonfirmasi. Asset yang disetujui (A9) kembali tersedia/gudang, header status = dibatalkan (v1.6; sebelumnya ditolak), ket_tolak = "Dibatalkan oleh karyawan.", notifikasi peminjaman.dibatalkan ke admin, message "Peminjaman asset berhasil dibatalkan.". Tidak ada baris log.

Karyawan membatalkan saat pengajuan (v1.6). Andi menyadari salah memilih asset segera setelah langkah 1, sebelum admin memutuskan. Pada detail transaksi yang masih Menunggu Konfirmasi hanya ada tombol Batalkan (dialog "Peminjaman yang dibatalkan tidak dapat dipulihkan.").

POST /asset/karyawan/peminjaman/CMP001202610001/batalkan

Diproses batalkanKaryawan: header pengajuan diterima; karena status pengajuan, semua item (status_item NULL: A9 dan A10) diambil; kedua asset yang masih proses + gudang diubah menjadi tersedia, gudang, id_pemegang_asset = ''; header menjadi dibatalkan, ket_tolak = "Dibatalkan oleh karyawan.", tgl_update/user_update = EMP-003 - Andi Contoh. Tidak ada baris asset_trx_log. Notifikasi peminjaman.dibatalkan dikirim ke kedua admin ("Andi Contoh membatalkan peminjaman asset KRY05-202610001."). Peminjaman tampil di tab Permintaan Peminjaman → chip Dibatalkan.

{ "code": "UPDATED", "message": "Peminjaman asset berhasil dibatalkan.",
  "data": { "id": "CMP001202610001", "no_trx": "KRY05-202610001", "status_approval": "dibatalkan",
            "status_label": "Dibatalkan", "tab": "dibatalkan" } }

Mencoba membatalkan lagi, atau membatalkan peminjaman yang sudah aktif, ditolak dengan HTTP 422 "Peminjaman asset sudah tidak dapat dibatalkan.". Bila admin lebih dulu mengonfirmasi, Andi tetap bisa membatalkan (status dikonfirmasi); bila Andi lebih dulu membatalkan, konfirmasi admin ditolak 422 "Peminjaman asset sudah tidak menunggu konfirmasi.".

Tab Riwayat dengan pengembalian (v1.6). Setelah langkah 5, peminjaman CMP001202610001 berstatus selesai dan muncul di tab Riwayat Peminjaman sebagai satu entri bersama pengembaliannya.

GET /asset/karyawan/peminjaman?tab=riwayat&limit=20&offset=0

{ "code": "SUCCESS", "message": "Data peminjaman asset berhasil ditemukan.",
  "data": {
    "filters": [
      {"value": "pengajuan", "label": "Pengajuan"},
      {"value": "dikonfirmasi", "label": "Dikonfirmasi"},
      {"value": "ditolak", "label": "Ditolak"},
      {"value": "aktif", "label": "Aktif"},
      {"value": "dibatalkan", "label": "Dibatalkan"}
    ],
    "records": [
      { "id": "CMP001202610001", "no_trx": "KRY05-202610001", "tgl_pengajuan": "2026-10-22",
        "keperluan": "dinas", "tujuan_peminjaman": "Presentasi klien di Surabaya",
        "tgl_pinjam": "2026-10-24", "tgl_kembali": "2026-10-28",
        "jenis_status": "peminjaman", "status_approval": "selesai", "status_label": "Selesai", "tab": "selesai",
        "jumlah_asset": 2, "tgl_diterima": "", "terlambat": false,
        "pengembalian": [
          { "id": "CMP001202610002", "no_trx": "KRY05-202610002", "tgl_selesai": "2026-10-28",
            "jumlah_normal": 0, "jumlah_rusak": 1 }
        ] }
    ],
    "pagination": { "limit": 20, "offset": 0, "next_offset": 1, "has_more": false } } }

Daftar diurut tgl_update desc. jumlah_asset = 2 karena header menghitung semua item (A9 disetujui dan A10 ditolak). Mobile menampilkan kartu: nomor KRY05-202610001, periode 24–28 Okt 2026, "2 Asset", badge Selesai, dan ringkasan "Dikembalikan 28 Okt 2026 · 0 normal · 1 rusak". Membuka kartu memanggil detail (API-010) yang memuat pengembalian[] lengkap (status Selesai, aset A9 kondisi = rusak, keterangan_kerusakan = Lensa tergores, lokasi_tujuan = Gudang Servis). Admin melihat entri yang sama lewat GET /asset/peminjaman-karyawan?tab=riwayat (semua karyawan) dan detailnya read-only.

Pengembalian normal. Pada langkah 5, bila kondisi = normal: item disetujui, A9 → tersedia @gudang pilihan admin, ket_rusak = '', log kondisi_akhir = normal, jumlah_normal = 1.

Terlambat. Peminjaman aktif setelah tgl_dikembalikan tetap aktif di database; API menghitung terlambat = true dan mobile menampilkan label Terlambat serta peringatan pengembalian.

Kasus gagal yang umum

Semua pelanggaran aturan dilempar sebagai InvalidArgumentException di dalam DB::transaction, sehingga seluruh perubahan request itu dibatalkan. Pesan tersedia dalam bahasa Indonesia dan Inggris mengikuti header locale.

Ringkasan siapa mengerjakan apa

46Ringkasan Database Impact

47Checklist Implementasi

Database

• Header (peminjaman & pengembalian) & item
• Relasi id_peminjaman_asal
• Index list admin & karyawan
• Enum status
• Nilai enum dibatalkan di DBML dan SQL manual sql-peminjaman-status-dibatalkan.sql (eksekusi di server: ⚠️ belum diverifikasi, prasyarat deploy)
• Rapikan data lama "Dibatalkan oleh karyawan." dari ditolak ke dibatalkan (SQL langkah 3, opsional)
• Log serah terima & pengembalian
• Migration CREATE TABLE baseline
• Kolom tanggal diterima & kondisi terpisah

Backend

• Ajukan, konfirmasi per asset + jadwal, terima, batalkan
• Ajukan & konfirmasi pengembalian
• Jatuh tempo & terlambat (tampilan)
• Integrasi offboarding
• Batal pengajuan oleh karyawan (v1.6)
• Filter kondisi dan tab dibatalkan/riwayat; pengembalian[] di list riwayat dan detail
• Batal/kedaluwarsa oleh admin
• Tolak pengembalian
• Scheduler pengingat jatuh tempo
• Perpanjangan & pengembalian sebagian

Mobile

• List peminjaman/pengembalian (karyawan & admin)
• Form pengajuan dengan picker asset & rentang tanggal
• Detail + Terima/Batalkan/Kembalikan
• Konfirmasi admin + sheet jadwal
• Konfirmasi kondisi pengembalian
• Lokasi gudang tujuan per asset saat pengembalian; lokasi dikosongkan saat asset keluar gudang (v1.1)
• Backfill lokasi asset yang sudah di gudang
• Banner & kartu di Asset Saya
• Halaman 4 tab (Permintaan, Sedang Dipinjam, Pengembalian, Riwayat) dengan chip kondisi dan kartu Riwayat (v1.6)
• Batalkan pada detail status pengajuan; admin read-only pada peminjaman selesai
• maxLength tujuan peminjaman

Documentation

• Business Flow, DB, API, Mobile, Mapping, Manual Book, Testing
• Disinkronkan dengan kode 2026-10-27 (v1.6)
• Screenshot

48Changelog