Doc_chelvyn/Mito/Sfa/Integrasi/SFA CMS — Sync Master Produ...

12 KiB
Raw Blame History

judul proyek terkait stack kategori status tipe tags diperbarui
SFA CMS — Sync Master Product dari Odoo SFA CMS Mito · Odoo 18 · mito_base Laravel 11 · Filament 3 · Odoo 18 REST API (mito_base) Integrasi Ter-deploy di VPS (develop 8d5f815) 2026-10-06 — cron aktif dokumen-internal
sfa
cms
odoo
integrasi
scheduler
master-product
2026-10-06

Index: SFA — Index · Kategori: Integrasi

Implementasi sisi CMS untuk Mito - FDD - CMS - Master Product - Revised: scheduler Laravel yang menarik master product (finished good) dari API mito_base di Odoo 18 lalu menyimpannya ke tabel product CMS.

Sync Master Product Odoo → SFA-CMS

1. Ringkasan

Pola Pull, sesuai FDD. Scheduler ada di CMS, Odoo cukup menyediakan API
Sumber GET /api/v1/products dari modul mito_base (sudah ada, tidak dibuat API baru)
Server Odoo https://mitodev.sinerka.id = http://16.79.56.41:8069 (server yang sama)
Database Odoo MITO_PRODUCTION_20082026
Yang di-sync Hanya classification = finished_good → 639 produk (dari total 6.975 produk sale_ok)
Kunci Kolom lama product.product_id = id product.product Odoo. Tidak ada kolom/tabel baru
Data lama CMS Dihapus (soft delete) — master product sekarang murni dari Odoo
Jadwal Harian, jam 01:00 WIB (full sync)
Hasil uji lokal created=639 deleted=191 (191 produk lama), run berikutnya unchanged=639 deleted=0. Aktif = 639, semua FG - …, tanpa duplikat
cron tiap menit ──► php artisan schedule:run
                        │  (01:00 WIB)
                        ▼
                 php artisan odoo:sync-products
                        │  GET /api/v1/products?limit=200&offset=…
                        │  Authorization: Bearer <MITO_API_KEY>
                        ▼
                 Odoo 18 (mito_base) ──► 6.975 produk sale_ok
                        │
                        ▼  filter classification = finished_good (639)
                 tabel product CMS  (create / update / restore)
                        │  produk yang tidak ada di Odoo → soft delete
                        │
                        ▼
                 Filament /products  ·  Sales Order  ·  SFA Mobile

2. API Odoo yang Dipakai (mito_base)

Source: snk_mito/mito_odoo/mito/mito_base/controllers/api/ · Swagger: http://16.79.56.41:8069/api/v1/docs#/Products/get_api_v1_products

Auth. Header Authorization: Bearer <key>. Key dicek berurutan:

  1. Static key di System Parameter mito_base.api_key. Request dijalankan sebagai user di mito_base.api_user_id (sekarang Administrator 12, login admin).
  2. Fallback: Odoo API key bawaan milik user.

Format respons. JSON murni (bukan JSON-RPC):

{"success": true, "data": [ ... ], "meta": {"limit": 200, "offset": 0, "total": 6975}}

Parameter /products. limit (maks 200), offset, search, barcode, category_id, brand_id, warehouse_id, updated_since (UTC, untuk incremental). Domain dasarnya sale_ok = True dan hanya produk aktif.

[!warning] API tidak bisa dipanggil langsung tanpa memilih database Server Odoo ini punya 3 database (HO_MASTER_DATA_20260911_170725, MITO_PRODUCTION_20082026, MITO_PRODUCTION_20260918_230104) tanpa dbfilter. Request API polos dijawab:

{"success": false, "error": {"code": "no_database", "message": "Database not resolved (set db_name/dbfilter)"}}

Solusi sementara di CMS: client mengambil cookie session_id dari /web/login?db=<ODOO_DB>, lalu mengirimnya bersama request API. Solusi yang benar: set dbfilter / db_name di odoo.conf, lalu kosongkan ODOO_DB di .env CMS.


3. Yang Dibuat di Repo sfa-cms

