7.7 KiB
| judul | proyek | terkait | stack | kategori | status | tipe | repo | tags | diperbarui | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| SFA — Staff Registration | SFA CMS · SFA API | Mito · SFA Mobile | Node/Express (sfa-api) · Laravel 11 · Filament 3 · MySQL | Fitur | Di-push ke develop 13-10-2026 (sfa-cms 9271eea · sfa-api 79be952) — belum deploy | dokumen-internal |
|
|
2026-10-13 |
Index: SFA — Index · Kategori: Fitur
Implementasi SFA – CMS – Staff Registration: dealer mendaftarkan staff-nya dari SFA Mobile, CMS Admin me-review di menu Employee External, lalu akun staff aktif. Mengisi TBD FDD §3.5, §3.6, §4, dan §7 dengan keputusan di bawah.
Staff Registration
1. Prinsip: tambahan, tidak mengubah alur yang sudah dipakai mobile
| Yang tidak berubah | Keterangan |
|---|---|
POST /auth/login |
Staff login dengan kode yang sama: user EXTERNAL APPROVED → token USER, PENDING → Registrasi belum di-approve, REJECTED → Registrasi ditolak |
/registration/* (Self Registration) |
Endpoint, tabel customer_registration, dan serviceRegistration.js tidak disentuh |
| Endpoint sales | Token staff (EXTERNAL) tetap ditolak validateJWT |
app.js |
Endpoint staff di bawah prefix /registration, jadi otomatis ikut batas body 35MB |
2. Keputusan (mengisi TBD FDD)
| Hal | Keputusan |
|---|---|
| Siapa mendaftarkan | Dealer yang sudah login: user EXTERNAL APPROVED yang bukan staff. Staff tidak bisa mendaftarkan staff lain |
| Akun staff | Dibuat saat submit: users EXTERNAL, status = PENDING, tanpa role. Role (mis. Dealer Staff) dipilih admin saat Approve — lihat SFA — Self Registration#Alur Pemasangan Role (Approve) (20-10-2026) |
| Aktivasi (CMS-STAFF_RE-06) | Approve = aktivasi: users.status = APPROVED + role yang dipilih admin, staff langsung bisa login. Tidak ada langkah Activate terpisah |
| Revisi (CMS-STAFF_RE-05) | Dikerjakan dealer lewat resubmit; akun staff tetap PENDING |
| Kode registrasi | STF + YYMMDD + id 6 digit (customer: REG…) |
| Hak akses CMS | Memakai permission Shield Customer Registration yang sama (review / approve / revision / reject_customer::registration) |
| Notifikasi (CMS-STAFF_RE-07) | Admin: lonceng CMS (POST /api/staff-registrations/{id}/notify). Dealer: cek status lewat GET /registration/staff/{id}. Push / email ke dealer masih TBD |
Status: SUBMITTED → (UNDER_REVIEW) → APPROVED, atau REVISION (→ resubmit → SUBMITTED) / REJECTED (final; boleh didaftarkan ulang dengan email yang sama, akun lama dipakai ulang).
3. Data (FDD §3.5) & validasi (§3.6)
| Field API | Kolom | Wajib | Aturan |
|---|---|---|---|
staff_name |
staff_name |
✅ | maks 100 |
email |
email_address + users.email |
✅ | format email, maks 60 |
phone |
phone_number |
✅ | ^\+?[0-9]+$, 6–20 |
password |
users.password (hash $2y$) |
✅ submit | 8–72 |
nik |
nik (BIGINT) |
— | JSON number (string ditolak), 16 digit, maks 9007199254740991 |
position |
position |
— | maks 100 (jabatan, teks bebas) |
staff_address |
staff_address |
— | maks 500 |
additional_information |
additional_information |
— | maks 1000 |
attachment[] |
staff_registration_attachment |
— | PDF/PNG/JPG, 5MB per file, maks 5 per request & 10 per registrasi |
[!info] NPWP & NIK sebagai number (13-10-2026)
nik(staff) danvat_num(registrasi customer &POST /master/customer) dikirim sebagai JSON number dan disimpanBIGINT UNSIGNED(migration CMS2026_10_13_000002). NPWP 14–16 digit (leading zero NPWP lama hilang), NIK 16 digit. Batas atas9007199254740991(Number.MAX_SAFE_INTEGER): angka di atasnya dibulatkan diam-diam oleh JSON/JavaScript, jadi ditolak 400 — artinya NIK/NPWP 16 digit berawalan901…–99…(mis. Papua94…) belum bisa diinput.
Duplikat (409): email sudah dipakai users lain / registrasi staff aktif / registrasi customer aktif; no. HP atau NIK sudah dipakai registrasi staff yang belum REJECTED. Approve di CMS mengecek ulang email dan memastikan dealer masih APPROVED.
4. API (Node sfa-api)
Semua pakai header token dari /auth/login milik dealer (middleware baru validateExternalJWT).
| Endpoint | Fungsi |
|---|---|
POST /registration/staff/submit |
Daftarkan staff. 201 + detail registrasi |
GET /registration/staff?page&limit&status |
List staff yang didaftarkan dealer ini |
GET /registration/staff/{id} |
Detail, status, alasan, dokumen, riwayat. 404 bila bukan milik dealer ini |
POST /registration/staff/{id}/resubmit |
Hanya status REVISION. Field opsional + attachment baru + remove_attachment_ids + password (bila diganti) |
| Kondisi | HTTP |
|---|---|
| Tanpa token / token internal / token registrant | 403 |
Token staff, atau dealer belum APPROVED |
403 |
| Validasi field / dokumen | 400 |
Duplikat, resubmit saat status bukan REVISION |
409 |
Swagger: tag Staff Registration di /api-docs.
5. CMS — menu Employee External
- Kolom baru Type (Dealer / Staff) dan Dealer; filter Type. Kolom Registration / Status / Submitted menampilkan data staff untuk baris staff.
- Aksi staff (tabel + header View): Start Review, Approve, Request Revision, Reject.
- Halaman View staff: section Staff Registration, Staff Documents, Staff History (section customer disembunyikan).
- Edit dinonaktifkan untuk staff: form edit menulis
customer_registration, jadi perbaikan data staff lewat Request Revision. - Badge menu sudah ikut menghitung staff
PENDING.
6. Database
Migration CMS 2026_10_13_000001_create_staff_registration_tables.php (idempotent): staff_registration, staff_registration_attachment, staff_registration_history, dan role Dealer Staff (EXTERNAL). Dokumen tersimpan di files/staff_registration/… (opsional .env Node staffRegistrationAttachmentPath).
7. Pengujian (lokal, 13-10-2026)
HTTP → Node API → MySQL → CMS, data uji dihapus setelahnya:
- Submit ok (dengan dokumen), validasi 400, tanpa token 403, duplikat email / HP / email customer 409, list, detail, detail milik lain 404
- Staff login sebelum approve → 403; resubmit saat
SUBMITTED→ 409 - Revision → resubmit (ganti dokumen) → Approve → staff login
USERdengan roleDealer Staff; reject setelah approve ditolak - Token staff → submit 403 & endpoint sales 403
- Reject → login Registrasi ditolak → daftar ulang email sama memakai ulang akun (tidak dobel)
- Notifikasi lonceng terkirim ke admin reviewer
- Filament: filter Type, visibilitas aksi staff/customer/edit, halaman View staff & customer lama, Start Review dari header
8. Deploy
- CMS dulu:
php artisan migrate --path=database/migrations/2026_10_13_000001_create_staff_registration_tables.php(Node tidak lagi butuh role saat submit sejak 20-10-2026) - Node API: pull +
pm2 restart. PastikanLARAVEL_API_URL/LARAVEL_API_KEYterisi untuk notifikasi - Kabari tim mobile: 4 endpoint baru di §4 (endpoint lama tidak berubah)
9. Terbuka
| # | Hal |
|---|---|
| 1 | Notifikasi status ke dealer (push / email) — channel masih TBD di FDD |
| 2 | Menu / akses apa yang boleh dipakai staff di aplikasi setelah login (role Dealer Staff belum punya pembatasan route) |
| 3 | Bila dealer di-reject / dinonaktifkan, apakah staff-nya ikut dinonaktifkan? Sekarang hanya Approve yang mengecek status dealer |
| 4 | Admin tidak bisa mengedit data staff di CMS (hanya lewat revisi dealer) |
| 5 | Helper dokumen staff (routes/helpers/registrationDocuments.js) menduplikasi logika di serviceRegistration.js; bisa disatukan nanti tanpa mengubah perilaku |