AWCMS-Mini — Modular Monolith Standard

⛔ ARSIP sejak 11 Agustus 2026 — repo ini tidak dikembangkan lagi.

Pengembangan AWCMS berlangsung di dua repo saja: ahliweb/awcms — backend dan admin SISTEM, system of record — dan ahliweb/awcms-astro — web publik dan admin USER. Kebutuhan platform lain (mis. aplikasi mobile) mendapat repo sendiri dengan pola awcms-<platform>, bukan cabang dari repo ini.

Dasarnya ADR-0055 (2 Agustus 2026) dan ADR-0070 (8 Agustus 2026) milik ahliweb/awcms: repo ini bukan standar, bukan sumber port, bukan template keluarga. Ia boleh dibaca sebagai referensi sejarah — sama seperti membaca commit lama — tetapi tidak ada pekerjaan yang dijadwalkan "di-port dari" sini. Kemampuan yang diinginkan dibangun langsung di ahliweb/awcms dengan ADR admission-nya sendiri.

Seluruh isi di bawah adalah catatan historis per 26 Juli 2026 — tanggal commit manusia terakhir — dan tidak menggambarkan arah pengembangan hari ini. Repositori di-set read-only di GitHub; issue dan PR yang masih terbuka ikut beku dan tidak akan ditindaklanjuti.

AWCMS-Mini adalah template modular monolith standar AhliWeb berbasis Bun + Astro 7 + PostgreSQL yang dipakai langsung. Ia berisi lapisan reusable (multi-tenant, RBAC/ABAC/RLS, audit, offline-first, kontrak OpenAPI/AsyncAPI, coding standard, skill proyek) — salah satu dari tiga template sejajar keluarga AWCMS (awcms-mini/awcms/awcms-micro), dipakai langsung sebagai titik awal pengembangan, bukan basis-turunan-wajib yang di atasnya harus dibangun aplikasi terpisah (ADR-0024). Modul domain (mis. retail/POS gaya AWPOS) ditambahkan langsung di src/modules/ template ini saat dipakai.

Status: Sprint foundation Issue 0.1-0.3, seluruh epic Tenant/Identity/Profile (Issue 2.1-2.4, M2), Issue 12.1 (Setup Wizard), seluruh epic M5 Sync Storage (Issue 6.1-6.3), seluruh epic M7 UI/UX & Reporting (Issue 8.1 Admin Layout Shell, 9.1 Management Reporting Views), Issue 10.1 (Structured Logging and Audit Trail), Issue 10.2 (Database Connection Pooling and Backpressure), Issue 10.3 (Production Security Readiness Checklist), Issue 11.1 (Workflow Approval Engine), dan Issue 12.2 (Offline/LAN Deployment Profile) tersedia — seluruh 18 issue backlog base generik (doc06) tuntas: Astro build, health endpoint, module contract, response helper, soft-delete convention, folder standar, runner PostgreSQL checksum-based, baseline OpenAPI/AsyncAPI dengan validator, skema tenant/office/physical location/tenant settings, skema profile/identifier/channel/address/entity link/merge request, skema identity/tenant user/session dengan endpoint live POST /auth/login, POST /auth/logout, GET /auth/me, skema RBAC/ABAC dengan evaluator default-deny live POST /access/evaluate, setup wizard live GET /setup/status, POST /setup/initialize, sync node/outbox/inbox HMAC-signed live POST /sync/push, POST /sync/pull, GET /sync/status, sync conflict tracking/resolution (bearer session) live GET /sync/conflicts, POST /sync/conflicts/{id}/resolve, R2 object sync queue HMAC-signed live POST /sync/objects, GET /sync/objects/status, SSR admin shell (/login, /admin, /admin/settings) dengan design token/theming dan sesi cookie httpOnly, dashboard reporting live GET /reports/tenant-activity, GET /reports/access-audit, GET /reports/sync-health, GET /reports/module-usage, audit trail generik live GET /logs/audit dengan logger JSON terstruktur, redaksi lintas-modul, correlation ID, serta contoh lifecycle profil (DELETE/POST .../restore/POST .../purge), connection pooling/backpressure live GET /database/pool/health dengan work-class gate serta circuit breaker terpasang di withTenant (melindungi seluruh endpoint tenant-scoped), tooling production readiness bun run db:pool:health/security:readiness/production:preflight (checklist go-live nyata dengan gate kritis, terverifikasi live memblokir saat RLS sengaja dimatikan), workflow approval engine generik live GET /workflows/tasks, POST /workflows/tasks/{id}/decisions (idempotent, self-approval guard memakai ulang evaluator ABAC yang sudah ada), dan deployment profile offline/LAN lengkap (deploy/systemd, deploy/nginx, deploy/pgbouncer, deploy/backup, docker-compose.yml, bun run config:validate) — seluruhnya dengan RLS. Kontributor & coding agent wajib membaca AGENTS.md lebih dulu.

