Doc_chelvyn/Mito/Sfa/Fitur/SFA — Reward.md

28 KiB
Raw Permalink Blame History

judul proyek terkait stack kategori status tipe tags diperbarui
SFA — Reward (scan IMEI, saldo, claim) SFA API · SFA CMS Mito · Odoo 18 · SFA Mobile Node/Express (sfa-api) · Laravel 11 · Filament 3 · MySQL Fitur Ter-deploy ke CMS dev 13-10-2026 (cms 137aca2 + db25341, api 63c9153) — integrasi Odoo selesai di kode (cms 46fc3c7, odoo a5cc341e), belum deploy dokumen-internal
sfa
reward
imei
odoo
2026-10-27

Index: SFA — Index · Kategori: Fitur · FDD: Functional Design — SFA Reward, CMS, dan Integrasi Odoo

Implementasi tahap 1 FDD SFA Reward v0.2: config reward, ledger, saldo, scan IMEI, claim full balance, dan menu CMS. Berbeda dari FDD: scan IMEI tidak langsung menambah saldo — masuk Pengajuan IMEI dulu dan reward baru masuk saldo setelah di-approve user internal di CMS. Admin juga bisa input pengajuan dari CMS untuk IMEI yang tidak bisa di-scan (§5). Draft Vendor Bill di Odoo dikerjakan terpisah: SFA — Reward Claim ke Odoo (Draft Vendor Bill) (FDD v0.4, belum deploy).

SFA — Reward

1. Keputusan

# Hal Keputusan
1 IMEI uniqueness scope (FDD §12) ✅ Per IMEI (MoM 22-10-2026, sebelumnya per produk sejak 13-10-2026). Cek di Node & CMS: IMEI yang sudah ada di ledger — termasuk yang saldonya sudah di-claim — ditolak IMEI_ALREADY_REWARDED, walaupun produk IMEI di Odoo berubah. UNIQUE(imei_number, product_id) di ledger tetap sebagai pengaman terakhir
2 Sumber relasi IMEI–produk (FDD §12) ✅ Tabel imei hasil odoo:sync-imeis. Product ID dari mobile tidak dipakai
3 Siapa "konsumen" users.id dari token /auth/login, INTERNAL maupun EXTERNAL (middleware baru validateUserJWT). Token registrant ditolak
4 Saldo per apa Per user, lintas program. Ledger tetap menyimpan program & produk untuk laporan. Satu claim = seluruh saldo user
5 Mapping tumpang tindih CMS menolak 2 mapping ACTIVE untuk produk yang sama dengan periode bertabrakan, lintas program (program ENDED dikecualikan). Kalau tidak begitu, program pemberi reward jadi ambigu karena IMEI hanya dapat sekali per produk
6 Ubah nominal Mapping yang sudah dipakai ledger: produk, nominal, effective_from dikunci. Ubah nominal = isi effective_to mapping lama lalu buat mapping baru
7 Minimum claim Tidak ada. Claim ditolak hanya kalau saldo 0
8 Expiry Tidak ada (FDD: kalau tidak didefinisikan, saldo tidak kedaluwarsa)
9 Approval IMEI (di luar FDD, 13-10-2026) Semua IMEI lewat Pengajuan IMEI dulu, saldo belum bertambah. Satu customer = satu pengajuan SUBMITTED: scan mobile dan input admin CMS untuk customer itu masuk sebagai line di header yang sama (lintas reward program; program, sumber, catatan, attachment disimpan per line). Approval per pengajuan → satu EARN per IMEI + saldo bertambah total, header ditutup; IMEI berikutnya membuka header baru. IMEI bermasalah bisa ditolak per line tanpa menolak header. Approver tidak boleh yang meng-input / scan IMEI di header itu. Produk dan nominal dikunci saat IMEI masuk. Detail di §5
10 Submit IMEI dari mobile (di luar FDD, 19-10-2026) Hasil scan dikumpulkan dulu di list mobile (belum hit API), user menambahkan satu nota, lalu dikirim sekali: POST /reward/imei {imei_number: [..], request_id, attachment?}. Nota dipakai bersama semua IMEI di list — opsional sejak MoM 22-10-2026 (submit tanpa nota → attachment line null, bisa ditambah lewat PUT). Semua atau tidak sama sekali — satu IMEI ditolak → tidak ada yang disimpan, 422 IMEI_REJECTED + alasan per IMEI. POST /reward/imei/attachment (upload nota sesudah scan) dihapus; PUT tetap untuk ganti nota. reward_imei_submission_line.request_id jadi index biasa (bukan UNIQUE), migration CMS 2026_10_19_000001
11 IMEI hanya sekali di-scan & harus sudah terjual (MoM 22-10-2026, di luar FDD) Terjual = stock.lot.product_qty Odoo = 0 (stok internal habis, diputuskan 27-10-2026). API Odoo /imeis mengirim product_qty; updated_since juga menangkap IMEI yang quant-nya berubah (DO / retur tidak mengubah write_date IMEI). CMS menyimpan imei.product_qty (migration 2026_10_27_000001, NULL = belum ter-sync → dianggap belum terjual). Cek saat scan lewat endpoint baru GET /reward/imei/check (sebelumnya list mobile tidak hit API) + dicek ulang saat submit / input CMS → IMEI_NOT_SOLD. IMEI yang pernah REJECTED boleh di-scan lagi

