Data & Analytics Skills

Terapkan idempotency pada mutation high-risk AWCMS agar aman dari double-submit. Gunakan saat implementasi posting transaksi, cancel/return, transfer approve/ship/receive, cycle count, adjustment, VAT generate, Coretax batch, receipt send, sync push, atau workflow decision. Sesuai doc 10.

Scaffold modul baru pada modular monolith AWCMS. Gunakan saat membuat modul domain baru di src/modules/ (mis. warehouse-management, accounting-tax) atau saat memerlukan struktur module.ts + domain/application/infrastructure/api + README. Ikuti struktur standar doc 10 & 11.

Modul sitesearch SUDAH di-port ke repo ini (dari awcms-micro Issue 270 / ADR-0031, di sini ADR-0040; migrasi sql/064 schema + sql/065 permission, Gelombang-1 docs/awcms/absorb-awcms-micro-roadmap.md). Indeks PostgreSQL FTS lintas-konten per tenant atas konten publik terbit — type: domain, deps Core-only [tenantadmin, identityaccess], lima tabel awcmssitesearch (ENABLE+FORCE RLS), endpoint publik anonim host-resolved GET /api/v1/site-search/{query,suggest} + halaman /search, admin /api/v1/site-search/{settings,index/}, job bun run site-search:reconcile, gate bun run site-search:sources:check. Seam kontribusi ModuleDescriptor.searchSources (MODULECONTRACTVERSION 2.2.0) — modul konten MENDEKLARASIKAN sumber, agregator menemukannya lewat listModules(). Gunakan saat menambah sumber pencarian baru, mengubah relevansi/snippet/rebuild, atau menyentuh config/diagnostik search.

Triase dan perbaiki temuan CodeQL code scanning AWCMS (github.com/ahliweb/awcms/security/code-scanning). Gunakan saat diminta "analisis code scanning"/"perbaiki CodeQL", saat sebuah PR gagal check CodeQL, atau saat menemukan alert baru. Mendokumentasikan enam false-positive nyata yang sudah ditemukan (name-heuristic password, incompatible-types typeof/null, URL substring-sanitization di test mock, dua kasus dismiss resmi tanpa reformulasi kode, Bun.SQL tagged-template null-cast, dan build-time extension seam trivial-conditional) plus pola "unused-local-variable di test kadang menandai coverage gap" — supaya tidak diinvestigasi ulang dari nol.

BACAAN SAJA / HISTORIS (ADR-0034) — kontrak kesiapan ekstensi ERP base (shared/business-transaction-contract.ts/shared/erp-reference-data-contract.ts/shared/ports/period-lock-port.ts) DAN jalur aplikasi-turunan yang skill ini asumsikan SUDAH DIHAPUS. ERP kini dibangun sebagai modul domain LANGSUNG di src/modules/ (pola sama modul base lain), bukan repo turunan; file kontrak & fixture example-erp-extension yang dirujuk tidak lagi ada. Rujukan historis dari Issue 755, epic 738 platform-evolution Wave 4, ADR-0020 — men-supersede oleh ADR-0034.

Audit dan perkuat backend & integrasi eksternal AWCMS (resiliensi, outbox, webhook/provider, versioning API, observability). Gunakan saat menambah/mengeraskan integrasi ke provider luar (R2, WhatsApp, email, AI, pajak), memperbaiki keandalan delivery, atau menaikkan ketahanan backend. Menegakkan ADR-0006 (provider opsional, di luar transaksi) dan pola outbox doc 16.

Tambah/ubah string UI atau konten multi-bahasa AWCMS yang benar. Gunakan saat menambah teks UI baru, menambah locale, memformat angka/mata uang/tanggal, atau menambah field konten yang perlu multi-bahasa. Menegakkan katalog .po gettext (default en, min en+id), resolusi locale via middleware, dan konvensi konten multi-bahasa doc 04 sesuai Issue 433.

