refactor: migrate amount fields to decimal and implement location service restriction for unsupported regions

payment_server/migrations/2026_07_24_fix_wallet_amount_varchar.sql

@@ -0,0 +1,29 @@
+-- 2026_07_24_fix_wallet_amount_varchar.sql
+-- Siro audit S5 (docs/21 في Tripz): driverWallet.amount و siroWallet.amount كانا varchar(10)
+-- — المال مخزَّن نصاً و SUM() يُجري جمعاً نصياً. يوسّعهما إلى DECIMAL(12,3) NOT NULL.
+--
+-- آمن رجعياً: كل الإدخالات الحالية في الكود تمرّر أرقاماً (موجبة أو سالبة) عبر PDO
+-- params، فلا قيمة نصية غير رقمية موجودة فعلياً. DECIMAL(12,3) يحتفظ بالإشارة
+-- (driverWallet يخزّن دفتر أستاذ بقيود موجبة وسالبة، لا رصيداً تراكمياً) — لذلك
+-- لا CHECK (amount >= 0) هنا، خلافاً لعمود الرصيد التراكمي في Tripz.
+--
+-- التطبيق: mysql < 2026_07_24_fix_wallet_amount_varchar.sql
+-- التراجع: انظر نهاية الملف (معلَّق، فعّله يدوياً عند الحاجة فقط)
+
+START TRANSACTION;
+
+ALTER TABLE `driverWallet`
+  MODIFY COLUMN `amount` DECIMAL(12,3) NOT NULL;
+
+ALTER TABLE `siroWallet`
+  MODIFY COLUMN `amount` DECIMAL(12,3) NOT NULL;
+
+COMMIT;
+
+-- ── تحقّق يدوي بعد التنفيذ ─────────────────────────────────────────
+-- SELECT driverID, SUM(amount) AS balance FROM driverWallet GROUP BY driverID LIMIT 5;
+-- تأكد أن balance رقم صحيح منطقي (لا نص مبتور كما كان يحدث مع SUM() على varchar).
+
+-- ── تراجع (لا يُنفَّذ تلقائياً) ─────────────────────────────────────
+-- ALTER TABLE `driverWallet` MODIFY COLUMN `amount` VARCHAR(10) CHARACTER SET latin1 COLLATE latin1_swedish_ci NOT NULL;
+-- ALTER TABLE `siroWallet`   MODIFY COLUMN `amount` VARCHAR(10) NOT NULL;