name	pm-alpha-prd-writer
description	PRD文档撰写规范。包含背景与目标、功能规格（含DICOM Tag映射表模板）、接口规范、验收标准（Gherkin格式）。适用于产品经理编写标准化产品需求文档，确保开发、测试团队对需求理解一致。当需要撰写或审核PRD文档时使用此skill。

PRD文档撰写规范

标准化产品需求文档模板，确保需求传递清晰、无歧义、可执行、可测试。

文档结构概览

PRD文档
├── 1. 背景与目标
├── 2. 功能规格
│   ├── 2.1 功能概述
│   ├── 2.2 用户故事
│   ├── 2.3 功能流程图
│   ├── 2.4 业务规则
│   └── 2.5 DICOM Tag映射表
├── 3. 接口规范
│   ├── 3.1 内部API
│   └── 3.2 外部集成
├── 4. 验收标准
│   └── Gherkin格式场景
├── 5. 非功能需求
└── 6. 附录

1. 背景与目标

1.1 文档信息

字段	内容
文档编号	PRD-YYYYMMDD-XXX
版本号	v1.0
作者	[产品经理姓名]
创建日期	YYYY-MM-DD
最后更新	YYYY-MM-DD

1.2 背景描述

编写规范：说明业务背景、市场/用户需求来源、现有问题或优化机会

背景：
[描述当前的业务痛点或市场机会]
- 用户/客户遇到的问题：...
- 现有解决方案的不足：...
- 期望达成的目标：...

1.3 目标定义

业务目标（BO）

目标	衡量指标	目标值	当前值

用户目标（UO）

目标	衡量指标	目标值	当前值

1.4 成功标准

主要 KPI：[列出关键指标]
验收里程碑：[列出关键节点]

2. 功能规格

2.1 功能概述

功能清单

功能编号	功能名称	优先级	模块归属
F-001		P0/P1/P2
F-002		P0/P1/P2

功能依赖关系

┌─────────────────┐
│   依赖功能      │
│  (前置条件)     │
└────────┬────────┘
         ↓
┌─────────────────┐
│   当前功能       │
│  (本PRD范围)    │
└────────┬────────┘
         ↓
┌─────────────────┐
│   被依赖功能     │
│  (后续支持)     │
└─────────────────┘

2.2 用户故事

故事模板

用户故事编号：US-XXX
标题：[简洁描述]

作为    [角色]
我希望  [功能/行为]
以便    [获得的收益/价值]

验收标准：
- Given [前置条件]
- When  [触发动作]
- Then  [预期结果]

优先级：P0/P1/P2/P3
工作量：X 人/天

示例用户故事

用户故事编号：US-001
标题：放射科医生调阅患者历史检查影像

作为    放射科医生
我希望  在写报告时快速调阅患者的历史检查影像
以便    对比病情变化，支持诊断决策

验收标准：
- Given 我正在为患者A编写CT报告
- When  我点击"调阅历史"按钮
- Then  系统展示患者A过去30天内所有DICOM影像序列
- And   支持双击打开任意序列进行对比

优先级：P0
工作量：3 人/天

2.3 功能流程图

流程图符号规范

开始/结束    →  圆角矩形 (Terminator)
处理步骤    →  矩形 (Process)
判断分支    →  菱形 (Decision)
数据存储    →  波浪线矩形 (Data)
连接线      →  箭头 (Flow)

泳道图（跨角色流程）

┌──────────────┬──────────────┬──────────────┐
│    医生      │    系统      │   PACS      │
├──────────────┼──────────────┼──────────────┤
│              │              │              │
│  1. 选择患者  │              │              │
│       ↓      │              │              │
│              │  2. 查询患者  │              │
│              │       ↓      │              │
│              │              │  3. 返回影像列表│
│              │       ↓      │              │
│  4. 查看影像  │              │              │
│              │              │              │
└──────────────┴──────────────┴──────────────┘

2.4 业务规则

规则清单

规则编号	规则描述	优先级	备注
BR-001

规则描述模板

**规则编号**：BR-XXX
**规则名称**：[简洁名称]
**规则描述**：
[详细描述业务规则逻辑]

