Perintah: product:validate

Perintah product:validate adalah penjaga gerbang kualitas katalog website afiliasi Anda. Sebelum sebuah produk ditayangkan ke hadapan ribuan calon pembeli di internet, perintah ini memastikan bahwa spesifikasi produk sudah lengkap, gambar hero resmi tersedia, harga pasar tercatat wajar, dan tautan afiliasi mengarah ke tujuan yang tepat tanpa tautan rusak (broken links).

⚡ Fungsi Cepat

Deteksi Dini Kesalahan Data: Menangkap data produk yang belum lengkap, gambar yang hilang, atau link yang rusak sebelum calon pembeli melihatnya.
Perlindungan Reputasi & Kepercayaan: Memastikan website Anda tidak memajang halaman kosong dengan teks galat (error) atau harga jebakan yang dapat merusak kredibilitas situs.
Verifikasi Standar Skema Kanonik: Memastikan berkas Markdown produk mematuhi standar format CuanAff sehingga dapat dirakit mulus oleh mesin pembuat situs statis.
Mode Aman Murni Membaca (Read-Only): Perintah ini 100% aman dijalankan kapan saja karena hanya memeriksa dan membaca data tanpa pernah mengubah atau menghapus isi berkas Anda.

Perbedaan Kontras dengan catalog:validate

Perintah ini (product:validate) berfokus memeriksa kesiapan konten ulasan produk individual (foto hero, harga wajar, teks ulasan, link afiliasi). Jika Anda ingin memvalidasi integritas arsitektur situs secara menyeluruh (skema YAML, relasi penawaran harga toko/offers, dan berkas panduan belanja), gunakan perintah catalog:validate.

🛠️ Jalur A: Perintah CLI

Jalankan perintah validasi produk di terminal komputer Anda:

bash

php cuanaff product:validate [opsi-penyaring]

Contoh Praktis:

bash

# 1. Memvalidasi seluruh produk pada situs aktif
php cuanaff product:validate

# 2. Memvalidasi seluruh produk pada situs spesifik
php cuanaff product:validate --site=tas

# 3. Memvalidasi 1 produk tertentu yang baru ditambahkan
php cuanaff product:validate --site=tas --slug=baller-all-aluminium-20-inch

# 4. Memfilter pemeriksaan hanya untuk produk yang masih berstatus draft
php cuanaff product:validate --status=draft

# 5. Mengeluarkan laporan hasil validasi dalam format JSON
php cuanaff product:validate --json

Pratinjau Output Terminal (Hasil Lulus 100%):

txt

[VALIDASI] Memulai audit integritas katalog produk...
[SITUS] Situs target: tas (TasKu)
[PEMERIKSAAN] Memindai 15 berkas produk di data/tas/products/...
  - Skema Kanonik Frontmatter : 15/15 VALID
  - Keberadaan Foto Hero Resmi : 15/15 TERSEDIA (>800px)
  - Rentang Harga Pasar Wajar : 15/15 WAJAR (Lolos Plausibility Gate)
  - Tautan Toko & Afiliasi    : 15/15 LENGKAP
[HASIL] 100% PASS (0 error, 0 warning)
[REKOMENDASI] Katalog produk sempurna dan siap dipublikasikan ke internet publik.

Pratinjau Output Terminal (Jika Ditemukan Kesalahan):

txt

[PERINGATAN] Ditemukan 1 produk dengan data belum lengkap:
  - american-tourister-curio-spinner:
    * [MISSING_IMAGE] Foto hero resmi belum diunduh (Jalankan: php cuanaff media:harvest tas --slug=american-tourister-curio-spinner)
    * [STATUS_HOLD] Status produk ditahan sebagai draf hingga foto terpasang.

🤖 Jalur B: Prompt AI Siap Salin

Anda dapat meminta asisten coding pintar (Antigravity, CommandCode, Cursor) atau web AI (ChatGPT, Claude) untuk mengaudit kondisi katalog Anda, menganalisis baris yang belum lengkap, dan langsung memperbaikinya sebelum publikasi.

Template Prompt AI (Audit & Perbaikan Katalog Otomatis)

text

Halo AI, tolong bantu saya melakukan audit kualitas data produk di CuanAff untuk situs aktif saat ini.

Langkah kerja:
1. Jalankan perintah validasi di terminal:
   php cuanaff product:validate

2. Analisis output hasil validasi:
   - Jika 100% PASS, konfirmasikan bahwa seluruh katalog siap diterbitkan.
   - Jika terdapat error atau peringatan (misalnya foto belum ada, harga belum terisi, atau kategori salah), sebutkan produk mana saja yang bermasalah.

3. Jika ada produk bermasalah, tolong berikan rekomendasi solusi perbaikannya (misalnya menyarankan perintah media:harvest untuk unduh foto resmi atau product:enrich untuk melengkapi review).

Pemulihan Mandiri Bersama Coding Agent

Asisten coding seperti Antigravity dan CommandCode dapat membaca daftar error dari product:validate, lalu secara proaktif menjalankan perintah perbaikan yang sesuai (seperti mengunduh gambar yang hilang dengan media:harvest) hingga seluruh katalog lolos validasi 100%.

⚙️ Parameter & Opsi Kunci

Berikut adalah opsi dan filter yang tersedia pada perintah product:validate:

Parameter / Opsi	Wajib?	Keterangan & Fungsi	Contoh Nilai
`--site="<slug>"`	Opsional	Menentukan situs spesifik yang ingin divalidasi (bawaan: situs aktif).	`--site="tas"`
`--slug="<slug>"`	Opsional	Membatasi pemeriksaan hanya pada 1 produk (wajib menyertakan `--site`).	`--slug="baller-aluminium-20"`
`--status="<tipe>"`	Opsional	Menyaring produk berdasarkan status publikasi (`draft`, `published`, `archived`).	`--status=published`
`--niche="<slug>"`	Opsional	Menyaring produk berdasarkan kategori tema niche kanonik.	`--niche="tas"`
`--dry-run`	Opsional	Diterima untuk konsistensi CLI (perintah ini selalu bersifat baca).	`--dry-run`
`--json`	Opsional	Mengeluarkan rekap audit dalam format objek JSON terstruktur.	`--json`

📱 Hasil Nyata di Website

Setelah seluruh produk lolos pengujian product:validate:

Bebas Galat dan Tata Letak Sempurna:
- Tidak ada kartu produk yang bolong, gambar rusak (broken image icon), atau tulisan undefined di situs Anda.
Tombol Afiliasi Bekerja Sempurna:
- Setiap tautan belanja dipastikan mengarah ke merchant yang valid sehingga setiap klik pengunjung tercatat menghasilkan komisi.
Peringkat SEO Terlindungi:
- Mesin pencari Google memberikan skor kualitas tinggi pada website yang memiliki struktur data bersih, tautan yang valid, dan metadata yang lengkap.

Perintah: product:validate ​

⚡ Fungsi Cepat ​

🛠️ Jalur A: Perintah CLI ​

Contoh Praktis: ​

Pratinjau Output Terminal (Hasil Lulus 100%): ​

Pratinjau Output Terminal (Jika Ditemukan Kesalahan): ​

🤖 Jalur B: Prompt AI Siap Salin ​

⚙️ Parameter & Opsi Kunci ​

📱 Hasil Nyata di Website ​