---
spec_id: YYYY-MM-DD-NNN-<slug>
artifact_kind: prd-requirements
target_surface: backend
status: draft
evidence_grade: mixed
author: <作者>
created: YYYY-MM-DD
---

# <需求名称> 后台/中台服务增量需求文档

> 本模板在「00-通用增量需求模板」骨架上叠加 Backend/服务端 surface lens。行业、团队或合规细节由项目本地 overlay 叠加，不在本 packaged 模板中内置。
>
> **WHAT not HOW**：写状态语义、业务契约、幂等/一致性的产品级约束与生效时效；不写接口入参出参字段设计、数据库 schema、配置中间件实现或消息队列细节。

---

## Summary [core]

（同通用模板：一句话需求）

## 需求属性确认 [core，Backend 专属]

| 维度 | 内容 |
| --- | --- |
| 业务域 | |
| 影响对象 | 用户 / 账户 / 工单 / 订单 / 记录 / 配置 / 报表 / 其它 |
| 是否关键业务链路 | 是 / 否（若是，必须填写一致性与异常章节） |
| 是否影响权限、数据或审计 | 是 / 否（若是，补充待确认方） |
| 是否涉及第三方或外部系统 | 是 / 否（若是，提供规则来源，非接口设计） |
| 是否灰度测试 | 是 / 否（若是，补充灰度策略和回滚用户感知） |
| 是否涉及批处理/对账/补偿 | 是 / 否 |
| 是否涉及历史数据/旧调用方 | 是 / 否 |

## Change Delta [core]

### 与线上功能对比表（涉及现有功能改造必填）

| 模块 | 功能点 | 与线上是否一致 | 改动前效果 | 改动后效果 | 业务/风险影响 | 证据 tag |
| --- | --- | --- | --- | --- | --- | --- |
| | | 一致 / 有变动 / 新增 / 未知 | | | | |

标注规则：未知必须指定确认人；关键业务规则未知不得进入 ready-for-planning。

## Requirements [core]

（同通用模板：EARS + BR 编号。Backend 重点写状态语义、业务契约、幂等性、一致性边界等产品约束。）

建议把以下内容写成 R 或 BR：

- 状态流转是否可逆、终态含义、人工介入后结果。
- 重复请求/重复事件/重试是否允许，用户和上游看到什么。
- 部分成功时哪些结果对用户可见，哪些必须进入人工处理。
- 第三方失败、超时、降级、回滚后的业务处理口径。

## Scope Boundaries [core]

（同通用模板）

## Acceptance Examples [core]

（同通用模板。Backend 验收关注：状态流转正确、幂等生效、错误语义、兼容性、补偿和回滚后用户感知。）

## Evidence And Assumptions [core]

（同通用模板。关键业务、权限、数据、审计相关主张必须显式标注。）

---

## 状态语义 [conditional，Backend 专属]

> 写状态的业务含义与流转规则，不写状态机的技术实现/副作用调用。

| 状态 | 业务含义 | 用户/运营可见文案 | 是否终态 | 是否允许人工处理 |
| --- | --- | --- | --- | --- |

| 当前状态 | 操作/事件 | 操作者 | 前置条件 | 下一状态 | 业务后果（非技术实现） |
| --- | --- | --- | --- | --- | --- |

必须写清：终态能否回退、撤销后是否保留历史、状态冲突时谁获胜、用户是否需要刷新确认。

## 业务原子性与一致性边界 [conditional，Backend 专属]

> 触及订单、余额、库存、权限、审核结论、外部同步等关键结果时必填。只写产品期望，不写事务实现。

| 业务动作 | 必须同时成立的结果 | 可接受的中间态 | 不可接受结果 | 失败后用户/运营看到什么 |
| --- | --- | --- | --- | --- |
| 提交 | | | 重复处理/状态不一致 | |
| 撤销 | | | 已完成仍显示可撤 | |
| 审核通过 | | | 结果未生效 | |

## 业务生命周期 [conditional，Backend 专属]

| 节点 | 触发方 | 前置条件 | 业务校验 | 成功结果 | 失败/拒绝结果 | 用户/上游感知 |
| --- | --- | --- | --- | --- | --- | --- |
| 前置校验 | | | | | | |
| 提交处理 | | | | | | |
| 回调/同步 | | | | | | |
| 撤销/变更 | | | | | | |
| 过期/归档 | | | | | | |

必须写清状态展示口径、用户是否可重试、重复触发是否产生重复业务结果。

## 业务数据与账务口径 [conditional，Backend 专属]

> 触及金额、数量、库存、额度、账单、流水、对账或结算口径时必填。

