Doc_chelvyn/Mito/Sfa/Fitur/SFA — Revisi Reward MoM 22-...

613 lines
43 KiB
Markdown
Raw Normal View History

---
judul: SFA — Revisi Reward MoM 22-10-2026 (checklist)
proyek: SFA API · SFA CMS · mito_odoo
terkait: Mito · Odoo 18 · SFA Mobile
kategori: Fitur
status: 10 dari 10 selesai · revisi customer per baris produk ter-deploy dev 31-10-2026 · Odoo (Jobsheet) menunggu review senior · mobile Staff Dealer belum · mobile Staff Dealer belum
tipe: dokumen-internal
tags:
- sfa
- reward
- imei
- jobsheet
- mom
diperbarui: 2026-10-30
---
> Index: [[SFA — Index]] · Kategori: **Fitur** · Sumber: [[Fix sfa aftrer meet with mito]] (MoM 22-10-2026, HO Mito)
> Fitur induk: [[SFA — Reward]]
# SFA — Revisi Reward MoM 22-10-2026
**Cara baca dokumen ini**
| Pembaca | Bagian |
|---|---|
| Functional / PM / Mito | [Ringkasan](#Ringkasan) · [Checklist](#Checklist) · [Keputusan yang Dibutuhkan](#Keputusan%20yang%20Dibutuhkan) · [Info ke Tim Mobile](#Info%20ke%20Tim%20Mobile) |
| Developer / Senior | [Detail Teknis per Poin](#Detail%20Teknis%20per%20Poin) · [Commit & Status Deploy](#Commit%20&%20Status%20Deploy) · [Catatan Deploy](#Catatan%20Deploy) |
## Ringkasan
- **10 dari 10 poin selesai** dan teruji lokal. Sebagian sudah ter-deploy di dev, sisanya tinggal commit / deploy (lihat
[Commit & Status Deploy](#Commit%20&%20Status%20Deploy)).
- **Jobsheet (poin 8 & 9), 30-10-2026:** admin memilih nomor Jobsheet Odoo di Reward Program (tidak bisa typo), nomornya
ikut ke Vendor Bill claim sebagai **referensi teks** (field **Jobsheet No.**), tidak memotong budget Jobsheet.
1 claim = 1 bill (keputusan K1 & K2, usulan Oliver).
- **Mobile:** menu saldo / claim untuk Staff Dealer masih perlu disembunyikan tim mobile (API sudah menolak).
## Checklist
Legenda: ✅ selesai · 🟡 sebagian · ⬜ belum
| # | Poin MoM | Status | Hasil (bahasa bisnis) | Catatan teknis |
|---|---|---|---|---|
| 1 | IMEI hanya boleh discan 1 kali | ✅ | Satu IMEI hanya sekali dapat reward, **apa pun produknya**, termasuk yang saldonya sudah di-claim | Sebelumnya unik per IMEI + produk |
| 2 | IMEI yang bisa discan hanya yang sudah terjual | ✅ | IMEI yang masih ada stok / diretur tidak bisa discan | Odoo kirim `product_qty`; CMS hanya simpan IMEI `product_qty = 0` |
| 3 | Upload attachment tidak mandatory | ✅ | Nota boleh menyusul | `attachment` opsional di `POST /reward/imei`, susulan lewat `PUT /reward/imei/attachment` |
| 4 | Minimum claim reward Rp 500.000 | ✅ | Saldo di bawah Rp 500.000 tidak bisa di-claim; tombol Claim CMS disembunyikan | `422 BELOW_MIN_CLAIM`; `GET /reward/balance` kirim `min_claim_amount` & `claimable` |
| 5 | Reward bisa multi customer | ✅ | **Customer menempel di baris produk** (revisi Oliver 30-10-2026): produk yang sama boleh beberapa baris dengan nominal & customer berbeda. Baris tanpa customer = dealer lain | Dealer tidak tercakup baris mana pun → `NO_ACTIVE_REWARD`. Revisi ter-deploy dev 31-10-2026 (CMS `0da379f`, API `c6fc18a`) |
| 6 | Export & import | ✅ | Tombol **Import / Export** Excel di list Reward Program (program + produk + customer, 1 sheet). Bisa **centang program** lalu **Export terpilih** | Upsert; 1 baris error = semua ditolak |
| 7 | Take out effective from & to | ✅ | Periode reward ikut header program. Nominal boleh diubah, riwayat lama aman | Kolom DB tidak di-drop |
| 8 | Field nomor Jobsheet + format anti-typo | ✅ | Field **Jobsheet** di Reward Program: nomor **dipilih dari daftar Odoo** (status On Progress), bukan diketik → tidak mungkin typo. Ikut Export / Import Excel | Odoo `GET /api/v1/jobsheets` + CMS dropdown realtime. Teruji lokal, di-push (Odoo `bb955bd2`, CMS `54285e6`), **belum deploy** |
| 9 | Nomor Jobsheet ikut ke Vendor Bill Odoo | ✅ | Vendor Bill claim punya field **Jobsheet No.** berisi nomor Jobsheet program asal saldo (lebih dari satu dipisah koma). Murni referensi, budget Jobsheet tidak terpotong | `jobsheet_no` di `POST /api/v1/reward-bills`. Teruji lokal, di-push, **belum deploy** |
| 10 | Staff Dealer tidak boleh lihat reward balance | ✅ API · ⬜ Mobile | Staff hanya scan; reward masuk **saldo dealer** | API `403 STAFF_NOT_ALLOWED`. Mobile belum sembunyikan menu |
**Progress: 10 / 10 selesai** (poin 10 sisi mobile belum).
## Keputusan yang Dibutuhkan
| Kode | Pertanyaan | Kenapa penting | Opsi | Saran dev | Status |
|---|---|---|---|---|---|
| **K1** | Satu claim berisi reward dari **beberapa program** (= beberapa Jobsheet). Vendor Bill-nya bagaimana? | Claim selalu *full balance* lintas program | a) 1 bill per Jobsheet · b) claim dipisah per program · c) **1 bill per claim** | — | ✅ **Diputuskan 30-10-2026: 1 bill per claim** (seperti sekarang). Jobsheet lebih dari satu → ditulis semua, dipisah koma |
| **K2** | Jobsheet di Vendor Bill = **AP Form** (terhubung budget) atau **teks** saja? | AP Form → saat Finance post bill, budget Jobsheet terpotong & dicek cukup / tidak | a) AP Form (`snk_ap_form`) · b) **field teks "Jobsheet No."** | — | ✅ **Diputuskan 30-10-2026 (Oliver): teks referensi.** "1 jobsheet bisa banyak reward, inputan nomor jobsheet pure hanya untuk referensi di vendor bill" |
| K3 | Nominal reward **per customer × produk** (1 program, harga beda per dealer) | Sekarang nominal hanya per produk | a) customer di baris produk · b) tier dealer (Gold/Silver) | — | ✅ **Diputuskan 30-10-2026 (Oliver): a.** Customer nempel ke baris produk, tab Customer dihapus. Detail di [Poin 5](#Poin%205%20·%20Reward%20multi%20customer%20(customer%20per%20baris%20produk)) |
| K4 | IMEI yang **belum pernah masuk gudang** ikut terhitung "terjual" (`product_qty = 0`) | Celah: IMEI hasil generate sebelum GR bisa discan | Tambah syarat "pernah keluar lewat DO" | Tutup celah (1 query per halaman sync) | ⏳ Belum diputuskan |
| K5 | Nominal reward per IMEI masih terlihat Staff Dealer di riwayat pengajuan | Poin 10 hanya menyebut saldo | Sembunyikan / biarkan | — | ⏳ Belum diputuskan |
## Info ke Tim Mobile
- **Minimum claim:** tombol Claim pakai field `claimable` dari `GET /reward/balance`; pesan error pakai `BELOW_MIN_CLAIM`.
- **Staff Dealer:** sembunyikan menu saldo, riwayat ledger, claim, riwayat claim. Kalau tetap dipanggil → `403 STAFF_NOT_ALLOWED`.
Respon submit IMEI untuk staff **tidak punya** field `balance`.
- **Attachment:** opsional saat submit, bisa diunggah belakangan lewat `PUT /reward/imei/attachment`.
- **Scan:** gunakan `GET /reward/imei/check` sebelum memasukkan IMEI ke list (kode error di diagram di bawah).
## Alur Scan IMEI (setelah revisi)
Urutan cek sama di `GET /reward/imei/check` (saat scan, tanpa lock), `POST /reward/imei` (submit, di dalam transaksi
+ lock), dan input IMEI dari CMS (`RewardImeiSubmissionService::check`).
```mermaid
flowchart TD
A["Mobile scan IMEI"] --> B["GET /reward/imei/check"]
B --> C{"Ada di master IMEI CMS?<br/>(hanya product_qty = 0)"}
C -- "tidak (belum terjual / diretur / tidak ada)" --> E1["IMEI_NOT_FOUND"]
C -- "ya" --> D{"Sudah pernah dapat reward?<br/>(apa pun produknya)"}
D -- "ya" --> E2["IMEI_ALREADY_REWARDED"]
D -- "tidak" --> F{"Sedang menunggu approval?"}
F -- "ya" --> E3["IMEI_PENDING_APPROVAL"]
F -- "tidak" --> G{"product_qty = 0?"}
G -- "tidak" --> E4["IMEI_NOT_SOLD"]
G -- "ya" --> H{"Produk punya mapping<br/>reward ACTIVE hari ini?"}
H -- "tidak" --> E5["NO_ACTIVE_REWARD"]
H -- "ya" --> I["scannable = true<br/>masuk list mobile"]
I --> J["POST /reward/imei<br/>(attachment opsional)"]
J --> K["Pengajuan SUBMITTED<br/>menunggu approval CMS"]
K -- "approve CMS" --> L{"Saldo >= Rp 500.000?"}
L -- "tidak" --> E6["422 BELOW_MIN_CLAIM<br/>claimable = false"]
L -- "ya" --> N["Claim full balance<br/>→ Draft Vendor Bill Odoo"]
N --> M["+ Jobsheet No. di Vendor Bill<br/>(referensi)"]
classDef ok fill:#d1fae5,stroke:#059669,color:#064e3b
classDef err fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
classDef todo fill:#f3f4f6,stroke:#9ca3af,color:#374151,stroke-dasharray:4 3
class I,K,N,M ok
class E1,E2,E3,E4,E5,E6 err
```
Keterangan warna: hijau = lolos, merah = ditolak (kode error dari API).
> [!note] `IMEI_NOT_SOLD` sekarang jarang muncul
> Karena master IMEI CMS hanya berisi IMEI `product_qty = 0`, IMEI yang masih ada stok biasanya sudah ditolak di
> langkah pertama sebagai `IMEI_NOT_FOUND` ("IMEI tidak terdaftar"). `IMEI_NOT_SOLD` tetap dicek sebagai pengaman
> kalau data CMS belum ter-update.
---
## Detail Teknis per Poin
### Poin 1–3 · Sync stok IMEI Odoo → CMS
- **Odoo** `GET /api/v1/imeis` mengirim `product_qty` (`stock.lot.product_qty`, stok di lokasi internal).
`updated_since` ikut menangkap perubahan stok lewat `write_date` quant, karena DO / retur tidak mengubah
`write_date` IMEI.
- **CMS** `odoo:sync-imeis`:
- IMEI dengan `product_qty` NULL / bukan 0 **tidak disimpan**; kalau sudah ada → soft delete (statistik `removed=`).
- Incremental (tiap 5 menit) tetap menarik semua IMEI yang berubah, supaya IMEI yang **diretur** langsung terbuang.
- Akhir full cycle membuang sisa IMEI NULL / bukan 0, tidak bergantung error mapping product.
- Kolom **Stok Odoo** di list IMEI CMS, label "Terjual" untuk stok 0.
**Celah yang diketahui (K4):** `product_qty = 0` juga berlaku untuk IMEI yang **belum pernah masuk gudang**
(di-generate sebelum GR). Opsi penutup: syarat tambahan "pernah keluar lewat DO" — `stock.move.line` done dengan
`picking_code = 'outgoing'` (logika yang sama dengan smart button **Transfers** di Lot/Serial Odoo), dicek 1 query
per halaman sync.
### Poin 4 · Minimum claim Rp 500.000
- Konstanta `MIN_CLAIM_AMOUNT = 500000` di Node (`routes/helpers/enums/reward.js`) dan CMS
(`RewardClaimService::MIN_CLAIM_AMOUNT`) — **ubah dua-duanya** kalau nominal berubah.
- Urutan cek claim: saldo `<= 0` → `BALANCE_EMPTY`, saldo `< 500.000` → `BELOW_MIN_CLAIM`, nominal beda → `BALANCE_CHANGED`.
- `GET /reward/balance` tambah `min_claim_amount`; `claimable` jadi `balance >= min_claim_amount`.
Hasil uji lokal 28-10-2026 (user 445, data dikembalikan setelah tes):
| Saldo | Mobile `claimable` / `POST /reward/claim` | CMS tombol Claim / `claimFullBalance` |
|---|---|---|
| Rp 50.000 | `false` / 422 `BELOW_MIN_CLAIM` | hilang / ditolak |
| Rp 499.999,99 | `false` / 422 `BELOW_MIN_CLAIM` | hilang / ditolak |
| Rp 500.000 | `true` / claim berhasil, saldo jadi 0 | tampil / claim berhasil |
### Poin 5 · Reward multi customer (customer per baris produk)
**Revisi 30-10-2026 (Oliver):** "harusnya customer nempel ke productnya, jadi ga bikin tab baru … biar bisa ada product
yg sama, tapi nominalnya beda … jadi 1 lines". Customer per baris = **many2one** (1 customer per baris, kolom
`reward_product_mapping.user_id`), dikonfirmasi 31-10-2026. Versi pertama (29-10-2026, `609ed39`) memakai tab
**Customer** di level program — diganti oleh versi ini.
Contoh Oliver (customer A, B, C dapat 10.000; D, E dapat 15.000 → 1 baris per customer):
| Reward 1 · Produk | Nominal | Customer |
|---|---|---|
| Product A | 10.000 | A |
| Product A | 10.000 | B |
| Product A | 10.000 | C |
| Product A | 15.000 | D |
| Product A | 15.000 | E |
| Product A | 12.000 | *(kosong = dealer lain, opsional)* |
Dealer D / E scan IMEI Product A → reward **15.000**; dealer A / B / C → **10.000**.
**Aturan (disepakati 30-10-2026):**
| # | Aturan |
|---|---|
| 1 | Baris **tanpa customer** = berlaku untuk dealer yang **tidak disebut** di baris lain produk yang sama. Tidak ada baris kosong → dealer lain tidak dapat reward produk itu |
| 2 | Produk sama di **program yang sama**: 1 dealer hanya 1 baris; baris tanpa customer maksimal satu |
| 3 | Produk sama di **program lain** yang periodenya beririsan (bukan ENDED): bentrok kalau customer-nya sama, atau salah satu baris tanpa customer (= semua dealer) |
| 4 | Customer = **akun dealer** (`users` EXTERNAL, APPROVED, bukan Staff Dealer). Scan Staff Dealer dihitung untuk dealer-nya |
| 5 | Data tab Customer lama dipindah ke baris: tiap baris produk program itu diisi customer pertama, lalu diduplikasi untuk customer berikutnya (perilaku tetap sama) |
```mermaid
flowchart TD
A["Scan IMEI mobile / input IMEI CMS"] --> B["Pemilik saldo<br/>(dealer; scan Staff Dealer → dealer-nya)"]
B --> C{"Ada baris produk IMEI ACTIVE<br/>di program ACTIVE & periode hari ini?"}
C -- "tidak" --> E1["NO_ACTIVE_REWARD"]
C -- "ya" --> D{"Ada baris dengan<br/>customer = dealer ini?"}
D -- "ya" --> F["Reward = nominal baris itu<br/>(mis. D → 15.000)"]
D -- "tidak" --> G{"Ada baris tanpa customer?"}
G -- "ya" --> H["Reward = nominal baris tanpa customer"]
G -- "tidak" --> E2["Mobile: NO_ACTIVE_REWARD<br/>CMS: Produk … tidak sedang mendapat reward /<br/>Reward program ini tidak berlaku untuk customer tersebut."]
F --> I["Nominal di-snapshot ke line pengajuan"]
H --> I
classDef ok fill:#d1fae5,stroke:#059669,color:#064e3b
classDef err fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
class F,H,I ok
class E1,E2 err
```
Keterangan warna: hijau = dapat reward, merah = ditolak (kode / pesan error persis dari API & CMS).
**Yang dibuat (revisi 30/31-10-2026, CMS `0da379f`, API `c6fc18a`, ter-deploy dev 31-10-2026):**
| Bagian | Isi |
|---|---|
| Migration `2026_10_31_000001_add_user_id_to_reward_product_mapping_table` | Kolom `reward_product_mapping.user_id` (nullable) + index (`product_id`, `user_id`). Pindah data `reward_program_customer` → baris (aturan 5). Idempotent (`hasColumn`; program yang barisnya sudah punya `user_id` dilewati). Tabel lama **tidak di-drop** (API lama masih membacanya sampai ikut ter-deploy) |
| Form baris produk (`ProductMappingsRelationManager`) | Field **Customer** (1 dealer, opsional, hanya akun dealer — dicek ulang di server). Kolom **Customer** di tabel (kosong tampil "Semua dealer"), urut per produk |
| `RewardMappingOverlap` (baru) | Aturan bentrok 2 & 3, dipakai form dan import |
| Tab **Customer** di program | **Dihapus** (`CustomersRelationManager`) |
| `RewardProductMapping::customer()`, scope `appliesToUser()` | Relasi many2one + filter baris "`user_id` kosong atau = user ini" |
| `RewardProgram::appliesToUser()` | Program berlaku kalau punya baris ACTIVE untuk user ini (dipakai pilihan program di input IMEI CMS) |
| CMS `findActiveMapping`, Node `findActiveMappings` (+ field `user_id` di model Node) | Urutan pilih: baris customer = dealer ini → baris tanpa customer → mapping terbaru |
| `User::scopeRewardDealer()` | Query akun dealer (pindahan dari tab Customer) |
Hasil uji lokal 30-10-2026 (data tes dihapus / di-rollback):
| Skenario | Hasil |
|---|---|
| Produk `MX - 003`: 10.000 [443], 15.000 [445], 12.000 tanpa customer | CMS & Node: 443 → 10.000, 444 → 12.000, 445 → 15.000 |
| Baris tanpa customer di-INACTIVE-kan | 444 → CMS "tidak sedang mendapat reward", Node `NO_ACTIVE_REWARD`; program tidak muncul di pilihan input IMEI CMS untuk 444 |
| Form: produk sama, customer beda | Tersimpan |
| Form: dealer sudah punya baris produk sama | Ditolak "Dealer TEST REGISTRASI sudah punya baris produk ini di program ini. Satu dealer hanya boleh satu baris per produk." |
| Form: baris tanpa customer kedua | Ditolak "Produk ini sudah punya baris untuk semua dealer (tanpa customer) di program ini." |
| Form: program lain periode beririsan, program pertama punya baris tanpa customer | Ditolak "Produk ini sudah aktif di program TMP-F1 (…) untuk semua dealer." |
| Form: periode tidak beririsan | Tersimpan |
| Form: user internal dipilih | Ditolak "Hanya akun dealer (EXTERNAL, APPROVED, bukan staff) yang bisa dipilih." |
| Halaman List / Edit Reward Program, tabel baris produk, form input IMEI CMS | Render OK, tab Customer sudah tidak ada |
| Migration lokal | Program #1 (customer lama [443, 445], 6 baris produk) → 6 baris `user_id` 443 + 6 baris `user_id` 445; `up()` dijalankan ulang → tetap 12 (tidak dobel) |
> [!info] Deploy
> CMS dulu (`php artisan migrate --path=database/migrations/2026_10_31_000001_add_user_id_to_reward_product_mapping_table.php`),
> **baru** restart API — query Node baru membaca kolom `reward_product_mapping.user_id`. Setelah keduanya ter-deploy,
> `reward_program_customer` boleh di-drop lewat migration terpisah.
### Poin 6 · Export & Import Reward Program (Excel)
Tombol **Import** dan **Export** di halaman list Reward Program (`ListRewardPrograms`), logika di
`app/Services/RewardProgramExcelService.php`. Format **.xlsx** (OpenSpout), proses **sinkron** — bukan Import/Export
bawaan Filament, karena yang bawaan hanya baca CSV dan butuh queue worker (VPS hanya punya cron `schedule:run`).
**Format file** (file hasil Export = template Import) — **1 sheet**, 1 blok per program. Data program hanya di
baris pertama blok; **1 baris = 1 baris produk** (produk + nominal + 1 customer, kolom `customer_email`). Revisi
30-10-2026: customer pindah ke baris produk (sebelumnya kolom customer berjejer terpisah per program) — file format
lama ditolak dengan pesan untuk Export ulang.
| program_code | program_name | … | jobsheet_no | mapping_id | product_code | product_name | customer_email | customer_name | reward_amount | mapping_status |
|---|---|---|---|---|---|---|---|---|---|---|
| RWD-A | Program A | … | 001/NOV/2026/AREA | 12 | P-1 | … | a@… | A | 10000 | ACTIVE |
| | | | | 13 | P-1 | … | d@… | D | 15000 | ACTIVE |
| | | | | | P-2 | … | | | 20000 | ACTIVE |
| RWD-B | Program B | … | | 20 | P-1 | … | | | 10000 | INACTIVE |
Urutan kolom baris produk: **produk → customer → reward_amount** (permintaan 31-10-2026). Import membaca berdasarkan
nama header, jadi urutan kolom di file bebas.
Aturan:
- Export ikut filter / pencarian tabel yang sedang aktif.
- Import = **upsert, tidak menghapus baris**: program by `program_code`, baris produk by **`mapping_id`** (dari Export;
kosong = baris baru). Customer baris yang punya `mapping_id` **diganti** sesuai file. `mapping_id` harus milik program
& produk yang sama, tidak boleh dobel. Hapus baris tetap lewat form program.
- Baris dengan `program_code` = awal blok program baru; baris tanpa `program_code` = lanjutan program di atasnya.
Satu program cukup satu blok (program_code dobel ditolak). Kolom program di baris lanjutan harus kosong.
- `status` kosong = `DRAFT`, `mapping_status` kosong = `ACTIVE`, `claim_mode` hanya `FULL_BALANCE`.
`product_name` & `customer_name` hanya info, diabaikan saat import.
- Tanggal: cell tanggal Excel, `YYYY-MM-DD`, `DD/MM/YYYY`, atau `DD-MM-YYYY`. `end_date` kosong = tanpa batas.
- Mapping **baru** wajib produk aktif di master. Mapping **lama** tetap bisa di-update walau produknya sudah dihapus
(hilang dari sync Odoo), supaya file Export bisa di-Import balik.
- Aturan bentrok sama dengan form ([Poin 5](#Poin%205%20·%20Reward%20multi%20customer%20(customer%20per%20baris%20produk)) aturan 2 & 3) — dihitung dari kondisi
**setelah** import (antar baris file + data CMS, termasuk periode program lama yang digeser lewat file).
- Customer: **1 email per baris** (lebih dari satu → error "Buat baris baru untuk customer lain"), harus akun dealer
(EXTERNAL, APPROVED, bukan staff) — query sama dengan form baris produk.
- **1 baris error = tidak ada yang disimpan** (keputusan 30-10-2026). Notifikasi menampilkan maksimal 20 error per baris.
- Tombol Import hanya muncul untuk user dengan izin create + update Reward Program.
- **Export terpilih** (revisi 30-10-2026): centang program di kiri tabel → bulk action **Export terpilih** hanya
meng-export program yang dicentang. Tombol **Export** di header tetap meng-export semua sesuai filter.
- Kolom `jobsheet_no` di baris program — aturannya di [Poin 8–9](#Poin%208–9%20·%20Jobsheet%20Odoo%20→%20CMS%20→%20Vendor%20Bill).
#### Alur Import
```mermaid
flowchart TD
A["Upload .xlsx<br/>(Import di list Reward Program)"] --> B{"File bisa dibaca<br/>dan kolom template ada?"}
B -- "tidak" --> E1["Import dibatalkan<br/>(file tidak valid / kolom tidak ditemukan)"]
B -- "ya" --> C["Baca baris per blok program<br/>(program_code terisi = program baru,<br/>kosong = lanjutan program di atasnya)"]
C --> D["Validasi: data program, mapping_id milik program & produk,<br/>product_code, reward_amount >= 1, email = akun dealer,<br/>program / mapping_id / customer per baris tidak dobel"]
D --> F{"Ada error?"}
F -- "tidak" --> G["Cek bentrok baris ACTIVE<br/>(produk sama, periode beririsan,<br/>customer beririsan / tanpa customer)"]
G --> H{"Ada error?"}
F -- "ya" --> E2["Import dibatalkan,<br/>tidak ada data yang disimpan<br/>(daftar error per baris)"]
H -- "ya" --> E2
H -- "tidak" --> I["DB transaction:<br/>upsert program by program_code<br/>upsert baris by mapping_id (kosong = baru)<br/>customer baris = isi file"]
I --> J["Import selesai<br/>(jumlah program baru / update,<br/>baris produk baru / update)"]
classDef ok fill:#d1fae5,stroke:#059669,color:#064e3b
classDef err fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
class J ok
class E1,E2 err
```
Hijau = sukses, merah = ditolak.
Teruji lokal 30-10-2026 (semua di-rollback): export 1 sheet berbentuk blok; import program baru + mapping
ACTIVE/INACTIVE + customer; import ulang file yang sama (update, tidak dobel); round-trip Export → Import `RWD-OKT26`
(produk sudah terhapus); error validasi per baris (baris tanpa program, data program di baris lanjutan, program /
produk / customer dobel); bentrok antar baris file, bentrok dengan data CMS, periode tidak beririsan / INACTIVE lolos,
program lama di-ENDED lewat file lalu produknya dipakai program baru lolos, periode program lama digeser jadi bentrok
ditolak; tombol Import / Export lewat Livewire.
Teruji lokal revisi customer per baris 31-10-2026 (di-rollback): export 1 baris = 1 baris produk + 1 email customer;
import ulang file export → 3 update; ganti customer baris lewat `mapping_id` 443 → 444 → tersimpan; baris baru dengan
dealer yang sudah punya baris → "Baris 5 (TMP-F1, produk MX - 003): Dealer CV MAJU JAYA sudah punya baris produk ini di
program ini. … (bentrok dengan baris 3)"; 2 email di 1 baris → "customer_email hanya boleh 1 email per baris";
`mapping_id` tidak dikenal / file format lama → ditolak.
### Poin 7 · Hapus effective from & to di mapping produk
**Kenapa dulu ada:** FDD Reward §3.2 — supaya nominal bisa diganti di tengah program (mapping lama diberi
`effective_to`, buat mapping baru). Akibatnya dua lapis tanggal (header program + mapping) dan produk bisa "tidak
dapat reward" padahal programnya aktif.
**Kenapa aman dihapus:** nominal di-snapshot ke line pengajuan IMEI saat submit (`reward_amount`) dan EARN di ledger
memakai nilai line itu, jadi mengubah nominal mapping tidak mengubah reward yang sudah tercatat.
| Bagian | Sebelum | Sesudah |
|---|---|---|
| Form & tabel mapping CMS | Effective From / To | Produk, nominal, status saja |
| Cek reward aktif (CMS `findActiveMapping`, Node `findActiveMappings`) | Tanggal mapping **dan** tanggal program | Tanggal program saja |
| Aturan bentrok | 1 produk 1 mapping ACTIVE per tanggal mapping | 1 produk 1 mapping ACTIVE di program yang periodenya beririsan |
| Mapping sudah dipakai ledger | Produk + nominal + tanggal dikunci | Produk dikunci, **nominal boleh diedit** (berlaku untuk scan berikutnya) |
| Kolom DB `effective_from` / `effective_to` | Dipakai | **Tidak di-drop** (tanpa migrasi); `effective_from` diisi `start_date` program saat create karena NOT NULL |
Hasil uji lokal 28-10-2026 (Livewire + transaksi di-rollback, program `RWD-OKT26` 01–31 Okt 2026):
| # | Skenario | Hasil |
|---|---|---|
| 1 | Produk 1824, mapping `effective_to` 14 Okt sudah lewat, program masih aktif | Dulu `NO_ACTIVE_REWARD` → sekarang **lolos** (Node `checkImei` & cek IMEI CMS), Rp 10.000 |
| 2 | Tambah mapping produk baru dari CMS | OK, `effective_from` otomatis 01-10-2026 (= `start_date` program) |
| 3 | Tambah produk yang sudah ACTIVE di program yang sama | Ditolak: "Produk ini sudah punya mapping aktif di program RWD-OKT26 (01 Oct 2026 s/d 31 Oct 2026)…" |
| 4 | Edit nominal mapping yang sudah dipakai ledger 10.000 → 25.000 | OK, ledger lama tetap Rp 10.000 |
| 5 | Kolom "Effective" di tabel mapping | Sudah tidak ada |
> [!warning] Belum dicek: ubah tanggal header program
> Bentrok antar program hanya divalidasi saat simpan **mapping**. Kalau `start_date` / `end_date` program diubah
> sampai beririsan dengan program lain yang punya produk sama, tidak ada validasi — sistem memilih mapping terbaru.
### Poin 8–9 · Jobsheet Odoo → CMS → Vendor Bill
**Konsep:** nomor Jobsheet **tidak diketik** di CMS, tapi **dipilih** dari dropdown yang memanggil Odoo **realtime**
→ anti-typo tanpa perlu masking format.
**Keputusan teknis 30-10-2026 — tanpa tabel master jobsheet di CMS (tanpa cron sync):**
- Odoo sumber kebenaran; status Jobsheet (`done` / `cancel` / periode habis) langsung kelihatan, tidak basi menunggu cron.
- Setup Reward Program jarang (beberapa kali sebulan) → tidak perlu cron yang jalan terus.
- CMS cukup simpan **snapshot** `odoo_jobsheet_id` + `jobsheet_no` di `reward_program`, supaya list / export / histori
tetap tampil walau Odoo mati. Ketergantungan ke Odoo bukan risiko baru — claim → Vendor Bill memang sudah butuh Odoo.
**Keputusan bisnis 30-10-2026 (Oliver):** "1 jobsheet bisa banyak reward, inputan nomor jobsheet pure hanya untuk
referensi di vendor bill". Jadi Jobsheet **tidak** dihubungkan ke AP Form (`snk_ap_form`) dan **tidak** memotong budget
Jobsheet saat bill di-post. 1 claim tetap 1 bill.
**Yang dibuat (30-10-2026, Odoo `bb955bd2` di `cj/api`, CMS `54285e6` di `develop`, belum deploy):**
| Repo | Bagian | Isi |
|---|---|---|
| mito_odoo · `snk_jobsheet_operation` | `controllers/api_jobsheets.py` | `GET /api/v1/jobsheets` + `GET /api/v1/jobsheets/<id>` (lihat di bawah). Di modul jobsheet karena `mito_base` tidak depend ke modul ini; tetap pakai `api_route` `mito_base` → auth, format respons, Swagger tag **Jobsheet** |
| mito_odoo · `mito_base` | `account.move.snk_reward_jobsheet_ref` | Field Char **Jobsheet No.** (tracking). Tampil di form Vendor Bill di bawah Bill Reference, **hanya untuk bill hasil claim reward**, bisa diedit selama Draft |
| mito_odoo · `mito_base` | `POST /api/v1/reward-bills` | Body opsional `jobsheet_no` (string, tidak divalidasi), respons ikut `jobsheet_no`. Retry Claim ID sama → bill lama dikembalikan apa adanya |
| mito_odoo · `mito_base` | `__manifest__.py` | Version `18.0.1.0.5` (develop sudah `1.0.4`). Kolom baru dibuat otomatis oleh `-u`, tanpa migration script |
| sfa-cms | Migration `2026_10_30_000001_add_jobsheet_to_reward_program_table` | Kolom `reward_program.odoo_jobsheet_id` + `jobsheet_no` (snapshot nomor). Idempotent (`hasColumn`) |
| sfa-cms | Form Reward Program | Field **Jobsheet**: dropdown cari realtime ke Odoo (label `nomor — subject`), nomor di-snapshot ke `jobsheet_no`. Gagal ambil nomor → form error, tidak tersimpan |
| sfa-cms | Tabel Reward Program | Kolom **Jobsheet** (bisa dicari) |
| sfa-cms | Export / Import Excel | Kolom `jobsheet_no` di baris program (lihat aturan di bawah) |
| sfa-cms | `RewardClaimOdooService` | Kirim `jobsheet_no` = Jobsheet program asal saldo claim (`jobsheetNo()`) |
| sfa-cms | `JobsheetOdooService` (baru) | Panggilan `GET /api/v1/jobsheets` untuk form & import |
**Nomor Jobsheet sebuah claim** (`RewardClaimOdooService::jobsheetNo`): claim selalu seluruh saldo, jadi saldonya =
EARN user itu **sejak CLAIM_DEBIT sebelumnya sampai CLAIM_DEBIT claim ini** (id ledger berurutan, saldo di-lock saat
claim — berlaku untuk claim dari mobile maupun CMS). Ambil `jobsheet_no` program-program EARN tersebut, unik, urut,
dipisah koma. Program tanpa Jobsheet dilewati; kalau tidak ada sama sekali, `jobsheet_no` tidak dikirim.
**Aturan Jobsheet di Import Excel:**
- Kolom `jobsheet_no` **tidak ada** di file (template lama) → Jobsheet program tidak disentuh.
- Kosong → Jobsheet program dihapus.
- Nomor **baru / berubah** → dicek ke Odoo dalam **1 request batch**; harus ada & On Progress. Tidak ketemu → error
per baris, seluruh file ditolak (aturan import yang sama).
- Nomor **sama** dengan data CMS → tidak dicek ulang, supaya file Export tetap bisa di-Import walau Jobsheet-nya sudah Done.
- Odoo tidak bisa dihubungi → import ditolak dengan pesan jelas.
#### API `GET /api/v1/jobsheets`
| Param | Isi |
|---|---|
| `search` | Cari di nomor Jobsheet / subject — untuk dropdown |
| `reference` | Exact match, pisahkan koma untuk banyak nomor — validasi import Excel 1 request |
| `state` | Default `on_progress`. Boleh beberapa dipisah koma, atau `all`. Nilai lain → `422 validation_error` |
| `limit` / `offset` | Default 50, max 200 |
Jobsheet yang masih bernomor `New` (belum di-confirm) tidak pernah dikirim. Contoh 1 record:
```json
{
"id": 958,
"reference": "091/SEP/2026/DEP-TM",
"subject": "Produksi Flyer,POP, dan Wobbler untuk September",
"category": "support",
"operating_unit": {"id": 612, "name": "HO-Trade Marketing"},
"pic": {"id": 1206, "name": "[False] [00] Administrator"},
"date_from": "2026-09-13",
"date_to": "2026-09-30",
"state": "on_progress",
"write_date": "2026-10-26 07:10:50"
}
```
Label dropdown CMS yang disarankan: `reference — subject` (mis. `091/SEP/2026/DEP-TM — Produksi Flyer…`).
Hasil uji lokal 30-10-2026, DB `MITO_PRODUCTION_20082026` (copy production):
| Skenario | Hasil |
|---|---|
| Tanpa API key | `401 unauthorized` |
| Default | **729** Jobsheet `on_progress` = jumlah di DB (user API tidak terhalang operating unit rule) |
| `reference` = 2 nomor benar + 1 typo | Hanya 2 yang kembali → nomor typo terdeteksi |
| `search=2026` | OK |
| `state=all` | **761** = semua Jobsheet bernomor (729 + 1 + 2 + 13 + 16) |
| `state=approved` (tidak ada di Odoo) | `422 validation_error` |
| `GET /jobsheets/999999` | `404 not_found` |
| `limit=500` | Dibatasi 200 |
#### Alur 1 · Pilih Jobsheet di Reward Program (realtime)
```mermaid
sequenceDiagram
autonumber
actor MKT as Marketing (Odoo)
participant OD as Odoo (jobsheet.operation)
participant API as Odoo REST /api/v1/jobsheets
participant CMS as CMS SFA (Filament)
actor ADM as Admin CMS
MKT->>OD: Confirm Jobsheet
OD->>OD: state = on_progress<br/>snk_reference = "001/OKT/2026/CODE"
rect rgb(240, 253, 244)
Note over API: Di-push 30-10-2026 (bb955bd2), belum deploy
end
ADM-->>CMS: Form Reward Program → ketik di dropdown Jobsheet
CMS->>API: GET /api/v1/jobsheets?search=OKT/2026
API->>CMS: [{id, reference, subject, date_from, date_to, state}]<br/>(default hanya on_progress)
ADM-->>CMS: Pilih satu Jobsheet
CMS-->>CMS: simpan reward_program.odoo_jobsheet_id<br/>+ snapshot jobsheet_no
Note over CMS,API: Import Excel: 1 request batch
CMS->>API: GET /api/v1/jobsheets?reference=A,B,C
API->>CMS: hanya nomor yang ada & on_progress
CMS-->>CMS: ada nomor yang tidak kembali → seluruh file ditolak
```
Panah utuh = request ke Odoo, panah putus-putus = aksi admin / proses di CMS.
#### Alur 2 · Claim → Draft Vendor Bill bawa Jobsheet No.
```mermaid
flowchart TD
A["Claim full balance<br/>(mobile / CMS)<br/>reward_claim QUEUED"] --> B["Cron odoo:push-reward-claims<br/>RewardClaimOdooService"]
B --> C["jobsheetNo(): EARN sejak CLAIM_DEBIT<br/>sebelumnya s/d CLAIM_DEBIT claim ini"]
C --> D{"Program asal saldo<br/>punya Jobsheet?"}
D -- "tidak satu pun" --> E["POST /api/v1/reward-bills<br/>tanpa jobsheet_no"]
D -- "ya (1 atau lebih)" --> F["POST /api/v1/reward-bills<br/>jobsheet_no = 'A, B' (unik, urut)"]
E --> G{"Vendor & Reward Product valid?"}
F --> G
G -- "tidak" --> E1["422 vendor_not_found / vendor_inactive /<br/>reward_product_not_set / reward_product_invalid<br/>→ PERMANENT_ERROR"]
G -- "ya" --> H["1 Draft Vendor Bill per claim<br/>Jobsheet No. = referensi<br/>(tanpa AP Form, budget tidak terpotong)"]
H --> I["Finance post & bayar seperti biasa"]
classDef ok fill:#d1fae5,stroke:#059669,color:#064e3b
classDef err fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
class H,I ok
class E1 err
```
Keterangan warna: hijau = bill dibuat, merah = ditolak (kode error persis dari API Odoo). Nomor Jobsheet **tidak**
divalidasi Odoo saat bill dibuat (murni referensi) — validasinya sudah terjadi saat admin memilih Jobsheet di CMS.
Hasil uji lokal 30-10-2026 (CMS di-rollback, bill tes di Odoo dihapus):
| Skenario | Hasil |
|---|---|
| Odoo `-u mito_base` di `MITO_DEV` + `TestRewardClaimBill` | **12 / 12 lolos** (2 test baru: simpan Jobsheet, Jobsheet kosong) |
| `POST /reward-bills` + `jobsheet_no` 2 nomor | 201, bill Draft, **Jobsheet No.** = `001/OKT/2026/AREA, 005/OKT/2026/DEP-MKT` |
| Retry Claim ID sama, `jobsheet_no` beda | 200 `created: false`, Jobsheet bill tidak berubah |
| CMS form: pilih Jobsheet #149 | Tersimpan `odoo_jobsheet_id = 149`, `jobsheet_no = 001/JUN/2026/JABO` |
| CMS form: id Jobsheet tidak ada di Odoo | Error form, tidak tersimpan |
| CMS form: kosongkan Jobsheet | Dua kolom jadi NULL |
| Export | Kolom `jobsheet_no` terisi |
| Import: 1 nomor benar + 1 typo | Seluruh file ditolak: "Baris 3: Jobsheet 999/XXX/2026/TYPO tidak ditemukan di Odoo atau statusnya bukan On Progress." |
| Import: nomor benar / kosong / sama dengan CMS / file tanpa kolom | Tersimpan + id Odoo / NULL / tidak dicek ulang / tidak disentuh |
| Claim: EARN 2 program Jobsheet sama + 1 Jobsheet lain + 1 tanpa Jobsheet, EARN sebelum claim lalu & sesudah claim ini | `jobsheet_no` = `001/OKT/2026/AREA, 005/OKT/2026/DEP-MKT` (EARN di luar rentang tidak ikut) |
| Claim → Odoo lewat `OdooClient` | 201, Jobsheet No. tersimpan di bill |
> [!warning] Belum teruji end-to-end lewat `send()`
> Di CMS lokal belum ada dealer yang terhubung ke partner Odoo (`customer_not_linked`), jadi payload dikirim langsung
> lewat `OdooClient` dengan partner tes. Logika pencarian partner di `send()` tidak berubah. Uji ulang di dev setelah deploy.
### Poin 10 · Staff Dealer hanya scan
**Keputusan 28-10-2026:** reward dari IMEI yang di-scan staff masuk ke **saldo dealer**-nya. Sebelumnya masuk ke saldo
staff sendiri — kalau saldo cuma disembunyikan, reward-nya tertahan dan tidak bisa di-claim siapa pun.
Staff dikenali dari tabel `staff_registration` (`user_id` staff → `dealer_user_id`), **bukan nama role** — nama role
pernah di-rename (Customer → Dealer, lihat [[2026-10-20_registrasi-role-customer-direname-dealer]]).
```mermaid
flowchart TD
A["Request /reward/* (token /auth/login)"] --> B{"user_id ada di<br/>staff_registration?"}
B -- "tidak" --> C["Dealer / customer biasa<br/>owner = dirinya sendiri"]
B -- "ya" --> D{"Dealer APPROVED?"}
D -- "tidak" --> E1["403 DEALER_NOT_ACTIVE"]
D -- "ya" --> F{"Endpoint?"}
F -- "balance / transactions / claim / claims" --> E2["403 STAFF_NOT_ALLOWED"]
F -- "imei/check, imei (submit)" --> G["Pengajuan atas nama dealer<br/>user_id = dealer, submitted_by = staff<br/>respon tanpa balance"]
F -- "imei-submissions" --> H["Hanya pengajuan berisi IMEI scan staff tsb<br/>line & total dari IMEI staff saja"]
F -- "imei/attachment" --> I{"Line di-scan staff ini?"}
I -- "tidak" --> E3["404 LINE_NOT_FOUND"]
I -- "ya" --> J["Nota diganti"]
G --> K["Approve CMS → EARN ke saldo dealer"]
M["Mobile: sembunyikan menu saldo / claim untuk staff"]
classDef ok fill:#d1fae5,stroke:#059669,color:#064e3b
classDef err fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
classDef todo fill:#f3f4f6,stroke:#9ca3af,color:#374151,stroke-dasharray:4 3
class C,G,H,J,K ok
class E1,E2,E3 err
class M todo
```
Keterangan warna: hijau = diizinkan, merah = ditolak (kode error API), abu-abu putus-putus = belum dikerjakan (mobile).
Hasil uji lokal 28-10-2026 (user 26 dijadikan staff dealer 445 CV MAJU JAYA sementara, data dihapus setelah tes):
| Skenario | Hasil |
|---|---|
| Staff `GET /reward/balance`, `/transactions`, `/claims`, `POST /reward/claim` | 403 `STAFF_NOT_ALLOWED` |
| Staff `GET /reward/imei/check` | `scannable: true` |
| Staff submit IMEI | Masuk header dealer, DB `user_id = 445`, `submitted_by = 26`, respon tanpa `balance` |
| Dealer submit IMEI lain | Masuk header terbuka yang sama |
| Staff `GET /reward/imei-submissions` | Hanya IMEI miliknya, `total_amount` dari IMEI staff saja |
| Dealer `GET /reward/imei-submissions` / balance | Melihat IMEI staff + dealer, `pending_approval` ikut naik |
| Staff ganti nota IMEI milik dealer | 404 `LINE_NOT_FOUND` |
---
## Commit & Status Deploy
| Repo | Commit | Branch | Poin | Isi | Status |
|---|---|---|---|---|---|
| sfa-api | `4e31c0f` | `develop` | 1–3 | 1 IMEI 1x reward, hanya terjual, attachment opsional, `GET /reward/imei/check` | Ter-deploy dev 28-10-2026 |
| sfa-cms | `fdb639f` | `develop` | 2 | Kolom `product_qty`, sync stok, cek input CMS | Ter-deploy dev |
| sfa-cms | `14d3d87` | `develop` | 2 | Master IMEI hanya simpan `product_qty = 0` | Ter-deploy dev 28-10-2026 |
| mito_odoo | `42b94a81` | `develop` | 2 | API IMEI kirim `product_qty` | Sudah di `develop` |
| sfa-cms | `2a8e1a0` | `develop` | 4 | Minimum claim Rp 500.000 | Ter-deploy dev 28-10-2026 (Jenkins) |
| sfa-cms | `e785045` | `develop` | 7 | Hapus effective from/to mapping, periode ikut header program | Ter-deploy dev 28-10-2026 (Jenkins) |
| sfa-api | `5c1c203` | `develop` | 4, 7, 10 | Minimum claim + mapping tanpa effective date + Staff Dealer hanya scan | Ter-deploy dev 28-10-2026 (git bundle + `sudo pm2 restart sfa-api-dev`) |
| sfa-cms | `609ed39` | `develop` | 5 | Multi customer: tabel `reward_program_customer`, tab Customer, filter program per dealer | Ter-deploy dev 30-10-2026 (Jenkins, migration ikut jalan) |
| sfa-api | `35e312d` | `develop` | 5 | Multi customer (versi tab Customer): filter program per dealer di `findActiveMappings` | Ter-deploy dev 30-10-2026 (git bundle + `sudo pm2 restart sfa-api-dev`) |
| sfa-cms | `085b73e` | `develop` | 6 | Export & import Excel Reward Program (1 sheet, blok per program) | Ter-deploy dev 30-10-2026 |
| mito_odoo | `bb955bd2` | `cj/api` | 8, 9 | `GET /api/v1/jobsheets` (`snk_jobsheet_operation`) + field **Jobsheet No.** di Vendor Bill + `jobsheet_no` di `POST /reward-bills`, version `18.0.1.0.5` | Di-push 30-10-2026, `develop` sudah di-merge ke `cj/api` (`08c9413a`, tanpa konflik) → **menunggu review senior / deploy** |
| sfa-cms | `54285e6` | `develop` | 6, 8, 9 | Export program terpilih (centang), field Jobsheet (dropdown Odoo), kolom `jobsheet_no` Excel, kirim `jobsheet_no` saat claim | Ter-deploy dev 30-10-2026, migration `2026_10_30_000001` sudah Ran. Dropdown Jobsheet masih **404** sampai Odoo dev di-deploy |
| sfa-cms | `0da379f` | `develop` | 5, 6 | Revisi: customer per baris produk (kolom `reward_product_mapping.user_id`, field Customer many2one di baris, tab Customer dihapus, aturan bentrok baru), format Excel 1 baris = 1 baris produk + 1 customer + `mapping_id`, urutan kolom produk → customer → reward_amount | Ter-deploy dev 31-10-2026 (Jenkins, migration `2026_10_31_000001` Ran; program #7 customer [478, 479] → 2 baris) |
| sfa-api | `c6fc18a` | `develop` | 5 | Revisi: `findActiveMappings` pilih baris per dealer (`user_id` = dealer → `user_id` kosong) + field `user_id` di model | Ter-deploy dev 31-10-2026 (git bundle + `sudo pm2 restart sfa-api-dev`); smoke test `checkImei` dealer 478 / 479 → 500.000 dari baris masing-masing |
| mito_odoo | `89351a4d` | `cj/api` | 2 | Param `sold_only` di `GET /api/v1/imeis` — **dipakai CMS full sync** (`SyncOdooImeis`: `sold_only=1` saat bukan incremental) supaya hanya menarik IMEI terjual | Ikut PR `cj/api` (diputuskan 30-10-2026) |
## Catatan Deploy
> [!info] Deploy API dev (`/var/www/sfa_api_mito`)
> Server tidak bisa `git pull` HTTPS (tanpa kredensial) → kirim **git bundle** dari lokal lalu
> `git pull --ff-only <bundle> develop`, restart **`sudo pm2 restart sfa-api-dev`** (pm2 milik root, port 3069, route tanpa
> prefix: `/reward/...`). 28-10-2026 pull sempat gagal karena `routes/handler/reward`, `swagger`, dan sebagian `.git`
> milik root → `sudo chown -R ubuntu:ubuntu /var/www/sfa_api_mito`. **Jangan deploy API pakai sudo** supaya tidak terulang.
> [!warning] Poin 2 — setelah deploy CMS wajib full sync IMEI
> `php artisan migrate` lalu `php artisan odoo:sync-imeis --reset`. Incremental saja tidak menarik IMEI lama, jadi
> `product_qty` tetap NULL. Dev: full sync dijalankan 28-10-2026 (±810 ribu IMEI ditarik).
> [!info] Poin 5 — urutan deploy customer per baris produk (revisi 30-10-2026)
> 1. CMS: `php artisan migrate --path=database/migrations/2026_10_31_000001_add_user_id_to_reward_product_mapping_table.php`
> (kolom `user_id` + pindah data tab Customer lama ke baris).
> 2. **Baru** API: git bundle + `sudo pm2 restart sfa-api-dev` — query Node baru membaca kolom `user_id`.
> 3. `reward_program_customer` (versi tab Customer 29-10-2026) dibiarkan dulu; drop lewat migration terpisah setelah
> keduanya ter-deploy.
> [!info] Poin 8 & 9 — deploy Jobsheet (urutan: Odoo dulu, baru CMS)
> 1. Odoo: `-u mito_base` (field **Jobsheet No.** + view, version `18.0.1.0.5`) lalu restart — `snk_jobsheet_operation`
> cukup restart (hanya controller). Ikuti [[Mito — Upgrade Playbook Production]]: **upgrade semua server** yang share DB.
> 2. CMS: `php artisan migrate --path=database/migrations/2026_10_30_000001_add_jobsheet_to_reward_program_table.php`.
> Kalau CMS lebih dulu dari Odoo, claim yang membawa `jobsheet_no` tetap diterima Odoo lama (field tak dikenal diabaikan),
> tapi nomornya tidak tersimpan — jadi tetap deploy Odoo dulu.
> - `develop` sudah di-merge ke `cj/api` 30-10-2026 (`08c9413a`, konflik version diselesaikan → `18.0.1.0.5`).
> Teruji `MITO_DEV` 1.0.3 → 1.0.5: upgrade OK, `TestRewardClaimBill` 12/12.
> - `tests/__init__.py` (juga di `develop`) meng-import `test_partner_credit_limit_validation` yang filenya tidak ada →
> `--test-enable` di `mito_base` gagal load. Bukan dari PR ini; perlu diperbaiki pemilik test tersebut.
> - **Lokal saja:** `-u mito_base` di DB `MITO_PRODUCTION_20082026` gagal `open_customer_statement is not a valid action
> on res.partner` — view `account_followup` di DB berasal dari Enterprise production yang lebih baru, sedangkan
> `addons_e` lokal lama. Tidak terjadi di server (kode Enterprise sama dengan DB-nya).
> - User API (`mito_base.api_user_id`) wajib punya akses baca `jobsheet.operation`; kalau kena operating unit rule,
> Jobsheet di luar cabangnya tidak muncul.
> - Server wajib `db_name` / `dbfilter` satu database. Tanpa itu, request CMS (tanpa session) tidak tahu DB mana →
> **semua** `/api/v1/*` balas 404. Di lokal ada 2 DB (`MITO_DEV`, `MITO_PRODUCTION_20082026`) dan `odoo.conf` tidak
> set `db_name` / `dbfilter`, jadi tes lokal butuh cookie session `/web/login?db=...` dulu.
## Sisa Pekerjaan (urutan saran)
1. **PR** mito_odoo `cj/api` → `develop` (`sold_only` + Jobsheet, tanpa konflik) — menunggu review senior.
2. ~~Commit sfa-cms~~ ✅ `54285e6` di-push ke `develop`.
3. **Deploy Odoo dev** (`mitodev.sinerka.id`, DB `MITO_PRODUCTION_20082026`) setelah review senior: `-u mito_base` + restart. CMS & API dev sudah ter-deploy 30-10-2026; sampai Odoo di-deploy, dropdown Jobsheet CMS dapat 404 ("Daftar Jobsheet Odoo tidak bisa diambil").
4. **Uji di dev** claim end-to-end dengan dealer yang sudah terhubung ke partner Odoo → cek Jobsheet No. di Vendor Bill.
5. **Mobile:** sembunyikan menu saldo / claim untuk Staff Dealer.
6. ~~Commit + deploy revisi customer per baris produk~~ ✅ dev 31-10-2026. Sisa: migration drop `reward_program_customer` (tabel sudah tidak dipakai).
7. Keputusan K4 (celah IMEI belum masuk gudang), K5 (nominal terlihat staff).