8.9 KiB
| judul | proyek | terkait | server | kategori | status | tipe | tags | diperbarui | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Bug Report — Submit registrasi customer gagal 500 karena role Customer di-rename jadi Dealer | SFA CMS · SFA API | Mito | VPS MITO dev `/var/www/sfa_mito` + `/var/www/sfa_api_mito` (16.79.56.41) | Bug | Solved — sfa-api 19fba4d, sfa-cms 940e492 | dokumen-internal |
|
2026-10-20 |
Index: SFA — Index · Kategori: Bug · Fitur: SFA — Self Registration · SFA API — Login Terpadu auth-login
Bug Report: Submit registrasi customer gagal 500 — role Customer di-rename jadi Dealer
Tanggal: 20 Oktober 2026
Server/Environment: VPS MITO — server develop (ip-172-31-21-236): SFA CMS /var/www/sfa_mito (Jenkins), SFA API /var/www/sfa_api_mito (pm2 sfa-api-dev, port 3069), MySQL sfa_mito (dipakai bersama)
Project: SFA API (MITO/sfa-api) · SFA CMS (MITO/sfa-cms)
Status: ✅ Solved
Ringkasan Masalah
Tes POST /registration/submit lewat Swagger server dev awalnya ditolak 400 karena attachment dikirim
[] (aturannya memang wajib minimal 1 dokumen). Setelah diisi satu dokumen base64 yang valid, request
gagal 500 Role Customer belum ada, padahal migration CMS pembuat role sudah tercatat Ran.
Ternyata role Customer (id 6) tidak hilang, tapi di-rename jadi Dealer lewat menu CMS → Shield →
Roles. Node API mencari role berdasarkan nama (name = 'Customer' AND guard_name = 'web'), jadi
tidak ketemu. Diputuskan Dealer jadi nama resmi: Node disesuaikan, dan migration CMS baru menyamakan
nama role di semua server (termasuk 5 server production yang masih akan dapat Customer dari migration lama).
Alur Penyebab & Fix
flowchart TD
A["POST /registration/submit"] --> B{"attachment ≥ 1?"}
B -- "tidak, []" --> E1["400 arrayMin<br/>attachment must contain at least 1 items"]
B -- "ya" --> C["checkDuplicate → matchCustomer<br/>→ createRegistrantUser"]
C --> D{"roles WHERE name = ROLE_CUSTOMER<br/>AND guard_name = 'web'"}
D -- "cari 'Customer' (sebelum fix)" --> E2["500 Role Customer belum ada.<br/>Jalankan migration CMS terlebih dahulu."]
D -- "cari 'Dealer' (19fba4d)" --> OK["201 registrasi SUBMITTED<br/>role Dealer (id 6) dipasang"]
R["Migration 2026_10_08_000001<br/>buat role 'Customer' (id 6)"] -. "2026-10-13 06:26<br/>rename lewat Shield → Roles" .-> R2["role id 6 = 'Dealer'"]
R2 --> D
M["Migration 2026_10_20_000003<br/>(940e492)"] -. "server lain:<br/>Customer → Dealer" .-> R2
P["Kunci role sistem di UI Shield<br/>(belum dikerjakan)"]
classDef ok fill:#d1fae5,stroke:#059669,color:#064e3b
classDef err fill:#fee2e2,stroke:#dc2626,color:#7f1d1d
classDef todo fill:#f3f4f6,stroke:#9ca3af,color:#374151,stroke-dasharray:4 3
class OK,M ok
class E1,E2 err
class P todo
Hijau = sukses / fix · Merah = ditolak / gagal · Abu-abu putus-putus = belum dikerjakan
Timeline & Error
Error 1: arrayMin — attachment kosong
{
"status": "failed",
"msg": [
{
"type": "arrayMin",
"message": "The 'attachment' field must contain at least 1 items.",
"field": "attachment",
"expected": 1,
"actual": 0
}
]
}
Penyebab: di routes/validator/validatorRegistration.js aturan attachment untuk submit registrasi
customer adalah min: 1, max: 5. Payload uji juga sempat dikira untuk registrasi staff, padahal staff pakai
endpoint lain (POST /registration/staff/submit, token dealer, attachment opsional).
Fix: kirim satu dokumen dengan format data URI data:<mime>;base64,<isi>:
"attachment": [
{
"doc_type": "KTP",
"file": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAADElEQVR4nGP4//8/AAX+Av4N70a4AAAAAElFTkSuQmCC"
}
]
Perubahan lokal yang membuat
attachmentopsional (validator,attachment = []di service, swagger) belum di-commit, karena keputusan wajib/opsional dokumen belum final.
Error 2: Role Customer belum ada
{
"status": "error",
"message": "Role Customer belum ada. Jalankan migration CMS terlebih dahulu."
}
Penyebab: assignCustomerRole di routes/services/serviceRegistration.js menjalankan
SELECT id FROM roles WHERE name = :name AND guard_name = :guard, dengan ROLE_CUSTOMER = "Customer".
Investigasi di server:
php artisan migrate:status | tail -15
# 2026_10_08_000001_add_status_to_users_and_customer_role ... [9] Ran
grep -E '^DB_(HOST|DATABASE)=' /var/www/sfa_mito/.env # DB_DATABASE=sfa_mito
grep -E "^(DB_HOSTNAME|DB_NAME)=" /var/www/sfa_api_mito/.env # DB_NAME=sfa_mito → DB sama
Isi roles (DB sfa_mito):
| id | name | user_type | created_at | updated_at | user |
|---|---|---|---|---|---|
| 6 | Dealer | EXTERNAL | 2026-10-08 06:46:42 | 2026-10-13 06:26:01 | 11 |
| 7 | Dealer Staff | EXTERNAL | 2026-10-13 03:42:57 | 2026-10-13 03:42:57 | 6 |
created_at id 6 = waktu migration 2026_10_08_000001 jalan, updated_at = waktu rename lewat UI.
Ke-11 user pemegang id 6 semuanya registrant (customer_registration.user_id, 11/11). Di kode CMS tidak
ada yang bergantung pada nama role Customer, hanya Node.
Fix:
- sfa-api
19fba4d:routes/helpers/enums/registrationStatus.js→ROLE_CUSTOMER = "Dealer". - sfa-cms
940e492: migration2026_10_20_000003_rename_customer_role_to_dealer.php, idempotent:- hanya ada
Customer→ rename jadiDealer - ada
CustomerdanDealer→ user dipindah keDealer(lewati yang sudah punya),Customerdihapus - hanya ada
Dealer→ tidak berubah (kondisi server dev) - keduanya tidak ada → buat
Dealer - set
user_type = EXTERNAL,forgetCachedPermissions()
- hanya ada
Error 3: server Node tidak bisa pull
fatal: could not read Username for 'https://repo.sinerka.id': No such device or address
Penyebab: remote /var/www/sfa_api_mito memakai HTTPS (https://repo.sinerka.id/MITO/sfa-api.git)
tanpa kredensial. Server tidak punya deploy key untuk sfa-api, berbeda dengan CMS (~ubuntu/.ssh/sfa_cms_deploy).
CMS ter-deploy otomatis oleh Jenkins (migration [19] Ran); Node tidak.
Fix: kirim commit lewat git bundle lalu fast-forward ke commit yang sama persis dengan origin/develop
(file di server tidak diedit manual):
# lokal
git bundle create sfa-api.bundle 8a6ceec..origin/develop
scp -i mito-dev-snk.pem sfa-api.bundle ubuntu@16.79.56.41:/tmp/sfa-api.bundle
# server
cd /var/www/sfa_api_mito
sudo git fetch -q /tmp/sfa-api.bundle refs/remotes/origin/develop
sudo git merge --ff-only FETCH_HEAD
sudo git update-ref refs/remotes/origin/develop HEAD
rm /tmp/sfa-api.bundle
sudo pm2 restart sfa-api-dev --update-env
Verifikasi: GET /registration/master-data → 200; lookup dengan konstanta Node di server →
lookup Dealer => [{"id":6,"name":"Dealer"}].
Root Cause Summary
| # | Masalah | Penyebab | Fix |
|---|---|---|---|
| 1 | 400 arrayMin attachment |
Submit registrasi customer wajib ≥ 1 dokumen; payload kirim [] |
Kirim 1 dokumen data URI base64 (opsionalisasi masih lokal, belum di-commit) |
| 2 | 500 Role Customer belum ada |
Role id 6 Customer di-rename jadi Dealer lewat Shield; Node lookup by name |
ROLE_CUSTOMER = "Dealer" (19fba4d) + migration rename idempotent (940e492) |
| 3 | Node server tidak bisa git fetch |
Remote HTTPS tanpa kredensial, belum ada deploy key sfa-api | Fast-forward lewat git bundle + pm2 restart |
Rekomendasi Jangka Panjang
- Kunci role sistem (
Dealer,Dealer Staff) di UI Shield:RolePolicy::delete/updatesaat ini hanya cek permissiondelete_role/update_role. Tambah guard supaya nama role sistem tidak bisa diubah/dihapus. - ✅ Node tidak lagi bergantung nama role (20-10-2026, sfa-api
a7e02f8, sfa-cms8153d41): Node membuat akun registrant tanpa role; admin memilih role External saat Approve (dipasang berdasarkan id). Fix19fba4d(ROLE_CUSTOMER = "Dealer") sudah tidak dipakai. Alur: SFA — Self Registration#Alur Pemasangan Role (Approve). - Deploy key sfa-api di server (pola sama dengan
sfa_cms_deploy, SSH port 222) + job Jenkins untuk Node, supaya deploy Node tidak manual. - Production (5 server): deploy CMS dulu (
8153d41, form Approve pilih role), baru Node (a7e02f8). Kalau Node duluan, registrant baru tanpa role di-approve form lama → user APPROVED tanpa role. Migration000003tetap menyamakan namaCustomer→Dealer.
Warning / Catatan Tambahan
- Migration
2025_10_20_000007_create_invent_on_hand_viewdan2025_10_20_000009_fix_invent_on_hand_view_match_productionmasih Pending di server dev (sengaja dilewati skripsfa-cms deploy, lihat 2026-10-06_deploy-sfa-cms-dev). - Setelah Error 2 beres, submit masih bisa ditolak 409 / 400 kalau
referral_empl_codetidak valid (request tanpa token) atau email/NPWP tidak cocok dengan master customer.