提交反馈 PRD
⚠️ 虚构示例:本文件只演示 prd-builder 的 PRD 写法,不是真实需求。 其中的产品、字段、状态、规则和数字均为编造,不构成任何业务规则,禁止照搬。
示例应用 v1.0 · 01-提交反馈 · 已确认 · 2026-01-15 · 关联:本目录 spec.yaml、mocks/;版本 index.md;涉及功能「意见反馈」
1 目标与范围
现状:用户只能发邮件反馈,运营难以统一跟进。目标:用户在应用内提交,反馈统一进入后台列表。
- 包含:反馈提交表单、提交校验、反馈实体与状态机定义(本页主管,02-反馈处理 引用)
- 不包含:附件上传、匿名提交、用户查看处理进度
- 不改动现有账号体系;页面时间显示遵守 D-00-02。
2 场景与流程
| 角色 | 能做什么 | 不能做什么 | 权限来源 |
|---|---|---|---|
| 用户 | 提交反馈 | 修改已提交反馈 | 已登录账号 |
| 步骤 | 操作者 | 系统行为 |
|---|---|---|
| 1 | 用户 | 打开反馈页,选择类型并填写内容 |
| 2 | 用户 | 点提交,系统按 R-01-001、R-01-002 校验后保存,生成「待处理」反馈 |
| 3 | 运营 | 后续处理见 02-反馈处理 |
3 功能与规则
3.1 反馈表单
用户选择反馈类型、填写内容并提交,提交成功后生成一条反馈。
| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|---|---|---|---|---|---|
| 反馈类型 | category | enum | 是 | 问题 / 建议 | 问题 | — |
| 反馈内容 | content | text | 是 | 10–500 字 | — | 见 R-01-001 |
| 状态 | status | enum | 是 | 待处理 / 处理中 / 已回复 | 待处理 | 见 R-01-003 |
| 提交时间 | created_at | datetime | 是 | — | 系统生成 | 北京时间,精确到秒 |
- R-01-001 反馈内容 10 到 500 字,不足或超出时不发起提交,并在输入框下方提示「请输入 10 到 500 字」。
- R-01-002 同一用户 3 秒内重复点击提交,只生成 1 条反馈,其余点击提示「处理中,请稍候」。
- R-01-003 反馈状态只有「待处理 / 处理中 / 已回复」三种,提交成功时为「待处理」。
本页定义「反馈」状态机:
| 当前状态 | 触发动作 | 操作者 | 目标状态 | 前置条件 |
|---|---|---|---|---|
| (无) | 提交 | 用户 | 待处理 | 通过 R-01-001 校验 |
| 待处理 | 领取 | 运营 | 处理中 | 无 |
| 处理中 | 回复并完成 | 运营 | 已回复 | 回复内容非空 |
逆向操作:运营可将「处理中」退回为「待处理」,领取人清空。领取、回复的页面行为见 02-反馈处理。
| 场景 | 触发 | 系统行为 | 用户看到 |
|---|---|---|---|
| 内容长度不符 | 点提交 | 见 R-01-001 | 见 R-01-001 |
| 3 秒内连点提交 | 多次请求 | 见 R-01-002 | 「处理中,请稍候」 |
| 网络中断 | 请求未返回 | 不保存,保留已填内容 | 「网络异常,请重试」 |
4 验收标准
- G-01-001(验证 R-01-003)前置:用户已登录。操作:选择类型并填写 20 字内容后提交。期望:提示「提交成功」,生成 1 条状态为「待处理」的反馈。
- G-01-002(验证 R-01-001)前置:用户已登录。操作:填写 5 字内容后点提交。期望:不发起请求,输入框下方提示「请输入 10 到 500 字」。
- G-01-003(验证 R-01-002)前置:用户已登录,内容 20 字。操作:3 秒内连续点提交 3 次。期望:只生成 1 条反馈,另 2 次提示「处理中,请稍候」。
5 开放问题
暂无。