Files
KMH_IT_Assets/docs/analysis/16-source-map.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

7.6 KiB
Raw Blame History

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)

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.