# Glossary

> **Terakhir Diperbarui:** 2026-06-29

---

| Istilah | Definisi |
|---------|----------|
| **GeoNetAgent** | Nama proyek — portal IT + CMDB berbasis agent untuk inventaris endpoint Windows |
| **Agent** | PowerShell script yang berjalan di endpoint user (laptop/PC) via Scheduled Task setiap 3 jam |
| **Collector** | FastAPI service yang menerima laporan dari agent dan menyimpan ke PostgreSQL |
| **Portal** | Laravel UI untuk tim IT (belum scaffold — Fase 1 blocker) |
| **Snapshot** | Rekaman point-in-time data hardware/software dari laporan agent (bukan live metric) |
| **Asset** | Entitas terkelola: endpoint, server, VM, NAS, network device, dll |
| **CMDB** | Configuration Management Database — inventaris aset IT beserta relasi dan metadata |
| **ADR** | Architecture Decision Record — dokumen keputusan arsitektur permanen |
| **DoD** | Definition of Done — kriteria suatu fase dinyatakan selesai |
| **agent_id** | Identifier unik asset hasil resolusi ADR-001 (serial → smbios_uuid → MAC → machine_id → hostname) |
| **smbios_uuid** | UUID dari BIOS/SMBIOS — digunakan sebagai identitas asset utama |
| **machine_id** | OS-level machine identifier (bukan UNIQUE sejak migration 003) |
| **payload** | Data JSON yang dikirim agent ke collector: system, cpu, gpu, disks, network, peripherals, software |
| **v_asset_hardware_latest** | Database view yang merangkum hardware snapshot terbaru per asset |
| **manifest.json** | File di server listing semua file agent + versi — dipakai untuk auto-update |
| **auto-update** | Mekanisme agent mengunduh ulang file terbaru dari server sebelum kirim laporan (cek VERSION vs manifest) |
| **GPO** | Group Policy Object — mekanisme Windows untuk deploy script ke semua endpoint domain |
| **Web install** | Cara install agent via 2 baris PowerShell dari URL `agent.gisportal.id/install/` |
| **SSI** | Server-Side Includes — fitur Nginx yang memotong `$env:` di file `.ps1` (wajib `ssi off`) |
| **Zabbix** | Platform monitoring existing — GeoNetAgent melengkapi, bukan menggantikan |
| **Proxmox** | Platform virtualisasi — VM-nya akan di-sync ke CMDB di Fase 3 |
| **QNAP OSS** | QNAP QuObjects Object Storage — penyimpanan dokumen procurement/service/complain (ADR-003) |
| **Split asset** | ADR-002: satu chassis dengan hardware campur (laptop Dell + PC Gigabyte) dipecah jadi 2 asset record |
| **form_factor** | Field yang menentukan Laptop/PC/Desktop berdasarkan chassis type dari WMI |
| **physical_disks** | Array disk fisik (NVMe/HDD/SSD) — berbeda dari `disks` yang berisi logical partition |
| **is_external** | Flag peripheral yang menandakan apakah perangkat eksternal (USB) atau built-in |
| **is_built_in** | Flag NIC yang menandakan NIC onboard vs USB/adapter |