File Isi
app/Services/OdooClient.php Client REST mito_base: Bearer token, pilih DB via session cookie, retry 3× saat koneksi gagal, paginate() otomatis per 200
app/Console/Commands/SyncOdooProducts.php Command odoo:sync-products: ambil → filter FG → mapping → create/update/restore/soft delete → log

[!note] Tidak ada migration / perubahan struktur tabel Sempat dibuat kolom odoo_product_id + odoo_synced_at, lalu dibatalkan (rollback + file migration dihapus): keputusan akhirnya pakai kolom lama product_id sebagai kunci. Struktur tabel product sama persis dengan production. | routes/console.php | Jadwal dailyAt('01:00') Asia/Jakarta, withoutOverlapping(120), log ke storage/logs/odoo-sync-products.log | | config/services.php | Blok odoo → url, db, api_key, timeout | | .env / .env.example | ODOO_URL, ODOO_DB, MITO_API_KEY |

Konfigurasi .env

ODOO_URL=https://mitodev.sinerka.id     # production di VPS yang sama: http://127.0.0.1:8069
ODOO_DB=MITO_PRODUCTION_20082026        # kosongkan kalau Odoo sudah pakai dbfilter/db_name
MITO_API_KEY=MITO_API_KEY               # = System Parameter mito_base.api_key (nilai dev)
# ODOO_TIMEOUT=60                       # opsional, detik

4. Mapping Field (mengisi kolom TBD di FDD §3.4)

FDD (logical) Odoo API CMS product Catatan
Product ID id product_id Kunci sync, disimpan sebagai string (kolom varchar(60))
SKU / Internal Ref default_code product_code Format FG - 000005. Kosong → produk di-skip + dicatat error
Product Name name product_name Prefix [FG - 000005] dibuang, maks 150 karakter
Product Type type product_type consu → ITEM, service → SERVICE
UOM uom.name uom_id + uom_code Cocok ke master uom (case-insensitive), dibuat baru kalau belum ada
Product Category category.name product_category_id + product_category Diambil segmen terakhir: INVENTORY / FG / AERO FAN → AERO FAN
— brand.name brand_id + brand_name Cocok ke master brands (MITO, MITOCHIBA, BREX)
— barcode barcode Maks 20 karakter
— list_price price
Product Status (active) deleted_at Lihat §5
Last Updated write_date updated_at Ter-update otomatis hanya kalau ada field yang berubah

Kolom yang tidak disentuh sync: tax, discount_pct, discount_amount, product_image, additional_information, variant_code, product_classification*.


5. Aturan Sync

Kondisi Aksi CMS
product_id belum ada di CMS Create (kode diisi dari Odoo, number sequence PRODUCT tidak dipakai)
Sudah ada & ada field berubah Update
Sudah ada & tidak ada perubahan Dilewati (unchanged), tidak ada query write
Ada di CMS dalam keadaan soft-deleted & muncul lagi di Odoo Restore
Produk CMS yang tidak ada di hasil Odoo — data lama CMS, produk yang dibuat manual di Filament, FG yang di-archive / sale_ok dimatikan Soft delete, hanya saat full sync
Odoo mengembalikan 0 produk Soft delete dilewati (dianggap anomali, supaya master product tidak terhapus semua)
default_code kosong Skip + Log::warning, exit code FAILURE
Gagal ambil data dari Odoo Log::error, tidak ada data yang ditulis
Produk lama CMS (kode MSIFG...) Soft delete — hilang dari menu Product, tapi histori SO/packing/invoice/stok yang merujuk ke produk itu tetap utuh

Lookup master (uom/brand/kategori) dan produk existing di-prefetch sekali per run, jadi tidak ada query per produk.

[!warning] product_id selalu dibandingkan sebagai string Kolomnya varchar. Kalau dibandingkan dengan angka, MySQL meng-cast nilai lama seperti 'AF1' / '1233CF' → error Truncated incorrect DOUBLE value (sempat kejadian saat uji).

[!danger] Membuat produk manual di CMS tidak ada gunanya lagi Produk yang dibuat lewat Filament (tanpa product_id dari Odoo) akan ikut di-soft delete di full sync berikutnya. Semua produk baru harus dibuat di Odoo.


6. Cara Pakai

