# 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

```powershell
.\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) |