羽毛球系统「俱乐部」功能需求规格文档

安度因 发布于 阅读：95

状态：待评审

1. 问题陈述

当前羽毛球系统以「个人发布比赛 + 个人用户报名」为核心模式，本质上是单向的——个人负责组织一切，个人用户被动参与。这种模式存在三个明显瓶颈：

  1. 组织能力天花板：无法覆盖所有地域、所有层次的羽毛球活动需求，尤其是本地化、常态化的组局找搭子场景。
  2. 缺乏社群载体：羽毛球天然是高社交属性的运动，用户有归属感诉求，目前系统无法承载「俱乐部」这一社群形态。
  3. 商业变现单一：平台仅靠比赛报名费变现，缺乏 B2B2C（平台→俱乐部→用户）的多层商业模型。

引入「俱乐部」功能，本质上是将平台从一个「活动发布工具」升级为一个「羽毛球社群平台」——让有资源、有意愿的组织者（场馆方、教练、资深球友）成为平台的合作伙伴，由他们来服务和运营本地球友社群。

2. 目标

用户目标

序号 目标 衡量方式
U1 俱乐部组织者能够自主注册、管理俱乐部，招募会员 注册流程完成率 ≥ 80%
U2 会员能找到归属的俱乐部，参与内部比赛和组局 俱乐部会员活跃率（月活/总会员）≥ 40%
U3 俱乐部能够通过会员费获得收益 月均俱乐部会员费收入 > 0 的俱乐部占比 ≥ 30%

业务目标

序号 目标 衡量方式
B1 提升平台赛事供给量，突破组织瓶颈 平台月总比赛数增长 ≥ 100%
B2 建立俱乐部年审费 + 扩容费收入模型 俱乐部频道月收入达到可量化目标（待定）
B3 提升用户留存和活跃度 有俱乐部归属的用户 30 日留存率高于无归属用户 ≥ 15pp

3. 非目标

序号 非目标 原因
N1 不开放个人注册俱乐部 个人无营业执照、无场馆场景下，与现有「个人发布比赛」功能高度重合，缺乏独立价值。见第5节详细分析
N2 打通商城放在下一阶段开发 三方商城涉及类目/保证金/三方客服系统/物流发货等多种因素，将在后续阶段独立开发，暂时不纳入俱乐部 v1 范围
N3 不支持场地售卖与预订 原计划的场地售卖功能取消；比赛和组局也均不绑定场地，场地信息由发布者在活动描述中自行填写

4. 功能模块与用户故事

模块A：俱乐部注册与生命周期

A1. 注册申请流程

用户故事：

需求规格：

【P0】注册申请入口

步骤1：选择主体类型
  → 仅开放「企业/机构」注册（不开放个人注册）

步骤2：填写基本信息
  → 俱乐部名称（2-20字，需唯一性校验）
  → 俱乐部简介（选填，≤200字）
  → 所在城市（省-市-区 三级联动选择器）
  → 俱乐部详细地址（选填）
  → 联系人姓名、手机号（自动读取当前用户信息，可修改）

步骤3：上传资质文件
  → 营业执照（必填，支持 jpg/png/pdf，≤10MB）
  → 场馆照片（选填，最多5张，但建议设为强烈推荐的"选填"）
  → 其他资质证明（选填，如体育经营许可证等）

步骤4：阅读协议并缴费
  → 展示《俱乐部入驻协议》
  → 勾选「我已阅读并同意」
  → 支付年审费用
  → 拉起支付（微信支付）

步骤5：提交成功
  → 提示「申请已提交，预计 3 个工作日内完成审核」
  → 显示审核状态入口

【P0】后台审核系统

【P0】年审机制

验收标准：

模块B：俱乐部信息与管理

B1. 俱乐部信息编辑

用户故事：

需求规格：

【P0】俱乐部设置页

