Files
KMH_IT_Assets/docs/analysis/16-source-map.md
T
nuexn0x-9 f28983011c feat: implement consumable inventory module, network LAN access, and CI/CD enhancements
- 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)
2026-10-27 09:42:15 +07:00

106 lines
7.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 16 — Source Code Map & Responsibility Guide
**Tanggal Analisis:** 26 Oktober 2026
**Status Verifikasi:** Terverifikasi via code indexing statis
---
## 1. Peta Pohon Direktori & Komponen
```
manajemen-aset-it-ptkmh-master/
├── assets/ # Django App Utama (Domain IT Asset Management)
│ ├── admin.py # Konfigurasi antarmuka Django Admin (5 Model terdaftar)
│ ├── apps.py # AppConfig ('assets')
│ ├── models.py # 6 Model Data Inti & Logic Sync Kode Unit
│ ├── tests.py # Placeholder test (Kosong / 0% coverage)
│ ├── views.py # Monolithic Views (3.056 baris - Seluruh Controller)
│ ├── management/
│ │ └── commands/
│ │ ├── seed_initial_data.py # Seeding kategori default ('Karyawan', 'Network')
│ │ └── setup_superuser.py # Pembuatan superuser otomatis via ENV
│ └── migrations/ # 16 Migrasi database terurut
├── itam_core/ # Konfigurasi Proyek Django
│ ├── asgi.py # ASGI entry point
│ ├── settings.py # Global settings (DB MySQL, Auth, WhiteNoise, Logging)
│ ├── urls.py # Master routing (42 rute terdaftar)
│ └── wsgi.py # WSGI entry point untuk web server produksi
├── frontend/ # Source Aset Frontend Vite
│ ├── main.js # Entrypoint script Vite
│ └── style.css # Directive TailwindCSS (@tailwind base, etc.)
├── static/ # Direktori Aset Statis
│ ├── dist/style.css # CSS hasil kompilasi Tailwind final (~68 KB)
│ └── img/ # Aset grafis & logo perusahaan
│ ├── kerinci_logo.png # Logo resmi Kerinci Hydropower (dipakai di PDF & Header)
│ ├── it_all_role_logo.png# Logo divisi IT All Role (dipakai di PDF report)
│ └── main_logo.png # Logo sidebar aplikasi web
├── templates/ # Template HTML (Django DTL)
│ ├── base.html # Master layout (Sidebar, Navbar, Toasts, Guide Modal)
│ ├── login.html # Halaman autentikasi kredensial
│ ├── dashboard.html # Halaman beranda ringkasan statistik
│ ├── asset_list.html # Daftar master jenis aset (Tab Karyawan & Network)
│ ├── asset_units.html # Daftar unit fisik per jenis aset
│ ├── distribusi_list.html # Modul transaksi (Serah Terima, Mutasi, Return)
│ ├── status_aset_list.html # Monitoring unit per status operasional
│ ├── employee_list.html # Master data karyawan
│ ├── employee_detail.html # Rincian aset yang dipegang seorang karyawan
│ ├── unit_history.html # Timeline audit log pergerakan unit
│ ├── unit_public_detail.html # Halaman publik yang dibuka saat scan QR Code
│ ├── backup.html # Antarmuka ekspor database JSON / SQL
│ └── 404.html # Custom error page
├── media/ # Upload runtime (Akan dibuat otomatis saat ada berkas)
│ └── bast_documents/ # Dokumen scan fisik BAST serah terima
├── .env.example # Template konfigurasi variabel lingkungan
├── manage.py # CLI controller Django
├── package.json # Dependensi frontend (Tailwind v3.4, Vite v5.4, HTMX v2.0)
└── requirements.txt # Dependensi Python backend
```
---
## 2. Peta Fungsi Controller (`assets/views.py`)
File `assets/views.py` (3.056 baris) terbagi secara logis menjadi kelompok fungsi berikut:
| Kelompok Tanggung Jawab | Baris Awal – Akhir | Daftar Fungsi Utama | Model yang Terpengaruh | Tingkat Risiko Regresi Saat Diedit |
|---|---|---|---|---|
| **Dashboard Metrik** | L16 – L42 | `dashboard` | `AssetUnit`, `AssetAssignment` | Rendah |
| **Master Aset (SKU)** | L44 – L259 | `asset_list`, `asset_add`, `asset_edit`, `asset_delete` | `Asset`, `Category`, `AssetUnit` | **Sangat Tinggi** (Mengubah kode aset induk memicu auto-update ke seluruh unit anak) |
| **Unit Fisik Individual** | L260 – L441 | `asset_units`, `unit_add`, `unit_edit`, `unit_update_status`, `unit_delete`, `unit_history` | `AssetUnit`, `UnitLog`, `Employee` | **Tinggi** (Perubahan status unit memicu penulisan riwayat `UnitLog`) |
| **Status & Monitoring** | L442 – L489 | `status_aset_list` | `AssetUnit`, `Category` | Rendah |
| **Sirkulasi Distribusi** | L490 – L710 | `distribusi_list`, `distribusi_handover`, `distribusi_mutation`, `distribusi_return`, `distribusi_upload_doc` | `AssetAssignment`, `AssetUnit`, `UnitLog`, `Employee` | **Kritis** (Transaksi multi-tabel berbasis `@transaction.atomic`) |
| **Master Karyawan** | L711 – L801 | `employee_list`, `employee_detail`, `employee_create`, `employee_edit`, `employee_delete` | `Employee`, `AssetUnit`, `UnitLog` | **Tinggi** (Delete karyawan memodifikasi catatan log masa lalu via regex) |
| **QR Code & Publik** | L802 – L856 | `unit_qr_code`, `unit_public_detail` | `AssetUnit`, `UnitLog` | Sedang (Bergantung pada Pillow & font OS) |
| **Laporan Dokumen PDF** | L857 – L2440 | `asset_export_pdf`, `distribusi_export_pdf`, `status_aset_export_pdf`, `employee_export_pdf`, `employee_detail_export_pdf`, `unit_history_export_pdf`, `asset_units_export_pdf` | Read-only semua model | Sedang (Tinggi pada duplikasi kode ReportLab) |
| **Autentikasi & Akun** | L2441 – L2534 | `login_view`, `logout_view`, `custom_404_view`, `profile_view` | `User` | Sedang |
| **Pencadangan Database**| L2535 – L2596 | `backup_database_view` | Seluruh Database | **Kritis** (Menjalankan `dumpdata` dan subprocess `mysqldump`) |
| **Laporan Spreadsheet Excel** | L2597 – L3056 | `distribusi_export_excel`, `status_aset_export_excel`, `employee_export_excel`, `employee_detail_export_excel`, `unit_history_export_excel`, `asset_units_export_excel`, `asset_export_excel` | Read-only semua model | Rendah |
---
## 3. Matriks Ketergantungan Antar-Komponen (Cross-Dependency Risk)
```mermaid
graph TD
Asset["Model: Asset (Master)"]
AssetUnit["Model: AssetUnit (Fisik)"]
Employee["Model: Employee (User)"]
UnitLog["Model: UnitLog (Audit Ledger)"]
AssetAssignment["Model: AssetAssignment (Transaksi)"]
Asset -->|"CASCADE DELETE & Batch Code Update"| AssetUnit
AssetUnit -->|"CASCADE DELETE"| UnitLog
AssetUnit -->|"PROTECT (Dilarang Hapus jika ada transaksi)"| AssetAssignment
Employee -->|"SET NULL (Dicegah jika punya unit)"| AssetUnit
Employee -->|"SET NULL & Embed Nama ke String"| UnitLog
Employee -->|"SET NULL"| AssetAssignment
```
### Zona Rawan Regresi Tinggi (*High-Impact Regression Zones*)
1. **Modifikasi `Asset.save()` (`assets/models.py:39-83`):**
Metode ini memuat algoritma iterasi yang mengubah string `unit_code` dari seluruh unit yang berelasi jika `asset_code` berubah. Menyentuh fungsi ini berisiko merusak penomoran kode unit fisik di lapangan.
2. **Modifikasi Alur `distribusi_*` (`assets/views.py:576-687`):**
Setiap fungsi distribusi memanipulasi minimal 3 tabel secara bersamaan (`AssetAssignment`, `AssetUnit`, dan `UnitLog`). Kegagalan salah satu instruksi dapat menyebabkan inkonsistensi state jika tidak dibungkus atomic block secara benar.
3. **Modifikasi `employee_delete` (`assets/views.py:784-800`):**
Proses penghapusan karyawan menimpa field `UnitLog.notes` dengan format teks tertentu. Mengubah format ini akan merusak fungsi `unit_history` dan fungsi export riwayat yang membaca format tersebut dengan regex.