77 lines
5.5 KiB
Markdown
77 lines
5.5 KiB
Markdown
---
|
|
judul: SFA — Revisi Self Registration MoM 22-10-2026 (checklist)
|
|
proyek: SFA API · SFA CMS
|
|
terkait: Mito · SFA Mobile
|
|
kategori: Fitur
|
|
status: 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
|
|
tipe: dokumen-internal
|
|
tags:
|
|
- sfa
|
|
- self-registration
|
|
- mom
|
|
diperbarui: 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`.
|