Doc_chelvyn/Mito/Sfa/Fitur/SFA — Revisi Self Registrat...

5.5 KiB

judul proyek terkait kategori status tipe tags diperbarui
SFA — Revisi Self Registration MoM 22-10-2026 (checklist) SFA API · SFA CMS Mito · SFA Mobile Fitur Label CMS (ae16617) & API (87ebd72) ter-deploy dev 29-10-2026; NIK/NPWP mandatory & lampiran NPWP wajib untuk Company belum; label mobile di tim mobile dokumen-internal
sfa
self-registration
mom
2026-11-03

Index: SFA — Index · Kategori: Fitur · Sumber: Fix sfa aftrer meet with mito (MoM 22-10-2026, HO Mito) Fitur induk: SFA — Self Registration · Revisi reward: SFA — Revisi Reward MoM 22-10-2026

SFA — Revisi Self Registration MoM 22-10-2026

Checklist

# Poin MoM CMS SFA API Mobile Status
1 NIK / NPWP mandatory — ⬜ npwpRule & nikRule masih optional: true, nullable: true (routes/helpers/identityNumberRules.js) ⬜ field wajib di form ⬜ Belum
2 "Kode Referal Karyawan" → "Kode Referral Sales" ✅ label Kode Referral Sales ✅ pesan error + Swagger ⬜ label form mobile ⚠️ Sisa mobile
3 CMS hanya diakses Internal ✅ sudah berjalan — — ✅ Selesai
4a Lampiran KTP → Lampiran NPWP ✅ judul bagian Lampiran NPWP ✅ contoh Swagger doc_type: NPWP ⬜ label + nilai doc_type yang dikirim ⚠️ Sisa mobile
4b Lampiran NPWP mandatory ketika type Company (Individual tidak wajib — dipertegas Oliver 03-11-2026) — ✅ submit & resubmit: COMPANY wajib minimal 1 attachment doc_type = NPWP → 400 Lampiran NPWP wajib untuk customer type Company (attachment doc_type = NPWP); INDIVIDUAL tanpa lampiran boleh (aturan lama resubmit "minimal 1 dokumen" dihapus). Commit 05d6083, ter-deploy dev 03-11-2026 (git bundle + sudo pm2 restart sfa-api-dev; smoke test Company tanpa lampiran → 400) ⬜ wajib upload kalau pilih Company; 1 file, pilihan doc_type NPWP / KTP (Company dikunci NPWP) ⚠️ API ter-deploy dev · sisa mobile

Progress: 1 / 5 selesai penuh, 2 / 5 tinggal mobile.

Kenapa sebagian tidak ada di CMS

Poin Alasan
Label "Kode Referal Karyawan" Tulisan itu hanya ada di form aplikasi mobile. CMS tidak pernah memakai kata "Karyawan" untuk referral — sebelumnya sudah "Referral Sales", sekarang jadi "Kode Referral Sales". API hanya menerima field referral_empl_code (nama teknis, tidak tampil ke user) dan pesan error-nya sudah diganti. Jadi yang mengganti label form = tim mobile.
Label "Lampiran KTP" CMS menampilkan jenis dokumen apa adanya dari kolom doc_type yang dikirim mobile (teks bebas, mis. KTP). Tidak ada tulisan "Lampiran KTP" di kode CMS / API. Judul bagian di CMS sudah diganti jadi Lampiran NPWP; tapi isi doc_type per file tetap tergantung mobile → mobile perlu mengirim NPWP. Dokumen lama yang sudah terkirim tetap tampil KTP.
CMS hanya diakses Internal Ini hak akses, bukan label — tidak ada teks yang perlu diubah. Sudah berjalan: User::canAccessPanel() menolak user user_type = EXTERNAL (dealer, customer, staff dealer hasil self / staff registration), jadi mereka hanya bisa login lewat SFA Mobile. user_type mengikuti flag role (roles.user_type).
NIK / NPWP mandatory Ini validasi di API (input datang dari mobile), bukan label CMS. CMS hanya menampilkan "NPWP / NIK" hasil registrasi.
Lampiran NPWP mandatory (Company) Sama — validasi di API saat submit / resubmit registrasi, plus tanda wajib di form mobile.

[!warning] Catatan "CMS hanya Internal" Semua user INTERNAL tetap bisa masuk panel — yang membatasi menu = role / permission Shield. Masalah lama ±140 user punya role super_admin (termasuk sales lapangan) masih terbuka, lihat To-Do di SFA — Index. MoM versi sebelumnya menyebut "Admin & Kacab"; poin ini sekarang disebut "Internal".

Perubahan Label — ter-deploy dev 29-10-2026 (cms ae16617 via Jenkins, api 87ebd72 via git bundle + sudo pm2 restart sfa-api-dev)

CMS

Halaman Sebelum Sesudah
Customer Registrations — detail & tabel Referral Sales Kode Referral Sales
Customer Registrations — detail Supporting Documents Lampiran NPWP
Employee External — form & detail Referral Sales Kode Referral Sales
Employee External — form & detail Supporting Documents Lampiran NPWP

SFA API

Tempat Sebelum Sesudah
POST /registration/submit — referral kosong Referral sales wajib diisi Kode Referral Sales wajib diisi
POST /registration/submit — kode tidak ada Referral sales not found ! Kode Referral Sales tidak ditemukan
Swagger contoh doc_type KTP NPWP
Swagger contoh alasan revisi Foto KTP tidak terbaca Foto NPWP tidak terbaca
Swagger referral_empl_code — dijelaskan sebagai Kode Referral Sales

[!note] Info ke tim mobile

  • Ganti label "Kode Referal Karyawan" → Kode Referral Sales.
  • Ganti "Lampiran KTP" → Lampiran NPWP, dan kirim attachment[].doc_type = "NPWP".
  • Kalau mobile menampilkan pesan error dari API apa adanya, teks referral berubah (lihat tabel di atas).

Sisa Pekerjaan

  1. NIK / NPWP mandatory — ubah npwpRule / nikRule jadi wajib di submit Self Registration (dan Staff / Customer Registration kalau ikut). Perlu dipastikan dulu: wajib salah satu (NIK atau NPWP) atau dua-duanya.
  2. Lampiran NPWP wajib untuk Company — validasi di POST /registration/submit & resubmit: cust_type = COMPANY → minimal satu attachment doc_type = NPWP.