- Modul Consumable Item: model master, buku besar transaksi (stock ledger), purchase unit conversion, stock opname, dan transaction reversal - Integrasi ke Employee Management, Asset Unit, dan tiket/work order - Konfigurasi akses jaringan lokal (LAN) via 0.0.0.0:8000, ALLOWED_HOSTS, dan CSRF_TRUSTED_ORIGINS otomatis - Script pembuka firewall Windows (buka_firewall_lan.bat) dan menu interaktif run.bat - Skema migrasi 0019_consumableitem_consumabletransaction - Seeder 11 item consumable riil (seed_consumables.py) - Test suite komprehensif (41 automated tests, 100% lulus) - Pipeline CI/CD GitHub Actions (.github/workflows/ci.yml)
Dokumentasi Analisis & Audit Rekayasa Sistem (IT Asset Management PT KMH)
Selamat datang di direktori dokumentasi resmi hasil Reverse Engineering, System Audit, dan Technical Blueprint untuk aplikasi Sistem Informasi Manajemen Aset IT — PT. KMH (Kerinci Hydropower).
Dokumentasi ini disusun oleh AI Lead Software Architect & Technical Auditor pada 26 Oktober 2026 berdasarkan inspeksi kode sumber secara mendalam (read-only static analysis) tanpa mengubah state maupun kode aplikasi eksisting.
1. Panduan Urutan Membaca (Recommended Reading Order)
Untuk memahami aplikasi ini secara efektif, disarankan membaca dokumen dengan alur berikut sesuai dengan peran Anda:
Alur Cepat untuk Stakeholder / Project Manager:
00-executive-summary.md— Ringkasan kondisi sistem, temuan kritis, dan status kesiapan.02-prd-as-is.md— Penjelasan fungsionalitas aplikasi apa adanya berdasarkan kode yang ada.12-upgrade-roadmap.md— Rencana tahapan modernisasi dan peningkatan sistem.13-open-questions.md— Daftar pertanyaan bisnis yang butuh klarifikasi manajemen.
Alur Lengkap untuk Technical Lead & Developer Pengembang:
00-executive-summary.md— Konteks umum dan temuan P0.01-system-overview.md— Arsitektur sistem, stack teknologi, dan alur request.04-database-data-dictionary.md— Kamus data, model ORM, dan Diagram Relasi ERD.16-source-map.md— Peta lokasi file, tanggung jawab modul, dan zona rawan regresi.03-feature-inventory.md&06-api-documentation.md— Katalog fitur lengkap dan routing URL.05-roles-permissions.md— Alur autentikasi dan model otorisasi pengguna.07-security-audit.md— Laporan audit celah keamanan terkonfirmasi.08-code-quality-audit.md&11-technical-debt.md— Daftar utang teknis dan anti-pattern.09-test-strategy.md— Rencana pengujian otomatis (testing gaps).10-deployment-operations.md— Panduan instalasi dan operasional server.14-traceability-matrix.md— Matriks penelusuran requirement ke baris kode.15-glossary.md— Kamus istilah domain ITAM dan PLTA PT KMH.
2. Indeks Dokumen Terperinci
| No | File Dokumen | Judul Dokumen | Ruang Lingkup Utama |
|---|---|---|---|
| 00 | 00-executive-summary.md |
Executive Summary | Ringkasan kondisi repository, kekuatan, kelemahan, dan temuan kritis P0 |
| 01 | 01-system-overview.md |
System Overview | Arsitektur Django monolith, diagram alur HTTP request, dan batasan sistem |
| 02 | 02-prd-as-is.md |
PRD As-Is | Spesifikasi kebutuhan fungsional (FR) dan non-fungsional (NFR) eksisting |
| 03 | 03-feature-inventory.md |
Feature Inventory | Katalog 49 fitur aplikasi beserta status implementasi dan risikonya |
| 04 | 04-database-data-dictionary.md |
Database & Data Dictionary | Spesifikasi tabel, kolom, constraint, relasi ForeignKey, dan Diagram ERD Mermaid |
| 05 | 05-roles-permissions.md |
Roles & Permissions | Mekanisme autentikasi login, ketiadaan RBAC, dan analisis kontrol akses |
| 06 | 06-api-documentation.md |
API & URL Catalog | Dokumentasi 42 pola URL, parameter query HTTP, dan tipe respon |
| 07 | 07-security-audit.md |
Security Audit Report | Temuan kerentanan kode (Broken Access Control, Insecure Upload, dll.) |
| 08 | 08-code-quality-audit.md |
Code Quality Audit | Analisis masalah God File 3.056 baris, duplikasi kode ReportLab/openpyxl |
| 09 | 09-test-strategy.md |
Test Strategy & Plan | Analisis ketiadaan automated test (0%) dan rancangan prioritas test case |
| 10 | 10-deployment-operations.md |
Deployment & Ops Runbook | Panduan instalasi Gunicorn, Nginx, Systemd, Backup/Restore, dan Environment |
| 11 | 11-technical-debt.md |
Technical Debt Register | Daftar terperinci 17 item utang teknis lengkap dengan effort dan prioritas |
| 12 | 12-upgrade-roadmap.md |
Modernization Roadmap | Rencana upgrade 4 fase (Fase 0 s/d Fase 3) dengan kriteria penerimaan dan rollback |
| 13 | 13-open-questions.md |
Open Questions | Pertanyaan klarifikasi domain bisnis dan operasional untuk stakeholder |
| 14 | 14-traceability-matrix.md |
Traceability Matrix | Pemetaan keterlacakan requirement -> URL -> View -> Model -> Risiko |
| 15 | 15-glossary.md |
Glossary | Kamus istilah domain ITAM dan peristilahan teknis PLTA Kerinci |
| 16 | 16-source-map.md |
Source Code Map | Peta tanggung jawab file kode sumber dan identifikasi zona rawan regresi |
3. Komitmen Integritas Pemeriksaan
- Prinsip Read-Only: Pemeriksaan ini dilakukan sepenuhnya dalam mode baca tanpa mengubah kode aplikasi (
assets/,itam_core/,templates/,static/). - Ketiadaan Data Rahasia: Seluruh dokumen ini tidak memuat password, secret key produksi, NIK riil, atau data pribadi karyawan.
- Berbasis Bukti Nyata: Seluruh klaim temuan diverifikasi langsung melalui nomor baris dan struktur kode sumber yang ada di dalam repository.