**触发条件**：[在什么情况下此规则生效]
**业务影响**：
- 如果违反此规则：[后果]
- 如果遵守此规则：[收益]

**例外情况**：[是否有特殊豁免场景]

2.5 DICOM Tag映射表模板

适用于PACS/RIS系统功能开发

Tag映射表格式

## DICOM Tag 映射表

### 2.5.1 [功能名称] - Tag 读取映射

| Tag | Name | VR | 描述 | 读/写 | 必填 | 默认值 | 备注 |
|-----|------|----|----|----|----|----|-----|
| (0010,0010) | PatientName | PN | 患者姓名 | R/W | Y | - | 脱敏处理 |
| (0010,0020) | PatientID | LO | 患者ID | R/W | Y | - | 唯一标识 |
| (0010,0030) | PatientBirthDate | DA | 出生日期 | R | N | - | YYMMDD格式 |
| (0008,0020) | StudyDate | DA | 检查日期 | R | Y | - | 研究级日期 |
| (0008,0060) | Modality | CS | 设备类型 | R | Y | - | CT/MR/DX... |
| (0020,0010) | StudyInstanceUID | UI | 研究UID | R/W | Y | - | 唯一标识 |
| (0008,1030) | StudyDescription | LO | 检查描述 | R | N | - | - |

常用Tag参考表

Tag	Name	VR	说明
患者信息	PatientName	PN	患者姓名
	PatientID	LO	患者ID
	PatientBirthDate	DA	出生日期
	PatientSex	CS	性别
检查信息	StudyDate	DA	检查日期
	StudyTime	TM	检查时间
	Modality	CS	设备类型
	StudyDescription	LO	检查描述
	AccessionNumber	SH	检查号
序列信息	SeriesInstanceUID	UI	序列UID
	SeriesNumber	IS	序列号
图像信息	SOPInstanceUID	UI	图像UID
	InstanceNumber	IS	图像序号

SOP Class支持矩阵

SOP Class	支持操作	C-ECHO	C-FIND	C-GET	C-MOVE
CT Image Storage	是	✅	✅	✅	✅
MR Image Storage	是	✅	✅	✅	✅
Print Management	否	✅	❌	❌	❌

3. 接口规范

3.1 内部API规范

API模板

### API-XXX: [接口名称]

**接口描述**：[简要说明接口用途]

**请求信息**
- URL：/api/v1/{resource}
- Method：GET/POST/PUT/DELETE
- Content-Type：application/json

**请求头**
| 参数 | 类型 | 必填 | 说明 |
|-----|------|-----|------|
|       |      |     |      |

**请求参数**
| 参数 | 类型 | 必填 | 说明 |
|-----|------|-----|------|
|       |      |     |      |

**请求示例**
```json
{
  "key": "value"
}

响应格式

{
  "code": 200,
  "message": "success",
  "data": {}
}

响应码定义

响应码	说明
200	成功
400	请求参数错误
401	未授权
404	资源不存在
500	服务器错误

错误码定义

错误码	说明	处理建议
E001	参数缺失	检查必填参数
E002	权限不足	申请权限


### 3.2 外部系统集成

#### 集成矩阵
| 外部系统 | 集成方式 | 数据流向 | 关键Tag/字段 | 备注 |
|---------|---------|---------|-------------|------|
|         |         |         |             |      |

---

## 4. 验收标准（Gherkin格式）

### 4.1 Gherkin语法规范

#### 关键字定义
- **Feature**：功能特性
- **Scenario**：场景
- **Given**：前置条件
- **When**：触发动作
- **Then**：预期结果
- **And**：并列条件
- **But**：转折条件
- **Background**：共享前置条件
- **Scenario Outline**：参数化场景
- **Examples**：示例数据

### 4.2 验收标准模板

```gherkin
# 验收标准文档 - [功能名称]

## Feature: [功能名称]

### Background:
Given [共享的前置条件]
And [其他前置条件]

---

### Scenario: [场景001] - [场景名称]

**用户角色**：[医生/护士/管理员/...]

**前置条件**：
- Given [条件1]
- And [条件2]

**操作步骤**：
- When [动作1]
- And [动作2]

**预期结果**：
- Then [结果1]
- And [结果2]

