149 lines
6.8 KiB
Markdown
149 lines
6.8 KiB
Markdown
---
|
|
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`.
|