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

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
sfa
cms
bug
deploy
migration
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_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:
    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.