**验收要点**：
- [ ] [具体检查项1]
- [ ] [具体检查项2]

---

### Scenario: [场景002] - [异常场景名称]

**前置条件**：
- Given [异常条件]

**操作步骤**：
- When [触发动作]

**预期结果**：
- Then [错误提示/处理方式]

**错误码**：[具体错误码]

4.3 完整示例

# 验收标准 - 患者影像调阅功能

## Feature: PACS影像调阅

### Background:
Given 系统已登录用户 "Dr. Zhang" (角色: 放射科医生)
And 患者 "Zhang San" 存在（PatientID: P12345）
And 该患者有3个历史检查（CT/2024-01-15, MR/2024-02-20, CT/2024-03-10）

---

### Scenario: UC-001 - 正常调阅患者历史检查

**用户角色**：放射科医生

**前置条件**：
- Given 当前在为患者 "Zhang San" 编写CT报告
- And 检查日期为 2024-03-10

**操作步骤**：
- When 点击 "调阅历史" 按钮
- And 选择时间范围 "过去90天"

**预期结果**：
- Then 系统展示3条历史检查记录
- And 每条记录显示：检查日期、设备类型、检查描述、序列数量
- And 默认选中最近一次同类检查（CT/2024-03-10）

**验收要点**：
- [ ] 历史检查列表按时间倒序排列
- [ ] 支持按设备类型筛选
- [ ] 支持按检查日期范围筛选
- [ ] 双击记录可打开影像查看器

---

### Scenario: UC-002 - 跨设备对比调阅

**前置条件**：
- Given 当前在为患者 "Zhang San" 编写CT报告

**操作步骤**：
- When 选择 CT/2024-03-10 和 MR/2024-02-20 进行对比
- And 点击 "开启对比模式"

**预期结果**：
- Then 影像查看器左右分屏显示两个检查
- And 支持同步滚动/缩放

---

### Scenario: UC-003 - 无权限访问患者数据

**前置条件**：
- Given 当前用户无 "急诊ICU" 病区数据访问权限

**操作步骤**：
- When 尝试调阅该病区患者影像

**预期结果**：
- Then 系统提示 "无权访问该患者数据"
- And 不返回任何影像信息
- And 记录审计日志（用户、时间、访问的患者ID、操作类型）

---

### Scenario Outline: UC-004 - 多患者批量调阅

**前置条件**：
- Given 系统存在 <患者列表> 个患者
- And 每个患者有 <检查数量> 个历史检查

**操作步骤**：
- When 批量选择这些患者
- And 点击 "调阅历史"

**预期结果**：
- Then 系统在 <响应时间> 内返回所有历史检查
- And 展示总数量为 <总检查数>

**Examples**:
| 患者列表 | 检查数量 | 响应时间 | 总检查数 |
|---------|---------|---------|---------|
| 10      | 5       | <3s     | 50      |
| 50      | 10      | <10s    | 500     |

5. 非功能需求

5.1 性能指标

指标	要求	测试方法
响应时间	P95 < Xs	压力测试
并发数	支持 N 用户同时在线	负载测试
吞吐量	QPS >= X	性能测试

5.2 安全需求

数据加密：传输过程使用 TLS 1.2+
访问控制：基于角色的权限控制（RBAC）
审计日志：记录所有敏感操作
敏感数据脱敏：患者姓名、ID等展示时脱敏

5.3 兼容性需求

浏览器兼容：Chrome/Firefox/Edge/Safari 最新版本
操作系统兼容：Windows 10+, macOS 11+
设备兼容：桌面端/移动端响应式适配

5.4 可靠性需求

系统可用性：99.9%
数据备份：每日增量备份，每周全量备份
故障恢复：RTO < 4小时，RPO < 1小时

6. 附录

6.1 术语表

术语	定义
DICOM	医学数字影像和通信标准
PACS	影像归档和通信系统
RIS	放射信息系统
HIS	医院信息系统

6.2 参考文档

文档	位置/链接
技术方案设计	[链接]
数据库设计	[链接]
测试用例	[链接]

6.3 变更记录

版本	日期	作者	变更内容
v1.0	YYYY-MM-DD		初稿创建