6.8 KiB
| judul | proyek | terkait | server | kategori | status | tipe | tags | diperbarui | |||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Bug Report — Deploy SFA Reward 2026-10-13 (NPWP notasi ilmiah) | SFA CMS · SFA API | Mito | VPS MITO dev `/var/www/sfa_mito` (16.79.56.41) | Bug | Solved — migration diperbaiki (db25341), 1 data uji dikosongkan di server dev | dokumen-internal |
|
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:
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):
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):
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_submissiondiubah 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 miliknodemon(port 3000). Dihidupkan lagi dengantouch app.js; berikutnya proses uji dimatikan lewat PID-nya sendiri.
Rekomendasi
- 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.
- Production (5 server,
MITO_PRODUCTION): migration000002sudah menangani notasi ilmiah, tapi data lain yang bukan angka akan tetap menghentikan deploy. Cek dulu sebelum deploy: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 .-]*$'; - Skrip
sfa-cms deploytidak menjalankanshield:generate— setiap resource / permission baru perlu langkah manual. Pertimbangkan menambahshield:generate --option=permissionsuntuk resource baru ke skrip. - Jangan menjalankan
git/artisansebagai root di/var/www/sfa_mito; selalusudo -u ubuntuatau skripsfa-cms.