- 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)
14 KiB
04 — Database & Data Dictionary: Model dan Skema Database
Tanggal Analisis: 26 Oktober 2026
Sumber: assets/models.py, assets/migrations/0001_initial.py — 0016_sync_existing_unit_codes.py
Status: Terverifikasi dari source code — struktur aktual database hanya dapat dipastikan dengan akses runtime
1. Daftar Model
| Model | Tabel (estimasi) | Baris Definisi | Deskripsi |
|---|---|---|---|
Employee |
assets_employee |
L4-10 | Data karyawan/pengguna aset |
Category |
assets_category |
L12-16 | Kategori jenis aset |
Asset |
assets_asset |
L18-82 | Jenis/tipe aset (SKU-level) |
AssetUnit |
assets_assetunit |
L84-116 | Unit fisik individual |
UnitLog |
assets_unitlog |
L118-141 | Riwayat historis setiap unit |
AssetAssignment |
assets_assetassignment |
L143-168 | Riwayat distribusi aset |
2. Data Dictionary
2.1 Model: Employee
Tujuan: Menyimpan data karyawan yang dapat menerima/memegang aset IT
| Field | Tipe Django | Tipe DB (est.) | Nullable | Unique | Default | Keterangan |
|---|---|---|---|---|---|---|
id |
BigAutoField |
BIGINT |
No | Yes (PK) | Auto | Primary key otomatis |
nik |
CharField(20) |
VARCHAR(20) |
No | Yes | — | Nomor Induk Karyawan |
name |
CharField(150) |
VARCHAR(150) |
No | No | — | Nama lengkap karyawan |
position |
CharField(100) |
VARCHAR(100) |
Yes | No | None | Jabatan (ditambah di migration 0014) |
Constraints:
nikadalah unique — duplikasi NIK dicegah di level model
Methods: __str__ → "{nik} - {name}"
Relasi:
AssetUnit.assigned_to→ FK ke Employee (SET_NULL)UnitLog.employee→ FK ke Employee (SET_NULL)AssetAssignment.employee→ FK ke Employee (SET_NULL)AssetAssignment.from_employee→ FK ke Employee (SET_NULL)
2.2 Model: Category
Tujuan: Klasifikasi jenis aset (minimal dua: "Aset Karyawan" dan "Aset Network")
| Field | Tipe Django | Tipe DB (est.) | Nullable | Unique | Default | Keterangan |
|---|---|---|---|---|---|---|
id |
BigAutoField |
BIGINT |
No | Yes (PK) | Auto | Primary key otomatis |
name |
CharField(100) |
VARCHAR(100) |
No | No | — | Nama kategori |
Note
Seed data di
seed_initial_data.pymembuat dua kategori default:'Aset Karyawan'dan'Aset Network'. Aplikasi menggunakan__icontainsuntuk membedakan, bukan relasi eksplisit.
2.3 Model: Asset
Tujuan: Merepresentasikan jenis/tipe aset (SKU-level). Satu Asset bisa memiliki banyak AssetUnit.
| Field | Tipe Django | Tipe DB (est.) | Nullable | Unique | Default | Keterangan |
|---|---|---|---|---|---|---|
id |
BigAutoField |
BIGINT |
No | Yes (PK) | Auto | Primary key |
category |
ForeignKey(Category) |
BIGINT (FK) |
Yes | No | — | Kategori aset, SET_NULL jika kategori dihapus |
no_index |
CharField(20) |
VARCHAR(20) |
Yes | No | None | Nomor urut manual (tidak digenerate otomatis) |
asset_code |
CharField(50) |
VARCHAR(50) |
No | Yes | — | Kode unik aset, uppercase |
name |
CharField(150) |
VARCHAR(150) |
No | No | — | Nama aset |
brand |
CharField(100) |
VARCHAR(100) |
Yes | No | None | Merek/brand |
qty |
IntegerField |
INT |
No | No | 0 | Jumlah unit yang tercatat |
sum_qty |
IntegerField |
INT |
No | No | 0 | Tidak jelas digunakan untuk apa (field tidak di-update di kode) |
uom |
CharField(50) |
VARCHAR(50) |
Yes | No | None | Satuan unit (Unit, Pcs, dll) |
price |
DecimalField(15,2) |
DECIMAL(15,2) |
No | No | 0 | Harga satuan |
total_price |
DecimalField(15,2) |
DECIMAL(15,2) |
No | No | 0 | Total harga (tidak otomatis dihitung) |
serial_number |
CharField(100) |
VARCHAR(100) |
Yes | No | None | Serial number aset induk |
purchase_date |
DateField |
DATE |
Yes | No | None | Tanggal pembelian |
notes |
TextField |
TEXT |
Yes | No | None | Catatan tambahan |
Potensi Masalah:
qtydiupdate manual (asset.qty = asset.units.count()) hanya pada beberapa kondisi — tidak konsistensum_qty,price,total_price— tampaknya tidak di-update oleh views yang ada. Kemungkinan field legacyserial_numberdi level Asset (bukan unit) — pada aplikasi ini, SN mungkin lebih relevan di level unit- Tidak ada
created_atatauupdated_atpada model ini
Custom save() method:
- Mendeteksi jika
asset_codeberubah - Jika berubah, otomatis mengupdate
unit_codesemua unit anak (L39-82) - Menggunakan
transaction.atomic()untuk atomisitas
2.4 Model: AssetUnit
Tujuan: Unit fisik individual. Satu unit = satu perangkat nyata dengan kode unik.
| Field | Tipe Django | Tipe DB (est.) | Nullable | Unique | Default | Keterangan |
|---|---|---|---|---|---|---|
id |
BigAutoField |
BIGINT |
No | Yes (PK) | Auto | Primary key integer |
id_uuid |
UUIDField |
CHAR(32) |
No | Yes | uuid4() |
UUID untuk URL publik dan QR code |
asset |
ForeignKey(Asset) |
BIGINT (FK) |
No | No | — | Aset induk, CASCADE jika asset dihapus |
unit_code |
CharField(60) |
VARCHAR(60) |
No | Yes | — | Kode unik unit (format: {asset_code}-{suffix}) |
status |
CharField(20) |
VARCHAR(20) |
No | No | 'tersedia' |
Status unit |
assigned_to |
ForeignKey(Employee) |
BIGINT (FK) |
Yes | No | None | Pemegang saat ini, SET_NULL jika employee dihapus |
area |
CharField(50) |
VARCHAR(50) |
Yes | No | None | Area pemasangan (untuk aset network) |
location |
CharField(255) |
VARCHAR(255) |
Yes | No | None | Lokasi spesifik |
STATUS_CHOICES:
| Value | Label |
|---|---|
tersedia |
Tersedia |
digunakan |
Digunakan |
rusak |
Diperbaiki (label mismatch — value "rusak" tapi label "Diperbaiki") |
pensiun |
Dipensiunkan |
AREA_CHOICES (hardcoded, domain spesifik PT. KMH):
- Regulating Weir (RW), Jakon, Beringin Tunggal (BT), DAM, Adit 1/2/3, Gudang Induk (GI), Vertical Shaft (VS), Power House (PH), Lain-lainnya
Warning
Status mismatch: Field
statusmemiliki value'rusak'tetapi label'Diperbaiki'. Di views, status ini diperlakukan sebagai "maintenance". Inkonsistensi antara value dan label dapat membingungkan developer.
2.5 Model: UnitLog
Tujuan: Audit trail setiap unit aset — mencatat semua perubahan status dan kejadian.
| Field | Tipe Django | Tipe DB (est.) | Nullable | Unique | Default | Keterangan |
|---|---|---|---|---|---|---|
id |
BigAutoField |
BIGINT |
No | Yes (PK) | Auto | Primary key |
unit |
ForeignKey(AssetUnit) |
BIGINT (FK) |
No | No | — | Unit terkait, CASCADE jika unit dihapus |
timestamp |
DateTimeField(auto_now_add=True) |
DATETIME |
No | No | Now | Waktu kejadian (otomatis) |
action |
CharField(20) |
VARCHAR(20) |
No | No | — | Jenis kejadian (choices) |
employee |
ForeignKey(Employee) |
BIGINT (FK) |
Yes | No | None | Karyawan terkait, SET_NULL |
notes |
TextField |
TEXT |
Yes | No | None | Catatan detail |
ACTION_CHOICES:
| Value | Label |
|---|---|
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 |
Meta:
ordering = ['-timestamp']— terbaru di atas
Catatan Penting:
- Ketika
employeedihapus, nama karyawan di-embed ke dalamnotessebelum deletion (mekanismeemployee_deletedi views.py L792-796) - Pattern parsing:
"{name} ({nik}) - {catatan}"— parsing dilakukan dengan regex di view dan export
2.6 Model: AssetAssignment
Tujuan: Riwayat formal distribusi aset — serah terima, mutasi, pengembalian. Berbeda dengan UnitLog, ini adalah record formal dengan dokumen.
| Field | Tipe Django | Tipe DB (est.) | Nullable | Unique | Default | Keterangan |
|---|---|---|---|---|---|---|
id |
BigAutoField |
BIGINT |
No | Yes (PK) | Auto | Primary key |
type |
CharField(20) |
VARCHAR(20) |
No | No | 'handover' |
Tipe distribusi |
unit |
ForeignKey(AssetUnit) |
BIGINT (FK) |
No | No | — | Unit terkait, PROTECT — tidak bisa dihapus jika ada assignment |
employee |
ForeignKey(Employee) |
BIGINT (FK) |
Yes | No | None | Penerima, SET_NULL |
from_employee |
ForeignKey(Employee) |
BIGINT (FK) |
Yes | No | None | Pengirim (untuk mutasi), SET_NULL |
assigned_date |
DateField |
DATE |
No | No | — | Tanggal transaksi |
returned_date |
DateField |
DATE |
Yes | No | None | Tanggal dikembalikan (tidak di-update secara konsisten) |
document |
FileField |
VARCHAR(100) |
Yes | No | None | Path file dokumen BAST |
status |
CharField(20) |
VARCHAR(20) |
No | No | 'aktif' |
Status penugasan |
notes |
TextField |
TEXT |
Yes | No | None | Catatan tambahan |
created_at |
DateTimeField(auto_now_add=True) |
DATETIME |
Yes | No | Now | Waktu dibuat (ditambah di migration 0015) |
TYPE_CHOICES:
| Value | Label |
|---|---|
handover |
Serah Terima |
mutation |
Mutasi |
return |
Pengembalian |
STATUS_CHOICES:
| Value | Label |
|---|---|
aktif |
Aktif |
dikembalikan |
Dikembalikan |
Warning
returned_datetidak di-update secara otomatis ketika proses pengembalian (distribusi_return) dilakukan. Ini adalah inkonsistensi — field ada tapi tidak digunakan.
Potensi masalah:
statusfield diAssetAssignmenttidak di-update saat distribusi return — semua record tetap'aktif'unitmenggunakanPROTECT— mencegah penghapusan unit jika ada assignment
3. Entity Relationship Diagram (ERD)
erDiagram
Category {
bigint id PK
varchar(100) name
}
Employee {
bigint id PK
varchar(20) nik UK
varchar(150) name
varchar(100) position
}
Asset {
bigint id PK
bigint category_id FK
varchar(20) no_index
varchar(50) asset_code UK
varchar(150) name
varchar(100) brand
int qty
int sum_qty
varchar(50) uom
decimal(15-2) price
decimal(15-2) total_price
varchar(100) serial_number
date purchase_date
text notes
}
AssetUnit {
bigint id PK
char(32) id_uuid UK
bigint asset_id FK
varchar(60) unit_code UK
varchar(20) status
bigint assigned_to_id FK
varchar(50) area
varchar(255) location
}
UnitLog {
bigint id PK
bigint unit_id FK
datetime timestamp
varchar(20) action
bigint employee_id FK
text notes
}
AssetAssignment {
bigint id PK
varchar(20) type
bigint unit_id FK
bigint employee_id FK
bigint from_employee_id FK
date assigned_date
date returned_date
varchar(100) document
varchar(20) status
text notes
datetime created_at
}
Category ||--o{ Asset : "mengkategorikan"
Asset ||--o{ AssetUnit : "memiliki unit"
Employee ||--o{ AssetUnit : "memegang (assigned_to)"
AssetUnit ||--o{ UnitLog : "memiliki riwayat"
Employee ||--o{ UnitLog : "terkait dengan"
AssetUnit ||--o{ AssetAssignment : "memiliki distribusi"
Employee ||--o{ AssetAssignment : "menerima (employee)"
Employee ||--o{ AssetAssignment : "mengirim (from_employee)"
4. Migration Overview
| Migration | Perubahan Utama | Tanggal (dari kode) |
|---|---|---|
0001_initial.py |
Create: Category, Employee, Asset (dengan status), AssetAssignment | 2026-10-06 |
0002 |
Tambah: no_index, price, qty, sum_qty ke Asset; tambah AssetUnit |
— |
0003 |
Remove: status dari Asset; hapus field lama; restrukturisasi model |
— |
0004 |
Create: UnitLog model |
— |
0005 |
Tambah: brand ke Asset; alter beberapa field |
— |
0006 |
Create: MasterAssetCode (kemudian dihapus) |
— |
0007 |
Delete: MasterAssetCode |
— |
0008 |
Remove: label dari AssetUnit; alter UnitLog.action choices |
— |
0009 |
Tambah: from_employee, type ke AssetAssignment |
— |
0010 |
Tambah: area, location ke AssetUnit |
— |
0011 |
Tambah: id_uuid ke AssetUnit |
— |
0012 |
Alter: id_uuid ke UUID type yang benar |
— |
0013 |
Alter: FK AssetAssignment (ubah CASCADE ke SET_NULL/PROTECT) | — |
0014 |
Tambah: position ke Employee |
— |
0015 |
Tambah: created_at ke AssetAssignment |
— |
0016 |
RunPython: Sinkronisasi unit_code dengan asset_code induk | 2026-10-13 |
Note
Adanya migration
0006(create MasterAssetCode) diikuti0007(delete MasterAssetCode) menunjukkan ada eksperimen desain yang ditinggalkan. Field ini kemungkinan digantikan denganasset_codeyang ada diAsset.
5. Potensi Masalah Database
| # | Masalah | Lokasi | Dampak | Rekomendasi |
|---|---|---|---|---|
| DB-01 | qty tidak sinkron otomatis |
Asset.qty, views.py |
Angka qty di Asset bisa tidak akurat |
Gunakan annotate dari unit count, bukan field tersimpan |
| DB-02 | sum_qty, price, total_price tidak diisi |
Asset model |
Field tidak berguna, membuang ruang | Audit penggunaan atau hapus jika tidak diperlukan |
| DB-03 | returned_date tidak diisi |
AssetAssignment |
Field tidak berfungsi | Update saat proses return |
| DB-04 | AssetAssignment.status tidak diupdate |
views.py | Semua assignment berstatus 'aktif' meskipun sudah dikembalikan | Update status saat return |
| DB-05 | Status value mismatch di AssetUnit | models.py L89 | 'rusak' → label 'Diperbaiki' membingungkan |
Ganti value ke 'maintenance' atau sesuaikan label |
| DB-06 | Tidak ada soft delete | Semua model | Data yang dihapus tidak bisa dipulihkan | Pertimbangkan soft delete untuk Employee dan Asset |
| DB-07 | Tidak ada created_at/updated_at di Asset, Employee, Category, AssetUnit |
— | Tidak bisa audit kapan data dibuat/diubah | Tambahkan audit fields |
| DB-08 | No index pada field pencarian umum | AssetUnit.status, Employee.name | Potensi slow query pada data besar | Tambahkan db_index=True |
| DB-09 | ON DELETE PROTECT pada AssetUnit→AssetAssignment | AssetAssignment.unit | Delete unit akan error jika ada assignment | By design, tapi perlu handling error yang baik di view |
| DB-10 | Employee deletion hardcode embed nama ke UnitLog.notes | views.py L792-796 | Parsing fragile, regex-based | Pertimbangkan soft delete atau arsip employee |