Files
KMH_IT_Assets/docs/analysis/11-technical-debt.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

8.1 KiB
Raw Blame History

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