• Arsitektur tingkat tinggi
• Stack
• Prinsip utama
• Paket dokumen
• Untuk kontributor
• Keamanan
• Tata kelola & komunitas
• Versioning
• Lisensi

flowchart TB
  subgraph Client["Client / LAN"]
    ADM[Admin]
    APP[Modul domain<br/>di src/modules/]
  end

  subgraph App["AWCMS-Mini — Bun + Astro 7 (Modular Monolith)"]
    API[REST API /api/v1<br/>OpenAPI]
    MW[Middleware:<br/>Auth · Tenant · ABAC · Idempotency · Audit]
    MOD[Modul base:<br/>Tenant · Identity · Profile · Access ·<br/>Sync · Workflow · Reporting · UI · Observability]
    EVT[Domain events<br/>AsyncAPI]
  end

  subgraph Data["Data & Storage"]
    PG[(PostgreSQL<br/>RLS + Audit)]
    FILE[Local file storage]
  end

  subgraph Ext["Provider eksternal (OPSIONAL, non-blocking)"]
    R2[Cloudflare R2]
    PROV[Provider domain<br/>mis. pesan/notifikasi]
  end

  ADM --> API
  APP --> API
  API --> MW --> MOD
  MOD --> PG
  MOD --> FILE
  MOD --> EVT
  MOD -. queue/outbox .-> R2
  MOD -. queue/outbox .-> PROV

Provider eksternal terhubung lewat outbox/queue, bukan jalur langsung transaksi — sehingga alur kritikal tetap jalan saat koneksi eksternal bermasalah.

flowchart LR
  Tx[Aksi operasional] --> Local[(DB lokal / LAN)]
  Local --> Outbox[Outbox event + object queue]
  Outbox -->|saat online| Sync[Sync push/pull<br/>HMAC signed]
  Sync --> Server[(Server pusat)]
  Outbox -->|saat online| Deliver[Kirim ke provider · upload R2]
  Server -->|conflict| Manual[Resolusi manual + audit]

• Runtime: Bun (ADR-0002 — Bun-only; Node.js hanya lewat pengecualian tertulis)
• Web framework: Astro 7 (SSR di atas Bun)
• Database: PostgreSQL dengan RLS (ADR-0003)
• Arsitektur: Modular monolith, microservice-ready (ADR-0001)
• Mode operasi: Offline-first / LAN-first, optional online sync (ADR-0006)
• Storage file opsional: Cloudflare R2
• Security baseline: RBAC + ABAC + PostgreSQL RLS + Audit Log (ADR-0004)
• Kontrak: OpenAPI + AsyncAPI (ADR-0007)

1. Alur operasional kritikal tetap berjalan tanpa internet bila mode offline/LAN diaktifkan.
2. Provider eksternal (R2, pesan, dsb.) tidak boleh menjadi dependency alur kritikal dan tidak boleh dipanggil di dalam DB transaction.
3. Data yang sudah posted (bila modul domain memilikinya) bersifat immutable, idempotent, atomic, dan audit-ready.
4. Multi-tenant wajib memakai tenant_id, RLS, tenant context, dan ABAC.
5. Data sensitif (password, token, NPWP, NIK, email, nomor HP) wajib di-hash/mask/redact.
6. Master/config/draft yang bisa dihapus memakai soft delete; list default menyembunyikan deleted_at, restore/purge harus berizin dan diaudit (ADR-0005).
7. Dokumentasi, migration, API contract, test, dan SOP mengikuti implementasi nyata.
8. Backend Bun-only; pengecualian Node.js hanya dengan izin maintainer + catatan docs.

