feat: 移除“租户管理员为用户充值 / 每租户一套余额”能力：余额统一为全局用户余额

backend/database/migrations/20251215084449_users.sql

@@ -10,9 +10,17 @@ CREATE TABLE IF NOT EXISTS users(
     roles text[] NOT NULL DEFAULT ARRAY['user'],
     status varchar(50) NOT NULL DEFAULT 'active',
     metas jsonb NOT NULL DEFAULT '{}',
+    balance bigint NOT NULL DEFAULT 0,
+    balance_frozen bigint NOT NULL DEFAULT 0,
     verified_at timestamptz
 );
 
+COMMENT ON COLUMN users.balance IS '全局可用余额：分/最小货币单位；用户在所有已加入租户内共享该余额；默认 0';
+COMMENT ON COLUMN users.balance_frozen IS '全局冻结余额：分/最小货币单位；用于下单冻结等；默认 0';
+
+CREATE INDEX IF NOT EXISTS ix_users_balance ON users(balance);
+CREATE INDEX IF NOT EXISTS ix_users_balance_frozen ON users(balance_frozen);
+
 -- +goose StatementEnd
 -- +goose Down
 -- +goose StatementBegin

backend/database/migrations/20251216011456_tenant_users.sql

@@ -5,7 +5,6 @@ CREATE TABLE IF NOT EXISTS tenant_users(
     tenant_id bigint NOT NULL,
     user_id bigint NOT NULL,
     role TEXT[] NOT NULL DEFAULT ARRAY['member'],
-    balance bigint NOT NULL DEFAULT 0,
     status varchar(50) NOT NULL DEFAULT 'active',
     created_at timestamptz NOT NULL DEFAULT NOW(),
     updated_at timestamptz NOT NULL DEFAULT NOW(),

backend/database/migrations/20251218120000_orders_ledgers.sql

@@ -1,13 +1,5 @@
 -- +goose Up
 -- +goose StatementBegin
-ALTER TABLE tenant_users
-    ADD COLUMN IF NOT EXISTS balance_frozen bigint NOT NULL DEFAULT 0;
-
--- tenant_users.balance_frozen：冻结余额（用于下单冻结、争议期等）
-COMMENT ON COLUMN tenant_users.balance_frozen IS '冻结余额：分/最小货币单位；下单冻结时从可用余额转入，最终扣款或回滚时转出；默认 0';
-
-CREATE INDEX IF NOT EXISTS ix_tenant_users_tenant_balance_frozen ON tenant_users(tenant_id, balance_frozen);
-
 CREATE TABLE IF NOT EXISTS orders(
     id bigserial PRIMARY KEY,
     tenant_id bigint NOT NULL,
@@ -29,12 +21,12 @@ CREATE TABLE IF NOT EXISTS orders(
     updated_at timestamptz NOT NULL DEFAULT NOW()
 );
 
--- orders：订单主表（租户内购买/充值等业务单据）
+-- orders：订单主表（租户内购买等业务单据）
 COMMENT ON TABLE orders IS '订单：租户内的业务交易单据；记录成交金额快照、状态流转与退款信息；所有查询/写入必须限定 tenant_id';
 COMMENT ON COLUMN orders.id IS '主键ID：自增；用于关联订单明细、账本流水、权益等';
 COMMENT ON COLUMN orders.tenant_id IS '租户ID：多租户隔离关键字段；所有查询/写入必须限定 tenant_id';
 COMMENT ON COLUMN orders.user_id IS '用户ID：下单用户（buyer）；余额扣款与权益归属以该 user_id 为准';
-COMMENT ON COLUMN orders.type IS '订单类型：content_purchase（购买内容）/topup（充值）等；当前默认 content_purchase';
+COMMENT ON COLUMN orders.type IS '订单类型：content_purchase（购买内容）等；当前默认 content_purchase';
 COMMENT ON COLUMN orders.status IS '订单状态：created/paid/refunding/refunded/canceled/failed；状态变更需与账本/权益保持一致';
 COMMENT ON COLUMN orders.currency IS '币种：当前固定 CNY；金额单位为分';
 COMMENT ON COLUMN orders.amount_original IS '原价金额：分；未折扣前金额（用于展示与对账）';
@@ -103,12 +95,12 @@ CREATE TABLE IF NOT EXISTS tenant_ledgers(
 );
 
 -- tenant_ledgers：租户内余额账本流水（必须可审计、可幂等）
-COMMENT ON TABLE tenant_ledgers IS '账本流水：记录租户内用户余额的每一次变化（充值/冻结/扣款/退款等）；用于审计与对账回放';
+COMMENT ON TABLE tenant_ledgers IS '账本流水：记录租户内用户余额的每一次变化（冻结/扣款/退款/调账等）；用于审计与对账回放';
 COMMENT ON COLUMN tenant_ledgers.id IS '主键ID：自增';
 COMMENT ON COLUMN tenant_ledgers.tenant_id IS '租户ID：多租户隔离关键字段；必须与 tenant_users.tenant_id 一致';
 COMMENT ON COLUMN tenant_ledgers.user_id IS '用户ID：余额账户归属用户；对应 tenant_users.user_id';
 COMMENT ON COLUMN tenant_ledgers.order_id IS '关联订单ID：购买/退款类流水应关联 orders.id；非订单类可为空';
-COMMENT ON COLUMN tenant_ledgers.type IS '流水类型：credit_topup/debit_purchase/credit_refund/freeze/unfreeze/adjustment；不同类型决定余额/冻结余额的变更方向';
+COMMENT ON COLUMN tenant_ledgers.type IS '流水类型：debit_purchase/credit_refund/freeze/unfreeze/adjustment；不同类型决定余额/冻结余额的变更方向';
 COMMENT ON COLUMN tenant_ledgers.amount IS '流水金额：分/最小货币单位；通常为正数，方向由 type 决定（由业务层约束）';
 COMMENT ON COLUMN tenant_ledgers.balance_before IS '变更前可用余额：用于审计与对账回放';
 COMMENT ON COLUMN tenant_ledgers.balance_after IS '变更后可用余额：用于审计与对账回放';
@@ -143,8 +135,4 @@ DROP INDEX IF EXISTS ix_orders_tenant_status;
 DROP INDEX IF EXISTS ix_orders_tenant_user;
 DROP TABLE IF EXISTS orders;
 
-DROP INDEX IF EXISTS ix_tenant_users_tenant_balance_frozen;
-ALTER TABLE tenant_users DROP COLUMN IF EXISTS balance_frozen;
-
 -- +goose StatementEnd
-

backend/database/migrations/20251222211500_tenant_ledgers_audit_fields.sql

@@ -6,12 +6,12 @@ ALTER TABLE tenant_ledgers
     ADD COLUMN IF NOT EXISTS biz_ref_id bigint;
 
 -- tenant_ledgers.operator_user_id：操作者（谁触发该流水）
--- 用途：用于审计与风控追溯（例如后台代充值/代退款/调账等）。
+-- 用途：用于审计与风控追溯（例如后台代退款/调账等）。
 COMMENT ON COLUMN tenant_ledgers.operator_user_id IS '操作者用户ID：谁触发该流水（admin/buyer/system）；用于审计与追责；可为空（历史数据或无法识别时）';
 
 -- tenant_ledgers.biz_ref_type/biz_ref_id：业务引用（幂等与追溯）
--- 用途：在 idempotency_key 之外提供结构化引用（例如 order/refund/topup 等），便于报表与按业务对象追溯。
-COMMENT ON COLUMN tenant_ledgers.biz_ref_type IS '业务引用类型：order/refund/topup/etc；与 biz_ref_id 组成可选的结构化幂等/追溯键';
+-- 用途：在 idempotency_key 之外提供结构化引用（例如 order/refund 等），便于报表与按业务对象追溯。
+COMMENT ON COLUMN tenant_ledgers.biz_ref_type IS '业务引用类型：order/refund/etc；与 biz_ref_id 组成可选的结构化幂等/追溯键';
 COMMENT ON COLUMN tenant_ledgers.biz_ref_id IS '业务引用ID：与 biz_ref_type 配合使用（例如 orders.id）；用于对账与审计';
 
 -- 索引：按操作者检索敏感操作流水（后台审计用）。
@@ -38,4 +38,3 @@ ALTER TABLE tenant_ledgers
     DROP COLUMN IF EXISTS biz_ref_type,
     DROP COLUMN IF EXISTS operator_user_id;
 -- +goose StatementEnd
-

backend/database/migrations/20251223124000_update_order_ledger_comments.sql

@@ -0,0 +1,24 @@
+-- +goose Up
+-- +goose StatementBegin
+-- 清理“充值”遗留描述：当前项目已移除租户充值与 per-tenant 余额。
+
+COMMENT ON COLUMN orders.type IS '订单类型：content_purchase（购买内容）等；当前默认 content_purchase';
+
+COMMENT ON TABLE tenant_ledgers IS '账本流水：记录租户内用户余额的每一次变化（冻结/扣款/退款/调账等）；用于审计与对账回放';
+COMMENT ON COLUMN tenant_ledgers.type IS '流水类型：debit_purchase/credit_refund/freeze/unfreeze/adjustment；不同类型决定余额/冻结余额的变更方向';
+
+COMMENT ON COLUMN tenant_ledgers.operator_user_id IS '操作者用户ID：谁触发该流水（admin/buyer/system）；用于审计与追责；可为空（历史数据或无法识别时）';
+COMMENT ON COLUMN tenant_ledgers.biz_ref_type IS '业务引用类型：order/refund/etc；与 biz_ref_id 组成可选的结构化幂等/追溯键';
+-- +goose StatementEnd
+
+-- +goose Down
+-- +goose StatementBegin
+-- 新项目不需要依赖 Down 做历史回滚；保持与 Up 一致，避免引入已移除特性的遗留描述。
+COMMENT ON COLUMN orders.type IS '订单类型：content_purchase（购买内容）等；当前默认 content_purchase';
+
+COMMENT ON TABLE tenant_ledgers IS '账本流水：记录租户内用户余额的每一次变化（冻结/扣款/退款/调账等）；用于审计与对账回放';
+COMMENT ON COLUMN tenant_ledgers.type IS '流水类型：debit_purchase/credit_refund/freeze/unfreeze/adjustment；不同类型决定余额/冻结余额的变更方向';
+
+COMMENT ON COLUMN tenant_ledgers.operator_user_id IS '操作者用户ID：谁触发该流水（admin/buyer/system）；用于审计与追责；可为空（历史数据或无法识别时）';
+COMMENT ON COLUMN tenant_ledgers.biz_ref_type IS '业务引用类型：order/refund/etc；与 biz_ref_id 组成可选的结构化幂等/追溯键';
+-- +goose StatementEnd