Files
nuexn0x-9 f28983011c feat: implement consumable inventory module, network LAN access, and CI/CD enhancements
- Modul Consumable Item: model master, buku besar transaksi (stock ledger), purchase unit conversion, stock opname, dan transaction reversal
- Integrasi ke Employee Management, Asset Unit, dan tiket/work order
- Konfigurasi akses jaringan lokal (LAN) via 0.0.0.0:8000, ALLOWED_HOSTS, dan CSRF_TRUSTED_ORIGINS otomatis
- Script pembuka firewall Windows (buka_firewall_lan.bat) dan menu interaktif run.bat
- Skema migrasi 0019_consumableitem_consumabletransaction
- Seeder 11 item consumable riil (seed_consumables.py)
- Test suite komprehensif (41 automated tests, 100% lulus)
- Pipeline CI/CD GitHub Actions (.github/workflows/ci.yml)
2026-10-27 09:42:15 +07:00

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:

  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)

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