Export Monitor valettashop.com

Dokumentasi Export Monitor

Dashboard export.valettashop.com — monitoring proses export Instagram → katalog Valettashop dan kesehatan cron di server.

1. Apa yang dipantau

Dashboard ini punya dua jalur data yang terpisah:

Kedua jalur membaca dari database export_monitor. Katalog toko dibaca read-only dari database valetta_shop.

2. Arsitektur

/www/wwwroot/export.valettashop.com/
  app/
    auth.php          login, sesi, CSRF
    cronlib.php       parser jadwal cron + hitung run berikutnya
    dashboard_data.php lapisan baca (cron, run, export, draft)
    db.php            koneksi DB dari environment
    ig.php            klien proxy Composio (Graph API Instagram)
    ig_images.php     unduh media -> WebP permanen
    ig_parser.php     parser caption -> field produk
    view.php          layout & helper render
  bin/
    collect-cron.php     inventaris cron + riwayat run dari syslog
    export-ig.php        worker export Instagram -> draft katalog
    process-queue.php    menjalankan permintaan dari dashboard
    test-cronlib.php     unit test parser cron
    test-real-crontab.php verifikasi parser vs crontab nyata
  public/
    index.php   ringkasan
    cron.php    monitoring cron
    export.php  export process
    login.php   login
    logout.php  logout
    docs.php    dokumen ini

Kenapa ada antrean (queue)?

PHP-FPM di server ini menonaktifkan exec(), jadi halaman web tidak bisa memanggil worker. Dashboard menulis permintaan ke tabel export_requests, lalu cron menjalankan bin/process-queue.php untuk mengeksekusinya. Klaim baris dilakukan dengan UPDATE ... WHERE status = 'pending' supaya dua worker tidak mengambil permintaan yang sama.

3. Definisi status cron

Health dihitung dari dua sumber: jadwal di crontab, dan jumlah run dalam 24 jam terakhir yang dibaca dari syslog.

Run berikutnya dihitung dengan parser cron 5-field yang sama dengan yang dipakai collector, sehingga definisi jadwal di dashboard dan di collector tidak berbeda.

4. Proses export

  1. Tarik media Instagram lewat proxy CLI Composio (readonly).
  2. Dedupe berdasarkan ig_media_id (unique index) — sisanya dilewati.
  3. Unduh media ke penyimpanan permanen, konversi ke WebP (maks 1400 px, kualitas 82), simpan di assets/img/produk/ katalog.
  4. Buat produk berstatus draft. Tidak ada produk yang terbit otomatis.
  5. Admin 검토 manual, baru produk naik ke published.

Harga dan SKU

Caption Instagram tidak memuat harga maupun SKU — pada korpus 400 caption @valettashop, 0 caption punya harga dan 0 punya SKU. Karena itu harga diambil dari template admin per kategori/fabric, dan SKU dibuat berurutan oleh worker. Productname dan deskripsi diturunkan dari baris Bahan dan baris caption lainnya.

5. Cara memicu sinkron

Di halaman Export Process, tombol Sinkronkan Instagram dan Kumpulkan cron membuat baris permintaan. Opsi yang tersedia:

Permintaan diproses worker cron dalam ≤1 menit. Riwayat permintaan dan hasilnya ada di tabel Permintaan antrean.

6. Referensi data

Skema lengkap tiap tabel ada di halaman Referensi. Ringkasnya:

7. Batasan & catatan