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

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`.