- 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)
279 lines
12 KiB
Markdown
279 lines
12 KiB
Markdown
# 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
|