<!-- 9774f234-db58-4d1d-a960-14f15586ebc9 -->
---
todos:
  - id: "user-input"
    content: "用户下一条消息提供：变更一句话、涉及仓库、原因、数据影响、优先级"
    status: pending
  - id: "draft-prd"
    content: "按 docs/requirements 体例撰写变更 PRD（含变更前后对比表与验收标准）"
    status: pending
  - id: "index-link"
    content: "若属已有需求体系，更新 README/父文档索引并链到新文档"
    status: pending
  - id: "user-review"
    content: "根据用户反馈修订开放问题与验收项"
    status: pending
isProject: false
---
# 协作撰写变更需求 PRD

## 可以做什么

可以帮你写**变更需求（Change Request）PRD**，结构对齐你仓库里已有规范，例如：

- 父文档：[docs/requirements/game_gateway_risk_prd_v_2.md](docs/requirements/game_gateway_risk_prd_v_2.md)
- 子需求：[docs/requirements/game_gateway/01_launch_session.md](docs/requirements/game_gateway/01_launch_session.md)

这些文档已包含：**目标与范围（In/Out scope）**、**依赖与边界**、**业务流程**、**数据表/接口**、**验收标准**——与你选择的「标准 PRD」一致。

---

## 当前阻塞：需要你补充变更说明

你已选择：**其它主题** + **变更需求** + **下一条消息文字说明**。在 Plan 模式下还缺少以下最小信息（建议下一条回复用 5～10 行写完）：

| 必填 | 示例 |
|------|------|
| 变更一句话 | 「渠道创建时编号由运营手填改为系统生成」 |
| 涉及系统/仓库 | `slot-admin`、`slot-admin-vue`、`slot_wallet` 等 |
| 变更原因 | 运营误填、编号冲突、对接要求 |
| 是否影响线上数据 | 仅新数据 / 需迁移历史 |
| 期望上线时间或优先级 | P0 / 本迭代 / 可排期 |

可选但有助于写准：

- 相关页面或接口路径
- 已知约束（不能改表、必须兼容某厂商等）
- 是否需挂到现有父文档（如 Game Gateway 系列）

---

## 变更需求 PRD 文档结构（将按此产出）

在标准 PRD 基础上，**变更类**会额外突出「前后差异」，建议章节如下：

```mermaid
flowchart TB
  input[你提供的变更说明]
  code[可选：对照现有代码/表结构]
  draft[撰写 PRD 初稿]
  review[你确认/修订]
  output[Markdown 落库或对话交付]
  input --> code
  code --> draft
  draft --> review
  review --> output
```

### 1. 文档元信息

- 标题、版本（如 V1.1-change）、日期、作者/评审人
- 关联父文档（若属于 Game Gateway 等已有体系）

### 2. 背景与变更动机

- 现状问题（As-Is）
- 变更目标（To-Be）
- 不做的范围（Out of scope）

### 3. 变更摘要（核心）

| 维度 | 变更前 | 变更后 |
|------|--------|--------|
| 业务规则 | … | … |
| 界面/交互 | … | … |
| 接口/字段 | … | … |
| 数据/缓存 | … | … |

### 4. 功能需求（按角色或模块）

- 管理端 / 用户端 / innerapi / 跨服务（slot_sdk）分项
- 每条需求：**描述 + 规则 + 异常/边界**

### 5. 接口与数据（如涉及）

- API 路径、请求/响应字段变更（新增/废弃/只读）
- 表字段、索引、Redis key、MQ（若有）
- 幂等、事务、兼容性说明

### 6. 非功能需求

- 性能、安全、日志、监控、回滚策略

### 7. 验收标准（可测试）

- Given / When / Then 或检查清单
- 回归范围（哪些旧功能不能坏）

### 8. 实施与发布建议（可选）

- 涉及仓库与大致文件（实施阶段再细化）
- 发布顺序、配置开关、数据迁移步骤

### 9. 风险与开放问题

- 待产品/技术确认项列表

---

## 撰写时我会怎么做（确认计划后执行）

1. **读你提供的变更说明**，必要时只读检索相关代码（Controller / Logic / Model / Vue），保证 PRD 与实现或意图一致。
2. **对齐仓库体例**：表格元信息、In/Out scope、mermaid/文本流程图，与 [01_launch_session.md](docs/requirements/game_gateway/01_launch_session.md) 风格一致。
3. **落盘位置**（默认，你可改）：
   - 独立变更：`docs/requirements/<模块>/<简短英文名>_change.md`
   - 若属 Game Gateway 体系：在 [game_gateway/README.md](docs/requirements/game_gateway/README.md) 索引中增加一行，并链到父文档
4. **交付方式**：默认写入仓库；若你只希望对话里预览，说明「不要写文件」即可。

**不会**在未经你确认前修改业务代码；Plan 阶段仅产出文档。

---

## 与「反推 PRD」的区别

你选的是**变更需求**，不是从零或纯反推。若变更其实已部分落地（例如 [GameServerLogic.php](slot-admin/app/game/logic/GameServerLogic.php) 里渠道编号自动生成），可在 PRD 中标注 **「已实现 / 待实现」**，便于评审与补测。

---

## 你确认计划后的下一步

请在下一条消息直接粘贴变更说明（不必等再点选）。收到后我将：

1. 定文档标题与存放路径
2. 输出完整 PRD 初稿（Markdown）
3. 请你审阅「开放问题」与验收项，再按需修订一版

若变更属于 Game Gateway / 渠道 / 钱包等已有域，请点名，我会自动挂接对应父文档索引。