--- judul: Bug Report — Deploy SFA Reward 2026-10-13 (NPWP notasi ilmiah) proyek: SFA CMS · SFA API terkait: Mito server: VPS MITO dev `/var/www/sfa_mito` (16.79.56.41) kategori: Bug status: Solved — migration diperbaiki (db25341), 1 data uji dikosongkan di server dev tipe: dokumen-internal tags: - sfa - cms - bug - deploy - migration diperbarui: 2026-10-13 --- > Index: [[SFA — Index]] · Kategori: **Bug** · Fitur yang di-deploy: [[SFA — Reward]] # Bug Report: Deploy SFA Reward — Migration NPWP/NIK gagal karena notasi ilmiah **Tanggal:** 13 Oktober 2026 **Server/Environment:** VPS MITO — server **develop** SFA CMS (`/var/www/sfa_mito`, `ip-172-31-21-236`), MySQL strict mode, Jenkins `SFA-CMS-DEV` **Project:** SFA CMS (`MITO/sfa-cms`) · SFA API (`MITO/sfa-api`) **Status:** ✅ Solved --- ## Ringkasan Masalah Push fitur Reward (`137aca2`) memicu deploy otomatis Jenkins, tapi migration berhenti di `2026_10_13_000002_change_npwp_nik_to_bigint` (commit sebelumnya, belum pernah jalan di server), sehingga `000003` (tabel reward) dan `000004` (IMEI Registration) ikut tertahan. Penyebab utamanya **urutan deploy**: Node API sudah mengirim NPWP sebagai **JSON number** (`19e4500`) sementara kolom di server masih `VARCHAR`, jadi MySQL menyimpan angka besar itu dalam **notasi ilmiah** (`1.234567890789258e15`) — yang ditolak oleh pengecekan migration. Ditambah satu data uji berisi teks `i`. --- ## Timeline & Error ### Error 1 — Migration reward masih Pending setelah push ``` 2026_10_13_000002_change_npwp_nik_to_bigint ...... Pending 2026_10_13_000003_create_reward_tables ........... Pending 2026_10_13_000004_create_reward_imei_submission_table ... Pending ``` Kode sudah ter-pull (Shield menemukan `RewardImeiSubmissionResource`), tapi migration belum jalan. `sfa-cms deploy` menjalankan migration satu per satu dan berhenti di file pertama yang gagal → lihat Error 3. ### Error 2 — `git pull` gagal saat dijalankan sebagai root ``` root@ip-172-31-21-236:/var/www/sfa_mito# git pull origin develop --no-edit ssh: connect to host repo.sinerka.id port 22: Connection refused ``` **Penyebab:** deploy key dan setting port Gitea **222** hanya ada di `~ubuntu/.ssh/config`. Root memakai port 22. Perintah `sfa-mito deploy` juga tidak ada — nama skripnya `sfa-cms`. **Fix:** pakai skrip yang sudah ada (jalan sebagai `ubuntu`), jangan `git pull` manual sebagai root: ```bash sfa-cms deploy ``` ### Error 3 — Migration `000002` berhenti: NPWP bukan angka ``` 2026_10_13_000002_change_npwp_nik_to_bigint .................... 8.98ms FAIL In 2026_10_13_000002_change_npwp_nik_to_bigint.php line 51: customer_registration.vat_num berisi data yang tidak bisa dijadikan angka ( id => nilai): {"11":"1.234567890789258e15","6":"i"}. Perbaiki datanya lalu jalankan migration lagi. ``` | id | Nilai | Penyebab | |---|---|---| | 11 | `1.234567890789258e15` | Node (`19e4500`) mengirim `vat_num` sebagai JSON number → mysql2 mengikat sebagai DOUBLE → kolom masih `VARCHAR` → MySQL menulis notasi ilmiah. Nilai asli `1234567890789258` masih utuh (< 2^53) | | 6 | `i` | Data uji, bukan angka | **Fix 1 — migration diperbaiki (commit `db25341`), berlaku juga untuk 5 server production:** nilai notasi ilmiah yang bilangan bulat dan ≤ `9007199254740991` dikonversi ke angka utuh tanpa kehilangan digit. Teks lain dan nilai di atas batas tetap ditolak dan ditampilkan (prinsip "tidak ada data dibuang diam-diam" tetap). Konversi `+ 0` hanya dievaluasi untuk nilai yang lolos regex notasi ilmiah (CASE bersarang), karena di strict mode `UPDATE ... 'i' + 0` error `Truncated incorrect DOUBLE value`. Diuji di database scratch dengan kolom `VARCHAR` seperti server: `1.234567890789258e15` → `1234567890789258`, batas `9.007199254740991e15` → `9007199254740991`, NIK notasi ilmiah, NPWP bertitik, string kosong → NULL; `i` dan notasi ilmiah di atas batas tetap ditolak; tidak ada tabel berubah selama ada yang gagal; jalan ulang idempotent. **Fix 2 — data uji id 6 dikosongkan di server dev** (diputuskan user): ```bash cd /var/www/sfa_mito sudo -u ubuntu php artisan tinker --execute='echo DB::table("customer_registration")->where("id",6)->where("vat_num","i")->update(["vat_num"=>null]);' sfa-cms deploy # jawab y → 000002, 000003, 000004 DONE ``` Shield untuk menu Reward dijalankan manual (skrip deploy tidak men-generate permission): ```bash sudo -u ubuntu php artisan shield:generate \ --resource=RewardProgramResource,RewardBalanceResource,RewardClaimResource,RewardImeiSubmissionResource \ --option=permissions --panel=admin sudo -u ubuntu php artisan permission:cache-reset ``` --- ## Tabel Root Cause | # | Error | Root Cause | Fix | Status | |---|---|---|---|---| | 1 | Migration reward Pending setelah push | Deploy berhenti di migration `000002` yang gagal | Lihat #3 | ✅ | | 2 | `git pull` root → port 22 refused | Deploy key + port 222 hanya untuk user `ubuntu` | Pakai `sfa-cms deploy` | ✅ | | 3a | `vat_num = 1.234567890789258e15` | Node kirim JSON number sebelum kolom CMS jadi BIGINT → VARCHAR menyimpan notasi ilmiah | Migration konversi notasi ilmiah (`db25341`) | ✅ | | 3b | `vat_num = i` | Data uji | Dikosongkan manual di server dev | ✅ | --- ## Catatan lain dari sesi yang sama (lokal, bukan server) - Saat struktur `reward_imei_submission` diubah berulang (migration belum di-deploy, di-rollback & jalan ulang di lokal), satu pengajuan uji **RIS261013000014** di DB lokal ikut terhapus tanpa dicek dulu. Ledger EARN #23 dan saldo tidak terpengaruh. Setelahnya data lokal selalu di-backup ke JSON sebelum rollback, lalu dipulihkan ke struktur baru. - `pkill -f "node ./bin/www"` untuk mematikan server uji (port 3099) ikut mematikan proses Node milik `nodemon` (port 3000). Dihidupkan lagi dengan `touch app.js`; berikutnya proses uji dimatikan lewat PID-nya sendiri. --- ## Rekomendasi 1. **Urutan deploy saat tipe data berubah:** migration CMS (ubah kolom) dulu, baru Node yang mengirim tipe baru. Kalau terbalik, data yang masuk di antaranya tersimpan dalam format yang salah. 2. **Production (5 server, `MITO_PRODUCTION`):** migration `000002` sudah menangani notasi ilmiah, tapi data lain yang bukan angka akan tetap menghentikan deploy. Cek dulu sebelum deploy: ```sql SELECT id, vat_num FROM customer_registration WHERE vat_num IS NOT NULL AND vat_num NOT REGEXP '^[0-9 .-]*$'; SELECT id, vat_num FROM customer WHERE vat_num IS NOT NULL AND vat_num NOT REGEXP '^[0-9 .-]*$'; SELECT id, nik FROM staff_registration WHERE nik IS NOT NULL AND nik NOT REGEXP '^[0-9 .-]*$'; ``` 3. **Skrip `sfa-cms deploy` tidak menjalankan `shield:generate`** — setiap resource / permission baru perlu langkah manual. Pertimbangkan menambah `shield:generate --option=permissions` untuk resource baru ke skrip. 4. Jangan menjalankan `git` / `artisan` sebagai root di `/var/www/sfa_mito`; selalu `sudo -u ubuntu` atau skrip `sfa-cms`.