Perintah: catalog:approve ​

Perintah catalog:approve adalah instrumen kedaulatan kurator manusia untuk memindahkan calon produk terpilih dari antrean kurasi (ReviewQueue) menjadi berkas produk markdown kanonik di katalog website Anda (data/<site>/products/<slug>.md). Seluruh metadata spesifikasi asli, estimasi harga pasar wajar, dan tautan rujukan toko resmi otomatis ditransfer tanpa Anda perlu mengetik ulang secara manual.

⚡ Fungsi Cepat ​

  • Persetujuan Cepat 1-Ketukan (--pick=1): Cukup sebutkan nomor urut calon dari hasil catalog:discover terakhir, sistem langsung memprosesnya menjadi produk katalog resmi.
  • Transformasi Otomatis ke Produk Markdown: Mengonversi data calon dan tautan merchant otomatis via authoring engine tanpa perlu repot mengetik manual spesifikasi teknis dan dimensi.
  • Kustomisasi Judul Produk SEO (--name): Memungkinkan kurator merapikan nama model jika judul bawaan toko marketplace terlalu panjang, berantakan, atau dipenuhi kata kunci spam.
  • Pencegahan Produk Duplikat (Idempotent Protection): Menjalankan ulang nomor atau ID yang sama tidak akan membuat produk ganda; sistem otomatis mengenali status calon yang telah disetujui.
  • Dukungan Status Draf Fleksibel (--draft): Menyimpan berkas dengan status draft bila Anda ingin menyunting ulasan personal secara santai sebelum dipajang ke publik.

🛠️ Jalur A: Perintah CLI ​

Jalankan perintah persetujuan produk di terminal komputer Anda:

bash
php cuanaff catalog:approve [--pick=<nomor> | --id=<kunci-identitas>] [--name="<Nama Baru>"] [--draft] [opsi]

Mode Interaktif Cerdas: ​

Jika Anda menjalankan perintah tanpa opsi --pick atau --id:

bash
php cuanaff catalog:approve

Sistem CuanAff akan membaca antrean calon produk yang masih menunggu keputusan (pending) pada kategori aktif dan menampilkan daftar bernomor:

txt
Calon yang mana?
  [1] Lojel Cubo Small 21 Inch
  [2] Baller All Aluminium 20 Inch
  [3] American Tourister Curio Spinner 55
 >

Anda cukup mengetikkan nomor pilihan Anda dan menekan tombol Enter.

Contoh Praktis Penggunaan: ​

bash
# 1. Menyetujui calon nomor urut 1 dari antrean kurasi terakhir
php cuanaff catalog:approve --pick=1

# 2. Menyetujui calon nomor 2 sambil merapikan nama produk agar ramah SEO
php cuanaff catalog:approve --pick=2 --name="Baller All Aluminium 20 Inch Cabin Luggage"

# 3. Menyetujui calon nomor 3 dan menyimpannya sebagai draf terlebih dahulu
php cuanaff catalog:approve --pick=3 --draft

# 4. Menyetujui secara presisi via kunci identitas unik (ideal untuk otomasi/skrip)
php cuanaff catalog:approve --id="shopee:223344:556677"

# 5. Menentukan situs dan kategori secara eksplisit jika memiliki banyak niche
php cuanaff catalog:approve --site="tas" --category="koper-kabin" --pick=1

# 6. Simulasi persetujuan tanpa menulis berkas fisik ke disk (--dry-run)
php cuanaff catalog:approve --pick=1 --dry-run

# 7. Format keluaran mesin JSON untuk integrasi pipeline
php cuanaff catalog:approve --pick=1 --json

Pratinjau Output Terminal: ​

txt
Selesai: Lojel Cubo Small 21 Inch
Produk: lojel-cubo-small-21-inch · Status: published

Rekomendasi langkah berikutnya:
  Periksa dengan: php cuanaff product:validate --slug=lojel-cubo-small-21-inch

🤖 Jalur B: Prompt AI Siap Salin ​

Anda dapat memanfaatkan asisten coding pintar (Antigravity, CommandCode, Cursor) atau web chat AI (ChatGPT, Claude) untuk menganalisis daftar antrean calon produk, menyempurnakan judul model agar menarik bagi pembeli, dan mengeksekusi persetujuan secara presisi.

Mengapa Merapikan Judul dengan --name Sangat Disarankan?

Judul produk di marketplace sering kali dipenuhi kata kunci pencarian yang tidak rapi (contoh: "KOPER KABIN 20 INCH TRAVEL TAS KOPER WANITA PRIA PROMO FREE ONGKIR"). Gunakan parameter --name saat mengeksekusi catalog:approve untuk menghasilkan judul yang elegan, profesional, dan nyaman dibaca pembeli (contoh: "Lojel Cubo Small 21 Inch").

Template Prompt AI Kurasi & Persetujuan Calon Produk: ​

Template Prompt AI (Tinggal Salin & Sesuaikan Nomor Calon)

text
Halo AI, saya telah menjalankan `catalog:discover` dan memiliki beberapa calon produk di antrean ReviewQueue.

Tolong bantu saya melakukan kurasi dan menyetujui calon terbaik ke katalog resmi CuanAff:
1. Periksa daftar antrean calon yang tersedia pada kategori aktif saat ini.
2. Analisis calon nomor urut [1]:
   - Rapikan nama modelnya agar bersih dari kata kunci spam toko (buang kata seperti "Murah", "Promo", "Grosir").
   - Pastikan nama memuat Nama Brand, Seri Model, dan Ukuran Kunci (misal: "Baller All Aluminium 20 Inch").
