Asset Management · Dokumentasi Teknis & Manual Book

Dokumentasi Asset Karyawan

Tujuh belas fitur dan satu dokumen infrastruktur penyimpanan foto yang mengatur perjalanan asset — di tangan karyawan (diterima, dipakai, dikembalikan), di ruangan (dialokasikan, diupgrade, dan diretur lewat PIC), dan di gudang (dirawat, diperbaiki, diklaim, dihapus). Setiap dokumen disusun dari source code API (Lumen) dan MOBILE (Flutter) dengan 48 bagian yang sama.

18dokumen

211endpoint

48bagian/dok

GitHub — dokumen dibuka dari situs ini.

gudang → karyawan

Asset masuk ke karyawan

Penyerahan awal, tambahan, dan pinjaman.

KRY01v1.3

Onboarding Asset

Admin menyerahkan asset gudang kepada karyawan baru; karyawan memeriksa kondisi fisik tiap asset.

draft / proses → dikonfirmasi

11 endpointtanpa approval

RISKPenggantian asset gagal bila deskripsi asset kosong.

Buka dokumen →

KRY-03-1v1.5

Request & Penambahan Asset

Asset tambahan untuk karyawan aktif — diajukan karyawan (Pengajuan) atau langsung oleh admin (Penambahan). Serah terima all-or-nothing.

draft / proses → dikonfirmasi · ditolak

17 endpoint2 jalur

TINGGILaporan rusak saat konfirmasi membuat transaksi & asset macet.

Buka dokumen →

KRY05v1.6

Peminjaman Asset

Karyawan meminjam asset gudang untuk periode tertentu, lalu mengembalikannya dan admin menilai kondisinya.

pengajuan → dikonfirmasi → aktif → selesai · dibatalkan

15 endpoint+ pengembalian4 tab

TINGGIAsset terkunci bila peminjaman disetujui tapi tidak pernah diterima.

Buka dokumen →

tetap di karyawan

Asset selama dipakai

Perbaikan, peningkatan, dan pemeliharaan berkala tanpa memindahkan kepemilikan secara permanen.

KRY06v1.6

Laporan Kerusakan Asset

Lapor kerusakan per komponen; unit pengganti sekategori dicek karyawan lewat checklist sampai dinyatakan normal.

pengajuan → menunggu_pengambilan → (menunggu_review_checklist) → selesai

13 endpoint15 test

SEDANGUnit pengganti tertahan proses di gudang sampai laporan diselesaikan admin.

Buka dokumen →

KRY03-2v1.4

Upgrade Asset

Spesifikasi komponen ditingkatkan: asset diambil sementara, diupgrade teknisi, lalu kembali ke karyawan yang sama.

pengajuan → menunggu_pengambilan → dalam_service → menunggu_pengembalian → selesai

13 endpoint5 test2 jalur

TINGGITransaksi lama di fase menunggu_review terkunci sampai SQL migrasi dijalankan; belum ada pembatalan.

Buka dokumen →

PML01v1.3

Pemeliharaan Terjadwal

Asset diservis berkala sesuai interval: jadwal disepakati karyawan, PM didampingi PIC atau lewat Admin/HR, hasil lima tingkat menentukan tindak lanjut.

konfirmasi_jadwal → penjadwalan → pelaksanaan → menunggu_review → selesai

16 endpoint15 test2 mekanisme

TINGGISkema dari SQL manual — wajib dijalankan sebelum fitur dipakai.

Buka dokumen →

karyawan → gudang

Asset keluar dari karyawan

Pengembalian sebagian atau penarikan seluruh asset.

KRY04v1.8

Retur Asset

Karyawan mengembalikan asset (rusak, tidak digunakan, tukar unit); admin memutuskan per asset dan dapat memberi pengganti.

pengajuan → disetujui → selesai · ditolak

9 endpointmenu "Pengembalian"

SEDANGTidak ada batal/kedaluwarsa setelah disetujui; unit pengganti tertahan.

Buka dokumen →

KRY02v1.6

Off Boarding Asset

Admin menarik seluruh asset karyawan; asset pinjaman otomatis dibuatkan pengembalian sebagai transaksi child.

draft → pengajuan → dikonfirmasi → selesai

11 endpoint12 test

TINGGIKaryawan yang sudah nonaktif tidak bisa konfirmasi — off boarding macet.

Buka dokumen →

gudang · pemeliharaan lanjutan

Asset di gudang: rawat, perbaiki, klaim, hapus

Pemeliharaan asset gudang sampai disposal, beserta master PIC.

PML01v1.4

Pemeliharaan Gudang

Asset cadangan di gudang diservis berkala: PM dijadwalkan admin, PIC Pendamping mengisi checklist komponen, hasil terberat menentukan tindak lanjut.

