# Protokol Sync Dokumentasi AI

> **Wajib** di akhir sesi pengembangan. Repository = sumber kebenaran; percakapan bukan dokumentasi.

## Indeks cepat (operasional)

| Topik | File / URL |
|-------|------------|
| Progress & fase | `.cursor/progress.md` |
| SSH server | `.cursor/server.md` |
| Collector API | `collector/docs/API.md` |
| Install agent user | https://agent.gisportal.id/install/ · `agent/README.md` |
| Nginx reverse proxy | `infra/nginx/README.md` |
| Publish paket agent | `bash infra/collector/publish_agent_install.sh` |
| Deploy nginx collector | `infra/collector/deploy_nginx.sh` |

### URL produksi (domain `gisportal.id`)

| Fungsi | URL |
|--------|-----|
| Agent POST (internet) | `https://agent.gisportal.id/api/v1/agent/report` |
| Install / update agent | `https://agent.gisportal.id/install/` |
| UI + read API HTTPS | `https://collector.gisportal.id/ui/` |
| UI + read API HTTP LAN | `http://10.100.1.24:8000/ui/` |

### Install agent (PowerShell Admin — 2 baris berurutan)

```powershell
Invoke-WebRequest -Uri 'https://agent.gisportal.id/install/GeoNetAgent-Install.ps1' -OutFile "$env:TEMP\GeoNetAgent-Install.ps1" -UseBasicParsing
& "$env:TEMP\GeoNetAgent-Install.ps1" -SkipInitialRun
```

Path install: `%ProgramData%\GeoNetAgent` · Task: `GeoNetAgent-Report`, `GeoNetAgent-Report-Startup`

---

## PERTANYAAN SYNC (checklist AI)

```
1. Sinkronisasi Dokumentasi

- Pastikan seluruh keputusan, perubahan arsitektur, perubahan desain, perubahan implementasi, dan hasil diskusi pada sesi ini sudah didokumentasikan.
- Minimal periksa dan update:
    - .cursor/rules/
    - .cursor/*.md
    - Architecture Decision Record (ADR) bila terdapat perubahan desain.

2. Sinkronisasi AI Context

- Project ini menggunakan folder .cursor sebagai single source of truth untuk seluruh AI Agent.
- Karena saya sering berpindah perangkat (PC, Laptop, Workstation), AI Agent tidak boleh bergantung pada riwayat percakapan.
- Seluruh konteks penting harus selalu tersimpan di repository.

3. Konsistensi Dokumentasi

- Pastikan tidak ada informasi yang hanya ada di percakapan tetapi belum terdokumentasi.
- Seluruh keputusan teknis wajib dipindahkan ke dokumentasi project.
- Percakapan bukan merupakan sumber dokumentasi.
- Repository adalah sumber dokumentasi utama.

4. Rules Update

- Apabila hasil diskusi mengubah cara pengembangan project, maka AI wajib memperbarui file rules yang relevan.
- atau membuat rules baru apabila diperlukan.

5. Dokumentasi Sebelum Coding

- Jika terdapat perubahan desain, arsitektur, atau workflow, dokumentasi harus diperbarui terlebih dahulu sebelum implementasi kode dilanjutkan.
- Documentation First, Code Second.

6. Final Checklist

- Sebelum menjawab "selesai", AI wajib melakukan checklist berikut:
    - Semua keputusan pada percakapan ini sudah terdokumentasi.
    - Semua file .cursor yang relevan telah diperbarui.
    - Tidak ada konteks penting yang hanya tersimpan di percakapan.
    - Dokumentasi konsisten dengan implementasi.
    - Rules AI tetap menjadi acuan utama pengembangan.
    - Project tetap dapat dipahami AI Agent meskipun riwayat chat tidak tersedia.

- Jika salah satu poin belum terpenuhi, jangan nyatakan pekerjaan selesai.
```

### Sync terakhir: 2026-06-17

- Domain proyek: **`*.gisportal.id`** (bukan `geonet.co.id`)
- Reverse proxy `10.100.1.24`: agent POST publik, collector HTTPS, HTTP `:8000` LAN, web install `/install/`
- `Install-GeoNetAgent.ps1` + publish script; pilot install laptop dev (`DESKTOP-RRJ9G01`)
- Nginx `ssi off` di server `agent.gisportal.id` (fix truncate HTML/ps1)