|
@@ -6,6 +6,7 @@
|
|
|
| 1.0 | 2024-09-14 | 初始PRD版本 | John (PM) |
|
|
| 1.0 | 2024-09-14 | 初始PRD版本 | John (PM) |
|
|
|
| 1.1 | 2025-09-17 | 更新Epic结构和指标,与实际epic对齐 | Sarah (PO) |
|
|
| 1.1 | 2025-09-17 | 更新Epic结构和指标,与实际epic对齐 | Sarah (PO) |
|
|
|
| 1.2 | 2025-09-19 | 在Epic 001中集成数据库备份功能 | Winston |
|
|
| 1.2 | 2025-09-19 | 在Epic 001中集成数据库备份功能 | Winston |
|
|
|
|
|
+| 1.3 | 2025-11-06 | 新增供应链可视化大屏功能需求 | Claude |
|
|
|
|
|
|
|
|
## 1. 项目介绍和分析
|
|
## 1. 项目介绍和分析
|
|
|
|
|
|
|
@@ -19,6 +20,7 @@
|
|
|
- 👥 **用户管理**: 完整的用户和角色管理功能
|
|
- 👥 **用户管理**: 完整的用户和角色管理功能
|
|
|
- 📊 **数据库集成**: TypeORM + PostgreSQL 数据持久化
|
|
- 📊 **数据库集成**: TypeORM + PostgreSQL 数据持久化
|
|
|
- 🎨 **现代化UI**: React 19 + Tailwind CSS 界面
|
|
- 🎨 **现代化UI**: React 19 + Tailwind CSS 界面
|
|
|
|
|
+- 🗺️ **供应链可视化**: 农业供应链大屏展示系统
|
|
|
|
|
|
|
|
### 1.2 可用文档分析
|
|
### 1.2 可用文档分析
|
|
|
|
|
|
|
@@ -43,6 +45,7 @@
|
|
|
1. 将现有技术实现与业务需求对齐
|
|
1. 将现有技术实现与业务需求对齐
|
|
|
2. 定义清晰的产品方向和成功标准
|
|
2. 定义清晰的产品方向和成功标准
|
|
|
3. 为未来功能扩展建立需求基线
|
|
3. 为未来功能扩展建立需求基线
|
|
|
|
|
+4. 集成供应链可视化大屏功能,展示农业产业链数据
|
|
|
|
|
|
|
|
### 1.4 目标和背景
|
|
### 1.4 目标和背景
|
|
|
|
|
|
|
@@ -99,6 +102,14 @@ D8D Starter已经具备优秀的技术基础:
|
|
|
- 集成Docker Compose用于本地开发环境
|
|
- 集成Docker Compose用于本地开发环境
|
|
|
- 提供环境变量配置管理
|
|
- 提供环境变量配置管理
|
|
|
|
|
|
|
|
|
|
+**FR6: 供应链可视化大屏系统**
|
|
|
|
|
+- 提供4个农业产业的可视化大屏:粮食油脂、种业果蔬、畜牧水产、鲜食泛盐
|
|
|
|
|
+- 每个大屏包含地图可视化、供应链网络、关键指标展示
|
|
|
|
|
+- 支持基地和产业链节点的可视化定位
|
|
|
|
|
+- 显示产业关键数据:加工能力、基地规模、储备容量等
|
|
|
|
|
+- 采用响应式设计,适配大屏显示设备
|
|
|
|
|
+- 集成在src/client/home目录下,作为主要展示页面
|
|
|
|
|
+
|
|
|
### 详细 rationale (决策依据):
|
|
### 详细 rationale (决策依据):
|
|
|
|
|
|
|
|
这些需求基于对现有代码的深入分析:
|
|
这些需求基于对现有代码的深入分析:
|
|
@@ -113,6 +124,7 @@ D8D Starter已经具备优秀的技术基础:
|
|
|
- 主要使用场景是创建企业级管理界面和CRUD操作
|
|
- 主要使用场景是创建企业级管理界面和CRUD操作
|
|
|
- 开发体验和类型安全是核心价值主张
|
|
- 开发体验和类型安全是核心价值主张
|
|
|
- 需要提供生产就绪的认证和权限管理
|
|
- 需要提供生产就绪的认证和权限管理
|
|
|
|
|
+- 供应链可视化大屏面向农业企业决策者和展示场景
|
|
|
|
|
|
|
|
**需要验证的领域**:
|
|
**需要验证的领域**:
|
|
|
- 这些功能需求是否覆盖了所有重要的业务场景?
|
|
- 这些功能需求是否覆盖了所有重要的业务场景?
|
|
@@ -155,6 +167,13 @@ D8D Starter已经具备优秀的技术基础:
|
|
|
- 错误信息应该具有指导性
|
|
- 错误信息应该具有指导性
|
|
|
- 配置过程应该简单直观
|
|
- 配置过程应该简单直观
|
|
|
|
|
|
|
|
|
|
+**NFR6: 大屏可视化性能**
|
|
|
|
|
+- 大屏页面加载时间 < 3秒
|
|
|
|
|
+- 地图和图表渲染流畅,无卡顿
|
|
|
|
|
+- 支持1920x1080分辨率适配
|
|
|
|
|
+- 数据更新响应时间 < 1秒
|
|
|
|
|
+- 内存使用优化,避免内存泄漏
|
|
|
|
|
+
|
|
|
### 详细 rationale (决策依据):
|
|
### 详细 rationale (决策依据):
|
|
|
|
|
|
|
|
这些非功能性需求反映了项目的核心价值主张:
|
|
这些非功能性需求反映了项目的核心价值主张:
|
|
@@ -169,6 +188,7 @@ D8D Starter已经具备优秀的技术基础:
|
|
|
- 需要支持PostgreSQL关系型数据库
|
|
- 需要支持PostgreSQL关系型数据库
|
|
|
- 前端构建基于Vite,后端基于Hono
|
|
- 前端构建基于Vite,后端基于Hono
|
|
|
- 部署环境支持Docker容器化
|
|
- 部署环境支持Docker容器化
|
|
|
|
|
+- 大屏可视化使用React + Tailwind CSS实现,不引入额外地图库
|
|
|
|
|
|
|
|
### 3.2 集成策略
|
|
### 3.2 集成策略
|
|
|
|
|
|
|
@@ -225,6 +245,10 @@ D8D Starter已经具备优秀的技术基础:
|
|
|
**Epic目标**: 为现有API系统添加实际HTTP请求测试,验证系统在真实数据库环境下的行为。
|
|
**Epic目标**: 为现有API系统添加实际HTTP请求测试,验证系统在真实数据库环境下的行为。
|
|
|
**成功标准**: 所有核心API端点都有实际请求测试,测试通过率100%
|
|
**成功标准**: 所有核心API端点都有实际请求测试,测试通过率100%
|
|
|
|
|
|
|
|
|
|
+**Epic 005: 供应链可视化大屏实现**
|
|
|
|
|
+**Epic目标**: 实现4个农业产业的供应链可视化大屏,提供直观的数据展示和供应链网络可视化。
|
|
|
|
|
+**成功标准**: 4个大屏功能完整,视觉设计符合Figma规范,性能指标达标,集成到home页面
|
|
|
|
|
+
|
|
|
### 5.3 各Epic用户故事概览
|
|
### 5.3 各Epic用户故事概览
|
|
|
|
|
|
|
|
**Epic 001 - 测试基础设施**:
|
|
**Epic 001 - 测试基础设施**:
|
|
@@ -248,6 +272,14 @@ D8D Starter已经具备优秀的技术基础:
|
|
|
- 用户API实际请求测试实现
|
|
- 用户API实际请求测试实现
|
|
|
- CI/CD流水线集成
|
|
- CI/CD流水线集成
|
|
|
|
|
|
|
|
|
|
+**Epic 005 - 供应链可视化大屏**:
|
|
|
|
|
+- 粮食油脂大屏实现
|
|
|
|
|
+- 种业果蔬大屏实现
|
|
|
|
|
+- 畜牧水产大屏实现
|
|
|
|
|
+- 鲜食泛盐大屏实现
|
|
|
|
|
+- 大屏导航和切换功能
|
|
|
|
|
+- 数据集成和API对接
|
|
|
|
|
+
|
|
|
## 6. 成功指标和验收标准
|
|
## 6. 成功指标和验收标准
|
|
|
|
|
|
|
|
### 6.1 关键绩效指标(KPI)
|
|
### 6.1 关键绩效指标(KPI)
|
|
@@ -277,10 +309,18 @@ D8D Starter已经具备优秀的技术基础:
|
|
|
- 🐛 生产环境缺陷减少 50%
|
|
- 🐛 生产环境缺陷减少 50%
|
|
|
- 🔄 测试数据管理自动化程度 100%
|
|
- 🔄 测试数据管理自动化程度 100%
|
|
|
|
|
|
|
|
|
|
+**Epic 005 - 供应链可视化大屏指标**:
|
|
|
|
|
+- ✅ 4个大屏功能完整实现
|
|
|
|
|
+- ⏱️ 大屏页面加载时间 < 3秒
|
|
|
|
|
+- 🎨 视觉设计与Figma设计一致
|
|
|
|
|
+- 📊 关键数据指标准确显示
|
|
|
|
|
+- 🔄 大屏切换响应时间 < 1秒
|
|
|
|
|
+
|
|
|
**总体项目指标**:
|
|
**总体项目指标**:
|
|
|
- 📚 文档完整性:API文档覆盖率达到100%
|
|
- 📚 文档完整性:API文档覆盖率达到100%
|
|
|
- 🚀 项目使用率:内部项目采用率>60%
|
|
- 🚀 项目使用率:内部项目采用率>60%
|
|
|
- 📈 功能完成度:PRD需求实现率100%
|
|
- 📈 功能完成度:PRD需求实现率100%
|
|
|
|
|
+- 🗺️ 供应链可视化:4个产业大屏完整实现
|
|
|
|
|
|
|
|
### 6.2 验收标准
|
|
### 6.2 验收标准
|
|
|
|
|
|
|
@@ -318,5 +358,5 @@ D8D Starter已经具备优秀的技术基础:
|
|
|
---
|
|
---
|
|
|
|
|
|
|
|
**文档状态**: 已更新
|
|
**文档状态**: 已更新
|
|
|
-**最后更新**: 2025-09-17
|
|
|
|
|
-**下次评审**: 2025-09-24
|
|
|
|
|
|
|
+**最后更新**: 2025-11-06
|
|
|
|
|
+**下次评审**: 2025-11-13
|