penjadwalan → menunggu_review → selesai · dibatalkan

13 endpoint16 test API1 transaksi = 1 asset

TINGGISkema dari SQL manual — wajib dijalankan sebelum fitur dipakai.

Buka dokumen →

PML02v1.3

Perbaikan Asset

Aset gudang rusak diperbaiki vendor atau tim internal; PIC Service menerima, mengirim, memantau progres, lalu mengisi hasil per aset.

menunggu_serah_terima → dalam_service → menunggu_pengembalian → menunggu_review → selesai

19 endpoint6 test API

SEDANGTidak ada pembatalan; PML01/PML03 belum membuat perbaikan otomatis.

Buka dokumen →

PML03v1.3

Klaim Garansi

Aset gudang rusak yang masih bergaransi diklaim ke vendor; klaim ditolak diarahkan ke Perbaikan atau Disposal.

menunggu_serah_terima → proses_klaim → menunggu_pengembalian → menunggu_review → selesai

17 endpoint5 test API

SEDANGDokumen bisnis menyebut ruangan/karyawan; implementasi hanya gudang.

Buka dokumen →

PML04v1.2

Disposal Asset

Admin menghapus aset gudang rusak dari daftar aktif: keputusan, pelaksanaan per metode dengan bukti wajib, lalu penyelesaian.

menunggu_disposal → siap diselesaikan → disposed

6 endpoint20 test

SEDANGDisposal tidak dibuat otomatis dari PML01/02/03; tidak ada pembatalan.

Buka dokumen →

PICv1.3

Pendamping & Tugas PIC

Satu master pendamping dipakai sebagai PIC di PM gudang, klaim garansi, dan perbaikan; karyawan PIC punya satu dashboard tugas.

daftar → tunjuk PIC → kerjakan → nonaktifkan

5 endpoint5 test mobile

RENDAHPesan penolakan nonaktif hanya menyebut pemeliharaan gudang.

Buka dokumen →

gudang → ruangan

Asset masuk ke ruangan

Admin/HR mengalokasikan aset gudang ke ruangan; PIC Ruangan menerima dan memeriksanya.

ALK-RGN01v1.1

Onboarding Ruangan

Aset gudang dialokasikan ke ruangan; PIC menilai tiap aset, aset rusak diganti per ronde, lalu Admin/HR mengonfirmasi.

menunggu_serah_terima → menunggu_review → (pengganti, ronde + 1) → selesai

10 endpoint17 test API18 test mobile

TINGGISkema bergantung pada SQL manual; belum ada pembatalan alokasi.

Buka dokumen →

ALK-RGN04v1.1

Penambahan Asset Ruangan

Ruangan aktif ditambah aset lewat pengajuan PIC (disetujui atau ditolak Admin/HR) atau inisiasi langsung Admin/HR; serah terima dan penggantian aset rusak sama dengan onboarding ruangan.

menunggu_persetujuan → menunggu_serah_terima → menunggu_review → selesai

14 endpoint12 test API11 test mobile

TINGGIKolom status_approval harus enum di database; belum ada pembatalan oleh Admin.

Buka dokumen →

tetap di ruangan

Asset selama di ruangan

Peningkatan spesifikasi aset ruangan tanpa memindahkan kepemilikannya.

ALK-RGN07v1.2

Upgrade Komponen Ruangan

Spesifikasi satu aset ruangan ditingkatkan: PIC mengajukan atau Admin/HR langsung membuat, aset diambil sementara, diupgrade teknisi, lalu kembali ke ruangan yang sama. Alur meniru upgrade karyawan.

pengajuan → menunggu_pengambilan → dalam_service → menunggu_pengembalian → selesai

13 endpoint15 test API15 test mobile2 jalur

SEDANGTransaksi lama di fase menunggu_review terkunci sampai SQL migrasi dijalankan; ruangan tanpa PIC aktif membuat pelepasan/terima mustahil; belum diuji end-to-end.

Buka dokumen →

ruangan → gudang

Asset keluar dari ruangan

PIC Ruangan mengajukan retur; Admin/HR memutuskan per asset dan menerimanya ke gudang.

ALK-RGN06v1.1

Retur Asset Ruangan

PIC Ruangan mengajukan retur asset ruangannya; Admin/HR memutuskan per asset (+ pengganti), lalu menerima asset dan memilih gudang tujuan tiap asset. Alur sama dengan retur karyawan.

pengajuan → dikonfirmasi → diterima (atau ditolak)

9 endpoint16 test API25 test mobile

SEDANGSkrip unique no_trx per company belum dikonfirmasi dijalankan; belum ada jalur batal/edit.

