Masalah utama adalah konten yang ditandai sebagai "AI-generated" tetap terbit tanpa flag yang terlihat di CMS. Berdasarkan diskusi Ask HN: Add flag for AI-generated articles, penyebab umum adalah data tidak tersebar ke semua service dan cache menyajikan versi lama. Artikel ini langsung membahas gejala, langkah rekonstruksi, logging bantuannya, akar masalah, patch perbaikan, serta mitigasi jangka panjang agar developer bisa segera menerapkannya.

Gejala dan reproduksi

Gejala awal: artikel yang diunggah via pipeline AI tidak menunjukkan label "AI-generated" pada dashboard editor, sekalipun flag tersebut tersedia saat content diterbitkan. Langkah reproduksi yang konsisten:

  1. Proses artikel baru lewat generator AI dan tandai parameter isAIGenerated=true.
  2. Periksa entry pada tabel articles di database utama untuk memastikan flag tersimpan.
  3. Refresh CMS editor yang mengambil data dari cache publik (misalnya Redis) atau service read-replica.
  4. Jika label hilang, berarti frontend membaca data dari cache/replica yang belum terpropagasi.

Dalam kasus Ask HN, tim noticing bahwa flag muncul di UI internal tetapi hilang di CMS, menandakan pipeline backend tidak menyebarkan metadata ke storage konsisten.

Log dan metrik yang membantu deteksi

Untuk memverifikasi propagation, perhatikan log berikut:

  • Job queue: Pastikan worker yang menyimpan artikel mem-emit log article.update dengan payload termasuk flags: { aiGenerated: true }.
  • Cache invalidation: Cek log listener cache untuk event article:initial_publish agar key yang menampung flag dihapus.
  • Service read path: Tambahkan peringatan jika respons API tidak menyertakan flag meski tabel master punya nilai true.
  • Metric: Hitung Rasio mismatch antara value flag di master DB dan value yang dikembalikan API; threshold >0.1% memicu alarm.

Contoh query diagnostik sederhana (PostgreSQL) untuk mengetahui penyimpangan:

SELECT id
FROM articles
WHERE ai_generated = true
AND id NOT IN (
  SELECT article_id
  FROM article_cache_snapshot
  WHERE ai_generated = true
);

Query ini membantu melihat artikel mana yang sudah benar di master tetapi cache snapshot menunjukkan tidak.

Root cause: propagasi flag dan cache inconsistent

Akar masalah biasanya di manifest pipeline data:

  • Flag ai_generated disimpan di schema utama namun tidak disertakan dalam event payload yang dikonsumsi service cache.
  • Cache invalidation hanya berdasar timestamp publish, tanpa memicu detektor perubahan metadata.
  • Jika deployment memisahkan write dan read service, flag bisa hilang pada read-replica yang tidak menerima replikasi asynchronous dalam waktu singkat.

Akibatnya, UI internal yang memanggil service source-of-truth melihat flag, sedangkan CMSnya yang membaca layer cache lama tidak.

Perbaikan kode dan patch

Perbaikan fokus pada dua area: event payload dan cache invalidation. Contoh patch Node.js/TypeScript di worker queue:

diff --git a/src/workers/articlePublisher.ts b/src/workers/articlePublisher.ts
index 9f3a2c1..4b6d6a8 100644
--- a/src/workers/articlePublisher.ts
+++ b/src/workers/articlePublisher.ts
@@ -78,6 +78,13 @@ async function publishArticle(payload: PublishPayload) {
   const article = await articlesRepository.save(payload);
 
   eventBus.emit('article.update', {
     id: article.id,
+    aiGenerated: article.flags.aiGenerated,
+    metadataVersion: article.metadataVersion,
     status: article.status,
     publishedAt: article.publishedAt,
   });
+
+  cacheInvalidator.invalidate(`article:${article.id}`);
 }

Tambahan payload memastikan consumer downstream (cache updater, search builder) mendapat flag terbaru. Langkah kedua memanggil cache invalidation secara eksplisit dengan key spesifik.

Pada service cache, harus memetakan payload ke schema cache agar flag tidak hilang:

cache.set(`article:${payload.id}`, {
  title: payload.title,
  aiGenerated: payload.aiGenerated || false,
  updatedAt: payload.publishedAt,
});

Perhatikan default false untuk menghindari undefined.

Mitigasi jangka panjang

Selanjutnya, pastikan:

  • Schema contract: Flag baru wajib terdaftar di protobuf/GraphQL schema untuk semua service.
  • Contract testing: Automated test memvalidasi bahwa update article selalu menyertakan metadata flag.
  • Cache warming: Saat publikasi article baru, consumer cache memuat ulang data langsung walaupun belum ada permintaan dari UI.
  • Monitoring: Tambahkan alert ketika data flag di cache berbeda dengan database lebih dari threshold.

Alternatif lain adalah menyatukan pembacaan metadata langsung dari database untuk elemen yang kritikal, sehingga cache tidak menjadi sumber kebenaran untuk flag.

Checklist regression testing

Untuk mencegah regresi, jalankan checklist ini di pipeline QA/CI:

  1. Lakukan publish artikel dengan isAIGenerated=true lewat API publik dan verifikasi response mengandung flag.
  2. Periksa bahwa event queue memuat flag dalam payload article.update.
  3. Verifikasi cache invalidation membawa value terbaru melalui debug log dan data pada cache store.
  4. Uji UI CMS membaca flag secara konsisten setelah refresh tanpa menunggu cache expiry.
  5. Pastikan hook Analytics turut mengirimkan metadata terbaru jika digunakan untuk label.

Checklist ini membantu memastikan perbaikan tidak merusak pipeline lain dan flag tetap konsisten dari publish hingga tampilan editor.