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)
This commit is contained in:
nuexn0x-9
2026-10-27 09:42:15 +07:00
commit f28983011c
110 changed files with 20296 additions and 0 deletions
+105
View File
@@ -0,0 +1,105 @@
# 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.