LDAPWeb/Zammad/docs/context-index.md

Context Index — Zammad ⭐ AI Entry Point

Terakhir Diperbarui: 2026-07-06 Versi: 7.1.1-0012.1 — version.md Cold start: ../AGENTS.md Fase Aktif: Fase 1b — SMTP notifikasi 🔄 → Fase 2 FE /ticketing

---

Filosofi

Proyek ini menerapkan AI Native Development:

• Repository = sumber kebenaran utama (Single Source of Truth)
• AI tidak boleh mengandalkan riwayat percakapan
• Developer sering berpindah perangkat — konteks harus tersimpan di repo
• Implementasi tanpa dokumentasi = belum selesai

---

Urutan Membaca

1. File ini — peta navigasi
2. docs/project-status.md — fase & status saat ini
3. docs/todo.md — next actions
4. Dokumen spesifik task (lihat tabel di bawah)
5. perintah.md — wajib dibaca sebelum menyatakan selesai

---

Posisi dalam Super Apps

my.gisportal.id (FE)  ──API──►  zammad.gisportal.id (Zammad REST)
geonet-console        ──LDAP──►  AD 10.100.1.40 (user/group sama)
Zammad attachments    ──S3───►  QNAP OSS zammad-attachments
Zammad DB             ──PG───►  10.100.1.25

Repo terkait	Entry point	Kapan baca
mysupperapps_FE_PWA	docs/context-index.md	Integrasi /ticketing UI
server-connection	server-connection/docs/context-index.md	LDAP, OSS credential, nginx pattern
GeoNetAgent	GeoNetAgent/docs/context-index.md	Kaitkan tiket ↔ asset (opsional)

---

Peta Dokumentasi

docs/ — Flat Files

File	Isi	Baca Saat
docs/project-status.md	Status modul, milestone	Selalu
docs/roadmap.md	Fase super apps ticketing	Planning
docs/todo.md	Next actions berprioritas	Sebelum coding
docs/issues.md	Known bugs + workaround	Debug
docs/changelog.md	Riwayat perubahan	Reference
docs/environment.md	Env vars (tanpa secret)	Setup, deploy
docs/server.md	Server, SSH, stack path	Deploy, infra
docs/deployment.md	Step-by-step install Zammad	Deploy
docs/storage.md	QNAP OSS zammad-attachments	Attachment / S3
docs/troubleshooting.md	Debug umum	Debug
docs/security.md	Credential, LDAP, token	Security
docs/glossary.md	Istilah Zammad + internal	Reference

docs/notes/

File	Isi
email-geonet-co-id.md	Parameter SMTP geonet.co.id + error historis
smtp-notification-setup.md	Step-by-step SMTP Zammad 7 (fase aktif)
fe-ticketing-integration.md	Integrasi mysupperapps_FE_PWA /ticketing
ldap-ad-setup.md	LDAP Zammad → AD 10.100.1.40

docs/architecture/

File	Isi
system-overview.md	Boundary Zammad vs FE vs Mailcow
deployment-architecture.md	Docker di 10.100.1.24, PG eksternal
authentication-flow.md	LDAP AD → Zammad user/role

docs/api/

File	Isi
overview.md	Zammad REST API, token, base URL

docs/adr/

ADR	Keputusan
ADR-0001-zammad-ticketing-platform.md	Zammad sebagai platform ticketing (bukan Jira .55)
ADR-0002-oss-attachments-qnap.md	Attachment di bucket private QNAP OSS

.cursor/rules/

File	Isi
project-context.mdc	Ringkasan proyek untuk AI

---

Quick Reference

Fungsi	URL / Path
Zammad UI (target)	https://zammad.gisportal.id
Zammad API	https://zammad.gisportal.id/api/v1/
FE ticketing	https://my.gisportal.id/ticketing
OSS endpoint	http://10.100.1.10:8010
OSS bucket	zammad-attachments
Docker stack (target)	/opt/stacks/zammad/

SSH

ssh -m hmac-sha1 root@10.100.1.24 -p 22

SSH ke server wajib minta persetujuan user sebelum dijalankan.

---

Aturan Utama AI

1. Baca docs/context-index.md ini terlebih dahulu
2. Jangan duplikasi dokumentasi OSS/LDAP — referensi ke server-connection/docs/ bila umum
3. Perubahan deploy → update docs/deployment.md + perintah.md
4. ADR tidak boleh dihapus — buat baru jika keputusan berubah
5. Jangan commit secret (.env, token, LDAP password, OSS secret)