Python/产品需求文档AI生成/skills/requirements-analysis/references/complete-example.md

# 完整需求分析示例

## 初始请求
```
用户："我们需要一个管理者仪表板"
```

## 分析对话

### 第 1 轮：基本理解
```
AI："我会帮你分析这个需求。让我先问几个问题：

1. 管理者面临什么具体问题，这个仪表板将解决？
2. 谁在请求这个仪表板？
3. 这是用于现有系统还是新系统？"

用户："管理者无法轻松查看团队绩效指标。运营副总裁在请求它。这是用于我们现有的项目管理系统。"
```

### 第 2 轮：利益相关者识别
```
AI："很好，让我了解利益相关者：

1. 谁是将使用这个仪表板的管理者？
2. 除了运营副总裁，还有谁需要参与？
3. 是否有合规或安全要求？"

用户："所有部门经理（约 50 人）。我们需要让 IT 总监和数据隐私官参与，因为我们要显示员工数据。"
```

### 第 3 轮：详细需求
```
AI："现在让我们深入细节：

1. 管理者需要看到哪些具体指标？
2. 数据应该多久更新一次？
3. 管理者需要过滤或自定义视图吗？
4. 是否有性能要求？"

用户："他们需要看到：项目完成率、团队利用率、预算 vs 实际、即将到来的截止日期。数据应该每天更新。是的，他们应该能按团队、项目和日期范围过滤。仪表板应该在 3 秒内加载。"
```

### 第 4 轮：时间线和依赖关系
```
AI："让我们讨论时间：

1. 你什么时候需要这个仪表板？
2. 是否依赖其他项目？
3. 是否有特定事件或截止日期驱动这个需求？"

用户："我们需要在第二季度末（6 月 30 日）之前完成。它依赖于数据仓库项目首先完成。CEO 想在 7 月审查第二季度绩效，所以我们需要准备好。"
```

### 第 5 轮：验收标准
```
AI："最后，让我们定义成功：

1. 我们如何知道这个仪表板满足你的需求？
2. 哪些是必须有的功能，哪些是最好有的？
3. 你将如何测试？"

用户："成功意味着管理者可以做出数据驱动的决策，而无需向 IT 请求报告。必须有：我提到的 4 个指标、过滤和导出到 Excel。最好有：深入到单个项目、趋势图表。我们将首先与 5 位试点经理测试。"
```

---

## 最终需求文档

# 需求：管理者绩效仪表板

## 概述
- **ID**：REQ-2026-001
- **状态**：已批准
- **优先级**：高
- **创建日期**：2026-02-10
- **最后更新**：2026-02-10

## 利益相关者
- **业务负责人**：运营副总裁，Jane Smith
- **最终用户**：部门经理（50 位用户）
- **技术负责人**：IT 总监，John Doe
- **其他利益相关者**：数据隐私官（合规审查）

## 业务背景

### 问题陈述
部门经理目前缺乏对团队绩效指标的可见性，必须向 IT 请求自定义报告，导致决策延迟和 IT 资源使用效率低下。

### 业务价值
- 将 IT 报告请求量减少 80%
- 实现实时数据驱动决策
- 提高经理生产力 20%
- 支持 CEO 的第二季度绩效审查流程

### 成功指标
- 1 个月内 90% 经理采用率
- IT 报告请求减少 80%
- < 3 秒仪表板加载时间
- 85% 用户满意度评分

## 需求详情

### 功能性需求

#### 核心指标显示
1. **项目完成率**
   - 显示按时完成的项目百分比
   - 按团队和整体显示
   - 颜色编码：绿色（>90%）、黄色（70-90%）、红色（<70%）

2. **团队利用率**
   - 显示团队容量利用百分比
   - 按团队成员和团队平均值显示
   - 包括可计费 vs 不可计费分解

3. **预算 vs 实际**
   - 按项目显示预算差异
   - 显示为百分比和绝对值
   - 如果差异 > 10% 则警报

