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
+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