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:
@@ -0,0 +1,170 @@
|
||||
# 12 — Upgrade & Modernization Roadmap
|
||||
|
||||
**Tanggal Analisis:** 26 Oktober 2026
|
||||
**Prinsip Utama:** *Zero Downtime, Data Integrity First, Zero Business Disruption*
|
||||
**Dasar Penyusunan:** Hasil temuan audit statis kode, risiko keamanan terkonfirmasi, dan technical debt register.
|
||||
|
||||
---
|
||||
|
||||
## 1. Ikhtisar Fase Pengerjaan
|
||||
|
||||
Upgrade sistem dibagi menjadi 4 fase berurutan:
|
||||
- **Fase 0 (Minggu 1):** *Urgent Hotfix & Security Patching* (Tanpa migrasi skema besar).
|
||||
- **Fase 1 (Minggu 2-3):** *Core Data Integrity, Validation Hardening & Baseline Testing*.
|
||||
- **Fase 2 (Minggu 4-6):** *Architectural Refactoring (Modularization & Pagination)*.
|
||||
- **Fase 3 (Minggu 7-10):** *Feature Enhancements, RBAC & DevOps Modernization*.
|
||||
|
||||
---
|
||||
|
||||
## 2. Rincian Rencana per Fase
|
||||
|
||||
### FASE 0: Urgent Hotfix & Security Patching (Target: Hari ke 1 s/d 5)
|
||||
Fase ini berfokus pada penutupan celah keamanan terkonfirmasi dan perbaikan bug jalur routing tanpa mengubah logika database.
|
||||
|
||||
#### Item 0.1 — Penambahan Autentikasi pada Endpoint Tambah Aset (`TD-001`)
|
||||
- **Masalah:** Fungsi `asset_add` di `assets/views.py:192` tidak memiliki `@login_required`.
|
||||
- **Kondisi Eksisting:** Permintaan POST tanpa session login tetap diproses dan membuat record di tabel `assets_asset`.
|
||||
- **Target:** Endpoint menolak akses anonim dan me-redirect ke login.
|
||||
- **Langkah Perbaikan:**
|
||||
```python
|
||||
# assets/views.py
|
||||
@login_required
|
||||
def asset_add(request):
|
||||
# ... kode tetap sama ...
|
||||
```
|
||||
- **Kriteria Penerimaan:** Request `POST /aset/add/` tanpa cookie session mengembalikan HTTP 302 Redirect ke `/login/`.
|
||||
- **Rencana Rollback:** Hapus kembali baris `@login_required` jika terjadi gangguan autentikasi darurat.
|
||||
|
||||
#### Item 0.2 — Perbaikan URL Router Penghapusan Unit Fisik (`TD-002`)
|
||||
- **Masalah:** Fungsi `unit_delete` ada di `assets/views.py:410`, tetapi tidak didaftarkan pada `itam_core/urls.py`.
|
||||
- **Kondisi Eksisting:** Fitur delete unit mati/tidak dapat diakses.
|
||||
- **Target:** Rute terdaftar secara resmi dengan validasi POST method.
|
||||
- **Langkah Perbaikan:**
|
||||
Tambahkan baris berikut pada `itam_core/urls.py`:
|
||||
```python
|
||||
path('unit/<int:unit_id>/delete/', unit_delete, name='unit_delete'),
|
||||
```
|
||||
- **Kriteria Penerimaan:** Tombol hapus unit pada modal `asset_units.html` dapat mengirim request POST dan berhasil menghapus unit fisik serta mengurangi nilai `asset.qty`.
|
||||
|
||||
#### Item 0.3 — Sanitasi File Sensitif Repository (`TD-003`, `TD-024`)
|
||||
- **Masalah:** File `database_lokal.sql`, `seed_karyawan.sql`, `scratch_urls_all.py`, dan `scratch_fix_views2.py` berada di repository.
|
||||
- **Target:** File sensitif dihapus dari git tracking, `.gitignore` diperbarui.
|
||||
- **Langkah Perbaikan:**
|
||||
Tambahkan aturan ke `.gitignore`:
|
||||
```gitignore
|
||||
*.sql
|
||||
scratch_*.py
|
||||
error.log
|
||||
.env
|
||||
```
|
||||
Jalankan perintah `git rm --cached database_lokal.sql seed_karyawan.sql scratch_*.py`.
|
||||
|
||||
#### Item 0.4 — Normalisasi Encoding Dependensi (`TD-007`)
|
||||
- **Masalah:** Baris 15 file `requirements.txt` mengandung null-byte pada teks `openpyxl`.
|
||||
- **Target:** File `requirements.txt` diformat ulang menjadi standar UTF-8 bersih.
|
||||
|
||||
---
|
||||
|
||||
### FASE 1: Core Data Integrity & Baseline Testing (Target: Minggu 2 s/d 3)
|
||||
Fase ini memastikan integritas data penugasan unit dan memasang safety net berupa automated tests.
|
||||
|
||||
#### Item 1.1 — Koreksi Status Siklus Distribusi Pengembalian (`TD-008`)
|
||||
- **Masalah:** Saat proses `distribusi_return`, kolom `returned_date` dan status `AssetAssignment` tidak diperbarui.
|
||||
- **Target:** Record penugasan yang unitnya dikembalikan otomatis diubah statusnya menjadi `'dikembalikan'` dan tanggal kembali tercatat.
|
||||
- **Langkah Perbaikan:** Pada `assets/views.py:654` (`distribusi_return`):
|
||||
Update status assignment aktif sebelumnya menjadi `dikembalikan` dan isi `returned_date = assigned_date`.
|
||||
- **Kriteria Penerimaan:** Dalam laporan distribusi, status transaksi yang sudah kembali berstatus `'dikembalikan'`.
|
||||
|
||||
#### Item 1.2 — Penyeragaman Validasi Unggah Berkas BAST (`TD-006`)
|
||||
- **Masalah:** Form serah terima dan mutasi tidak memvalidasi jenis file atau ukuran berkas.
|
||||
- **Target:** Menerapkan fungsi validasi file upload terpusat (maks 5MB, format PDF/Word/Gambar).
|
||||
|
||||
#### Item 1.3 — Pembangunan Baseline Test Suite (`TD-004`)
|
||||
- **Target:** Membuat test suite awal dengan target coverage minimal 60% mencakup:
|
||||
1. `test_auth.py`: Proteksi seluruh rute login.
|
||||
2. `test_asset_lifecycle.py`: CRUD aset, pembuatan unit, update kode unit saat kode aset berganti.
|
||||
3. `test_distribution.py`: Serah terima, mutasi, dan pengembalian unit secara atomic.
|
||||
4. `test_employee.py`: Validasi NIK dan proteksi hapus karyawan yang memegang aset.
|
||||
|
||||
---
|
||||
|
||||
### FASE 2: Architectural Refactoring (Target: Minggu 4 s/d 6)
|
||||
Fase ini mengurai technical debt berat pada kode backend tanpa merusak antarmuka pengguna.
|
||||
|
||||
#### Item 2.1 — Dekomposisi "God File" `assets/views.py` (`TD-005`)
|
||||
- **Target:** Memecah 3.056 baris kode menjadi modul-modul independen:
|
||||
```
|
||||
assets/views/
|
||||
├── __init__.py # Export all view functions agar tidak merusak urls.py
|
||||
├── auth_views.py # login, logout, profile
|
||||
├── dashboard_views.py # dashboard
|
||||
├── asset_views.py # asset_list, asset_add, asset_edit, asset_delete
|
||||
├── unit_views.py # asset_units, unit_add, unit_edit, unit_delete, unit_status
|
||||
├── distribution_views.py# handover, mutation, return, upload_doc
|
||||
├── employee_views.py # employee CRUD & detail
|
||||
├── qr_views.py # qr code generator & public detail
|
||||
├── report_pdf.py # Seluruh fungsi export PDF
|
||||
├── report_excel.py # Seluruh fungsi export Excel
|
||||
└── backup_views.py # backup_database_view
|
||||
```
|
||||
- **Kriteria Penerimaan:** Seluruh test suite Fase 1 tetap lulus hijau (100% regression pass).
|
||||
|
||||
#### Item 2.2 — Sentralisasi Report Builder (ReportLab & openpyxl) (`TD-010`)
|
||||
- **Target:** Membuat helper `BasePDFReport` dan `BaseExcelReport` untuk mengeliminasi ~1.500 baris duplikasi layout.
|
||||
|
||||
#### Item 2.3 — Implementasi Pagination Global (`TD-009`)
|
||||
- **Target:** Menerapkan paginasi pada `asset_list`, `status_aset_list`, `distribusi_list`, dan `employee_list` dengan limit 25 item per halaman.
|
||||
|
||||
#### Item 2.4 — Migrasi Soft Delete Karyawan (`TD-011`)
|
||||
- **Target:** Menambahkan field `is_active` pada `Employee` dan mengeliminasi ketergantungan pada parsing regex catatan string.
|
||||
|
||||
---
|
||||
|
||||
### FASE 3: Modernisasi & Fitur Lanjutan (Target: Minggu 7 s/d 10)
|
||||
Fase peningkatan kapabilitas operasional dan kesiapan enterprise.
|
||||
|
||||
#### Item 3.1 — Penerapan Role-Based Access Control (RBAC) (`TD-016`)
|
||||
- **Target:** Membedakan peran pengguna:
|
||||
1. **Super Admin IT:** Akses penuh konfigurasi sistem & backup database.
|
||||
2. **Teknisi IT / Operator:** Dapat melakukan CRUD aset, unit, dan distribusi serah terima.
|
||||
3. **Auditor / Management (Read-Only):** Hanya dapat melihat dashboard dan mengekspor laporan PDF/Excel.
|
||||
|
||||
#### Item 3.2 — Kontainerisasi Docker & CI/CD Pipeline (`TD-017`)
|
||||
- **Target:**
|
||||
1. `Dockerfile` berbasis multi-stage build (Node build + Python slim runtime).
|
||||
2. `docker-compose.yml` yang mencakup App Django, MySQL 8, dan Nginx Reverse Proxy.
|
||||
3. GitHub Actions workflow untuk otomatisasi running `pytest` dan linting pada setiap pull request.
|
||||
|
||||
#### Item 3.3 — Perbaikan Label Status Unit (`TD-012`)
|
||||
- **Target:** Migrasi data nilai status dari choice value `'rusak'` menjadi `'maintenance'` (Dalam Pemeliharaan) agar konsisten antara frontend dan database.
|
||||
|
||||
---
|
||||
|
||||
## 3. Rangkuman Roadmap Diagram (Gantt Visual)
|
||||
|
||||
```mermaid
|
||||
gantt
|
||||
title Roadmap Upgrade & Refactoring Sistem Aset IT KMH
|
||||
dateFormat YYYY-MM-DD
|
||||
section Fase 0: Urgent Hotfixes
|
||||
Fix asset_add Auth (P0) :done, f0_1, 2026-11-01, 2d
|
||||
Fix unit_delete Router (P0) :done, f0_2, after f0_1, 1d
|
||||
Sanitasi File SQL & Scratch (P0) :done, f0_3, 2026-11-01, 2d
|
||||
Fix requirements.txt (P1) :done, f0_4, 2026-11-02, 1d
|
||||
|
||||
section Fase 1: Data Integrity & Test
|
||||
Koreksi Status Return Distribusi :active, f1_1, 2026-11-04, 3d
|
||||
Validasi File Upload BAST :f1_2, after f1_1, 2d
|
||||
Pembangunan Test Suite (pytest) :f1_3, 2026-11-08, 10d
|
||||
|
||||
section Fase 2: Refactoring
|
||||
Dekomposisi views.py :f2_1, after f1_3, 7d
|
||||
Sentralisasi Report Builders :f2_2, after f2_1, 5d
|
||||
Implementasi Pagination Global :f2_3, after f2_2, 4d
|
||||
Soft Delete Karyawan :f2_4, after f2_3, 3d
|
||||
|
||||
section Fase 3: Modernisasi
|
||||
Penerapan RBAC Multi-Role :f3_1, 2026-12-08, 10d
|
||||
Docker & CI/CD Pipeline :f3_2, after f3_1, 5d
|
||||
Normalisasi Status Unit :f3_3, after f3_2, 3d
|
||||
```
|
||||
Reference in New Issue
Block a user