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
+455
View File
@@ -0,0 +1,455 @@
import uuid
from django.db import models
class Employee(models.Model):
nik = models.CharField(max_length=20, unique=True, verbose_name="NIK")
name = models.CharField(max_length=150, verbose_name="Nama Karyawan")
position = models.CharField(max_length=100, blank=True, null=True, verbose_name="Jabatan")
is_active = models.BooleanField(default=True, verbose_name="Status Aktif")
def __str__(self):
return f"{self.nik} - {self.name}"
class Category(models.Model):
name = models.CharField(max_length=100, verbose_name="Kategori Aset")
def __str__(self):
return self.name
class Asset(models.Model):
"""Jenis/Tipe aset (SKU-level). Contoh: Wireless CCTV, Qty: 20"""
category = models.ForeignKey(Category, on_delete=models.SET_NULL, null=True, verbose_name="Kategori")
no_index = models.CharField(max_length=20, blank=True, null=True, verbose_name="No")
asset_code = models.CharField(max_length=50, unique=True, verbose_name="Kode Aset")
name = models.CharField(max_length=150, verbose_name="Nama Aset")
brand = models.CharField(max_length=100, blank=True, null=True, verbose_name="Merek")
qty = models.IntegerField(default=0, verbose_name="Jumlah (Qty)")
sum_qty = models.IntegerField(default=0, verbose_name="sumQty")
uom = models.CharField(max_length=50, blank=True, null=True, verbose_name="Satuan (UoM)")
price = models.DecimalField(max_digits=15, decimal_places=2, default=0, verbose_name="Harga Satuan")
total_price = models.DecimalField(max_digits=15, decimal_places=2, default=0, verbose_name="Total Harga")
serial_number = models.CharField(max_length=100, blank=True, null=True, verbose_name="Serial Number")
purchase_date = models.DateField(blank=True, null=True, verbose_name="Tanggal Pembelian")
notes = models.TextField(blank=True, null=True, verbose_name="Catatan")
def __str__(self):
return f"{self.asset_code} - {self.name}"
def save(self, *args, **kwargs):
is_new = self.pk is None
old_code = None
if not is_new:
old_obj = Asset.objects.filter(pk=self.pk).only('asset_code').first()
if old_obj and old_obj.asset_code != self.asset_code:
old_code = old_obj.asset_code
super().save(*args, **kwargs)
if old_code and old_code != self.asset_code:
from django.db import transaction
with transaction.atomic():
for unit in self.units.all():
if unit.unit_code.startswith(f"{old_code}-"):
suffix = unit.unit_code[len(f"{old_code}-"):]
elif '-' in unit.unit_code:
suffix = unit.unit_code.rsplit('-', 1)[-1]
else:
suffix = unit.unit_code
target_code = f"{self.asset_code}-{suffix}"
if AssetUnit.objects.filter(unit_code=target_code).exclude(pk=unit.pk).exists():
counter = 1
try:
base_num = int(suffix)
while AssetUnit.objects.filter(unit_code=target_code).exclude(pk=unit.pk).exists():
target_code = f"{self.asset_code}-{base_num + counter:03d}"
counter += 1
except ValueError:
while AssetUnit.objects.filter(unit_code=target_code).exclude(pk=unit.pk).exists():
target_code = f"{self.asset_code}-{suffix}-{counter}"
counter += 1
new_unit_code = target_code
if unit.unit_code != new_unit_code:
old_unit_code = unit.unit_code
unit.unit_code = new_unit_code
unit.save(update_fields=['unit_code'])
UnitLog.objects.create(
unit=unit,
action='other',
notes=f"Kode unit diperbarui otomatis dari {old_unit_code} ke {new_unit_code} karena perubahan kode aset induk."
)
class AssetUnit(models.Model):
"""Unit fisik individual dari sebuah jenis aset. Contoh: CCTV-001, CCTV-002"""
STATUS_CHOICES = [
('tersedia', 'Tersedia'),
('digunakan', 'Digunakan'),
('rusak', 'Diperbaiki'),
('pensiun', 'Dipensiunkan'),
]
AREA_CHOICES = [
('Regulating Weir (RW)', 'Regulating Weir (RW)'),
('Jakon', 'Jakon'),
('Beringin Tunggal (BT)', 'Beringin Tunggal (BT)'),
('DAM', 'DAM'),
('Adit 1', 'Adit 1'),
('Adit 2', 'Adit 2'),
('Adit 3', 'Adit 3'),
('Gudang Induk (GI)', 'Gudang Induk (GI)'),
('Vertical Shaft (VS)', 'Vertical Shaft (VS)'),
('Power House (PH)', 'Power House (PH)'),
('Lain-lainnya', 'Lain-lainnya'),
]
id_uuid = models.UUIDField(default=uuid.uuid4, editable=False, unique=True)
asset = models.ForeignKey(Asset, on_delete=models.CASCADE, related_name='units', verbose_name="Jenis Aset")
unit_code = models.CharField(max_length=60, unique=True, verbose_name="Kode Unit")
status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='tersedia', verbose_name="Status")
assigned_to = models.ForeignKey(Employee, on_delete=models.SET_NULL, null=True, blank=True, related_name='held_units', verbose_name="Pengguna Aset (PIC)")
area = models.CharField(max_length=50, choices=AREA_CHOICES, blank=True, null=True, verbose_name="Area Pemasangan")
location = models.CharField(max_length=255, blank=True, null=True, verbose_name="Lokasi Spesifik")
def __str__(self):
return self.unit_code
class UnitLog(models.Model):
"""Riwayat historis perjalanan unit aset (Timeline)"""
ACTION_CHOICES = [
('created', 'Ditambahkan ke Sistem'),
('assigned', 'Diserahkan kepada Karyawan'),
('returned', 'Dikembalikan'),
('maintenance_in', 'Masuk Perbaikan'),
('maintenance_out', 'Selesai Perbaikan'),
('mutation', 'Pindah User'),
('retired', 'Dipensiunkan'),
('other', 'Lain-lain'),
]
unit = models.ForeignKey(AssetUnit, on_delete=models.CASCADE, related_name='logs', verbose_name="Unit Aset")
timestamp = models.DateTimeField(auto_now_add=True, verbose_name="Waktu Kejadian")
action = models.CharField(max_length=20, choices=ACTION_CHOICES, verbose_name="Jenis Kejadian")
employee = models.ForeignKey(Employee, on_delete=models.SET_NULL, null=True, blank=True, verbose_name="Karyawan Terkait")
notes = models.TextField(blank=True, null=True, verbose_name="Catatan")
class Meta:
ordering = ['-timestamp']
def __str__(self):
return f"{self.unit.unit_code} - {self.get_action_display()}"
class AssetAssignment(models.Model):
"""Riwayat distribusi aset: serah terima, mutasi, dan pengembalian."""
TYPE_CHOICES = [
('handover', 'Serah Terima'),
('mutation', 'Mutasi'),
('return', 'Pengembalian'),
]
STATUS_CHOICES = [
('aktif', 'Aktif'),
('dikembalikan', 'Dikembalikan'),
]
type = models.CharField(max_length=20, choices=TYPE_CHOICES, default='handover', verbose_name="Tipe Distribusi")
unit = models.ForeignKey(AssetUnit, on_delete=models.PROTECT, verbose_name="Unit Aset")
employee = models.ForeignKey(Employee, on_delete=models.SET_NULL, null=True, blank=True, verbose_name="Karyawan Penerima", related_name='received_assignments')
from_employee = models.ForeignKey(Employee, on_delete=models.SET_NULL, null=True, blank=True, verbose_name="Karyawan Pengirim", related_name='sent_assignments')
assigned_date = models.DateField(verbose_name="Tanggal Transaksi")
returned_date = models.DateField(blank=True, null=True, verbose_name="Tanggal Dikembalikan")
document = models.FileField(upload_to='bast_documents/', blank=True, null=True, verbose_name="Dokumen Fisik")
status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='aktif', verbose_name="Status Penugasan")
notes = models.TextField(blank=True, null=True, verbose_name="Catatan Tambahan")
created_at = models.DateTimeField(auto_now_add=True, null=True, verbose_name="Waktu Dibuat")
def __str__(self):
return f"{self.get_type_display()} - {self.unit.unit_code} → {self.employee.name}"
class ConfigurationItem(models.Model):
"""Configuration Item (CI) - Komponen individual, peripheral, atau modul sistem
yang membentuk IT Asset atau dialokasikan langsung kepada pengguna.
"""
CATEGORY_CHOICES = [
('storage', 'Storage (SSD, HDD, NVMe)'),
('memory', 'Memory (RAM)'),
('processor', 'Processor (CPU)'),
('motherboard', 'Motherboard / Mainboard'),
('gpu', 'Graphic Card / GPU'),
('peripheral', 'Peripheral (Monitor, Keyboard, Mouse, Headset)'),
('network', 'Network Component (SFP, NIC, Adapter)'),
('power', 'Power Supply & UPS'),
('other', 'Komponen Lainnya'),
]
STATUS_CHOICES = [
('available', 'Tersedia di Gudang'),
('in_use', 'Sedang Digunakan'),
('under_inspection', 'Dalam Pemeriksaan'),
('under_repair', 'Dalam Perbaikan'),
('retired', 'Dipensiunkan'),
]
CONDITION_CHOICES = [
('new', 'Baru (New)'),
('good', 'Bagus / Normal (Good)'),
('fair', 'Cukup / Bekas (Fair)'),
('damaged', 'Rusak (Damaged)'),
]
ci_code = models.CharField(max_length=60, unique=True, verbose_name="Kode CI")
name = models.CharField(max_length=150, verbose_name="Nama Item / Komponen")
category = models.CharField(max_length=30, choices=CATEGORY_CHOICES, default='storage', verbose_name="Kategori")
brand = models.CharField(max_length=100, blank=True, null=True, verbose_name="Merek")
model_series = models.CharField(max_length=100, blank=True, null=True, verbose_name="Model / Seri")
serial_number = models.CharField(max_length=100, blank=True, null=True, verbose_name="Nomor Seri (S/N)")
specifications = models.TextField(blank=True, null=True, verbose_name="Spesifikasi Teknis")
status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='available', verbose_name="Status Operasional")
condition = models.CharField(max_length=20, choices=CONDITION_CHOICES, default='good', verbose_name="Kondisi Fisik")
# Relasi Pemasangan atau Alokasi
installed_on = models.ForeignKey(AssetUnit, on_delete=models.SET_NULL, null=True, blank=True, related_name='components', verbose_name="Terpasang Pada Perangkat")
assigned_to = models.ForeignKey(Employee, on_delete=models.SET_NULL, null=True, blank=True, related_name='held_cis', verbose_name="Dialokasikan Langsung ke Karyawan")
location = models.CharField(max_length=150, blank=True, null=True, verbose_name="Lokasi Penyimpanan")
purchase_date = models.DateField(blank=True, null=True, verbose_name="Tanggal Pembelian")
warranty_expiry = models.DateField(blank=True, null=True, verbose_name="Garansi Hingga")
price = models.DecimalField(max_digits=15, decimal_places=2, default=0, verbose_name="Harga Perolehan")
notes = models.TextField(blank=True, null=True, verbose_name="Catatan")
created_at = models.DateTimeField(auto_now_add=True, verbose_name="Waktu Ditambahkan")
updated_at = models.DateTimeField(auto_now=True, verbose_name="Waktu Diperbarui")
class Meta:
ordering = ['-created_at']
indexes = [
models.Index(fields=['ci_code']),
models.Index(fields=['status']),
models.Index(fields=['category']),
models.Index(fields=['serial_number']),
]
def __str__(self):
return f"{self.ci_code} - {self.name}"
@property
def current_relation_display(self):
"""Menampilkan target penggunaan aktif (perangkat atau karyawan)."""
if self.installed_on:
user_suffix = f" (PIC: {self.installed_on.assigned_to.name})" if self.installed_on.assigned_to else ""
return f"Terpasang: {self.installed_on.unit_code}{user_suffix}"
elif self.assigned_to:
return f"Dipegang: {self.assigned_to.name}"
elif self.status == 'available':
return self.location or "Gudang IT"
return self.get_status_display()
@property
def effective_user(self):
"""Karyawan pemegang efektif, baik langsung maupun melalui perangkat terpasang."""
if self.assigned_to:
return self.assigned_to
if self.installed_on and self.installed_on.assigned_to:
return self.installed_on.assigned_to
return None
class CIHistory(models.Model):
"""Riwayat historis perjalanan dan perubahan Configuration Item."""
ACTION_CHOICES = [
('created', 'Didaftarkan ke Sistem'),
('installed', 'Dipasang ke Perangkat'),
('removed', 'Dilepas dari Perangkat'),
('assigned', 'Dialokasikan ke Karyawan'),
('returned', 'Dikembalikan ke Gudang'),
('replaced', 'Digantikan (Replacement / Upgrade)'),
('repair_in', 'Masuk Perbaikan'),
('repair_out', 'Selesai Perbaikan'),
('status_change', 'Perubahan Status / Kondisi'),
('retired', 'Dipensiunkan'),
]
ci = models.ForeignKey(ConfigurationItem, on_delete=models.CASCADE, related_name='history', verbose_name="Configuration Item")
action = models.CharField(max_length=25, choices=ACTION_CHOICES, verbose_name="Jenis Aksi")
related_unit = models.ForeignKey(AssetUnit, on_delete=models.SET_NULL, null=True, blank=True, verbose_name="Perangkat Terkait")
related_employee = models.ForeignKey(Employee, on_delete=models.SET_NULL, null=True, blank=True, verbose_name="Karyawan Terkait")
performed_by = models.ForeignKey('auth.User', on_delete=models.SET_NULL, null=True, blank=True, verbose_name="Dilakukan Oleh")
timestamp = models.DateTimeField(auto_now_add=True, verbose_name="Waktu Peristiwa")
notes = models.TextField(blank=True, null=True, verbose_name="Catatan")
class Meta:
ordering = ['-timestamp']
def __str__(self):
return f"{self.ci.ci_code} - {self.get_action_display()} ({self.timestamp.strftime('%Y-%m-%d %H:%M')})"
class ConsumableItem(models.Model):
"""Master Barang Habis Pakai (Consumable Item) untuk IT Network & Technical Support.
Mendukung tracking kuantitas bulk, konversi satuan pembelian ke satuan dasar,
serta pengawasan batas stok minimum dan out-of-stock.
"""
CATEGORY_CHOICES = [
('cable', 'Kabel (UTP, Fiber Optic, HDMI, Patch Cord)'),
('connector', 'Konektor & Barrel (RJ45, Modular, Adapter)'),
('maintenance', 'Bahan Kimia & Perawatan (Thermal Paste, Contact Cleaner)'),
('fastener', 'Sekrup, Baut, Cable Ties & Mounting'),
('electrical', 'Kelistrikan & Isolasi (Isolasi Listrik, Heat Shrink)'),
('cleaning', 'Cleaning Supplies & Lap Microfiber'),
('tools_acc', 'Aksesori & Komponen Kecil Lainnya'),
]
item_code = models.CharField(max_length=50, unique=True, verbose_name="Kode Barang", db_index=True)
name = models.CharField(max_length=150, verbose_name="Nama Barang")
category = models.CharField(max_length=30, choices=CATEGORY_CHOICES, default='cable', verbose_name="Kategori")
brand = models.CharField(max_length=100, blank=True, null=True, verbose_name="Merek / Brand")
specification = models.CharField(max_length=255, blank=True, null=True, verbose_name="Spesifikasi")
description = models.TextField(blank=True, null=True, verbose_name="Deskripsi")
# Satuan & Konversi
base_unit = models.CharField(max_length=30, default='pcs', verbose_name="Satuan Dasar (UoM)")
purchase_unit = models.CharField(max_length=30, blank=True, null=True, verbose_name="Satuan Pembelian")
conversion_rate = models.DecimalField(
max_digits=10, decimal_places=2, default=1.00,
verbose_name="Faktor Konversi (1 Satuan Pembelian = X Satuan Dasar)"
)
# Persediaan
stock_available = models.DecimalField(max_digits=12, decimal_places=2, default=0.00, verbose_name="Stok Tersedia")
minimum_stock = models.DecimalField(max_digits=12, decimal_places=2, default=0.00, verbose_name="Batas Stok Minimum")
location = models.CharField(max_length=100, default='Gudang Induk (GI)', verbose_name="Lokasi Penyimpanan")
# Finansial & Pengadaan
last_purchase_price = models.DecimalField(max_digits=15, decimal_places=2, default=0, verbose_name="Harga Beli Terakhir")
notes = models.TextField(blank=True, null=True, verbose_name="Catatan")
created_at = models.DateTimeField(auto_now_add=True, verbose_name="Waktu Ditambahkan")
updated_at = models.DateTimeField(auto_now=True, verbose_name="Waktu Diperbarui")
class Meta:
ordering = ['name']
verbose_name = "Consumable Item"
verbose_name_plural = "Consumable Items"
indexes = [
models.Index(fields=['item_code']),
models.Index(fields=['category']),
models.Index(fields=['stock_available']),
models.Index(fields=['location']),
]
def __str__(self):
return f"{self.item_code} - {self.name}"
@property
def stock_status(self):
"""Menentukan status ketersediaan stok aktual."""
if self.stock_available <= 0:
return 'out_of_stock'
elif self.stock_available <= self.minimum_stock:
return 'low_stock'
return 'available'
@property
def stock_status_display(self):
status_labels = {
'out_of_stock': 'Habis',
'low_stock': 'Menipis',
'available': 'Tersedia',
}
return status_labels.get(self.stock_status, 'Tersedia')
@property
def formatted_stock(self):
"""Menampilkan kuantitas stok yang rapi tanpa trailing zero berlebih."""
val = self.stock_available
if val % 1 == 0:
val_str = f"{int(val):,}".replace(",", ".")
else:
val_str = f"{val:,.2f}".replace(",", "@").replace(".", ",").replace("@", ".")
return f"{val_str} {self.base_unit}"
@property
def formatted_minimum_stock(self):
val = self.minimum_stock
if val % 1 == 0:
val_str = f"{int(val):,}".replace(",", ".")
else:
val_str = f"{val:,.2f}".replace(",", "@").replace(".", ",").replace("@", ".")
return f"{val_str} {self.base_unit}"
class ConsumableTransaction(models.Model):
"""Buku Besar Transaksi Consumable (Stock Ledger) yang bersifat audit-proof / append-only.
Mencatat mutasi masuk, pemakaian teknisi, penyesuaian stock opname, dan pembalikan transaksi.
"""
TYPE_CHOICES = [
('in', 'Barang Masuk'),
('out', 'Barang Keluar (Pemakaian)'),
('adjustment', 'Penyesuaian (Stock Opname)'),
('reversal', 'Pembalikan Transaksi (Reversal)'),
]
transaction_code = models.CharField(max_length=60, unique=True, verbose_name="Kode Transaksi", db_index=True)
transaction_type = models.CharField(max_length=20, choices=TYPE_CHOICES, verbose_name="Jenis Transaksi")
item = models.ForeignKey(ConsumableItem, on_delete=models.PROTECT, related_name='transactions', verbose_name="Item Consumable")
# Kuantitas & Konversi
quantity = models.DecimalField(max_digits=12, decimal_places=2, verbose_name="Jumlah Transaksi")
unit = models.CharField(max_length=30, verbose_name="Satuan Transaksi")
conversion_rate = models.DecimalField(max_digits=10, decimal_places=2, default=1.00, verbose_name="Faktor Konversi ke Satuan Dasar")
quantity_base = models.DecimalField(max_digits=12, decimal_places=2, verbose_name="Jumlah Efektif (Satuan Dasar)")
# Snapshot Saldo (Audit Trail)
stock_before = models.DecimalField(max_digits=12, decimal_places=2, verbose_name="Saldo Sebelum")
stock_after = models.DecimalField(max_digits=12, decimal_places=2, verbose_name="Saldo Sesudah")
# Integrasi & Referensi
source_destination = models.CharField(max_length=150, blank=True, null=True, verbose_name="Sumber / Tujuan / Area Penggunaan")
recipient_employee = models.ForeignKey(
Employee, on_delete=models.SET_NULL, null=True, blank=True,
related_name='consumable_usages', verbose_name="Teknisi / Karyawan Penerima"
)
related_unit = models.ForeignKey(
AssetUnit, on_delete=models.SET_NULL, null=True, blank=True,
related_name='consumable_usages', verbose_name="Unit Aset Terkait"
)
ticket_number = models.CharField(max_length=100, blank=True, null=True, verbose_name="No. Tiket / Work Order")
supplier = models.CharField(max_length=150, blank=True, null=True, verbose_name="Vendor / Supplier")
reference_no = models.CharField(max_length=100, blank=True, null=True, verbose_name="No. Referensi (PO/BAST/Faktur)")
batch_lot = models.CharField(max_length=100, blank=True, null=True, verbose_name="Nomor Batch / Lot")
expiry_date = models.DateField(blank=True, null=True, verbose_name="Tanggal Kedaluwarsa")
# Aktor & Timestamp
performed_by = models.ForeignKey(
'auth.User', on_delete=models.SET_NULL, null=True, blank=True,
verbose_name="Dicatat Oleh"
)
transaction_date = models.DateField(verbose_name="Tanggal Transaksi")
created_at = models.DateTimeField(auto_now_add=True, verbose_name="Waktu Sistem")
notes = models.TextField(blank=True, null=True, verbose_name="Catatan")
# Reversal Mechanism
is_reversed = models.BooleanField(default=False, verbose_name="Telah Dibalik")
reversed_by = models.ForeignKey(
'self', on_delete=models.SET_NULL, null=True, blank=True,
related_name='reversal_target', verbose_name="Dibalik Oleh Transaksi"
)
class Meta:
ordering = ['-transaction_date', '-created_at', '-id']
verbose_name = "Transaksi Consumable"
verbose_name_plural = "Transaksi Consumable"
indexes = [
models.Index(fields=['transaction_code']),
models.Index(fields=['transaction_type']),
models.Index(fields=['transaction_date']),
models.Index(fields=['ticket_number']),
]
def __str__(self):
return f"{self.transaction_code} - {self.get_transaction_type_display()} ({self.item.name})"