LDAPWeb/GeoNetAgent/docs/issues.md

Known Issues

Terakhir Diperbarui: 2026-06-29

---

✅ Fixed

[FIXED] Nginx memotong file .ps1 di /install/ — $env: hilang

• Dampak: File PowerShell yang diunduh dari agent.gisportal.id/install/ terpotong. Kode setelah $env: hilang → agent gagal install.
• Penyebab: Nginx SSI menginterpretasikan $env: sebagai variabel SSI → potong respons.
• Fix: Tambah ssi off di nginx config block location /install/.
• Tanggal Fix: 2026-06-22

---

[FIXED] machine_id UNIQUE constraint — split asset hardware campur

• Dampak: Satu laptop yang diinstall dua OS (dual-boot) atau satu chassis yang berisi dua hardware berbeda gagal masuk DB karena machine_id UNIQUE.
• Penyebab: Constraint terlalu ketat — machine_id bisa sama di hardware yang berbeda dalam chassis yang sama.
• Fix: Migration 003 — hapus UNIQUE constraint machine_id. Gunakan kombinasi smbios_uuid + hostname untuk identity. Lihat ADR-002.
• Tanggal Fix: 2026-06-22

---

🔶 Known Limitation

[LIMITATION] Collector port 8000 expose ke internal network

• Dampak: http://10.100.1.24:8000/ui/ bisa diakses tanpa auth dari subnet 10.x dan 192.168.x.
• Workaround: Hanya untuk internal LAN. UI read-only tidak mengekspos data sensitif.
• Rencana Fix: Tambah auth (Laravel session) di Fase 1.

---

[LIMITATION] Nama USB device sering generik

• Dampak: Peripherals HID (keyboard, mouse) terdeteksi tapi nama sering USB Input Device bukan nama spesifik.
• Penyebab: WMI Win32_PnPEntity tidak selalu punya nama deskriptif untuk HID generic.
• Workaround: Tidak ada saat ini. Klasifikasi HID yang lebih baik ada di backlog (v0.1.12+).

---

[LIMITATION] Printer belum dikumpulkan agent

• Dampak: Data printer tidak ada di inventory.
• Rencana: Tambah Win32_Printer / PnP PrintQueue di v0.1.11+.

---

[LIMITATION] Laravel portal belum ada

• Dampak: UI hanya tersedia di FastAPI /ui/ yang read-only tanpa auth.
• Rencana: Scaffold Laravel di Fase 1 (blocker untuk DoD Fase 1).

---

🔴 Open Issues

[OPEN] Uji agent di laptop kedua BKK-MINIPC

• Dampak: Belum diverifikasi agent berjalan di PC non-laptop.
• Prioritas: Low
• File: agent/ — tidak ada perubahan kode

---

Cara Melaporkan Issue Baru

Tambahkan entri di file ini:

### [OPEN] Judul Issue
- **Dampak:** Apa yang terasa salah dari perspektif user
- **Penyebab:** Root cause (jika diketahui)
- **Workaround:** Cara sementara
- **Prioritas:** High / Medium / Low
- **Ditemukan:** YYYY-MM-DD