- 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.1 KiB
8.1 KiB
11 — Technical Debt Register
Tanggal Analisis: 26 Oktober 2026
Status Verifikasi: Terverifikasi via code inspection komprehensif
1. Skala Penilaian
- Prioritas:
- P0: Kerusakan integritas data atau risiko keamanan mendesak.
- P1: Penghambat langsung terhadap pengembangan fitur baru dan reliabilitas.
- P2: Penurunan kualitas kode, pemeliharaan (maintainability), dan performa.
- P3: Refactoring estetika, optimasi jangka panjang.
- Estimasi Effort:
- S (Small): < 4 jam kerja.
- M (Medium): 1 – 3 hari kerja.
- L (Large): 1 – 2 minggu kerja.
- XL (Extra Large): > 2 minggu kerja (perlu perombakan arsitektural).
2. Register Technical Debt Terperinci
| Debt ID | Deskripsi Masalah | Bukti Lokasi di Repo | Dampak Teknis | Prioritas | Effort | Ketergantungan (Dependencies) | Rekomendasi Solusi | Risiko Jika Ditunda |
|---|---|---|---|---|---|---|---|---|
| TD-001 | asset_add tidak dilindungi autentikasi |
assets/views.py:192 |
Pengguna anonim dapat memasukkan data aset ilegal via POST | P0 | S | Tidak ada | Tambahkan dekorator @login_required di atas asset_add |
Serangan data injection / spamming master aset |
| TD-002 | View unit_delete tidak didaftarkan pada URL router |
assets/views.py:410 vs itam_core/urls.py |
Fitur penghapusan unit aset fisik tidak bisa diakses sama sekali (broken/dead code) | P0 | S | Konfirmasi bisnis flow penghapusan unit | Daftarkan rute path('unit/<int:unit_id>/delete/', unit_delete, name='unit_delete') atau hapus fungsinya jika unit tidak boleh dihapus |
Admin tidak dapat membersihkan data unit yang salah input |
| TD-003 | File dump database SQL development tersimpan di repository git | database_lokal.sql, seed_karyawan.sql |
Potensi bocornya data identitas karyawan (NIK & Nama) jika repo dibagikan | P0 | S | Tidak ada | Hapus kedua file dari git tracking dan daftarkan ekstensi *.sql ke .gitignore |
Pelanggaran privasi data dan kebocoran struktur data internal |
| TD-004 | Ketiadaan automated test suite (0% Coverage) | assets/tests.py |
Tidak ada safety net saat melakukan upgrade dependensi atau refactor | P1 | L | TD-005 (pemecahan views mempermudah testing) | Tulis unit test model, form, dan view menggunakan pytest-django | Risiko regresi sangat tinggi setiap kali ada kode yang disentuh |
| TD-005 | God file pada assets/views.py (3.056 baris) |
assets/views.py |
Sulit dipelihara, conflict-prone, mencampuradukkan controller, reporting, dan logic | P1 | L | TD-004 (buat baseline test sebelum split) | Pecah file menjadi package modul views/ per domain |
Melambatnya kecepatan development dan tingginya potensi conflict |
| TD-006 | File upload BAST pada serah terima awal tidak divalidasi | assets/views.py:584, 619, 659 |
Pengguna dapat mengunggah file berbahaya (skrip/executable) atau file raksasa | P1 | S | Tidak ada | Samakan validasi ekstensi (.pdf, .doc, .jpg) dan batas 5MB seperti di distribusi_upload_doc |
Server kehabisan storage atau tersimpan file berbahaya |
| TD-007 | Encoding anomali pada requirements.txt baris 15 |
requirements.txt:15 |
Teks o p e n p y x l = = 3 . 1 . 2 mengandung spasi/null byte UTF-16 |
P1 | S | Tidak ada | Format ulang baris menjadi openpyxl==3.1.2 standar UTF-8 |
pip install -r requirements.txt bisa gagal di environment build CI Linux |
| TD-008 | Inkonsistensi update kolom returned_date dan status pada AssetAssignment |
assets/views.py:654-686 |
Record transaksi distribusi tidak menandai bahwa masa pinjam telah berakhir | P1 | S | Tidak ada | Update assignment.returned_date = assigned_date dan assignment.status = 'dikembalikan' pada transaksi return |
Data riwayat distribusi tidak akurat dalam laporan audit penugasan |
| TD-009 | Ketiadaan pagination di seluruh halaman tabel utama | assets/views.py (semua fungsi *_list) |
Query memuat seluruh baris database ke memori sekaligus | P2 | M | Modifikasi template HTML untuk kontrol pagination | Terapkan django.core.paginator.Paginator per 25-50 baris data |
Server mengalami memory spike dan browser lambat saat data mencapai ribuan unit |
| TD-010 | Duplikasi layouting PDF ReportLab secara repetitif | assets/views.py:857-2440 (~1.500 baris duplikasi) |
Setiap perubahan header/logo harus diedit manual pada 7 fungsi terpisah | P2 | M | TD-005 | Buat utility builder class PDF Report terpusat | Inkonsistensi format laporan antar modul jika ada update |
| TD-011 | Mekanisme parsing nama karyawan yang dihapus menggunakan Regex | assets/views.py:428-438, 792-796 |
Fragile: nama dengan karakter tanda kurung dapat merusak parsing riwayat log | P2 | M | Skema migrasi model Employee | Terapkan soft delete (is_active=False) pada tabel Employee daripada hard delete |
Catatan riwayat mutasi aset menjadi korup atau hilang keterhubungannya |
| TD-012 | Inkonsistensi nilai status 'rusak' dengan display label 'Diperbaiki' |
assets/models.py:89 |
Membingungkan pengguna: apakah unit sedang rusak, atau sudah selesai diperbaiki? | P2 | S | Migrasi data nilai status | Ubah value choice menjadi 'maintenance' dengan label 'Dalam Pemeliharaan' |
Kesalahpahaman operasional teknisi lapangan |
| TD-013 | Field mati/legacy pada model Asset (sum_qty, price, total_price) |
assets/models.py:27-31 |
Kolom ada di tabel namun tidak pernah dihitung, diinput, ataupun divalidasi | P2 | M | Analisis kebutuhan financial tracking | Putuskan apakah akan diaktifkan fitur valuasi aset finansial atau dibersihkan via migrasi | Kebingungan arsitektur data bagi developer penerus |
| TD-014 | Filtering kategori berbasis string icontains='Network' |
assets/views.py (berbagai baris) |
Sangat rentan error jika nama kategori diubah di database | P2 | S | Skema Category model | Tambahkan kolom Category.code atau Category.category_type (Enum) |
Fitur filter kategori rusak jika nama kategori diedit user |
| TD-015 | Password database terekspos di argumen proses mysqldump |
assets/views.py:2566 |
Password database dapat dibaca via ps aux pada server Linux |
P2 | S | Tidak ada | Gunakan opsi environment MYSQL_PWD atau file konfigurasi --defaults-extra-file |
Kredensial database bocor ke pengguna non-root lokal |
| TD-016 | Ketiadaan mekanisme Role-Based Access Control (RBAC) | assets/views.py |
Setiap user yang login memiliki otoritas yang sama persis (Full Admin) | P3 | L | Kebutuhan bisnis aktor | Implementasikan Django Groups & Permissions (misal: Admin IT, Staff Teknisi, Auditor Read-Only) | Penyalahgunaan wewenang atau ketidaksengajaan edit/hapus data oleh staff biasa |
| TD-017 | Tidak adanya Containerization (Docker) dan CI/CD | Root repository | Setup environment baru bergantung pada panduan manual dan rentan perbedaan OS | P3 | M | TD-007, TD-010 | Buat Dockerfile, docker-compose.yml, dan pipeline GitHub Actions |
Waktu onboarding lambat dan potensi masalah "it works on my machine" |
3. Matriks Kuadran Dampak vs Effort
TINGGI ▲
│ [TD-001] Fix asset_add Auth [TD-005] Split God File views.py
D │ [TD-002] Fix unit_delete Router [TD-004] Tulis Unit Test Suite
A │ [TD-003] Bersihkan SQL Repo [TD-009] Pagination Implementation
M │ [TD-006] Validasi File Upload [TD-010] PDF Builder Refactor
P │ [TD-008] Fix Return Status
A │-----------------------------------------------------------------
K │ [TD-007] Fix requirements.txt [TD-011] Soft Delete Employee
│ [TD-012] Fix Status Label [TD-013] Bersihkan Field Legacy
RENDAH │ [TD-014] Category Code Enum [TD-016] RBAC Implementation
│ [TD-015] Hardening mysqldump [TD-017] Docker & CI/CD Pipeline
└─────────────────────────────────────────────────────────────────►
RENDAH (S) TINGGI (M - XL)
E F F O R T