# 提交反馈 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 | 「处理中，请稍候」 |
| 网络中断 | 请求未返回 | 不保存，保留已填内容 | 「网络异常，请重试」 |

<!-- mock: mocks/01-默认态.html | 反馈表单（默认态，示例） -->

## 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 开放问题

暂无。
