# Context Index — Mailcow

> Cold start: [../AGENTS.md](../AGENTS.md) → [ai-session-summary.md](./ai-session-summary.md) → **STOP**

---

## Zona A — Always-read pointers

| Item | Value |
|------|-------|
| Nama | Mailcow |
| Path monorepo | `Mailcow/` |
| Cold start | [../AGENTS.md](../AGENTS.md) |
| Sesi terakhir | [ai-session-summary.md](./ai-session-summary.md) |
| Priority | [todo.md](./todo.md) |
| Server / infra | [server.md](./server.md) |
| System requirements | [system-requirements.md](./system-requirements.md) |
| Env template | [../.env.example](../.env.example) |
| Versi | **1.2.5** — [version.md](./version.md) |
| Stack | Mailcow dockerized, fetchmail (geonet), Dovecot/Postfix |
| Domains | `geonet.co.id` (hybrid cPanel), `gisportal.id` (murni) |
| Tipe | infra |
| Last updated | 2026-07-06 |

**Rolling session memory:** hanya [ai-session-summary.md](./ai-session-summary.md).

---

## Zona B — On-demand map

### Dokumentasi inti

| Dokumen | Kapan baca |
|---------|------------|
| [project-status.md](./project-status.md) | Status milestone |
| [issues.md](./issues.md) | Bug / RCA |
| [changelog.md](./changelog.md) | Audit riwayat |
| [version.md](./version.md) | Deploy / rilis |
| [environment.md](./environment.md) | Variabel env |
| [deployment.md](./deployment.md) | Install stack |
| [guide/](./guide/) | IMAP user, migrasi MX |

### Notes (domain)

| Dokumen | Isi |
|---------|-----|
| [notes/gisportal-id-mail.md](./notes/gisportal-id-mail.md) | Domain `gisportal.id` — Mailcow murni, DNS Master Web |
| [notes/hybrid-migration-cpanel-mailcow.md](./notes/hybrid-migration-cpanel-mailcow.md) | Jalur A/B hybrid geonet |
| [notes/ldap-ad-mailcow.md](./notes/ldap-ad-mailcow.md) | LDAP AD + SOGo troubleshooting |
| [notes/storage-nas-qnap.md](./notes/storage-nas-qnap.md) | Backup QNAP |
| [notes/deployment-sizing.md](./notes/deployment-sizing.md) | Sizing VM |

### Parent / sibling

| Repo | Entry |
|------|-------|
| Zammad | `Zammad/docs/context-index.md` |
| server-connection | `server-connection/docs/context-index.md` |
| nginx | `nginx/docs/context-index.md` |
| Dockge | `Dockge/docs/context-index.md` |

---

## Arsitektur singkat

```
geonet.co.id  → MX cPanel → fetchmail POP3 → Mailcow (hybrid, transport maps)
gisportal.id  → MX mail.gisportal.id → 117.102.73.102 → Mailcow (murni)
                      ├── Outlook IMAP :993 / SMTP :587 (sync.geonet.co.id)
                      └── Zammad IMAP (planned)
```

| Fungsi | URL / Host |
|--------|------------|
| Mailcow UI | `https://sync.geonet.co.id` |
| VM | `10.100.1.28` |
| IMAP/SMTP | `sync.geonet.co.id` :993 / :587 |
| DNS gisportal | Master Web (`dns1.masterweb.com`) |

---

## Aturan kritis AI

- No commit `.env`; update `.env.example` + `environment.md`
- Deploy material → append `version.md` + `changelog.md`
- `support@` = authsource **ldap**; `admin@gisportal.id` = **mailcow**
- Jangan masukkan user ke `Mail-Users` jika masih baca cPanel
- SSH wajib persetujuan user