Alur Scan IMEI → Pengajuan → Approval

Berlaku untuk cek saat scan (GET /reward/imei/check), submit SFA Mobile (POST /reward/imei), dan input admin CMS (menu IMEI Registration). Kode error mobile sama persis dengan respon API. Cek C–D dijalankan per IMEI, urut seperti di chart: saat scan hasilnya 200 scannable: false + error.code (IMEI tidak masuk list), saat submit semua alasan dikumpulkan ke 422 IMEI_REJECTED (data.errors[]), di CMS tampil sebagai error di line itu.

flowchart TD
    A0["SFA Mobile: scan IMEI<br/>GET /reward/imei/check?imei_number"] --> CK["Cek C–D (tanpa lock, tidak menyimpan)"]
    CK -- "ada yang gagal" --> CK1["200 scannable: false + error.code<br/>IMEI tidak masuk list"]
    CK -- lolos --> CK2["200 scannable: true<br/>product, program, reward_amount<br/>→ IMEI masuk list"]
    CK2 --> A["List IMEI + nota opsional → kirim<br/>POST /reward/imei {imei_number: [..], request_id baru, attachment?}<br/>atau Admin CMS: Buat Pengajuan<br/>(Reward + customer + attachment opsional + IMEI per line)"]
    A --> V{"Body valid?<br/>array 1–100 tanpa dobel,<br/>nota (kalau ada) PDF / PNG / JPG ≤ 5MB"}
    V -- tidak --> V1["400"]
    V -- ya --> B{"request_id<br/>sudah pernah dipakai?<br/>(mobile saja)"}
    B -- "ya, user & daftar IMEI sama" --> B1["200 replay<br/>hasil submit sebelumnya"]
    B -- "ya, user / daftar IMEI lain" --> B2["409 REQUEST_ID_CONFLICT"]
    B -- tidak --> C{"Per IMEI: ada di<br/>master IMEI?"}
    C -- tidak --> C1["IMEI_NOT_FOUND"]
    C -- ya --> E{"IMEI sudah pernah dapat reward?<br/>(ada di ledger, termasuk<br/>yang sudah di-claim)"}
    E -- ya --> E1["IMEI_ALREADY_REWARDED"]
    E -- tidak --> P{"IMEI ini masih menunggu<br/>approval (line SUBMITTED)?<br/>REJECTED tidak dihitung"}
    P -- ya --> P1["IMEI_PENDING_APPROVAL"]
    P -- tidak --> S{"Sudah terjual?<br/>imei.product_qty = 0<br/>(NULL = belum sync)"}
    S -- tidak --> S1["IMEI_NOT_SOLD"]
    S -- ya --> D{"Program ACTIVE + mapping produk<br/>berlaku hari ini?<br/>(CMS: di Reward yang dipilih)"}
    D -- tidak --> D1["NO_ACTIVE_REWARD"]
    D -- ya --> Q["IMEI lolos"]
    C1 & E1 & P1 & S1 & D1 & Q --> R{"Ada IMEI yang ditolak?"}
    R -- ya --> R1["422 IMEI_REJECTED<br/>errors[] per IMEI<br/>tidak ada IMEI / nota yang disimpan"]
    R -- tidak --> O{"Customer punya pengajuan<br/>SUBMITTED?"}
    O -- ya --> F["Semua IMEI ditambah sebagai line<br/>di pengajuan itu, nota sama (atau null)"]
    O -- tidak --> F0["Buat pengajuan baru<br/>kode RIS + YYMMDD + id"]
    F0 --> F
    F --> F2["201 WAITING APPROVAL<br/>submitted_lines[], produk & nominal dikunci<br/>saldo BELUM bertambah"]

    classDef ok fill:#d1fae5,stroke:#059669,color:#064e3b
    classDef err fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
    class CK2,B1,Q,F0,F,F2 ok
    class CK1,V1,B2,C1,D1,E1,P1,S1,R1 err