Paket dokumen master ada di docs/awcms-mini/. Rantai dari kebutuhan sampai siap koding:

flowchart LR
  A[01 Canvas Induk] --> B[02 PRD]
  B --> C[03 SRS]
  C --> D[04 ERD]
  D --> E[05 OpenAPI/AsyncAPI]
  E --> F[06 Issues]
  F --> G[07 Sprint/Test]
  G --> H[08 SOP]
  H --> I[09 Roadmap Repo]
  I --> J[10 Coding Standard]
  J --> K[11 Blueprint]
  K --> L[12 Generator Prompt]
  L --> M[13 Traceability]
  M --> N([Ready for Coding])
  D --> TD[16 Backend & DB]
  E --> TD
  E --> UX[14 UI/UX] --> FE[15 Frontend]
  TD --> N
  FE --> N
  T17[17 Seed/RBAC/ABAC] --> N
  T18[18 Config/Env] --> N
  SEC[20 Threat Model] -. gates .-> N

• 01–13 perencanaan → kontrak → eksekusi; 14–18 desain teknis; 19 glossary; 20 threat model & arsitektur keamanan.
• Catatan penting: dokumen 02–19 memakai domain retail/POS (gaya AWPOS) sebagai contoh ilustratif — polanya reusable, entitas/endpoint/layarnya adalah ilustrasi domain yang diisi langsung di repo ini dengan modul domain sendiri saat template dipakai. Lihat docs/awcms-mini/README.md §Reusable vs domain turunan.
• Keputusan arsitektural dicatat di docs/adr/.
• Snapshot GitHub issue aktual di docs/awcms-mini/github/.

