- 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)
64 lines
5.8 KiB
Markdown
64 lines
5.8 KiB
Markdown
# 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:
|
|
1. [`00-executive-summary.md`](00-executive-summary.md) — Ringkasan kondisi sistem, temuan kritis, dan status kesiapan.
|
|
2. [`02-prd-as-is.md`](02-prd-as-is.md) — Penjelasan fungsionalitas aplikasi apa adanya berdasarkan kode yang ada.
|
|
3. [`12-upgrade-roadmap.md`](12-upgrade-roadmap.md) — Rencana tahapan modernisasi dan peningkatan sistem.
|
|
4. [`13-open-questions.md`](13-open-questions.md) — Daftar pertanyaan bisnis yang butuh klarifikasi manajemen.
|
|
|
|
### Alur Lengkap untuk Technical Lead & Developer Pengembang:
|
|
1. [`00-executive-summary.md`](00-executive-summary.md) — Konteks umum dan temuan P0.
|
|
2. [`01-system-overview.md`](01-system-overview.md) — Arsitektur sistem, stack teknologi, dan alur request.
|
|
3. [`04-database-data-dictionary.md`](04-database-data-dictionary.md) — Kamus data, model ORM, dan Diagram Relasi ERD.
|
|
4. [`16-source-map.md`](16-source-map.md) — Peta lokasi file, tanggung jawab modul, dan zona rawan regresi.
|
|
5. [`03-feature-inventory.md`](03-feature-inventory.md) & [`06-api-documentation.md`](06-api-documentation.md) — Katalog fitur lengkap dan routing URL.
|
|
6. [`05-roles-permissions.md`](05-roles-permissions.md) — Alur autentikasi dan model otorisasi pengguna.
|
|
7. [`07-security-audit.md`](07-security-audit.md) — Laporan audit celah keamanan terkonfirmasi.
|
|
8. [`08-code-quality-audit.md`](08-code-quality-audit.md) & [`11-technical-debt.md`](11-technical-debt.md) — Daftar utang teknis dan anti-pattern.
|
|
9. [`09-test-strategy.md`](09-test-strategy.md) — Rencana pengujian otomatis (*testing gaps*).
|
|
10. [`10-deployment-operations.md`](10-deployment-operations.md) — Panduan instalasi dan operasional server.
|
|
11. [`14-traceability-matrix.md`](14-traceability-matrix.md) — Matriks penelusuran requirement ke baris kode.
|
|
12. [`15-glossary.md`](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`](00-executive-summary.md) | Executive Summary | Ringkasan kondisi repository, kekuatan, kelemahan, dan temuan kritis P0 |
|
|
| **01** | [`01-system-overview.md`](01-system-overview.md) | System Overview | Arsitektur Django monolith, diagram alur HTTP request, dan batasan sistem |
|
|
| **02** | [`02-prd-as-is.md`](02-prd-as-is.md) | PRD As-Is | Spesifikasi kebutuhan fungsional (FR) dan non-fungsional (NFR) eksisting |
|
|
| **03** | [`03-feature-inventory.md`](03-feature-inventory.md) | Feature Inventory | Katalog 49 fitur aplikasi beserta status implementasi dan risikonya |
|
|
| **04** | [`04-database-data-dictionary.md`](04-database-data-dictionary.md) | Database & Data Dictionary | Spesifikasi tabel, kolom, constraint, relasi ForeignKey, dan Diagram ERD Mermaid |
|
|
| **05** | [`05-roles-permissions.md`](05-roles-permissions.md) | Roles & Permissions | Mekanisme autentikasi login, ketiadaan RBAC, dan analisis kontrol akses |
|
|
| **06** | [`06-api-documentation.md`](06-api-documentation.md) | API & URL Catalog | Dokumentasi 42 pola URL, parameter query HTTP, dan tipe respon |
|
|
| **07** | [`07-security-audit.md`](07-security-audit.md) | Security Audit Report | Temuan kerentanan kode (*Broken Access Control*, *Insecure Upload*, dll.) |
|
|
| **08** | [`08-code-quality-audit.md`](08-code-quality-audit.md) | Code Quality Audit | Analisis masalah *God File* 3.056 baris, duplikasi kode ReportLab/openpyxl |
|
|
| **09** | [`09-test-strategy.md`](09-test-strategy.md) | Test Strategy & Plan | Analisis ketiadaan automated test (0%) dan rancangan prioritas test case |
|
|
| **10** | [`10-deployment-operations.md`](10-deployment-operations.md) | Deployment & Ops Runbook | Panduan instalasi Gunicorn, Nginx, Systemd, Backup/Restore, dan Environment |
|
|
| **11** | [`11-technical-debt.md`](11-technical-debt.md) | Technical Debt Register | Daftar terperinci 17 item utang teknis lengkap dengan effort dan prioritas |
|
|
| **12** | [`12-upgrade-roadmap.md`](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`](13-open-questions.md) | Open Questions | Pertanyaan klarifikasi domain bisnis dan operasional untuk stakeholder |
|
|
| **14** | [`14-traceability-matrix.md`](14-traceability-matrix.md) | Traceability Matrix | Pemetaan keterlacakan requirement -> URL -> View -> Model -> Risiko |
|
|
| **15** | [`15-glossary.md`](15-glossary.md) | Glossary | Kamus istilah domain ITAM dan peristilahan teknis PLTA Kerinci |
|
|
| **16** | [`16-source-map.md`](16-source-map.md) | Source Code Map | Peta tanggung jawab file kode sumber dan identifikasi zona rawan regresi |
|
|
|
|
---
|
|
|
|
## 3. Komitmen Integritas Pemeriksaan
|
|
|
|
1. **Prinsip Read-Only:** Pemeriksaan ini dilakukan sepenuhnya dalam mode baca tanpa mengubah kode aplikasi (`assets/`, `itam_core/`, `templates/`, `static/`).
|
|
2. **Ketiadaan Data Rahasia:** Seluruh dokumen ini tidak memuat password, secret key produksi, NIK riil, atau data pribadi karyawan.
|
|
3. **Berbasis Bukti Nyata:** Seluruh klaim temuan diverifikasi langsung melalui nomor baris dan struktur kode sumber yang ada di dalam repository.
|