设置项 类型 说明
俱乐部名称 文本 修改需平台审核（防止恶意改名）
俱乐部简介 富文本 支持图文混排
俱乐部头像/Logo 图片 建议 200×200
封面图 图片 最多3张，轮播展示
所在位置 地址选择器 审核通过后不可自行修改，需提交变更申请

【P0】运营规则设置

设置项 类型 默认值 说明
是否允许用户申请加入 开关 开 关闭后新用户无法申请加入
加入是否需要审核 开关 开 开启 = 管理员审核通过方可加入；关闭 = 用户可直接加入
加入费用 金额 0（免费） 0 = 免费加入；>0 = 需付费加入，可选择「永久/一次性」或「年费/周期制」
非会员能否报名俱乐部比赛 开关 关 开启后，管理员发比赛时可选择「允许非会员报名」
会员参赛折扣 百分比 100%（无折扣） 设置后，会员报名本俱乐部比赛自动享受折扣（如 80% = 8折）
是否开启俱乐部分销 开关 关 开启后可设置1级分销佣金比例或具体金额,仅支持1级分销
最大会员数 数字 500 见 B4 扩容功能

【P1】俱乐部名称修改审核

B2. 子管理员体系

用户故事：

需求规格：

【P0】子管理员设置

【P0】子管理员额度

子管理员额度 费用
5 人（默认免费） 免费
10 人 ¥X/永久
30 人 ¥Y/永久
50 人 ¥Z/永久
自定义 按每人 ¥N 计算

【P0】权限边界

权限项 俱乐部管理员 子管理员
编辑俱乐部信息 ✓ ✗
设置运营规则 ✓ ✗
设置分销（开关/比例） ✓ ✗
移除会员（仅限免费会员） ✓ ✗
转移会员归属 ✓ ✗
发布比赛 ✓ ✓
删除自己发布的比赛 ✓ ✓
删除他人发布的比赛 ✓ ✗
查看俱乐部数据统计 ✓ ✗
查看自己名下用户 ✓ ✓
审核退款申请 ✓（全部） ✓（仅自己发布的活动）
审核会员费退款 ✓ ✗

B3. 会员管理

【P0】会员移除规则

俱乐部管理员可以移除会员，但有严格限制：

会员类型 是否可移除 说明
免费加入的会员 ✅ 可移除 管理员确认后即刻移除，会员失去俱乐部身份
付费永久会员 ❌ 不可移除 会员已一次性买断，永远不可移除
周期制年费会员（有效期内） ❌ 不可移除 会员已付费，在会员周期内受保护
周期制年费会员（已到期） — 自动移除 到期后系统自动移除，无需管理员操作

【P0】管理员不可主动添加会员

【P0】多俱乐部归属

【P0】会员归属规则

每个会员在俱乐部内归属到一个管理者名下，用于明确服务关系与售后责任。

归属场景 归属对象
用户自行加入俱乐部 自动归属俱乐部管理员名下
通过子管理员二维码或者转发小程序卡片邀请加入 自动归属该子管理员名下

【P0】会员归属转移

【P0】会员归属查看页面

B4. 俱乐部人员上限与扩容

用户故事：

需求规格：

【P0】基础上限

【P1】付费扩容

B5. 俱乐部分销

用户故事：

需求规格：

【P0】分销开关与比例设置

【P0】分销生效范围

【P0】资金归属规则

发布者 报名费资金去向
俱乐部管理员发布组局/比赛 计入俱乐部管理员自己的平台余额
子管理员发布组局/比赛 计入俱乐部管理员平台余额；若分销开启，抽佣部分计入子管理员余额，其余部分仍计入俱乐部管理员余额
俱乐部会员自行发布组局/比赛 一律计入该会员自己的平台余额，分销无效

【P0】分销关闭的影响

模块C：俱乐部比赛与组局

注：比赛和组局均不绑定具体场地，场地信息由发布者在活动描述中自行填写

C1. 比赛列表整合方案

用户故事：

需求规格：

