docs : SFA keputusan K5/P6, P5 export Reward Program dan centang update

main
chelvyn 2026-11-11 11:33:10 +07:00
parent 84b3716d0e
commit 4caebcbe7e
2 changed files with 26 additions and 9 deletions

View File

@ -37,7 +37,7 @@ harus dicocokkan dulu ke kode sebelum ngoding.
| 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) |
| 4 | Export untuk edit / update (by ID atau External ID) | cms | Kecil | 🛠️ P5 terjawab 11-11-2026: Export/Import **Reward Program** CMS. Import sudah upsert; bug export diperbaiki (belum commit) |
| 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) →
@ -387,7 +387,7 @@ Aturan keamanan:
- `dealer_id` diambil dari **token**, bukan dari parameter. Kalau dari parameter, dealer A bisa intip data dealer B.
- `staff_id` yang bukan staff dealer tersebut → `403 STAFF_NOT_OWNED`.
- Nominal reward di respons untuk role staff mengikuti keputusan **K5** (masih terbuka).
- Nominal reward di respons untuk role staff mengikuti keputusan **K5** ✅ 11-11-2026: staff melihat nominal IMEI miliknya saja, dealer dirinya + staff.
- Index MySQL: `(customer_user_id, created_at)` dan `(scanned_by_user_id, created_at)` di tabel line **[cek nama kolom]**.
- Wajib pagination (`limit` maks 100).
@ -401,7 +401,7 @@ flowchart TD
F -- "tidak" --> F1["403 STAFF_NOT_OWNED"]
F -- "ya" --> G["Line milik dealer<br/>AND scanned_by = staff_id"]
B -- "lainnya" --> B1["403"]
C & E & G --> H["200 · list + pagination<br/>(nominal ikut keputusan K5)"]
C & E & G --> H["200 · list + pagination<br/>(staff: nominal milik sendiri · K5)"]
classDef err fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
classDef todo fill:#f3f4f6,stroke:#9ca3af,color:#374151,stroke-dasharray:4 3
@ -436,7 +436,7 @@ terbalik, format tanggal salah → 400. Migration index dijalankan ulang → *No
**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.
dengan perilaku `/reward/imei-submissions` sekarang) — sesuai **K5** (11-11-2026): staff boleh lihat nominal miliknya saja.
---
@ -445,7 +445,24 @@ dengan perilaku `/reward/imei-submissions` sekarang) sampai **K5** diputuskan.
**Yang sudah ada:** Export/Import Excel **Reward Program** di CMS (upsert by `program_code` + `mapping_id`,
1 error = semua ditolak). Lihat [[SFA — Revisi Reward MoM 22-10-2026#Poin 6 · Export & Import Reward Program (Excel)]].
**Belum jelas (P5): export data apa, di sistem mana?**
> [!success] P5 terjawab 11-11-2026 — Export/Import **Reward Program** di CMS
> Import **sudah** bisa update (upsert): program by `program_code`, baris produk by `mapping_id` (kosong = baris
> baru). Yang membuat user mengira "import hanya bisa tambah data": **Export error untuk semua user** sejak Area-Based
> Visibility (`377b146`, ter-deploy dev 03-11-2026):
> `AreaAccess::scopeMappings(): Argument #1 ($query) must be of type Builder, HasMany given` — closure eager-load
> `with(['productMappings' => fn ($q) => ...])` di `RewardProgramExcelService::export()` menerima Relation, bukan
> Builder. Tanpa file Export, user tidak pernah dapat `mapping_id` untuk update.
> **Fix:** `scopeMappings(Builder|Relation $query)`. Uji lokal: tanpa fix → error yang sama persis; dengan fix →
> export 13 baris, ubah `reward_amount` mapping #47 10.000 → 11.111, import balik → `programs_updated 1,
> mappings_updated 13, mappings_created 0`, jumlah baris tetap 13 (transaksi di-rollback).
>
> **Tambahan 11-11-2026 — centang "Untuk update data" di Export** (gaya Odoo *import-compatible export*), di tombol
> Export header & "Export terpilih". Dicentang → ikut kolom `mapping_id` (bisa diedit lalu Import balik). Tidak
> dicentang (default) → export biasa tanpa `mapping_id`, untuk dibaca / laporan; kalau di-Import ditolak dengan
> pesan "Pakai file Export dengan centang Untuk update data". Uji lokal: biasa 14 kolom, update 15 kolom, import file
> biasa ditolak (0 tersimpan), import file update → 13 updated, 0 created.
Pilihan awal sebelum P5 terjawab (arsip):
| Kalau di… | Rencana |
|---|---|
@ -544,8 +561,8 @@ aplikasi lama tanpa field ini tetap jalan (semua tercatat `SCAN`).
| **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 | ⏳ |
| **P5** | 4 | Export untuk objek apa, di CMS atau Odoo? `id` kosong boleh create? | Reward Program CMS; `mapping_id` kosong = baris baru | ✅ 11-11-2026 |
| P6 | 3 | Dealer perlu lihat nominal reward per IMEI staff? (terkait K5) | Dealer ya, staff ikut K5 | ✅ 11-11-2026: dealer lihat nominal dirinya + semua staff; staff hanya miliknya |
| P7 | 5 | Input manual dibatasi? (role tertentu / jumlah per hari) | Tidak dibatasi, cukup ditandai `MANUAL` | ⏳ |
| 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) | ⏳ |

View File

@ -62,7 +62,7 @@ Legenda: ✅ selesai · 🟡 sebagian · ⬜ belum
| **K2** | Jobsheet di Vendor Bill = **AP Form** (terhubung budget) atau **teks** saja? | AP Form → saat Finance post bill, budget Jobsheet terpotong & dicek cukup / tidak | a) AP Form (`snk_ap_form`) · b) **field teks "Jobsheet No."** | — | ✅ **Diputuskan 30-10-2026 (Oliver): teks referensi.** "1 jobsheet bisa banyak reward, inputan nomor jobsheet pure hanya untuk referensi di vendor bill" |
| K3 | Nominal reward **per customer × produk** (1 program, harga beda per dealer) | Sekarang nominal hanya per produk | a) customer di baris produk · b) tier dealer (Gold/Silver) | — | ✅ **Diputuskan 30-10-2026 (Oliver): a.** Customer nempel ke baris produk, tab Customer dihapus. Detail di [Poin 5](#Poin%205%20·%20Reward%20multi%20customer%20(customer%20per%20baris%20produk)) |
| K4 | IMEI yang **belum pernah masuk gudang** ikut terhitung "terjual" (`product_qty = 0`) | Celah: IMEI hasil generate sebelum GR bisa discan | Tambah syarat "pernah keluar lewat DO" | Tutup celah (1 query per halaman sync) | ⏳ Belum diputuskan |
| K5 | Nominal reward per IMEI masih terlihat Staff Dealer di riwayat pengajuan | Poin 10 hanya menyebut saldo | Sembunyikan / biarkan | — | ⏳ Belum diputuskan |
| 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
@ -609,4 +609,4 @@ Hasil uji lokal 28-10-2026 (user 26 dijadikan staff dealer 445 CV MAJU JAYA seme
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).
7. Keputusan K4 (celah IMEI belum masuk gudang), ~~K5 (nominal terlihat staff)~~ ✅ 11-11-2026.