Преглед изворни кода

📝 docs(prd): update product requirements document

- add version 1.3 with supply chain visualization feature
- update project features to include supply chain visualization system
- add FR6: supply chain visualization dashboard requirements
- add NFR6: dashboard visualization performance requirements
- add Epic 005: supply chain visualization dashboard implementation
- update success metrics and acceptance criteria for new feature

🔧 chore(settings): add figma design context command

- add "mcp__figma__get_design_context" to allowed commands in claude settings
yourname пре 2 месеци
родитељ
комит
f76dfa515c
2 измењених фајлова са 45 додато и 4 уклоњено
  1. 3 2
      .claude/settings.local.json
  2. 42 2
      docs/prd.md

+ 3 - 2
.claude/settings.local.json

@@ -34,9 +34,10 @@
       "Bash(pnpm test:components:*)",
       "Bash(pnpm test:unit:*)",
       "Bash(mkdir:*)",
-      "Bash(xargs sed:*)"
+      "Bash(xargs sed:*)",
+      "mcp__figma__get_design_context"
     ],
     "deny": [],
     "ask": []
   }
-}
+}

+ 42 - 2
docs/prd.md

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