12 KiB
| 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 |
|
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_basedi Odoo 18 lalu menyimpannya ke tabelproductCMS.
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:
- Static key di System Parameter
mito_base.api_key. Request dijalankan sebagai user dimito_base.api_user_id(sekarang Administrator 12, loginadmin). - 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) tanpadbfilter. 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_iddari/web/login?db=<ODOO_DB>, lalu mengirimnya bersama request API. Solusi yang benar: setdbfilter/db_namediodoo.conf, lalu kosongkanODOO_DBdi.envCMS.
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 lamaproduct_idsebagai kunci. Struktur tabelproductsama persis dengan production. |routes/console.php| JadwaldailyAt('01:00')Asia/Jakarta,withoutOverlapping(120), log kestorage/logs/odoo-sync-products.log| |config/services.php| Blokodoo→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_idselalu dibandingkan sebagai string Kolomnyavarchar. Kalau dibandingkan dengan angka, MySQL meng-cast nilai lama seperti'AF1'/'1233CF'→ errorTruncated incorrect DOUBLE value(sempat kejadian saat uji).
[!danger] Membuat produk manual di CMS tidak ada gunanya lagi Produk yang dibuat lewat Filament (tanpa
product_iddari 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, kodeFG - 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 migration000008(kolombrand_namedkk) — dijalankan dengan--pathkarenamigratebiasa gagal di server. Cron dipasang untuk userubuntu(user PHP-FPM), bukanwww-data. Langkah di bawah adalah rencana awal, dibiarkan sebagai referensi.
- 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> php artisan config:cache(tidak ada migration)- Uji:
php artisan odoo:sync-products --dry-run→ cek angkadeleted=(= jumlah produk lama yang akan di-soft delete) sebelum run sungguhan. Backup DB dulu. - 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 - Pantau
storage/logs/odoo-sync-products.logdanstorage/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) |