BACAAN SAJA — migrasi data legacy sengaja DIDESKOP dari base repo AWCMS (lihat doc 06 §"Riwayat perubahan backlog"). Gunakan skill ini untuk memahami KENAPA fitur ini tidak ada di sini dan ke mana konsep ini harus dibangun (aplikasi turunan, mis. AWPOS) — jangan pakai sebagai panduan implementasi. Command/tabel/issue yang dulu dirujuk di skill ini (legacy:preflight, awcmslegacymigrationruns, Issue 1.1/1.2) tidak ada di repo ini.

Tambah atau ubah domain event AWCMS. Gunakan saat mem-publish event baru (mis. sales.transaction.posted), mengubah payload event, atau menambah subscriber. Menegakkan envelope event standar dan update AsyncAPI sesuai doc 05.

Kerjakan bagian mana pun dari epic newsportal AWCMS (Issue 631-642, 649). Gunakan saat menambah/mengubah preset full-online R2-only, media object registry, presigned upload flow, R2 readiness checks, homepage composer, ad/video/quality-checklist berbasis media R2, tag linking, atau SEO/social preview /news. Merangkum keputusan arsitektur yang sudah dibuat (docs/awcms/news-portal/) supaya issue lanjutan tidak mengulang/kontradiksi.

Kelola sistem log/audit/metrics AWCMS yang sudah aktif — correlation ID lintas hop, retensi/purge audit log, extension point untuk consumer eksternal (alerting/export/SIEM), dan metrics port (counter/histogram/gauge berkardinalitas rendah untuk request/pool/job/provider). Gunakan saat menambah endpoint baru (correlation ID otomatis), menjadwalkan purge audit log, memasang consumer log/audit di deployment/consumer eksternal, atau menambah/mengonsumsi metrik operasional. Berbeda dari awcms-audit-log (APA yang wajib diaudit) — skill ini tentang BAGAIMANA sistem log/audit/metrics itu sendiri dikelola, sesuai Issue 447 dan Issue 698.

SEBAGIAN BACAAN SAJA — hanya fondasi (Issue 2.2: profile CRUD, identifier, entity link, sql/003) yang ada di repo ini; seluruh lapis Issue 748 yang dijelaskan di bawah (merge workflow, relasi party-to-party, deteksi duplikat, merge history) ADA DI awcms-mini dan BELUM di-port ke sini. Gunakan saat mengubah profile CRUD/identifier/masking/cross-tenant guard, ATAU saat mem-port lapis 748 dari mini — bagian 748 di skill ini adalah spesifikasi target, bukan deskripsi kode yang bisa dipanggil hari ini.

ADR-0055 (2 Agustus 2026): ini kandidat BANGUN-DI-SINI, bukan port.

Tulis test AWCMS sesuai strategi berlapis (unit, integration, API contract, security, performance). Gunakan saat menambah fitur, sebelum PR, atau saat diminta menambah/melengkapi test. Sesuai doc 07.

Implementasikan layar/komponen UI AWCMS sesuai design system. Gunakan saat membangun halaman admin/POS/portal, komponen UI, island interaktif, atau memasang design token/theme. Menegakkan token doc 14, state pattern, a11y AA, i18n, dan aturan offline-first doc 15.

BACAAN SAJA — modul visitoranalytics BELUM di-port ke repo ini (ada di awcms-mini; ls src/modules tidak memuat visitor-analytics, tidak ada migration-nya di sql/). Rujukan modul/tabel/sql/NNN di dalamnya adalah artefak awcms-mini, penomoran mini. Pakai sebagai spesifikasi target saat MEM-PORT (via awcms-port-from-mini), bukan panduan implementasi kode yang bisa dipanggil — verifikasi ls src/modules dulu. Konteks port (Issue 617-624). Gunakan saat menambah/mengubah VISITORANALYTICS env config, skema session/event/rollup, helper identity/UA/bot classification, middleware collector, API/dashboard /admin/analytics, enrichment geolokasi, atau job rollup/retention purge. Merangkum keputusan yang sudah dibuat supaya issue lanjutan tidak mengulang/kontradiksi.

ADR-0055 (2 Agustus 2026): ini kandidat BANGUN-DI-SINI, bukan port.