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:
@@ -0,0 +1,498 @@
|
||||
import re
|
||||
from datetime import datetime
|
||||
from django.shortcuts import render, redirect, get_object_or_404
|
||||
from django.contrib.auth.decorators import login_required
|
||||
from django.contrib import messages
|
||||
from django.http import JsonResponse
|
||||
from django.db import transaction
|
||||
from django.db.models import Count, Q
|
||||
from django.core.paginator import Paginator
|
||||
|
||||
from assets.models import ConfigurationItem, CIHistory, AssetUnit, Employee, UnitLog
|
||||
from assets.permissions import operator_required
|
||||
|
||||
|
||||
@login_required
|
||||
def ci_list(request):
|
||||
"""Menampilkan katalog Configuration Item (CI) dengan kartu ringkasan,
|
||||
filter kategori, status operasional, kondisi fisik, dan paginasi 25 baris.
|
||||
"""
|
||||
search_query = request.GET.get('q', '').strip()
|
||||
status_filter = request.GET.get('status', '').strip()
|
||||
category_filter = request.GET.get('category', '').strip()
|
||||
condition_filter = request.GET.get('condition', '').strip()
|
||||
|
||||
# Base queryset
|
||||
ci_qs = ConfigurationItem.objects.select_related(
|
||||
'installed_on', 'installed_on__asset', 'installed_on__assigned_to', 'assigned_to'
|
||||
)
|
||||
|
||||
# Ringkasan KPI operasional
|
||||
counts = {
|
||||
'total': ConfigurationItem.objects.count(),
|
||||
'in_use': ConfigurationItem.objects.filter(status='in_use').count(),
|
||||
'available': ConfigurationItem.objects.filter(status='available').count(),
|
||||
'under_repair': ConfigurationItem.objects.filter(status__in=['under_inspection', 'under_repair']).count(),
|
||||
'retired': ConfigurationItem.objects.filter(status='retired').count(),
|
||||
}
|
||||
|
||||
# Penerapan Filter
|
||||
if status_filter:
|
||||
if status_filter == 'repair':
|
||||
ci_qs = ci_qs.filter(status__in=['under_inspection', 'under_repair'])
|
||||
else:
|
||||
ci_qs = ci_qs.filter(status=status_filter)
|
||||
|
||||
if category_filter:
|
||||
ci_qs = ci_qs.filter(category=category_filter)
|
||||
|
||||
if condition_filter:
|
||||
ci_qs = ci_qs.filter(condition=condition_filter)
|
||||
|
||||
if search_query:
|
||||
ci_qs = ci_qs.filter(
|
||||
Q(ci_code__icontains=search_query) |
|
||||
Q(name__icontains=search_query) |
|
||||
Q(brand__icontains=search_query) |
|
||||
Q(model_series__icontains=search_query) |
|
||||
Q(serial_number__icontains=search_query) |
|
||||
Q(specifications__icontains=search_query) |
|
||||
Q(installed_on__unit_code__icontains=search_query) |
|
||||
Q(assigned_to__name__icontains=search_query)
|
||||
)
|
||||
|
||||
# Paginasi 25 item per halaman
|
||||
paginator = Paginator(ci_qs, 25)
|
||||
page_number = request.GET.get('page')
|
||||
page_obj = paginator.get_page(page_number)
|
||||
|
||||
# Master data untuk modal aksi
|
||||
available_units = AssetUnit.objects.select_related('asset', 'assigned_to').filter(
|
||||
status__in=['tersedia', 'digunakan']
|
||||
).order_by('unit_code')
|
||||
|
||||
available_employees = Employee.objects.filter(is_active=True).order_by('name')
|
||||
|
||||
# CI yang berstatus available untuk pilihan modal ganti/upgrade
|
||||
spare_cis = ConfigurationItem.objects.filter(status='available').order_by('name')
|
||||
|
||||
return render(request, 'ci_list.html', {
|
||||
'items': page_obj,
|
||||
'page_obj': page_obj,
|
||||
'counts': counts,
|
||||
'search_query': search_query,
|
||||
'status_filter': status_filter,
|
||||
'category_filter': category_filter,
|
||||
'condition_filter': condition_filter,
|
||||
'categories': ConfigurationItem.CATEGORY_CHOICES,
|
||||
'status_choices': ConfigurationItem.STATUS_CHOICES,
|
||||
'condition_choices': ConfigurationItem.CONDITION_CHOICES,
|
||||
'available_units': available_units,
|
||||
'available_employees': available_employees,
|
||||
'spare_cis': spare_cis,
|
||||
})
|
||||
|
||||
|
||||
@login_required
|
||||
def ci_detail(request, ci_id):
|
||||
"""Menampilkan informasi komprehensif suatu CI: spesifikasi, relasi aktif,
|
||||
dan timeline riwayat siklus hidup (audit trail).
|
||||
"""
|
||||
ci = get_object_or_404(
|
||||
ConfigurationItem.objects.select_related(
|
||||
'installed_on', 'installed_on__asset', 'installed_on__assigned_to', 'assigned_to'
|
||||
),
|
||||
id=ci_id
|
||||
)
|
||||
|
||||
history_logs = ci.history.select_related(
|
||||
'related_unit', 'related_unit__asset', 'related_employee', 'performed_by'
|
||||
).all()
|
||||
|
||||
return render(request, 'ci_detail.html', {
|
||||
'ci': ci,
|
||||
'history_logs': history_logs,
|
||||
})
|
||||
|
||||
|
||||
@login_required
|
||||
@operator_required
|
||||
def ci_create(request):
|
||||
"""Menambahkan Configuration Item baru ke dalam sistem."""
|
||||
if request.method == 'POST':
|
||||
ci_code = request.POST.get('ci_code', '').strip().upper()
|
||||
name = request.POST.get('name', '').strip()
|
||||
category = request.POST.get('category', 'storage')
|
||||
brand = request.POST.get('brand', '').strip()
|
||||
model_series = request.POST.get('model_series', '').strip()
|
||||
serial_number = request.POST.get('serial_number', '').strip()
|
||||
specifications = request.POST.get('specifications', '').strip()
|
||||
condition = request.POST.get('condition', 'new')
|
||||
status = request.POST.get('status', 'available')
|
||||
location = request.POST.get('location', '').strip() or "Gudang IT"
|
||||
purchase_date = request.POST.get('purchase_date') or None
|
||||
warranty_expiry = request.POST.get('warranty_expiry') or None
|
||||
price = request.POST.get('price') or 0
|
||||
notes = request.POST.get('notes', '').strip()
|
||||
|
||||
# Auto-generate CI code jika tidak diisi
|
||||
if not ci_code:
|
||||
prefix_map = {
|
||||
'storage': 'CI-STR',
|
||||
'memory': 'CI-MEM',
|
||||
'processor': 'CI-CPU',
|
||||
'motherboard': 'CI-MB',
|
||||
'gpu': 'CI-GPU',
|
||||
'peripheral': 'CI-PER',
|
||||
'network': 'CI-NET',
|
||||
'power': 'CI-PWR',
|
||||
'other': 'CI-GEN',
|
||||
}
|
||||
prefix = prefix_map.get(category, 'CI-IT')
|
||||
last_item = ConfigurationItem.objects.filter(ci_code__startswith=f"{prefix}-").order_by('-id').first()
|
||||
counter = 1
|
||||
if last_item:
|
||||
match = re.search(r'-(\d+)$', last_item.ci_code)
|
||||
if match:
|
||||
counter = int(match.group(1)) + 1
|
||||
ci_code = f"{prefix}-{counter:03d}"
|
||||
|
||||
# Validasi keunikan CI code
|
||||
if ConfigurationItem.objects.filter(ci_code=ci_code).exists():
|
||||
msg = f'Kode CI "{ci_code}" sudah terdaftar di sistem!'
|
||||
if request.headers.get('Accept') == 'application/json' or request.headers.get('x-requested-with') == 'XMLHttpRequest':
|
||||
return JsonResponse({'status': 'error', 'message': msg}, status=400)
|
||||
messages.error(request, msg)
|
||||
return redirect('ci_list')
|
||||
|
||||
ci = ConfigurationItem.objects.create(
|
||||
ci_code=ci_code,
|
||||
name=name,
|
||||
category=category,
|
||||
brand=brand,
|
||||
model_series=model_series,
|
||||
serial_number=serial_number,
|
||||
specifications=specifications,
|
||||
condition=condition,
|
||||
status=status,
|
||||
location=location,
|
||||
purchase_date=purchase_date,
|
||||
warranty_expiry=warranty_expiry,
|
||||
price=price,
|
||||
notes=notes
|
||||
)
|
||||
|
||||
CIHistory.objects.create(
|
||||
ci=ci,
|
||||
action='created',
|
||||
performed_by=request.user,
|
||||
notes=f"Didaftarkan ke sistem dengan status {ci.get_status_display()}, kondisi {ci.get_condition_display()} di {location}."
|
||||
)
|
||||
|
||||
messages.success(request, f'Configuration Item "{ci.ci_code} - {ci.name}" berhasil ditambahkan.')
|
||||
if request.headers.get('Accept') == 'application/json' or request.headers.get('x-requested-with') == 'XMLHttpRequest':
|
||||
return JsonResponse({'status': 'success', 'ci_id': ci.id})
|
||||
|
||||
return redirect('ci_list')
|
||||
|
||||
|
||||
@login_required
|
||||
@operator_required
|
||||
def ci_edit(request, ci_id):
|
||||
"""Memperbarui informasi metadata dan spesifikasi Configuration Item."""
|
||||
ci = get_object_or_404(ConfigurationItem, id=ci_id)
|
||||
|
||||
if request.method == 'POST':
|
||||
name = request.POST.get('name', '').strip()
|
||||
brand = request.POST.get('brand', '').strip()
|
||||
model_series = request.POST.get('model_series', '').strip()
|
||||
serial_number = request.POST.get('serial_number', '').strip()
|
||||
specifications = request.POST.get('specifications', '').strip()
|
||||
condition = request.POST.get('condition', ci.condition)
|
||||
location = request.POST.get('location', ci.location)
|
||||
warranty_expiry = request.POST.get('warranty_expiry') or None
|
||||
notes = request.POST.get('notes', '').strip()
|
||||
|
||||
old_condition = ci.condition
|
||||
ci.name = name
|
||||
ci.brand = brand
|
||||
ci.model_series = model_series
|
||||
ci.serial_number = serial_number
|
||||
ci.specifications = specifications
|
||||
ci.condition = condition
|
||||
ci.location = location
|
||||
ci.warranty_expiry = warranty_expiry
|
||||
ci.notes = notes
|
||||
ci.save()
|
||||
|
||||
if old_condition != condition:
|
||||
CIHistory.objects.create(
|
||||
ci=ci,
|
||||
action='status_change',
|
||||
performed_by=request.user,
|
||||
notes=f"Kondisi fisik diperbarui dari {dict(ConfigurationItem.CONDITION_CHOICES).get(old_condition)} ke {ci.get_condition_display()}."
|
||||
)
|
||||
|
||||
messages.success(request, f'Perubahan pada {ci.ci_code} berhasil disimpan.')
|
||||
if request.headers.get('Accept') == 'application/json' or request.headers.get('x-requested-with') == 'XMLHttpRequest':
|
||||
return JsonResponse({'status': 'success'})
|
||||
|
||||
return redirect('ci_detail', ci_id=ci.id)
|
||||
|
||||
|
||||
@login_required
|
||||
@operator_required
|
||||
def ci_assign(request, ci_id):
|
||||
"""Alur 'Gunakan Untuk' (Assignment): Memasang komponen ke perangkat utama (AssetUnit)
|
||||
atau mengalokasikannya langsung ke Karyawan secara transaksional.
|
||||
"""
|
||||
ci = get_object_or_404(ConfigurationItem, id=ci_id)
|
||||
|
||||
if request.method == 'POST':
|
||||
usage_type = request.POST.get('usage_type') # 'asset' atau 'employee'
|
||||
target_id = request.POST.get('target_id')
|
||||
notes = request.POST.get('notes', '').strip()
|
||||
|
||||
if ci.status == 'in_use':
|
||||
messages.error(request, f'Komponen {ci.ci_code} sedang digunakan. Lepas terlebih dahulu sebelum dialokasikan.')
|
||||
return redirect('ci_list')
|
||||
|
||||
if ci.status == 'retired':
|
||||
messages.error(request, f'Komponen {ci.ci_code} sudah dipensiunkan.')
|
||||
return redirect('ci_list')
|
||||
|
||||
with transaction.atomic():
|
||||
if usage_type == 'asset':
|
||||
unit = get_object_or_404(AssetUnit, id=target_id)
|
||||
ci.installed_on = unit
|
||||
ci.assigned_to = None
|
||||
ci.status = 'in_use'
|
||||
ci.location = None
|
||||
ci.save()
|
||||
|
||||
pic_info = f" (Pengguna: {unit.assigned_to.name})" if unit.assigned_to else ""
|
||||
log_text = f"Dipasang pada perangkat {unit.unit_code} ({unit.asset.name}){pic_info}. {notes}".strip()
|
||||
|
||||
CIHistory.objects.create(
|
||||
ci=ci,
|
||||
action='installed',
|
||||
related_unit=unit,
|
||||
related_employee=unit.assigned_to,
|
||||
performed_by=request.user,
|
||||
notes=log_text
|
||||
)
|
||||
|
||||
# Rekam juga di UnitLog perangkat induk
|
||||
UnitLog.objects.create(
|
||||
unit=unit,
|
||||
action='other',
|
||||
employee=unit.assigned_to,
|
||||
notes=f"Pemasangan komponen CI: {ci.name} ({ci.ci_code}). {notes}".strip()
|
||||
)
|
||||
|
||||
messages.success(request, f'{ci.name} berhasil dipasang pada perangkat {unit.unit_code}.')
|
||||
|
||||
elif usage_type == 'employee':
|
||||
employee = get_object_or_404(Employee, id=target_id, is_active=True)
|
||||
ci.assigned_to = employee
|
||||
ci.installed_on = None
|
||||
ci.status = 'in_use'
|
||||
ci.location = None
|
||||
ci.save()
|
||||
|
||||
log_text = f"Dialokasikan langsung kepada karyawan {employee.name} ({employee.nik}). {notes}".strip()
|
||||
|
||||
CIHistory.objects.create(
|
||||
ci=ci,
|
||||
action='assigned',
|
||||
related_employee=employee,
|
||||
performed_by=request.user,
|
||||
notes=log_text
|
||||
)
|
||||
|
||||
messages.success(request, f'{ci.name} berhasil dialokasikan kepada {employee.name}.')
|
||||
|
||||
if request.headers.get('Accept') == 'application/json' or request.headers.get('x-requested-with') == 'XMLHttpRequest':
|
||||
return JsonResponse({'status': 'success'})
|
||||
|
||||
return redirect('ci_list')
|
||||
|
||||
|
||||
@login_required
|
||||
@operator_required
|
||||
def ci_remove(request, ci_id):
|
||||
"""Alur 'Lepas dari Perangkat / Pengguna': Memutus relasi aktif dan mengembalikan
|
||||
komponen ke gudang, pemeriksaan, atau perbaikan secara transaksional.
|
||||
"""
|
||||
ci = get_object_or_404(ConfigurationItem, id=ci_id)
|
||||
|
||||
if request.method == 'POST':
|
||||
new_status = request.POST.get('new_status', 'available') # available, under_inspection, under_repair
|
||||
new_condition = request.POST.get('new_condition', ci.condition)
|
||||
location = request.POST.get('location', '').strip() or "Gudang IT"
|
||||
notes = request.POST.get('notes', '').strip()
|
||||
|
||||
old_unit = ci.installed_on
|
||||
old_emp = ci.assigned_to
|
||||
|
||||
with transaction.atomic():
|
||||
ci.installed_on = None
|
||||
ci.assigned_to = None
|
||||
ci.status = new_status
|
||||
ci.condition = new_condition
|
||||
ci.location = location
|
||||
ci.save()
|
||||
|
||||
from_desc = ""
|
||||
if old_unit:
|
||||
from_desc = f"perangkat {old_unit.unit_code}"
|
||||
elif old_emp:
|
||||
from_desc = f"karyawan {old_emp.name}"
|
||||
|
||||
log_text = f"Dilepas dari {from_desc}. Status kini {ci.get_status_display()}, kondisi {ci.get_condition_display()} di {location}. {notes}".strip()
|
||||
|
||||
CIHistory.objects.create(
|
||||
ci=ci,
|
||||
action='removed',
|
||||
related_unit=old_unit,
|
||||
related_employee=old_emp,
|
||||
performed_by=request.user,
|
||||
notes=log_text
|
||||
)
|
||||
|
||||
# Jika dilepas dari unit perangkat fisik, rekam di UnitLog
|
||||
if old_unit:
|
||||
UnitLog.objects.create(
|
||||
unit=old_unit,
|
||||
action='other',
|
||||
employee=old_unit.assigned_to,
|
||||
notes=f"Pelepasan komponen CI: {ci.name} ({ci.ci_code}). {notes}".strip()
|
||||
)
|
||||
|
||||
messages.success(request, f'{ci.name} berhasil dilepas dan status diperbarui ke {ci.get_status_display()}.')
|
||||
if request.headers.get('Accept') == 'application/json' or request.headers.get('x-requested-with') == 'XMLHttpRequest':
|
||||
return JsonResponse({'status': 'success'})
|
||||
|
||||
return redirect('ci_list')
|
||||
|
||||
|
||||
@login_required
|
||||
@operator_required
|
||||
def ci_replace(request, ci_id):
|
||||
"""Alur 'Ganti / Upgrade Komponen': Menggantikan komponen lama yang terpasang pada
|
||||
suatu perangkat dengan komponen baru/cadangan dalam satu transaksi atomik.
|
||||
"""
|
||||
old_ci = get_object_or_404(ConfigurationItem, id=ci_id)
|
||||
|
||||
if request.method == 'POST':
|
||||
replacement_ci_id = request.POST.get('replacement_ci_id')
|
||||
reason = request.POST.get('reason', 'Replacement Kerusakan')
|
||||
old_ci_status = request.POST.get('old_ci_status', 'under_repair') # under_repair, available, retired
|
||||
old_ci_condition = request.POST.get('old_ci_condition', 'damaged')
|
||||
old_ci_location = request.POST.get('old_ci_location', 'Gudang Perbaikan')
|
||||
notes = request.POST.get('notes', '').strip()
|
||||
|
||||
if not old_ci.installed_on:
|
||||
messages.error(request, f'Komponen {old_ci.ci_code} tidak terpasang pada perangkat apapun.')
|
||||
return redirect('ci_list')
|
||||
|
||||
new_ci = get_object_or_404(ConfigurationItem, id=replacement_ci_id)
|
||||
|
||||
if new_ci.id == old_ci.id:
|
||||
messages.error(request, 'Komponen pengganti tidak boleh sama dengan komponen yang diganti.')
|
||||
return redirect('ci_list')
|
||||
|
||||
if new_ci.status != 'available':
|
||||
messages.error(request, f'Komponen pengganti {new_ci.ci_code} tidak berstatus Tersedia (sedang {new_ci.get_status_display()}).')
|
||||
return redirect('ci_list')
|
||||
|
||||
target_unit = old_ci.installed_on
|
||||
|
||||
with transaction.atomic():
|
||||
# 1. Lepas komponen lama
|
||||
old_ci.installed_on = None
|
||||
old_ci.assigned_to = None
|
||||
old_ci.status = old_ci_status
|
||||
old_ci.condition = old_ci_condition
|
||||
old_ci.location = old_ci_location
|
||||
old_ci.save()
|
||||
|
||||
# 2. Pasang komponen baru
|
||||
new_ci.installed_on = target_unit
|
||||
new_ci.assigned_to = None
|
||||
new_ci.status = 'in_use'
|
||||
new_ci.location = None
|
||||
new_ci.save()
|
||||
|
||||
# 3. Catat history komponen lama
|
||||
CIHistory.objects.create(
|
||||
ci=old_ci,
|
||||
action='replaced',
|
||||
related_unit=target_unit,
|
||||
performed_by=request.user,
|
||||
notes=f"Dilepas dari unit {target_unit.unit_code} dan digantikan oleh {new_ci.ci_code} ({new_ci.name}) [Alasan: {reason}]. {notes}".strip()
|
||||
)
|
||||
|
||||
# 4. Catat history komponen baru
|
||||
CIHistory.objects.create(
|
||||
ci=new_ci,
|
||||
action='installed',
|
||||
related_unit=target_unit,
|
||||
performed_by=request.user,
|
||||
notes=f"Dipasang pada unit {target_unit.unit_code} menggantikan komponen lama {old_ci.ci_code} ({old_ci.name}) [Alasan: {reason}]. {notes}".strip()
|
||||
)
|
||||
|
||||
# 5. Rekam jejak di UnitLog perangkat induk
|
||||
UnitLog.objects.create(
|
||||
unit=target_unit,
|
||||
action='other',
|
||||
employee=target_unit.assigned_to,
|
||||
notes=f"Upgrade/Penggantian Komponen: {old_ci.name} digantikan oleh {new_ci.name}. Alasan: {reason}. {notes}".strip()
|
||||
)
|
||||
|
||||
messages.success(request, f'Penggantian komponen pada unit {target_unit.unit_code} berhasil: {new_ci.ci_code} menggantikan {old_ci.ci_code}.')
|
||||
if request.headers.get('Accept') == 'application/json' or request.headers.get('x-requested-with') == 'XMLHttpRequest':
|
||||
return JsonResponse({'status': 'success'})
|
||||
|
||||
return redirect('ci_list')
|
||||
|
||||
|
||||
@login_required
|
||||
@operator_required
|
||||
def ci_report_damage(request, ci_id):
|
||||
"""Melaporkan keluhan kerusakan pada CI dan mengarahkan ke status pemeriksaan/perbaikan."""
|
||||
ci = get_object_or_404(ConfigurationItem, id=ci_id)
|
||||
|
||||
if request.method == 'POST':
|
||||
action_type = request.POST.get('action_type', 'repair_in') # 'repair_in' atau 'repair_out'
|
||||
condition = request.POST.get('condition', 'damaged')
|
||||
notes = request.POST.get('notes', '').strip()
|
||||
|
||||
if action_type == 'repair_in':
|
||||
ci.status = 'under_repair'
|
||||
ci.condition = condition
|
||||
ci.save()
|
||||
|
||||
CIHistory.objects.create(
|
||||
ci=ci,
|
||||
action='repair_in',
|
||||
performed_by=request.user,
|
||||
notes=f"Dilaporkan rusak / masuk perbaikan. Kondisi: {ci.get_condition_display()}. Catatan: {notes}"
|
||||
)
|
||||
messages.success(request, f'Komponen {ci.ci_code} ditandai masuk perbaikan.')
|
||||
|
||||
elif action_type == 'repair_out':
|
||||
ci.status = 'available'
|
||||
ci.condition = 'good'
|
||||
ci.location = request.POST.get('location', 'Gudang IT')
|
||||
ci.save()
|
||||
|
||||
CIHistory.objects.create(
|
||||
ci=ci,
|
||||
action='repair_out',
|
||||
performed_by=request.user,
|
||||
notes=f"Perbaikan selesai, kondisi dinyatakan bagus dan siap digunakan di {ci.location}. Catatan: {notes}"
|
||||
)
|
||||
messages.success(request, f'Komponen {ci.ci_code} selesai diperbaiki dan siap digunakan.')
|
||||
|
||||
return redirect(request.META.get('HTTP_REFERER', 'ci_list'))
|
||||
Reference in New Issue
Block a user