Hijau = lolos / tersimpan · merah = ditolak (kode per IMEI tanpa angka HTTP = isi data.errors[].code).

flowchart TD
    S["Pengajuan customer SUBMITTED<br/>(berisi line IMEI dari mobile + CMS)"] --> T{"Ada IMEI bermasalah?"}
    T -- ya --> T1["Tolak IMEI (per line) + alasan<br/>line REJECTED, total dikurangi"]
    T1 --> T2{"Masih ada line<br/>menunggu?"}
    T2 -- tidak --> R0["Pengajuan REJECTED<br/>(semua IMEI ditolak)"]
    T2 -- ya --> S
    T -- tidak --> G{"Approve / Reject pengajuan<br/>(satu-satu / bulk)"}
    G -- "Reject + alasan" --> R["REJECTED: semua line menunggu ditolak<br/>IMEI boleh di-scan / diajukan lagi"]
    G -- Approve --> H{"Approver pernah input / scan<br/>IMEI di pengajuan ini?"}
    H -- ya --> H1["Ditolak: harus user lain<br/>(bulk: dilewati)"]
    H -- tidak --> N{"Ada IMEI baru masuk sejak<br/>dialog approve dibuka?"}
    N -- ya --> N1["Gagal: muat ulang lalu approve lagi"]
    N -- tidak --> I{"Ada IMEI yang sudah dapat<br/>reward dari jalur lain?"}
    I -- ya --> I1["Gagal: tolak IMEI itu dulu"]
    I -- tidak --> J["Satu transaksi DB: EARN per IMEI<br/>(request_id = RIS…-line_id) + saldo bertambah<br/>→ APPROVED, header ditutup"]
    J -.-> K["Scan berikutnya membuka<br/>pengajuan baru"]

    classDef ok fill:#d1fae5,stroke:#059669,color:#064e3b
    classDef err fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
    class J,K,L ok
    class T1,R0,R,H1,N1,I1 err

Hijau = sukses, merah = ditolak / gagal (saldo tidak berubah).

Alur Claim

flowchart TD
    H["SFA Mobile: Claim Full Balance<br/>amount = saldo di layar<br/>(hanya reward yang sudah APPROVED)"] --> I{"amount = saldo<br/>saat diproses?"}
    H2["Admin CMS: Saldo Reward → tab Reward Ledger<br/>tombol Claim (permission claim_reward::balance)<br/>amount = saldo saat dialog dibuka"] --> I
    I -- "saldo 0" --> I1["422 BALANCE_EMPTY<br/>(CMS: tombol tidak tampil)"]
    I -- "beda" --> I2["409 BALANCE_CHANGED + saldo terbaru<br/>(CMS: Claim gagal, muat ulang)"]
    I -- sama --> J["Satu transaksi DB:<br/>reward_claim + CLAIM_DEBIT<br/>saldo jadi 0"]
    J --> K["reward_claim<br/>integration_status = QUEUED"]
    K --> L["CMS → Odoo tiap menit<br/>Draft Vendor Bill (lihat dokumen integrasi)"]

    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 J,K ok
    class I1,I2 err

Hijau = sukses, merah = ditolak (saldo tidak berubah), abu-abu putus-putus = belum dikerjakan. Claim dari CMS (di luar FDD) memakai RewardClaimService dengan aturan yang sama: request_id = CMS-<uuid>, CLAIM_DEBIT reason "Claim dari CMS", created_by = admin; claim-nya tampil juga di GET /reward/claims customer.