【P0】比赛列表重构

方案选择：采用「混合排列 + 筛选项」方案（而非「俱乐部置顶」方案），原因：

  • 置顶方案对个人发布者不公平，会降低个人用户发比赛积极性
  • 混合排列 + 筛选兼顾了公平性和可发现性
  • 后续可根据数据调整排序权重（如俱乐部比赛获得少量加权但不置顶）

【P1】俱乐部比赛标识

C2. 俱乐部内部比赛

用户故事：

需求规格：

【P0】内部比赛发布

【P0】俱乐部内部比赛列表

【P0】会员专属折扣

C3. 踢人与代报名（争议功能）

详细分析见第 5 节「争议问题」

场景 功能 建议
免费内部比赛 踢人 ✅ 支持
免费内部比赛 代报名 ✅ 支持（管理员选择会员直接报名，无需缴费）
收费内部比赛 踢人 ⚠️ 支持但限制（需发起踢人请求 → 被踢者确认 → 自动退款）
收费内部比赛 代报名 ⚠️ 改为「邀请报名」模式（管理员发起邀请 → 会员确认并付款）
允许非会员参与的比赛 踢人 ❌ 不支持（外部用户无归属关系，踢人不合理）
允许非会员参与的比赛 代报名 ❌ 不支持

C4. 比赛管理规则

【P0】发布后不可编辑

模块D：退款与售后体系

D1. 现状分析

现有系统的退款逻辑分散在多个场景中：

场景 现有退款机制 触发方
组局活动 不可自行退款，必须走售后申请（用户填写资料 → 平台操作退款） 用户申请 → 平台审核
比赛（对局生成前） 可自行取消报名，系统自动退款 用户自助
比赛（对局生成后） 走售后申请（用户填写资料 → 平台操作退款） 用户申请 → 平台审核

现有问题：

D2. 新流程设计

核心变化：审核权从「平台运营方」下放到「俱乐部管理员/子管理员」，平台退居仲裁角色。

新流程：
用户提交退款资料 → 俱乐部管理员/子管理员审核
  ├── 同意 → 系统自动退款（原路返回）
  └── 拒绝 → 显示拒绝原因 +「平台介入」按钮
                └── 平台运营方仲裁 → 判同意/判驳回（终局）

权限隔离：

D3. 退款类型与权限矩阵

退款类型 英文标识 可审核角色
比赛报名费退款 match_signup 管理员（全部）+ 子管理员（仅自己发布的活动）
组局报名费退款 group_signup 管理员（全部）+ 子管理员（仅自己发布的活动）
会员费退款（新增） membership_fee 仅管理员（子管理员无权）

D4. 退款状态机

                   退款申请状态流转

   ┌─────────┐   用户提交申请    ┌──────────┐
   │ 无申请   │ ─────────────→  │ 待审核    │
   └─────────┘                └──────────┘
                                   │
                    ┌──────────────┼──────────────┐
                    │              │              │
                管理员同意      管理员拒绝    超时未处理
                    │              │         (超过72h)
                    ▼              ▼              │
              ┌──────────┐  ┌──────────┐         │
              │ 已同意    │  │ 已拒绝    │ ←──────┘
              │ 待退款    │  └──────────┘
              └──────────┘        │
                    │          用户点击
                系统自动        「平台介入」
                执行退款           │
                    │              ▼
                    ▼        ┌──────────┐
              ┌──────────┐  │ 平台仲裁中 │
              │ 已退款    │  └──────────┘
              │ (终态)    │        │
              └──────────┘   ┌────┴────┐
                             │         │
                         平台判同意  平台判驳回
                             │         │
                             ▼         ▼
                       ┌──────────┐ ┌──────────┐
                       │ 已退款    │ │ 平台驳回  │
                       │ (终态)    │ │ (终态)    │
                       └──────────┘ └──────────┘

   ┌──────────┐   用户主动撤销     ┌──────────┐
   │ 待审核    │ ───────────────→  │ 已撤销    │
   └──────────┘  (管理员处理前)    │ (终态)    │
                                  └──────────┘

