# 产品名称：社区读书会报名页
版本日期：2026年10月16日
---

## 一、项目背景
- 业务背景：当前社区读书会组织者通过群聊接龙统计报名，名额变动和取消情况容易混乱，需要手机端页面管理单场读书会活动
- 用户痛点：
  1. 组织者：群接龙统计易出错，满额后仍可报名，取消报名后名额无法自动释放，手动统计名单效率低
  2. 居民：无法实时知晓剩余名额，重复报名/取消操作流程混乱，需要提供隐私信息才能报名存在顾虑
- 战略意义：提升社区读书会组织者的报名管理效率，优化居民报名体验，助力社区线下活动运营，量化目标[待定]

---

## 二、项目目标
- 核心目标：
  1. 实现单场社区读书会的线上报名自动管理，解决群接龙统计混乱的问题
  2. 支持居民无需隐私信息即可完成报名/取消报名，清晰获取活动信息和剩余名额
- 成功指标：
  技术指标：页面加载P95响应时间≤2s，接口请求错误率≤0.1%，报名规则校验正确率≥[待产品方补充实测数据]
  业务指标：[待产品方确认]
- 里程碑时间节点：
  1. 需求评审完成：2026-10-23
  2. 开发提测：2026-11-06
  3. 灰度上线：2026-11-13
  4. 正式发布：2026-11-20
- 明确不做什么：
  不收集用户手机号等隐私信息，不做付款功能，不做消息通知功能，不支持多场活动同时管理，不做用户社交功能，不做PC端管理后台，不做活动分享功能（仅保留分享入口，不做内置分享能力），不做历史活动留存

---

## 三、需求详述
### 用户故事1：作为想参加读书会的居民，我希望可以查看活动信息和剩余名额，以便我决定是否报名
- 功能描述：输入：用户打开报名页；AI处理：AI拉取单场活动的基础信息、计算实时剩余名额，整理输出；输出：展示活动名称、时间、地点、剩余名额、报名/取消入口
- 交互步骤：
  1. 居民通过分享链接打开社区读书会报名页
  2. 页面自动加载当前单场活动信息，依次展示活动名称、时间、地点、剩余可报名名额、报名区块、取消报名区块
  3. 居民滑动页面可查看补充活动说明
- 边界条件：网络超时→展示加载失败提示+刷新按钮；活动已结束/满额→隐藏报名入口，展示对应提示；无活动说明→不展示活动说明区块

### 用户故事2：作为想参加读书会的居民，我希望用昵称和自定义口令报名，以便我不提供隐私信息就能完成报名
- 功能描述：输入：用户输入昵称、自定义报名口令；AI处理：AI依次校验输入合法性、昵称是否重复报名、剩余名额是否充足，校验通过后扣减剩余名额、生成报名记录；输出：报名成功提示/带明确原因的报名失败提示
- 交互步骤：
  1. 居民在报名区块输入昵称（必填）、报名口令（必填，自定义）
  2. 居民点击「确认报名」按钮
  3. AI实时校验：先校验是否存在空输入，再校验该昵称是否已报名，最后校验剩余名额是否大于0
  4. 校验不通过→展示对应错误提示；校验通过→生成报名记录、扣减剩余名额、展示报名成功提示、更新页面剩余名额展示
- 边界条件：空输入→提示“请填写昵称和报名口令”；昵称重复报名→提示“该昵称已经报名本次读书会，请更换昵称或取消原报名后重新报名”；满额后报名→提示“本次读书会名额已满，感谢您的关注”；昵称超过20字符→限制输入，无法继续输入；网络超时→提示“网络异常，请稍后重试”

### 用户故事3：作为已报名的居民，我希望用昵称和报名口令取消报名，以便我释放名额给其他用户
- 功能描述：输入：用户输入报名时的昵称和口令；AI处理：AI校验昵称和口令是否匹配已有报名记录，校验通过后删除报名记录、释放名额、更新剩余名额；输出：取消成功提示/带明确原因的取消失败提示
- 交互步骤：
  1. 居民在取消报名区块输入报名时的昵称、报名口令
  2. 居民点击「确认取消」按钮
  3. AI校验：先校验是否空输入，再校验昵称和口令是否匹配有效报名记录
  4. 校验不通过→展示对应错误提示；校验通过→删除报名记录、释放名额、更新页面剩余名额展示、展示取消成功提示
- 边界条件：昵称口令不匹配→提示“昵称或报名口令错误，请重新输入”；活动已结束→提示“本次活动已结束，无法取消报名”；空输入→提示“请填写昵称和报名口令”；网络超时→提示“网络异常，请稍后重试”

### 用户故事4：作为读书会组织者，我希望查看报名名单和实时剩余名额，以便我掌握报名情况
- 功能描述：输入：组织者进入组织者管理入口；AI处理：AI整理所有有效报名记录，计算实时剩余名额；输出：展示总名额、剩余名额、报名用户昵称列表
- 交互步骤：
  1. 组织者通过报名页底部的组织者入口进入管理页面
  2. AI拉取所有有效报名记录，统计报名人数，计算剩余名额
  3. 页面展示总名额（固定20）、剩余名额、所有报名成功用户的昵称列表
  4. 组织者可点击刷新按钮获取最新数据
- 边界条件：无报名记录→展示“暂无报名用户”，剩余名额显示为20；活动已结束→正常展示报名名单，不做隐藏；网络超时→展示加载失败提示+刷新按钮

---