2. Tabel (migration CMS 2026_10_13_000003_create_reward_tables)

Tabel Isi Ditulis oleh
reward_program Program: kode, nama, periode, status DRAFT/ACTIVE/PAUSED/ENDED, claim_mode = FULL_BALANCE CMS
reward_product_mapping Nominal per IMEI per produk, effective_from/to, ACTIVE/INACTIVE CMS
reward_transaction Ledger: EARN (+), CLAIM_DEBIT (−), REVERSAL/ADJUSTMENT (±). Tidak pernah di-update/dihapus. request_id unik (EARN = kode RIS pengajuan, CLAIM_DEBIT = kosong) EARN: CMS (approve) · CLAIM_DEBIT: Node
reward_balance Saldo per user (balance, total_earned, total_claimed, total_adjusted). Di-update di transaksi DB yang sama dengan ledger; baris ini yang di-lock (FOR UPDATE) CMS (approve) · Node (claim)
reward_claim Claim: claim_code RCL+YYMMDD+id, status, integration_status (QUEUED = outbox untuk Odoo), kolom Odoo bill / error / retry Node (CMS untuk integrasi nanti)
reward_imei_submission Header pengajuan IMEI (migration 2026_10_13_000004), satu SUBMITTED per customer (kolom generated open_user_id unik): submission_code RIS+YYMMDD+id, user_id, total_amount (line yang tidak ditolak), status SUBMITTED/APPROVED/REJECTED, submitted_at (IMEI pertama), updated_at (IMEI terakhir), reviewed_by/at, review_note Node (scan) · CMS (input + approve/reject)
reward_imei_submission_line Satu baris per IMEI: source MOBILE/CMS, request_id (mobile, sama untuk semua line satu submit — index biasa sejak 2026_10_19_000001), imei_number, snapshot product_id/code, reward_program_id, reward_product_mapping_id, reward_amount, catatan (CMS) + attachment (nota mobile / bukti CMS), submitted_by, status SUBMITTED/APPROVED/REJECTED + reviewed_by/at, review_note (alasan tolak per IMEI), reward_transaction_id Node (scan) · CMS

Scan mobile hanya menulis pengajuan. EARN + saldo ditulis CMS saat approve (RewardImeiSubmissionService). Urutan lock di Node dan CMS sama supaya tidak deadlock: reward_balance customer → master imei → header. Lock saldo menyerialkan semua tambah-IMEI / approve / claim satu customer (jadi tidak pernah ada dua header terbuka); lock master IMEI menyerialkan scan IMEI yang sama dari customer berbeda.

3. Endpoint Node API (sfa-api)

Semua pakai header token dari /auth/login. Error membawa data.code.

Endpoint Fungsi Respon penting
GET /reward/imei/check?imei_number&program_id? Cek satu IMEI saat scan, sebelum masuk list (aturan sama dengan submit, tanpa menyimpan) Selalu 200: scannable: true + product, program, reward_amount, atau scannable: false + error (IMEI_NOT_FOUND / IMEI_ALREADY_REWARDED / IMEI_PENDING_APPROVAL / IMEI_NOT_SOLD / NO_ACTIVE_REWARD) · 400 validasi
POST /reward/imei {imei_number: [..], request_id, attachment?, program_id?} Submit list IMEI hasil scan + satu nota (opsional) → line di pengajuan customer (belum masuk saldo). Semua atau tidak sama sekali 201 + submission_code, status: SUBMITTED, total_amount, lines[] (line_id, imei_number, product, program, reward_amount, status, source, attachment, reject_reason), submitted_lines[] (IMEI request ini), balance (saat ini) · 200 replay · 400 IMEI dobel / nota tidak valid · 422 IMEI_REJECTED + errors[] (IMEI_NOT_FOUND / IMEI_ALREADY_REWARDED / IMEI_PENDING_APPROVAL / IMEI_NOT_SOLD / NO_ACTIVE_REWARD per IMEI) · 409 REQUEST_ID_CONFLICT
PUT /reward/imei/attachment {line_ids, attachment} Ganti nota IMEI di list pengajuan (masih SUBMITTED, sumber MOBILE) 200 + URL nota baru, submissions[] · 404 LINE_NOT_FOUND · 409 LINE_ALREADY_REVIEWED / LINE_NOT_FROM_MOBILE. Nota lama dihapus kalau tidak dipakai IMEI lain
GET /reward/imei-submissions?page&limit&status Riwayat pengajuan saya (mobile + CMS) Format sama dengan respon scan. Maksimal satu SUBMITTED. status pengajuan SUBMITTED / APPROVED / REJECTED + reject_reason; status per IMEI di lines[].status
GET /reward/balance Saldo balance, totals, pending_approval (reward menunggu approval, belum bisa di-claim), pending_integration, claimable
GET /reward/transactions?page&limit&trans_type Ledger saya —
POST /reward/claim {request_id, amount} Claim full balance 201 + claim_code, balance 0 · 409 BALANCE_CHANGED + saldo terbaru · 422 BALANCE_EMPTY
GET /reward/claims?page&limit&status Riwayat claim display_status: PROCESSING / DRAFT_BILL_CREATED / NEEDS_ASSISTANCE / REVERSED