状态说明：

状态 含义 可流转到
pending_review 待审核 approved, rejected, cancelled, expired
approved 已同意待退款 refunded, refund_failed
refunded 已退款（终态） —
refund_failed 退款失败需人工处理 refunded
rejected 管理员拒绝 escalated（用户点平台介入）
cancelled 用户主动撤销（终态） —
escalated 平台仲裁中 refunded, platform_rejected
platform_rejected 平台驳回（终态） —
expired 超时未处理 → 自动升级 escalated

D5. 关键业务规则

编号 规则
R1 用户提交退款申请后，在管理员处理前可主动撤销
R2 管理员同意后，系统自动调用支付网关退款（原路返回）
R3 管理员拒绝时，必须填写拒绝原因（不可为空）
R4 拒绝后，用户端显示拒绝原因 +「平台介入」按钮
R5 超时自动升级：俱乐部管理员/子管理员审核超过 48小时 → 自动通过退款申请
R6 平台仲裁时效：平台介入后,平台运营需在 48小时内完成仲裁
R7 同一订单不可重复提交退款申请（一笔订单最多一条 active 退款单）
R8 管理员和子管理员的审核操作均需留痕（谁、何时、什么操作、原因）
R9 个人/俱乐部发布的组局和比赛售后流程统一走此新流程
R10 比赛对局生成前的「自行取消报名自动退款」功能保持不变

D6. 会员费退款特殊规则

用户故事：

需求规格：

【P0】会员费退款冷静期设计

时间段 退款规则
加入后 0-7 天 可申请全额退款
加入后 8-14 天 按剩余天数比例退款：退款金额 = 支付金额 × (剩余天数 / 总天数)
加入后 超过 14 天 不可申请退款

【P0】权益清算

【P0】退款后处理

【P0】审核权限

D7. 售后通知与归属转移限制

用户故事：

需求规格：

【P0】售后通知范围

技术说明：小程序订阅提醒为一次性订阅，需被通知者预先授权。建议在俱乐部管理员/子管理员开通权限时，引导其订阅「售后审核提醒」类消息模板。

【P0】归属转移限制

设计说明：售后审核责任人与会员归属强绑定。若在售后未完结时转移归属，会导致「谁该继续处理这笔售后」的责任不清。因此采用「未完结售后 → 禁止转移归属」这一最简单明确的方案。

5. 争议问题分析与方案建议

问题1：踢人与代报名

现状：当前系统不支持「管理员踢人」和「代其他用户报名」功能。

分析：

踢人和代报名在免费场景下没有争议。争议集中在收费场景：

场景 踢人 代报名
免费 + 内部 ✅ 直接踢，无资金牵扯 ✅ 管理员直接选人报名
收费 + 内部 ⚠️ 涉及已付费用处理 ⚠️ 涉及"谁付钱"的问题
允许外部参与 ❌ 管理员对外部用户无管理权 ❌ 代外部用户报名无业务合理性

方案：

踢人（收费场景）：

代报名（收费场景）：

问题2：个人注册 vs 企业注册

分析：

维度 个人注册 企业注册
营业执照 ❌ 无法提供 ✅ 可提供
场馆/场所资质 ❌ 无固定场所，位置难确定 ✅ 有实体场所
信任度 低 高
与现有「个人发比赛」的区分度 模糊 清晰

推荐方案：

6. 开放问题

# 问题 需要谁回答
Q1 年审费用定多少？ 运营/商务
Q2 会员扩容费用阶梯定价？ 运营/商务
Q3 子管理员扩容费用阶梯定价？ 运营/商务
Q4 俱乐部是否需要缴纳保证金（防止纠纷）？ 运营/法务
Q5 子管理员额度购买的价格阶梯？ 运营/商务

文档状态：待评审 |