总店 / 分店：字段、分店策略、分销关系

先记三句话

1. 包是谁的：独立小程序永远属于总店（_zong_mch_id）。导航、主题、装修读这一层。
2. 人在哪家店：没选分店就是总店；选店 / 扫码 / 转发进了分店，就是分店（请求里的生效 mch_id）。商品、订单、分销商读这一层。
3. 分销商一店一行：同一用户可以在总店是分销商、在分店再申请一次，两条 yjd_share，互不影响。

总店和分店是什么关系

都在 yjd_mch。分店不是独立平台，而是挂在某一家总店下面的店。

例：总店「绿茶餐厅（壹方天地店）」23778，分店「测试」23818，parent_mch_id=23778，store_id 都是 365。

flowchart LR
  PKG["独立小程序包\n_zong_mch_id=23778"]
  HQ["总店 yjd_mch 23778\nshop_type=1"]
  BR["分店 yjd_mch 23818\nshop_type=2"]
  PKG --> HQ
  HQ -->|parent_mch_id| BR

商品建在总店、订单记在当前店，见 总店与分店 · 数据关系。

本店用户怎么算

平台包和商家独立包共用同一个 store_id，以前总店后台用「没绑分店」当本店用户，会把平台小程序用户一起算进去。现在登录时把包主写到 yjd_user.mch_id（等于请求里的 _zong_mch_id）。

yjd_user.branch_id 只表示进了哪家分店（0=还没进分店），不能用来区分平台用户和总店用户。不授权头像、正常打开小程序也会建号，同样要带上包主。余额：商家自己小程序读 yjd_user.money，yjd_user_mch_balance 只给平台包逛入驻店用。完整说明见 平台 / 商家 / 总店 / 分店 · 用户关系。

请求里三个商家 ID（最容易绕）

小程序每次请求都会带这三个字段（tenant.js / attachTenantFields）：

哪些数据跟总店，哪些跟当前店

分店策略（打开小程序进哪家店）

配在总店：平台后台 mch/mch/index/edit（仅 shop_type=1 显示）。字段 yjd_mch.mp_entry_mode。

接口：C 端 chain-meta 会带回 mp_entry_mode 和 need_pick_store。单店模式 need_pick_store=false。

flowchart TD
  OPEN["打开总店独立小程序"]
  MODE{"mp_entry_mode"}
  PICK["pages/store-pick\n选店"]
  HQ["逛总店\nmch_id=总店"]
  BR["逛分店\nmch_id=分店"]
  SCAN["扫码/转发带分店 mch_id"]
  OPEN --> MODE
  MODE -->|"1 分店模式"| PICK
  PICK --> BR
  MODE -->|"2 单店模式"| HQ
  SCAN --> BR

分销：一店一行

表 yjd_share 增加 mch_id，含义与请求生效 mch_id 相同：成为分销商时所在的店。

• 唯一口径：user_id + store_id + mch_id + is_delete=0
• 总店申请 → 一行 mch_id=23778
• 进分店再申请 → 另一行 mch_id=23818
• 总店审核通过，分店没申请：进分店仍显示要申请（对的）
• yjd_user.is_distributor 只是用户级标记；本店是不是分销商以这一行为准（api/share/check）

写入点

成为条件（平台设置，按 store）

yjd_setting.share_condition：

• 1 提交申请 · 需要审核（status=0）
• 2 提交申请 · 无需审核（直接 status=1）
• 3 无需申请 · 授权即成为（登录 / check 直接写通过）

申请页不再强制真实姓名、手机；空姓名用微信昵称。

后台列表

商家后台分销商列表过滤 yjd_share.mch_id = 本店。总店看不到分店的分销商，分店也看不到总店的。平台总后台不带商家 ID 时仍按整个 store_id 看。

佣金与上级

订单记在当前店（order.mch_id）。找上级分销商、分销等级时，优先用 订单店 那一行 yjd_share。用户在总店是分销商、在分店不是，分店订单不会按总店那一行计佣。

上下级关系仍在 yjd_user.parent_id（用户级）。同一人在两家店都是分销商时，团队人数可能交叉，按订单店拆开看佣金。

容易绕开的几件事

1. 导航还是总店的：进了分店，底部仍是总店配的「首页 / 分类 / 购物车 / 我」，不会变成平台导航，也不会读分店（分店通常没配导航）。
2. 没点「进入门店」不算进分店：branch_mch_id 必须 user_picked=true。只打开过选店页、或接口写过 chain 缓存，不会把后续个人中心、分销申请改成分店。
3. 单店模式冷启动：本地以前选过的分店作废，打开就是总店。要进分店只能扫码 / 转发。
4. check=2 是待审核：不是「还没申请」。待审核不要再跳到填写手机号的申请页。
5. 不要用 _build_mch_id：已废弃，只认 _zong_mch_id。

和商品 / 订单文档怎么配合

• 总店与分店 · 数据关系 — 建品、选品、库存、订单归属与 SQL
• 平台 / 商家 / 总店 / 分店 · 用户关系 — 两套小程序两条用户、包主打标、两套余额
• 购物车 · 平台 / 总店 / 分店 — 加购按商品商家分堆、连锁货在总店
• 本文 — 进店策略、请求字段、配置跟谁、分销商跟谁