amount di claim = saldo yang tampil di layar. Kalau saldo berubah sebelum diproses (reward baru masuk / claim lain), claim ditolak 409 dengan saldo terbaru → mobile menampilkan ulang, user konfirmasi, kirim dengan request_id baru. Ini memenuhi UAT "CMS menghitung ulang saldo dan mengonfirmasi nominal full-balance yang benar sebelum debit".

request_id: dibuat mobile (UUID) per aksi, dikirim ulang apa adanya saat retry → hasil sama, tanpa reward/debit ganda. Unik global (semua user), 8–64 karakter [A-Za-z0-9_-]. Submit IMEI disimpan di reward_imei_submission_line.request_id (sama untuk semua line dari satu submit; replay dicocokkan dengan daftar IMEI, urutan bebas), claim di reward_claim.request_id. request_id lama yang dipakai untuk daftar IMEI lain / user lain / nominal claim lain → 409 REQUEST_ID_CONFLICT (submit: ada used_for_imei[]). Untuk tes manual di Swagger cukup MITO0001, MITO0002, …; di aplikasi tetap UUID supaya dua HP tidak bertabrakan.

File: routes/services/serviceReward.js, routes/handler/reward/reward.js, routes/validator/validatorReward.js, routes/helpers/enums/reward.js, models/Mreward*.js (termasuk MrewardImeiSubmission), validateUserJWT di validatorJWT.js, route di routes/sfa.js, Swagger tag Reward.

4. Menu CMS (grup Reward)

Menu Isi
Reward Program CRUD program (tidak bisa dihapus, akhiri dengan ENDED) + relation manager Product Reward Mapping (validasi overlap, kunci nominal setelah dipakai, hapus hanya kalau belum dipakai)
Saldo Reward List saldo per customer (saldo, earned, claimed, pending integration, last activity; filter tipe user, rentang saldo, tanggal). Detail: Reward Ledger (filter type/program, tombol Claim = claim seluruh saldo atas nama customer, tampil bila saldo > 0 dan punya claim_reward::balance) + Claim History
Claim History Semua claim (filter status, status integrasi, tanggal). Detail: data claim + blok Integrasi Odoo
IMEI Registration Satu baris per pengajuan customer (tombol New IMEI Registration). List (badge = jumlah WAITING APPROVAL, kolom Sumber / Reward / IMEI / Jumlah IMEI / Total / IMEI terakhir masuk, filter Sumber, Reward, status, tanggal, cari per IMEI) dengan bulk Approve / Reject, form Buat Pengajuan (header + line IMEI), detail (header + tabel IMEI dengan Tolak IMEI per baris) dengan tombol Approve / Reject. Lihat §5

Ledger di detail Saldo Reward punya kolom Sumber: Scan Mobile / Input CMS (EARN, dari pengajuannya), Mobile (claim).

