diff --git a/Mito/Sfa/Fitur/SFA — Plan Revisi 09-11-2026.md b/Mito/Sfa/Fitur/SFA — Plan Revisi 09-11-2026.md
index 309e935..c8fcbc9 100644
--- a/Mito/Sfa/Fitur/SFA — Plan Revisi 09-11-2026.md
+++ b/Mito/Sfa/Fitur/SFA — Plan Revisi 09-11-2026.md
@@ -3,7 +3,7 @@ judul: SFA — Plan Revisi 09-11-2026 (SO, Vendor Bill per Reward, History Scan
proyek: SFA API · SFA CMS · mito_odoo · SFA Mobile
terkait: Mito · Odoo 18
kategori: Fitur
-status: Plan — belum ada kode · menunggu jawaban Keputusan P1–P9
+status: Poin 3 & 5 selesai di kode (belum commit) · P1 diputuskan 10-11-2026 · menunggu P2–P13
tipe: dokumen-internal
tags:
- sfa
@@ -34,86 +34,259 @@ harus dicocokkan dulu ke kode sebelum ngoding.
| # | Permintaan | Repo | Ukuran | Status |
|---|---|---|---|---|
-| 1 | Integrasi Sales Order ke Odoo: revisi lewat CMS, atau dari Mobile langsung ke Odoo | api · cms · odoo · mobile | Besar | ⬜ Menunggu keputusan arsitektur (P1) |
-| 2 | Vendor Bill hasil claim **dipisah per Reward** (bukan 1 bill per claim) | cms · odoo | Sedang | ⬜ **Membalik keputusan K1** — perlu konfirmasi (P2, P3) |
-| 3 | API history scan IMEI: dealer bisa filter per staff, rekap IMEI yang di-scan staffnya (mobile) | api · mobile | Kecil–sedang | ⬜ Siap dikerjakan setelah [cek] relasi staff |
+| 1 | Integrasi Sales Order ke Odoo: revisi lewat CMS, atau dari Mobile langsung ke Odoo | api · cms · odoo · mobile | Besar | ✅ P1 diputuskan 10-11-2026: **mobile → Odoo langsung, CMS hanya riwayat** · ⬜ menunggu P10–P13 |
+| 2 | Vendor Bill hasil claim **dipisah per Reward** (bukan 1 bill per claim) | cms | Sedang | 🛠️ CMS selesai 10-11-2026 tanpa ubah Odoo (belum commit) — lihat [Hasil A](#Hasil%20A%20(10-11-2026)%20—%20CMS%20saja,%20Odoo%20tidak%20diubah,%20belum%20commit) |
+| 3 | API history scan IMEI: dealer bisa filter per staff, rekap IMEI yang di-scan staffnya (mobile) | api · mobile | Kecil–sedang | 🛠️ API + index CMS selesai 10-11-2026 (belum commit), mobile belum — lihat [Hasil Poin 3](#Hasil%20Poin%203%20(10-11-2026)) |
| 4 | Export untuk edit / update (by ID atau External ID) | cms **atau** odoo | Sedang | ⬜ Objek & sistem belum jelas (P5) |
-| 5 | IMEI bisa diketik manual (free text) saat scan | mobile · api | Kecil | ⬜ Siap dikerjakan |
+| 5 | IMEI bisa diketik manual (free text) saat scan | mobile · api | Kecil | 🛠️ API + CMS selesai 10-11-2026 (belum commit), mobile belum — lihat [Hasil Poin 5](#Hasil%20Poin%205%20(10-11-2026)) |
**Usulan urutan:** 5 + 3 dulu (kecil, langsung kerasa di mobile) → 2 (uang/akuntansi, scope jelas setelah P2/P3) →
4 → 1 (paling besar, butuh keputusan dulu).
---
-## 1. Sales Order: lewat CMS atau Mobile langsung ke Odoo
+## Rencana Aman — Tanpa Ubah Odoo (10-11-2026)
-**Konteks:** MoM 22-10-2026 ([[Fix sfa aftrer meet with mito]]) menyebut *"Salesman hanya menginput Product dan
-Quantity"*. **Direvisi 09-11-2026: field harga boleh disediakan di mobile** (opsional, lihat desain di bawah).
-Diskon, promo, dan pajak tetap dihitung Odoo. Alur SO yang jalan sekarang di
-`sfa-api` / CMS belum dipetakan **[cek]**. Odoo sudah punya endpoint sale order di `mito_base` (`controllers/api/`,
-lihat temuan #3 di [[SFA — Reward Claim ke Odoo (Draft Vendor Bill)#9. Temuan Selama Pengujian]]) **[cek isi & pemakainya]**.
+> [!important] Prinsip
+> `mito_odoo` **tidak diubah** kecuali diputuskan sendiri oleh Chelvyn. Semua yang bisa dikerjakan di CMS / sfa-api
+> memakai **endpoint Odoo yang sudah ada**. Belum ada kode untuk bagian ini — dokumen ini untuk direview dulu.
-### Perbandingan
-
-| | A. Mobile → CMS/API → Odoo (**rekomendasi**) | B. Mobile → Odoo langsung |
+| Poin | Bisa tanpa ubah Odoo? | Cara |
|---|---|---|
-| Kredensial | API key Odoo tetap di server | API key Odoo harus ada di aplikasi mobile, bisa dibongkar dari APK |
-| Retry / offline | Outbox di CMS (pola sama dengan claim reward: `QUEUED → SENDING → SUCCESS / RETRY / PERMANENT_ERROR`) | Mobile urus retry sendiri, rawan SO dobel |
-| Beban Odoo | Bisa di-batch & dibatasi; penting karena Odoo masih **single-process** | Setiap tap mobile = 1 request ke Odoo |
-| Visibilitas admin | SO gagal terlihat di CMS + tombol **Kirim Ulang ke Odoo** | Tidak ada tempat memantau |
-| Ubah alur | Deploy server saja | Rilis ulang aplikasi ke store |
-| Latensi | +1 hop (±1 menit kalau lewat worker, atau sinkron kalau perlu nomor SO langsung) | Langsung |
+| 2 · Vendor bill per program | ✅ Ya | CMS memanggil `POST /api/v1/reward-bills` **sekali per program** dengan Claim ID berakhiran program |
+| 1 · Buat SO | ✅ Ya | sfa-api memanggil `POST /api/v1/sale-orders` yang sudah ada |
+| 1 · Edit SO | ⚠️ Pilihan | a) API bawaan Odoo (XML-RPC / JSON-RPC, modul tidak diubah) · b) endpoint baru di `mito_base` — **diputuskan Chelvyn** |
-### Desain usulan (opsi A)
+### A. Vendor Bill per Program (poin 2) — CMS saja
-- Mobile kirim `{request_id, customer, lines: [{product_code, qty, price_unit?}]}` ke `sfa-api`.
-- **Harga boleh diinput dari mobile (revisi 09-11-2026)**, menggantikan catatan MoM 22-10 "salesman hanya input
- Product dan Quantity". `price_unit` **opsional**:
- - Diisi → Odoo pakai harga itu sebagai `price_unit` line SO.
- - Kosong → Odoo hitung dari pricelist (perilaku standar).
- - Mobile tampilkan harga default dari master product / pricelist sebagai nilai awal, salesman boleh ubah.
-- Hati-hati: helper `get_float` di `mito_base/controllers/api/core.py` menganggap `0` = kosong. Kalau salesman isi
- harga **0**, harga akan jatuh ke pricelist tanpa pesan. Endpoint SO harus parsing `price_unit` sendiri (pola sama
- dengan `amount` di endpoint reward-bills): `null` = pakai pricelist, `0` = ditolak atau diterima sesuai keputusan P9.
-- Interaksi dengan promo / diskon Odoo: harga manual = harga dasar, promo tetap dihitung di atasnya **[konfirmasi P9]**.
-- CMS simpan SO lokal + status integrasi, worker kirim ke Odoo (`POST /api/v1/sale-orders` **[cek: endpoint yang ada / baru]**).
-- Odoo: idempotency key `snk_sfa_order_ref` di `sale.order` + `unique` (pola sama dengan `snk_reward_claim_ref`).
- Harga & promo dihitung Odoo (pricelist + promotion yang sudah ada).
-- Respons balik: nomor SO, total, status. Disimpan di CMS, ditampilkan di mobile.
-- Volume 500–1.000 SO/hari: pembuatan SO di Odoo pertimbangkan `snk_queue_job` kalau > 2 detik per SO.
+**Cara kerja:** endpoint Odoo menolak 2 bill dengan Claim ID yang sama, jadi CMS mengirim Claim ID **berbeda per
+program**: `RCL261110000001-P3` (P + id program). Satu claim dengan 3 program = 3 panggilan = 3 Draft Vendor Bill.
+Pengaman dobel di Odoo tetap jalan per program.
```mermaid
flowchart TD
- A["SFA Mobile: salesman input
customer + product + qty + harga (opsional)"] --> B["sfa-api: validasi
request_id, customer aktif, product aktif, harga ≥ 0"]
- B -- "gagal" --> B1["400 / 422 ke mobile"]
- B -- "ok" --> C["CMS: simpan SO lokal
integration QUEUED"]
- C --> D["Worker CMS → POST Odoo sale order"]
- D --> E{"snk_sfa_order_ref
sudah ada?"}
- E -- "ya" --> E1["200 · SO lama dikembalikan"]
- E -- "tidak" --> F0{"price_unit
dikirim?"}
- F0 -- "ya" --> F1["pakai harga dari mobile"]
- F0 -- "tidak" --> F2["harga dari pricelist"]
- F1 & F2 --> F["Odoo hitung promo / pajak
create sale.order (draft / quotation)"]
- F --> S["CMS: SUCCESS
simpan nomor SO + total"]
- E1 --> S
- D -- "422 data salah" --> P["PERMANENT_ERROR
admin perbaiki → Kirim Ulang"]
- D -- "timeout / 5xx" --> R["RETRY bertahap"]
- R --> D
- S -.-> M["Mobile tampilkan nomor SO & total"]
+ A["Claim RCL261110000001
Rp 500.000 (saldo lock)"] --> B["CMS: hitung per program dari ledger
EARN sejak CLAIM_DEBIT sebelumnya"]
+ B --> C{"Σ per program
= nominal claim?"}
+ C -- "tidak" --> C1["PERMANENT_ERROR
split_mismatch"]
+ C -- "ya" --> D["Simpan baris reward_claim_bill per program
P1 200rb · P3 150rb · P7 150rb"]
+ D --> E["Worker: untuk tiap program yang belum SUCCESS
POST /reward-bills claim_id = RCL…-P{id}"]
+ E --> F{"Respons Odoo"}
+ F -- "201 / 200" --> G["baris program SUCCESS
simpan odoo_bill_id"]
+ F -- "422" --> H["claim PERMANENT_ERROR
admin perbaiki → Kirim Ulang"]
+ F -- "timeout / 5xx" --> I["claim RETRY
program yang sudah SUCCESS dilewati"]
+ I --> E
+ G --> J{"Semua program
SUCCESS?"}
+ J -- "ya" --> K["claim SUCCESS · DRAFT_CREATED"]
+ J -- "belum" --> E
classDef ok fill:#d1fae5,stroke:#059669,color:#064e3b
classDef err fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
classDef warn fill:#fef3c7,stroke:#d97706,color:#78350f
classDef todo fill:#f3f4f6,stroke:#9ca3af,color:#374151,stroke-dasharray:4 3
- class A,B,C,D,E,F0,F1,F2,F,S,E1,M,R,P todo
+ class B,C,D,E,F,G,J todo
+ class K ok
+ class C1,H err
+ class I warn
```
-Semua node abu-abu putus-putus = belum dikerjakan (desain usulan).
+| Hal | Rencana |
+|---|---|
+| Nominal per program | Jumlah ledger `EARN` per `reward_program_id` di jendela claim (sama dengan logika `jobsheetNo()` yang sudah ada). Ledger tidak pernah diubah, jadi hasilnya selalu sama walau dihitung ulang saat retry. Saat ini hanya ada `EARN` & `CLAIM_DEBIT` (`REVERSAL` / `ADJUSTMENT` belum pernah dibuat kode) |
+| Pengaman | Σ per program harus = nominal claim, kalau tidak → `PERMANENT_ERROR split_mismatch`, tidak dikirim |
+| Claim ID per bill | `{claim_code}-P{program_id}`. Pakai id (tidak pernah berubah), bukan kode program (bisa diedit). Nama program masuk label line bill lewat `description` |
+| Jobsheet No. | Per bill = Jobsheet program itu saja (tidak lagi dipisah koma). Program tanpa Jobsheet → kosong (P4) |
+| Tabel baru CMS | `reward_claim_bill`: `reward_claim_id`, `reward_program_id`, `odoo_claim_ref`, `amount`, `jobsheet_no`, `odoo_bill_id`, `odoo_bill_ref`, `status`. Unique `(reward_claim_id, reward_program_id)` |
+| Gagal di tengah | Program yang sudah SUCCESS dilewati saat retry; Odoo juga mengembalikan bill lama kalau Claim ID-nya sudah ada → tidak mungkin dobel |
+| Claim lama (P3) | Claim yang sudah SUCCESS (1 bill gabungan) **tidak disentuh**. Claim yang belum terkirim saat deploy ikut aturan baru |
+| Tampilan | Claim History CMS: daftar bill per program. Mobile `GET /reward/claims`: tambah `bills[]` (opsional, kontrak lama tetap) |
+| Keterbatasan | 3 bill dibuat lewat 3 panggilan terpisah, jadi sesaat bisa ada 1–2 bill dulu sebelum lengkap. Status claim baru SUCCESS setelah semua lengkap |
+
+#### Hasil A (10-11-2026) — CMS saja, Odoo tidak diubah, belum commit
+
+| File (sfa-cms) | Perubahan |
+|---|---|
+| `migrations/2026_11_10_000003_create_reward_claim_bill_table.php` | Tabel `reward_claim_bill` (unique `odoo_claim_ref` & `(reward_claim_id, reward_program_id)`), idempotent (`hasTable`) |
+| `app/Models/RewardClaimBill.php` (baru) · `RewardClaim.php` | Model + relasi `bills()` |
+| `app/Services/RewardClaimOdooService.php` | `prepareBills()` + `programAmounts()` (menggantikan `jobsheetNo()` yang menggabung Jobsheet dengan koma). `send()` kirim 1x per program yang belum punya bill. `split_mismatch` bila Σ ≠ nominal. 1 program → `odoo_bill_id` / `odoo_bill_ref` claim terisi seperti dulu; > 1 → `odoo_bill_ref` = "N Vendor Bill" |
+| `RewardClaimResource.php` | Section **Vendor Bill per Reward Program** di detail claim (program, Jobsheet, nominal, Claim ID di Odoo, bill). Notifikasi Kirim Ulang pakai `odoo_bill_ref` |
+| `PushRewardClaimsToOdoo.php` | Output worker menampilkan semua id bill claim |
+
+**Uji lokal** (Odoo palsu, data dibuat dalam transaksi lalu di-rollback — sisa 0 claim, 0 bill):
+
+| # | Skenario | Hasil |
+|---|---|---|
+| 1 | Claim Rp 500.000: program A (2 IMEI, 200rb, JS/A/001), B (150rb, JS/B/002), C (150rb, tanpa Jobsheet) | ✅ 3 POST `RCL…-P89/-P90/-P91`, Jobsheet per bill, C tanpa Jobsheet tetap 1 bill (P4), claim `SUCCESS`, ref "3 Vendor Bill" |
+| 2 | Program B timeout | ✅ A tersimpan, claim `RETRY`; kirim ulang → **hanya B** yang dikirim, claim `SUCCESS` |
+| 3 | 422 `vendor_not_found` | ✅ `PERMANENT_ERROR`; setelah diperbaiki → `SUCCESS`, 1 program → `odoo_bill_id` & ref terisi seperti format lama |
+| 4 | Nominal claim ≠ Σ ledger per program | ✅ `PERMANENT_ERROR split_mismatch`, Odoo **tidak dipanggil** |
+| 5 | Kirim ulang claim yang sudah `SUCCESS` | ✅ ditolak, 0 POST |
+
+Belum diuji: tampilan section di browser, dan kirim ke Odoo asli (dev).
+
+**Catatan deploy:** claim yang **sebelum deploy** sedang `RETRY` / `SENDING` karena timeout bisa saja sudah punya bill di
+Odoo dengan Claim ID lama (tanpa akhiran) → setelah deploy dikirim ulang dengan akhiran → **bill dobel**. Sebelum deploy
+cek: `SELECT claim_code, integration_status, error_code FROM reward_claim WHERE integration_status IN ('RETRY','SENDING');`
+Kalau ada, cek Bill Reference-nya di Odoo dulu. `PERMANENT_ERROR` karena 422 aman (Odoo tidak membuat bill).
+
+### B. Buat SO dari Mobile (poin 1) — sfa-api + CMS saja
+
+| Hal | Rencana |
+|---|---|
+| Alur | Mobile → `POST /transaction/sales-order` (sfa-api) → validasi → catat log (`request_id` unik) → panggil `POST /api/v1/sale-orders` Odoo **langsung** → nomor SO balik ke mobile |
+| Mapping | Customer → `partner_id` = `customer.cust_code` (sudah id Odoo dari sync). Product → **[cek]** `product_id` CMS = id `product.product` Odoo atau `product.template`? Endpoint butuh `product.product` |
+| Kirim ulang dari mobile | `request_id` sama → sfa-api balikin hasil yang sudah tercatat, tidak memanggil Odoo lagi |
+| Odoo mati / koneksi ditolak | Pasti belum sampai Odoo → `RETRY` otomatis lewat worker CMS, mobile dapat `202` |
+| **Timeout** (tidak tahu SO sudah dibuat atau belum) | **Tidak di-retry otomatis** → status `NEEDS_CHECK`. Admin cek di Odoo, lalu klik **Tandai sudah ada** (isi nomor SO) atau **Kirim Ulang**. Ini satu-satunya celah dobel tanpa ubah Odoo; dengan cara ini SO dobel tidak terjadi otomatis |
+| Harga | Harga kosong → pricelist. **Harga 0 belum bisa** (endpoint Odoo menganggap 0 = kosong). Kalau P9 memutuskan 0 harus boleh, baru perlu perubahan Odoo |
+| Salesperson | Default customer (P11), endpoint sudah begitu |
+| CMS | Menu Sales Order: riwayat dari log + data lama (read-only), tombol Kirim Ulang / Tandai sudah ada untuk `RETRY` / `NEEDS_CHECK` |
+
+### Yang masih butuh keputusan sebelum coding
+
+| # | Hal |
+|---|---|
+| P3, P4 | Pakai usulan (claim lama dibiarkan, program tanpa Jobsheet tetap 1 bill)? |
+| P9 | Harga 0 boleh? Kalau tidak → sfa-api menolak, Odoo tidak perlu diubah |
+| P17 | Edit SO: pakai **a** (API bawaan Odoo) atau **b** (endpoint baru, ubah Odoo)? Plus: SO yang sudah diberi promo oleh admin boleh diedit dari mobile? (nilai promo bisa basi) |
+| [cek] | Product id CMS = `product.product` Odoo? (dicek dari kode sync, tanpa ubah apa pun) |
+
+---
+
+## 1. Sales Order: Mobile → Odoo langsung, CMS hanya riwayat
+
+> [!success] Keputusan P1 (10-11-2026)
+> SO **tidak lagi diedit / diproses di CMS**. Order salesman dari mobile **langsung jadi SO di Odoo**, CMS **cukup
+> menampilkan riwayat** (read-only). Alasan dari Mito: fitur SO di CMS sekarang terlalu banyak, padahal yang dibutuhkan
+> cuma riwayat.
+
+**Konteks:** MoM 22-10-2026 ([[Fix sfa aftrer meet with mito]]) menyebut *"Salesman hanya menginput Product dan
+Quantity"*. **Direvisi 09-11-2026: field harga boleh disediakan di mobile** (opsional). Diskon bertingkat, promo,
+pajak tetap dihitung Odoo.
+
+### Kondisi sekarang (dicek 10-11-2026)
+
+| Sistem | Yang ada |
+|---|---|
+| **CMS** (`SalesTableResource` + menu terkait) | Mini-ERP SO sendiri: Create / **Edit** / Delete / **Confirm SO** / **Create Packing** / **Cancel SO**, menu **Sales Packing Journal**, **Sales Invoice Journal**, **Sales Tracking**, Invent Trans / On Hand. SO tersimpan di tabel CMS `sales_table` + line, **tidak masuk Odoo** **[cek: ada jalur ke Odoo?]** |
+| **sfa-api** (mobile) | `GET/POST /transaction/sales-order`, `/sales-order/update`, `/sales-order/delete`, `/sales-order/delete-lines`, `/sales-order-topten`, `/invoice` + download PDF → semua ke tabel CMS |
+| **Odoo** `mito_base` | **Sudah ada** `POST /api/v1/sale-orders` (+ `GET` list & detail): SO **draft**, OU / area / sub-area / salesperson / warehouse / diskon bertingkat diisi otomatis dari master customer (replay onchange form SO), `price_unit` opsional (kosong = pricelist), tier validation jalan normal |
+
+**Celah endpoint Odoo yang harus ditutup sebelum dipakai mobile:**
+
+| # | Celah | Akibat | Perbaikan |
+|---|---|---|---|
+| 1 | **Tidak ada idempotency** | Sinyal salesman putus → kirim ulang → **SO dobel** di Odoo | Field `sale.order.snk_sfa_order_ref` (Char, `copy=False`, readonly) + `unique`, diisi `request_id` mobile. Retry → SO lama dikembalikan `200`. Paralel → `409` (pola sama dengan `snk_reward_claim_ref`) |
+| 2 | `get_float` menganggap `0` = kosong | Harga **0** diam-diam diganti harga pricelist | Parse `price_unit` sendiri: `null` = pricelist, angka ≥ 0 dipakai (P9) |
+| 3 | Salesperson diambil dari master customer | — | **Bukan celah** — memang begitu yang diinginkan (P11, Oliver 10-11-2026). Perubahan salesperson dilakukan manual oleh admin / kacab di Odoo |
+| 4 | `get_float` qty sama | qty `0` → pesan "required", bukan "> 0" | Ikut diperbaiki bersama #2 |
+
+### Desain baru
+
+```mermaid
+sequenceDiagram
+ participant M as SFA Mobile
+ participant A as sfa-api
+ participant DB as DB CMS (sfa_order_log)
+ participant O as Odoo POST /api/v1/sale-orders
+ M->>A: POST /transaction/sales-order
{request_id, customer, lines[product, qty, price_unit?]}
+ A->>A: validasi (customer & product aktif, qty > 0, harga ≥ 0)
+ A->>DB: simpan log request_id · SENDING
+ A->>O: kirim (sinkron, timeout ±20 dtk)
sfa_order_ref = request_id
+ alt sukses (201 baru / 200 sudah ada)
+ O-->>A: nomor SO, total, state draft
+ A->>DB: SUCCESS + odoo_order_id + nomor SO
+ A-->>M: 201 · nomor SO & total
+ else 422 data salah (customer/product tidak valid)
+ O-->>A: error.code
+ A->>DB: FAILED + pesan
+ A-->>M: 422 · pesan → salesman perbaiki
+ else timeout / Odoo down
+ A->>DB: RETRY
+ A-->>M: 202 · "order diterima, sedang dikirim ke Odoo"
+ Note over DB,O: worker CMS kirim ulang tiap menit
request_id sama → tidak dobel
+ end
+ Note over M,O: Confirm / delivery / invoice di Odoo. Edit dari mobile diteruskan ke Odoo (lihat di bawah). Hapus / batal SO hanya di Odoo. CMS hanya riwayat
+```
+
+**Prinsip:**
+- **Odoo = satu-satunya tempat SO.** CMS tidak bisa membuat / mengubah SO. Mobile bisa buat dan edit (**tidak bisa hapus**), tapi
+ semuanya langsung ke Odoo (tidak ada salinan yang diubah sendiri).
+- **Tetap lewat sfa-api, bukan mobile → Odoo langsung secara teknis**: API key Odoo tidak boleh ada di APK. Bagi user
+ tetap "langsung": tidak ada langkah di CMS, nomor SO Odoo langsung balik ke mobile.
+- **Sinkron dulu, fallback antre:** normalnya salesman langsung dapat nomor SO. Kalau Odoo lambat / down, order tidak
+ hilang: tersimpan `RETRY`, dikirim worker (pola sama dengan claim reward), mobile dapat `202`.
+- **Riwayat** di CMS & mobile: daftar dari log lokal (cepat, bisa filter area / salesman), **status terkini**
+ (draft / confirmed / dikirim / ditagih) dibaca **realtime dari Odoo** `GET /api/v1/sale-orders/` saat detail
+ dibuka — tanpa cron sync (sama dengan keputusan Jobsheet).
+- Volume 500–1.000 SO/hari: 1 request = 1 SO, ringan. Kalau create SO di Odoo > 2 detik, pindah ke `snk_queue_job`.
+
+### Edit SO dari Mobile (tanpa hapus)
+
+Diputuskan 10-11-2026 (P12): mobile **bisa edit SO**, perubahan langsung ke Odoo. Mobile **tidak bisa menghapus /
+membatalkan SO** — pembatalan hanya oleh admin / kacab di Odoo. Odoo tetap satu-satunya sumber data; mobile tidak
+pernah mengubah salinan lokal saja.
+
+```mermaid
+flowchart TD
+ A["Mobile: edit SO
(header / tambah / ubah / buang line)"] --> B{"SO sudah punya
nomor Odoo?"}
+ B -- "belum (masih RETRY)" --> B1["409 SO_NOT_SYNCED
tunggu terkirim dulu"]
+ B -- "SO lama, hanya di CMS" --> B2["409 SO_READ_ONLY
(P16)"]
+ B -- "ya" --> C["sfa-api → Odoo
cek state + validation_status + write_date"]
+ C --> D{"SO masih Draft
& belum diajukan approval?"}
+ D -- "tidak" --> D1["409 SO_LOCKED
ubah lewat Odoo (admin / kacab)"]
+ D -- "ya" --> E{"write_date sama dengan
yang dilihat mobile?"}
+ E -- "tidak, sudah diubah di Odoo" --> E1["409 SO_CHANGED
+ data terbaru → mobile refresh"]
+ E -- "ya" --> G["PUT /api/v1/sale-orders/:id
ganti header & semua lines (min. 1 line)"]
+ G --> S["200 · SO terbaru (total dihitung ulang Odoo)"]
+ C -- "Odoo down / timeout" --> R["503 ODOO_UNAVAILABLE
mobile coba lagi"]
+ X["Mobile: hapus SO"] --> X1["403 SO_DELETE_NOT_ALLOWED
batal SO hanya di Odoo"]
+
+ classDef ok fill:#d1fae5,stroke:#059669,color:#064e3b
+ classDef err fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
+ classDef warn fill:#fef3c7,stroke:#d97706,color:#78350f
+ classDef todo fill:#f3f4f6,stroke:#9ca3af,color:#374151,stroke-dasharray:4 3
+ class A,B,C,D,E,G,X todo
+ class S ok
+ class B1,B2,D1,E1,X1 err
+ class R warn
+```
+
+Aturan:
+
+| Hal | Aturan | Alasan |
+|---|---|---|
+| Kapan boleh diedit (P14) | `state = draft` **dan** `validation_status = no` | Setelah diajukan tier validation, Odoo sendiri sudah mengunci edit (termasuk ditolak) |
+| Edit = ganti penuh | `PUT` mengirim header + **semua** lines (bukan per baris). Odoo hapus lines lama → buat ulang → harga, diskon bertingkat, promo, pajak dihitung ulang. **Minimal 1 line** | Satu aturan sederhana, aman di-retry (hasil sama), tidak ada line yatim. Buang semua line = sama dengan hapus SO → ditolak |
+| Bentrok dengan edit di Odoo | Mobile kirim `write_date` yang dia lihat. Beda dengan Odoo → `409 SO_CHANGED` + data terbaru | Admin bisa mengubah SO di Odoo pada saat bersamaan; tanpa cek ini edit mobile menimpa perubahan admin |
+| **Hapus SO (P12)** | **Tidak bisa dari mobile** → `403 SO_DELETE_NOT_ALLOWED`. Batal SO dilakukan admin / kacab di Odoo (Cancel) | Keputusan 10-11-2026 |
+| SO belum terkirim ke Odoo | `409 SO_NOT_SYNCED` | Hindari edit menumpuk di antrean; biasanya hanya beberapa detik / menit |
+| SO lama (P16) | Read-only | Tidak punya pasangan di Odoo |
+| Odoo down | Edit **sinkron**, tidak diantre → `503`, mobile coba lagi | Edit yang tertunda lalu menimpa perubahan lain lebih berbahaya daripada gagal jelas |
+
+Tambahan di Odoo `mito_base`: `PUT /api/v1/sale-orders/` (dengan cek di atas), **tanpa endpoint DELETE / cancel**.
+Respons `GET` sudah punya `state`, `validation_status`, `write_date`. Di sfa-api: `update` & `delete-lines` diarahkan
+ke Odoo (`delete-lines` = edit dengan lines tersisa, minimal 1); `POST /transaction/sales-order/delete` →
+`403 SO_DELETE_NOT_ALLOWED`.
+
+### Perubahan per repo
+
+| Repo | Perubahan |
+|---|---|
+| **mito_odoo** `mito_base` | `snk_sfa_order_ref` + unique (naik versi, tanpa migration destruktif); endpoint terima `sfa_order_ref`; parse `price_unit` / `qty` tanpa `get_float`; respons `created` true/false; test `TransactionCase` |
+| **sfa-api** | `POST /transaction/sales-order` diganti: validasi → log → kirim Odoo → nomor SO. `update` / `delete-lines` diteruskan ke Odoo dengan aturan kunci (P12, P14, P16); `delete` → `403 SO_DELETE_NOT_ALLOWED`. `GET` list dari log, detail + status dari Odoo |
+| **sfa-cms** | Tabel `sfa_order_log`. Menu **Sales Order** jadi **read-only** (list + detail + status Odoo + tombol **Kirim Ulang ke Odoo** untuk `RETRY` / `FAILED`). Action Create / Edit / Delete / Confirm / Create Packing / Cancel **dihilangkan**. Grup **Transaction Sales** hanya
+menyisakan **Sales Order**; menu **Sales Packing Journal** disembunyikan (kode & data tidak dihapus). Menu lain tidak
+diubah (P10). Worker `odoo:push-sales-orders` |
+| **mobile** | Form order: customer, product, qty, harga opsional. Edit SO tetap ada, **tombol hapus SO dihilangkan**; kirim `write_date` saat edit, tangani `409 SO_LOCKED` / `SO_CHANGED` / `SO_NOT_SYNCED` / `SO_READ_ONLY` dan `503`. Create: tangani `201` / `202` / `422`. Riwayat dari `GET` |
---
## 2. Vendor Bill dipisah per Reward
+> [!note] Diganti 10-11-2026
+> Desain teknis di bawah (ubah constraint + migration `mito_base`) **tidak dipakai**. Yang dipakai:
+> [Rencana Aman A — tanpa ubah Odoo](#A.%20Vendor%20Bill%20per%20Program%20(poin%202)%20—%20CMS%20saja).
+
**Permintaan:** 1 claim Rp 500.000 yang saldonya berasal dari **3 Reward (3 Jobsheet)** → di Odoo terbentuk
**3 Draft Vendor Bill**, masing-masing sebesar nominal reward-nya. Bukan 1 bill Rp 500.000.
@@ -122,7 +295,7 @@ Semua node abu-abu putus-putus = belum dikerjakan (desain usulan).
> koma. Permintaan ini = opsi **a/b** K1 yang dulu tidak dipilih. Perlu konfirmasi siapa yang memutuskan dan tanggalnya,
> lalu K1 diperbarui.
-### Interpretasi yang dipakai (perlu dikonfirmasi — P2)
+### Interpretasi yang dipakai (P2 dikonfirmasi 10-11-2026: per Reward Program)
- **"Reward" = Reward Program.** Jobsheet nempel di header program (`reward_program.jobsheet_no`), jadi
1 program = 0 atau 1 Jobsheet.
@@ -236,6 +409,35 @@ flowchart TD
class A,B,C,D,E,F,G,H todo
```
+### Hasil Poin 3 (10-11-2026)
+
+**Beda dari desain awal:** `/reward/imei-submissions` **tidak diubah** (bentuknya per pengajuan, dipakai mobile
+sekarang). Dibuat 2 endpoint baru yang berbentuk **per IMEI**. Kolom "siapa yang scan" ternyata **sudah ada**
+(`reward_imei_submission_line.submitted_by`, terisi sejak Staff Dealer), jadi tidak perlu kolom baru.
+
+| Endpoint | Isi |
+|---|---|
+| `GET /reward/imei-scans?page&limit&staff_id&status&date_from&date_to` | List per IMEI, terbaru di atas. Item = `lines[]` lama + `submission_code` + `scanned_by {user_id, name}`. Dealer: semua IMEI di pengajuannya (scan dirinya, staff, input admin CMS), `staff_id` = staff miliknya / dirinya sendiri, staff dealer lain → `403 STAFF_NOT_OWNED`. Staff: dipaksa hanya scan sendiri, `staff_id` diabaikan |
+| `GET /reward/imei-scans/summary?date_from&date_to` | Rekap per orang: `role` `DEALER` / `STAFF` / `CMS_ADMIN`, `total_scan`, `submitted`, `approved`, `rejected`, `approved_amount` + `totals`. **Semua staff dealer ikut walau belum pernah scan** (angka 0) → dipakai juga untuk dropdown filter `staff_id`. Staff: hanya barisnya sendiri |
+
+Tanggal = WIB, inklusif (`date_from` ≤ `date_to`, selain itu 400). Kolom `TIMESTAMP` + session `+07:00` di CMS dan API,
+jadi batas hari konsisten.
+
+| Repo | File |
+|---|---|
+| sfa-api | `serviceReward.js` (`getImeiScans`, `getImeiScanSummary`, `resolveScanScope`, `wibDayBounds`), `handler/reward/reward.js`, `validatorReward.js`, `routes/sfa.js`, `MrewardImeiSubmissionLine.js` (relasi `submitter` → `users`), `swagger/openapi.js` |
+| sfa-cms | Migration `2026_11_10_000002_add_submitted_by_index_to_reward_imei_submission_line_table` — index `(submitted_by, created_at)`, idempotent (`Schema::hasIndex`) |
+
+**Uji lokal** (data staff sementara untuk dealer 445, dihapus lagi setelah uji): rekap dealer (dealer 8 IMEI + staff 1),
+filter tanggal 19-10 → 3 IMEI, rekap staff hanya dirinya, list dealer semua 9 / filter staff 1 / filter diri sendiri +
+APPROVED + 16-10 → 5, staff mengirim `staff_id` dealer → tetap hanya miliknya, `staff_id` user lain → `403
+STAFF_NOT_OWNED`, dealer lain tidak melihat data 445. Validator: tanpa `page`, `staff_id` bukan angka, tanggal
+terbalik, format tanggal salah → 400. Migration index dijalankan ulang → *Nothing to migrate*.
+
+**Info ke tim mobile:** layar **Riwayat Scan** dealer → `GET /reward/imei-scans/summary` (kartu rekap + dropdown
+staff), pilih staff → `GET /reward/imei-scans?staff_id=…`. Nominal per IMEI masih tampil juga untuk staff (sama
+dengan perilaku `/reward/imei-submissions` sekarang) sampai **K5** diputuskan.
+
---
## 4. Export untuk Edit / Update (by ID atau External ID)
@@ -299,20 +501,53 @@ flowchart TD
Hijau = sudah ada, abu-abu putus-putus = baru, merah = ditolak.
+### Hasil Poin 5 (10-11-2026)
+
+Dikerjakan dengan keputusan sementara: **P7 = tidak dibatasi, cukup ditandai**, **P8 = tanpa cek panjang / Luhn**,
+karena contoh IMEI di master 11 digit (`11220018494`), bukan 15 digit.
+
+| Repo | File | Perubahan |
+|---|---|---|
+| sfa-api | `routes/validator/validatorReward.js` | Spasi di dalam IMEI dibuang (`check` & `submit`) sebelum validasi, jadi `1122 0018 494` = `11220018494`; cek dobel jalan setelah spasi dibuang. Field opsional `manual_imei_number` (harus bagian dari `imei_number`, kalau tidak → 400) |
+| sfa-api | `routes/services/serviceReward.js` · `handler/reward/reward.js` | Line dari IMEI di `manual_imei_number` → `input_method = MANUAL`, sisanya `SCAN`. Respons `lines[]` ikut `input_method` |
+| sfa-api | `routes/helpers/enums/reward.js` · `models/MrewardImeiSubmissionLine.js` | `RewardImeiInputMethodEnum` + kolom model |
+| sfa-api | `swagger/openapi.js` | Dokumentasi `manual_imei_number`, `input_method` |
+| sfa-cms | `migrations/2026_11_10_000001_add_input_method_to_reward_imei_submission_line_table.php` | Kolom `input_method` VARCHAR(10) default `SCAN`, line lama `source = CMS` → `MANUAL`. Idempotent (`hasColumn`) |
+| sfa-cms | `RewardImeiSubmissionService.php` | Input admin CMS → `MANUAL` |
+| sfa-cms | `LinesRelationManager.php` | Kolom badge **Input** (Scan abu-abu / Ketik manual kuning) + filter **Input** di IMEI Registration |
+
+**Uji lokal:** migration jalan + dijalankan ulang = *Nothing to migrate*; validator 6 skenario (kontrak lama tanpa
+`manual_imei_number` tetap lolos, spasi dibuang, manual di luar list 400, dobel setelah buang spasi 400, IMEI isi spasi
+saja 400); model menulis `MANUAL` / default `SCAN` (transaksi di-rollback). **Belum:** submit end-to-end, karena DB lokal
+tidak punya IMEI yang lolos `checkImei` (program / mapping lokal sudah tidak aktif).
+
+**Deploy:** CMS dulu (migration), baru API. Kalau API naik duluan, insert line gagal karena kolom belum ada.
+
+**Info ke tim mobile:** tambah tombol **Ketik Manual** di layar scan → panggil `GET /reward/imei/check` yang sama →
+masuk list dengan penanda lokal. Saat submit, kirim IMEI yang diketik juga di `manual_imei_number`. Tidak wajib:
+aplikasi lama tanpa field ini tetap jalan (semua tercatat `SCAN`).
+
---
## Keputusan yang Dibutuhkan
| # | Poin | Pertanyaan | Usulan | Status |
|---|---|---|---|---|
-| **P1** | 1 | SO lewat CMS/API atau Mobile langsung ke Odoo? Masalah apa di alur sekarang yang memicu usulan ini? | Lewat CMS/API (opsi A) | ⏳ |
-| **P2** | 2 | "Reward" = **Reward Program**? Bill dipisah per program (bukan per Jobsheet)? | Ya, per program | ⏳ |
-| **P3** | 2 | Siapa yang memutuskan K1 dibalik + tanggal? Claim lama yang sudah 1 bill: dibiarkan? | Dibiarkan, berlaku untuk claim baru | ⏳ |
-| P4 | 2 | Saldo program tanpa Jobsheet: tetap jadi bill sendiri? | Ya, 1 bill per program, Jobsheet No. kosong | ⏳ |
+| **P1** | 1 | SO lewat CMS/API atau Mobile langsung ke Odoo? | SO tidak diedit di CMS, langsung jadi SO Odoo, CMS cukup riwayat (fitur SO CMS terlalu banyak) | ✅ 10-11-2026 |
+| **P10** | 1 | Menu CMS mana yang disembunyikan? | Grup **Transaction Sales** hanya menyisakan **Sales Order** (read-only). **Sales Packing Journal** disembunyikan. Grup **Inventory Transactions** (Inventory Journal, Inventory Transaction History, Inventory On Hands) juga disembunyikan karena tidak dipakai. Tombol **New Sales Order** dihapus (`canCreate() = false`). Kode & data tidak dihapus | ✅ 10-11-2026 (CMS, belum commit) |
+| **P11** | 1 | Salesperson di SO Odoo = salesman yang input di mobile, atau salesman default customer (perilaku endpoint sekarang)? | **Diputuskan Oliver 10-11-2026: pakai salesperson yang ada di master customer** (perilaku endpoint sekarang, tanpa perubahan kode). Kalau perlu diganti, **diubah manual oleh admin / kacab** yang memproses SO di Odoo. Field tambahan "SFA Salesman" di SO **tidak dibuat** (tidak diminta); siapa yang input tetap tercatat di log SO CMS. Data pendukung (DB `MITO_PRODUCTION_20082026`): (1) 1.487 dari 1.561 SO 90 hari terakhir (**95%**) salesperson-nya memang = default customer; 67 SO (4%) beda orang. (2) **Tidak ada kunci yang andal** untuk mencocokkan salesman SFA → `hr.employee`: semua 39 salesperson punya `identification_id` = `00` (tidak unik), 4 kosong, hanya 10 punya user login; sync customer CMS mencocokkan pakai **nama** dan cuma 29/42 cocok. Kalau nanti kode employee Odoo dirapikan (unik, sama dengan `empl_code` CMS), bisa diganti jadi salesman yang input | ✅ 10-11-2026 |
+| **P12** | 1 | Mobile bisa edit / hapus SO? | **Edit: bisa, perubahan ikut ke Odoo. Hapus: tidak boleh dari mobile** (10-11-2026) — batal SO hanya oleh admin / kacab di Odoo. Aturan di [Edit SO dari Mobile](#Edit%20SO%20dari%20Mobile%20(tanpa%20hapus)) | ✅ 10-11-2026 |
+| **P14** | 1 | Kapan SO masih boleh diedit dari mobile? | **Diputuskan 10-11-2026: selama SO masih Draft (Quotation).** Catatan teknis: di Odoo SO yang sudah **diajukan approval** tetap berstatus Draft, tapi `base_tier_validation` **sudah mengunci edit** sejak ada review (menunggu, disetujui, maupun **ditolak**) — `ValidationError` "not allowed to write those fields under validation". Jadi aturan efektifnya: **Draft dan belum diajukan approval** (`validation_status = no`). Selain itu → `409 SO_LOCKED`, ubah lewat Odoo. SO ditolak bisa diedit lagi setelah admin Cancel → Set to Draft di Odoo (review ikut terhapus). Tier validation **tidak di-bypass** | ✅ 10-11-2026 |
+| ~~P15~~ | 1 | ~~"Hapus" dari mobile = Cancel atau hapus permanen?~~ | **Gugur** — mobile tidak bisa hapus SO (P12) | ✅ 10-11-2026 |
+| P16 | 1 | SO lama (sebelum go-live, hanya di tabel CMS, tidak ada di Odoo) boleh diedit? | **Read-only** (10-11-2026). SFA masih tahap dev, jadi SO lama di CMS = data dev / uji, cukup tampil sebagai riwayat | ✅ 10-11-2026 |
+| P13 | 1 | Fitur Invoice di mobile (`/invoice` + download PDF) ikut ambil dari Odoo? | Tahap berikutnya, di luar scope ini | ⏳ |
+| **P2** | 2 | "Reward" = **Reward Program**? Bill dipisah per program (bukan per Jobsheet)? | **Ya, per Reward Program** (10-11-2026). 1 claim = 1 Draft Vendor Bill per program asal saldo | ✅ 10-11-2026 |
+| **P3** | 2 | Claim lama yang sudah 1 bill? | **Dibiarkan**, aturan baru untuk claim yang dikirim setelah deploy (usulan, dijalankan 10-11-2026) | ✅ 10-11-2026 |
+| P4 | 2 | Saldo program tanpa Jobsheet? | **Tetap 1 bill sendiri**, Jobsheet No. kosong (usulan, dijalankan 10-11-2026) | ✅ 10-11-2026 |
| **P5** | 4 | Export untuk objek apa, di CMS atau Odoo? `id` kosong boleh create? | — | ⏳ |
| P6 | 3 | Dealer perlu lihat nominal reward per IMEI staff? (terkait K5) | Dealer ya, staff ikut K5 | ⏳ |
| P7 | 5 | Input manual dibatasi? (role tertentu / jumlah per hari) | Tidak dibatasi, cukup ditandai `MANUAL` | ⏳ |
-| P8 | 5 | Format IMEI di master selalu 15 digit? | — **[cek data]** | ⏳ |
+| P8 | 5 | Format IMEI di master selalu 15 digit? | **Tidak.** Data master lokal (10-11-2026): 465 × 11 digit, 114 × 12 digit, 13 × 9 digit, 3 × 10 digit, dan **beberapa berhuruf** (`B311804680`, `B03000176740`, `S1180000922`). Ini nomor seri produk, bukan IMEI HP → **tanpa cek panjang / Luhn**, keyboard input manual mobile harus **alfanumerik**. Ada 1 data aneh berisi spasi `MTWM202675849800 JANGAN` (tidak akan cocok setelah spasi dibuang — kemungkinan data uji) | ✅ dijawab dari data · cek production |
| P9 | 1 | Harga dari mobile: boleh **0** / di bawah harga pricelist? Promo Odoo tetap dihitung di atas harga manual? Perlu approval kalau harga diubah? | Opsional, ≥ 0, promo tetap jalan, tanpa approval tambahan (SO tetap lewat tier validation yang ada) | ⏳ |
| ✅ | 1 | Field harga di mobile | **Diputuskan 09-11-2026: boleh disediakan** (opsional) | ✅ |
@@ -324,7 +559,7 @@ Hijau = sudah ada, abu-abu putus-putus = baru, merah = ditolak.
| 2 | Poin 3: `scanned_by` + filter + summary | api · cms → kabari mobile | [cek] relasi staff |
| 3 | Poin 2: split bill per program | odoo (`mito_base` naik versi + migration) → cms | P2, P3, P4 |
| 4 | Poin 4: export/import | cms / odoo | P5 |
-| 5 | Poin 1: SO via outbox CMS | api · cms · odoo | P1 + pemetaan alur SO sekarang |
+| 5 | Poin 1: SO mobile → Odoo, CMS read-only | odoo (idempotency dulu) → api → cms → mobile | P10–P12 |
Aturan deploy (sama seperti integrasi sebelumnya):