awcms-news-portal

AWCMS — News Portal (full-online R2-only media)

<!-- sql-refs: awcms-mini — nomor `sql/NNN` di badan skill ini memakai penomoran awcms-mini; modul SUDAH di-port ke awcms sebagai `sql/041`–`sql/045` (lihat README modul + `sql/` nyata untuk nomor sebenarnya) -->

STATUS — SUDAH di-port ke repo ini (PR #214). news_portal kini nyata di sini: src/modules/news-portal, migrasi sql/041_awcms_news_media_object_registry_schema.sql–sql/045_awcms_news_portal_ad_placements_schema.sql, 4 tabel awcms_news_* (semua FORCE ROW LEVEL SECURITY). Skill ini kini panduan mengubah/menambah kode nyata. Baca src/modules/news-portal/README.md

• sql/ untuk nomor/tabel akurat.

⚠ INVERSI ADR-0036 (WAJIB BACA — mengubah kepemilikan media): media BUKAN LAGI milik news_portal. Migrasi 052/053/054 mengekstrak SELURUH registry media (awcms_news_media_objects), presigned upload/finalize/cancel, MIME sniffer, R2 config/client/verification, categorization, dan job news-media:reconcile KELUAR dari news-portal/ ke modul baru src/modules/media-library/ (file news-media-* → media-*, symbol internal fetchNewsMediaObjectById/NewsMediaObjectView DIPERTAHANKAN). Port _shared/ports/news-media-port.ts DIHAPUS → media-library-port.ts (MediaLibraryPort, isManagedMediaEnforcementActiveForTenant). Permission news_portal.media.* → media_library.media.* (repoint destruktif sql/052). Untuk apa pun tentang media (upload, registry, reconcile, R2 config, enforcement) pakai skill awcms-media-library, BUKAN skill ini. news_portal di sini tinggal homepage sections + ad placements; ia CONSUMES media_library. Sebagian besar badan skill di bawah masih men-spesifikasi bentuk PRA-inversi (mini) — perlakukan bagian media-nya sebagai sejarah, bukan lokasi kode kini.

DELTA PORT AWCMS (WAJIB — sebagian besar badan skill di bawah men-spesifikasi bentuk mini; ini yang BEDA di sini):

• DI-DROP: keluarga rute publik host-resolved /news/** (index, detail, kategori, tag, search, feed, sitemap) beserta helper render-nya (homepage-section-composer, homepage-section-rendering, news-share-config). Butuh lib/tenant/public-host-tenant-resolver.ts + env PUBLIC_TENANT_RESOLUTION_MODE dari modul tenant_domain. UPDATE 2026-07-25: tenant_domain SUDAH di-port (#219, sql/046–048), jadi blocker fondasinya hilang — tapi rute /news/** itu sendiri tetap belum diadopsi. Jangan bangun/rujuk /news/** sebagai ada; mengadopsinya sekarang adalah pekerjaan tersendiri, bukan konsekuensi otomatis dari tenant_domain. (Rute publik yang ADA = /blog/{tenantCode} milik blog_content, path-based ADR-0009.)
• DI-DROP: aktivasi preset news_portal_full_online_r2 (apply-news-portal-preset.ts) — butuh preset subsystem module_management yang belum di-port. Tabel awcms_news_portal_tenant_state + reader isFullOnlineR2ModeAppliedForTenant tetap ada (forward-compatible) tapi tanpa writer (inert). Pasca ADR-0036, enforcement managed-media digerakkan media_library lewat isManagedMediaEnforcementActiveForTenant (readiness + flag per-tenant sql/053), dinyalakan via POST /api/v1/media/ enforcement — BUKAN lagi isFullOnlineR2ModeActiveForTenant port lama.
• Yang NYATA di-port & aktif DI news_portal: homepage section composer + ad placements (sql/044/045). Registry media + presigned upload/finalize + MIME sniff/SHA-256 + job news-media:reconcile sudah PINDAH ke media_library (ADR-0036) — lihat skill awcms-media-library. Capability news_media dipensiunkan; news_portal kini CONSUMES media_library.
• Env pre-validasi NEWS_MEDIA_R2_* (validate-env + 3 security-readiness check) ditunda saat port — modul fail-safe tanpa itu di runtime.
• Nomor sql/NNN di badan skill = penomoran awcms-mini; nyata di awcms sql/041–sql/045.

Epic news_portal (#631-#642, #649) menambah lapisan editorial + media di atas blog_content (base module, sudah active) dan online public routing (tenant_domain, ADR-0009/ADR-0010), khusus untuk deployment full-online yang mengaktifkan mode R2-only untuk gambar berita. Epic lanjutan social-publishing (#643-#647) bergantung pada fondasi arsitektur epic ini (khususnya media registry #633 untuk gambar yang dibagikan ke platform sosial) tapi bukan bagian tabel status di bawah — lihat skill/dokumentasi terpisah begitu epic itu mulai dikerjakan.

Kapan pakai skill ini vs skill generik

Skill ini melengkapi (bukan menggantikan) awcms-new-endpoint, awcms-new-migration, awcms-integration (pola outbox/ circuit breaker untuk R2, ADR-0006), awcms-idempotency (mutation confirm upload), awcms-sensitive-data (foto berpotensi PII), awcms-abac-guard, dan awcms-blog-content (model konten post/page/gallery/ads yang jadi konsumen media registry). Skill ini menyediakan konteks cross-cutting epic spesifik — terutama keputusan "R2-only, bucket terpisah dari sync-storage" yang wajib dipertahankan setiap issue.

Baca dulu docs/awcms/news-portal/full-online-r2-architecture.md sebelum mengerjakan issue mana pun di epic ini — dokumen itu (bukan skill ini) adalah sumber kebenaran arsitektur; skill ini merangkum status + pointer, bukan menduplikasi isinya.

Status per issue (jangan bangun ulang yang sudah ada)

Issue	Scope	Status
#631	Dokumentasi arsitektur full-online R2-only + SOP + security + IR + backup + user guide	Selesai — lihat §Dokumen yang sudah ada di bawah
#632	Preset news_portal_full_online_r2 (module descriptor/config gate)	Selesai — lihat §632 di bawah
#633	Tenant-scoped R2-only media object registry (schema + migration)	Selesai — lihat §633 di bawah
#634	Direct-to-R2 presigned upload flow (endpoint upload/confirm)	Selesai — lihat §634 di bawah
#635	Config validation + readiness checks (config:validate/security:readiness/production:preflight) untuk R2 image delivery	Selesai — lihat §635 di bawah
#636	blog_content wajib referensi R2 media object untuk gambar berita saat mode aktif	Selesai — lihat §636 di bawah
#637	Editorial homepage section composer /news dengan render R2-only	Selesai — lihat §637 di bawah
#638	Preset placement iklan news portal dengan validasi gambar R2-only	Selesai — lihat §638 di bawah
#639	Content block video_news dengan thumbnail R2 wajib	Selesai — lihat §639 di bawah
#640	Content quality checklist publishing dengan syarat gambar R2	Selesai — lihat §640 di bawah
#641	Automatic internal tag linking untuk konten post/news	Selesai — lihat §641 di bawah
#642	Public social share buttons di halaman artikel /news	Selesai — lihat §642 di bawah
#649	SEO + social preview metadata lengkap di halaman artikel /news	Selesai — lihat §649 di bawah

Urutan dependency yang disarankan (dari objective masing-masing issue): 631 → 632 → 633 → 634 → 635 (readiness butuh #632-#634 ada untuk divalidasi) → 636 (butuh #633 registry) → 637/638/639/640 (butuh #636, bisa paralel satu sama lain) → 641 (independen, hanya butuh blog_content taxonomies yang sudah ada) → 642/649 (butuh #636 untuk gambar R2 yang valid dipakai preview sosial, bisa paralel).

Yang sudah ada — pakai ulang, jangan re-derive

Dokumen arsitektur (Issue #631, docs/awcms/news-portal/)

Enam dokumen, semua docs-only (tidak ada kode/migration/endpoint di issue ini):

• full-online-r2-architecture.md — dokumen utama. Berisi: ruang lingkup full-online-only (§1), keputusan bucket R2 terpisah dari sync-storage (§2 — lihat §Keputusan kunci di bawah), lima prinsip inti tidak bisa dinegosiasi (§3), konvensi env var NEWS_MEDIA_R2_* (§4 — diimplementasikan Issue #632: sudah ada di .env.example/doc 18/scripts/validate-env.ts), model data konseptual media registry (§5), konvensi object key (§6), dua diagram alur upload (§7), lifecycle presigned URL (§8), urutan validasi MIME/ekstensi/checksum (§9), CORS (§10), custom domain (§11), Cache-Control (§12), rotasi kredensial (§13), diagram trust boundary (§14), dan pemetaan kepatuhan penuh ke ISO/IEC 27001/27002/27005/27017/27018/27701/27034, ISO 22301, OWASP ASVS, OWASP API Security Top 10 (§15).
• r2-upload-sop.md — SOP operasional Jalur A (direct-to-R2, disarankan) dan Jalur B (server-streaming tanpa temp file lokal), urutan validasi, penanganan error, troubleshooting operator.
• r2-security-checklist.md — checklist si

---

Content truncated.