Permission Shield: *_reward::program, *_reward::balance (+ claim_reward::balance), *_reward::claim (policy sudah di-generate), dan view / view_any / create / approve / reject _reward::imei::submission. Di server: php artisan shield:generate --resource=RewardProgramResource,RewardBalanceResource,RewardClaimResource --panel=admin lalu php artisan shield:generate --resource=RewardImeiSubmissionResource,RewardBalanceResource --panel=admin --ignore-existing-policies (wajib --ignore-existing-policies, kalau tidak policy custom tertimpa dan pengajuan jadi bisa di-edit / dihapus). Setelah itu centang permission di role yang sesuai: pembuat pengajuan cukup create, approver approve + reject.

5. Pengajuan IMEI & Approval (di luar FDD)

Semua IMEI masuk Pengajuan IMEI dulu; reward baru masuk saldo setelah di-approve. Alur lengkap di chart Alur Scan IMEI → Pengajuan → Approval di atas.

Hal Aturan
Satu pengajuan per customer Customer hanya punya satu pengajuan SUBMITTED. Scan mobile dan input CMS untuk customer itu masuk sebagai line di pengajuan yang sama, lintas reward program. Setelah pengajuan di-approve / ditolak, IMEI berikutnya membuka pengajuan baru
Sumber line MOBILE: scan SFA Mobile, submitted_by = user yang scan. CMS: admin dengan create_reward::imei::submission atas nama customer (user status = APPROVED, internal maupun external), bila scan mobile tidak bisa
Form CMS — header Reward (Reward Program ACTIVE hari ini, untuk IMEI yang diinput sekarang), Customer, Attachment jpg / png / pdf (opsional, maks 5 MB, files/reward_imei_submission), Reason (opsional, mis. alasan scan mobile tidak bisa). Program, reason, dan attachment disimpan di tiap line yang diinput (kolom Reason di tabel IMEI)
Form CMS — line IMEI Isi IMEI → Product dan Reward terisi otomatis dari master IMEI + mapping program terpilih (read-only). Tombol Add IMEI menambah line baru. Total reward + jumlah IMEI tampil di bawah. Ganti Reward → semua line dihitung ulang. IMEI yang sama tidak boleh diisi dua kali. Setelah submit → diarahkan ke detail pengajuan customer itu
Validasi saat scan / submit (per IMEI) IMEI di master, mapping ACTIVE hari ini (CMS: di program yang dipilih), IMEI + produk belum dapat reward, IMEI tidak sedang menunggu approval (409 IMEI_PENDING_APPROVAL, by_you). Di CMS error tampil di line IMEI yang salah
Status Pengajuan: SUBMITTED (tampil WAITING APPROVAL) → APPROVED / REJECTED. Line: SUBMITTED → APPROVED (ikut approve pengajuan) / REJECTED (ditolak sendiri atau ikut reject pengajuan). Tidak bisa diedit / dihapus
Nominal Dikunci per IMEI saat masuk. Kalau program berakhir atau nominal mapping diubah sebelum approve, yang dibayar tetap nominal saat itu
Tolak IMEI (per line) Di tabel IMEI pada detail pengajuan, user dengan reject_reward::imei::submission, alasan wajib (tampil di mobile sebagai lines[].reject_reason). Total pengajuan dikurangi; pengajuan tetap menunggu. Kalau semua IMEI ditolak, pengajuan ikut REJECTED
Approve User dengan approve_reward::imei::submission yang tidak meng-input / scan IMEI mana pun yang menunggu di pengajuan itu. Dialog approve tanpa isian catatan. Satu transaksi DB: satu EARN per line SUBMITTED (request_id = RIS…-<line_id>, reason = "Scan IMEI RIS…" / "Pengajuan IMEI CMS RIS…", created_by = approver), saldo bertambah, pengajuan APPROVED. Gagal kalau ada IMEI baru masuk sejak dialog approve dibuka (muat ulang) atau ada IMEI yang sudah dapat reward dari jalur lain (tolak IMEI itu dulu)
Reject pengajuan Alasan wajib; semua line yang menunggu ikut ditolak. Semua IMEI-nya boleh di-scan / diajukan lagi
Bulk Approve / Reject banyak pengajuan sekaligus dari list (hanya WAITING APPROVAL yang bisa dicentang). Tiap pengajuan transaksi sendiri; yang gagal dilewati dan dilaporkan di notifikasi. Bulk approve tidak memakai cek "IMEI baru masuk" — semua line yang menunggu saat diproses ikut di-approve
Di SFA Mobile Scan masuk list lokal dulu; setelah nota ditambah dan dikirim, tampilkan "menunggu approval" + submitted_lines[].reward_amount. Kalau 422 IMEI_REJECTED, tandai IMEI di errors[] di list (hapus / perbaiki) lalu kirim ulang dengan request_id baru. Pengajuan + status per IMEI dari GET /reward/imei-submissions; total menunggu dari pending_approval di GET /reward/balance. Reward yang di-approve muncul di GET /reward/transactions sebagai EARN dan bisa di-claim

