fix(tenant): 收紧双站运营提号与录单边界

This commit is contained in:
yml
2026-11-16 16:12:55 +08:00
parent 1108df195d
commit 1ce9f7aaf5
60 changed files with 1531 additions and 337 deletions
@@ -94,6 +94,15 @@
## 三、方案设计与改造范围
### 0. 双站点租户边界(2026-11-16)
- `admin_pickups.tenant_id` 表示实际创建和管理提号记录的提号站点。
- `admin_pickups.source_tenant_id` 表示商品和号主所属的货源站点。
- 提号列表、详情、导出、操作权限、店铺配置、历史映射和财务统计均按 `tenant_id` 隔离。
- 可提号商品池同时包含大锤商行和解忧商行货源;选择跨站商品时保存两个站点快照,并在后台明确显示“跨站提号”。
- 站内上传的号主结算仍进入号主所属货源站点钱包;平台代管的线下打款也归属提号站点处理。
- `admin_pickup_financial_adjustments.tenant_id`、`pickup_shops.tenant_id`、`pickup_shop_mappings.tenant_id` 必须与提号记录保持同一提号站点。
### 1. 数据库升级 (`000079_admin_pickup_extra_fields_and_shops.sql`)
1. 对 `admin_pickups` 表增加 4 个字段及必要索引:
- `operator VARCHAR(64) NOT NULL DEFAULT '' COMMENT '操作人(如客服/运营人员名字)'`
@@ -1,7 +1,7 @@
# 解忧商行双站点改造方案
> 状态:阶段 1~7 本地功能闭环已完成,后台租户边界修复完成,待真实域名切换
> 更新时间:2026-11-15
> 状态:阶段 1~7 本地功能闭环已完成,后台租户、平台财务、私有文件和任务边界已收口,待真实域名验收
> 更新时间:2026-11-16
> 目标:用一套后端、一套数据库和一套前端,上线大锤商行、解忧商行两个经营站点
## 1. 基调
@@ -63,9 +63,15 @@
- 租户各自复制一套后台程序;后台仍复用各经营站点 Host,平台运营统计使用独立只读域名。
- 统一跨站客服工作台。
- 双向自动铺货规则、复杂供货合同和自动追偿。
- 与首期无关的撞车、积分、邀请、成长、优质号主、线下提号和广告归因改造。
- 撞车商城和积分商城的完整经营租户拆分。
> 撞车、积分商城、线下提号等未完成经营租户隔离的模块,当前仍按平台共享能力处理;在完成独立租户改造前,不应把它们的结果当作某一经营站点的独立经营数据。
> 撞车商城、积分商城等未完成经营租户隔离的模块,当前仍按平台共享能力处理;在完成独立租户改造前,不应把它们的结果当作某一经营站点的独立经营数据。
>
> 运营开支、其他线下出款属于平台级财务数据,不是单站经营数据,仅平台超级管理员可操作。
>
> 线下提号按提号站点独立记录、统计和操作,同时允许选择另一经营站点的已上架货源;货源站点单独保存在提号记录中。
>
> 客服手动录单及平台、操作人、出款操作人选项按经营站点独立维护,不跨站共享。
## 4. 目标架构
@@ -105,7 +111,7 @@
| 表 | 字段 |
|---|---|
| `users` | `tenant_id`,手机号唯一键改为 `(tenant_id, phone)` |
| `users` | `tenant_id`,手机号唯一键为 `(tenant_id, distribution_site_id, phone)`;经营用户使用 `distribution_site_id=0`,历史分销用户保留原渠道 ID |
| `user_realname` | `tenant_id`,身份证唯一键改为 `(tenant_id, id_no_hash)` |
| `user_payment_accounts` | `tenant_id` |
| `wallet_accounts`、`wallet_ledger` | `tenant_id` |
@@ -113,6 +119,8 @@
| `game_accounts` | `source_tenant_id` |
| `rental_listings` | `source_tenant_id`(号主所属租户由 `owner_id -> users.tenant_id` 约束) |
| `rental_orders` | `buyer_tenant_id`、`source_tenant_id`、`payment_tenant_id`、`source_amount_cent` |
| `admin_pickups` | `tenant_id`(提号站点)、`source_tenant_id`(货源站点) |
| `cs_manual_entries`、`cs_manual_entry_options` | `tenant_id`,录单编号和选项名称按经营站点分别唯一 |
| `payment_merchant_configs` | `owner_tenant_id` |
| `payment_orders` | `tenant_id` |
| `notifications`、`sms_messages` | `tenant_id`、`source_tenant_id` |
@@ -148,6 +156,7 @@ source_amount_cent
- 同一手机号可以在两个租户分别注册。
- 历史分销用户只能从原分销域名登录,不进入经营站点用户体系。
- 同一手机号的历史分销身份和大锤经营身份可以并存,按 `tenant_id + distribution_site_id + phone` 区分。
- JWT 必须包含 `tenant_id` 和 `scope`。
- 用户令牌只能访问令牌所属经营租户。
- 短信验证码、登录失败、限流、实名和钱包 Key 都带租户。
@@ -155,8 +164,8 @@ source_amount_cent
- 共享客服可以同时拥有两个租户的客服角色。
- `super_admin` 使用 `tenant_id=0` 的平台角色,可以查看全部租户。
- 首期复用同一套后台页面,通过当前 Host 确定租户;主站和解忧各自通过本站域名进入后台。
- 平台运营使用独立 `ops.<主域名>` 只读统计后台,仅平台超级管理员可登录。
- 权限缓存 Key 至少包含管理员 ID 和租户 ID。
- 平台运营使用独立 `OPS_DOMAIN` 只读统计后台,未配置时默认 `ops.<主域名>`,仅平台超级管理员可登录。
- 权限缓存 Key 至少包含管理员 ID,并区分经营租户和平台运营作用域。
## 7. 共享号库和双站货架
@@ -249,7 +258,7 @@ A 站商品进入 B 站货架
平台统计按租户分组展示,不把两个租户的内部交易重复相加为公司 GMV。
平台运营后台另设 `ops.<主域名>`,只提供只读统计,不开放用户、订单、商品和资金操作。
平台运营后台另设 `OPS_DOMAIN`,只提供只读统计,不开放用户、订单、商品和资金操作。
## 11. 客服、通知、文件和任务
@@ -263,6 +272,8 @@ A 站商品进入 B 站货架
- 通知、短信、未读统计和消息缓存按租户隔离。
- 私有文件上传和读取校验租户及业务角色。
- 经营站点管理员读取私有文件时同样校验当前租户,不允许按对象 key 越站读取。
- 管理员临时上传的文件记录管理员归属,业务记录保存前即可安全预览。
- 二维码、运营开支凭证和手工出款凭证必须纳入对应业务关联授权。
- 定时任务从订单、支付、会话等业务记录恢复租户,无法解析时暂停并告警。
首期不做客户会话、货源会话、内部案件的复杂拆分。
@@ -350,12 +361,15 @@ A 站商品进入 B 站货架
现有分销表不迁移为经营租户。
启用解忧前必须保留大锤完整回归数据。启用同手机号双租户后,应用回滚不能再退回旧全局手机号版本;故障回滚通过关闭解忧域名和功能开关、保留兼容代码完成。
历史分销身份和大锤经营身份并存后,数据库回滚不能再恢复旧的 `(tenant_id, phone)` 唯一键。
两个站点分别创建同名线下提号店铺后,数据库回滚也不能恢复旧的全局店铺名唯一键;故障回滚应关闭解忧提号入口并保留复合唯一键。
## 15. 上线验收
- 未知域名不会落到大锤。
- 主站和解忧域名都能打开各自后台登录入口。
- 同一手机号可以在两个租户注册。
- 同一手机号的历史分销与大锤经营身份可以并存,且不能互相登录对方入口。
- 大锤 JWT 不能访问解忧数据,反向同样拒绝。
- 两个站点都能看到双方开放的商品。
- 未开放商品无法通过详情、图片、搜索或分享链接访问。
@@ -367,7 +381,12 @@ A 站商品进入 B 站货架
- 两个站点的用户、订单、支付、钱包和统计互不串数据。
- 用户管理、申诉仲裁和钱包调账不能跨经营租户操作。
- 审计日志、公告、管理员通知和私有文件访问不能跨经营租户。
- 站点管理员不能访问平台级运营开支和其他线下出款;平台超级管理员可正常预览财务凭证。
- 平台运营后台的 HTML、JS、CSS 和静态图标均可正常加载。
- 出货站不能关闭或封存买方已支付订单;退款只能由买方租户发起。
- 每个站点只能管理本站发起的线下提号;提号时可以选择另一站点的已上架货源。
- 跨站线下提号的利润和出款统计归属提号站点,号主结算进入货源站点号主钱包。
- 两个站点的手动录单、平台选项、操作人选项和出款操作人选项互不可见。
- 历史分销用户、订单、钱包和提现不会进入经营站点后台及统计。
- 每个经营站点可以在商品详情中独立设置本站售价和展示状态。
- 无租户上下文的任务暂停并告警。