- 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)
8.5 KiB
8.5 KiB
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_adddiassets/views.py:192tidak 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:
# 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_requiredjika terjadi gangguan autentikasi darurat.
Item 0.2 — Perbaikan URL Router Penghapusan Unit Fisik (TD-002)
- Masalah: Fungsi
unit_deleteada diassets/views.py:410, tetapi tidak didaftarkan padaitam_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:path('unit/<int:unit_id>/delete/', unit_delete, name='unit_delete'), - Kriteria Penerimaan: Tombol hapus unit pada modal
asset_units.htmldapat mengirim request POST dan berhasil menghapus unit fisik serta mengurangi nilaiasset.qty.
Item 0.3 — Sanitasi File Sensitif Repository (TD-003, TD-024)
- Masalah: File
database_lokal.sql,seed_karyawan.sql,scratch_urls_all.py, danscratch_fix_views2.pyberada di repository. - Target: File sensitif dihapus dari git tracking,
.gitignorediperbarui. - Langkah Perbaikan:
Tambahkan aturan ke
.gitignore:Jalankan perintah*.sql scratch_*.py error.log .envgit rm --cached database_lokal.sql seed_karyawan.sql scratch_*.py.
Item 0.4 — Normalisasi Encoding Dependensi (TD-007)
- Masalah: Baris 15 file
requirements.txtmengandung null-byte pada teksopenpyxl. - Target: File
requirements.txtdiformat 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, kolomreturned_datedan statusAssetAssignmenttidak 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 menjadidikembalikandan isireturned_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:
test_auth.py: Proteksi seluruh rute login.test_asset_lifecycle.py: CRUD aset, pembuatan unit, update kode unit saat kode aset berganti.test_distribution.py: Serah terima, mutasi, dan pengembalian unit secara atomic.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
BasePDFReportdanBaseExcelReportuntuk 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, danemployee_listdengan limit 25 item per halaman.
Item 2.4 — Migrasi Soft Delete Karyawan (TD-011)
- Target: Menambahkan field
is_activepadaEmployeedan 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:
- Super Admin IT: Akses penuh konfigurasi sistem & backup database.
- Teknisi IT / Operator: Dapat melakukan CRUD aset, unit, dan distribusi serah terima.
- Auditor / Management (Read-Only): Hanya dapat melihat dashboard dan mengekspor laporan PDF/Excel.
Item 3.2 — Kontainerisasi Docker & CI/CD Pipeline (TD-017)
- Target:
Dockerfileberbasis multi-stage build (Node build + Python slim runtime).docker-compose.ymlyang mencakup App Django, MySQL 8, dan Nginx Reverse Proxy.- GitHub Actions workflow untuk otomatisasi running
pytestdan 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)
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