<!-- @author Yifei.Kuang -->
# 房间 / 群 / 群员业务需求说明文档

## 一、项目背景与目标

- **背景**  
  在现有「师傅 / 商城 / 分销」体系上，引入「房间（圈子）+ 群 + 分销」的新结构，实现多房间、多群、多身份的精细化运营与监管。

- **目标**
  - 建立清晰的层级结构：**平台 → 房间 → 群 → 群员/分销**。
  - 统一分销身份规则，保证订单与佣金归属准确。
  - 支持群主、房间主、下级分销、运营商等多角色协同。
  - 为后续房间收费、群收费、群员收费等模式预留空间。

---

## 二、核心概念定义

### 2.1 平台

- 系统最上层运营主体，负责全局参数（平台扣点、结算规则等）。

### 2.2 房间（圈子）

- **定义**：平台下的独立运营空间，一个平台可创建多个房间。
- **特点**
  - 房间名称：限制在 4–6 个字。
  - 房间标识图片、品牌注解由房间主配置。
  - 顶部功能栏：默认为「师傅库 / 商城 / 会话厅」，文字可改，总长度有限制但功能不变。
  - 房间可配置自身的功能权限（是否开放商城、是否允许群选品等）以及扣点、收费策略。
- **关系**
  - 「微社圈」是整体产品名，“切换圈子”即切换不同房间。

### 2.3 群（分销群）

- **定义**：隶属于某房间的运营群，每个房间下可以创建多个群。
- **建群要求**
  - 填写城市、区域、主营品类、预期群规模等信息。
  - 建群申请需由房间主及后台审核（形式类似现有分销申请）。
- **职责**
  - 每个群经营自己的商品与客户。
  - 群商城中仅群主有选品权限，下级分销不能选品。

### 2.4 群主

- 该群的最高级分销者。
- 新建群后自动成为本群顶级分销（无上级分销）。
- 负责本群的选品、群成员管理、群内规则等。

### 2.5 群员 / 分销人员

- 所有群员可根据既有三级分销规则绑定上级关系。
- **分销身份规则**
  - 每个群员在「平台 + 房间 + 群」这一组合下有一个独立分销身份。
  - 同一微信号在不同房间、不同群中，对系统而言是多个独立身份。
- **影响**
  - 每个身份对应一条独立的分销线。
  - 订单结算与分账都按所在群对应的分销线进行。

### 2.6 系统机器人 / 监管号

- 平台可在任意群中驻入一个“系统机器人”账号：
  - 拥有类似群主的管理能力及后台监管能力。
  - 用于监管群运营是否健康、是否违规。

### 2.7 运营商（按微信号）

- 以微信号为主体的运营视角。
- 同一微信号在多个房间、多个群中有多条分销线，但在运营统计中可统一聚合。

---

## 三、分销身份与订单归属规则

### 3.1 唯一身份线

- 每条分销身份线由四段组合定义：  
  **平台ID + 房间ID + 群ID + 用户ID**
- 每一条组合都被视为“系统中的一个人、一条分销线”。

### 3.2 多群多房间身份

- 同一微信号在不同房间/群中创建或加入时：
  - 系统会为其生成新的分销身份线。
  - 不同房间、群的身份互不影响。

### 3.3 分销绑定

- 在某群中被拉入的新成员：
  - 按现有三级分销规则建立上下级关系。
  - 上下级关系限定在本群对应的分销线中。

### 3.4 订单与分销归属

- 用户从某个群入口进入商城并下单：
  - 所有分销与分账都按该群的分销线计算。
  - 即使服务商在其他群也有身份，本订单仍只归属于当前群对应的身份线。

---

## 四、房间与群的前台结构

### 4.1 房间首页结构

- 房间头部展示：
  - 房间头像/标识图；
  - 品牌名称（4–6 字）；
  - 简短品牌注解。
- 顶部功能栏：
  - 默认入口为：「师傅库 / 商城 / 会话厅」。
  - 房间主可修改这三个名称（总长度有限制），但功能含义不变。
  - 顶部入口与底部导航对应，为功能快捷入口。

### 4.2 师傅库

- 展示本房间下已入驻的师傅与服务店铺。
- 支持按街道、服务品类筛选。
- 师傅资料在现有认证信息基础上增加头像和定位信息。
- 用户可在师傅详情中：
  - 直接发起“发布订单”给该师傅；
  - 或将已有未接订单指派给该师傅。

### 4.3 商城

- 房间/群共用一个商城体系：
  - 房间级定义基础类目与商品池。
  - 群主在此基础上为本群做选品配置。
- 首页默认展示热门服务类目，可左划展示其他商品类目。
- 列表支持按价格、评分、销量筛选。
- 商品销量按整条上架商品做统一统计。

### 4.4 会话厅

- 作为房间的首页使用：
  - 展示全部群、自建群、已加入群、单聊会话等。
  - 顶部菜单包含：申请房间、申请建群、搜索群、房间名称设置等入口。
- 与群聊页面不同，主要承载群列表与会话入口。

---

## 五、订单与发布相关需求（概要）

### 5.1 师傅端状态汇总

- 师傅端首页顶部使用黄条展示：
  - 新订单数量；
  - 未约订单数量；
  - 待上门/待发货数量。
- 点击不同统计可跳转到对应订单列表。

### 5.2 发单入口

- 页面底部设置蓝色「+」按钮作为发布主单入口。
- 支持：
  - 服务类/商品类发单；
  - 选择到第 4 级类目，可多选；
  - 将常用配置保存为模板。
- 支持代填发布，由专业师傅代填问题内容，客户补充地址、电话后提交。

### 5.3 保险规则（概念级）

- 发单时默认勾选“启用保险核查服务费”。
- 发单方需选择保险费用由谁承担：
  - 服务费由发单方支付；
  - 服务费在订单中扣除。
- 到付场景下，已产生的保险费用仍需保留，并可在后续订单中抵扣。

### 5.4 报价/加价模式（概念级）

- 在满足一定条件（报价模式或允许商家报价）时，显示“加价/报价”入口。
- 支持大厅主单、未约/未排/监控单、已接单主单进行报价。
- 客户最多可选择 3 家（特例 4 家）报价，确认后进入支付流程。

---

## 六、「我的」与运营统计（概念级）

- “我的”页面延用现有结构：
  - 展示分销中心、订单、选品等信息。
- 运营统计以微信号为主体：
  - 汇总展示多房间、多群的运营数据；
  - 可按房间、群维度下钻查看。

---

## 七、商品与服务上架（概念级）

- 服务上架沿用当前规则。
- 商品上架需区分于服务：
  - 针对库存、规格、展示方式做单独设计；
  - 与服务上架在前台展示上明显区分。

---

## 八、后台与安全监管（概念级）

- 房间级管理：
  - 房间创建与审核；
  - 房间启用/禁用；
  - 房间收费与扣点配置。
- 群级管理：
  - 建群审核；
  - 群启用/禁用；
  - 群主调整；
  - 系统机器人驻入/移除。
- 操作审计：
  - 记录房间、群创建和重要参数修改，便于运营追溯。

---

**文档定位**：业务需求说明（偏产品视角）  
**用途**：为后续详细设计与开发提供业务背景和规则依据


