# 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:

```markdown
### [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
```