From d957a0c2a33ebac90c91af994998031d29655eed Mon Sep 17 00:00:00 2001 From: cb <275647614@qq.com> Date: Mon, 22 Dec 2025 18:05:22 +0800 Subject: [PATCH] no message --- doc/房间群业务需求说明文档.md | 214 ++++++++++++++++ doc/房间群分销功能说明文档(开发视角).md | 285 +++++++++++++++++++++ doc/群成员身份标签与权限管理功能文档.md | 299 ++++++++++++++++++++++ 3 files changed, 798 insertions(+) create mode 100644 doc/房间群业务需求说明文档.md create mode 100644 doc/房间群分销功能说明文档(开发视角).md create mode 100644 doc/群成员身份标签与权限管理功能文档.md diff --git a/doc/房间群业务需求说明文档.md b/doc/房间群业务需求说明文档.md new file mode 100644 index 00000000..39cd998c --- /dev/null +++ b/doc/房间群业务需求说明文档.md @@ -0,0 +1,214 @@ + +# 房间 / 群 / 群员业务需求说明文档 + +## 一、项目背景与目标 + +- **背景** + 在现有「师傅 / 商城 / 分销」体系上,引入「房间(圈子)+ 群 + 分销」的新结构,实现多房间、多群、多身份的精细化运营与监管。 + +- **目标** + - 建立清晰的层级结构:**平台 → 房间 → 群 → 群员/分销**。 + - 统一分销身份规则,保证订单与佣金归属准确。 + - 支持群主、房间主、下级分销、运营商等多角色协同。 + - 为后续房间收费、群收费、群员收费等模式预留空间。 + +--- + +## 二、核心概念定义 + +### 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 家)报价,确认后进入支付流程。 + +--- + +## 六、「我的」与运营统计(概念级) + +- “我的”页面延用现有结构: + - 展示分销中心、订单、选品等信息。 +- 运营统计以微信号为主体: + - 汇总展示多房间、多群的运营数据; + - 可按房间、群维度下钻查看。 + +--- + +## 七、商品与服务上架(概念级) + +- 服务上架沿用当前规则。 +- 商品上架需区分于服务: + - 针对库存、规格、展示方式做单独设计; + - 与服务上架在前台展示上明显区分。 + +--- + +## 八、后台与安全监管(概念级) + +- 房间级管理: + - 房间创建与审核; + - 房间启用/禁用; + - 房间收费与扣点配置。 +- 群级管理: + - 建群审核; + - 群启用/禁用; + - 群主调整; + - 系统机器人驻入/移除。 +- 操作审计: + - 记录房间、群创建和重要参数修改,便于运营追溯。 + +--- + +**文档定位**:业务需求说明(偏产品视角) +**用途**:为后续详细设计与开发提供业务背景和规则依据 + + diff --git a/doc/房间群分销功能说明文档(开发视角).md b/doc/房间群分销功能说明文档(开发视角).md new file mode 100644 index 00000000..290558e0 --- /dev/null +++ b/doc/房间群分销功能说明文档(开发视角).md @@ -0,0 +1,285 @@ + +# 房间 / 群 / 分销功能说明文档(开发视角) + +## 一、整体架构 + +- 层级结构: + - 平台 → 房间(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 纯发单群模式 + +- 对于“只发单、不聊天”的群: + - 群聊可以不保持实时连接; + - 用户仅在手动刷新时看到新订单; + - 群形态接近“单纯接单页面”,以降低系统实时成本。 + +--- + +## 九、「我的」与运营视角 + +- “我的”页面沿用现有商城结构: + - 包含分销中心、订单、选品等模块。 +- 统计以微信号为主视角: + - 汇总展示该用户在不同房间、群中的运营情况; + - 可按房间、群进行明细下钻。 + +--- + +## 十、后台与审计(功能级) + +- 房间管理: + - 房间申请审批; + - 房间启用/禁用; + - 房间级扣点/收费配置。 +- 群管理: + - 建群申请审核; + - 群启用/禁用; + - 群主调整; + - 系统机器人驻入/移除。 +- 审计日志: + - 创建/修改房间、群; + - 修改扣点与重要配置; + - 关键权限调整(如群主、管理员变更)等操作均需记录。 + +--- + +**文档定位**:开发可读的功能说明(不含字段/接口细节) +**用途**:指导后续接口设计、表结构设计与前后端实现拆分 + + diff --git a/doc/群成员身份标签与权限管理功能文档.md b/doc/群成员身份标签与权限管理功能文档.md new file mode 100644 index 00000000..66c1a18f --- /dev/null +++ b/doc/群成员身份标签与权限管理功能文档.md @@ -0,0 +1,299 @@ +# 群成员身份标签与权限管理功能文档 + +## 文档说明 +本文档描述群聊中**群成员身份标签、分类管理、权限控制、消息通知**相关的功能逻辑,不涉及字段/表结构设计,仅面向功能实现。 + +--- + +## 一、群成员身份标签系统 + +### 1.1 身份标签类型 +系统支持以下身份标签: +- **创建者**:群创建者(通常也是群主) +- **管理员**:被群主任命的管理员 +- **服务商家**:提供服务的商家/师傅 +- **商品商家**:提供商品的商家 +- **消费者**:普通消费者 +- **发单人**:经常发单的用户 +- **接单人**:经常接单的用户 +- **群成员**:普通群成员 +- **VIP客户**:VIP客户 + +### 1.2 标签分配流程 +- **入群时自选标签** + - 用户加入群时,系统提供两个初始选项: + - **非商家** + - **商家** + - 用户选择一个作为初始身份标识。 +- **群主/管理员最终确认** + - 群主或管理员可以在群成员资料中: + - 查看用户自选的标签。 + - 从系统标签库中选择一个标签,覆盖或确认用户的标签。 + - 后续可以随时修改成员的标签。 +- **标签对外展示** + - 标签会显示在群成员资料、群成员列表等位置,作为该成员在群内的“对外身份”。 + +### 1.3 群成员资料栏位 +- **群成员资料页包含7个栏位**: + - 每个栏位可以放置一个名称/备注。 + - 这些栏位对所有身份/标签的群员都开放使用。 + - 用途:方便所有群员查看和识别成员信息。 + +--- + +## 二、群成员分类/分组系统 + +### 2.1 分类概念 +- **分类定义** + - 群内成员可以按照“分类”进行组织,每个分类可以理解为“分组”或“分仓”。 + - 系统支持创建 **1~7个分类**。 + - 每个分类可以自定义命名(例如“1类”、“2类”,或自定义别名如“核心商家组”、“普通客户组”等)。 +- **分类与标签的关系** + - 分类与身份标签是**独立的两套体系**: + - 一个成员可以拥有一个身份标签(如“服务商家”)。 + - 同时,该成员可以被放入任意一个分类中(如“1类”)。 + - 标签不影响分类归属,分类也不影响标签展示。 + +### 2.2 分类操作 +- **成员分类归属** + - 任何成员可以被放入任意一个分类中。 + - 例如:可以将某个“服务商家”放入“1类”,也可以将某个“消费者”放入“1类”。 + - 成员可以只属于一个分类,也可以不属于任何分类(显示在“未分类”或“全部”中)。 +- **按分类查看成员** + - 群主与管理员可以: + - 按分类查看成员列表。 + - 按标签查看成员列表。 + - 按“分类+标签”组合筛选查看。 +- **普通群成员查看** + - 普通群成员在群名单中: + - 可以按“全部”及“标签身份”查看成员信息。 + - 不能按分类查看(分类信息对普通成员不展示)。 + +### 2.3 分类消息发送 +- **管理员按分类发消息** + - 管理员可以: + - 选择向某个分类的所有成员发送消息(其他分类看不到)。 + - 选择向某个分类中的单个成员发送消息。 + - 用途:主要用于群管理员进行精细化运营和定向通知。 + +--- + +## 三、管理员任命与权限体系 + +### 3.1 管理员任命 +- **任命流程** + - 群主可以任命任意群成员为管理员。 + - 任命时可以: + - 标注该管理员的“岗位名称”(例如“客服主管”、“运营专员”等)。 + - 有岗位名称的管理员会在“服务团队消息专列”中显示。 +- **订单交付权限(独立于管理员)** + - 订单交付栏的权限与管理员身份独立: + - 群主可以勾选某些成员(不一定是管理员)拥有“订单交付权限”。 + - 拥有交付权限的人可以在订单交付栏中发布交付信息。 + +### 3.2 管理员权限列表 +群主在任命管理员时,可以勾选该管理员拥有的权限项。管理员在哪个分类中不影响其权限范围。 + +#### 权限1:按类发群信息 +- 管理员可以向指定分类的所有成员发送群消息(其他分类看不到)。 + +#### 权限2:禁言与消息可见性控制 +- **禁言功能(实际为“审核可见”)** + - 管理员可以按分类或单个成员设置“禁言”。 + - 被禁言的成员: + - 仍然可以发送消息,但消息默认**仅管理员可见 + 自己可见**。 + - 管理员可以在后台审核这些消息,勾选后才会展示到群聊页面。 + - 严格来说这不是传统“禁言”,而是“审核可见”机制。 +- **消息可见性设置** + - 管理员可以: + - 按分类设置:该类群员发的消息仅该类成员可见,或仅管理员可见。 + - 按单个成员设置:该成员发的消息仅管理员可见(在群内形成独立通道,对其他人无感)。 +- **特殊规则** + - 被禁言的成员仍然可以发送商品链接到群(商品链接不受禁言限制)。 + - 管理员查看消息的规则: + - 如果管理员属于某个分类,只能看到该类群员发的信息。 + - 如果管理员在“全部”分类中,可以看到所有分类群员发的信息。 +- **管理员@解禁** + - 管理员可以@被禁言的成员,临时解禁3小时。 + +#### 权限3:禁止接单 +- 管理员可以按分类或单个成员设置“禁止点击接单键”。 +- 被禁止的成员无法接取群消息中的订单。 + +#### 权限4:禁止发单 +- 管理员可以按分类或单个成员设置“禁止点击发单键”。 +- 被禁止的成员无法使用发单功能(包括类目发单)。 + +#### 权限5:禁止互加好友 +- 管理员可以按分类或单个成员设置“禁止互加好友”。 +- 被禁止的成员: + - 别人无法添加他为好友。 + - 他也无法添加别人为好友。 +- **特殊规则** + - 即使被禁止加好友,双方仍然可以: + - 在服务团队聊天中直接对话(通过服务团队入口)。 + +#### 权限6:屏蔽群内信息 +- 管理员可以按分类或单个成员设置“屏蔽群内信息”。 +- 被屏蔽的成员: + - 看不到群内在发的消息。 + - **但订单仍然可见可接**(屏蔽消息,不屏蔽订单展示)。 + +#### 权限7:禁止发圈信息 +- 管理员可以按分类或单个成员设置“禁止发圈信息”。 +- 被禁止的成员无法在商家圈/动态圈中发布内容。 + +#### 权限8:审核成员入群 +- 管理员可以审核新成员的入群申请。 + +#### 权限9:删除成员与撤回消息 +- 管理员可以: + - 删除群成员(将成员移出群)。 + - 撤回群成员的消息: + - 可以撤回任意成员的一条消息。 + - 可以彻底删除消息(删除后不可见,不可恢复)。 + +#### 权限10:分类分标签发公告 +- 管理员可以: + - 按分类发送公告。 + - 按标签发送公告。 + - 按“分类+标签”组合发送公告。 + +--- + +## 四、群主专属权限 + +### 4.1 群名设置 +- 群主可以修改群名称。 + +### 4.2 群转让 +- 群主可以将群主身份转让给其他成员。 + +### 4.3 开通入群申请 +- 群主可以开启/关闭“入群申请”功能。 +- 开启后,新成员需要申请才能加入群。 + +### 4.4 待接单显示规则(待定) +- 群主可以设置“待接单是否仅显示本群的订单”(此功能待定,可能不实现)。 + +--- + +## 五、群消息通知机制 + +### 5.1 消息通知基础规则 + +#### 未打开登录页面的通知策略 +- 用户未打开登录页面(APP未打开)时: + - 系统每 **5分钟** 聚合一次新消息,发送一条通知。 + - 通知内容:显示所有群的新消息汇总(例如“您有X条新消息”)。 + - 用户打开APP后,不再发送聚合通知。 + +#### 群外消息计数 +- 在群列表页面(群外): + - 每个群名旁边显示该群的消息数量角标。 + - APP端统一使用角标显示。 + +### 5.2 群消息免打扰设置 + +#### 免打扰选项 +每个群成员可以为自己设置该群的“免打扰”策略,选项包括: +- **仅1小时1条**:1小时内只通知一次。 +- **仅1天1条**:1天内只通知一次。 +- **仅3天1条**:3天内只通知一次。 +- **仅10天1条**:10天内只通知一次。 + +#### 免打扰与通知队列的关系 +- 系统维护多个通知队列: + - **5分钟通知队列**:默认队列,每5分钟通知一次。 + - **1小时通知队列**:设置了“1小时1条”的用户进入此队列。 + - **1天通知队列**:设置了“1天1条”的用户进入此队列。 + - **3天通知队列**:设置了“3天1条”的用户进入此队列。 + - **10天通知队列**:设置了“10天1条”的用户进入此队列。 +- 用户设置免打扰后: + - 从“5分钟队列”中剔除,进入对应的免打扰队列。 + - 例如:设置“1小时1条”后,每1小时聚合通知一次(而不是每5分钟)。 + +#### 通知时间窗口 +- **5分钟队列与1小时队列**: + - 晚上7点后不通知。 + - 早上8点后才开始通知。 +- **1天队列、3天队列、10天队列**: + - 通知时间点可以设定在12点,或错开时间点(例如1天队列12点,3天队列14点,10天队列16点),以减少大量通知同时推送。 + +#### 用户类型与免打扰选择 +- **经营者(商家/师傅)**: + - 更多选择“5分钟通知”或“1小时通知”(需要及时响应)。 +- **客户(消费者)**: + - 更多选择“3天通知”或“10天通知”(降低打扰频率)。 + +### 5.3 @通知机制 + +#### @通知规则 +- **无论用户是否设置免打扰**,被@时: + - 使用**手机上方消息栏**直接通知(不进入队列等待)。 + - 通知带有声音提醒(用户可以自定义声音)。 + - 不等待5分钟/1小时等时间窗口,立即推送。 + +#### @通知展示位置 +- @通知显示在手机顶部通知栏(系统级通知)。 + +--- + +## 六、消息通知总结 + +### 6.1 通知队列体系 +系统维护以下通知队列: +1. **5分钟通知队列**(默认) + - 时间窗口:早上8点 ~ 晚上7点。 + - 每5分钟聚合通知一次。 +2. **1小时通知队列** + - 时间窗口:早上8点 ~ 晚上7点。 + - 每1小时聚合通知一次。 +3. **1天通知队列** + - 在指定时间点(例如12点)通知一次。 +4. **3天通知队列** + - 在指定时间点(例如14点)通知一次。 +5. **10天通知队列** + - 在指定时间点(例如16点)通知一次。 + +### 6.2 特殊通知(不受队列限制) +- **@通知**: + - 立即推送,使用手机顶部通知栏。 + - 带声音提醒。 + - 不受免打扰设置影响。 + +### 6.3 通知聚合规则 +- **未打开APP时**: + - 所有群的新消息统一聚合为一条通知(例如“您有X条新消息”)。 + - 按用户所属队列的时间窗口进行通知。 +- **打开APP后**: + - 不再发送聚合通知。 + - 用户可以在APP内查看各群的具体消息。 + +--- + +## 七、功能总结 + +### 7.1 身份标签与分类 +- 9种身份标签,入群时自选,群主/管理员可最终确认和修改。 +- 支持1~7个分类,分类与标签独立,成员可被放入任意分类。 + +### 7.2 管理员权限 +- 10个权限点,群主可灵活配置每个管理员的权限。 +- 订单交付权限独立于管理员身份。 + +### 7.3 消息通知 +- 5个通知队列(5分钟/1小时/1天/3天/10天),用户可自由选择。 +- @通知立即推送,不受免打扰影响。 +- 时间窗口控制,避免夜间打扰。 + +--- + +## 八、待定事项 +- 待接单是否仅显示本群的订单(功能待定)。 + +--- + +**文档版本**:v1.0 +**最后更新**:2024年 +