1. Baca AGENTS.md — kontrak kerja, aturan wajib, guardrail keamanan.
2. Baca CONTRIBUTING.md — alur kontribusi, setup, konvensi commit, Definition of Done.
3. Gunakan skill proyek di .claude/skills/ agar standar diterapkan konsisten.
4. Kerjakan atomic per issue; migration bila schema berubah, OpenAPI bila API berubah, AsyncAPI bila event berubah.
5. Validasi (bun run check — gate CI utama; rantai sub-check lengkap dan urutannya didokumentasikan di CONTRIBUTING.md dan package.json's check script, jangan diduplikasi di sini agar tidak drift) sebelum PR. Untuk perubahan UI non-trivial, tambahkan/jalankan E2E browser sungguhan secara terpisah — bun run test:e2e (Playwright + Bun, skill awcms-mini-browser-test), butuh app+DATABASE_URL hidup, belum bagian dari bun run check.

Backlog base generik ada di docs/awcms-mini/06_github_issues_detail.md — seluruh 18 issue-nya kini tuntas: foundation (0.1-0.3), epic M2 Tenant/Identity/Profile (2.1-2.4), 12.1 (setup wizard), epic M5 Sync Storage (6.1-6.3), epic M7 UI/UX & Reporting (8.1, 9.1), dan epic M8 Security/Performance/Production (10.1-10.3, 11.1, 12.2). Template ini dipakai langsung: tambahkan modul domain di src/modules/ template ini (ADR-0024). Jalur aplikasi-turunan terpisah kini dihapus (ADR-0024, men-supersede ADR-0013/0014/0015); panduan lawasnya di docs/awcms-mini/derived-application-guide.md (DEPRECATED, rujukan historis).

• Kebijakan pelaporan kerentanan: SECURITY.md (gunakan private vulnerability reporting — jangan issue publik).
• Model ancaman & arsitektur keamanan: docs/awcms-mini/20_threat_model_security_architecture.md.
• Automasi: Dependabot, CodeQL, secret scanning, CI hygiene (Bun-only + no-.env).

Semantic Versioning + Changesets; riwayat di CHANGELOG.md. Setiap PR yang mengubah perilaku wajib menyertakan changeset. Versi saat ini 1.0.0 — base production-ready (ADR-0024, 2026-07-21); sejak rilis ini SemVer ditegakkan ketat (perubahan breaking = bump major; aturan pra-1.0 pensiun). Seluruh 18 issue backlog base generik (doc06) tuntas (foundation + epic M2 tenant/office, central profile, identity/login, RBAC/ABAC + 12.1 setup wizard + epic M5 Sync Storage 6.1-6.3 + epic M7 UI/UX & Reporting 8.1, 9.1 + epic M8 Security/Performance/Production 10.1-10.3, 11.1, 12.2), plus perawatan/peningkatan pasca-backlog (milestone M9 — epic #438 5/5 issue selesai, plus issue lanjutan berdiri sendiri di milestone yang sama): upgrade pin PostgreSQL 16 → 18.4, suite test integrasi HTTP terhadap PostgreSQL nyata di CI (lihat tests/README.md), penegakan RLS multi-tenant (migrasi 013: FORCE ROW LEVEL SECURITY + role aplikasi least-privilege awcms_mini_app, lihat deployment-profiles.md §Model dua-peran), Access & Users management penuh (/admin/access-users; lihat src/modules/identity-access/README.md §Access & Users management), Sync admin ops dashboard (/admin/sync — kelola node, resolusi konflik, retry antrean objek; lihat src/modules/sync-storage/README.md §Sync admin ops dashboard), Settings management (/admin/settings — profil tenant, bahasa/tema default, timezone, feature flags; lihat src/modules/tenant-admin/README.md §Settings management), runtime i18n (katalog .po gettext untuk string UI, default bahasa Inggris, min EN+ID; lihat 14_ui_ux_design_system.md §Internationalization), audit UX/UI & aksesibilitas WCAG 2.1 AA atas layar admin yang sudah ada (kontras token -strong, state Error eksplisit, anti double-submit, skip-link), audit performa aplikasi & database (index RLS-aware baru untuk empat query tenant-scoped yang sebelumnya Seq Scan, N+1 write/read dihilangkan, keyset pagination pada tiga endpoint listing — diukur EXPLAIN ANALYZE sebelum/sesudah), dispatcher object sync queue nyata + kerasan integrasi eksternal (Issue #436 — upload nyata via Bun.S3Client diluar transaction DB sesuai ADR-0006, circuit breaker generik diperluas ke provider eksternal, timeout panggilan keluar, CLI terjadwal bun run sync:objects:dispatch; lihat src/modules/sync-storage/README.md §Dispatcher — Issue #436), security hardening berbasis standar OWASP Top 10 / ASVS / ISO 27001 (Issue #437, issue terakhir epic #438 — matrix kepatuhan dengan bukti konkret di 20_threat_model_security_architecture.md §Matrix kepatuhan; gap ditutup: security response headers termasuk CSP via fitur bawaan Astro security.csp — diverifikasi headless-Chrome nyata, bukan cuma curl — dan rate limiting login sumber+tenant melengkapi lockout per-identitas yang sudah ada), dan aktivasi sistem log & manajemennya (Issue #447, issue berdiri sendiri pasca epic #438 — ApiMeta.correlationId konsisten di seluruh respons /api/*, retensi/purge terjadwal awcms_mini_audit_events yang teraudit sendiri, dan extension point observability setLogSink/setAuditExportHook default no-op; lihat src/modules/logging/README.md dan CHANGELOG.md 0.23.5). Kebijakan versi independen (Issue #451): versi rilis (package.json, halaman ini) terpisah dari versi kontrak (info.version OpenAPI/AsyncAPI, kini 1.0.0 — kontrak dinyatakan stabil) dan versi/status module descriptor (kini 1.0.0/active untuk ketujuh modul base) — aturan bump masing-masing di ADR-0008.

Dilisensikan di bawah lisensi MIT — lihat LICENSE. Audit standar pengembangan terakhir: docs/awcms-mini/AUDIT_STANDAR_PENGEMBANGAN_2026-07-17.md.