Dokumentasi/Referensi/Kontrak publikasi

Pahami aturan data yang tampil di QELAR.

Halaman ini menjelaskan data apa yang bisa tampil di QELAR, data apa yang tetap berada di area internal, dan aturan dasar yang dipakai saat sistem menampilkan halaman provider, bukti kerja, ulasan, perbandingan, dan output data publik lainnya.

Aturan publikasi

Di QELAR, aturan publikasi menentukan data mana yang boleh tampil di permukaan publik dan data mana yang tetap tinggal di area internal. Aturan ini dipakai saat sistem membangun halaman provider, halaman perbandingan, VIC, dan aset distribusi.

  • Data baru dianggap siap tayang jika status moderasi dan status publikasinya sudah memenuhi syarat.
  • Halaman publik hanya boleh mengambil data dari sumber yang sama dengan yang menjadi acuan data utama.
  • Data pendukung seperti VIC, sitemap, dan metadata tidak boleh mengklaim lebih dari yang tampil di halaman publik.
  • Bukti kerja yang masuk ke VIC harus memenuhi syarat tambahan: `isPublic=true`, `submissionStatus=approved`, dan `verificationStatus` termasuk `client_confirmed`, `manually_verified`, atau `ai_extracted`.

Model data utama

Empat kelompok data utama yang menopang QELAR adalah provider, bukti kerja, ulasan, dan kategori layanan. Keempatnya saling terhubung dan dipakai ulang di halaman publik, halaman dashboard, pencarian, perbandingan, dan output data.

  • `providers` menyimpan identitas bisnis, slug publik, deskripsi, lokasi, kapabilitas, rating, trust level, dan `publishedAt`.
  • `project_proofs` menyimpan bukti kerja seperti judul proyek, kategori, hasil kerja, status verifikasi, status publikasi, dan penanda `isPublic`.
  • `reviews` menyimpan ulasan, rating, status moderasi, dan kaitannya dengan provider atau bukti kerja tertentu.
  • `service_categories` menyimpan kelompok layanan, nama kategori, slug, status aktif, urutan tampil, dan relasi induk-anak.

Peran kategori layanan

Kategori layanan membantu buyer menjelajah direktori dengan lebih rapi dan membantu sistem membaca posisi tiap provider secara konsisten. Di QELAR, kategori memakai slug, nama, parent, dan urutan tampil yang tersimpan di `service_categories`.

  • Slug kategori dipakai ulang di profil provider, bukti kerja, ulasan, filter pencarian, dan halaman discovery programatik.
  • Relasi induk-anak membantu pembaca masuk dari kategori besar, lalu turun ke layanan yang lebih spesifik.
  • Hanya kategori yang aktif yang boleh ikut ke API publik dan halaman discovery programatik.
  • Kategori yang terlalu kabur membuat hasil discovery dan perbandingan sulit dipercaya.

Akses, verifikasi, dan batas tayang

Tidak semua data internal harus ditampilkan ke publik. Bagian ini menjelaskan batas antara data yang boleh tayang, data yang masih perlu moderasi, dan data yang butuh verifikasi lebih lanjut sebelum dipercaya sebagai sinyal publik.

  • Provider umumnya baru layak tayang jika `submissionStatus` sudah `approved` dan `publishedAt` sudah terisi.
  • Bukti kerja memiliki status verifikasi bertahap seperti `pending`, `client_confirmed`, `ai_extracted`, dan `manually_verified`.
  • Ulasan berstatus `approved` yang ikut memengaruhi rating publik dan juga dipakai saat menghitung trust score.
  • Route discovery programatik saat ini hanya mengambil provider yang sudah tayang dan memiliki trustLevel >= 1.
  • Verifikasi harus menguatkan bukti nyata, bukan hanya menambah label di tampilan.