3. Eksekusi perintah persetujuan di terminal lokal dengan parameter nama yang telah dirapikan:
   php cuanaff catalog:approve --pick=1 --name="[Nama Model Rapi]"

4. Konfirmasikan bahwa berkas Markdown produk baru telah berhasil terbit di:
   data/<slug-situs>/products/<slug-produk>.md
5. Tampilkan ringkasan frontmatter (nama, brand, estimasi harga, kategori) yang telah terbentuk.

Eksekusi Sekali Perintah di Coding Agent

Coding agent seperti Antigravity dan CommandCode dapat memeriksa antrean produk, merumuskan nama model yang bersih secara otomatis, langsung mengeksekusi php cuanaff catalog:approve --pick=..., dan melaporkan slug produk markdown yang siap diberi ulasan personal.

⚙️ Parameter & Opsi Kunci ​

Berikut adalah seluruh opsi dan parameter yang dapat digunakan pada perintah catalog:approve:

Parameter / OpsiWajib?Keterangan & FungsiContoh Nilai
--pick=<nomor>Kondisional*Nomor urut calon produk dari hasil antrean catalog:discover terakhir (dimulai dari 1).--pick=1
--id="<kunci>"Kondisional*Kunci identitas antrean unik (format: shopee:<shop_id>:<item_id>). Ideal untuk otomasi.--id="shopee:112233:445566"
--name="<nama>"OpsionalMengganti judul produk dengan nama yang lebih rapi atau ramah SEO daripada judul asli toko.--name="Lojel Cubo Small 21 Inch"
--category="<slug>"OpsionalKategori target produk (otomatis terdeteksi jika hanya ada 1 kategori di situs).--category="koper-kabin"
--site="<slug>"OpsionalMenentukan nama situs target secara spesifik jika mengelola multi-situs.--site="tas"
--draftOpsionalMemaksa status berkas produk sebagai draft meskipun datanya lengkap.--draft
--dry-runOpsionalMenampilkan simulasi rencana persetujuan tanpa membuat berkas produk fisik di disk.--dry-run
--jsonOpsionalMenghasilkan respons terstruktur dalam format JSON untuk otomasi.--json
--data="<path>"OpsionalMenentukan direktori data kanonik jika menggunakan struktur folder khusus.--data="data"

*Catatan: Jika --pick maupun --id tidak diisi pada sesi terminal interaktif, CuanAff akan menampilkan prompt pilihan interaktif secara otomatis.

🔄 Transformasi Data: Dari Antrean ke Berkas Resmi ​

Ketika Anda menjalankan catalog:approve, CuanAff melakukan serangkaian transformasi data otomatis di balik layar:

Tahap 1
Calon di ReviewQueue
Data calon produk terpilih diambil dari antrean terisolasi dengan status awal pending.
→
Tahap 2
Sanitasi & Idempotensi
Pemeriksaan anti-duplikasi dan pembersihan slug nama produk secara aman.
→
Tahap 3
Pipeline & Plausibility
Validasi kelayakan harga (*Plausibility Gate*) dan ekstraksi merchant toko resmi.
→
Tahap 4
Penulisan Berkas Kanonik
Penerbitan berkas markdown resmi di data/<site>/products/<slug>.md.
→
Tahap 5
Pembaruan Status Antrean
Calon di antrean ditandai approved untuk mencegah duplikasi ganda di masa depan.
  1. Pengecekan Anti-Duplikasi (Idempotency Check):
    • Sistem memeriksa apakah kunci identitas produk sudah berstatus approved. Jika sudah ada, sistem mengembalikan pesan sukses aman: Already approved; no duplicate authored tanpa menimpa data yang telah ada.
  2. Penerusan ke Pipeline Authoring Resmi:
    • Calon produk diekstraksi tautan toko resminya, lalu dialirkan ke pipeline authoring standar CuanAff.
    • Uji kelayakan harga (Plausibility Gate) tetap ditegakkan untuk memastikan harga tidak nol atau tidak wajar.
  3. Penyusunan Berkas Markdown Kanonik:
    • Berkas dibuat di data/<site>/products/<slug>.md dengan struktur frontmatter lengkap (nama, brand, harga, tautan merchant, kategori) dan siap untuk dipublikasikan.

📱 Hasil Nyata di Website & Langkah Lanjutan ​

Setelah calon produk berhasil disetujui:

  1. Katalog Resmi Bertambah:
    • Produk baru terdaftar resmi di direktori ulasan website Anda dan siap tampil di kartu etalase kategori serta tabel komparasi.
  2. Langkah Penyempurnaan 4 Langkah:
    • Agar ulasan memenuhi standar Google E-E-A-T dan memikat hati calon pembeli, lengkapi produk dengan rangkaian perintah kurasi berikut:
      • Ulasan Personal: Jalankan product:review untuk menyematkan pengalaman pemakaian nyata.
        bash
        php cuanaff product:review lojel-cubo-small-21-inch --review="..."
      • Evaluasi Pro-Kontra: Jalankan product:enrich untuk melengkapi pros, cons, dan target persona pembeli.
        bash
        php cuanaff product:enrich --slug=lojel-cubo-small-21-inch --verdict="..."
      • Unduh Foto Resmi: Jalankan media:harvest (atau product:media) untuk mengunduh foto pabrikan resolusi tinggi WebP secara otomatis.
        bash
        php cuanaff media:harvest tas --slug=lojel-cubo-small-21-inch
      • Validasi Kualitas: Jalankan product:validate untuk memastikan integritas berkas produk 100% sempurna sebelum dipublikasikan.
        bash
        php cuanaff product:validate --slug=lojel-cubo-small-21-inch