LDAPWeb/server-connection/perintah.md

Protokol Sync Dokumentasi AI

Wajib di akhir sesi pengembangan. Repository = sumber kebenaran; percakapan bukan dokumentasi.
Repo: server-connection · Konteks pemilik: .cursor/me.md

Indeks cepat (operasional)

Topik	File / URL
Profil & infrastruktur	.cursor/me.md
Konteks repo, host SSH, deploy	.cursor/rules/00-project-context.mdc
Perilaku AI agent	.cursor/rules/03-ai-behavior.mdc
Status fitur geonet-console	.cursor/rules/02-implementation-status.mdc
Ringkasan agent & Ollama/NAS	AGENTS.md
Requirement bisnis	rules, rules-adv
SSH & deploy cepat	readme.txt
Host & IP	server/host.txt
geonet-console	https://console.gisportal.id
databaselist	https://databaselist.gisportal.id
sqlservercheck	https://sqlservercheck.gisportal.id

Aplikasi & stack produksi

Folder	URL	Stack server
geonet-console/	https://console.gisportal.id	/opt/stacks/geonet-console/
databaselist/	https://databaselist.gisportal.id	/opt/stacks/databaselist/
sqlservercheck/	https://sqlservercheck.gisportal.id	/opt/stacks/sqlservercheck/

URL produksi (domain gisportal.id)

geonet-console

Fungsi	URL
Login / dashboard	https://console.gisportal.id

databaselist

Fungsi	URL
Daftar database	https://databaselist.gisportal.id/
LDAP Users	https://databaselist.gisportal.id/ldap-users
LDAP Groups	https://databaselist.gisportal.id/ldap-groups
DB Connections	https://databaselist.gisportal.id/database-connections
Mail SMTP & template	https://databaselist.gisportal.id/mail-settings
Audit Logs	https://databaselist.gisportal.id/audit-logs
API Docs	https://databaselist.gisportal.id/api-docs
Profile (user)	https://databaselist.gisportal.id/profile
REST API	https://databaselist.gisportal.id/api/v1
API Clients (OAuth2 + API Tokens + Service Tokens)	https://console.gisportal.id/api-clients

sqlservercheck

Fungsi	URL
Tool cek SQL Server	https://sqlservercheck.gisportal.id/ts
	https://sqlservercheck.gisportal.id/nts

Deploy dari laptop

.\scripts\deploy-geonet-console.ps1
.\scripts\deploy-databaselist.ps1
.\scripts\deploy-sqlservercheck.ps1
.\scripts\deploy-databaselist.ps1 -NoBuild   # restart tanpa rebuild

SSH reverse proxy: ssh -m hmac-sha1 root@10.100.1.24 -p 22 · Edit .env hanya di server.

File konteks (update saat sync)

File	Isi
.cursor/me.md	Profil pemilik & infrastruktur
.cursor/rules/*.mdc	Rules Cursor
AGENTS.md	Ringkasan agent, roadmap Ollama/NAS
perintah.md	Protokol sync (file ini)
readme.txt	SSH, deploy, URL
rules / rules-adv	Requirement bisnis manual
server/ollama-nas-project-search-requirements.md	Requirement Ollama + NAS

Rules	Isi
00-project-context.mdc	Repo, host, deploy
01-enterprise-principles.mdc	Prinsip enterprise & UX
02-implementation-status.mdc	Status geonet-console
03-ai-behavior.mdc	Perilaku agent
04-geonet-uiux.mdc	Standar UI/UX
05-laravel-backend.mdc	Backend Laravel
06-infrastructure.mdc	SSH, Mikrotik, deploy

---

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
    - perintah.md (baris "Sync terakhir" di bawah)
    - 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.
- URL & indeks di perintah.md dan .cursor/me.md harus selaras.

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

Tanggal	Ringkasan perubahan
2026-06-11	Lengkapi me.md & perintah.md — URL produksi, indeks file, selaraskan server-connection / GeoNetAgent
2026-06-23	Implementasi fitur Service Tokens di geonet-console (migration, model, service, API endpoints, UI, audit log)
2026-06-23	Implementasi sinkronisasi Service Tokens → geonetagent_dev.agent_tokens (AgentTokenSyncService, Opsi C)
2026-06-29	Audit & lengkapi dokumentasi server-connection: buat docs/ lengkap (context-index, architecture, api, adr, diagrams, onboarding, decisions), README.md root, .cursor/rules/ tambahan (documentation, security, deployment, api, database, architecture)