- 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)
6.8 KiB
6.8 KiB
15 — Glossary & Domain Terminology
Tanggal Analisis: 26 Oktober 2026
Status Verifikasi: Istilah diekstraksi dari kode sumber, label template, dan model bisnis PT KMH.
1. Terminologi Domain Bisnis & Pengelolaan Aset (ITAM)
| Istilah | Definisi Konseptual | Konteks Penerapan dalam Aplikasi | Status Verifikasi |
|---|---|---|---|
| Aset (SKU Level) | Definisi tipe atau model perangkat keras/lunak secara umum tanpa nomor identitas fisik unik. Contoh: "Monitor Dell 24 inch", "Wireless Access Point Ruijie". | Direpresentasikan oleh model Asset di assets/models.py:18. Berisi informasi kode kelompok (asset_code), merek, dan kategori. |
Terverifikasi |
| Unit Aset (Unit Fisik) | Perangkat fisik individual nyata yang memiliki serial number, stiker inventaris, atau kode pelacak mandiri. Satu jenis aset dapat memiliki puluhan unit fisik. | Direpresentasikan oleh model AssetUnit di assets/models.py:84. Memiliki unit_code unik (misal: NB-001, NB-002) dan status operasional. |
Terverifikasi |
Kode Aset (asset_code) |
Pengidentifikasi unik untuk tipe/model aset induk, biasanya ditulis dalam format huruf kapital singkat. | Kolom Asset.asset_code (unique constraint aktif). Jika kode ini diubah, sistem otomatis memperbarui awalan seluruh kode unit di bawahnya. |
Terverifikasi |
Kode Unit (unit_code) |
Pengidentifikasi unik untuk setiap unit fisik barang, terbentuk dari kombinasi kode aset induk dan suffix nomor urut (contoh: PC-OFFICE-015). |
Kolom AssetUnit.unit_code (unique constraint aktif). Digunakan pada pencetakan label stiker dan pencarian cepat. |
Terverifikasi |
| Distribusi Aset | Seluruh proses sirkulasi pemindahan fisik dan tanggung jawab pemeliharaan aset dari gudang IT ke pengguna, antar-pengguna, atau kembali ke gudang. | Dikelola melalui model AssetAssignment dan antarmuka /distribusi/. |
Terverifikasi |
| Serah Terima (Handover) | Transaksi penyerahan unit aset yang berstatus "tersedia" dari gudang IT kepada seorang karyawan untuk keperluan kedinasan. |
AssetAssignment.TYPE_CHOICES = 'handover'. Mengubah status unit menjadi "digunakan" dan menetapkan kolom assigned_to. |
Terverifikasi |
| Mutasi (Mutation) | Transaksi pemindahan tanggung jawab pemegang unit aset dari karyawan lama (from_employee) langsung ke karyawan baru (employee). |
AssetAssignment.TYPE_CHOICES = 'mutation'. Mencatat 2 jejak log riwayat sekaligus (pengembalian pemegang lama & serah terima pemegang baru). |
Terverifikasi |
| Pengembalian (Return) | Transaksi pengembalian unit aset dari karyawan pemegang ke gudang IT karena selesai masa tugas, mutasi keluar, atau kerusakan unit. | AssetAssignment.TYPE_CHOICES = 'return'. Mengubah status unit kembali menjadi "tersedia" dan mengosongkan assigned_to. |
Terverifikasi |
| BAST (Berita Acara Serah Terima) | Dokumen legal fisik/surat tanda terima penyerahan inventaris perusahaan yang ditandatangani kedua belah pihak. | Kolom AssetAssignment.document, disimpan pada direktori server media/bast_documents/. |
Terverifikasi |
| PIC (Person in Charge) / Pemegang | Karyawan aktif yang tercatat secara sah sebagai penanggung jawab unit aset saat ini. | Foreign Key AssetUnit.assigned_to yang terhubung ke model Employee. |
Terverifikasi |
| Area Pemasangan | Lokasi zona geografis penempatan perangkat infrastruktur jaringan pada fasilitas PLTA Kerinci Hydropower. | Pilihan statis pada AssetUnit.AREA_CHOICES (seperti: RW, DAM, Adit 1/2/3, Power House, Vertical Shaft). |
Terverifikasi |
| Lokasi Spesifik | Keterangan detail letak fisik perangkat di dalam area tertentu (contoh: "Ruang Server Lt. 2 Rack A", "Pos Satpam Pintu 3"). | Kolom teks bebas AssetUnit.location. |
Terverifikasi |
| Status Unit: Tersedia | Unit berada di ruang penyimpanan/gudang IT, dalam kondisi prima, dan siap diserahterimakan. | Nilai database 'tersedia'. |
Terverifikasi |
| Status Unit: Digunakan | Unit sedang aktif dipakai oleh karyawan tertentu atau terpasang aktif di area jaringan. | Nilai database 'digunakan'. |
Terverifikasi |
| Status Unit: Rusak / Maintenance | Unit mengalami kendala teknis dan sedang berada di lab IT/vendor untuk perbaikan. | Nilai database 'rusak', dengan display label antarmuka 'Diperbaiki'. |
Terverifikasi |
| Status Unit: Dipensiunkan | Unit telah melewati masa manfaat ekonomis/teknis, rusak permanen, atau dihapuskan dari pembukuan perusahaan (disposed). | Nilai database 'pensiun'. |
Terverifikasi |
| Unit Log / Timeline | Catatan buku besar (audit trail ledger) yang merekam setiap peristiwa perubahan status, mutasi, atau perbaikan pada unit sejak pertama kali didaftarkan. | Model UnitLog. Bersifat append-only dan diurutkan dari peristiwa paling baru (-timestamp). |
Terverifikasi |
2. Terminologi Teknis Arsitektur & Rekayasa Perangkat Lunak
| Istilah | Definisi & Peran dalam Sistem |
|---|---|
| Django Monolith | Pola arsitektur di mana logika bisnis, routing, model data, dan antarmuka HTML digabungkan dalam satu repositori terpusat. |
| HTMX | Library JavaScript deklaratif yang memungkinkan pembaruan bagian halaman HTML secara dinamis via AJAX tanpa menulis JavaScript manual. |
| TailwindCSS | Framework CSS utility-first yang digunakan untuk styling modern, responsif, dan konsisten di seluruh antarmuka web. |
| WhiteNoise | Middleware Django yang mengoptimalkan penyajian file statis (CSS/JS/Gambar) secara langsung dari server aplikasi Python tanpa memberatkan WSGI server. |
| ReportLab | Library Python untuk mengonversi data dinamis menjadi dokumen PDF berstandar cetak dengan tata letak koordinat presisi. |
| openpyxl | Library Python untuk membaca dan menulis file spreadsheet format Microsoft Excel (.xlsx) dengan styling border dan warna sel. |
| PyMySQL | Driver Python murni untuk menghubungkan aplikasi Django ke database MySQL / MariaDB tanpa kompilasi native C extension. |
| UUID (Universally Unique Identifier) | 128-bit identifier acak yang digunakan pada AssetUnit.id_uuid agar URL publik tidak dapat ditebak secara berurutan (anti-enumeration attack). |
| Atomic Transaction | Blok eksekusi database di mana serangkaian operasi query harus berhasil seluruhnya; jika satu query gagal, seluruh operasi dibatalkan (rollback). Digunakan pada @transaction.atomic di alur distribusi. |
| God File | Anti-pattern di mana sebuah file modul menampung terlalu banyak tanggung jawab dan baris kode (assets/views.py dengan 3.056 baris). |
| Soft Delete | Pola penghapusan data di mana baris database tidak benar-benar dihapus (DELETE), melainkan hanya ditandai nonaktif melalui kolom flag boolean atau timestamp. |
| RBAC (Role-Based Access Control) | Mekanisme kontrol akses yang membatasi wewenang tindakan pengguna berdasarkan peran atau grup yang diberikan kepadanya. |