File CMS: RewardImeiSubmissionService, RewardImeiSubmissionResource (+ Pages, RelationManagers\LinesRelationManager), RewardImeiSubmission, RewardImeiSubmissionLine, RewardImeiSubmissionStatusEnum, RewardImeiSubmissionPolicy, migration 2026_10_13_000004_create_reward_imei_submission_table. File Node: submitImei / replaceImeiAttachment / getSubmissions di serviceReward.js, models/MrewardImeiSubmission.js + MrewardImeiSubmissionLine.js, route GET /reward/imei-submissions.

6. Pengujian (lokal, 13-10-2026)

  • Node, 24/24 lolos (versi awal, scan langsung EARN — digantikan uji approval di bawah): token registrant/tanpa token 403, EARN + replay, request_id milik user lain, IMEI duplikat, IMEI tidak ada, produk tanpa mapping, program_id salah, 5 scan paralel IMEI sama → tepat 1 reward, claim nominal salah → BALANCE_CHANGED, claim + replay, saldo kosong, 5 claim paralel → tepat 1 debit, saldo 0, SUM ledger = saldo, filter & isolasi antar user. Tidak ada respon 500.
  • CMS, 12/12 lolos (Livewire): semua halaman list/create/edit/view + relation manager ter-render; overlap mapping produk sama ditolak, produk lain diterima.
  • Pengajuan IMEI, 2 test / 96 assertion lolos (PHPUnit + Livewire, rollback otomatis): IMEI tidak ada / produk tanpa mapping / alasan kosong ditolak form, preview produk & nominal tampil, submit → kode RIS, pengajuan ganda ditolak, pembuat tidak bisa approve (tombol disabled), user tanpa permission tidak melihat tombol, approve → EARN + saldo bertambah (SUM ledger = saldo), approve/reject ulang ditolak, reject dari tabel wajib alasan, IMEI yang sudah di-scan mobile saat pengajuan menunggu → approve gagal tanpa reward dobel, kolom Sumber CMS.
  • Approval scan mobile, E2E 27/27 lolos (HTTP Node + approve/reject lewat service CMS): scan → 201 SUBMITTED saldo tetap 0, replay 200, REQUEST_ID_CONFLICT, IMEI_PENDING_APPROVAL (user sama & lain), 5 scan paralel IMEI sama → tepat 1 pengajuan, pending_approval di balance, ledger kosong & claim BALANCE_EMPTY selama pending, list + filter + isolasi user, pemilik scan tidak bisa approve, approve → EARN + saldo, reject → reject_reason, IMEI ter-reward → IMEI_ALREADY_REWARDED, IMEI ditolak boleh di-scan ulang, claim full balance, SUM ledger = saldo.
  • Claim dari CMS, 29 assertion lolos (Livewire): tombol tersembunyi tanpa permission, saldo berubah setelah dialog dibuka → gagal tanpa claim, claim → RCL… PROCESSING / QUEUED + CLAIM_DEBIT (created_by admin) + saldo 0, SUM ledger = saldo, tombol hilang saat saldo 0.
  • Satu pengajuan per customer — Node E2E 26/26 lolos: scan pertama buka header, scan berikutnya masuk header yang sama, 2 scan paralel IMEI berbeda → tetap 1 header, 4 scan paralel IMEI sama → tepat 1 masuk, replay, REQUEST_ID_CONFLICT, IMEI_PENDING_APPROVAL (user sama & lain), pending_approval, user yang scan tidak bisa approve, tolak 1 IMEI (header tetap menunggu, total berkurang), approve dengan daftar IMEI basi ditolak, approve → 4 EARN + saldo, IMEI ditolak bisa di-scan lagi → header baru, reject pengajuan, claim, SUM ledger = saldo.
  • CMS, 89 assertion lolos (Livewire): input CMS masuk header customer yang sudah berisi scan mobile (redirect ke detail, notifikasi "N IMEI masuk ke pengajuan …"), 2 program dalam 1 header, customer lain header sendiri, list 1 baris per customer + cari IMEI + filter Sumber, maker tidak bisa approve, Tolak IMEI wajib alasan, IMEI baru masuk setelah dialog approve dibuka → gagal, approve → EARN per line + saldo, header baru setelah ditutup, bulk approve, kolom Sumber ledger. Halaman list / detail / create dirender dengan data lokal.
  • Form header + line IMEI, 68 assertion lolos (versi satu pengajuan per input) (Livewire, setelah pengajuan dipecah header/line): halaman create menampilkan Add IMEI & Attachment, product & reward terisi otomatis per line, total Rp 55.000 (2 IMEI), ganti Reward → line dihitung ulang, error per line (produk di program lain / tanpa mapping / IMEI tidak ada / IMEI dobel), submit 2 IMEI → header CMS + 2 line, IMEI di pengajuan menunggu ditolak, pembuat tidak bisa approve, approve → 2 EARN (RIS…-line_id) + saldo +55.000, pengajuan multi-IMEI dengan 1 IMEI sudah ter-reward → bulk approve gagal tanpa mengubah saldo, cari per IMEI di list, kolom Sumber ledger. E2E Node 27/27 diulang dengan format lines[].
  • CMS bulk & sumber, 60 assertion lolos (Livewire, versi sebelum header/line): form CMS → source = CMS, form menolak IMEI yang pending dari mobile, filter Sumber, bulk approve (pengajuan sendiri dilewati: "2 di-approve, 1 gagal"), bulk reject wajib alasan, detail menampilkan Sumber / alasan, reason ledger per sumber, kolom Sumber di ledger saldo.
  • Data uji sudah dibersihkan dari DB lokal.

