Alur Media Harvester & Auto-Enrichment Foto Produk (media:harvest) ​

Perintah media:harvest adalah mesin pengayaan media otomatis (Automated Media Enrichment Engine) yang bertugas mencari, memvalidasi, mengunduh, dan mengonversi foto hero resmi pabrikan untuk melengkapi ulasan review-first di website CuanAff Anda.

Setelah Anda menemukan calon produk lewat catalog:discover dan menyetujuinya lewat catalog:approve, media:harvest memastikan setiap produk ulasan memiliki visual asli beresolusi tinggi yang tajam, ringan, dan siap tayang ke pembeli.

⚡ Fungsi Cepat & Nilai Tambah ​

Keunggulan Utama Media Harvester CuanAff

  • 100% Foto Resmi Pabrikan: Hanya mengambil foto produk asli dari kanal resmi produsen dan toko resmi terverifikasi. Sistem menolak keras gambar palsu (zero synthetic mock card).
  • Konversi Otomatis Ringan & Cepat: Menyimpan foto dalam format lokal yang dioptimasi WebP/JPEG berukuran hemat (<100 KB) untuk skor Google PageSpeed 95+ dan muat instan di smartphone.
  • Bebas Risiko Hotlink: Semua foto disimpan mandiri di folder lokal situs Anda (media/products/<slug>/). Tidak ada risiko gambar hilang atau rusak akibat broken hotlink dari server luar.
  • Sanitasi Nama Berkas URL-Safe: Nama berkas dibersihkan otomatis menggunakan standar kebab-case bersih tanpa karakter spasi atau simbol marketplace yang membingungkan server web.
  • Perlindungan Idempotensi: Produk yang sudah memiliki foto valid tidak akan diunduh ulang secara sia-sia, menghemat kuota internet dan waktu proses Anda.

🔄 Alur Kerja: Siklus Hidup Review-First Media Harvester ​

Media Harvester dirancang sebagai pilar penutup yang menyempurnakan siklus hidup kurasi produk berbasis Review-First:

Langkah 1
Eksplorasi Calon
Temukan kandidat produk di niche pilihan via catalog:discover.
→
Langkah 2
Persetujuan Kurator
Pindahkan produk pilihan ke katalog kanonik via catalog:approve.
→
Langkah 3
Ulasan E-E-A-T
Sematkan impresi dan pengalaman nyata kurator via product:review.
→
Langkah 4
Auto-Enrichment Foto
Unduh dan optimasi visual hero resmi berkualitas tinggi via media:harvest.
→
Langkah 5
Publikasi Situs
Validasi mutu katalog lalu terbitkan website online via site:publish.
  1. Langkah 1 — Temukan: Jalankan catalog:discover untuk menemukan kandidat produk di niche pilihan Anda.
  2. Langkah 2 — Setujui: Gunakan catalog:approve untuk memindahkan calon terpilih ke dalam katalog website Anda.
  3. Langkah 3 — Ulas: Tambahkan impresi kurasi manusia berstandar Google E-E-A-T dengan product:review.
  4. Langkah 4 — Perkaryakan Visual: Eksekusi media:harvest untuk melengkapi produk dengan foto hero resmi pabrikan beresolusi tinggi.
  5. Langkah 5 — Terbitkan: Verifikasi katalog Anda dengan catalog:validate, lalu luncurkan website dengan site:publish.

⚙️ Detail Teknis Engine Media Harvester ​

Media Harvester CuanAff dilengkapi dengan 5 lapis perlindungan kualitas tingkat tinggi untuk menjaga integritas tampilan website Anda:

1. Konversi Format WebP Ringan (<100 KB)

Gambar yang diunduh diuji resolusi dan ukurannya. Engine memprioritaskan aset berbobot hemat di bawah 100 KB dengan kompresi visual optimal, sehingga halaman ulasan Anda terbuka seketika tanpa membebani kuota data pembeli di perangkat mobile.

2. Sanitasi Nama Berkas Kebab-Case Bersih

