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:
nuexn0x-9
2026-10-27 09:42:15 +07:00
commit f28983011c
110 changed files with 20296 additions and 0 deletions
+202
View File
@@ -0,0 +1,202 @@
# 00 — Executive Summary: Analisis Aplikasi Manajemen Aset IT PT. KMH
**Tanggal Analisis:** 26 Oktober 2026
**Analis:** Automated Reverse Engineering via Antigravity
**Ruang Lingkup:** Seluruh source code pada repository `manajemen-aset-it-ptkmh-master`
**Status:** Analisis Statis (Read-Only, tidak ada runtime testing)
---
## 1. Ringkasan Aplikasi
Aplikasi ini adalah **Sistem Manajemen Aset IT** yang dikembangkan khusus untuk **PT. KMH (Kerinci Hydropower)**. Berdasarkan bukti di repository:
- Nama sistem: **"IT All Role PT. KMH"** (terlihat di `admin.site.site_header` dan judul halaman HTML)
- Digunakan untuk mengelola aset IT milik perusahaan, mencakup perangkat karyawan dan infrastruktur jaringan
- Area operasional yang tercantum dalam kode: Regulating Weir (RW), DAM, Adit 1/2/3, Power House (PH), Vertical Shaft (VS), Gudang Induk (GI), Beringin Tunggal (BT), Jakon
- Ini merupakan sistem internal, bukan SaaS publik
Aplikasi ini bukan sistem manajemen aset generik — ia dirancang dan di-hardcode untuk konteks operasional perusahaan pembangkit listrik tenaga air (PLTA).
---
## 2. Kondisi Repository
| Aspek | Kondisi |
|---|---|
| Struktur proyek | Bersih, satu Django app utama (`assets`) |
| Dokumentasi existing | **Tidak ada** — tidak ada README, tidak ada docs |
| Test coverage | **Tidak ada** — `tests.py` hanya berisi placeholder |
| Migration history | 16 migrasi, mencerminkan evolusi skema yang signifikan |
| File scratch/temporary | Ada: `scratch_fix_views2.py`, `scratch_urls_all.py` — menjadi indikasi proses development yang tidak terstruktur |
| SQL seed files | Ada: `seed_karyawan.sql`, `database_lokal.sql` — data development terekspos di repository |
| Environment | `.env.example` tersedia, template konfigurasi cukup minimal |
| CI/CD | **Tidak ditemukan** — tidak ada konfigurasi GitHub Actions, Dockerfile, atau pipeline CI/CD |
| Git history | Tidak dapat diperiksa dalam mode statis |
---
## 3. Stack Teknologi
| Komponen | Teknologi | Versi | Status |
|---|---|---|---|
| Backend framework | Django | 5.2.17 | Terverifikasi (`requirements.txt` L4) |
| Python | Python | Tidak dieksplisit — target Django 5.2 memerlukan Python 3.10+ | Indikasi |
| Database | MySQL | Tidak diketahui versi — via PyMySQL | Terverifikasi (`settings.py` L86-93) |
| ORM | Django ORM | Bawaan Django | Terverifikasi |
| Frontend | TailwindCSS 3.x + HTMX 2.x | 3.4.19 / 2.0.11 | Terverifikasi (`package.json`) |
| Build tool | Vite | 5.4.21 | Terverifikasi (`package.json`) |
| Static serving | WhiteNoise | 6.12.0 | Terverifikasi (`requirements.txt` L14) |
| PDF generation | ReportLab | 5.0.1 | Terverifikasi (`requirements.txt` L11) |
| Excel generation | openpyxl | 3.1.2 | Terverifikasi (`requirements.txt` L15, dengan encoding anomaly) |
| QR Code | qrcode + Pillow | 8.2 / 12.3.0 | Terverifikasi |
| Env management | python-dotenv | 1.2.4 | Terverifikasi |
| REST API | **Tidak ada** — murni server-side rendered | — | Terverifikasi |
| Auth library | Django built-in | Bawaan Django | Terverifikasi |
| Cache | **Tidak ada** | — | Tidak ditemukan |
| Background task | **Tidak ada** | — | Tidak ditemukan |
| WSGI server | Tidak dieksplisit (tersedia `wsgi.py`) | — | Belum diketahui |
| Container | **Tidak ada Docker** | — | Tidak ditemukan |
---
## 4. Modul Utama
| Modul | Deskripsi | Status |
|---|---|---|
| **Dashboard** | Ringkasan statistik aset dan log distribusi terbaru | Implemented |
| **Manajemen Aset (Asset)** | CRUD jenis/tipe aset dengan kode unik | Implemented |
| **Unit Fisik (AssetUnit)** | CRUD unit fisik individual per jenis aset | Implemented |
| **Distribusi Aset** | Serah terima, mutasi, dan pengembalian aset | Implemented |
| **Status Aset** | Monitor status unit (tersedia/digunakan/rusak) | Implemented |
| **Riwayat Unit** | Timeline audit trail setiap unit aset | Implemented |
| **Data Karyawan** | CRUD data karyawan (penerima aset) | Implemented |
| **QR Code** | Generate QR code per unit dan halaman publik | Implemented |
| **Export PDF** | Export laporan ke PDF untuk semua modul | Implemented |
| **Export Excel** | Export laporan ke Excel untuk semua modul | Implemented |
| **Backup Data** | Export seluruh data (JSON/SQL) | Implemented |
| **Profil & Password** | Edit profil dan ubah password admin | Implemented |
| **Django Admin** | Panel admin Django | Terdaftar tapi dinonaktifkan di URL (`urls.py` L20) |
---
## 5. Status Dokumentasi Sebelum Analisis Ini
| Jenis Dokumen | Status |
|---|---|
| README | Tidak ada |
| PRD / Spesifikasi Kebutuhan | Tidak ada |
| Dokumentasi arsitektur | Tidak ada |
| Data dictionary | Tidak ada |
| API documentation | Tidak ada (tidak ada REST API) |
| Deployment guide | Tidak ada |
| Test plan | Tidak ada |
---
## 6. Kekuatan Aplikasi
1. **Fitur cukup lengkap untuk use case inti** — mulai dari pendataan aset, distribusi, audit trail, hingga export laporan
2. **Audit trail per unit** — setiap perubahan status unit aset dicatat dalam `UnitLog`, memberikan histori lengkap
3. **QR Code terintegrasi** — setiap unit memiliki UUID publik dan halaman publik, memungkinkan scan untuk cek status
4. **Export PDF & Excel** — semua laporan utama dapat diekspor
5. **Pengelolaan kode unit otomatis** — saat kode aset induk berubah, kode unit anak diperbarui otomatis
6. **Halaman publik tanpa login** — `unit_public_detail` dapat diakses tanpa autentikasi (by design untuk QR scan)
7. **Konfigurasi keamanan dasar** — `ALLOWED_HOSTS`, `SECRET_KEY` dari env, security headers di production mode
8. **UI modern** — menggunakan TailwindCSS dengan desain responsif
---
## 7. Risiko Utama
> [!CAUTION]
> Beberapa risiko berikut memerlukan perhatian segera sebelum deployment atau pengembangan lebih lanjut.
| # | Risiko | Severity | Confidence |
|---|---|---|---|
| R1 | **Tidak ada sistem role/permission** — satu akun admin mengelola segalanya, tidak ada role berbeda | High | High |
| R2 | **`asset_add` tidak memiliki `@login_required`** — siapapun dapat menambah aset tanpa login | High | High |
| R3 | **`unit_delete` tidak terdaftar di URL** — view ada tapi tidak bisa diakses (broken feature) | Medium | High |
| R4 | **File database SQL di repository** (`database_lokal.sql`, `seed_karyawan.sql`) — data mungkin mengandung data sensitif | High | High |
| R5 | **File scratch di repository** (`scratch_fix_views2.py`, `scratch_urls_all.py`) — mengekspos path development dan proses kerja | Low | High |
| R6 | **Backup SQL mengeksekusi `subprocess`/`mysqldump`** — memerlukan validasi implementasi backup_database_view | Medium | Medium |
| R7 | **Tidak ada test sama sekali** — tidak ada safety net untuk perubahan kode | High | High |
| R8 | **Tidak ada pagination** — jika data besar, performa akan degradasi | Medium | High |
| R9 | **`openpyxl` di `requirements.txt` memiliki encoding anomaly** — null bytes pada line 15 | Medium | High |
| R10 | **`asset_export_pdf` tanpa `@login_required` (line 84-85)** — ada dekorator ganda yang ambigu | Medium | Medium |
| R11 | **Distribusi hanya untuk "Aset Karyawan"** — `available_units` di `distribusi_list` hardcoded filter hanya Karyawan | Medium | High |
| R12 | **Django Admin URL dikomentari** — admin ada di `INSTALLED_APPS` tapi URL-nya dihapus, menimbulkan inkonsistensi | Low | High |
---
## 8. Temuan Kritis
### CRIT-01: `asset_add` Tidak Membutuhkan Login
- **File:** `assets/views.py`, baris 192
- **Bukti:** Fungsi `asset_add` tidak memiliki dekorator `@login_required`
- **Dampak:** Siapapun yang mengetahui URL `/aset/add/` dapat menambahkan aset tanpa autentikasi
### CRIT-02: Double `@login_required` pada Line 84-86
- **File:** `assets/views.py`, baris 84-87
- **Bukti:** Terdapat `@login_required` kosong pada baris 84 (tanpa fungsi di bawahnya) dan baris 86 (`@login_required` untuk `asset_export_excel`)
- **Dampak:** Indikasi kode copy-paste yang tidak diperhatikan
### CRIT-03: `unit_delete` View Ada Tapi Tidak Dapat Diakses
- **File:** `assets/views.py` L410, `itam_core/urls.py`
- **Bukti:** `unit_delete` view terdefinisi tapi tidak ada URL pattern untuk mengaksesnya
- **Dampak:** Fungsi hapus unit tidak dapat digunakan — fitur ini broken
### CRIT-04: Data Database di Repository
- **File:** `database_lokal.sql`, `seed_karyawan.sql`
- **Bukti:** File SQL ada di root repository
- **Dampak:** Data karyawan (NIK, nama) mungkin terekspos jika repository bersifat publik
---
## 9. Area yang Belum Diketahui
- Implementasi `backup_database_view` — tidak terbaca dalam analisis ini (tersembunyi di views.py section yang belum dibaca penuh)
- Python version yang actual digunakan di production
- Versi MySQL yang digunakan
- Apakah WSGI server (gunicorn/uwsgi) sudah dikonfigurasi
- Cara deployment ke server production
- Apakah ada data produksi aktif
- Konfigurasi backup scheduled yang mungkin ada di luar repository
---
## 10. Rekomendasi Prioritas
| # | Rekomendasi | Prioritas |
|---|---|---|
| 1 | Tambahkan `@login_required` pada `asset_add` dan audit semua view lainnya | P0 — Segera |
| 2 | Daftarkan URL untuk `unit_delete` atau hapus view yang tidak terpakai | P0 — Segera |
| 3 | Hapus `database_lokal.sql` dan `seed_karyawan.sql` dari repository, tambahkan ke `.gitignore` | P0 — Segera |
| 4 | Tambahkan test dasar untuk fitur kritis (login, CRUD aset, distribusi) | P1 — Sebelum Pengembangan |
| 5 | Tambahkan pagination pada semua list view untuk performa di data besar | P2 — Peningkatan |
| 6 | Bersihkan file scratch dari repository | P2 — Peningkatan |
| 7 | Pertimbangkan RBAC sederhana untuk memisahkan akses (read-only vs admin) | P3 — Jangka Menengah |
---
## 11. Tabel Ringkasan Status Aplikasi
| Area | Status | Catatan |
|---|---|---|
| Core Business Logic | ✅ Implemented | Semua alur bisnis inti berjalan |
| Authentication | ✅ Implemented | Standard Django auth |
| Authorization (RBAC) | ❌ Tidak Ada | Semua user = admin |
| Data Validation (Frontend) | ⚠️ Partial | Validasi di form HTML, minimal server-side |
| Data Validation (Backend) | ⚠️ Partial | Beberapa validasi, tidak komprehensif |
| Error Handling | ⚠️ Partial | Custom 404, tapi error 500 tidak ditangani khusus |
| Logging | ✅ Basic | Log error ke file, WARNING ke console |
| Testing | ❌ Tidak Ada | Placeholder saja |
| Documentation | ❌ Tidak Ada | Baru dibuat dalam analisis ini |
| CI/CD | ❌ Tidak Ada | Tidak ditemukan |
| Deployment Config | ⚠️ Minimal | Hanya `.env.example` |
| Security | ⚠️ Sebagian | Beberapa endpoint tidak protected |
| Performance | ⚠️ Risiko | Tidak ada pagination, potensial N+1 query |
---
*Dokumen ini dibuat berdasarkan analisis statis source code. Verifikasi runtime diperlukan untuk memastikan perilaku aktual.*
+278
View File
@@ -0,0 +1,278 @@
# 01 — System Overview: Arsitektur Sistem Manajemen Aset IT PT. KMH
**Tanggal Analisis:** 26 Oktober 2026
**Status Verifikasi:** Analisis statis — arsitektur runtime belum diverifikasi
---
## 1. Tujuan Aplikasi (Berdasarkan Implementasi)
Berdasarkan pemeriksaan source code, aplikasi ini bertujuan untuk:
1. **Mencatat dan menginventarisasi aset IT** yang dimiliki PT. KMH (peralatan karyawan dan infrastruktur jaringan/network)
2. **Mengelola distribusi aset** — mencatat serah terima aset dari gudang ke karyawan, mutasi antar karyawan, dan pengembalian aset
3. **Memantau status fisik unit aset** — tersedia, sedang digunakan, dalam perbaikan/maintenance, atau dipensiunkan
4. **Menyimpan riwayat historis** setiap unit aset (audit trail) dari masuk sistem hingga pensiun
5. **Menghasilkan laporan** dalam format PDF dan Excel untuk semua modul
6. **Menyediakan identifikasi unit via QR Code** — setiap unit dapat di-scan untuk melihat informasi publiknya
7. **Mengelola data karyawan** sebagai penerima/penanggung jawab aset
---
## 2. Arsitektur Sistem
### 2.1 Jenis Arsitektur
Aplikasi ini adalah **monolithic web application** berbasis Django dengan pattern **Multi-Page Application (MPA)**:
- **Tidak ada REST API atau GraphQL** — semua komunikasi adalah server-rendered HTML
- **HTMX** digunakan untuk partial page updates (interaksi asinkron tanpa full page reload)
- **Satu Django app** (`assets`) menangani seluruh business logic
- **Satu project Django** (`itam_core`) sebagai konfigurasi inti
### 2.2 Lapisan Arsitektur
```
┌─────────────────────────────────────────────────┐
│ Browser │
│ (TailwindCSS + HTMX + Vanilla JS) │
└──────────────────────┬──────────────────────────┘
│ HTTP Request
┌──────────────────────▼──────────────────────────┐
│ Django WSGI Server │
│ ┌─────────────────────────────────────────────┐ │
│ │ Middleware Stack │ │
│ │ SecurityMiddleware → WhiteNoiseMiddleware │ │
│ │ → SessionMiddleware → CommonMiddleware │ │
│ │ → CsrfViewMiddleware → AuthMiddleware │ │
│ │ → MessageMiddleware → XFrameOptionsMiddleware│ │
│ │ → HtmxMiddleware │ │
│ └──────────────────┬──────────────────────────┘ │
│ │ │
│ ┌──────────────────▼──────────────────────────┐ │
│ │ URL Routing │ │
│ │ itam_core/urls.py │ │
│ └──────────────────┬──────────────────────────┘ │
│ │ │
│ ┌──────────────────▼──────────────────────────┐ │
│ │ Views (Function-Based Views) │ │
│ │ assets/views.py (3056 baris) │ │
│ └──────┬──────────────────────────┬────────────┘ │
│ │ │ │
│ ┌──────▼──────┐ ┌────────▼──────────┐ │
│ │ ORM/Models│ │ Templates │ │
│ │ assets/ │ │ templates/*.html │ │
│ │ models.py │ └───────────────────┘ │
│ └──────┬──────┘ │
└─────────┼───────────────────────────────────────┘
│
┌─────────▼──────────────────────────────────────┐
│ MySQL Database │
│ (django.db.backends.mysql via PyMySQL) │
└──────────────────────────────────────────────────┘
```
---
## 3. Komponen Utama
### 3.1 Backend
| Komponen | File | Peran |
|---|---|---|
| Django Project | `itam_core/` | Konfigurasi inti, URL routing global, WSGI/ASGI entrypoint |
| Django App | `assets/` | Satu-satunya app, menampung semua business logic |
| Models | `assets/models.py` | Definisi 5 model: Employee, Category, Asset, AssetUnit, UnitLog, AssetAssignment |
| Views | `assets/views.py` | 3056 baris — seluruh business logic dan response rendering |
| Admin | `assets/admin.py` | Registrasi model ke Django Admin (URL admin dinonaktifkan) |
| Management Commands | `assets/management/commands/` | `seed_initial_data.py`, `setup_superuser.py` |
| Migrations | `assets/migrations/` | 16 file migrasi, evolusi skema dari awal hingga kini |
### 3.2 Frontend
| Komponen | File/Directory | Peran |
|---|---|---|
| Templates | `templates/*.html` | 13 template HTML |
| Base Layout | `templates/base.html` | Layout utama: sidebar, topbar, toast notification, guide modal |
| CSS Framework | TailwindCSS 3.4.19 | Styling utility-first |
| JS Interactivity | HTMX 2.0.11 | Partial page updates (form submission, modal, dll) |
| Build System | Vite 5.4.21 | Bundle frontend assets |
| Frontend Source | `frontend/main.js`, `frontend/style.css` | Source sebelum di-build |
| Compiled CSS | `static/dist/style.css` | CSS yang sudah dikompilasi (committed ke repo) |
### 3.3 Static Files
| Direktori | Konten |
|---|---|
| `static/dist/` | CSS yang sudah dikompilasi oleh Tailwind/Vite |
| `static/img/` | Logo perusahaan (kerinci_logo.png, it_all_role_logo.png, dll) |
### 3.4 Media Files
| Path | Konten |
|---|---|
| `media/bast_documents/` | Upload dokumen BAST (Berita Acara Serah Terima) — runtime directory |
---
## 4. Diagram Arsitektur (Mermaid)
```mermaid
flowchart TD
Browser["🌐 Browser\n(TailwindCSS + HTMX + Vanilla JS)"]
subgraph Django["Django 5.2 Application"]
Middleware["⚙️ Middleware Stack\nSecurity → WhiteNoise → Session\nCSRF → Auth → HTMX"]
URLRouter["🔀 URL Router\nitam_core/urls.py"]
subgraph Assets["assets app"]
Views["📋 Function-Based Views\nassets/views.py\n~3056 lines"]
Models["🗄️ Models\nEmployee, Category\nAsset, AssetUnit\nUnitLog, AssetAssignment"]
Admin["⚙️ Django Admin\n(URL dinonaktifkan)"]
end
Templates["🖼️ HTML Templates\ntemplates/*.html\n13 files"]
Static["📁 Static Files\nstatic/dist/style.css\nstatic/img/*.png"]
end
MySQL["🗄️ MySQL Database\nmanajemen_aset_it"]
MediaStorage["📂 Media Storage\nmedia/bast_documents/"]
Browser -->|"HTTP Request"| Middleware
Middleware --> URLRouter
URLRouter --> Views
Views --> Models
Views --> Templates
Models --> MySQL
Views -->|"PDF/Excel/QR"| Browser
Views -->|"File Upload"| MediaStorage
Templates -->|"HTML Response"| Browser
Static -->|"WhiteNoise"| Browser
```
---
## 5. Alur Request dari Browser ke Database
### 5.1 Alur Standar (GET request halaman)
```
1. Browser → GET /aset/
2. Django Middleware Stack (security checks, session, auth check)
3. URL Router mencocokkan pattern → asset_list view
4. @login_required → redirect ke /login/ jika tidak terautentikasi
5. View: Asset.objects.annotate().filter().order_by()
6. MySQL mengembalikan queryset
7. View merender template asset_list.html dengan context
8. Template engine render HTML
9. HTML response → Browser
```
### 5.2 Alur Form Submit (POST request dengan HTMX)
```
1. Browser → POST /aset/add/ (dengan HTMX atau form biasa)
2. Middleware: CSRF token validation
3. URL Router → asset_add view
4. View: request.method == 'POST' check
5. Ekstrak data dari request.POST
6. Validasi (duplikasi kode, dll)
7. Asset.objects.create(...)
8. MySQL INSERT
9. messages.success() → tambah ke session
10. JsonResponse({'success': True}) atau redirect
11. Browser: HTMX/JS menangani respons (tutup modal, refresh tabel, show toast)
```
### 5.3 Alur Export PDF
```
1. Browser → GET /aset/export/?tab=karyawan
2. @login_required check
3. View query data dari MySQL
4. ReportLab membangun PDF di memory (BytesIO)
5. HttpResponse dengan content_type='application/pdf'
6. Browser menampilkan/mengunduh PDF
```
---
## 6. Template Hierarchy
```
base.html (layout utama: sidebar, topbar, toast, guide modal)
├── login.html (tidak extends base — standalone)
├── dashboard.html
├── asset_list.html
├── asset_units.html
├── status_aset_list.html
├── distribusi_list.html
├── employee_list.html
├── employee_detail.html
├── unit_history.html
├── unit_public_detail.html (tidak extends base — halaman publik)
├── backup.html
├── profile.html
└── 404.html (tidak extends base)
```
---
## 7. Integrasi Eksternal
| Integrasi | Tipe | Detail |
|---|---|---|
| Google Fonts | CDN eksternal | Font "Inter" dimuat dari `fonts.googleapis.com` (`base.html` L9) |
| MySQL Server | Database | Server MySQL lokal/remote via PyMySQL |
| Media storage | Filesystem lokal | Upload dokumen disimpan di `media/bast_documents/` |
> [!NOTE]
> Tidak ditemukan integrasi dengan layanan cloud, email provider, message queue, atau external API. Semua operasi bersifat self-contained.
---
## 8. Konfigurasi Keamanan
| Setting | Development | Production |
|---|---|---|
| `DEBUG` | `True` (dari env) | `False` |
| `SECRET_KEY` | Dari env, fallback `'django-insecure-dev-key-change-in-production'` | Dari env |
| `ALLOWED_HOSTS` | Dari env (split by comma) | Dari env |
| `SECURE_SSL_REDIRECT` | Tidak aktif | Optional (dari env) |
| `SECURE_HSTS_SECONDS` | Tidak aktif | 31536000 (1 tahun) |
| `SESSION_COOKIE_SECURE` | Tidak aktif | `True` |
| `CSRF_COOKIE_SECURE` | Tidak aktif | `True` |
| `SECURE_CONTENT_TYPE_NOSNIFF` | Tidak aktif | `True` |
---
## 9. Batas Sistem
Sistem ini **tidak menangani**:
- Manajemen lisensi software
- Kontrak vendor/supplier
- Pengadaan/procurement aset
- Garansi aset
- Manajemen tiket/insiden IT
- Notifikasi email atau push notification
- Integrasi dengan HRIS atau sistem ERP lainnya
- Multi-tenant atau multi-departemen dengan akses berbeda
- Peminjaman aset (borrow/return dengan tenggat waktu)
- Audit fisik (stock opname)
---
## 10. Asumsi dan Keterbatasan Analisis
| Asumsi | Dasar |
|---|---|
| Python versi ≥ 3.10 | Django 5.2 memerlukan Python 3.10+ |
| MySQL versi ≥ 5.7 atau 8.x | PyMySQL 1.2.3 mendukung keduanya |
| Server berjalan di Linux | Indikasi dari path dan konfigurasi |
| Single user (admin) | Tidak ada implementasi multi-role |
**Keterbatasan analisis:**
- Tidak ada runtime testing — perilaku aktual belum dikonfirmasi
- JavaScript di templates belum dianalisis sepenuhnya
- File `scratch_fix_views2.py` tidak dianalisis secara mendalam (kode development)
- `database_lokal.sql` tidak dibuka untuk menjaga privasi data
+288
View File
@@ -0,0 +1,288 @@
# 02 — PRD As-Is: Product Requirements Document (Berdasarkan Implementasi)
**Tanggal Analisis:** 26 Oktober 2026
**Tipe Dokumen:** PRD As-Is — requirement berdasarkan implementasi yang ditemukan, bukan requirement baru
**Status:** Terverifikasi dari source code | **Confidence:** High untuk fitur terimplementasi
> [!IMPORTANT]
> PRD ini mendokumentasikan PERILAKU AKTUAL yang ditemukan di kode. Bukan requirement yang diusulkan. Setiap requirement memiliki status verifikasi.
---
## 1. Latar Belakang
PT. KMH (Kerinci Hydropower) adalah perusahaan pembangkit listrik tenaga air (PLTA) yang membutuhkan sistem untuk mengelola aset IT di berbagai area operasional (DAM, Power House, Adit, dll). Aset IT digunakan oleh karyawan dan dipasang di infrastruktur jaringan. Sistem ini menggantikan pengelolaan manual (spreadsheet) dengan aplikasi web terpusat.
*Sumber inferensi: AREA_CHOICES di models.py, judul halaman "Manajemen Aset IT - Kerinci Hydropower", logo dalam static/img/*
---
## 2. Tujuan Sistem (Terverifikasi)
| ID | Tujuan | Bukti | Status |
|---|---|---|---|
| OBJ-01 | Mencatat inventaris aset IT per jenis dan per unit fisik | `Asset`, `AssetUnit` models | Terverifikasi |
| OBJ-02 | Mengelola distribusi aset ke karyawan | `AssetAssignment` model, distribusi views | Terverifikasi |
| OBJ-03 | Menyimpan riwayat historis setiap unit | `UnitLog` model | Terverifikasi |
| OBJ-04 | Monitoring status aset real-time | `status_aset_list` view | Terverifikasi |
| OBJ-05 | Menghasilkan laporan dalam PDF dan Excel | Export views | Terverifikasi |
| OBJ-06 | Identifikasi unit via QR code yang dapat di-scan | `unit_qr_code`, `unit_public_detail` | Terverifikasi |
| OBJ-07 | Pengelolaan data karyawan terintegrasi | `Employee` model dan views | Terverifikasi |
---
## 3. Aktor/Pengguna
| Aktor | Deskripsi | Hak Akses | Status |
|---|---|---|---|
| **Administrator IT** | Pengguna sistem satu-satunya — staff IT yang mengelola semua aset | Akses penuh ke semua fitur | Terverifikasi |
| **Publik (tanpa login)** | Siapapun yang men-scan QR code | Hanya bisa melihat detail unit publik (`/public/unit/{uuid}/`) | Terverifikasi |
> [!NOTE]
> Tidak ada implementasi multi-role atau multi-user. Semua Django user yang login memiliki akses yang sama. Tidak ada pembedaan antara "read-only" dan "admin".
---
## 4. Daftar Modul
| ID | Modul | Deskripsi | Status |
|---|---|---|---|
| MOD-01 | Dashboard | Ringkasan statistik dan log aktivitas terbaru | Implemented |
| MOD-02 | Manajemen Aset | CRUD jenis aset (master data) | Implemented |
| MOD-03 | Unit Aset | CRUD unit fisik per aset | Implemented |
| MOD-04 | Distribusi Aset | Serah terima, mutasi, pengembalian | Implemented |
| MOD-05 | Status Aset | Monitor status per unit | Implemented |
| MOD-06 | Riwayat Unit | Timeline audit trail unit | Implemented |
| MOD-07 | Data Karyawan | CRUD karyawan | Implemented |
| MOD-08 | QR Code | Generate dan halaman publik | Implemented |
| MOD-09 | Export Laporan | PDF dan Excel untuk semua modul | Implemented |
| MOD-10 | Backup Data | Export JSON/SQL seluruh database | Implemented |
| MOD-11 | Profil Akun | Edit profil dan ubah password | Implemented |
---
## 5. Functional Requirements
### 5.1 Autentikasi (FR-AUTH)
| ID | Requirement | Status | Bukti |
|---|---|---|---|
| FR-AUTH-01 | Sistem menyediakan halaman login dengan username dan password | Implemented | `login_view`, `templates/login.html` |
| FR-AUTH-02 | Semua halaman utama memerlukan autentikasi — redirect ke login jika belum login | Implemented | `@login_required` decorator pada views |
| FR-AUTH-03 | Sistem menyediakan fungsi logout | Implemented | `logout_view`, form logout di `base.html` |
| FR-AUTH-04 | Administrator dapat mengubah profil (nama depan, nama belakang, username, email) | Implemented | `profile_view`, `templates/profile.html` |
| FR-AUTH-05 | Administrator dapat mengubah password (verifikasi password lama) | Implemented | `profile_view`, form update_password |
| FR-AUTH-06 | Django admin dapat dibuat via management command `setup_superuser` | Implemented | `assets/management/commands/setup_superuser.py` |
### 5.2 Dashboard (FR-DASH)
| ID | Requirement | Status | Bukti |
|---|---|---|---|
| FR-DASH-01 | Dashboard menampilkan jumlah unit aset karyawan | Implemented | `dashboard` view L19 |
| FR-DASH-02 | Dashboard menampilkan jumlah unit aset network | Implemented | `dashboard` view L20 |
| FR-DASH-03 | Dashboard menampilkan jumlah unit per status (tersedia, digunakan, maintenance) | Implemented | `dashboard` view L22-25 |
| FR-DASH-04 | Dashboard menampilkan 5 log serah terima terbaru | Implemented | `recent_handovers` L28 |
| FR-DASH-05 | Dashboard menampilkan 3 log mutasi terbaru | Implemented | `recent_mutations` L29 |
| FR-DASH-06 | Dashboard menampilkan 3 log pengembalian terbaru | Implemented | `recent_returns` L30 |
| FR-DASH-07 | Kartu statistik dapat diklik sebagai shortcut ke halaman detail | Implemented | Link di `dashboard.html` L18, 26, 34 |
### 5.3 Manajemen Aset / Asset (FR-ASSET)
| ID | Requirement | Status | Bukti |
|---|---|---|---|
| FR-ASSET-01 | Sistem menampilkan daftar aset dengan tab Karyawan dan Network | Implemented | `asset_list`, query filter L63-66 |
| FR-ASSET-02 | Pengguna dapat mencari aset berdasarkan kode, nama, atau merek | Implemented | `asset_list` L56-61 |
| FR-ASSET-03 | Daftar aset menampilkan jumlah unit tersedia dan digunakan (annotated count) | Implemented | `asset_list` L50-54 |
| FR-ASSET-04 | Pengguna dapat menambahkan jenis aset baru | Partially Implemented | `asset_add` view — **tidak ada `@login_required`** |
| FR-ASSET-05 | Pengguna dapat mengedit jenis aset | Implemented | `asset_edit` view |
| FR-ASSET-06 | Jika kode aset berubah, semua unit_code anak diperbarui otomatis | Implemented | `Asset.save()` custom method |
| FR-ASSET-07 | Pengguna dapat menghapus jenis aset | Implemented | `asset_delete` view |
| FR-ASSET-08 | Sistem dapat mengekspor daftar aset ke PDF | Implemented | `asset_export_pdf` |
| FR-ASSET-09 | Sistem dapat mengekspor daftar aset ke Excel | Implemented | `asset_export_excel` |
### 5.4 Unit Aset (FR-UNIT)
| ID | Requirement | Status | Bukti |
|---|---|---|---|
| FR-UNIT-01 | Setiap aset memiliki daftar unit fisik | Implemented | `asset_units` view |
| FR-UNIT-02 | Pengguna dapat menambah unit fisik baru dengan suffix kode | Implemented | `unit_add` |
| FR-UNIT-03 | Unit code diformat otomatis: `{asset_code}-{suffix}` | Implemented | `unit_add` L285 |
| FR-UNIT-04 | Unit code harus unik di seluruh sistem | Implemented | unique constraint + validasi di view |
| FR-UNIT-05 | Pengguna dapat mengedit unit (kode, status, assigned_to) | Implemented | `unit_edit` |
| FR-UNIT-06 | Edit unit mencatat log otomatis berdasarkan perubahan status | Implemented | `unit_edit` L326-346 |
| FR-UNIT-07 | Pengguna dapat menghapus unit | Potentially Defective | `unit_delete` view ada tapi **tidak ada URL pattern** |
| FR-UNIT-08 | Setiap unit memiliki UUID unik untuk QR code | Implemented | `AssetUnit.id_uuid` |
| FR-UNIT-09 | Sistem dapat mengekspor daftar unit ke PDF dan Excel | Implemented | `asset_units_export_pdf`, `asset_units_export_excel` |
| FR-UNIT-10 | Update status unit (tersedia/rusak) untuk aset network memperbarui area dan lokasi | Implemented | `unit_update_status` |
### 5.5 Distribusi Aset (FR-DIST)
| ID | Requirement | Status | Bukti |
|---|---|---|---|
| FR-DIST-01 | Pengguna dapat melakukan serah terima aset ke karyawan | Implemented | `distribusi_handover` |
| FR-DIST-02 | Serah terima mengubah status unit menjadi "digunakan" dan menetapkan assigned_to | Implemented | `distribusi_handover` L598-600 |
| FR-DIST-03 | Pengguna dapat melakukan mutasi aset antar karyawan | Implemented | `distribusi_mutation` |
| FR-DIST-04 | Pengguna dapat mencatat pengembalian aset | Implemented | `distribusi_return` |
| FR-DIST-05 | Setiap distribusi dapat dilampiri dokumen BAST | Implemented | `document` field di AssetAssignment |
| FR-DIST-06 | Dokumen BAST dapat diupload setelah transaksi dibuat | Implemented | `distribusi_upload_doc` |
| FR-DIST-07 | Upload dokumen dibatasi: PDF, DOC, DOCX, JPG, PNG, maksimal 5MB | Implemented | `distribusi_upload_doc` L696-702 |
| FR-DIST-08 | Daftar distribusi dapat difilter per tipe (serah terima/mutasi/pengembalian) | Implemented | `distribusi_list` tab filter |
| FR-DIST-09 | Daftar distribusi dapat dicari berdasarkan nama, kode unit, tanggal | Implemented | `distribusi_list` L507-549 |
| FR-DIST-10 | Setiap distribusi menghasilkan UnitLog otomatis | Implemented | UnitLog.create di setiap distribusi view |
| FR-DIST-11 | Distribusi menggunakan `@transaction.atomic` untuk konsistensi | Implemented | Semua distribusi views |
| FR-DIST-12 | Distribusi hanya tersedia untuk "Aset Karyawan" | Partially Implemented | `distribusi_list` L557-558 hardcoded filter |
### 5.6 Status Aset (FR-STATUS)
| ID | Requirement | Status | Bukti |
|---|---|---|---|
| FR-STATUS-01 | Sistem menampilkan semua unit berdasarkan status | Implemented | `status_aset_list` |
| FR-STATUS-02 | Filter berdasarkan kategori (Karyawan/Network) dan status | Implemented | cat_filter dan tab di `status_aset_list` |
| FR-STATUS-03 | Pencarian unit berdasarkan kode, nama aset, nama karyawan, area, lokasi | Implemented | `status_aset_list` L470-479 |
| FR-STATUS-04 | Sistem dapat mengekspor status aset ke PDF dan Excel | Implemented | export views |
### 5.7 Riwayat Unit (FR-HIST)
| ID | Requirement | Status | Bukti |
|---|---|---|---|
| FR-HIST-01 | Setiap unit memiliki halaman riwayat berupa timeline | Implemented | `unit_history` view |
| FR-HIST-02 | Riwayat menampilkan nama karyawan yang sudah dihapus | Implemented | Parsing regex di `unit_history` L428-438 |
| FR-HIST-03 | Riwayat dapat diekspor ke PDF dan Excel | Implemented | export views |
### 5.8 Data Karyawan (FR-EMP)
| ID | Requirement | Status | Bukti |
|---|---|---|---|
| FR-EMP-01 | Sistem menampilkan daftar karyawan dengan jumlah aset yang dipegang | Implemented | `employee_list` dengan annotate Count |
| FR-EMP-02 | Pencarian karyawan berdasarkan nama atau NIK | Implemented | `employee_list` L718-722 |
| FR-EMP-03 | Pengguna dapat menambah karyawan baru (NIK, nama, jabatan) | Implemented | `employee_create` |
| FR-EMP-04 | NIK harus unik per karyawan | Implemented | unique constraint + validasi view |
| FR-EMP-05 | Pengguna dapat mengedit data karyawan | Implemented | `employee_edit` |
| FR-EMP-06 | Pengguna tidak dapat menghapus karyawan yang masih memegang aset | Implemented | `employee_delete` L788-789 |
| FR-EMP-07 | Saat karyawan dihapus, nama-NIK diembed ke UnitLog notes | Implemented | `employee_delete` L792-796 |
| FR-EMP-08 | Halaman detail karyawan menampilkan aset yang sedang dipegang | Implemented | `employee_detail` |
| FR-EMP-09 | Laporan karyawan dapat diekspor ke PDF dan Excel | Implemented | export views |
### 5.9 QR Code & Halaman Publik (FR-QR)
| ID | Requirement | Status | Bukti |
|---|---|---|---|
| FR-QR-01 | Setiap unit dapat di-generate QR code-nya | Implemented | `unit_qr_code` view |
| FR-QR-02 | QR code berisi URL ke halaman publik unit | Implemented | URL `/public/unit/{uuid}/` |
| FR-QR-03 | QR code menampilkan nama aset dan kode unit sebagai teks | Implemented | `unit_qr_code` L813-814 |
| FR-QR-04 | Halaman publik dapat diakses tanpa login | Implemented | `unit_public_detail` tanpa `@login_required` |
| FR-QR-05 | Halaman publik menampilkan info unit dan riwayat log | Implemented | `unit_public_detail` L848-854 |
### 5.10 Backup (FR-BACKUP)
| ID | Requirement | Status | Bukti |
|---|---|---|---|
| FR-BACKUP-01 | Sistem menyediakan fitur backup data ke format JSON (Django dumpdata) | Unverified | Template backup.html menunjukkan opsi ini; implementasi view belum terbaca penuh |
| FR-BACKUP-02 | Sistem menyediakan backup ke format SQL (mysqldump) | Unverified | Template backup.html menunjukkan opsi SQL; implementasi belum diverifikasi |
---
## 6. Non-Functional Requirements (Terverifikasi)
| ID | Requirement | Status | Bukti |
|---|---|---|---|
| NFR-01 | Bahasa antarmuka: Bahasa Indonesia | Implemented | `LANGUAGE_CODE = 'id-id'`, semua label dalam Bahasa Indonesia |
| NFR-02 | Timezone: Asia/Jakarta | Implemented | `TIME_ZONE = 'Asia/Jakarta'` di settings.py |
| NFR-03 | Desain responsif (mobile dan desktop) | Implemented | TailwindCSS responsive classes di templates |
| NFR-04 | Keamanan: CSRF protection aktif | Implemented | `CsrfViewMiddleware`, CSRF token di semua form |
| NFR-05 | Keamanan: Security headers aktif di production | Implemented | Settings HSTS, NOSNIFF, cookie secure saat DEBUG=False |
| NFR-06 | Log error ke file `error.log` di root project | Implemented | LOGGING config di settings.py L175-179 |
| NFR-07 | Static files serving via WhiteNoise | Implemented | `whitenoise.middleware.WhiteNoiseMiddleware` |
| NFR-08 | Konfigurasi via environment variables | Implemented | `.env.example`, `python-dotenv` |
---
## 7. Business Rules
| ID | Aturan | Bukti | Status |
|---|---|---|---|
| BR-01 | Kode aset harus unik, uppercase | `Asset.asset_code unique=True`, `asset_code.upper()` di views | Terverifikasi |
| BR-02 | NIK karyawan harus unik | `Employee.nik unique=True` | Terverifikasi |
| BR-03 | Unit code harus unik di seluruh sistem | `AssetUnit.unit_code unique=True` | Terverifikasi |
| BR-04 | Karyawan yang masih memegang aset tidak dapat dihapus | `employee_delete` L788-789 | Terverifikasi |
| BR-05 | Setiap perubahan status unit menghasilkan UnitLog | Semua status-change views | Terverifikasi |
| BR-06 | Serah terima mengubah status unit menjadi "digunakan" | `distribusi_handover` L598-600 | Terverifikasi |
| BR-07 | Pengembalian aset mengubah status menjadi "tersedia" dan assigned_to menjadi null | `distribusi_return` L675-677 | Terverifikasi |
| BR-08 | Aset dengan kategori "Network" memerlukan area dan lokasi saat digunakan/rusak | `unit_update_status` L368-388 | Terverifikasi |
| BR-09 | Dokumen upload maksimal 5MB dan hanya tipe tertentu | `distribusi_upload_doc` L700-702 | Terverifikasi |
| BR-10 | Distribusi formal (serah terima) menggunakan transaction.atomic | `@transaction.atomic` decorator | Terverifikasi |
| BR-11 | Unit tidak dapat dihapus jika masih ada AssetAssignment (PROTECT) | `AssetAssignment.unit ON_DELETE=PROTECT` | Terverifikasi |
| BR-12 | QR code halaman publik dapat diakses siapapun tanpa login | `unit_public_detail` tanpa `@login_required` | Terverifikasi (by design) |
---
## 8. Alur Kerja Pengguna
### 8.1 Alur Tambah Aset Baru + Unit
```
1. Login sebagai Administrator
2. Navigasi ke "Daftar Aset"
3. Klik "Tambah Aset" → Isi kategori, kode, nama, merek, satuan
4. Sistem validasi kode unik → Simpan Asset
5. Klik pada aset → masuk ke halaman "Unit Aset"
6. Klik "Tambah Unit" → Isi suffix kode (misal: 001)
7. Sistem membuat unit dengan kode format "{asset_code}-001"
8. UnitLog dibuat: action='created'
9. Asset.qty diperbarui
```
### 8.2 Alur Serah Terima Aset ke Karyawan
```
1. Navigasi ke "Distribusi Aset" tab "Serah Terima"
2. Klik "Serah Terima Baru"
3. Pilih unit (dari dropdown unit tersedia)
4. Pilih karyawan penerima
5. Isi tanggal serah terima, catatan (opsional), dokumen BAST (opsional)
6. Submit → transaction.atomic:
a. AssetAssignment dibuat (type='handover')
b. AssetUnit.status → 'digunakan'
c. AssetUnit.assigned_to → karyawan terpilih
d. UnitLog dibuat (action='assigned')
7. Redirect ke daftar distribusi tab handover
```
### 8.3 Alur Mutasi Aset
```
1. Navigasi ke "Distribusi Aset" tab "Mutasi"
2. Klik "Mutasi Baru"
3. Pilih unit yang sedang digunakan
4. Sistem otomatis mengisi from_employee dari assigned_to unit
5. Pilih karyawan penerima baru
6. Submit → transaction.atomic:
a. AssetAssignment dibuat (type='mutation', from_employee=pemegang lama)
b. AssetUnit.assigned_to → karyawan baru
c. UnitLog: action='returned' (pemegang lama)
d. UnitLog: action='assigned' (pemegang baru)
```
### 8.4 Alur Pengembalian Aset
```
1. Navigasi ke "Distribusi Aset" tab "Pengembalian"
2. Pilih unit yang dikembalikan
3. Isi tanggal dan catatan
4. Submit → transaction.atomic:
a. AssetAssignment dibuat (type='return')
b. AssetUnit.status → 'tersedia'
c. AssetUnit.assigned_to → None
d. UnitLog: action='returned'
```
---
## 9. Batasan dan Asumsi
- **Satu pengguna admin:** Sistem tidak mendukung multi-user dengan role berbeda
- **Dua kategori aset:** "Aset Karyawan" dan "Aset Network" — hardcoded dalam logika bisnis
- **Area hardcoded:** Lokasi area (RW, DAM, PH, dll) adalah choices statis, bukan data master
- **Tidak ada notifikasi:** Tidak ada email, push notif, atau alert otomatis
- **Tidak ada pagination:** Semua list ditampilkan sekaligus tanpa paging
- **Distribusi hanya untuk aset Karyawan:** Logika distribusi di `distribusi_list` view memfilter hanya unit Karyawan
+98
View File
@@ -0,0 +1,98 @@
# 03 — Feature Inventory: Inventaris Fitur Lengkap
**Tanggal Analisis:** 26 Oktober 2026
**Sumber:** `assets/views.py`, `itam_core/urls.py`, `templates/*.html`
**Status:** Terverifikasi dari source code statis
---
## Legenda Status
| Status | Arti |
|---|---|
| ✅ Implemented | Implementasi lengkap ditemukan |
| ⚠️ Partially Implemented | Sebagian alur tersedia |
| ❌ Potentially Defective | Bug/inkonsistensi ditemukan |
| 🔲 Missing | Tidak ditemukan implementasi |
| ❓ Unverified | Ada kode tapi belum bisa diverifikasi runtime |
---
## Feature Inventory Table
| FEAT-ID | Modul | Fitur | Deskripsi | Aktor | Entry Point (URL) | Komponen | Model | Permission | Status | Risiko |
|---|---|---|---|---|---|---|---|---|---|---|
| FEAT-001 | Auth | Login | Autentikasi username/password | Semua user | `GET/POST /login/` | `login_view`, `login.html` | Django User | Public | ✅ | Tidak ada rate limiting |
| FEAT-002 | Auth | Logout | Keluar dari sesi | Admin | `POST /logout/` | `logout_view` | Django User | Login | ✅ | — |
| FEAT-003 | Auth | Edit Profil | Update nama, username, email | Admin | `GET/POST /profil/` | `profile_view`, `profile.html` | Django User | Login | ✅ | Tidak ada validasi username unik |
| FEAT-004 | Auth | Ubah Password | Ganti password dengan verifikasi lama | Admin | `POST /profil/` | `profile_view` | Django User | Login | ✅ | — |
| FEAT-005 | Dashboard | Statistik Ringkasan | Jumlah aset per kategori dan status | Admin | `GET /` | `dashboard`, `dashboard.html` | AssetUnit, AssetAssignment | Login | ✅ | N+1 query potential |
| FEAT-006 | Dashboard | Log Aktivitas Terbaru | 5 serah terima, 3 mutasi, 3 pengembalian | Admin | `GET /` | `dashboard` | AssetAssignment | Login | ✅ | Data statis hardcoded limit |
| FEAT-007 | Aset | Daftar Aset | List aset dengan tab Karyawan/Network | Admin | `GET /aset/` | `asset_list`, `asset_list.html` | Asset, Category | Login | ✅ | Tidak ada pagination |
| FEAT-008 | Aset | Cari Aset | Filter berdasarkan kode, nama, merek | Admin | `GET /aset/?q=...` | `asset_list` | Asset | Login | ✅ | — |
| FEAT-009 | Aset | Tambah Aset | Create jenis aset baru | Admin | `POST /aset/add/` | `asset_add` | Asset | **❌ No Auth!** | ❌ | **CRITICAL: Tidak ada @login_required** |
| FEAT-010 | Aset | Edit Aset | Update data jenis aset | Admin | `POST /aset/{id}/edit/` | `asset_edit` | Asset, AssetUnit | Login | ✅ | Cascade update unit_code — risky |
| FEAT-011 | Aset | Hapus Aset | Delete jenis aset (CASCADE ke units) | Admin | `POST /aset/{id}/delete/` | `asset_delete` | Asset | Login | ✅ | Hapus unit juga! Tidak ada konfirmasi server-side |
| FEAT-012 | Aset | Export PDF Aset | Download laporan PDF daftar aset | Admin | `GET /aset/export/` | `asset_export_pdf` | Asset | Login (double decorator?) | ⚠️ | Dekorator ganda baris 84-86 |
| FEAT-013 | Aset | Export Excel Aset | Download laporan Excel daftar aset | Admin | `GET /aset/export-excel/` | `asset_export_excel` | Asset | Login | ✅ | — |
| FEAT-014 | Unit | Daftar Unit per Aset | List unit fisik suatu aset | Admin | `GET /aset/{id}/units/` | `asset_units`, `asset_units.html` | AssetUnit | Login | ✅ | Tidak ada pagination |
| FEAT-015 | Unit | Tambah Unit | Create unit fisik baru | Admin | `POST /aset/{id}/units/add/` | `unit_add` | AssetUnit, UnitLog | Login | ✅ | — |
| FEAT-016 | Unit | Edit Unit | Update kode, status, pemegang unit | Admin | `POST /unit/{id}/edit/` | `unit_edit` | AssetUnit, UnitLog | Login | ✅ | Tidak mengupdate AssetAssignment.status |
| FEAT-017 | Unit | Hapus Unit | Delete unit fisik | Admin | (URL tidak ada) | `unit_delete` (view ada) | AssetUnit | Login | ❌ | **BROKEN: view ada, URL tidak terdaftar** |
| FEAT-018 | Unit | Update Status (Network) | Update status dan lokasi unit network | Admin | `POST /unit/{id}/status/` | `unit_update_status` | AssetUnit, UnitLog | Login | ✅ | — |
| FEAT-019 | Unit | Export PDF Unit | Download laporan PDF unit per aset | Admin | `GET /aset/{id}/units/export/` | `asset_units_export_pdf` | AssetUnit | Login | ✅ | — |
| FEAT-020 | Unit | Export Excel Unit | Download laporan Excel unit | Admin | `GET /aset/{id}/units/export-excel/` | `asset_units_export_excel` | AssetUnit | Login | ✅ | — |
| FEAT-021 | QR | Generate QR Code | Buat gambar QR code unit | Publik | `GET /qr/{uuid}/` | `unit_qr_code` | AssetUnit | Public (no auth) | ✅ | Font 'arial.ttf' mungkin tidak tersedia di Linux |
| FEAT-022 | QR | Halaman Publik Unit | Detail unit tanpa login (untuk QR scan) | Publik | `GET /public/unit/{uuid}/` | `unit_public_detail`, `unit_public_detail.html` | AssetUnit, UnitLog | Public (no auth) | ✅ | Mengekspos info unit ke publik |
| FEAT-023 | Riwayat | Timeline Unit | Riwayat historis unit aset | Admin | `GET /unit/{id}/history/` | `unit_history`, `unit_history.html` | UnitLog | Login | ✅ | — |
| FEAT-024 | Riwayat | Export PDF Riwayat | Download laporan PDF riwayat unit | Admin | `GET /unit/{id}/history/export/` | `unit_history_export_pdf` | UnitLog | Login | ✅ | — |
| FEAT-025 | Riwayat | Export Excel Riwayat | Download laporan Excel riwayat | Admin | `GET /unit/{id}/history/export-excel/` | `unit_history_export_excel` | UnitLog | Login | ✅ | — |
| FEAT-026 | Status | Monitor Status Aset | List unit per status dan kategori | Admin | `GET /status-aset/` | `status_aset_list`, `status_aset_list.html` | AssetUnit | Login | ✅ | Tidak ada pagination |
| FEAT-027 | Status | Cari Status Aset | Filter berdasarkan kode, nama, karyawan, area | Admin | `GET /status-aset/?q=...` | `status_aset_list` | AssetUnit | Login | ✅ | — |
| FEAT-028 | Status | Export PDF Status | Download laporan PDF status aset | Admin | `GET /status-aset/export/` | `status_aset_export_pdf` | AssetUnit | Login | ✅ | — |
| FEAT-029 | Status | Export Excel Status | Download laporan Excel status | Admin | `GET /status-aset/export-excel/` | `status_aset_export_excel` | AssetUnit | Login | ✅ | — |
| FEAT-030 | Distribusi | Daftar Distribusi | List semua transaksi distribusi | Admin | `GET /distribusi/` | `distribusi_list`, `distribusi_list.html` | AssetAssignment | Login | ✅ | Tidak ada pagination |
| FEAT-031 | Distribusi | Serah Terima | Distribusi aset ke karyawan | Admin | `POST /distribusi/handover/` | `distribusi_handover` | AssetAssignment, AssetUnit, UnitLog | Login | ✅ | Validasi status unit minimal |
| FEAT-032 | Distribusi | Mutasi Aset | Pindah aset antar karyawan | Admin | `POST /distribusi/mutation/` | `distribusi_mutation` | AssetAssignment, AssetUnit, UnitLog | Login | ✅ | — |
| FEAT-033 | Distribusi | Pengembalian Aset | Kembalikan aset ke gudang | Admin | `POST /distribusi/return/` | `distribusi_return` | AssetAssignment, AssetUnit, UnitLog | Login | ⚠️ | `returned_date` tidak di-update |
| FEAT-034 | Distribusi | Upload Dokumen BAST | Upload dokumen setelah transaksi | Admin | `POST /distribusi/{id}/upload/` | `distribusi_upload_doc` | AssetAssignment | Login | ✅ | File type dan size validated |
| FEAT-035 | Distribusi | Export PDF Distribusi | Download laporan PDF distribusi | Admin | `GET /distribusi/export/` | `distribusi_export_pdf` | AssetAssignment | Login | ✅ | — |
| FEAT-036 | Distribusi | Export Excel Distribusi | Download laporan Excel distribusi | Admin | `GET /distribusi/export-excel/` | `distribusi_export_excel` | AssetAssignment | Login | ✅ | — |
| FEAT-037 | Karyawan | Daftar Karyawan | List karyawan dengan jumlah aset | Admin | `GET /karyawan/` | `employee_list`, `employee_list.html` | Employee | Login | ✅ | Tidak ada pagination |
| FEAT-038 | Karyawan | Cari Karyawan | Filter berdasarkan nama atau NIK | Admin | `GET /karyawan/?q=...` | `employee_list` | Employee | Login | ✅ | — |
| FEAT-039 | Karyawan | Tambah Karyawan | Create data karyawan | Admin | `POST /karyawan/buat/` | `employee_create` | Employee | Login | ✅ | — |
| FEAT-040 | Karyawan | Edit Karyawan | Update data karyawan | Admin | `POST /karyawan/{id}/edit/` | `employee_edit` | Employee | Login | ✅ | — |
| FEAT-041 | Karyawan | Hapus Karyawan | Delete karyawan (proteksi jika masih pegang aset) | Admin | `POST /karyawan/{id}/delete/` | `employee_delete` | Employee, UnitLog | Login | ✅ | Embed nama di notes — fragile |
| FEAT-042 | Karyawan | Detail Karyawan | Aset yang dipegang karyawan | Admin | `GET /karyawan/{id}/` | `employee_detail`, `employee_detail.html` | Employee, AssetUnit | Login | ✅ | — |
| FEAT-043 | Karyawan | Export PDF Karyawan | Download laporan PDF karyawan | Admin | `GET /karyawan/export/` | `employee_export_pdf` | Employee | Login | ✅ | — |
| FEAT-044 | Karyawan | Export Excel Karyawan | Download Excel daftar karyawan | Admin | `GET /karyawan/export-excel/` | `employee_export_excel` | Employee | Login | ✅ | — |
| FEAT-045 | Karyawan | Export PDF Detail | Export PDF aset per karyawan | Admin | `GET /karyawan/{id}/export/` | `employee_detail_export_pdf` | Employee, AssetUnit | Login | ✅ | — |
| FEAT-046 | Karyawan | Export Excel Detail | Export Excel aset per karyawan | Admin | `GET /karyawan/{id}/export-excel/` | `employee_detail_export_excel` | Employee, AssetAssignment | Login | ✅ | — |
| FEAT-047 | Backup | Export JSON | Download backup data sebagai JSON (dumpdata) | Admin | `POST /backup/` | `backup_database_view` | Semua | Login | ❓ | Implementasi belum diverifikasi penuh |
| FEAT-048 | Backup | Export SQL | Download backup sebagai SQL (mysqldump) | Admin | `POST /backup/` | `backup_database_view` | Semua | Login | ❓ | Risiko subprocess injection jika tidak divalidasi |
| FEAT-049 | Settings | Lihat 404 Test | Halaman test 404 | Admin | `GET /404/` | `custom_404_view` | — | Public | ✅ | Halaman debug — seharusnya dihapus di production |
---
## Ringkasan Status
| Status | Jumlah |
|---|---|
| ✅ Implemented | 39 |
| ⚠️ Partially Implemented | 3 |
| ❌ Potentially Defective | 2 |
| ❓ Unverified | 2 |
| 🔲 Missing | 0 |
| **Total** | **49** |
---
## Fitur Kritis yang Perlu Perhatian Segera
| FEAT-ID | Masalah | Dampak |
|---|---|---|
| FEAT-009 | `asset_add` tidak ada `@login_required` | Penambahan aset oleh siapapun |
| FEAT-017 | `unit_delete` view ada tapi URL tidak terdaftar | Hapus unit tidak bisa dilakukan |
| FEAT-012 | Double `@login_required` decorator (anomali) | Potensi bug tak terduga |
| FEAT-033 | `returned_date` tidak diisi saat pengembalian | Data tidak akurat |
| FEAT-048 | Backup SQL via mysqldump — perlu audit subprocess | Risiko keamanan command injection |
@@ -0,0 +1,319 @@
# 04 — Database & Data Dictionary: Model dan Skema Database
**Tanggal Analisis:** 26 Oktober 2026
**Sumber:** `assets/models.py`, `assets/migrations/0001_initial.py` — `0016_sync_existing_unit_codes.py`
**Status:** Terverifikasi dari source code — struktur aktual database hanya dapat dipastikan dengan akses runtime
---
## 1. Daftar Model
| Model | Tabel (estimasi) | Baris Definisi | Deskripsi |
|---|---|---|---|
| `Employee` | `assets_employee` | L4-10 | Data karyawan/pengguna aset |
| `Category` | `assets_category` | L12-16 | Kategori jenis aset |
| `Asset` | `assets_asset` | L18-82 | Jenis/tipe aset (SKU-level) |
| `AssetUnit` | `assets_assetunit` | L84-116 | Unit fisik individual |
| `UnitLog` | `assets_unitlog` | L118-141 | Riwayat historis setiap unit |
| `AssetAssignment` | `assets_assetassignment` | L143-168 | Riwayat distribusi aset |
---
## 2. Data Dictionary
### 2.1 Model: `Employee`
**Tujuan:** Menyimpan data karyawan yang dapat menerima/memegang aset IT
| Field | Tipe Django | Tipe DB (est.) | Nullable | Unique | Default | Keterangan |
|---|---|---|---|---|---|---|
| `id` | `BigAutoField` | `BIGINT` | No | Yes (PK) | Auto | Primary key otomatis |
| `nik` | `CharField(20)` | `VARCHAR(20)` | No | Yes | — | Nomor Induk Karyawan |
| `name` | `CharField(150)` | `VARCHAR(150)` | No | No | — | Nama lengkap karyawan |
| `position` | `CharField(100)` | `VARCHAR(100)` | Yes | No | None | Jabatan (ditambah di migration 0014) |
**Constraints:**
- `nik` adalah unique — duplikasi NIK dicegah di level model
**Methods:** `__str__` → `"{nik} - {name}"`
**Relasi:**
- `AssetUnit.assigned_to` → FK ke Employee (SET_NULL)
- `UnitLog.employee` → FK ke Employee (SET_NULL)
- `AssetAssignment.employee` → FK ke Employee (SET_NULL)
- `AssetAssignment.from_employee` → FK ke Employee (SET_NULL)
---
### 2.2 Model: `Category`
**Tujuan:** Klasifikasi jenis aset (minimal dua: "Aset Karyawan" dan "Aset Network")
| Field | Tipe Django | Tipe DB (est.) | Nullable | Unique | Default | Keterangan |
|---|---|---|---|---|---|---|
| `id` | `BigAutoField` | `BIGINT` | No | Yes (PK) | Auto | Primary key otomatis |
| `name` | `CharField(100)` | `VARCHAR(100)` | No | No | — | Nama kategori |
> [!NOTE]
> Seed data di `seed_initial_data.py` membuat dua kategori default: `'Aset Karyawan'` dan `'Aset Network'`. Aplikasi menggunakan `__icontains` untuk membedakan, bukan relasi eksplisit.
---
### 2.3 Model: `Asset`
**Tujuan:** Merepresentasikan jenis/tipe aset (SKU-level). Satu Asset bisa memiliki banyak AssetUnit.
| Field | Tipe Django | Tipe DB (est.) | Nullable | Unique | Default | Keterangan |
|---|---|---|---|---|---|---|
| `id` | `BigAutoField` | `BIGINT` | No | Yes (PK) | Auto | Primary key |
| `category` | `ForeignKey(Category)` | `BIGINT` (FK) | Yes | No | — | Kategori aset, SET_NULL jika kategori dihapus |
| `no_index` | `CharField(20)` | `VARCHAR(20)` | Yes | No | None | Nomor urut manual (tidak digenerate otomatis) |
| `asset_code` | `CharField(50)` | `VARCHAR(50)` | No | Yes | — | Kode unik aset, uppercase |
| `name` | `CharField(150)` | `VARCHAR(150)` | No | No | — | Nama aset |
| `brand` | `CharField(100)` | `VARCHAR(100)` | Yes | No | None | Merek/brand |
| `qty` | `IntegerField` | `INT` | No | No | 0 | Jumlah unit yang tercatat |
| `sum_qty` | `IntegerField` | `INT` | No | No | 0 | Tidak jelas digunakan untuk apa (field tidak di-update di kode) |
| `uom` | `CharField(50)` | `VARCHAR(50)` | Yes | No | None | Satuan unit (Unit, Pcs, dll) |
| `price` | `DecimalField(15,2)` | `DECIMAL(15,2)` | No | No | 0 | Harga satuan |
| `total_price` | `DecimalField(15,2)` | `DECIMAL(15,2)` | No | No | 0 | Total harga (tidak otomatis dihitung) |
| `serial_number` | `CharField(100)` | `VARCHAR(100)` | Yes | No | None | Serial number aset induk |
| `purchase_date` | `DateField` | `DATE` | Yes | No | None | Tanggal pembelian |
| `notes` | `TextField` | `TEXT` | Yes | No | None | Catatan tambahan |
**Potensi Masalah:**
- `qty` diupdate manual (`asset.qty = asset.units.count()`) hanya pada beberapa kondisi — tidak konsisten
- `sum_qty`, `price`, `total_price` — tampaknya tidak di-update oleh views yang ada. Kemungkinan field legacy
- `serial_number` di level Asset (bukan unit) — pada aplikasi ini, SN mungkin lebih relevan di level unit
- Tidak ada `created_at` atau `updated_at` pada model ini
**Custom `save()` method:**
- Mendeteksi jika `asset_code` berubah
- Jika berubah, otomatis mengupdate `unit_code` semua unit anak (L39-82)
- Menggunakan `transaction.atomic()` untuk atomisitas
---
### 2.4 Model: `AssetUnit`
**Tujuan:** Unit fisik individual. Satu unit = satu perangkat nyata dengan kode unik.
| Field | Tipe Django | Tipe DB (est.) | Nullable | Unique | Default | Keterangan |
|---|---|---|---|---|---|---|
| `id` | `BigAutoField` | `BIGINT` | No | Yes (PK) | Auto | Primary key integer |
| `id_uuid` | `UUIDField` | `CHAR(32)` | No | Yes | `uuid4()` | UUID untuk URL publik dan QR code |
| `asset` | `ForeignKey(Asset)` | `BIGINT` (FK) | No | No | — | Aset induk, CASCADE jika asset dihapus |
| `unit_code` | `CharField(60)` | `VARCHAR(60)` | No | Yes | — | Kode unik unit (format: `{asset_code}-{suffix}`) |
| `status` | `CharField(20)` | `VARCHAR(20)` | No | No | `'tersedia'` | Status unit |
| `assigned_to` | `ForeignKey(Employee)` | `BIGINT` (FK) | Yes | No | None | Pemegang saat ini, SET_NULL jika employee dihapus |
| `area` | `CharField(50)` | `VARCHAR(50)` | Yes | No | None | Area pemasangan (untuk aset network) |
| `location` | `CharField(255)` | `VARCHAR(255)` | Yes | No | None | Lokasi spesifik |
**STATUS_CHOICES:**
| Value | Label |
|---|---|
| `tersedia` | Tersedia |
| `digunakan` | Digunakan |
| `rusak` | Diperbaiki (label mismatch — value "rusak" tapi label "Diperbaiki") |
| `pensiun` | Dipensiunkan |
**AREA_CHOICES (hardcoded, domain spesifik PT. KMH):**
- Regulating Weir (RW), Jakon, Beringin Tunggal (BT), DAM, Adit 1/2/3, Gudang Induk (GI), Vertical Shaft (VS), Power House (PH), Lain-lainnya
> [!WARNING]
> **Status mismatch:** Field `status` memiliki value `'rusak'` tetapi label `'Diperbaiki'`. Di views, status ini diperlakukan sebagai "maintenance". Inkonsistensi antara value dan label dapat membingungkan developer.
---
### 2.5 Model: `UnitLog`
**Tujuan:** Audit trail setiap unit aset — mencatat semua perubahan status dan kejadian.
| Field | Tipe Django | Tipe DB (est.) | Nullable | Unique | Default | Keterangan |
|---|---|---|---|---|---|---|
| `id` | `BigAutoField` | `BIGINT` | No | Yes (PK) | Auto | Primary key |
| `unit` | `ForeignKey(AssetUnit)` | `BIGINT` (FK) | No | No | — | Unit terkait, CASCADE jika unit dihapus |
| `timestamp` | `DateTimeField(auto_now_add=True)` | `DATETIME` | No | No | Now | Waktu kejadian (otomatis) |
| `action` | `CharField(20)` | `VARCHAR(20)` | No | No | — | Jenis kejadian (choices) |
| `employee` | `ForeignKey(Employee)` | `BIGINT` (FK) | Yes | No | None | Karyawan terkait, SET_NULL |
| `notes` | `TextField` | `TEXT` | Yes | No | None | Catatan detail |
**ACTION_CHOICES:**
| Value | Label |
|---|---|
| `created` | Ditambahkan ke Sistem |
| `assigned` | Diserahkan kepada Karyawan |
| `returned` | Dikembalikan |
| `maintenance_in` | Masuk Perbaikan |
| `maintenance_out` | Selesai Perbaikan |
| `mutation` | Pindah User |
| `retired` | Dipensiunkan |
| `other` | Lain-lain |
**Meta:**
- `ordering = ['-timestamp']` — terbaru di atas
**Catatan Penting:**
- Ketika `employee` dihapus, nama karyawan di-embed ke dalam `notes` sebelum deletion (mekanisme `employee_delete` di views.py L792-796)
- Pattern parsing: `"{name} ({nik}) - {catatan}"` — parsing dilakukan dengan regex di view dan export
---
### 2.6 Model: `AssetAssignment`
**Tujuan:** Riwayat formal distribusi aset — serah terima, mutasi, pengembalian. Berbeda dengan UnitLog, ini adalah record formal dengan dokumen.
| Field | Tipe Django | Tipe DB (est.) | Nullable | Unique | Default | Keterangan |
|---|---|---|---|---|---|---|
| `id` | `BigAutoField` | `BIGINT` | No | Yes (PK) | Auto | Primary key |
| `type` | `CharField(20)` | `VARCHAR(20)` | No | No | `'handover'` | Tipe distribusi |
| `unit` | `ForeignKey(AssetUnit)` | `BIGINT` (FK) | No | No | — | Unit terkait, **PROTECT** — tidak bisa dihapus jika ada assignment |
| `employee` | `ForeignKey(Employee)` | `BIGINT` (FK) | Yes | No | None | Penerima, SET_NULL |
| `from_employee` | `ForeignKey(Employee)` | `BIGINT` (FK) | Yes | No | None | Pengirim (untuk mutasi), SET_NULL |
| `assigned_date` | `DateField` | `DATE` | No | No | — | Tanggal transaksi |
| `returned_date` | `DateField` | `DATE` | Yes | No | None | Tanggal dikembalikan (tidak di-update secara konsisten) |
| `document` | `FileField` | `VARCHAR(100)` | Yes | No | None | Path file dokumen BAST |
| `status` | `CharField(20)` | `VARCHAR(20)` | No | No | `'aktif'` | Status penugasan |
| `notes` | `TextField` | `TEXT` | Yes | No | None | Catatan tambahan |
| `created_at` | `DateTimeField(auto_now_add=True)` | `DATETIME` | Yes | No | Now | Waktu dibuat (ditambah di migration 0015) |
**TYPE_CHOICES:**
| Value | Label |
|---|---|
| `handover` | Serah Terima |
| `mutation` | Mutasi |
| `return` | Pengembalian |
**STATUS_CHOICES:**
| Value | Label |
|---|---|
| `aktif` | Aktif |
| `dikembalikan` | Dikembalikan |
> [!WARNING]
> `returned_date` tidak di-update secara otomatis ketika proses pengembalian (`distribusi_return`) dilakukan. Ini adalah inkonsistensi — field ada tapi tidak digunakan.
**Potensi masalah:**
- `status` field di `AssetAssignment` tidak di-update saat distribusi return — semua record tetap `'aktif'`
- `unit` menggunakan `PROTECT` — mencegah penghapusan unit jika ada assignment
---
## 3. Entity Relationship Diagram (ERD)
```mermaid
erDiagram
Category {
bigint id PK
varchar(100) name
}
Employee {
bigint id PK
varchar(20) nik UK
varchar(150) name
varchar(100) position
}
Asset {
bigint id PK
bigint category_id FK
varchar(20) no_index
varchar(50) asset_code UK
varchar(150) name
varchar(100) brand
int qty
int sum_qty
varchar(50) uom
decimal(15-2) price
decimal(15-2) total_price
varchar(100) serial_number
date purchase_date
text notes
}
AssetUnit {
bigint id PK
char(32) id_uuid UK
bigint asset_id FK
varchar(60) unit_code UK
varchar(20) status
bigint assigned_to_id FK
varchar(50) area
varchar(255) location
}
UnitLog {
bigint id PK
bigint unit_id FK
datetime timestamp
varchar(20) action
bigint employee_id FK
text notes
}
AssetAssignment {
bigint id PK
varchar(20) type
bigint unit_id FK
bigint employee_id FK
bigint from_employee_id FK
date assigned_date
date returned_date
varchar(100) document
varchar(20) status
text notes
datetime created_at
}
Category ||--o{ Asset : "mengkategorikan"
Asset ||--o{ AssetUnit : "memiliki unit"
Employee ||--o{ AssetUnit : "memegang (assigned_to)"
AssetUnit ||--o{ UnitLog : "memiliki riwayat"
Employee ||--o{ UnitLog : "terkait dengan"
AssetUnit ||--o{ AssetAssignment : "memiliki distribusi"
Employee ||--o{ AssetAssignment : "menerima (employee)"
Employee ||--o{ AssetAssignment : "mengirim (from_employee)"
```
---
## 4. Migration Overview
| Migration | Perubahan Utama | Tanggal (dari kode) |
|---|---|---|
| `0001_initial.py` | Create: Category, Employee, Asset (dengan status), AssetAssignment | 2026-10-06 |
| `0002` | Tambah: `no_index`, `price`, `qty`, `sum_qty` ke Asset; tambah `AssetUnit` | — |
| `0003` | Remove: `status` dari Asset; hapus field lama; restrukturisasi model | — |
| `0004` | Create: `UnitLog` model | — |
| `0005` | Tambah: `brand` ke Asset; alter beberapa field | — |
| `0006` | Create: `MasterAssetCode` (kemudian dihapus) | — |
| `0007` | Delete: `MasterAssetCode` | — |
| `0008` | Remove: `label` dari AssetUnit; alter `UnitLog.action` choices | — |
| `0009` | Tambah: `from_employee`, `type` ke AssetAssignment | — |
| `0010` | Tambah: `area`, `location` ke AssetUnit | — |
| `0011` | Tambah: `id_uuid` ke AssetUnit | — |
| `0012` | Alter: `id_uuid` ke UUID type yang benar | — |
| `0013` | Alter: FK AssetAssignment (ubah CASCADE ke SET_NULL/PROTECT) | — |
| `0014` | Tambah: `position` ke Employee | — |
| `0015` | Tambah: `created_at` ke AssetAssignment | — |
| `0016` | RunPython: Sinkronisasi unit_code dengan asset_code induk | 2026-10-13 |
> [!NOTE]
> Adanya migration `0006` (create MasterAssetCode) diikuti `0007` (delete MasterAssetCode) menunjukkan ada eksperimen desain yang ditinggalkan. Field ini kemungkinan digantikan dengan `asset_code` yang ada di `Asset`.
---
## 5. Potensi Masalah Database
| # | Masalah | Lokasi | Dampak | Rekomendasi |
|---|---|---|---|---|
| DB-01 | `qty` tidak sinkron otomatis | `Asset.qty`, views.py | Angka `qty` di Asset bisa tidak akurat | Gunakan annotate dari unit count, bukan field tersimpan |
| DB-02 | `sum_qty`, `price`, `total_price` tidak diisi | `Asset` model | Field tidak berguna, membuang ruang | Audit penggunaan atau hapus jika tidak diperlukan |
| DB-03 | `returned_date` tidak diisi | `AssetAssignment` | Field tidak berfungsi | Update saat proses return |
| DB-04 | `AssetAssignment.status` tidak diupdate | views.py | Semua assignment berstatus 'aktif' meskipun sudah dikembalikan | Update status saat return |
| DB-05 | Status value mismatch di AssetUnit | models.py L89 | `'rusak'` → label `'Diperbaiki'` membingungkan | Ganti value ke `'maintenance'` atau sesuaikan label |
| DB-06 | Tidak ada soft delete | Semua model | Data yang dihapus tidak bisa dipulihkan | Pertimbangkan soft delete untuk Employee dan Asset |
| DB-07 | Tidak ada `created_at`/`updated_at` di Asset, Employee, Category, AssetUnit | — | Tidak bisa audit kapan data dibuat/diubah | Tambahkan audit fields |
| DB-08 | No index pada field pencarian umum | AssetUnit.status, Employee.name | Potensi slow query pada data besar | Tambahkan db_index=True |
| DB-09 | ON DELETE PROTECT pada AssetUnit→AssetAssignment | AssetAssignment.unit | Delete unit akan error jika ada assignment | By design, tapi perlu handling error yang baik di view |
| DB-10 | Employee deletion hardcode embed nama ke UnitLog.notes | views.py L792-796 | Parsing fragile, regex-based | Pertimbangkan soft delete atau arsip employee |
+156
View File
@@ -0,0 +1,156 @@
# 05 — Roles, Permissions & Authentication
**Tanggal Analisis:** 26 Oktober 2026
**Sumber:** `assets/views.py`, `itam_core/settings.py`, `itam_core/urls.py`, `templates/base.html`
**Status:** Terverifikasi dari source code
---
## 1. Authentication Flow
### 1.1 Login
```mermaid
flowchart TD
A["User → GET /login/"] --> B{Sudah login?}
B -->|Ya| C["Redirect → /dashboard/"]
B -->|Tidak| D["Tampilkan login.html"]
D --> E["User submit POST /login/"]
E --> F{Input berisi '@'?}
F -->|Ya| G["Lookup User by email"]
G --> H["Gunakan username yang ditemukan"]
F -->|Tidak| H
H --> I["authenticate(username, password)"]
I --> J{Valid?}
J -->|Ya| K["login(request, user)"]
K --> L{Ada next param yang aman?}
L -->|Ya| M["Redirect ke next URL"]
L -->|Tidak| N["Redirect → /dashboard/"]
J -->|Tidak| O["messages.error → tampil pesan salah"]
O --> D
```
**Fitur login:**
- Login via username ATAU email (L2452-2458 di `login_view`)
- Redirect ke URL `next` yang aman setelah login (menggunakan `url_has_allowed_host_and_scheme`)
- Jika sudah login, redirect ke dashboard
### 1.2 Logout
- Hanya via POST (`logout_view` L2473-2476)
- CSRF token diperlukan (form di base.html mengandung CSRF token)
- Redirect ke `/login/` setelah logout
### 1.3 Django Session
- Session disimpan di database Django (default `django.contrib.sessions.SessionStore`)
- `SESSION_COOKIE_SECURE = True` di production (DEBUG=False)
---
## 2. Authorization Model
### 2.1 Model Authorization yang Digunakan
| Mekanisme | Digunakan? | Detail |
|---|---|---|
| `@login_required` decorator | Ya | Hampir semua view menggunakannya |
| Django Groups | Tidak ditemukan implementasi | INSTALLED_APPS include `auth`, tapi tidak ada grup |
| Django Permissions | Tidak ditemukan | Tidak ada `has_perm()` atau `permission_required` |
| Object-level permissions | Tidak ada | Tidak ada django-guardian atau similar |
| Custom middleware | Tidak ada | Hanya middleware bawaan |
| Role-based access | Tidak ada | Satu level: authenticated = akses penuh |
### 2.2 Satu-satunya Pembatasan Akses Khusus
**Backup Database** — hanya `is_superuser` yang dapat mengakses:
```python
# assets/views.py L2538-2540
if not request.user.is_superuser:
return HttpResponseForbidden("Anda tidak memiliki akses ke halaman ini.")
```
Ini adalah **satu-satunya** pembatasan akses berbasis role yang ditemukan di seluruh aplikasi.
---
## 3. Role yang Teridentifikasi
| Role | Deskripsi | Akses | Bukti | Status |
|---|---|---|---|---|
| **Anonymous** | Belum login | Hanya: `/login/`, `/public/unit/{uuid}/`, `/qr/{uuid}/` | URL patterns | Terverifikasi |
| **Authenticated User** | User Django yang sudah login | Hampir semua fitur kecuali backup SQL | `@login_required` di views | Terverifikasi |
| **Superuser** | `is_superuser=True` | Semua fitur termasuk backup database | `backup_database_view` check L2538 | Terverifikasi |
> [!WARNING]
> **Tidak ada diferensiasi role** dalam praktiknya. Jika ada 2 user yang login, keduanya memiliki akses yang sama ke semua fitur kecuali backup. Tidak ada "read-only" user, tidak ada role "supervisor" atau "viewer".
---
## 4. Permission Matrix per Fitur
| Fitur | Anonymous | Authenticated | Superuser | Catatan |
|---|---|---|---|---|
| Login | ✅ | ↩️ Redirect | ↩️ Redirect | — |
| Logout | ❌ | ✅ | ✅ | — |
| Dashboard | ❌ | ✅ | ✅ | — |
| Daftar Aset | ❌ | ✅ | ✅ | — |
| **Tambah Aset** | **✅ PUBLIK!** | ✅ | ✅ | **BUG: tidak ada @login_required** |
| Edit Aset | ❌ | ✅ | ✅ | — |
| Hapus Aset | ❌ | ✅ | ✅ | — |
| Export Aset | ❌ | ✅ | ✅ | Anomali double decorator |
| Unit Aset | ❌ | ✅ | ✅ | — |
| Tambah Unit | ❌ | ✅ | ✅ | — |
| Edit Unit | ❌ | ✅ | ✅ | — |
| Hapus Unit | N/A | N/A | N/A | URL tidak terdaftar |
| Status Aset | ❌ | ✅ | ✅ | — |
| Distribusi | ❌ | ✅ | ✅ | — |
| Data Karyawan | ❌ | ✅ | ✅ | — |
| QR Code | ✅ | ✅ | ✅ | By design — untuk scan publik |
| Halaman Publik Unit | ✅ | ✅ | ✅ | By design — untuk scan QR |
| Backup JSON | ❌ | ✅* | ✅ | *Authenticated non-superuser bisa akses (tidak ada superuser check) |
| **Backup SQL** | ❌ | ❌ Forbidden | ✅ | Satu-satunya pembatasan khusus |
| Profil | ❌ | ✅ | ✅ | — |
| Django Admin | Varies | Staff only | ✅ | **URL dikomentari di urls.py** |
> [!CAUTION]
> **Backup JSON (dumpdata)** dapat diakses oleh semua authenticated user (bukan hanya superuser). Ini dapat mengekspos seluruh data database kepada operator biasa jika ada multi-user di masa depan.
---
## 5. Security Findings terkait Auth
| Finding | Lokasi | Severity | Detail |
|---|---|---|---|
| `asset_add` tanpa `@login_required` | `views.py` L192 | High | Siapapun bisa tambah aset |
| `unit_qr_code` tanpa `@login_required` | `views.py` L804 | Info | Disengaja — QR perlu diakses publik |
| `unit_public_detail` tanpa `@login_required` | `views.py` L847 | Info | Disengaja — halaman publik untuk QR |
| `backup_database_view` hanya check superuser untuk SQL | `views.py` L2538 | Medium | JSON backup tidak dilindungi sama ketatnya |
| Double `@login_required` di baris 84-86 | `views.py` L84-86 | Low | Kode anomali, tapi tidak merusak security |
| `login_view` tidak ada rate limiting | `views.py` L2442 | Medium | Brute-force login tidak dicegah |
| Django Admin dinonaktifkan di URL | `urls.py` L20 | Info | `path('admin/', ...)` dikomentari |
---
## 6. Password Management
| Aspek | Implementasi | Status |
|---|---|---|
| Password hashing | Django default (PBKDF2-SHA256) | ✅ Aman |
| Password validators | 4 validator aktif (similarity, length, common, numeric) | ✅ |
| Ganti password | Verifikasi password lama dulu | ✅ |
| Session update setelah ganti password | `update_session_auth_hash` dipanggil | ✅ |
| Password reset via email | Tidak ditemukan | ❌ Missing |
| Password via env | `setup_superuser.py` membaca dari env | ✅ |
---
## 7. Bagian yang Belum Dapat Diverifikasi
| Aspek | Status | Langkah Verifikasi |
|---|---|---|
| Apakah ada lebih dari satu Django user di production | Belum diketahui | Periksa database `auth_user` |
| Konfigurasi session expire time | Belum diketahui | Cek settings untuk `SESSION_COOKIE_AGE` (tidak ditemukan, default Django = 2 minggu) |
| Apakah Django Admin pernah digunakan sebelumnya | Indikasi ya (terdaftar di admin.py) | Periksa apakah ada data di `django_admin_log` |
| Mekanisme recovery jika password superuser terlupa | Belum terverifikasi | Cek apakah `setup_superuser.py` ada di deployment runbook |
+166
View File
@@ -0,0 +1,166 @@
# 06 — API & URL Documentation
**Tanggal Analisis:** 26 Oktober 2026
**Sumber:** `itam_core/urls.py`, `assets/views.py`
**Status:** Terverifikasi dari source code
> [!NOTE]
> Aplikasi ini **tidak memiliki REST API**. Semua endpoint adalah traditional Django views yang menghasilkan HTML response atau file download (PDF/Excel/Image). HTMX digunakan untuk partial page updates, bukan REST API JSON.
---
## 1. Katalog URL Lengkap
| # | Method | URL Pattern | View Function | Auth | Output | Keterangan |
|---|---|---|---|---|---|---|
| 1 | GET | `/` | `dashboard` | Login | HTML | Dashboard utama |
| 2 | GET/POST | `/login/` | `login_view` | Public | HTML/Redirect | Login page |
| 3 | POST | `/logout/` | `logout_view` | Login | Redirect | Logout |
| 4 | GET/POST | `/profil/` | `profile_view` | Login | HTML/Redirect | Edit profil & password |
| 5 | GET/POST | `/backup/` | `backup_database_view` | Superuser | HTML/File | Backup database |
| 6 | GET | `/404/` | `custom_404_view` | Public | HTML | Test 404 |
| 7 | GET | `/aset/` | `asset_list` | Login | HTML | Daftar aset (tab Karyawan/Network) |
| 8 | GET | `/aset/export/` | `asset_export_pdf` | Login | PDF | Export PDF daftar aset |
| 9 | GET | `/aset/export-excel/` | `asset_export_excel` | Login | XLSX | Export Excel daftar aset |
| 10 | GET/POST | `/aset/add/` | `asset_add` | **❌ No Auth!** | JSON/Redirect | Tambah aset baru |
| 11 | GET/POST | `/aset/<int:asset_id>/edit/` | `asset_edit` | Login | JSON/Redirect | Edit aset |
| 12 | GET/POST | `/aset/<int:asset_id>/delete/` | `asset_delete` | Login | Redirect | Hapus aset |
| 13 | GET | `/aset/<int:asset_id>/units/` | `asset_units` | Login | HTML | Daftar unit per aset |
| 14 | GET | `/aset/<int:asset_id>/units/export/` | `asset_units_export_pdf` | Login | PDF | Export PDF unit |
| 15 | GET | `/aset/<int:asset_id>/units/export-excel/` | `asset_units_export_excel` | Login | XLSX | Export Excel unit |
| 16 | POST | `/aset/<int:asset_id>/units/add/` | `unit_add` | Login | JSON/Redirect | Tambah unit fisik |
| 17 | POST | `/unit/<int:unit_id>/edit/` | `unit_edit` | Login | JSON/Redirect | Edit unit |
| 18 | POST | `/unit/<int:unit_id>/status/` | `unit_update_status` | Login | Redirect | Update status unit |
| 19 | GET | `/unit/<int:unit_id>/history/` | `unit_history` | Login | HTML | Riwayat/history unit |
| 20 | GET | `/unit/<int:unit_id>/history/export/` | `unit_history_export_pdf` | Login | PDF | Export PDF riwayat |
| 21 | GET | `/unit/<int:unit_id>/history/export-excel/` | `unit_history_export_excel` | Login | XLSX | Export Excel riwayat |
| 22 | GET | `/status-aset/` | `status_aset_list` | Login | HTML | Status semua unit |
| 23 | GET | `/status-aset/export/` | `status_aset_export_pdf` | Login | PDF | Export PDF status |
| 24 | GET | `/status-aset/export-excel/` | `status_aset_export_excel` | Login | XLSX | Export Excel status |
| 25 | GET | `/distribusi/` | `distribusi_list` | Login | HTML | Daftar distribusi |
| 26 | GET | `/distribusi/export/` | `distribusi_export_pdf` | Login | PDF | Export PDF distribusi |
| 27 | GET | `/distribusi/export-excel/` | `distribusi_export_excel` | Login | XLSX | Export Excel distribusi |
| 28 | POST | `/distribusi/handover/` | `distribusi_handover` | Login | Redirect | Serah terima aset |
| 29 | POST | `/distribusi/mutation/` | `distribusi_mutation` | Login | Redirect | Mutasi aset |
| 30 | POST | `/distribusi/return/` | `distribusi_return` | Login | Redirect | Pengembalian aset |
| 31 | POST | `/distribusi/<int:assignment_id>/upload/` | `distribusi_upload_doc` | Login | Redirect | Upload dokumen BAST |
| 32 | GET | `/karyawan/` | `employee_list` | Login | HTML | Daftar karyawan |
| 33 | GET | `/karyawan/export/` | `employee_export_pdf` | Login | PDF | Export PDF karyawan |
| 34 | GET | `/karyawan/export-excel/` | `employee_export_excel` | Login | XLSX | Export Excel karyawan |
| 35 | GET/POST | `/karyawan/buat/` | `employee_create` | Login | JSON/Redirect | Tambah karyawan |
| 36 | GET | `/karyawan/<int:emp_id>/` | `employee_detail` | Login | HTML | Detail karyawan |
| 37 | GET | `/karyawan/<int:emp_id>/export/` | `employee_detail_export_pdf` | Login | PDF | Export PDF detail karyawan |
| 38 | GET | `/karyawan/<int:emp_id>/export-excel/` | `employee_detail_export_excel` | Login | XLSX | Export Excel detail karyawan |
| 39 | POST | `/karyawan/<int:emp_id>/edit/` | `employee_edit` | Login | JSON/Redirect | Edit karyawan |
| 40 | POST | `/karyawan/<int:emp_id>/delete/` | `employee_delete` | Login | Redirect | Hapus karyawan |
| 41 | GET | `/qr/<uuid:uuid>/` | `unit_qr_code` | Public | PNG Image | Generate QR code unit |
| 42 | GET | `/public/unit/<uuid:uuid>/` | `unit_public_detail` | Public | HTML | Detail unit publik |
---
## 2. URL yang Ada di Views tapi TIDAK di URL Patterns
| View | Baris | Keterangan |
|---|---|---|
| `unit_delete` | L410 | View ada tapi tidak ada URL → fungsi tidak dapat diakses |
---
## 3. Query Parameters yang Digunakan
| URL | Parameter | Nilai | Efek |
|---|---|---|---|
| `/aset/` | `tab` | `karyawan` (default), `network` | Filter kategori aset |
| `/aset/` | `q` | string | Search kode/nama/merek |
| `/aset/export/` | `tab` | `karyawan`, `network` | Filter PDF export |
| `/aset/export-excel/` | `tab` | `karyawan`, `networking`, `all` | Filter Excel export |
| `/aset/export-excel/` | `q` | string | Search filter |
| `/aset/{id}/units/export-excel/` | `tab` | `semua`, `tersedia`, `digunakan`, `rusak` | Filter status unit |
| `/status-aset/` | `tab` | `tersedia` (default), `digunakan`, `rusak` | Filter status |
| `/status-aset/` | `cat` | `karyawan` (default), `network` | Filter kategori |
| `/status-aset/` | `q` | string | Search unit/aset/karyawan |
| `/distribusi/` | `tab` | `handover` (default), `mutation`, `return` | Filter tipe distribusi |
| `/distribusi/` | `q` | string | Search multi-field |
| `/distribusi/` | `sort` | `desc` (default), `asc` | Urutan tanggal |
| `/distribusi/export/` | `tab` | `handover`, `mutation`, `return` | Filter PDF export |
| `/karyawan/` | `q` | string | Search nama/NIK |
---
## 4. Response Pattern Views (HTMX/AJAX)
Beberapa views merespons secara berbeda berdasarkan header request:
```python
# Deteksi HTMX/AJAX request
if request.headers.get('Accept') == 'application/json' or
request.headers.get('x-requested-with') == 'XMLHttpRequest':
return JsonResponse({'status': 'success'}) # atau {'success': True/False, 'error': '...'}
```
Views yang menggunakan pattern ini:
- `asset_add` → `JsonResponse({'success': True/False, 'error': '...'})`
- `asset_edit` → `JsonResponse({'success': True/False, 'error': '...'})`
- `unit_add` → `JsonResponse({'status': 'success'/'error', 'message': '...'})`
- `unit_edit` → `JsonResponse({'status': 'success'/'error', 'message': '...'})`
- `employee_create` → `JsonResponse({'status': 'success'/'error', 'message': '...'})`
- `employee_edit` → `JsonResponse({'status': 'success'/'error', 'message': '...'})`
> [!NOTE]
> Tidak ada konsistensi format response JSON. `asset_add/edit` menggunakan `{'success': True}` sementara `unit_add/edit` dan `employee_*` menggunakan `{'status': 'success'}`.
---
## 5. File Upload Endpoints
| URL | Field | Tipe Diizinkan | Ukuran Maks | Simpan Di |
|---|---|---|---|---|
| `POST /distribusi/handover/` | `document` | Tidak dibatasi di sini | Tidak dibatasi di sini | `media/bast_documents/` |
| `POST /distribusi/mutation/` | `document` | Tidak dibatasi di sini | Tidak dibatasi di sini | `media/bast_documents/` |
| `POST /distribusi/return/` | `document` | Tidak dibatasi di sini | Tidak dibatasi di sini | `media/bast_documents/` |
| `POST /distribusi/{id}/upload/` | `document` | PDF, DOC, DOCX, JPG, JPEG, PNG | 5 MB | `media/bast_documents/` |
> [!WARNING]
> Upload dokumen saat distribusi (handover/mutation/return) **tidak divalidasi** tipe dan ukurannya. Hanya `distribusi_upload_doc` yang memiliki validasi. Ini adalah inkonsistensi — handover/mutation/return dapat menerima file apa saja.
---
## 6. Catatan Keamanan URL
| Temuan | URL | Detail |
|---|---|---|
| Tidak ada rate limiting | `/login/` | Brute force tidak dicegah |
| Tidak ada `@login_required` | `POST /aset/add/` | Siapapun dapat POST tambah aset |
| Open redirect check ada | `/login/?next=...` | `url_has_allowed_host_and_scheme` digunakan |
| Media files hanya tersedia di DEBUG | `MEDIA_URL` | `if settings.DEBUG: urlpatterns += static(...)` — production perlu konfigurasi webserver |
---
## 7. Handler Error
```python
# itam_core/urls.py L64
handler404 = 'assets.views.custom_404_view'
```
- Handler 404 custom menggunakan template `404.html`
- Handler 500 tidak dikustomisasi — menggunakan default Django
---
## 8. Django Admin
```python
# itam_core/urls.py L20 — DIKOMENTARI
# path('admin/', admin.site.urls), # Django Admin dinonaktifkan
```
- Django Admin **tidak dapat diakses** dari URL manapun
- Model tetap terdaftar di `admin.py` (Employee, Category, Asset, AssetUnit, AssetAssignment)
- Admin header dikustomisasi (L10-12 di urls.py):
- `site_header = "Administrasi IT All Role PT. KMH"`
- `site_title = "Admin Portal IT"`
- `index_title = "Manajemen Database Inti"`
> [!NOTE]
> Mengaktifkan kembali Django Admin memerlukan uncomment baris L20 di `urls.py`. Semua model sudah terdaftar dan siap digunakan.
+431
View File
@@ -0,0 +1,431 @@
# 07 — Security Audit Report
**Tanggal Analisis:** 26 Oktober 2026
**Tipe Audit:** Code-level Static Analysis — BUKAN penetration testing aktif
**Reviewer:** Automated via AI
**Confidence Level:** Analisis statis — temuan belum diverifikasi secara runtime
> [!CAUTION]
> Dokumen ini mengandung informasi kerentanan. Simpan dengan aman dan batasi distribusinya.
---
## Ringkasan Temuan
| Severity | Confirmed | Suspected | Not Verified | Total |
|---|---|---|---|---|
| Critical | 0 | 0 | 0 | 0 |
| High | 2 | 1 | 0 | 3 |
| Medium | 4 | 2 | 1 | 7 |
| Low | 5 | 1 | 0 | 6 |
| Informational | 4 | 0 | 0 | 4 |
| **Total** | **15** | **4** | **1** | **20** |
---
## CONFIRMED FINDINGS
---
### SEC-001 — Broken Access Control: `asset_add` Tanpa Autentikasi
**Severity:** High
**Confidence:** High
**Status:** Confirmed
**File:** `assets/views.py` L192-212
**URL:** `POST /aset/add/`
**Bukti teknis:**
```python
# L192 — tidak ada @login_required sebelum def
def asset_add(request):
if request.method == 'POST':
...
Asset.objects.create(...)
```
**Kondisi eksploitasi:** Siapapun yang mengetahui URL `POST /aset/add/` dengan payload yang benar dapat menambahkan data aset tanpa perlu login.
**Dampak:** Penyerang atau pengguna tidak sah dapat mengotori database dengan data sampah, menggunakan kode aset yang valid untuk keperluan jahat, atau mengganggu integritas data inventaris.
**Rekomendasi:**
```python
@login_required # Tambahkan ini
def asset_add(request):
```
---
### SEC-002 — Broken Feature: `unit_delete` Tidak Dapat Diakses
**Severity:** High (Integrity risk)
**Confidence:** High
**Status:** Confirmed
**File:** `assets/views.py` L410, `itam_core/urls.py`
**Bukti teknis:**
```python
# views.py L410 — view ada
@login_required
def unit_delete(request, unit_id):
...
# urls.py — URL TIDAK TERDAFTAR
# Tidak ada: path('unit/<int:unit_id>/delete/', unit_delete, name='unit_delete')
```
**Dampak:** Fungsi hapus unit tidak dapat digunakan sama sekali. Jika ada tombol atau link "hapus unit" di frontend, kliknya akan menghasilkan 404.
**Rekomendasi:** Tambahkan URL pattern atau hapus view jika tidak diperlukan.
---
### SEC-003 — Double Decorator Anomali pada `asset_export_excel`
**Severity:** Medium
**Confidence:** High
**Status:** Confirmed
**File:** `assets/views.py` L84-91
**Bukti teknis:**
```python
@login_required # L84 — dekorator kosong tanpa fungsi
# L85 — baris kosong
@login_required # L86 — dekorator untuk asset_export_excel
def asset_export_excel(request):
```
**Dampak:** Fungsi tetap terlindungi (karena ada `@login_required` di L86), tapi `@login_required` di L84 tidak memiliki fungsi yang didekorasi — ini adalah kode yang tidak valid secara semantik. Dapat menimbulkan kebingungan developer.
---
### SEC-004 — File Upload Tanpa Validasi pada Distribusi Awal
**Severity:** Medium
**Confidence:** High
**Status:** Confirmed
**File:** `assets/views.py` L584-596, L619-633, L659-672
**Bukti teknis:**
```python
def distribusi_handover(request):
...
document = request.FILES.get('document')
AssetAssignment.objects.create(
...
document=document # Tidak ada validasi tipe/ukuran!
)
```
**Kondisi eksploitasi:** Pengguna yang login dapat mengupload file jenis apapun (termasuk executable atau script) saat melakukan distribusi aset.
**Dampak:** Potensial untuk menyimpan file berbahaya di server. Tidak ada eksekusi otomatis, tapi file tersimpan di `media/bast_documents/`.
**Rekomendasi:** Terapkan validasi yang sama dengan `distribusi_upload_doc` (L696-702) ke semua distribusi views.
---
### SEC-005 — Tidak Ada Rate Limiting pada Login
**Severity:** Medium
**Confidence:** High
**Status:** Confirmed
**File:** `assets/views.py` L2442-2471
**Detail:** Tidak ada mekanisme pembatasan percobaan login (rate limiting, CAPTCHA, atau account lockout). Brute force attack terhadap akun admin tidak dicegah di level aplikasi.
**Rekomendasi:** Implementasikan `django-axes` atau custom rate limiting middleware.
---
### SEC-006 — Informasi Error Stacktrace di Response HTTP 500
**Severity:** Medium
**Confidence:** High
**Status:** Confirmed
**File:** `itam_core/settings.py` L30
**Detail:** `DEBUG = os.getenv('DJANGO_DEBUG', 'False').lower() in ('true', '1', 'yes')`. Jika `DJANGO_DEBUG=True` di production, Django akan menampilkan stacktrace penuh ke browser — mengekspos path file, konfigurasi, dan potensi informasi sensitif.
**Rekomendasi:** Pastikan `DJANGO_DEBUG=False` di environment production. Verifikasi dengan mengecek file `.env` di server.
---
### SEC-007 — File SQL Database di Repository
**Severity:** High
**Confidence:** High
**Status:** Confirmed
**File:** `database_lokal.sql`, `seed_karyawan.sql`
**Detail:** File SQL dump ada di root repository. `seed_karyawan.sql` kemungkinan berisi data karyawan (NIK, nama). File tidak dibuka untuk analisis.
**Dampak:** Jika repository bersifat publik (GitHub public), data karyawan terekspos. Bahkan jika private, tetap merupakan risiko jika ada yang mendapat akses ke repo.
**Rekomendasi:**
1. Pindahkan atau hapus file dari repository
2. Tambahkan ke `.gitignore`: `*.sql`, `database_lokal.sql`, `seed_karyawan.sql`
3. Jika sudah di git history, gunakan `git filter-repo` untuk membersihkan
---
### SEC-008 — Backup SQL via subprocess (Command Injection Risk)
**Severity:** Medium
**Confidence:** Medium
**Status:** Confirmed (implementasi ditemukan, exploitation condition perlu verifikasi)
**File:** `assets/views.py` L2551-2581
**Bukti teknis:**
```python
cmd = ['mysqldump', f'--user={db_user}', f'--host={db_host}',
f'--port={db_port}']
if db_pass:
cmd.append(f'--password={db_pass}')
cmd.append(db_name)
result = subprocess.run(cmd, ...)
```
**Detail:** Menggunakan list form (tidak string interpolation langsung) → command injection via `subprocess` sangat kecil kemungkinannya. NAMUN nilai `db_user`, `db_host`, `db_port`, `db_name` datang dari environment variables — jika env variables bisa dimanipulasi, ada risiko. Lebih besar risikonya: password database terekspos di command line (dapat terlihat oleh `ps aux`).
**Rekomendasi:** Gunakan `~/.my.cnf` atau `--defaults-file` untuk credentials, bukan command line arguments.
---
### SEC-009 — Django Admin Terdaftar tapi URL Dinonaktifkan
**Severity:** Low
**Confidence:** High
**Status:** Confirmed — Informational
**File:** `urls.py` L20, `admin.py`
**Detail:** Django Admin masih terdaftar di `INSTALLED_APPS` dan semua model sudah terdaftar di `admin.py`. URL dikomentari. Risiko: jika seseorang uncomment URL admin tanpa mengatur akses, admin panel menjadi tersedia.
**Rekomendasi:** Jika admin tidak digunakan, hapus registrasi di `admin.py` dan hapus dari `INSTALLED_APPS`. Jika akan digunakan, pastikan HTTPS dan pastikan hanya diakses dari IP terbatas.
---
### SEC-010 — Fallback Secret Key Tidak Aman
**Severity:** Low
**Confidence:** High
**Status:** Confirmed
**File:** `itam_core/settings.py` L27
**Bukti teknis:**
```python
SECRET_KEY = os.getenv('DJANGO_SECRET_KEY', 'django-insecure-dev-key-change-in-production')
```
**Detail:** Ada fallback secret key hardcoded. Jika environment variable `DJANGO_SECRET_KEY` tidak diset di production (lupa konfigurasi), aplikasi akan berjalan dengan key insecure yang sama di semua instance.
**Rekomendasi:** Ganti fallback dengan raise `ValueError` agar deployment gagal daripada berjalan dengan key tidak aman:
```python
SECRET_KEY = os.getenv('DJANGO_SECRET_KEY')
if not SECRET_KEY:
raise ValueError("DJANGO_SECRET_KEY environment variable tidak diset!")
```
---
### SEC-011 — `ALLOWED_HOSTS` Default Kosong
**Severity:** Low
**Confidence:** High
**Status:** Confirmed
**File:** `itam_core/settings.py` L32
**Bukti teknis:**
```python
ALLOWED_HOSTS = os.getenv('DJANGO_ALLOWED_HOSTS', '').split(',')
```
**Detail:** Jika `DJANGO_ALLOWED_HOSTS` tidak diset, `ALLOWED_HOSTS` akan menjadi `['']`. Pada Django dengan `DEBUG=False`, ini akan menyebabkan semua request ditolak. Dengan `DEBUG=True`, Django mengizinkan semua host.
**Rekomendasi:** Pastikan `DJANGO_ALLOWED_HOSTS` selalu diset di production `.env`.
---
### SEC-012 — Media Files Hanya Tersedia di DEBUG Mode
**Severity:** Low
**Confidence:** High
**Status:** Confirmed
**File:** `itam_core/urls.py` L60-61
**Bukti teknis:**
```python
if settings.DEBUG:
urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
```
**Detail:** Ini adalah behavior yang benar — di production, media files harus dilayani oleh webserver (Nginx/Apache). Tapi jika webserver tidak dikonfigurasi dengan benar, dokumen BAST yang diupload tidak akan bisa diakses.
**Rekomendasi:** Pastikan deployment guide mendokumentasikan konfigurasi Nginx/Apache untuk serve `media/` directory.
---
### SEC-013 — Nama File Download Mengandung User Input
**Severity:** Low
**Confidence:** Medium
**Status:** Confirmed
**File:** `assets/views.py` (multiple export views)
**Contoh:**
```python
# L2062
response['Content-Disposition'] = f'inline; filename="Laporan_Aset_{employee.name.replace(" ", "_")}_{now.strftime("%Y%m%d")}.pdf"'
```
**Detail:** `employee.name` berasal dari database — bukan langsung dari user input, tapi jika ada karakter khusus di nama, bisa berpotensi header injection. Risiko rendah karena nama diambil dari database yang sudah tervalidasi saat insert.
---
### SEC-014 — Password di Command Line untuk mysqldump
**Severity:** Medium
**Confidence:** High
**Status:** Confirmed
**File:** `assets/views.py` L2566
**Bukti teknis:**
```python
cmd.append(f'--password={db_pass}')
```
**Detail:** Password database terekspos sebagai argumen command line. Pada sistem Linux/Unix, argumen proses dapat dilihat oleh user lain via `ps aux` atau `/proc/[pid]/cmdline`.
**Rekomendasi:** Gunakan environment variable `MYSQL_PWD` atau `--defaults-file` pointing ke file konfigurasi MySQL yang dibatasi aksesnya.
---
### SEC-015 — Tidak Ada CORS Configuration
**Severity:** Informational
**Confidence:** High
**Status:** Confirmed — Not Applicable
**Detail:** Aplikasi tidak menggunakan CORS karena tidak ada REST API. Semua request adalah same-origin. Tidak diperlukan konfigurasi CORS.
---
## SUSPECTED FINDINGS (Perlu Verifikasi)
---
### SEC-016 — Potensial N+1 Query di Dashboard
**Severity:** Medium
**Confidence:** Medium
**Status:** Suspected
**File:** `assets/views.py` L17-42
**Detail:** Dashboard menggunakan beberapa query terpisah. Akses ke `log.unit.asset.name` dan `log.employee` dalam loop template bisa menghasilkan N+1 queries jika `select_related` tidak mencakup semua relasi.
---
### SEC-017 — `CSRF_TRUSTED_ORIGINS` Default Kosong
**Severity:** Medium
**Confidence:** Medium
**Status:** Suspected
**File:** `itam_core/settings.py` L162
**Bukti teknis:**
```python
CSRF_TRUSTED_ORIGINS = os.getenv('CSRF_TRUSTED_ORIGINS', '').split(',')
```
**Detail:** Jika tidak diset, aplikasi di balik reverse proxy mungkin menolak request POST karena CSRF validation. Aplikasi mungkin tidak berjalan dengan baik di production jika ini tidak dikonfigurasi.
---
### SEC-018 — Halaman Publik Unit Mengekspos Riwayat Internal
**Severity:** Low
**Confidence:** Medium
**Status:** Suspected (tergantung kebijakan bisnis)
**File:** `assets/views.py` L847-854, `templates/unit_public_detail.html`
**Detail:** `unit_public_detail` menampilkan UnitLog kepada siapapun yang punya UUID. UnitLog bisa mengandung nama karyawan (meski yang sudah dihapus dalam format tertentu) dan catatan internal. Apakah ini disengaja?
**Pertanyaan untuk stakeholder:** Apakah riwayat lengkap unit harus terlihat publik, atau cukup info dasar?
---
### SEC-019 — File Scratch di Repository Mengekspos Path Development
**Severity:** Low
**Confidence:** High
**Status:** Confirmed
**File:** `scratch_urls_all.py` L3
**Bukti teknis:**
```python
with open('c:/laragon/www/Manajemen-Aset-IT/itam_core/urls.py', 'r', ...) as f:
```
**Detail:** Mengekspos path lengkap development environment di Windows. Tidak berisiko secara langsung, tapi mengekspos struktur sistem developer.
**Rekomendasi:** Hapus file scratch dari repository.
---
## NOT VERIFIED
---
### SEC-020 — Dependency Vulnerabilities
**Severity:** Varies
**Confidence:** Low
**Status:** Not Verified
**Detail:** Beberapa dependensi memiliki versi spesifik di `requirements.txt`. Perlu dijalankan `pip audit` atau `safety check` untuk memverifikasi apakah ada CVE yang diketahui.
**Langkah verifikasi:**
```bash
pip install pip-audit
pip-audit -r requirements.txt
```
---
## Ringkasan Rekomendasi Priority
| Priority | Finding ID | Tindakan |
|---|---|---|
| P0 (Segera) | SEC-001 | Tambahkan `@login_required` ke `asset_add` |
| P0 (Segera) | SEC-007 | Hapus file SQL dari repository |
| P1 | SEC-004 | Validasi upload di semua distribusi views |
| P1 | SEC-005 | Implementasikan rate limiting login |
| P1 | SEC-008 | Gunakan `~/.my.cnf` untuk mysqldump credentials |
| P2 | SEC-010 | Hilangkan fallback secret key |
| P2 | SEC-014 | Pindah password dari command line |
| P3 | SEC-020 | Audit dependency vulnerabilities |
---
## Pernyataan Pembatasan
> Audit ini bersifat analisis statis berdasarkan source code. Tidak ada eksploitasi aktif, penetration testing terhadap server, atau pengujian runtime yang dilakukan. Temuan yang diberi label "Suspected" atau "Not Verified" memerlukan verifikasi tambahan sebelum dikonfirmasi sebagai kerentanan.
+173
View File
@@ -0,0 +1,173 @@
# 08 — Code Quality & Maintainability Audit
**Tanggal Analisis:** 26 Oktober 2026
**Sumber Bukti:** `assets/views.py` (3.056 baris), `assets/models.py`, `itam_core/settings.py`
**Status Verifikasi:** Terverifikasi via code inspection statis
---
## 1. Ringkasan Kualitas Kode & Maintainability
| Aspek | Penilaian | Tingkat Keparahan / Bukti |
|---|---|---|
| **Struktur Modularitas** | Rendah (God File / Monolith) | `views.py` memiliki 3.056 baris tanpa sub-modul |
| **Separation of Concerns** | Rendah | View memproses HTTP, query ORM rumit, validasi, PDF layouting ReportLab, dan styling Excel sekaligus |
| **Duplikasi Kode (DRY)** | Sangat Tinggi | Kode pembuatan dokumen ReportLab dan openpyxl disalin berulang kali |
| **Penanganan Error** | Kurang Konsisten | Banyak blok `try-except` yang menangkap `Exception` generik dan melakukan silent pass (`pass`) |
| **Type Annotations** | Tidak Ada | Tidak ditemukan type hinting (`typing`) di fungsi maupun model |
| **Pengujian Otomatis** | Kosong (0% Coverage) | `assets/tests.py` hanya 4 baris placeholder bawaan Django |
| **Logging Sistem** | Parsial | Konfigurasi logging ada di `settings.py`, tetapi logging terstruktur tidak dipakai di business logic |
| **Technical Debt** | Tinggi | Terakumulasi di penanganan data yang terhapus dan query yang berpotensi N+1 |
---
## 2. Temuan Kritis & Analisis Masalah
### CQ-01: Masalah "God File" pada `assets/views.py`
- **Lokasi:** `assets/views.py` (Baris 1 s/d 3056)
- **Tingkat Keparahan:** High
- **Deskripsi:** Seluruh fungsi tampilan (dashboard, aset, unit, distribusi, karyawan, generate QR, PDF export, Excel export, backup) ditempatkan dalam satu file tunggal berukuran >130 KB.
- **Dampak:**
1. Sangat rentan menimbulkan merge conflict saat dikerjakan oleh lebih dari satu developer.
2. Sulit melakukan penelusuran regresi atau isolasi unit testing.
3. Memperlambat proses review kode dan navigasi IDE.
- **Rekomendasi:** Pecah direktori `assets/views/` menjadi beberapa package:
- `views/dashboard.py`
- `views/asset.py` (Master Aset & Unit)
- `views/distribution.py` (Handover, Mutation, Return)
- `views/employee.py`
- `views/export_pdf.py` & `views/export_excel.py`
- `views/auth.py` & `views/backup.py`
---
### CQ-02: Duplikasi Kode Ekstrem pada Modul Pelaporan (ReportLab & openpyxl)
- **Lokasi:** `assets/views.py` (L857-2440 dan L2598-3056)
- **Tingkat Keparahan:** High
- **Bukti Teknis:**
Setiap view export PDF (misal `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`) menduplikasi:
1. Definisi palette warna:
```python
navy = HexColor('#002060')
alt_row = HexColor('#F8F9FC')
border_color = HexColor('#D0D5DD')
```
2. Kamus bulan bahasa Indonesia (`bulan_indo = {1: 'Januari', ...}`).
3. Logika pemuatan logo perusahaan (`kerinci_logo.png` & `it_all_role_logo.png`) serta kalkulasi aspect ratio ReportLab.
4. Header banner dan footer boilerplate.
Hal yang sama terjadi pada export Excel (`Workbook()`, styling font, warna fill, penataan cell border).
- **Dampak:** Perubahan kecil pada header laporan (misal pergantian logo atau perubahan format tanggal) harus diubah manual di 7-10 tempat terpisah.
- **Rekomendasi:** Ekstrak ke dalam utilitas terpusat: `assets/utils/pdf_reports.py` dan `assets/utils/excel_reports.py` yang menyediakan base canvas, header builder, dan style sheet standar.
---
### CQ-03: Desain Anti-Pattern dalam Penanganan Relasi Karyawan yang Dihapus
- **Lokasi:** `assets/views.py` (L784-800 dan L428-438)
- **Tingkat Keparahan:** Medium
- **Bukti Teknis:**
Ketika data karyawan dihapus pada `employee_delete`:
```python
logs = UnitLog.objects.filter(employee=employee)
for log in logs:
prefix = f"{employee.name} ({employee.nik})"
log.notes = f"{prefix} - {log.notes}" if log.notes else prefix
log.save()
employee.delete()
```
Kemudian pada `unit_history`, string tersebut dibedah kembali menggunakan Regular Expression:
```python
pattern = re.compile(r"^(.+?) \((.+?)\) - (.*)$")
for log in logs_qs:
if not log.employee and log.notes:
match = pattern.match(log.notes.strip())
if match:
name, nik, rest_of_notes = match.groups()
log.deleted_employee_name = name
log.notes = rest_of_notes.strip()
```
- **Dampak:**
1. Mekanisme sangat rapuh (*fragile*): jika nama karyawan mengandung tanda kurung atau strip ` - `, regex akan salah membaca atau gagal parsing.
2. Menjadikan kolom catatan teks bebas (`notes`) sebagai tempat penyimpanan metadata terstruktur.
- **Rekomendasi:** Terapkan **Soft Delete** pada model `Employee` (`is_active = models.BooleanField(default=True)` atau `deleted_at = models.DateTimeField(null=True)`). Jangan pernah melakukan hard delete pada master karyawan yang pernah memiliki jejak transaksi.
---
### CQ-04: Inkonsistensi Sinkronisasi Counter `Asset.qty`
- **Lokasi:** `assets/views.py` (L293-294, L416-417) vs `assets/models.py`
- **Tingkat Keparahan:** Medium
- **Bukti Teknis:**
Kolom `Asset.qty` diupdate secara manual saat penambahan unit fisik via `unit_add`:
```python
asset.qty = asset.units.count()
asset.save()
```
Namun, pada aksi edit unit, perubahan status massal, atau operasi database langsung, `asset.qty` tidak dijamin sinkron. Terdapat juga kolom `Asset.sum_qty` di model yang tidak pernah diupdate di alur manapun.
- **Dampak:** Nilai `qty` tersimpan bisa menyimpang (*out-of-sync*) dari jumlah record `AssetUnit` fisik yang sebenarnya.
- **Rekomendasi:** Hapus field redundan `sum_qty`. Untuk `qty`, gunakan property model `@property def total_units(self): return self.units.count()` atau gunakan Django ORM annotation (`annotate(total_units=Count('units'))`) secara konsisten.
---
### CQ-05: Ketiadaan Pagination pada Queryset Skala Besar
- **Lokasi:** `asset_list`, `status_aset_list`, `distribusi_list`, `employee_list`
- **Tingkat Keparahan:** Medium
- **Bukti Teknis:** Seluruh queryset langsung di-render ke HTML template tanpa `Paginator` (misalnya `Asset.objects.all().order_by(...)`).
- **Dampak:** Seiring bertambahnya aset, riwayat pergerakan unit, dan transaksi log hingga ribuan baris, konsumsi memori server dan waktu rendering browser akan melonjak (potensi browser hang dan request timeout).
- **Rekomendasi:** Gunakan `django.core.paginator.Paginator` dengan batas 25 atau 50 baris per halaman, dilengkapi kontrol pagination HTMX atau URL query `?page=X`.
---
### CQ-06: Duplikasi Logika Filter Kategori Berbasis String Matching
- **Lokasi:** `assets/views.py` (L19-20, L63-66, L72-73, L360, L450-454, L557-563)
- **Tingkat Keparahan:** Low
- **Bukti Teknis:**
Pemisahan aset karyawan vs infrastruktur jaringan dilakukan melalui matching nama teks kategori:
```python
is_network = 'Network' in unit.asset.category.name
# atau
assets.filter(category__name__icontains='Network')
```
- **Dampak:** Jika admin mengubah nama kategori di database dari `"Aset Network"` menjadi `"Infrastruktur Jaringan"`, seluruh filtering dashboard, distribusi, dan status aset akan rusak seketika.
- **Rekomendasi:** Tambahkan field slug atau tipe kategori terstruktur pada model `Category`, misalnya `Category.TYPE_CHOICES = (('employee', 'Aset Karyawan'), ('network', 'Aset Network'))`.
---
### CQ-07: In-Function Imports Berulang
- **Lokasi:** Di hampir semua fungsi export dan view sekunder pada `assets/views.py`
- **Tingkat Keparahan:** Low
- **Bukti Teknis:**
`import datetime`, `import re`, `from io import BytesIO`, `from reportlab...` diimpor di dalam body fungsi secara berulang-ulang di baris 87, 423, 471, 859, 1217, 1525, 1730, dst.
- **Dampak:** Melanggar standar PEP 8, mempersulit analisis ketergantungan statis modul, dan menurunkan keterbacaan kode.
- **Rekomendasi:** Pindahkan seluruh import ke bagian atas modul setelah pemecahan file.
---
## 3. Evaluasi Kualitas Arsitektural
```mermaid
graph TD
subgraph As_Is ["Kondisi As-Is (Monolithic)"]
V["assets/views.py (3.056 baris)"]
V --> Logic["Business Logic"]
V --> DB["ORM Queries"]
V --> PDF["ReportLab Layouting (~1.500 baris)"]
V --> XLS["openpyxl Styling (~600 baris)"]
V --> Reg["Regex Hack Parsing"]
end
subgraph To_Be ["Rekomendasi To-Be (Layered / Modular)"]
Routes["itam_core/urls.py"] --> Controllers["assets/views/ (Modular)"]
Controllers --> Services["assets/services/ (Business Logic)"]
Controllers --> Reports["assets/reports/ (PDF & Excel Builders)"]
Services --> Models["assets/models.py (Clean Domain)"]
Reports --> Models
end
```
---
## 4. Rangkuman Metrik Teknis
- **Total Baris Views:** 3.056 baris.
- **Rasio Duplikasi Estimasi:** ~40% (terkonsentrasi pada pembuatan layout tabel ReportLab dan styling cell openpyxl).
- **Kepatuhan PEP 8:** Rendah pada file `views.py` (baris kosong ganda dekorator, in-function imports, trailing spaces).
- **Test Coverage:** 0.00%.
+124
View File
@@ -0,0 +1,124 @@
# 09 — Test Strategy & Test Plan
**Tanggal Analisis:** 26 Oktober 2026
**Kondisi Eksisting:** 0% Automated Test (`assets/tests.py` hanya 4 baris template default)
**Status Verifikasi:** Terverifikasi via code audit statis
---
## 1. Analisis Kesenjangan Pengujian (Testing Gap Analysis)
Repository saat ini **sama sekali tidak memiliki pengujian otomatis (automated test)**.
Bukti langsung pada `assets/tests.py`:
```python
from django.test import TestCase
# Create your tests here.
```
Ketiadaan test suite ini menimbulkan risiko regresi yang sangat tinggi, terutama karena sistem mengelola:
1. Siklus hidup unit aset (status change logic).
2. Perubahan kode aset induk yang mentranslasikan suffix ke ratusan unit turunan (`Asset.save()`).
3. Transaksi distribusi serah terima, mutasi antar-karyawan, dan pengembalian unit.
4. Parsing riwayat penghapusan data karyawan berbasis Regular Expression.
---
## 2. Strategi Pengujian yang Direkomendasikan (Test Strategy)
Pengujian harus dibagi menjadi 3 piramida pengujian:
```
/ \
/ E2E \ (Playwright / Cypress untuk UI Flow Kritis)
/-------\
/ Integr- \ (View & Request-Response Tests, Transaction Rollback)
/ ation \
/-------------\
/ Unit Testing \ (Model validations, logic helpers, formatters, export builders)
/-----------------\
```
### 2.1 Framework dan Tools
- **Test Runner:** `pytest` + `pytest-django` (lebih ekspresif dan cepat dibanding default `unittest/TestCase`).
- **Mocking & Factory:** `factory_boy` untuk pembuatan data dummy model yang terisolasi tanpa bergantung pada fixture statis.
- **Coverage Tool:** `pytest-cov` dengan ambang batas target minimum 80% line coverage.
- **Database:** Gunakan database SQLite in-memory untuk eksekusi test cepat pada CI, atau MySQL test container khusus.
---
## 3. Matriks Test Case Prioritas Tinggi (Critical Test Cases)
Berikut daftar skenario pengujian yang **wajib dibuat sebelum memulai perubahan atau penambahan fitur**:
### 3.1 Modul Autentikasi & Kontrol Akses (Security & Auth)
| Test ID | Skenario Pengujian | Input / Kondisi | Ekspektasi Hasil |
|---|---|---|---|
| TC-AUTH-01 | Login pengguna valid | Username & password terdaftar | Status code 302 redirect ke `/`, session auth terisi |
| TC-AUTH-02 | Login dengan Email | Format email terdaftar di User | Berhasil login dan redirect ke dashboard |
| TC-AUTH-03 | Login kredensial salah | Password salah | Status 200, pesan error muncul di context |
| TC-AUTH-04 | Proteksi URL anonim | Mengakses `/aset/` tanpa login | Redirect 302 ke `/login/?next=/aset/` |
| TC-AUTH-05 | **Bug Verification: `asset_add`** | Mengirim POST ke `/aset/add/` tanpa session login | **Harus ditolak (401/302). Saat ini lolos (Bug SEC-001)!** |
| TC-AUTH-06 | Akses Backup Database | User biasa (bukan superuser) akses `/backup/` | Mengembalikan status 403 Forbidden |
| TC-AUTH-07 | Detail Publik QR Code | Mengakses `/public/unit/<uuid>/` tanpa login | Status 200 OK (Akses publik diizinkan) |
### 3.2 Modul Master Aset & Siklus Unit Fisik
| Test ID | Skenario Pengujian | Input / Kondisi | Ekspektasi Hasil |
|---|---|---|---|
| TC-AST-01 | Pembuatan jenis aset unik | Kode aset baru `"CCTV-EXT"` | Record tersimpan, status 200/JsonResponse success |
| TC-AST-02 | Validasi duplikasi kode aset | Kode aset yang sudah ada | Ditolak dengan pesan error validasi |
| TC-AST-03 | Pembuatan unit fisik | Suffix `"001"` pada aset `"CCTV-EXT"` | Terbentuk unit `"CCTV-EXT-001"` dengan status `"tersedia"`, `UnitLog` `"created"` otomatis tercipta |
| TC-AST-04 | Sinkronisasi perubahan kode aset induk | Ubah kode aset `"LAPTOP"` jadi `"NB"` | Seluruh unit turunan `"LAPTOP-001"` otomatis berubah menjadi `"NB-001"` via atomic transaction |
| TC-AST-05 | Resolusi benturan kode unit anak | Update kode induk yang unit tujuannya sudah ada | Penambahan counter otomatis `002`, `003` tanpa duplicate key error |
### 3.3 Modul Distribusi Aset (Handover, Mutasi, Return)
| Test ID | Skenario Pengujian | Input / Kondisi | Ekspektasi Hasil |
|---|---|---|---|
| TC-DIST-01 | Serah terima unit tersedia | Unit status `"tersedia"`, Karyawan A | Unit status menjadi `"digunakan"`, `assigned_to` = Karyawan A, `AssetAssignment` type `"handover"`, `UnitLog` `"assigned"` terbuat |
| TC-DIST-02 | Mutasi aset antar karyawan | Unit dipegang Karyawan A, dimutasi ke Karyawan B | Unit `assigned_to` berganti ke Karyawan B, `AssetAssignment` type `"mutation"` (from A to B), 2 baris `UnitLog` terbuat (returned & assigned) |
| TC-DIST-03 | Pengembalian unit ke gudang | Unit dipegang Karyawan B dikembalikan | Unit status kembali `"tersedia"`, `assigned_to` = `None`, `AssetAssignment` type `"return"`, `UnitLog` `"returned"` terbuat |
| TC-DIST-04 | Atomic Rollback saat gagal distribusi | Error di tengah proses penyimpanan | State database tidak berubah (unit tidak menggantung pada status yang salah) |
### 3.4 Modul Karyawan & Integritas Relasi
| Test ID | Skenario Pengujian | Input / Kondisi | Ekspektasi Hasil |
|---|---|---|---|
| TC-EMP-01 | Hapus karyawan yang memegang aset | Karyawan dengan `held_units.count() > 0` | Ditolak, karyawan tidak boleh terhapus |
| TC-EMP-02 | Hapus karyawan bebas tanggungan | Karyawan tanpa unit yang dipegang | Karyawan terhapus, log riwayat masa lalunya diperbarui dengan prefix teks nama & NIK |
| TC-EMP-03 | Validasi keunikan NIK | Input karyawan baru dengan NIK sama | Ditolak dengan response error NIK sudah terdaftar |
### 3.5 Modul Laporan & File Upload
| Test ID | Skenario Pengujian | Input / Kondisi | Ekspektasi Hasil |
|---|---|---|---|
| TC-DOC-01 | Validasi format file BAST | Upload file `.exe` atau `.sh` | Ditolak dengan pesan format tidak diizinkan |
| TC-DOC-02 | Validasi ukuran file BAST | Upload dokumen > 5MB | Ditolak dengan pesan ukuran maksimal 5MB |
| TC-REP-01 | Export PDF Aset | Request GET `/aset/export/?tab=karyawan` | Response `content_type='application/pdf'`, header attachment valid |
| TC-REP-02 | Export Excel Aset | Request GET `/aset/export-excel/` | Response `content_type='application/vnd.openxmlformats...'`, struktur spreadsheet valid |
---
## 4. Rencana Implementasi Test Suite (Test Execution Plan)
### Struktur Direktori Pengujian yang Disarankan:
```
assets/
└── tests/
├── __init__.py
├── factories.py # Factory boy definitions
├── test_auth.py # Login, logout, permission checks
├── test_models.py # Model constraints & save() methods
├── test_views_asset.py # CRUD Asset & AssetUnit
├── test_views_distribusi.py # Handover, mutation, return
├── test_views_employee.py # CRUD Employee & deletion guard
├── test_exports.py # PDF & Excel response headers
└── test_security.py # Vulnerability regression tests
```
---
## 5. Kriteria Penerimaan Pengujian (Acceptance Gate)
Sebelum kode hasil upgrade atau bug fixing di-deploy ke environment staging/production:
1. **Zero Failing Tests:** 100% test case lulus (`pytest` returncode 0).
2. **Security Regression Pass:** Tidak ada view yang bisa diakses anonim tanpa dekorator resmi.
3. **Migration Check:** Perintah `python manage.py makemigrations --check --dry-run` menyatakan tidak ada migrasi yang tertinggal.
4. **Flake8 / Linter Clean:** Kode baru mematuhi standar formatting tanpa unresolved lint errors.
+217
View File
@@ -0,0 +1,217 @@
# 10 — Deployment & Operational Runbook
**Tanggal Analisis:** 26 Oktober 2026
**Status Verifikasi:** Disusun berdasarkan bukti repository (`settings.py`, `package.json`, `manage.py`, `.env.example`, `scratch_urls_all.py`)
**Lingkungan Target Terdeteksi:** Windows Server / Linux Server, Laragon / Apache / Nginx, MySQL / MariaDB
---
## 1. Analisis Arsitektur Deployment Eksisting
Berdasarkan bukti di file repository:
1. **WSGI & ASGI Entry Point:**
- `itam_core/wsgi.py` (tersedia untuk WSGI Server seperti Gunicorn/uWSGI/mod_wsgi).
- `itam_core/asgi.py` (tersedia, namun saat ini tidak ada fitur asynchronous/websocket).
2. **Environment Path Clues:**
- File `scratch_urls_all.py` baris 3 menunjukkan path development awal: `c:/laragon/www/Manajemen-Aset-IT/...` (Environment Laragon berbasis Windows).
3. **Frontend Build Pipeline:**
- Proyek menggunakan Vite + TailwindCSS + PostCSS (`package.json`).
- File output CSS final dikompilasi ke `static/dist/style.css` (sudah di-commit di git).
- `django-vite` dan `WhiteNoise` dikonfigurasi di `settings.py` untuk menyajikan static files di mode production.
4. **Media Storage:**
- Direktori `media/bast_documents/` digunakan untuk menyimpan file BAST yang diunggah pengguna.
---
## 2. Kebutuhan Lingkungan & Dependensi Sistem (Prerequisites)
| Komponen | Spesifikasi Rekomendasi | Keterangan |
|---|---|---|
| **OS** | Linux (Ubuntu 22.04 LTS / Debian 12) atau Windows Server | Linux sangat direkomendasikan untuk stabilitas produksi |
| **Python** | Python 3.10 atau 3.11 | Wajib untuk kompatibilitas Django 5.2 |
| **Node.js** | Node.js v18.x atau v20.x + npm | Hanya diperlukan saat build aset CSS/JS |
| **Database** | MySQL 8.0+ atau MariaDB 10.6+ | Karakter set `utf8mb4` wajib aktif |
| **Utilitas Sistem** | `mysqldump` | Wajib ada di PATH sistem agar fitur backup SQL berjalan |
| **Web Server** | Nginx (Reverse Proxy) + Gunicorn | Menangani HTTPS termination & media serving |
---
## 3. Variabel Lingkungan (Environment Variables)
File `.env` wajib dibuat di root direktori dengan parameter berikut:
```ini
# ==========================================
# KONFIGURASI INTI DJANGO
# ==========================================
DJANGO_SECRET_KEY=isi-dengan-string-acak-panjang-dan-unik-50-karakter
DJANGO_DEBUG=False
DJANGO_ALLOWED_HOSTS=aset.ptkmh.co.id,localhost,127.0.0.1
CSRF_TRUSTED_ORIGINS=https://aset.ptkmh.co.id
# ==========================================
# KONFIGURASI DATABASE MYSQL
# ==========================================
DB_NAME=manajemen_aset_it
DB_USER=db_user_it
DB_PASSWORD=password_database_kuat
DB_HOST=127.0.0.1
DB_PORT=3306
# ==========================================
# KEAMANAN HTTPS (PRODUCTION)
# ==========================================
SECURE_SSL_REDIRECT=True
# ==========================================
# INISIALISASI SUPERUSER (Opsional, untuk setup awal)
# ==========================================
SUPERUSER_USERNAME=admin
SUPERUSER_EMAIL=[email protected]
SUPERUSER_PASSWORD=password_admin_sangat_rahasia
```
---
## 4. Prosedur Instalasi & Deployment Langkah-demi-Langkah
### Tahap 1: Persiapan Repository & Virtual Environment
```bash
# Masuk ke direktori aplikasi
cd /var/www/manajemen-aset-it
# Buat virtual environment Python
python3 -m venv venv
source venv/bin/activate
# Upgrade pip & install dependensi
pip install --upgrade pip
pip install -r requirements.txt
```
### Tahap 2: Build Frontend Assets (TailwindCSS)
```bash
# Instal node modules & build aset produksi
npm ci
npm run build
```
### Tahap 3: Konfigurasi Database & Migrasi
```bash
# Pastikan database telah dibuat di MySQL:
# CREATE DATABASE manajemen_aset_it CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
# Jalankan migrasi skema
python manage.py migrate
# Jalankan seeding kategori awal
python manage.py seed_initial_data
# Buat akun administrator (jika belum ada)
python manage.py setup_superuser
```
### Tahap 4: Pengumpulan Static Files
```bash
python manage.py collectstatic --noinput
```
---
## 5. Konfigurasi Layanan Produksi (Gunicorn + Nginx + Systemd)
### 5.1 Service Systemd Gunicorn (`/etc/systemd/system/itam.service`)
```ini
[Unit]
Description=Gunicorn daemon for IT Asset Management PT KMH
After=network.target
[Service]
User=www-data
Group=www-data
WorkingDirectory=/var/www/manajemen-aset-it
ExecStart=/var/www/manajemen-aset-it/venv/bin/gunicorn \
--access-logfile /var/log/gunicorn/itam_access.log \
--error-logfile /var/log/gunicorn/itam_error.log \
--workers 3 \
--bind unix:/run/itam.sock \
itam_core.wsgi:application
[Install]
WantedBy=multi-user.target
```
### 5.2 Konfigurasi Nginx Virtual Host (`/etc/nginx/sites-available/itam`)
```nginx
server {
listen 80;
server_name aset.ptkmh.co.id;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name aset.ptkmh.co.id;
ssl_certificate /etc/ssl/certs/ptkmh_ssl.crt;
ssl_certificate_key /etc/ssl/private/ptkmh_ssl.key;
client_max_body_size 10M;
# Static files dilayani langsung oleh Nginx (Cache efisien)
location /static/ {
alias /var/www/manajemen-aset-it/staticfiles/;
expires 30d;
add_header Cache-Control "public, no-transform";
}
# Media files (Dokumen BAST fisik & QR Code)
location /media/ {
alias /var/www/manajemen-aset-it/media/;
expires 7d;
add_header Cache-Control "private";
}
# Reverse proxy ke Gunicorn socket
location / {
include proxy_params;
proxy_pass http://unix:/run/itam.sock;
}
}
```
---
## 6. Prosedur Backup & Disaster Recovery
### 6.1 Prosedur Backup Otomatis Terjadwal (Cron Job)
Aplikasi memiliki fitur backup web di `/backup/`, namun untuk keandalan infrastruktur wajib disiapkan backup level sistem menggunakan cron job:
```bash
# Tambahkan ke crontab (setiap hari pukul 02:00 dini hari)
0 2 * * * /usr/bin/mysqldump -u db_user_it -p'password' manajemen_aset_it | gzip > /backup/db/itam_db_$(date +\%Y\%m\%d).sql.gz
# Backup folder media upload setiap minggu
0 3 * * 0 tar -czf /backup/media/itam_media_$(date +\%Y\%m\%d).tar.gz /var/www/manajemen-aset-it/media/
```
### 6.2 Prosedur Pemulihan (Restoration Runbook)
1. **Restore dari File SQL:**
```bash
gunzip < /backup/db/itam_db_20261026.sql.gz | mysql -u db_user_it -p manajemen_aset_it
```
2. **Restore dari File JSON Django (Fitur Bawaan Aplikasi):**
```bash
python manage.py loaddata backup_manajemen_aset_2026-10-26.json
```
---
## 7. Pemantauan & Logging Operasional
- **Application Error Log:** `error.log` di root direktori aplikasi (dikonfigurasi pada `settings.py` L165-190).
- **Web Server Logs:** `/var/log/nginx/access.log` dan `/var/log/nginx/error.log`.
- **Gunicorn Logs:** `/var/log/gunicorn/itam_error.log`.
> [!WARNING]
> File `error.log` di root folder aplikasi belum memiliki sistem *log rotation*. Pastikan dikonfigurasikan `logrotate` pada OS server agar ukuran log tidak memenuhi ruang disk.
+64
View File
@@ -0,0 +1,64 @@
# 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
```
+170
View File
@@ -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
```
+37
View File
@@ -0,0 +1,37 @@
# 13 — Open Questions & Stakeholder Clarifications
**Tanggal Analisis:** 26 Oktober 2026
**Status Verifikasi:** Pertanyaan teknis dan bisnis yang dirumuskan berdasarkan temuan kode tidak lengkap atau ambigu.
---
## 1. Domain Bisnis & Alur Pengelolaan Aset
| No | Pertanyaan untuk Stakeholder / Business Owner | Alasan Mengapa Informasi Ini Dibutuhkan | Keputusan Teknis/Bisnis yang Bergantung |
|---|---|---|---|
| **Q-BUS-01** | Apakah unit aset yang berstatus `"rusak"` (Maintenance) boleh diserahterimakan ke karyawan lain atau wajib dikembalikan ke status `"tersedia"` terlebih dahulu? | Saat ini di view `unit_edit`, admin dapat secara manual mengubah status dari `"rusak"` langsung menjadi `"digunakan"` ke karyawan baru tanpa validasi alur. | Pembuatan *State Machine* / validasi transisi status unit aset yang kaku pada backend. |
| **Q-BUS-02** | Apakah penghapusan unit aset fisik (`AssetUnit`) memang diizinkan dalam kebijakan operasional perusahaan? | Terdapat fungsi `unit_delete` di `views.py` namun rutenya tidak terdaftar di `urls.py`. | Apakah tombol hapus unit perlu diaktifkan, atau digantikan dengan status `"pensiun"` / `"disposed"`. |
| **Q-BUS-03** | Apakah ada perbedaan alur penugasan antara "Aset Karyawan" (laptop, mouse, monitor) dengan "Aset Network" (CCTV, switch, access point)? | Pada kode saat ini, dropdown distribusi hanya memfilter aset karyawan (`distribusi_list.html`), sedangkan penempatan aset network diatur terpisah melalui form `unit_update_status` (area dan lokasi). | Penyatuan atau pemisahan permanen alur mutasi perangkat infrastruktur jaringan dari perangkat individu karyawan. |
| **Q-BUS-04** | Apa maksud dan kegunaan kolom `sum_qty`, `price`, dan `total_price` pada model `Asset`? | Kolom-kolom ini ada di database sejak migrasi awal, tetapi tidak pernah ditampilkan atau diinput dalam antarmuka web saat ini. | Apakah perlu dibangun modul *Asset Financial Tracking & Valuation* (pembukuan harga perolehan), atau field ini sebaiknya di-drop agar skema lebih ringkas. |
| **Q-BUS-05** | Bagaimana kebijakan terkait dokumen fisik BAST? Apakah wajib diunggah sebelum aset diserahkan, atau boleh menyusul? | Pada `distribusi_handover`, field dokumen bersifat opsional (`blank=True, null=True`), dan disediakan view terpisah `distribusi_upload_doc`. | Menentukan apakah validasi form harus mewajibkan attachment dokumen atau tetap opsional. |
---
## 2. Kebutuhan Autentikasi & Hak Akses (User Roles)
| No | Pertanyaan untuk Stakeholder / Business Owner | Alasan Mengapa Informasi Ini Dibutuhkan | Keputusan Teknis/Bisnis yang Bergantung |
|---|---|---|---|
| **Q-SEC-01** | Berapa banyak orang yang akan mengoperasikan aplikasi ini, dan apa saja peran kerja mereka? | Saat ini aplikasi hanya memiliki satu level otorisasi: siapapun yang login dianggap sebagai Administrator penuh. | Perancangan skema Role-Based Access Control (RBAC): pemisahan antara Admin IT, Staff Teknisi Lapangan, dan Pimpinan/Auditor (View-Only). |
| **Q-SEC-02** | Mengapa antarmuka bawaan Django Admin (`/admin/`) dinonaktifkan di `urls.py`? | Konfigurasi `admin.site.site_header` sangat rapi diatur di `urls.py:10-12`, tetapi baris `path('admin/', ...)` dikomentari. | Menentukan apakah Django Admin ingin diaktifkan kembali sebagai emergency portal bagi superuser, atau memang dibuang permanen. |
| **Q-SEC-03** | Apakah informasi pada halaman publik QR Code (`/public/unit/<uuid>/`) aman dibaca oleh siapa saja tanpa login? | Siapapun yang men-scan QR code unit fisik dapat membaca riwayat seluruh mutasi karyawan dan status unit secara detail. | Apakah halaman publik perlu disederhanakan hanya menampilkan status "Milik PT KMH - Unit Aktif" tanpa membocorkan nama karyawan dan catatan internal. |
---
## 3. Infrastruktur & Operasional Server
| No | Pertanyaan untuk Tim Infrastruktur / DevOps | Alasan Mengapa Informasi Ini Dibutuhkan | Keputusan Teknis/Bisnis yang Bergantung |
|---|---|---|---|
| **Q-OPS-01** | Di lingkungan server mana aplikasi saat ini berjalan (atau akan dideploy)? (Windows Server vs Linux Ubuntu/Debian) | Terdapat dependensi font `arial.ttf` pada pembuatan stiker QR code (`PIL.ImageFont`) dan pemanggilan binary `mysqldump` pada fitur backup. | Penyiapan dependensi sistem operasi (paket `ttf-mscorefonts-installer` di Linux) dan konfigurasi environment path. |
| **Q-OPS-02** | Apakah server database MySQL saat ini sudah memiliki mekanisme scheduled backup otomatis di luar web aplikasi? | Fitur `/backup/` mengeksekusi `mysqldump` langsung dari request web HTTP, yang rentan timeout jika data database membesar. | Menonaktifkan backup via web untuk diganti dengan cron job sistem level OS yang jauh lebih stabil dan aman. |
| **Q-OPS-03** | Apakah file `database_lokal.sql` dan `seed_karyawan.sql` yang ada di root direktori berisi data riil operasional karyawan PT KMH? | File ini ter-commit di repository dan berpotensi melanggar privasi data jika repository diakses pihak luar. | Prosedur pembersihan commit history git (`git filter-repo`) dan penegasan kebijakan perlindungan data pribadi (PDP). |
| **Q-OPS-04** | Berapa kuota penyimpanan disk yang dialokasikan untuk folder `media/bast_documents/`? | Pengguna dapat mengunggah berkas BAST hingga batas 5MB per transaksi tanpa batasan kuota total. | Kebutuhan integrasi object storage (misal: MinIO / S3) jika penyimpanan server on-premise terbatas. |
+36
View File
@@ -0,0 +1,36 @@
# 14 — Traceability Matrix
**Tanggal Analisis:** 26 Oktober 2026
**Status Verifikasi:** Terverifikasi via cross-referencing file models, views, templates, dan urls.
---
## 1. Matriks Keterlacakan Komprehensif (End-to-End)
| Req ID | Deskripsi Kebutuhan | Feature ID | URL / Endpoint | View / Handler | Model Terkait | Aturan Permission | Cakupan Test Eksisting | Risiko & Technical Debt Terkait |
|---|---|---|---|---|---|---|---|---|
| **FR-AUTH-01** | Login pengguna berbasis kredensial | FEAT-001 | `/login/` (GET/POST) | `assets.views.login_view` | `django.contrib.auth.models.User` | Anonim / Public | ❌ 0% (Tidak ada test) | Brute-force risk (tanpa rate limiting) |
| **FR-AUTH-02** | Logout sesi pengguna | FEAT-002 | `/logout/` (POST) | `assets.views.logout_view` | `User`, `Session` | Login Required | ❌ 0% | - |
| **FR-AUTH-03** | Manajemen profil & password admin | FEAT-003, 004 | `/profil/` (GET/POST) | `assets.views.profile_view` | `User` | Login Required | ❌ 0% | Username clash exception handling |
| **FR-DASH-01** | Pemantauan metrik aset & log mutasi | FEAT-005, 006 | `/` (GET) | `assets.views.dashboard` | `AssetUnit`, `AssetAssignment` | Login Required | ❌ 0% | Potensi query N+1 pada recent log loops |
| **FR-ASSET-01** | Katalog master jenis aset (SKU level) | FEAT-007, 008 | `/aset/` (GET) | `assets.views.asset_list` | `Asset`, `Category` | Login Required | ❌ 0% | Ketiadaan pagination (`TD-009`) |
| **FR-ASSET-02** | Penambahan master jenis aset baru | FEAT-009 | `/aset/add/` (POST) | `assets.views.asset_add` | `Asset` | **❌ Anonim (Bug!)** | ❌ 0% | **`SEC-001` (Celah akses anonim)** |
| **FR-ASSET-03** | Perubahan data & kode master aset | FEAT-010 | `/aset/<id>/edit/` (POST) | `assets.views.asset_edit` | `Asset`, `AssetUnit` | Login Required | ❌ 0% | Konflik penomoran unit saat batch update |
| **FR-ASSET-04** | Penghapusan master aset (Cascade) | FEAT-011 | `/aset/<id>/delete/` (POST) | `assets.views.asset_delete` | `Asset`, `AssetUnit` | Login Required | ❌ 0% | Unit fisik terhapus cascade tanpa audit log |
| **FR-UNIT-01** | Pengelolaan unit fisik individual | FEAT-014 | `/aset/<id>/units/` (GET) | `assets.views.asset_units` | `AssetUnit`, `Employee` | Login Required | ❌ 0% | - |
| **FR-UNIT-02** | Registrasi unit fisik baru ber-suffix | FEAT-015 | `/aset/<id>/units/add/` (POST) | `assets.views.unit_add` | `AssetUnit`, `UnitLog` | Login Required | ❌ 0% | Inkonsistensi update `asset.qty` manual |
| **FR-UNIT-03** | Edit metadata & pemegang unit fisik | FEAT-016 | `/unit/<id>/edit/` (POST) | `assets.views.unit_edit` | `AssetUnit`, `UnitLog` | Login Required | ❌ 0% | Status assignment tidak tersinkronisasi |
| **FR-UNIT-04** | Penghapusan unit fisik individual | FEAT-017 | *(URL Missing!)* | `assets.views.unit_delete` | `AssetUnit` | Login Required | ❌ 0% | **`TD-002` (Fungsi tidak bisa diakses)** |
| **FR-UNIT-05** | Update status unit & lokasi network | FEAT-018 | `/unit/<id>/status/` (POST) | `assets.views.unit_update_status` | `AssetUnit`, `UnitLog` | Login Required | ❌ 0% | Hardcoded AREA choices |
| **FR-HIST-01** | Timeline riwayat perjalanan unit | FEAT-023 | `/unit/<id>/history/` (GET) | `assets.views.unit_history` | `UnitLog`, `Employee` | Login Required | ❌ 0% | Regex parsing nama employee (`TD-011`) |
| **FR-STAT-01** | Monitoring status aset (Tersedia/Pakai/Rusak) | FEAT-026, 027 | `/status-aset/` (GET) | `assets.views.status_aset_list` | `AssetUnit`, `Category` | Login Required | ❌ 0% | Filter string `Network` hardcoded |
| **FR-DIST-01** | Distribusi serah terima unit ke user | FEAT-031 | `/distribusi/handover/` (POST) | `assets.views.distribusi_handover` | `AssetAssignment`, `AssetUnit`, `UnitLog` | Login Required | ❌ 0% | Validasi file upload BAST nihil (`TD-006`) |
| **FR-DIST-02** | Mutasi kepemilikan aset antar user | FEAT-032 | `/distribusi/mutation/` (POST) | `assets.views.distribusi_mutation` | `AssetAssignment`, `AssetUnit`, `UnitLog` | Login Required | ❌ 0% | Validasi file upload BAST nihil (`TD-006`) |
| **FR-DIST-03** | Pengembalian unit aset ke gudang | FEAT-033 | `/distribusi/return/` (POST) | `assets.views.distribusi_return` | `AssetAssignment`, `AssetUnit`, `UnitLog` | Login Required | ❌ 0% | Kolom `returned_date` tidak terisi (`TD-008`) |
| **FR-DIST-04** | Susulan unggah berkas fisik BAST | FEAT-034 | `/distribusi/<id>/upload/` (POST) | `assets.views.distribusi_upload_doc` | `AssetAssignment` | Login Required | ❌ 0% | - |
| **FR-EMP-01** | Pengelolaan master data karyawan | FEAT-037..042 | `/karyawan/` (All Methods) | `assets.views.employee_*` | `Employee`, `AssetUnit` | Login Required | ❌ 0% | Ketiadaan soft delete pada master employee |
| **FR-QR-01** | Generate gambar stiker QR Code | FEAT-021 | `/qr/<uuid>/` (GET) | `assets.views.unit_qr_code` | `AssetUnit` | Anonim / Public | ❌ 0% | Dependensi font OS (`arial.ttf`) |
| **FR-QR-02** | Halaman publik info & histori unit | FEAT-022 | `/public/unit/<uuid>/` (GET) | `assets.views.unit_public_detail` | `AssetUnit`, `UnitLog` | Anonim / Public | ❌ 0% | Ekposur data histori internal ke publik |
| **FR-EXP-01** | Cetak Laporan PDF Seluruh Modul | FEAT-012, 019, 024, 028, 035, 043, 045 | `*/*/export/` (GET) | `assets.views.*_export_pdf` | Semua Model | Login Required | ❌ 0% | Duplikasi kode ReportLab ~1.500 baris |
| **FR-EXP-02** | Unduh Spreadsheet Excel Seluruh Modul | FEAT-013, 020, 025, 029, 036, 044, 046 | `*/*/export-excel/` (GET) | `assets.views.*_export_excel` | Semua Model | Login Required | ❌ 0% | Duplikasi kode openpyxl ~600 baris |
| **FR-OPS-01** | Pencadangan database (JSON / SQL) | FEAT-047, 048 | `/backup/` (GET/POST) | `assets.views.backup_database_view` | Seluruh DB | Superuser Only | ❌ 0% | Password terekspos di CLI `mysqldump` |
+47
View File
@@ -0,0 +1,47 @@
# 15 — Glossary & Domain Terminology
**Tanggal Analisis:** 26 Oktober 2026
**Status Verifikasi:** Istilah diekstraksi dari kode sumber, label template, dan model bisnis PT KMH.
---
## 1. Terminologi Domain Bisnis & Pengelolaan Aset (ITAM)
| Istilah | Definisi Konseptual | Konteks Penerapan dalam Aplikasi | Status Verifikasi |
|---|---|---|---|
| **Aset (SKU Level)** | Definisi tipe atau model perangkat keras/lunak secara umum tanpa nomor identitas fisik unik. Contoh: "Monitor Dell 24 inch", "Wireless Access Point Ruijie". | Direpresentasikan oleh model `Asset` di `assets/models.py:18`. Berisi informasi kode kelompok (`asset_code`), merek, dan kategori. | Terverifikasi |
| **Unit Aset (Unit Fisik)** | Perangkat fisik individual nyata yang memiliki serial number, stiker inventaris, atau kode pelacak mandiri. Satu jenis aset dapat memiliki puluhan unit fisik. | Direpresentasikan oleh model `AssetUnit` di `assets/models.py:84`. Memiliki `unit_code` unik (misal: `NB-001`, `NB-002`) dan status operasional. | Terverifikasi |
| **Kode Aset (`asset_code`)** | Pengidentifikasi unik untuk tipe/model aset induk, biasanya ditulis dalam format huruf kapital singkat. | Kolom `Asset.asset_code` (unique constraint aktif). Jika kode ini diubah, sistem otomatis memperbarui awalan seluruh kode unit di bawahnya. | Terverifikasi |
| **Kode Unit (`unit_code`)** | Pengidentifikasi unik untuk setiap unit fisik barang, terbentuk dari kombinasi kode aset induk dan suffix nomor urut (contoh: `PC-OFFICE-015`). | Kolom `AssetUnit.unit_code` (unique constraint aktif). Digunakan pada pencetakan label stiker dan pencarian cepat. | Terverifikasi |
| **Distribusi Aset** | Seluruh proses sirkulasi pemindahan fisik dan tanggung jawab pemeliharaan aset dari gudang IT ke pengguna, antar-pengguna, atau kembali ke gudang. | Dikelola melalui model `AssetAssignment` dan antarmuka `/distribusi/`. | Terverifikasi |
| **Serah Terima (*Handover*)** | Transaksi penyerahan unit aset yang berstatus `"tersedia"` dari gudang IT kepada seorang karyawan untuk keperluan kedinasan. | `AssetAssignment.TYPE_CHOICES = 'handover'`. Mengubah status unit menjadi `"digunakan"` dan menetapkan kolom `assigned_to`. | Terverifikasi |
| **Mutasi (*Mutation*)** | Transaksi pemindahan tanggung jawab pemegang unit aset dari karyawan lama (`from_employee`) langsung ke karyawan baru (`employee`). | `AssetAssignment.TYPE_CHOICES = 'mutation'`. Mencatat 2 jejak log riwayat sekaligus (pengembalian pemegang lama & serah terima pemegang baru). | Terverifikasi |
| **Pengembalian (*Return*)** | Transaksi pengembalian unit aset dari karyawan pemegang ke gudang IT karena selesai masa tugas, mutasi keluar, atau kerusakan unit. | `AssetAssignment.TYPE_CHOICES = 'return'`. Mengubah status unit kembali menjadi `"tersedia"` dan mengosongkan `assigned_to`. | Terverifikasi |
| **BAST (Berita Acara Serah Terima)** | Dokumen legal fisik/surat tanda terima penyerahan inventaris perusahaan yang ditandatangani kedua belah pihak. | Kolom `AssetAssignment.document`, disimpan pada direktori server `media/bast_documents/`. | Terverifikasi |
| **PIC (*Person in Charge*) / Pemegang** | Karyawan aktif yang tercatat secara sah sebagai penanggung jawab unit aset saat ini. | Foreign Key `AssetUnit.assigned_to` yang terhubung ke model `Employee`. | Terverifikasi |
| **Area Pemasangan** | Lokasi zona geografis penempatan perangkat infrastruktur jaringan pada fasilitas PLTA Kerinci Hydropower. | Pilihan statis pada `AssetUnit.AREA_CHOICES` (seperti: RW, DAM, Adit 1/2/3, Power House, Vertical Shaft). | Terverifikasi |
| **Lokasi Spesifik** | Keterangan detail letak fisik perangkat di dalam area tertentu (contoh: "Ruang Server Lt. 2 Rack A", "Pos Satpam Pintu 3"). | Kolom teks bebas `AssetUnit.location`. | Terverifikasi |
| **Status Unit: Tersedia** | Unit berada di ruang penyimpanan/gudang IT, dalam kondisi prima, dan siap diserahterimakan. | Nilai database `'tersedia'`. | Terverifikasi |
| **Status Unit: Digunakan** | Unit sedang aktif dipakai oleh karyawan tertentu atau terpasang aktif di area jaringan. | Nilai database `'digunakan'`. | Terverifikasi |
| **Status Unit: Rusak / Maintenance** | Unit mengalami kendala teknis dan sedang berada di lab IT/vendor untuk perbaikan. | Nilai database `'rusak'`, dengan display label antarmuka `'Diperbaiki'`. | Terverifikasi |
| **Status Unit: Dipensiunkan** | Unit telah melewati masa manfaat ekonomis/teknis, rusak permanen, atau dihapuskan dari pembukuan perusahaan (*disposed*). | Nilai database `'pensiun'`. | Terverifikasi |
| **Unit Log / Timeline** | Catatan buku besar (*audit trail ledger*) yang merekam setiap peristiwa perubahan status, mutasi, atau perbaikan pada unit sejak pertama kali didaftarkan. | Model `UnitLog`. Bersifat append-only dan diurutkan dari peristiwa paling baru (`-timestamp`). | Terverifikasi |
---
## 2. Terminologi Teknis Arsitektur & Rekayasa Perangkat Lunak
| Istilah | Definisi & Peran dalam Sistem |
|---|---|
| **Django Monolith** | Pola arsitektur di mana logika bisnis, routing, model data, dan antarmuka HTML digabungkan dalam satu repositori terpusat. |
| **HTMX** | Library JavaScript deklaratif yang memungkinkan pembaruan bagian halaman HTML secara dinamis via AJAX tanpa menulis JavaScript manual. |
| **TailwindCSS** | Framework CSS utility-first yang digunakan untuk styling modern, responsif, dan konsisten di seluruh antarmuka web. |
| **WhiteNoise** | Middleware Django yang mengoptimalkan penyajian file statis (CSS/JS/Gambar) secara langsung dari server aplikasi Python tanpa memberatkan WSGI server. |
| **ReportLab** | Library Python untuk mengonversi data dinamis menjadi dokumen PDF berstandar cetak dengan tata letak koordinat presisi. |
| **openpyxl** | Library Python untuk membaca dan menulis file spreadsheet format Microsoft Excel (.xlsx) dengan styling border dan warna sel. |
| **PyMySQL** | Driver Python murni untuk menghubungkan aplikasi Django ke database MySQL / MariaDB tanpa kompilasi native C extension. |
| **UUID (Universally Unique Identifier)** | 128-bit identifier acak yang digunakan pada `AssetUnit.id_uuid` agar URL publik tidak dapat ditebak secara berurutan (*anti-enumeration attack*). |
| **Atomic Transaction** | Blok eksekusi database di mana serangkaian operasi query harus berhasil seluruhnya; jika satu query gagal, seluruh operasi dibatalkan (*rollback*). Digunakan pada `@transaction.atomic` di alur distribusi. |
| **God File** | Anti-pattern di mana sebuah file modul menampung terlalu banyak tanggung jawab dan baris kode (`assets/views.py` dengan 3.056 baris). |
| **Soft Delete** | Pola penghapusan data di mana baris database tidak benar-benar dihapus (DELETE), melainkan hanya ditandai nonaktif melalui kolom flag boolean atau timestamp. |
| **RBAC (Role-Based Access Control)** | Mekanisme kontrol akses yang membatasi wewenang tindakan pengguna berdasarkan peran atau grup yang diberikan kepadanya. |
+105
View File
@@ -0,0 +1,105 @@
# 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)
```mermaid
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.
+63
View File
@@ -0,0 +1,63 @@
# Dokumentasi Analisis & Audit Rekayasa Sistem (IT Asset Management PT KMH)
Selamat datang di direktori dokumentasi resmi hasil *Reverse Engineering*, *System Audit*, dan *Technical Blueprint* untuk aplikasi **Sistem Informasi Manajemen Aset IT — PT. KMH (Kerinci Hydropower)**.
Dokumentasi ini disusun oleh AI Lead Software Architect & Technical Auditor pada **26 Oktober 2026** berdasarkan inspeksi kode sumber secara mendalam (*read-only static analysis*) tanpa mengubah state maupun kode aplikasi eksisting.
---
## 1. Panduan Urutan Membaca (Recommended Reading Order)
Untuk memahami aplikasi ini secara efektif, disarankan membaca dokumen dengan alur berikut sesuai dengan peran Anda:
### Alur Cepat untuk Stakeholder / Project Manager:
1. [`00-executive-summary.md`](00-executive-summary.md) — Ringkasan kondisi sistem, temuan kritis, dan status kesiapan.
2. [`02-prd-as-is.md`](02-prd-as-is.md) — Penjelasan fungsionalitas aplikasi apa adanya berdasarkan kode yang ada.
3. [`12-upgrade-roadmap.md`](12-upgrade-roadmap.md) — Rencana tahapan modernisasi dan peningkatan sistem.
4. [`13-open-questions.md`](13-open-questions.md) — Daftar pertanyaan bisnis yang butuh klarifikasi manajemen.
### Alur Lengkap untuk Technical Lead & Developer Pengembang:
1. [`00-executive-summary.md`](00-executive-summary.md) — Konteks umum dan temuan P0.
2. [`01-system-overview.md`](01-system-overview.md) — Arsitektur sistem, stack teknologi, dan alur request.
3. [`04-database-data-dictionary.md`](04-database-data-dictionary.md) — Kamus data, model ORM, dan Diagram Relasi ERD.
4. [`16-source-map.md`](16-source-map.md) — Peta lokasi file, tanggung jawab modul, dan zona rawan regresi.
5. [`03-feature-inventory.md`](03-feature-inventory.md) & [`06-api-documentation.md`](06-api-documentation.md) — Katalog fitur lengkap dan routing URL.
6. [`05-roles-permissions.md`](05-roles-permissions.md) — Alur autentikasi dan model otorisasi pengguna.
7. [`07-security-audit.md`](07-security-audit.md) — Laporan audit celah keamanan terkonfirmasi.
8. [`08-code-quality-audit.md`](08-code-quality-audit.md) & [`11-technical-debt.md`](11-technical-debt.md) — Daftar utang teknis dan anti-pattern.
9. [`09-test-strategy.md`](09-test-strategy.md) — Rencana pengujian otomatis (*testing gaps*).
10. [`10-deployment-operations.md`](10-deployment-operations.md) — Panduan instalasi dan operasional server.
11. [`14-traceability-matrix.md`](14-traceability-matrix.md) — Matriks penelusuran requirement ke baris kode.
12. [`15-glossary.md`](15-glossary.md) — Kamus istilah domain ITAM dan PLTA PT KMH.
---
## 2. Indeks Dokumen Terperinci
| No | File Dokumen | Judul Dokumen | Ruang Lingkup Utama |
|---|---|---|---|
| **00** | [`00-executive-summary.md`](00-executive-summary.md) | Executive Summary | Ringkasan kondisi repository, kekuatan, kelemahan, dan temuan kritis P0 |
| **01** | [`01-system-overview.md`](01-system-overview.md) | System Overview | Arsitektur Django monolith, diagram alur HTTP request, dan batasan sistem |
| **02** | [`02-prd-as-is.md`](02-prd-as-is.md) | PRD As-Is | Spesifikasi kebutuhan fungsional (FR) dan non-fungsional (NFR) eksisting |
| **03** | [`03-feature-inventory.md`](03-feature-inventory.md) | Feature Inventory | Katalog 49 fitur aplikasi beserta status implementasi dan risikonya |
| **04** | [`04-database-data-dictionary.md`](04-database-data-dictionary.md) | Database & Data Dictionary | Spesifikasi tabel, kolom, constraint, relasi ForeignKey, dan Diagram ERD Mermaid |
| **05** | [`05-roles-permissions.md`](05-roles-permissions.md) | Roles & Permissions | Mekanisme autentikasi login, ketiadaan RBAC, dan analisis kontrol akses |
| **06** | [`06-api-documentation.md`](06-api-documentation.md) | API & URL Catalog | Dokumentasi 42 pola URL, parameter query HTTP, dan tipe respon |
| **07** | [`07-security-audit.md`](07-security-audit.md) | Security Audit Report | Temuan kerentanan kode (*Broken Access Control*, *Insecure Upload*, dll.) |
| **08** | [`08-code-quality-audit.md`](08-code-quality-audit.md) | Code Quality Audit | Analisis masalah *God File* 3.056 baris, duplikasi kode ReportLab/openpyxl |
| **09** | [`09-test-strategy.md`](09-test-strategy.md) | Test Strategy & Plan | Analisis ketiadaan automated test (0%) dan rancangan prioritas test case |
| **10** | [`10-deployment-operations.md`](10-deployment-operations.md) | Deployment & Ops Runbook | Panduan instalasi Gunicorn, Nginx, Systemd, Backup/Restore, dan Environment |
| **11** | [`11-technical-debt.md`](11-technical-debt.md) | Technical Debt Register | Daftar terperinci 17 item utang teknis lengkap dengan effort dan prioritas |
| **12** | [`12-upgrade-roadmap.md`](12-upgrade-roadmap.md) | Modernization Roadmap | Rencana upgrade 4 fase (Fase 0 s/d Fase 3) dengan kriteria penerimaan dan rollback |
| **13** | [`13-open-questions.md`](13-open-questions.md) | Open Questions | Pertanyaan klarifikasi domain bisnis dan operasional untuk stakeholder |
| **14** | [`14-traceability-matrix.md`](14-traceability-matrix.md) | Traceability Matrix | Pemetaan keterlacakan requirement -> URL -> View -> Model -> Risiko |
| **15** | [`15-glossary.md`](15-glossary.md) | Glossary | Kamus istilah domain ITAM dan peristilahan teknis PLTA Kerinci |
| **16** | [`16-source-map.md`](16-source-map.md) | Source Code Map | Peta tanggung jawab file kode sumber dan identifikasi zona rawan regresi |
---
## 3. Komitmen Integritas Pemeriksaan
1. **Prinsip Read-Only:** Pemeriksaan ini dilakukan sepenuhnya dalam mode baca tanpa mengubah kode aplikasi (`assets/`, `itam_core/`, `templates/`, `static/`).
2. **Ketiadaan Data Rahasia:** Seluruh dokumen ini tidak memuat password, secret key produksi, NIK riil, atau data pribadi karyawan.
3. **Berbasis Bukti Nyata:** Seluruh klaim temuan diverifikasi langsung melalui nomor baris dan struktur kode sumber yang ada di dalam repository.