--- 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 | — | ✅ **Diputuskan 11-11-2026: boleh lihat, milik sendiri saja.** Staff melihat nominal IMEI yang dia scan; Dealer melihat dirinya + semua staff-nya. Sudah sesuai kode (tanpa perubahan) | ## 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?
(hanya product_qty = 0)"} C -- "tidak (belum terjual / diretur / tidak ada)" --> E1["IMEI_NOT_FOUND"] C -- "ya" --> D{"Sudah pernah dapat reward?
(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
reward ACTIVE hari ini?"} H -- "tidak" --> E5["NO_ACTIVE_REWARD"] H -- "ya" --> I["scannable = true
masuk list mobile"] I --> J["POST /reward/imei
(attachment opsional)"] J --> K["Pengajuan SUBMITTED
menunggu approval CMS"] K -- "approve CMS" --> L{"Saldo >= Rp 500.000?"} L -- "tidak" --> E6["422 BELOW_MIN_CLAIM
claimable = false"] L -- "ya" --> N["Claim full balance
→ Draft Vendor Bill Odoo"] N --> M["+ Jobsheet No. di Vendor Bill
(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
(dealer; scan Staff Dealer → dealer-nya)"] B --> C{"Ada baris produk IMEI ACTIVE
di program ACTIVE & periode hari ini?"} C -- "tidak" --> E1["NO_ACTIVE_REWARD"] C -- "ya" --> D{"Ada baris dengan
customer = dealer ini?"} D -- "ya" --> F["Reward = nominal baris itu
(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
CMS: Produk … tidak sedang mendapat reward /
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
(Import di list Reward Program)"] --> B{"File bisa dibaca
dan kolom template ada?"} B -- "tidak" --> E1["Import dibatalkan
(file tidak valid / kolom tidak ditemukan)"] B -- "ya" --> C["Baca baris per blok program
(program_code terisi = program baru,
kosong = lanjutan program di atasnya)"] C --> D["Validasi: data program, mapping_id milik program & produk,
product_code, reward_amount >= 1, email = akun dealer,
program / mapping_id / customer per baris tidak dobel"] D --> F{"Ada error?"} F -- "tidak" --> G["Cek bentrok baris ACTIVE
(produk sama, periode beririsan,
customer beririsan / tanpa customer)"] G --> H{"Ada error?"} F -- "ya" --> E2["Import dibatalkan,
tidak ada data yang disimpan
(daftar error per baris)"] H -- "ya" --> E2 H -- "tidak" --> I["DB transaction:
upsert program by program_code
upsert baris by mapping_id (kosong = baru)
customer baris = isi file"] I --> J["Import selesai
(jumlah program baru / update,
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/` (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
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}]
(default hanya on_progress) ADM-->>CMS: Pilih satu Jobsheet CMS-->>CMS: simpan reward_program.odoo_jobsheet_id
+ 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
(mobile / CMS)
reward_claim QUEUED"] --> B["Cron odoo:push-reward-claims
RewardClaimOdooService"] B --> C["jobsheetNo(): EARN sejak CLAIM_DEBIT
sebelumnya s/d CLAIM_DEBIT claim ini"] C --> D{"Program asal saldo
punya Jobsheet?"} D -- "tidak satu pun" --> E["POST /api/v1/reward-bills
tanpa jobsheet_no"] D -- "ya (1 atau lebih)" --> F["POST /api/v1/reward-bills
jobsheet_no = 'A, B' (unik, urut)"] E --> G{"Vendor & Reward Product valid?"} F --> G G -- "tidak" --> E1["422 vendor_not_found / vendor_inactive /
reward_product_not_set / reward_product_invalid
→ PERMANENT_ERROR"] G -- "ya" --> H["1 Draft Vendor Bill per claim
Jobsheet No. = referensi
(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
staff_registration?"} B -- "tidak" --> C["Dealer / customer biasa
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
user_id = dealer, submitted_by = staff
respon tanpa balance"] F -- "imei-submissions" --> H["Hanya pengajuan berisi IMEI scan staff tsb
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 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)~~ ✅ 11-11-2026.