## 四、AI理想态
| 维度 | 要求 | 示例/衡量标准 |
|------|------|---------------|
| 准确性 | 准确完成报名规则校验，名额计算正确，昵称口令匹配无误 | 人工抽检校验正确率≥[待产品方补充实测数据]，剩余名额计算错误率≤0.1% |
| 完整性 | 覆盖所有要求的业务场景校验 | 必须覆盖：空输入校验、重复报名校验、满额校验、昵称口令匹配校验、名额扣减/释放校验、活动结束状态校验，无遗漏场景 |
| 一致性 | 相同输入的处理结果必须一致，数据状态稳定 | 相同输入多次操作结果100%一致，不存在同一输入不同结果的情况，并发操作下数据一致性100% |
| 风格与语气 | 提示信息简洁礼貌，符合社区活动场景，易懂无歧义 | 所有提示信息不超过30字，无专业术语，普通居民可一眼看懂 |
| 降级处理 | AI服务异常时的回退方案 | AI服务超时/出错时，展示“当前系统维护，请稍后重试”提示，临时关闭报名/取消入口，禁止脏数据写入，提供刷新按钮重试 |
| Prompt设计要点 | 核心指令和规则约束 | 1. 校验顺序：先校验输入合法性（空值、长度），再校验业务规则；2. 校验失败必须返回明确的失败原因，不模糊提示；3. 名额扣减/释放必须实时更新，保证全局数据一致；4. 严格禁止收集/存储手机号等用户隐私信息；5. 单场活动总名额固定为20，不得变更 |

---

## 五、验收标准（AC）
### 正常流程AC
1. Given 活动剩余名额为5 When 新用户输入合法不重复的昵称和口令点击报名 Then 报名成功，剩余名额变为4，组织者管理页的报名列表新增该用户昵称
2. Given 用户已报名成功 When 用户输入匹配的昵称和口令点击取消报名 Then 取消成功，剩余名额增加1，组织者管理页的报名列表移除该用户昵称
3. Given 已有8位用户报名成功 When 组织者进入管理页 Then 页面展示总名额20，剩余名额12，报名列表显示8个用户昵称

### 异常流程AC
1. Given 活动已经满额（剩余名额0） When 用户尝试输入合法信息报名 Then 提示“本次读书会名额已满，感谢您的关注”，报名不生效，名额不变
2. Given 用户未报名本次活动 When 用户输入昵称和口令尝试取消报名 Then 提示“昵称或报名口令错误，请重新输入”，取消不生效，名额不变
3. Given 用户端网络超时 When 用户点击确认报名 Then 提示“网络异常，请稍后重试”，报名不生效，数据无变化

### 边界值AC
1. Given 当前剩余名额为1 When 用户输入合法信息报名 Then 报名成功，剩余名额变为0，报名入口自动隐藏
2. Given 用户输入的昵称长度刚好为20个字符 When 点击确认报名 Then 可以正常提交通过校验，报名成功

---

## 六、测试集设计
| 类型 | 用例描述 | 输入示例 | 预期输出要点 |
|------|----------|----------|-------------|
| 典型用例 | 新用户正常报名 | 昵称：李明，口令：lm1234，剩余名额：10 | 报名成功，剩余名额变为9，报名列表新增“李明” |
| 典型用例 | 已报名用户正常取消 | 昵称：李明，口令：lm1234，已报名 | 取消成功，剩余名额变回10，报名列表移除“李明” |
| 典型用例 | 组织者查看报名名单 | 已有6名用户报名，组织者进入管理页 | 展示总名额20，剩余14，列表显示6个用户昵称 |
| 边界用例 | 最后一个名额报名 | 剩余名额1，输入合法昵称口令 | 报名成功，剩余名额0，报名入口关闭 |
| 边界用例 | 昵称长度等于最大限制 | 昵称长度刚好20字符，口令合法 | 报名成功，昵称正常展示在列表中 |
| 边界用例 | 满额活动取消最后一个名额 | 活动满额，最后一名报名用户取消 | 取消成功，剩余名额变为1，重新打开报名入口 |
| 异常用例 | 同一昵称重复报名 | 昵称“李明”已报名，再次输入“李明”+任意口令报名 | 提示“该昵称已经报名本次读书会，请更换昵称或取消原报名后重新报名”，报名不生效 |
| 异常用例 | 取消报名口令不匹配 | 用户报名口令是lm1234，取消时输入lm1235，昵称正确 | 提示“昵称或报名口令错误，请重新输入”，取消不生效 |
| 异常用例 | 空昵称提交报名 | 昵称为空，输入口令，点击报名 | 提示“请填写昵称和报名口令”，报名不提交 |

---

## 七、风险与约束
| 类型 | 风险描述 | 概率 | 影响 | 应对措施 |
|------|----------|------|------|----------|
| 技术风险 | 高峰报名时AI校验服务响应超时，导致用户操作失败 | 中 | 用户报名体验差，可能流失潜在参与者 | 提前配置弹性扩容机制，AI服务异常时触发降级处理，提示用户稍后重试 |
| 数据风险 | 多用户并发抢最后一个名额时，可能出现数据不一致，导致名额统计错误 | 低 | 名额统计出错，引发用户纠纷 | AI增加并发原子操作锁，保证名额修改的一致性，避免超卖 |
| 业务风险 | 恶意用户批量注册占坑，导致真实用户无法报名 | 中 | 影响真实用户参与，降低活动质量 | [待产品方确认应对方案]，当前版本仅做自动规则校验，不限制报名次数，后续可根据运营需求调整 |
| 合规约束 | 用户昵称可能包含敏感信息、违规内容，违反内容合规要求 | 低 | 平台面临合规风险，影响社区氛围 | 增加AI敏感词校验模块，拦截含敏感/违规内容的昵称，不允许此类昵称报名 |