LDAPWeb/GeoNetAgent/perintah.md

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)

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)