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

43 KiB
Raw Permalink Blame History

judul proyek terkait kategori status tipe tags diperbarui
SFA — Revisi Reward MoM 22-10-2026 (checklist) SFA API · SFA CMS · mito_odoo Mito · Odoo 18 · SFA Mobile Fitur 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 dokumen-internal
sfa
reward
imei
jobsheet
mom
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 · Checklist · Keputusan yang Dibutuhkan · Info ke Tim Mobile
Developer / Senior Detail Teknis per Poin · Commit & Status Deploy · Catatan Deploy

Ringkasan

  • 10 dari 10 poin selesai dan teruji lokal. Sebagian sudah ter-deploy di dev, sisanya tinggal commit / deploy (lihat Commit & Status Deploy).
  • 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
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).
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)
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 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.

Alur Import

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:

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

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.

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

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) ✅ 11-11-2026.