php artisan odoo:sync-products                                   # full sync (sama dengan jadwal)
php artisan odoo:sync-products --dry-run                         # ringkasan saja, tanpa menulis
php artisan odoo:sync-products --since="2026-10-01 00:00:00"     # incremental (UTC), tanpa soft delete
php artisan schedule:list                                        # cek jadwal
php artisan schedule:work                                        # jalankan scheduler di lokal (foreground)

Lihat hasilnya:

  • UI: http://127.0.0.1:8000/products → produk Odoo ada di atas, kode FG - 000xxx
  • SQL:
    SELECT product_id, product_code, product_name, brand_name, product_category, updated_at
    FROM product WHERE deleted_at IS NULL ORDER BY product_code;
    

7. Deploy ke VPS (/var/www/sfa_mito) — ✅ dilakukan 2026-10-06

[!success] Sudah di-deploy — log lengkap di SFA CMS — Deploy 2026-10-06 Dry-run di server: created=639 deleted=191 (semua produk lama CMS). Butuh migration 000008 (kolom brand_name dkk) — dijalankan dengan --path karena migrate biasa gagal di server. Cron dipasang untuk user ubuntu (user PHP-FPM), bukan www-data. Langkah di bawah adalah rencana awal, dibiarkan sebagai referensi.

  1. Isi .env:
    ODOO_URL=http://127.0.0.1:8069      # VPS yang sama → tidak lewat jaringan publik
    ODOO_DB=MITO_PRODUCTION_20082026
    MITO_API_KEY=<key production>
    
  2. php artisan config:cache (tidak ada migration)
  3. Uji: php artisan odoo:sync-products --dry-run → cek angka deleted= (= jumlah produk lama yang akan di-soft delete) sebelum run sungguhan. Backup DB dulu.
  4. Pasang cron untuk user web, tanpa ini jadwal tidak pernah jalan:
    sudo crontab -u ubuntu -e        # user PHP-FPM pool sfa_mito
    * * * * * cd /var/www/sfa_mito && php artisan schedule:run >> /dev/null 2>&1
    
  5. Pantau storage/logs/odoo-sync-products.log dan storage/logs/laravel.log (prefix [odoo:sync-products]).

8. Temuan & Catatan Terbuka

# Temuan Dampak / Saran
1 mito_base.api_key = MITO_API_KEY (placeholder) 🔴 Ganti string acak ≥32 karakter sebelum production
2 /web/database/list terbuka publik, nama 3 DB terlihat tanpa login 🔴 Set list_db = False + dbfilter di odoo.conf, blok /web/database/manager di nginx
3 Tidak ada dbfilter → API butuh akal-akalan session cookie Set db_name/dbfilter, lalu kosongkan ODOO_DB
4 API tidak punya filter classification CMS menarik 6.975 produk lalu membuang 6.336. Saran: tambah param classification di mito_base /products
5 API memakai active_test default → produk archived tidak ikut Archive hanya terdeteksi saat full sync (makanya jadwal = full harian)
6 Kategori CMS (SMALL APPLIANCES, …) ≠ kategori Odoo (INVENTORY / FG / …) Sync membuat 15 kategori baru di master product_category. Perlu keputusan: pakai kategori Odoo atau dibuat mapping
7 list_price semua FG = 0 di Odoo Harga di CMS ikut 0. Harga jual sebenarnya mungkin dari pricelist; perlu dikonfirmasi
8 Brand banyak yang kosong di Odoo (mis. FREEDOM speaker) brand_name NULL di CMS. Perlu dilengkapi di Odoo (snk_product_brand_id)
9 Ada FG duplikat di Odoo (mis. FG - 000640 … PINK DUPLICATE) Ikut ter-sync. Sebaiknya di-archive di Odoo
10 Produk lama CMS (MSIFG..., 191 aktif) tidak punya padanan di Odoo ✅ Diputuskan: dihapus (soft delete), master product murni dari Odoo
12 Menu Product di Filament masih bisa create/edit/import Perubahan manual akan tertimpa / ter-soft delete oleh sync. Saran: jadikan read-only
11 FDD langkah 9 "Send Data to SFA" Belum dikerjakan. SFA Mobile membaca tabel product yang sama lewat Node API, jadi kemungkinan tidak perlu push terpisah (perlu dipastikan)