4. **即将到来的截止日期**
   - 列出未来 30 天内有截止日期的项目
   - 按紧急程度排序
   - 以红色突出显示逾期项目

#### 过滤和自定义
- 按团队过滤（多选）
- 按项目过滤（多选）
- 按日期范围过滤（最近 7/30/90 天，自定义范围）
- 保存每个用户的过滤偏好
- 重置为默认视图

#### 数据导出
- 导出到 Excel（.xlsx 格式）
- 包含基于当前过滤器的所有可见数据
- 保持格式和颜色编码

#### 最好有的功能
- 深入到单个项目详情
- 趋势图表（显示随时间变化的指标的折线图）
- 电子邮件定时报告

### 非功能性需求

- **性能**：
  - 仪表板加载时间 < 3 秒
  - 过滤器应用 < 1 秒
  - 支持 50 个并发用户

- **安全**：
  - 基于角色的访问控制（经理只能看到他们的团队）
  - 数据访问审计日志
  - 仅 HTTPS

- **数据新鲜度**：
  - 数据每天早上 6 点更新
  - 显示最后更新时间戳

- **可用性**：
  - 移动响应式设计
  - 无障碍（符合 WCAG 2.1 AA）
  - 无需培训的直观界面

- **可用性**：
  - 工作时间（早上 6 点 - 晚上 8 点）99% 正常运行时间
  - 计划维护窗口：周日凌晨 2-4 点

## 验收标准

1. **Given** 我是一名经理，**When** 我登录仪表板，**Then** 我看到截至今天早上 6 点更新的我的团队绩效指标

2. **Given** 我正在查看仪表板，**When** 我应用过滤器（团队、项目、日期范围），**Then** 指标在 1 秒内更新以反映过滤后的数据

3. **Given** 我正在查看过滤后的数据，**When** 我点击"导出到 Excel"，**Then** 下载一个 Excel 文件，包含所有可见数据并保持颜色编码

4. **Given** 我是一名经理，**When** 我尝试查看另一个团队的数据，**Then** 我被拒绝访问并看到适当的错误消息

5. **Given** 仪表板正在加载，**When** 页面加载时，**Then** 所有指标在 3 秒内可见

6. **Given** 我在移动设备上查看仪表板，**When** 我从手机访问它，**Then** 所有功能都可访问和可读

## 时间线

- **预期交付**：2026-06-30
- **里程碑**：
  - 需求批准：2026-02-15
  - 设计审查：2026-03-01
  - 开发完成：2026-05-31
  - 试点测试：2026-06-01 - 2026-06-15
  - 全面推出：2026-06-30

## 依赖关系

- **数据仓库项目**：必须在 2026-04-30 之前完成以提供数据源
- **认证系统**：必须支持基于角色的访问控制
- **Excel 导出库**：需要在 2026-03-15 之前评估和选择库

## 约束条件

- 必须使用现有项目管理数据库作为数据源
- 必须符合数据隐私法规（GDPR、CCPA）
- 必须与当前浏览器版本（Chrome、Firefox、Safari、Edge）兼容
- 预算：$50,000（开发 + 基础设施）

## 风险

| 风险 | 影响 | 概率 | 缓解措施 |
|------|--------|-------------|------------|
| 数据仓库项目延迟 | 高 | 中 | 从直接数据库查询开始，稍后迁移到仓库 |
| 50 个并发用户的性能问题 | 中 | 低 | 在预发布环境进行负载测试，优化查询，添加缓存 |
| 经理抵制采用 | 高 | 低 | 让经理参与设计，提供培训，收集反馈 |
| 数据隐私问题 | 高 | 低 | 与数据隐私官提前审查，实施严格的访问控制 |

## 备注

- 在全面推出之前，与来自不同部门的 5 位经理进行试点
- 计划在 6 月为所有经理举办培训课程
- 考虑根据反馈在第 2 阶段添加更多指标
- 探索在未来版本中与移动应用集成