# 房间 / 群 / 分销功能说明文档（开发视角） ## 一、整体架构 - 层级结构： - 平台 → 房间（Room）→ 群（Group）→ 群员 / 分销身份（Distributor） - 身份核心： - 每条分销身份由「平台 + 房间 + 群 + 用户」组合唯一确定，用于分销归属和订单结算。 --- ## 二、房间模块（Room） ### 2.1 房间功能点 - 创建房间申请： - 用户提交房间名称、头像、品牌注解等信息。 - 后台审核通过后，生成房间，并指定房间主。 - 房间信息维护： - 房间主可编辑名称、头像、品牌注解。 - 房间顶部功能栏配置： - 默认显示「师傅库 / 商城 / 会话厅」三项。 - 房间主可以修改显示文案（总字数受限），功能类型不变。 - 房间权限与扣点设置（后台）： - 是否开启本房间商城。 - 是否允许本房间下的群进行选品。 - 房间级扣点与收费策略配置。 - 房间切换： - 同一微信可加入多个房间，通过「切换圈子」在不同房间间切换。 --- ## 三、群模块（Group） ### 3.1 建群与审核 - 在某房间内，用户可发起建群申请。 - 填写群基础信息（城市、区域、主营类目、群规模等）。 - 审核流程： - 房间主初审； - 后台终审； - 通过后创建群，申请人自动成为群主。 ### 3.2 群基本操作 - 群信息维护： - 群主可编辑群名、介绍、主营描述等。 - 群状态控制（后台）： - 支持群的启用/禁用； - 禁用后，群内发单、接单、分销等操作关闭或受限。 - 群主变更： - 后台可在必要时调整群主（例如违规处理）。 ### 3.3 群监管 - 支持在任意群中驻入“系统机器人/系统监管号”： - 具备基本群管理与后台数据采集、监控能力。 - 用于运营与风险控制。 --- ## 四、群员 / 分销身份模块 ### 4.1 分销身份规则 - 每个用户在某「平台 + 房间 + 群」组合下对应一个分销身份。 - 同一微信在不同房间/群中拥有多个独立身份： - 每个身份有独立的分销链； - 后台视为多个“人”。 ### 4.2 加入群与分销绑定 - 成员加入群时： - 若在该群下不存在分销身份，则系统为其创建一条新身份线。 - 按既有三级分销规则绑定上级分销。 - 上下级分销关系： - 限定在当前群对应的分销线中，不跨群共享。 ### 4.3 角色与权限（概念层） - 群主： - 本群最高级分销； - 拥有选品、群配置、成员管理等高权限。 - 管理员： - 由群主任命，可拥有部分管理能力（禁言、审核、公告等）。 - 普通分销/群员： - 不能在群内进行选品； - 可以拉人建立下级分销关系。 --- ## 五、会话厅与群聊相关功能 ### 5.1 订单页面导航（左侧） - 导航栏包含 4 项： - 资源库； - 商品城； - 会话厅； - 附近圈动态。 - 群主可以： - 修改导航名称（总字数有限制）； - 单独开放/禁用任一入口； - 与外层房间首页的导航机制保持一致。 - 右下角「会话大厅」按钮： - 进入群聊页面（中间页）； - 文案可改，群主/平台可控制是否可用。 ### 5.2 资源库（A） - 展示服务师傅资料与店铺： - 格式类似现有“师傅圈”，但样式可定制。 - 群主可设置仅群内成员可见，或继承房间级展示。 - 提供发布入口，支持基于群选品的类目发单。 ### 5.3 商品城（B） - 群级商城展示逻辑： - 与整体商城逻辑一致； - 差异在于：群商城的选品由群主独立配置。 - 所有人看到的商品、类目等均来源于群主选品结果。 - 首页热门类目默认服务类，可左滑出商品类目列表。 - 列表筛选按价格、评分、销量进行。 - 销量统计按整条商品聚合，不再按规格拆分。 ### 5.4 会话厅（C） - 会话厅为“会话/订单流”页面，不是群聊页面。 - 默认进入订单页时落在该列： - 支持上拉刷新； - 承载订单、系统相关信息的流式展示。 ### 5.5 附近圈动态（D） - 展示商家图文动态的“公共圈子”区域： - 默认名称为“附近圈动态”； - 群主可以改名，但含义不变（商家圈/动态圈）。 ### 5.6 会话大厅图与编辑订单（E） - 页面中部展示“会话大厅相关图”： - 使用会话大厅图的一部分放大，作为视觉入口。 - 支持进入“编辑订单/发单页”： - 编辑后的订单可发至全群； - 管理员可选择仅发送至单个客户。 --- ## 六、群聊在线控制与刷新机制 ### 6.1 在线人数限制 - 当群聊在线人数超过上限（群主/后台可配置）： - 群主与管理员不受上线限制，始终在线。 - 系统自动将部分成员标记为离线： - 优先踢出近期未发言的成员； - 该过程对成员前端为“默默离线”，不会强制踢出页面。 ### 6.2 重新上线与刷新 - 被标记为离线的成员： - 在输入框输入内容时，自动重新上线。 - 新进群但未发言的成员： - 一段时间后，输入框变为“消息刷新”按钮； - 点击后重新加载消息，并作为新上线行为。 - 在已超上线限制的状态下： - 新进入成员默认离线； - 需主动刷新或发言才开始拉取实时消息。 ### 6.3 页面跳转与上线状态 - 在群聊中点击任何产品、品类跳转其他页面： - 无论是否超限，都视为离线（停止实时连接）。 - 从商品/其他页面返回群聊页： - 自动恢复为在线状态。 - 在商品页面点击“聊天”： - 跳回群聊，并恢复在线。 --- ## 七、会话厅顶部类目与选品关系 ### 7.1 顶部类目区 - 顶部显示： - 「全部」入口； - 若干热门类目。 - 热门类目： - 群主从本群的主营/重点品类中选定； - 可对特别重要的类目打红点标记。 - 展示方式： - 左右滑动； - 每行最多 8 个类目，最多展示两行。 ### 7.2 选品关系 - 群主 = 分销顶层： - 群主在本群选品的结果，体现在“全部”和热门类目展示中。 - 群员： - 无法直接在群内进行选品； - 仅能浏览、转发商品并参与分销。 --- ## 八、群内订单与全域订单 ### 8.1 群内订单发起 - 在群聊页面可以通过以下方式生成群内订单： - 使用专门的“群内订单发单入口”； - 将当前输入框的文字通过快捷键转换为订单（跳转到发单确认页）。 - 生成的群内订单： - 在群聊中以订单卡片形式展示； - 提供“接单”按钮。 ### 8.2 与专业版（师傅端）的联动 - 若群内发单时勾选“保险”等高级字段： - 该订单将按专业版（师傅端）逻辑处理； - 接单、保险、结算等均走专业端流程。 - 群主可配置： - 群内订单是否仅允许本群服务人员接单； - 或是否允许进入大厅，被所有专业师傅接单。 ### 8.3 全域订单 - 群主可将部分群内订单开放到“全域订单池”： - 其他群的服务商也能在“全域订单”中看到这些订单并接单。 - 展示限制： - 在群页面或全域订单列表中： - 只有服务商能看到具体金额； - 普通消费者看不到金额。 ### 8.4 订单生命周期（概念） - 典型状态流： - 已发单 → 待服务（需要填写上门时间）→ 已提交 → 已付款 → 已完成。 - 客户侧操作： - 在“已提交”中查看支付方式并确认； - 确认支付后进入“已付款”。 - 服务侧操作： - 服务方确认“已收款，结单”，进入“已完成”。 ### 8.5 纯发单群模式 - 对于“只发单、不聊天”的群： - 群聊可以不保持实时连接； - 用户仅在手动刷新时看到新订单； - 群形态接近“单纯接单页面”，以降低系统实时成本。 --- ## 九、「我的」与运营视角 - “我的”页面沿用现有商城结构： - 包含分销中心、订单、选品等模块。 - 统计以微信号为主视角： - 汇总展示该用户在不同房间、群中的运营情况； - 可按房间、群进行明细下钻。 --- ## 十、后台与审计（功能级） - 房间管理： - 房间申请审批； - 房间启用/禁用； - 房间级扣点/收费配置。 - 群管理： - 建群申请审核； - 群启用/禁用； - 群主调整； - 系统机器人驻入/移除。 - 审计日志： - 创建/修改房间、群； - 修改扣点与重要配置； - 关键权限调整（如群主、管理员变更）等操作均需记录。 --- **文档定位**：开发可读的功能说明（不含字段/接口细节） **用途**：指导后续接口设计、表结构设计与前后端实现拆分