Splay 2.0 表归档切库与功能裁剪计划

背景与目标

1.0 已结束，在 1.0 基础上推进 2.0：去掉部分老旧能力，保留机器人、客户端购买（非 VIP）、买剧、收益周期/发放/到期退本金等核心链路。

切库策略（已定）：不对业务表全面改名走 s2_*，而是对交易/用户态表做 同库归档 rename → 同名空表重建，业务读写路径尽量不动，降低改动面与破坏性。

与现有 legacy 割接的关系：legacy_point_* / playd/splay2_migration.go 负责 1.0 余额入金库与个人等级，与本计划「业务表归档空起」正交，可并存；本计划不重复迁用户余额。cmd/liquidate 已执行完毕，切库窗口不再依赖清算步骤。

已确认决策

方案说明

为何选「归档 + 同名空表」

• 业务 SQL / bun 模型表名不变，改动集中在「功能下线」与少量边界校验。
• 1.0 历史留在同库 *_1_0，便于对账、客服、审计；比「仅备份后 TRUNCATE」更安全。
• 硬切场景下无需维护两套读写路径；若未来要长期双端并行，再评估 s2_*（当前不做）。
• 管理端暂不提供查 *_1_0 的只读 API；需要时再加。

执行模式（示意）

-- 示例：tips_ledgers
ALTER TABLE tips_ledgers RENAME TO tips_ledgers_1_0;
CREATE TABLE tips_ledgers (LIKE tips_ledgers_1_0 INCLUDING ALL);
-- 索引/约束/序列：LIKE INCLUDING ALL 后按 PG 版本核对序列归属与自增

注意：

• 有 REFERENCES users(user_id) 等外键的表，归档后空表需重建等价外键。
• Identity / serial 需确认新表序列从 1 起或按需设置，避免与历史 ID 混淆（空起一般从 1 即可）。
• 迁移脚本须幂等或带 data_migration_runs / 专用标记，防止重复 rename。
• 白名单表绝对不能 rename（见下文「保留原表」）。

邀请体系（粉丝码 only + 对外 uid）

1.0 并存两套路：

• CPS 分销（分销商申请、CPS 榜单/入口等）
• 粉丝码体系（fans_code / inviter_fans，库内多为 F 前缀）

2.0：

功能取舍

保留（逻辑基本不变，落库见分类）

下线（2.0 不做）

表分类清单

Bun 默认复数蛇形表名；下列以业务名为准。归档后缀统一：_1_0（例：tips_ledgers → tips_ledgers_1_0）。

A. 保留原表（不 rename、不清空）

A1. 账号体系

• users（含 fans_code、inviter_fans、inviter_user_ids 等；关系数据保留，对外展示转 uid）
• roles、verifications、distributor_applies、third_logins
• bank_cards、withdrawals、feedbacks
• invite_logs、login_logs、operate_logs
• sign_in_records、configs
• withdraw_face_checks、withdraw_face_check_snapshots

A2. 短剧媒资与观看侧（共用 1.0）

• playlets、playlet_episodes、playlet_groups
• playlet_materials、subtitles
• user_playlet_ledgers、user_playlet_collects、user_playlet_episodes
• ad_records、material_watch_histories
• movies（若仍作媒资引用；AI 聊天下线后不再走聊天逻辑）

A3. 系统配置 / 运营参数

• tips_parameters、global_parameters、refund_parameters、wealth_parameters
• app_page_parameters、app_popup_parameters
• share_links、whats_app_links、user_whats_app_links
• experts、customer_services、announcements
• deposit_channels、withdraw_banks、withdraw_bank_channels、withdraw_channel_limits
• pay_bank_cards、versions、point_packs
• advertisements（含福利页 TYPE_WELFARE，保留）
• 券模板（非机器人券规则）：coupons、support_coupons、double_coupons
• 通知模板：notifications
• 已是 2.0 割接表（不动）：legacy_point_vaults、legacy_unlock_ledgers、legacy_unlock_adjustments、legacy_point_exchanges、legacy_exchange_quotas、data_migration_runs

B. 归档为 *_1_0 后重建空表（2.0 业务写入）

B1. 机器人（配置空起，含券规则，不迁 1.0）

• robots
• robot_daily_income_rates
• robot_coupon_rules
• robot_coupon_codes、robot_coupon_send_stats

B2. 支持 / 收益 / 活跃

