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

231 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

---
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) |