231 lines
12 KiB
Markdown
231 lines
12 KiB
Markdown
---
|
||
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 <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):
|
||
```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=<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`
|
||
|
||
```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=<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**:
|
||
```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) |
|