# Context Index — Zammad ⭐ AI Entry Point

> **Terakhir Diperbarui:** 2026-07-06
> **Versi:** 7.1.1-0012.1 — [version.md](./version.md)
> **Cold start:** [../AGENTS.md](../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

```bash
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)