feat(admin): full integration of order, product, and finance modules with real RPC data streams

docs/sql/10_schema/finance/ml_extract_v1.sql

@@ -0,0 +1,39 @@
+-- =====================================================================================
+-- Schema: 用户提现申请表
+-- 位置：docs/sql/10_schema/finance/
+-- 对象类型：Schema (DDL)
+-- 版本：v1
+-- 说明：管理用户发起的提现申请（佣金/余额），支持多种提现方式及快照信息
+-- =====================================================================================
+
+CREATE TABLE IF NOT EXISTS public.ml_extract (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  uid UUID NOT NULL REFERENCES public.ak_users(id),
+  
+  real_name TEXT NULL,          -- 提现人姓名快照
+  extract_type TEXT NOT NULL,   -- 提现方式: alipay, wechat, bank
+  
+  -- 账号快照信息
+  alipay_code TEXT NULL,        -- 支付宝账号
+  wechat_code TEXT NULL,        -- 微信账号
+  bank_code TEXT NULL,          -- 银行卡号
+  bank_address TEXT NULL,       -- 开户行地址
+  
+  extract_price DECIMAL(12,2) NOT NULL DEFAULT 0, -- 申请提现金额
+  service_fee DECIMAL(12,2) NOT NULL DEFAULT 0,   -- 提现手续费
+  balance DECIMAL(12,2) NOT NULL DEFAULT 0,       -- 提现时的余额快照
+  
+  status SMALLINT NOT NULL DEFAULT 0, -- 状态: 0:待审核, 1:已通过, -1:已驳回
+  refusal_reason TEXT NULL,           -- 驳回原因
+  
+  admin_id UUID NULL REFERENCES public.ak_users(id), -- 审核人ID
+  payment_time TIMESTAMPTZ NULL,      -- 打款/到账时间
+  
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+-- 索引
+CREATE INDEX IF NOT EXISTS ml_extract_uid_idx ON public.ml_extract (uid);
+CREATE INDEX IF NOT EXISTS ml_extract_status_idx ON public.ml_extract (status);
+CREATE INDEX IF NOT EXISTS ml_extract_created_at_idx ON public.ml_extract (created_at DESC);

docs/sql/10_schema/finance/ml_invoices_v1.sql

@@ -0,0 +1,36 @@
+-- =====================================================================================
+-- Schema: 发票管理表
+-- 位置：docs/sql/10_schema/finance/ml_invoices_v1.sql
+-- 对象类型：Schema (DDL)
+-- 版本：v1
+-- 说明：记录用户提交的开票申请及其处理状态
+-- =====================================================================================
+
+CREATE TABLE IF NOT EXISTS public.ml_invoices (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  uid UUID NOT NULL REFERENCES public.ak_users(id),
+  order_no TEXT NOT NULL,           -- 关联订单号
+  
+  order_amount DECIMAL(12,2) NOT NULL, -- 订单金额
+  
+  invoice_type SMALLINT NOT NULL DEFAULT 1, -- 1: 电子普通发票, 2: 增值税专用发票
+  header_type SMALLINT NOT NULL DEFAULT 1,  -- 1: 个人, 2: 企业
+  
+  header_name TEXT NOT NULL,        -- 发票抬头
+  tax_id TEXT NULL,                 -- 企业税号
+  
+  email TEXT NULL,                  -- 接收邮箱
+  remark TEXT NULL,                 -- 备注
+  
+  status SMALLINT NOT NULL DEFAULT 0, -- 0: 待开票, 1: 已开票, -1: 已拒绝
+  refusal_reason TEXT NULL,           -- 驳回原因
+  invoice_url TEXT NULL,              -- 电子发票文件路径/URL
+  
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+-- 索引
+CREATE INDEX IF NOT EXISTS ml_invoices_uid_idx ON public.ml_invoices (uid);
+CREATE INDEX IF NOT EXISTS ml_invoices_order_no_idx ON public.ml_invoices (order_no);
+CREATE INDEX IF NOT EXISTS ml_invoices_status_idx ON public.ml_invoices (status);

docs/sql/10_schema/finance/ml_user_bill_v1.sql

@@ -0,0 +1,33 @@
+-- =====================================================================================
+-- Schema: 用户资金流水表
+-- 位置：docs/sql/10_schema/finance/
+-- 对象类型：Schema (DDL)
+-- 版本：v1
+-- 说明：记录用户余额、积分、佣金的所有增减流水（原子日志）
+-- =====================================================================================
+
+CREATE TABLE IF NOT EXISTS public.ml_user_bill (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  uid UUID NOT NULL REFERENCES public.ak_users(id),
+  
+  link_id TEXT NULL,           -- 关联业务ID（订单号、提现ID、充值ID等）
+  pm SMALLINT NOT NULL DEFAULT 1, -- 0:支出, 1:收入
+  
+  title TEXT NOT NULL,         -- 流水标题（如：商品购买、充值、提现）
+  category TEXT NOT NULL,      -- 业务大类（如：balance-余额, integral-积分, brokerage-佣金）
+  type TEXT NOT NULL,          -- 业务子类型（如：recharge, extract, pay, refund, system_add, system_sub）
+  
+  number DECIMAL(12,2) NOT NULL DEFAULT 0, -- 变动金额
+  balance DECIMAL(12,2) NOT NULL DEFAULT 0, -- 变动后的余额快照
+  
+  mark TEXT NULL,              -- 备注
+  status SMALLINT NOT NULL DEFAULT 1, -- 状态（1:有效, 0:无效/冲正）
+  
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+-- 常用查询索引
+CREATE INDEX IF NOT EXISTS ml_user_bill_uid_idx ON public.ml_user_bill (uid);
+CREATE INDEX IF NOT EXISTS ml_user_bill_category_type_idx ON public.ml_user_bill (category, type);
+CREATE INDEX IF NOT EXISTS ml_user_bill_created_at_idx ON public.ml_user_bill (created_at DESC);

docs/sql/10_schema/finance/ml_user_recharge_v1.sql

@@ -0,0 +1,32 @@
+-- =====================================================================================
+-- Schema: 用户充值记录表
+-- 位置：docs/sql/10_schema/finance/
+-- 对象类型：Schema (DDL)
+-- 版本：v1
+-- 说明：记录用户主动发起的充值申请及支付状态
+-- =====================================================================================
+
+CREATE TABLE IF NOT EXISTS public.ml_user_recharge (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  uid UUID NOT NULL REFERENCES public.ak_users(id),
+  
+  order_no TEXT UNIQUE NOT NULL,    -- 充值订单号（cz开头）
+  recharge_type TEXT NOT NULL,      -- 充值渠道: wechat, alipay, system (后台补单)
+  
+  price DECIMAL(12,2) NOT NULL DEFAULT 0,      -- 实际充值金额
+  give_price DECIMAL(12,2) NOT NULL DEFAULT 0, -- 赠送金额
+  
+  paid SMALLINT NOT NULL DEFAULT 0, -- 支付状态: 0:未支付, 1:已支付
+  pay_time TIMESTAMPTZ NULL,        -- 支付时间
+  
+  channel_trade_no TEXT NULL,       -- 外部渠道流水号
+  status SMALLINT NOT NULL DEFAULT 1, -- 记录状态: 1:正常, 0:逻辑删除
+  
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+-- 索引
+CREATE INDEX IF NOT EXISTS ml_user_recharge_uid_idx ON public.ml_user_recharge (uid);
+CREATE INDEX IF NOT EXISTS ml_user_recharge_order_no_idx ON public.ml_user_recharge (order_no);
+CREATE INDEX IF NOT EXISTS ml_user_recharge_created_at_idx ON public.ml_user_recharge (created_at DESC);