# Backend / 中台服务 Surface 模板

> 与 `00-generic.md` 组合使用。这里只定义产品可观察的状态、业务契约、一致性、兼容、失败结果和运营准备，不写接口字段、数据库 schema、中间件或服务拆分。
>
> 所有人类问题只询问当前执行对话的用户。行业规则仅在明确命中后通过对应 overlay 增强。

## Backend 属性确认

| 维度 | 内容 |
| --- | --- |
| 业务能力 | |
| 主要 actor / consumer | 用户 / Admin / 其它服务 / 外部系统 |
| 主要业务对象 | |
| 调用形态 | 同步 / 异步 / 批处理 / 事件驱动（只描述产品时效） |
| 兼容范围 | 旧客户端 / 旧调用方 / 旧数据 / 第三方 |
| 是否涉及资金、隐私或不可逆数据 | |

## 状态语义

| 状态 | 产品含义 | 进入条件 | 可执行动作 | 可离开状态 | 用户 / consumer 可见结果 |
| --- | --- | --- | --- | --- | --- |
| | | | | | |

明确终态、可逆性、取消/撤回、过期、失败、重复事件和未知状态的产品语义，不描述内部状态机实现。

## 业务原子性与一致性边界

| 业务动作 | 必须一起成功的结果 | 可部分成功的结果 | 失败后产品状态 | 重试期望 |
| --- | --- | --- | --- | --- |
| | | | | |

涉及重复请求、并发更新或异步消息时，写产品级幂等期望：重复执行不得产生重复业务结果，且用户/consumer 能识别最终状态。

## Producer / Consumer 契约期望

| Producer | Consumer | 业务事件 / 请求 | 成功结果 | 失败结果 | 时效 | 兼容要求 |
| --- | --- | --- | --- | --- | --- | --- |
| | | | | | | |

PRD 可以定义字段的产品含义和必需信息，但不定义具体字段名、类型、协议或版本实现。

## 错误与降级语义

| 场景 | consumer 收到什么 | 用户看到什么 | 是否可重试 | 降级结果 | 是否需要人工处理 |
| --- | --- | --- | --- | --- | --- |
| 下游不可用 | | | | | |
| 超时 | | | | | |
| 重复请求 | | | | | |
| 状态冲突 | | | | | |
| 部分成功 | | | | | |

## 批处理、对账与补偿

命中批处理或异步一致性时，写明：处理窗口、数据范围、完成判定、重复运行、失败清单、人工介入、补偿后的用户/consumer 可见状态。

## 配置与生效

| 配置能力 | 产品含义 | 默认行为 | 生效范围 | 生效时效 | 未配置 / 非法值结果 |
| --- | --- | --- | --- | --- | --- |
| | | | | | |

只定义产品行为，不规定配置中心、key 或读取实现。

## 历史版本与存量数据

| 对象 | 旧行为 / 数据 | 新行为 | 是否迁移 | 未迁移时结果 | 回退后结果 |
| --- | --- | --- | --- | --- | --- |
| | | | | | |

## 安全、审计与数据边界

列出授权、敏感数据、导出、审计、保留和删除的产品约束。涉及专业或监管规则时，引用项目 source 或行业 overlay，并保留未确认项。

## 可用性与运营准备

| 维度 | 产品要求 / 可观察口径 |
| --- | --- |
| 关键使用窗口 | |
| 可接受延迟 | |
| 降级用户影响 | |
| 告警后的业务动作 | |
| 回退 / backfill 影响 | |
| 支持与人工处置 | |

## Backend 补充验收

- 合法状态迁移、非法迁移、重复事件和并发更新。
- 下游失败、超时、部分成功和重试。
- 旧调用方、旧数据和回退路径。
- 批处理重复运行、失败清单和补偿结果。
- 产品级幂等和可观察最终状态。

## Backend 待闭合问题候选

这里只提示候选缺口，不生成第二套 OQ schema。会改变产品状态、错误结果、compatibility、source-of-truth、默认行为或 consumer 可见契约的问题移入 output contract 的 canonical `Outstanding Questions`；缓存、数据库、消息系统和代码拆分进入 `spec-plan`。