• tips_ledgers、tips_income_ledgers、playlet_income_ledgers
• income_claim_ledgers、playlet_views、playlet_tips_shelf_ledgers
• active_value_ledgers、empiric_value_ledgers

B3. 订单与积分流水

• orders、point_ledgers、point_frozen_ledgers
• 统计 rollup：point_ledger_daily_stats、point_ledger_total_stats、tips_ledger_daily_stats、fund_flow_daily_stats、fund_flow_total_stats、incremental_task_cursors
• user_stats、user_stats_details

B4. 优惠券用户态 / 发放态

• coupon_codes、user_support_coupons、user_double_coupons

B5. 通知用户态

• user_notifications、notification_reactions

B6. 弹幕（空起）

• bullet_comments、bullet_comment_reports、bullet_comment_hiddens

B7. 2.0 保留活动（仅此两类，空起）

• 升级补贴：upgrade_subsidies
• 合伙人计划：partner_pool_records、partner_divided_records（及相关仅服务合伙人的表，若有则一并空起）

C. 随功能下线：归档即可（可不重建，或重建但不接流量）

下线域：必须改代码停 API/cron，不能只靠清表。

代码改造范围（按优先级）

P0 — 切库迁移

1. 新增 migration：按 A/B/C 清单执行 rename +（B 类）CREATE LIKE；写入执行标记防重入。
2. 预发完整演练：备份 → 跑迁移 → 冒烟核心路径。
3. 文档化回滚：DROP 新空表 + RENAME xxx_1_0 → xxx（仅切库失败且尚未写入新数据时）。
4. 不再跑 liquidate。

P1 — 功能下线与邀请改造

1. VIP：services/point/order.go、pay.go、plan.go；man plan；禁止 PRODUCT_TYPE_VIP。
2. VIP 解锁：清除 User.IsVip() 对买剧/播放的特殊分支。
3. 福利任务：services/task/task.go 及 man task；保留 CheckRobotIncomeSettlement 等结算（可挪到 playlet/point）。
4. AI 聊天：services/user/chat.go、man/chat.go。
5. 版权包：services/task/copyrightpack.go、man/copyrightpack.go。
6. CPS / 分销用户侧：services/cps、分销商申请/入口对客户端关闭。
7. 邀请对外 uid：注册与用户端邀请相关 API（如 services/user/user.go、invite.go、粉丝/分享相关）入参出参统一 uid；内部 uid↔fans_code 转换一层即可。
8. 非保留活动：对应 service/cron/man 入口全部停用（宝藏、抢购、拼团、33、嘉年华等）。

P2 — 回归与运维

1. 机器人：后台重建 robots + robot_coupon_rules → 客户端购买 → 收益 cron → 到期退本。
2. 买剧：下单支付、扣点、新空表订单/流水；观看仍读媒资原表。
3. 邀请：用 uid 注册/绑定；库内仍可见 F 码；用户响应无 F 码、无 CPS 入口。
4. 升级补贴、合伙人：空表后主路径冒烟。
5. 广告：首页 + 福利页 均正常。
6. 弹幕：若产品开放，确认写的是新空表。
7. 确认无 cron 仍扫描 *_1_0 或误写归档表；暂不做管理端 *_1_0 只读接口。

明确不做

• 不为 2.0 业务表建 s2_* 并行体系（本阶段）。
• 不把 1.0 机器人配置/券规则、tips/订单/流水迁入新空表。
• 不新建 users 或拆账号库。
• 不迁短剧媒资；不迁 A3 系统配置。
• 不改粉丝码底层落库形态（保持 F 前缀等现有结构）。
• 不再执行 liquidate。
• 暂不提供管理端查询 *_1_0 的只读 API。
• 除升级补贴、合伙人外，其余 1.0 运营活动不在 2.0 上线。

风险与注意事项

建议实施顺序

1. 按本文 A/B/C 冻结表清单（活动去留已定）。
2. 编写并预发跑通归档 migration。
3. 合并功能下线 + 邀请 uid 改造 PR（可与 migration 同发或紧随其后）。
4. 生产：停机或只读窗口 → migration → 配置机器人/券规则与必要运营数据 → 冒烟 → 开写。
5. 观察期：监控购买/收益/退本/买剧/邀请注册；*_1_0 只读留库，管理端暂不接查询接口。

决策冻结状态

关键路径速查