Buka dokumen →

infrastruktur · penyimpanan file

Penyimpanan foto dan bukti

Cara API menyimpan dan menyajikan foto asset.

APIv1.0

MinIO Object Storage

Foto garansi, perbaikan, dan disposal disimpan di bucket MinIO privat dibaca lewat presigned URL sementara; fitur baru memakai satu pintu ObjectStorageManager.

validasi gambar → upload key acak → simpan key → presigned URL

5 endpoint upload21 testsiap untuk fitur baru

SEDANGKoneksi MinIO nyata belum diverifikasi; object yatim belum dibersihkan otomatis.

Buka dokumen →

Pengecekan lintas fitur

Saat transaksi baru dibuat untuk asset yang dipegang karyawan, apakah sistem menolak asset yang sedang diproses di fitur lain? Hasil penelusuran source yang tercatat di dokumen Retur, Off Boarding, Kerusakan, Upgrade, dan Pemeliharaan (diverifikasi ulang terhadap kode 12 Okt 2026).

Saat membuat…	Retur aktif	Off Boarding aktif	Kerusakan aktif	Upgrade aktif	Pemeliharaan aktif
Retur (KRY04)	dicek	dicek	dicek	dicek	dicek
Off Boarding (KRY02)	dicek	dicek	dicek	dicek	dicek
Kerusakan (KRY06)	dicek	dicek	dicek	dicek	dicek
Upgrade (KRY03)	dicek	dicek	dicek	dicek	dicek
Pemeliharaan (PML01)	dicek	dicek	dicek	dicek	dicek

Off Boarding juga menolak pengembalian pinjaman yang masih berjalan; Retur hanya menolak asset berstatus dipinjam. Seluruh sel kini "dicek": Retur menambah pengecekan Kerusakan dan Upgrade (RISK-001 dokumen Kerusakan/Upgrade dan RISK-003 dokumen Retur ditutup).

Isi setiap dokumen

Semua dokumen memakai 48 bagian yang sama, dikelompokkan di navigasi samping.

§1–15Gambaran, aturan bisnis, flow, status
§16–19Database, relasi, data dictionary, index
§20–24Backend & kontrak API
§25–30Mobile & mapping UI → JSON → DB
§31–35Validasi, error, audit, notifikasi, security
§36–37Manual book & kondisi tombol
§38–41Testing, temuan, edge case, risiko
§42–48Referensi developer & changelog

unduh

Unduh dokumen

Setiap dokumen tersedia sebagai HTML (tampilan lengkap, diagram Mermaid memerlukan internet) dan Markdown (teks mentah).

Dokumen	HTML	Markdown
Dokumentasi Teknis & Manual Book — Disposal Asset (PML04)	HTML	Markdown
Dokumentasi Teknis & Manual Book — Klaim Garansi Asset (PML03)	HTML	Markdown
Dokumentasi Teknis & Manual Book — Laporan Kerusakan Asset Karyawan	HTML	Markdown
Dokumentasi Teknis & Manual Book — Off Boarding Asset Karyawan	HTML	Markdown
Dokumentasi Teknis & Manual Book — Asset Onboarding Karyawan	HTML	Markdown
Dokumentasi Teknis & Manual Book — Alokasi Asset ke Ruangan / Onboarding Ruangan (ALK-RGN01)	HTML	Markdown
Dokumentasi Teknis & Manual Book — Pemeliharaan Terjadwal Asset Gudang	HTML	Markdown
Dokumentasi Teknis & Manual Book — Pemeliharaan Terjadwal Asset Karyawan	HTML	Markdown
Dokumentasi Teknis & Manual Book — Peminjaman Asset Karyawan	HTML	Markdown
Dokumentasi Teknis & Manual Book — Penambahan Asset ke Ruangan Aktif (ALK-RGN04)	HTML	Markdown
Dokumentasi Teknis & Manual Book — Master Pendamping & Tugas PIC	HTML	Markdown
Dokumentasi Teknis & Manual Book — Perbaikan Asset (PML02)	HTML	Markdown
Dokumentasi Teknis & Manual Book — Request / Penambahan Asset Karyawan	HTML	Markdown
Dokumentasi Teknis & Manual Book — Retur Asset Karyawan	HTML	Markdown
Dokumentasi Teknis & Manual Book — Retur Asset Ruangan (ALK-RGN06)	HTML	Markdown
Dokumentasi Teknis & Manual Book — Upgrade Asset Karyawan	HTML	Markdown
Dokumentasi Teknis & Manual Book — Upgrade Komponen Aset Ruangan (ALK-RGN07)	HTML	Markdown
Dokumentasi Teknis — MinIO Object Storage (API)	HTML	Markdown