- 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)
12 KiB
12 KiB
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:
- Mencatat dan menginventarisasi aset IT yang dimiliki PT. KMH (peralatan karyawan dan infrastruktur jaringan/network)
- Mengelola distribusi aset — mencatat serah terima aset dari gudang ke karyawan, mutasi antar karyawan, dan pengembalian aset
- Memantau status fisik unit aset — tersedia, sedang digunakan, dalam perbaikan/maintenance, atau dipensiunkan
- Menyimpan riwayat historis setiap unit aset (audit trail) dari masuk sistem hingga pensiun
- Menghasilkan laporan dalam format PDF dan Excel untuk semua modul
- Menyediakan identifikasi unit via QR Code — setiap unit dapat di-scan untuk melihat informasi publiknya
- 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)
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.pytidak dianalisis secara mendalam (kode development) database_lokal.sqltidak dibuka untuk menjaga privasi data