Judul produk dari marketplace sering kali dipenuhi kata kunci spam (contoh: [PROMO CUCI GUDANG!!] Koper 20" Murah Berkualitas / Asli). Engine membersihkan seluruh label promosi, mengisolasi nama model asli, dan menyimpan berkas foto secara rapi dalam folder media/products/<slug>/hero.<ext>.

3. Detektor Gambar Rusak & Mock Card Sintetis

CuanAff memiliki sensor pendeteksi internal yang secara otomatis menolak:

  • Gambar pelacak berukuran 1x1 piksel.
  • Berkas rusak atau berbobot terlalu kecil (<10 KB).
  • Gambar beresolusi rendah (sisi terpanjang <800 px).
  • Gambar spanduk atau banner horizontal ekstrem (rasio aspek > 8.0).
  • Kartu sintetis palsu (synthetic GD mock card) berlabel watermark template.

4. Strategi Pencarian Multi-Tier & Fallback CDN

Jika halaman utama pabrikan memblokir akses bot otomatis (HTTP 403 Forbidden), Media Harvester menjalankan strategi pencarian bertingkat:

  • Tier 0 (Peer Network Sharing): Memeriksa apakah foto resmi produk yang sama sudah pernah diunduh di salah satu situs jaringan Delanja Network. Jika ada, sistem langsung menyalinnya tanpa menggunakan bandwidth internet tambahan.
  • Tier 1 (Bing Images Async Search): Melakukan pencarian terarah menggunakan kombinasi kata kunci Brand + Nama Model + Kategori pada indeks mesin pencari.
  • Tier 2 (Official Page & CDN Fallback): Mengambil gambar dari tag og:image atau <img> pada URL rujukan resmi pabrikan yang tercatat pada berkas spesifikasi produk.

5. Rekaman Celah Jujur (Zero Fake Data)

Jika seluruh kandidat foto gagal diverifikasi, CuanAff tidak akan pernah mengarang gambar palsu. Produk akan dicatat secara transparan dengan status hero_status: missing. Anda dapat melengkapi URL sumber secara manual atau menjalankan ulang pencarian di kemudian hari.

🛠️ Jalur A: Perintah CLI (media:harvest) ​

Jalankan perintah Media Harvester langsung di terminal komputer Anda:

bash
php cuanaff media:harvest [site] [niche] [opsi]

(Catatan: Anda juga dapat menggunakan perintah alias bawaan php cuanaff product:media dengan fungsionalitas yang identik).

Opsi Perintah Lengkap: ​

Ringkasan Opsi CLI Media Harvester

  • [site]: Slug situs target (contoh: tas, aman, pilihlistrik). Jika dikosongkan, sistem memakai situs yang sedang aktif.
  • [niche]: Kategori atau filter niche spesifik (opsional).
  • --slug=<slug-produk>: Menargetkan satu produk tertentu secara spesifik.
  • --missing: (Bawaan batch) Hanya mencari foto untuk produk yang belum memiliki foto hero valid di disk.
  • --all: Memindai seluruh katalog produk pada situs target.
  • --dry-run: Simulasi pencarian dan pengujian foto tanpa menulis berkas fisik ke disk.
  • --force-reharvest: Mengabaikan foto yang sudah ada dan memaksa unduh ulang dari awal.
  • --limit=<angka>: Membatasi jumlah maksimal produk yang diproses dalam satu sesi batch.
  • --json: Menghasilkan keluaran JSON terstruktur untuk kebutuhan otomasi skrip.

Contoh Praktis Penggunaan CLI: ​

bash
# 1. Pindai dan lengkapi foto semua produk yang belum punya gambar di situs 'tas'
php cuanaff media:harvest tas

# 2. Unduh foto untuk satu produk spesifik
php cuanaff media:harvest tas --slug=lojel-cubo-small-21-inch

# 3. Simulasi pencarian aman tanpa menyimpan file ke komputer (--dry-run)
php cuanaff media:harvest tas --dry-run

# 4. Paksa unduh ulang foto untuk produk tertentu yang ingin diganti gambarnya
php cuanaff media:harvest tas --slug=baller-all-aluminium-20-inch --force-reharvest

# 5. Batasi pemrosesan maksimal 5 produk dalam satu kali jalan
php cuanaff media:harvest tas --limit=5

# 6. Jalankan pada situs aktif saat ini tanpa menyebutkan nama situs
php cuanaff media:harvest --missing

Pratinjau Output Terminal: ​

txt
================================================================================
           BATCH SWEEPER FOTO PRODUK (MEDIA HELPER DELANJA)                     
================================================================================
  Situs      : tas
  Mode       : Missing only (--missing)
  Total File : 18
  Target Scan: 3

  [1/3] Memproses: Lojel Cubo Small 21 Inch (lojel-cubo-small-21-inch)
        -> Foto resmi ditemukan: 1200x800 px (86 KB, image/jpeg)
        -> Disimpan ke: media/products/lojel-cubo-small-21-inch/hero.jpg
        -> Front-matter media[] berhasil diperbarui.

  [2/3] Memproses: Baller All Aluminium 20 Inch (baller-all-aluminium-20-inch)
        -> Mengambil dari peer network cache (delanja.com)
        -> Foto tersalin sempurna.

Ringkasan Batch Sweeper:
  - Diproses  : 3
  - Berhasil  : 3
  - Tersimpan : 15
  - Kosong    : 0

Batch media sweep completed for site tas: 3 processed, 3 succeeded, 15 kept, 0 missing.

🤖 Jalur B: Template Prompt Asisten AI Siap Salin ​

Bagi praktisi pemula yang tidak terbiasa menghafal perintah terminal, gunakan asisten koding AI favorit Anda (Antigravity, CommandCode, Cursor, OpenCode) atau web chat AI (ChatGPT, Claude) untuk mengeksekusi pengayaan foto secara otomatis.

Mengapa Meminta Bantuan Asisten AI?

Asisten AI dapat menjalankan perintah media:harvest, memeriksa apakah resolusi gambar memenuhi standar >800 px, dan secara otomatis memberikan saran URL alternatif apabila ada produk yang gagal menemukan foto resmi di internet.

Template 1: Pengayaan Foto Borongan untuk Seluruh Katalog yang Kosong ​

Salin & Tempel ke Asisten AI Anda

text
Halo AI, tolong bantu saya melengkapi foto produk resmi untuk website CuanAff.

Target Operasi:
- Situs: tas (atau situs aktif saya saat ini)
- Target: Seluruh produk ulasan yang belum memiliki foto hero

Tolong jalankan langkah-langkah berikut:
1. Eksekusi simulasi terlebih dahulu di terminal lokal:
   php cuanaff media:harvest tas --dry-run

2. Periksa produk mana saja yang terdeteksi belum memiliki foto resmi.
3. Jika simulasi aman dan kandidat gambar valid, jalankan proses pengunduhan nyata:
   php cuanaff media:harvest tas

4. Laporkan ringkasan hasilnya kepada saya:
   - Berapa produk yang berhasil dilengkapi fotonya?
   - Apakah semua gambar beresolusi tajam (>800px) dan bebas gambar rusak?
   - Apakah ada produk yang berstatus 'missing' dan perlu dibantu dicari tautan resminya?

Template 2: Pengayaan Foto untuk 1 Produk Baru Setelah catalog:approve ​

Salin & Tempel ke Asisten AI Anda

text
Halo AI, saya baru saja menyetujui produk baru di CuanAff dengan slug:
[SEBUTKAN_SLUG_PRODUK, contoh: lojel-cubo-small-21-inch]

Tolong bantu saya:
1. Jalankan perintah unduh foto resmi pabrikan untuk produk tersebut:
   php cuanaff media:harvest --slug=lojel-cubo-small-21-inch

2. Periksa berkas markdown produk di data/tas/products/lojel-cubo-small-21-inch.md untuk memastikan bagian 'media[]' sudah terisi dengan path foto hero yang valid.
3. Jalankan validasi produk untuk memastikan integritas data:
   php cuanaff product:validate --slug=lojel-cubo-small-21-inch

📱 Desain Responsif & Standar Tampilan Mobile (390px) ​

Seluruh foto hero produk yang diproses melalui Media Harvester dioptimasi untuk menghasilkan pengalaman visual terbaik di layar smartphone (viewport standar 390px):

Standar Tampilan Visual Mobile CuanAff

  • 0px Horizontal Layout Overflow: Gambar disematkan dengan atribut max-width: 100%; height: auto; object-fit: cover; sehingga tidak akan pernah meluap atau membuat layar ponsel bergeser secara horizontal.
  • Pemuatan Asinkron & Lazy Loading: Seluruh kartu produk di-render dengan atribut HTML loading="lazy" dan decoding="async" untuk memastikan teks ulasan dapat dibaca seketika tanpa menunggu seluruh aset gambar selesai diunduh.
  • Dukungan Format WebP Modern: Kompatibel 100% dengan browser seluler modern (iOS Safari, Chrome Android, Samsung Internet) dengan penghematan data hingga 35% lebih efisien dibanding JPEG biasa.

❓ Pertanyaan Umum & Troubleshooting (FAQ) ​

Apa yang harus saya lakukan jika foto produk tercatat sebagai 'missing'?

Status missing terjadi jika mesin pencari tidak menemukan foto resmi beresolusi tajam (>800 px) atau jika situs resmi pabrikan dilindungi firewall ketat. Anda dapat mengatasinya dengan menambahkan URL halaman resmi produk secara manual menggunakan opsi --source:

bash
php cuanaff media:harvest tas --slug=nama-produk --source="https://website-resmi.com/produk-detail"
Apakah foto yang diunduh aman dari tuntutan hak cipta?

Ya. CuanAff mencatat atribut fair use ulasan produk independen pada metadata front matter (rights: "Hak cipta gambar milik Brand atau pemegang merek resmi"). Foto hanya digunakan sebagai identifikasi visual ulasan editorial, bukan untuk diklaim sebagai milik pribadi.

Bagaimana cara mengganti foto hero yang dirasa kurang pas?

Gunakan opsi --force-reharvest untuk memaksa sistem mengunduh ulang foto terbaru dan menimpa berkas lama:

bash
php cuanaff media:harvest tas --slug=nama-produk --force-reharvest

🔗 Tautan Terkait & Alur Selanjutnya ​

  • 🔎 catalog:discover — Cari calon produk ulasan berpotensi komisi tinggi.
  • ✅ catalog:approve — Setujui calon produk masuk ke antrean katalog resmi.
  • ✍️ product:review — Tambahkan opini ulasan berkendara dan penggunaan autentik (E-E-A-T).
  • 🛡️ catalog:validate — Uji kelayakan seluruh struktur katalog dan media sebelum perakitan.
  • 🚀 site:publish — Bangun dan terbitkan website affiliate Anda ke Cloudflare Pages.
  • 📖 Kamus Perintah CuanAff — Lembar contekan seluruh perintah operasional CuanAff.