release: prepare v0.1.132

backend/migrations/131_affiliate_rebate_hardening.sql

@@ -24,7 +24,7 @@ CREATE INDEX IF NOT EXISTS idx_user_affiliate_ledger_user_id ON user_affiliate_l
 CREATE INDEX IF NOT EXISTS idx_user_affiliate_ledger_action ON user_affiliate_ledger(action);
 
 COMMENT ON TABLE user_affiliate_ledger IS '邀请返利资金流水（累计/转入）';
-COMMENT ON COLUMN user_affiliate_ledger.action IS 'accrue|transfer';
+COMMENT ON COLUMN user_affiliate_ledger.action IS 'accrue|transfer|signup_reward';
 
 -- 3) Enforce idempotency at DB layer for payment audit actions.
 WITH ranked AS (

backend/migrations/134_affiliate_ledger_audit_snapshots.sql

@@ -16,8 +16,8 @@ ALTER TABLE user_affiliate_ledger
 ALTER TABLE user_affiliate_ledger
     ADD COLUMN IF NOT EXISTS aff_history_quota_after DECIMAL(20,8) NULL;
 
-COMMENT ON COLUMN user_affiliate_ledger.source_order_id IS '产生该返利流水的充值订单；转余额或无法可靠回填的历史数据为 NULL';
-COMMENT ON COLUMN user_affiliate_ledger.balance_after IS '邀请返利转余额后的用户余额快照；无法取得时为 NULL';
+COMMENT ON COLUMN user_affiliate_ledger.source_order_id IS '产生该返利流水的充值订单；转余额、注册奖励或无法可靠回填的历史数据为 NULL';
+COMMENT ON COLUMN user_affiliate_ledger.balance_after IS '邀请返利转余额或注册奖励入账后的用户余额快照；无法取得时为 NULL';
 COMMENT ON COLUMN user_affiliate_ledger.aff_quota_after IS '邀请返利转余额后的可用返利额度快照；无法取得时为 NULL';
 COMMENT ON COLUMN user_affiliate_ledger.aff_frozen_quota_after IS '邀请返利转余额后的冻结返利额度快照；无法取得时为 NULL';
 COMMENT ON COLUMN user_affiliate_ledger.aff_history_quota_after IS '邀请返利转余额后的历史返利总额快照；无法取得时为 NULL';

backend/migrations/136_user_registration_ip.sql

@@ -0,0 +1,19 @@
+-- 用户注册来源 IP 与归属地（管理端用户列表展示）。
+ALTER TABLE users
+    ADD COLUMN IF NOT EXISTS register_ip_address VARCHAR(45) NOT NULL DEFAULT '',
+    ADD COLUMN IF NOT EXISTS register_ip_country VARCHAR(100) NOT NULL DEFAULT '',
+    ADD COLUMN IF NOT EXISTS register_ip_country_code VARCHAR(16) NOT NULL DEFAULT '',
+    ADD COLUMN IF NOT EXISTS register_ip_region VARCHAR(100) NOT NULL DEFAULT '',
+    ADD COLUMN IF NOT EXISTS register_ip_city VARCHAR(100) NOT NULL DEFAULT '',
+    ADD COLUMN IF NOT EXISTS register_ip_location VARCHAR(255) NOT NULL DEFAULT '';
+
+CREATE INDEX IF NOT EXISTS idx_users_register_ip_address
+    ON users(register_ip_address)
+    WHERE register_ip_address <> '';
+
+COMMENT ON COLUMN users.register_ip_address IS '注册时记录的客户端 IP';
+COMMENT ON COLUMN users.register_ip_country IS '注册 IP 归属国家/地区';
+COMMENT ON COLUMN users.register_ip_country_code IS '注册 IP 国家/地区代码';
+COMMENT ON COLUMN users.register_ip_region IS '注册 IP 归属省/州/区域';
+COMMENT ON COLUMN users.register_ip_city IS '注册 IP 归属城市';
+COMMENT ON COLUMN users.register_ip_location IS '注册 IP 归属地展示文本';