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:
- Monitoring cron — inventaris seluruh job cron di server: root crontab,
/etc/crontab, dan/etc/cron.d/*. Dashboard menghitung kapan tiap job dijalankan berikutnya dan apakah job itu sehat, berdasarkan jadwal yang benar-benar terpasang — bukan tebakan dari nama perintah. - Export process — status pipeline penarikan produk dari Instagram: berapa post yang ditarik, berapa yang jadi draft, berapa yang dilewati, dan draft mana yang masih menunggu review.
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.
- Sehat — job ada di crontab dan ada run dalam 24 jam terakhir.
- Tidak jalan 24 jam — job ada di crontab tapi tidak ada run dalam 24 jam. Job yang dijadwalkan jarang (harian/mingguan) dihitung dari frekuensi jadwalnya, bukan dari "tidak setiap jam".
- Belum pernah jalan — job terdaftar tapi belum ada satu pun run tercatat.
- Tidak aktif — job sudah tidak ada di crontab. Barisnya disimpan supaya riwayat lama tidak hilang.
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
- Tarik media Instagram lewat proxy CLI Composio (readonly).
- Dedupe berdasarkan
ig_media_id(unique index) — sisanya dilewati. - Unduh media ke penyimpanan permanen, konversi ke WebP (maks 1400 px, kualitas 82),
simpan di
assets/img/produk/katalog. - Buat produk berstatus
draft. Tidak ada produk yang terbit otomatis. - 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:
- Jumlah post — 1 sampai 200 post per jalannya.
- Dry run — menarik dan menganalisa tanpa menulis ke katalog.
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:
cron_jobs— inventaris job: jadwal, perintah, sumber, status aktif.cron_runs— satu baris per eksekusi cron yang tercatat di syslog.export_runs— satu baris per jalannya worker export.export_items— satu baris per media Instagram: keputusan dan alasannya.export_requests— antrean permintaan dari dashboard.export_settings— pengaturan export (misalnya template harga).admin_users— akun dashboard (terpisah dari akun admin toko).
7. Batasan & catatan
- Dashboard menampilkan status; dashboard tidak mem-posting ke Instagram dan tidak menerbitkan produk ke katalog secara otomatis.
- Health cron adalah heuristic lokal berbasis jadwal + syslog. Ini bukan verdict dari pihak ketiga, dan tidak tahu apakah job itu berhasil di luar (misalnya keluar dari cron tapi prosesnya menggantung).
- Riwayat run dibatasi pada apa yang ada di syslog server. Run yang sudah terrotasi keluar dari log tidak akan muncul.
- Semua import masuk sebagai
draft. Rasio draft→publish dihitung manual. - Tidak ada push katalog → Instagram pada tahap ini; ditunda sampai pull, staging, dan moderasi stabil.
- Kredensial database dibaca dari environment PHP-FPM
(
EXPORT_DB_*,EXPORT_SHOP_DB_*), tidak ada password di source.