| 业务点 | 影响 | 单位/精度 | 生效时机 | 对账口径 | 异常处理 |
| --- | --- | --- | --- | --- | --- |
| | | | 实时 / T+1 / 人工确认 | | |

不得在 PRD 中写死外部规则；写产品口径与待确认来源。

## 决策点与准入规则 [conditional，Backend 专属]

| 决策点 | 触发条件 | 输入业务事实 | 通过结果 | 不通过结果 | 是否人工复核 | 留痕 |
| --- | --- | --- | --- | --- | --- | --- |
| 权限准入 | | | | 拦截/提示/确认 | | |
| 风险控制 | | | | 限制/转人工 | | |
| 数据完整性 | | | | 拒绝/补充材料 | | |

PRD 写决策结果与用户/运营感知，不写算法或模型实现。

## 业务域依赖 [conditional，Backend 专属]

> 写"依赖谁、要对方做什么动作、何时生效、影响范围"，不写具体接口设计。

| 依赖方 | 改动点（产品视角） | 动作 | 生效时效 | 影响范围 | 对接人 |
| --- | --- | --- | --- | --- | --- |
| 上游系统 | | 新增能力/现有需调整/复用/无 | 实时/重启/T+1/缓存N分钟/手动触发 | | |
| 下游系统 | | | | | |
| 第三方 | | | | | |
| 运营/人工流程 | | | | | |

## 契约期望（非接口设计）[conditional，Backend 专属]

> 写对契约的产品级要求：幂等性、错误语义、兼容性、超时行为预期。具体字段、路径、错误码值留给 `spec-plan` 与接口文档。

| 契约点 | 产品约束 |
| --- | --- |
| 幂等 | 该操作是否必须幂等、重复触发的预期结果 |
| 错误语义 | 失败时用户/上游应得到什么（不是错误码值） |
| 兼容 | 老版本/老调用方的兼容预期 |
| 性能感知 | 用户/上游可接受的响应时效 |
| 超时/重试 | 超时后是否允许重试、重试前用户看到什么 |
| 降级 | 第三方不可用时隐藏入口/排队/人工处理/直接失败 |

## 批处理、对账与补偿 [conditional，Backend 专属]

| 任务/流程 | 触发时机 | 业务产物 | 成功标准 | 失败处理 | 用户/运营感知 |
| --- | --- | --- | --- | --- | --- |
| 定时任务 | | | | | |
| 对账任务 | | | | | |
| 同步任务 | | | | | |
| 异常补偿 | | | | | |

## 历史版本与存量数据 [conditional，Backend 专属]

| 影响对象 | 是否影响 | 当前表现 | 新版本变化 | 兼容/迁移策略 |
| --- | --- | --- | --- | --- |
| 旧接口/旧调用方 | 是/否 | | | |
| 旧数据 | 是/否 | | | 保留/迁移/清洗/重算/废弃 |
| 旧配置 | 是/否 | | | |
| 历史记录 | 是/否 | | | |

## 配置项清单 [conditional，Backend 专属]

> 写"有哪些配置、未配置时的行为、生效时效、配置时机"，不写配置中间件实现细节。

| 配置项 | 含义 | 未配置时行为 | 生效时效 | 配置时机 | 影响范围 |
| --- | --- | --- | --- | --- | --- |

未配置行为枚举：取默认值 / 走老逻辑兜底 / 功能不可用 / 入口隐藏 / 直接报错（少用，需说明为什么不能兜底）。生效时效：实时 / 重启 / T+1 / 缓存 N 分钟 / 手动触发。

## 安全、审计与留存 [conditional，Backend 专属]

| 记录/动作 | 是否留痕 | 产品级内容 | 查询角色 | 保存口径 | 待确认 |
| --- | --- | --- | --- | --- | --- |
| 提交 | 是/否 | 操作者、时间、对象、确认动作 | | | |
| 审核 | 是/否 | 经办、复核、原因 | | | |
| 配置变更 | 是/否 | 变更前后、审批人 | | | |

## 上线 Checklist [conditional，Backend 专属]

- 上线前必须配置（阻塞项）：
- 运营/风控/数据确认：
- 灰度策略：
- 回滚方案与用户感知：
- 历史数据处理：
- 对账/批处理观察窗口：
- 客服/运营 SOP：

## Exception Handling / Outstanding Questions [conditional]

（同通用模板。Backend 重点：状态冲突、并发、部分成功、幂等冲突、第三方超时、对账差异、降级兜底、人工补偿。）

## 变更记录 / Handoff

（同通用模板）
