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