Files
KMH_IT_Assets/assets/views/ci_views.py
T
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

499 lines
20 KiB
Python

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'))