Doc_chelvyn/Mito/Sfa/Bug/2026-10-13_deploy-reward-np...

149 lines
6.8 KiB
Markdown
Raw Permalink Normal View History

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