--- judul: SFA CMS — Sync Master Product dari Odoo proyek: SFA CMS terkait: Mito · Odoo 18 · mito_base stack: Laravel 11 · Filament 3 · Odoo 18 REST API (mito_base) kategori: Integrasi status: Ter-deploy di VPS (develop 8d5f815) 2026-10-06 — cron aktif tipe: dokumen-internal tags: - sfa - cms - odoo - integrasi - scheduler - master-product diperbarui: 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 ▼ 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 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): ```json {"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=`, 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` ```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 ```bash 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: ```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`: ```env ODOO_URL=http://127.0.0.1:8069 # VPS yang sama → tidak lewat jaringan publik ODOO_DB=MITO_PRODUCTION_20082026 MITO_API_KEY= ``` 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**: ```bash 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) |