Submit list IMEI + nota (lokal, 19-10-2026) — HTTP ke Node, DB lokal: 3 IMEI + nota → 201, 3 line nota sama, total 30.000 · kirim ulang (urutan IMEI dibalik) → 200 replay, file nota kedua terhapus · request_id sama untuk IMEI lain → 409 REQUEST_ID_CONFLICT + used_for_imei[] · 3 IMEI (1 pending, 1 tidak ada) → 422 IMEI_REJECTED 2 alasan, IMEI yang valid ikut tidak disimpan, file terhapus · IMEI dobel (" 1122" & "1122") → 400 · tanpa nota → 400 · PUT ganti nota 2 dari 3 line → nota lama tetap dipakai line ke-3 · POST /reward/imei/attachment → 404. Migration 2026_10_19_000001 up → rollback → up lolos. Data uji dibersihkan.

7. Belum Dikerjakan

Hal Kenapa / butuh apa
Integrasi Odoo — Draft Vendor Bill ✅ Dikerjakan 14-10-2026: SFA — Reward Claim ke Odoo (Draft Vendor Bill). Sisa: deploy Odoo → CMS, keputusan Finance (akun expense, jurnal, pajak, OU)
Audit trail status claim Tabel history status claim ditambahkan bersama integrasi Odoo (saat ini status hanya berubah sekali saat dibuat)
Adjustment / Reversal dari CMS Action terkontrol + alasan + approver. FDD §12: siapa yang berwenang masih terbuka
Monthly settlement / rekonsiliasi Laporan snapshot saldo per periode + exception claim tanpa bill
Eligibility (kanal / wilayah) Belum ada aturannya di FDD
Maker-checker config FDD §12 masih terbuka
Kabari tim mobile Kontrak submit IMEI berubah 19-10-2026 (imei_number array + attachment wajib, IMEI_REJECTED.errors[], submitted_lines[] menggantikan line, POST attachment dihapus). Kontrak endpoint lain di atas, terutama: scan tidak langsung menambah saldo (status SUBMITTED, IMEI_PENDING_APPROVAL, GET /reward/imei-submissions, pending_approval), request_id, dan alur BALANCE_CHANGED
Notifikasi hasil approval ke mobile Saat ini mobile harus polling GET /reward/imei-submissions; push notification belum ada