|
|
@@ -1,7 +1,9 @@
|
|
|
# 供应链可视化大屏实现 - Brownfield Epic
|
|
|
|
|
|
## Epic Goal
|
|
|
-实现4个农业产业的供应链可视化大屏,提供直观的数据展示和供应链网络可视化,集成到现有项目的home页面中,为农业企业决策者提供全面的产业数据洞察。
|
|
|
+实现8个农业产业的供应链可视化大屏,提供直观的数据展示和供应链网络可视化,集成到现有项目的home页面中,为农业企业决策者提供全面的产业数据洞察。
|
|
|
+
|
|
|
+**更新说明**:基于最新的Figma设计文档分析,产业数量从4个扩展到8个(粮食、油脂、种业、果蔬、畜牧、水产、鲜食、泛盐)。
|
|
|
|
|
|
## Epic Description
|
|
|
|
|
|
@@ -12,53 +14,82 @@
|
|
|
- **现有页面**:✅ 已有HomePage、LoginPage、MemberPage等基础页面
|
|
|
|
|
|
### 增强详情
|
|
|
-- **新增内容**:4个农业产业的可视化大屏(粮食油脂、种业果蔬、畜牧水产、鲜食泛盐),包含地图可视化、供应链网络、关键指标展示
|
|
|
-- **集成方式**:在`src/client/home`目录下创建新的页面组件,使用现有Tailwind CSS样式系统
|
|
|
-- **技术实现**:React组件 + CSS可视化效果,不引入额外地图库
|
|
|
+- **新增内容**:8个农业产业的可视化大屏(粮食、油脂、种业、果蔬、畜牧、水产、鲜食、泛盐),包含地图可视化、供应链网络、关键指标展示
|
|
|
+- **集成方式**:在`src/client/home/pages/SupplyChainDashboards/`目录下创建新的页面组件,使用现有Tailwind CSS样式系统
|
|
|
+- **技术实现**:React组件 + CSS可视化效果 + Recharts图表库,不引入额外地图库
|
|
|
- **成功标准**:
|
|
|
- - ✅ 4个大屏功能完整实现
|
|
|
+ - ✅ 8个大屏功能完整实现
|
|
|
- ⏱️ 大屏页面加载时间 < 3秒
|
|
|
- 🎨 视觉设计与Figma设计一致
|
|
|
- 📊 关键数据指标准确显示
|
|
|
- 🔄 大屏切换响应时间 < 1秒
|
|
|
+ - 🎯 严格遵循1920*1080分辨率设计
|
|
|
|
|
|
## Stories
|
|
|
|
|
|
-1. **Story 005.001**: 粮食油脂大屏实现
|
|
|
- - 创建GrainOilDashboard组件
|
|
|
- - 实现地图可视化效果
|
|
|
- - 添加供应链网络展示
|
|
|
- - 集成关键指标数据展示
|
|
|
+1. **Story 005.001**: 粮食大屏实现
|
|
|
+ - 创建GrainDashboard组件
|
|
|
+ - 实现粮食供应链地图可视化
|
|
|
+ - 添加粮食产业关键指标展示
|
|
|
+ - 集成粮食产业数据卡片
|
|
|
- 实现导航和交互功能
|
|
|
|
|
|
-2. **Story 005.002**: 种业果蔬大屏实现
|
|
|
- - 创建SeedFruitDashboard组件
|
|
|
- - 实现种业产业链可视化
|
|
|
- - 添加果蔬供应链网络
|
|
|
- - 集成产业数据指标
|
|
|
- - 保持与粮食油脂大屏一致的交互体验
|
|
|
-
|
|
|
-3. **Story 005.003**: 畜牧水产大屏实现
|
|
|
- - 创建LivestockAquacultureDashboard组件
|
|
|
- - 实现畜牧产业链可视化
|
|
|
- - 添加水产供应链网络
|
|
|
- - 集成养殖和加工数据
|
|
|
- - 优化大屏性能表现
|
|
|
-
|
|
|
-4. **Story 005.004**: 鲜食泛盐大屏实现
|
|
|
- - 创建FreshFoodSaltDashboard组件
|
|
|
- - 实现鲜食供应链可视化
|
|
|
- - 添加盐业产业链展示
|
|
|
- - 集成生产和销售数据
|
|
|
- - 完成4个大屏的视觉统一
|
|
|
-
|
|
|
-5. **Story 005.005**: 大屏导航和切换功能
|
|
|
+2. **Story 005.002**: 油脂大屏实现
|
|
|
+ - 创建OilDashboard组件
|
|
|
+ - 实现油脂供应链地图可视化
|
|
|
+ - 添加油脂产业关键指标展示
|
|
|
+ - 集成油脂产业数据卡片
|
|
|
+ - 实现菜籽油产业链联合体展示
|
|
|
+
|
|
|
+3. **Story 005.003**: 种业大屏实现
|
|
|
+ - 创建SeedDashboard组件
|
|
|
+ - 实现种业供应链地图可视化
|
|
|
+ - 添加种业产业关键指标展示
|
|
|
+ - 集成种业产业数据卡片
|
|
|
+ - 实现种业产业链展示
|
|
|
+
|
|
|
+4. **Story 005.004**: 果蔬大屏实现
|
|
|
+ - 创建FruitVegetableDashboard组件
|
|
|
+ - 实现果蔬供应链地图可视化
|
|
|
+ - 添加果蔬产业关键指标展示
|
|
|
+ - 集成果蔬产业数据卡片
|
|
|
+ - 实现果蔬供应链网络展示
|
|
|
+
|
|
|
+5. **Story 005.005**: 畜牧大屏实现
|
|
|
+ - 创建LivestockDashboard组件
|
|
|
+ - 实现畜牧供应链地图可视化
|
|
|
+ - 添加畜牧产业关键指标展示
|
|
|
+ - 集成畜牧产业数据卡片
|
|
|
+ - 实现畜牧产业链展示
|
|
|
+
|
|
|
+6. **Story 005.006**: 水产大屏实现
|
|
|
+ - 创建AquacultureDashboard组件
|
|
|
+ - 实现水产供应链地图可视化
|
|
|
+ - 添加水产产业关键指标展示
|
|
|
+ - 集成水产产业数据卡片
|
|
|
+ - 实现水产供应链网络展示
|
|
|
+
|
|
|
+7. **Story 005.007**: 鲜食大屏实现
|
|
|
+ - 创建FreshFoodDashboard组件
|
|
|
+ - 实现鲜食供应链地图可视化
|
|
|
+ - 添加鲜食产业关键指标展示
|
|
|
+ - 集成鲜食产业数据卡片
|
|
|
+ - 实现鲜食供应链网络展示
|
|
|
+
|
|
|
+8. **Story 005.008**: 泛盐大屏实现
|
|
|
+ - 创建SaltDashboard组件
|
|
|
+ - 实现泛盐供应链地图可视化
|
|
|
+ - 添加泛盐产业关键指标展示
|
|
|
+ - 集成泛盐产业数据卡片
|
|
|
+ - 实现盐业产业链展示
|
|
|
+
|
|
|
+9. **Story 005.009**: 大屏导航和切换功能
|
|
|
- 创建统一的导航组件
|
|
|
- - 实现大屏间快速切换
|
|
|
+ - 实现8个大屏间快速切换
|
|
|
- 添加状态管理和路由
|
|
|
- 优化用户体验和响应速度
|
|
|
|
|
|
-6. **Story 005.006**: 数据集成和API对接
|
|
|
+10. **Story 005.010**: 数据集成和API对接
|
|
|
- 创建供应链数据模型
|
|
|
- 实现后端API接口
|
|
|
- 集成前端数据获取
|
|
|
@@ -82,13 +113,14 @@
|
|
|
|
|
|
## 完成定义
|
|
|
|
|
|
-- [ ] Story 005.001-005.004完成且验收标准满足
|
|
|
-- [ ] 4个大屏功能完整实现
|
|
|
+- [ ] Story 005.001-005.008完成且验收标准满足
|
|
|
+- [ ] 8个大屏功能完整实现
|
|
|
- [ ] 视觉设计与Figma设计一致
|
|
|
- [ ] 性能指标达标(加载时间<3秒)
|
|
|
- [ ] 集成点正常工作
|
|
|
- [ ] 文档适当更新
|
|
|
- [ ] 现有功能无回归
|
|
|
+- [ ] 严格遵循1920*1080分辨率设计
|
|
|
|
|
|
## 验证检查清单
|
|
|
|
|
|
@@ -117,17 +149,33 @@
|
|
|
### 前端架构
|
|
|
- **位置**:`src/client/home/pages/SupplyChainDashboards/`
|
|
|
- **组件结构**:
|
|
|
- - `GrainOilDashboard.tsx` - 粮食油脂大屏
|
|
|
- - `SeedFruitDashboard.tsx` - 种业果蔬大屏
|
|
|
- - `LivestockAquacultureDashboard.tsx` - 畜牧水产大屏
|
|
|
- - `FreshFoodSaltDashboard.tsx` - 鲜食泛盐大屏
|
|
|
+ - `GrainDashboard.tsx` - 粮食大屏
|
|
|
+ - `OilDashboard.tsx` - 油脂大屏
|
|
|
+ - `SeedDashboard.tsx` - 种业大屏
|
|
|
+ - `FruitVegetableDashboard.tsx` - 果蔬大屏
|
|
|
+ - `LivestockDashboard.tsx` - 畜牧大屏
|
|
|
+ - `AquacultureDashboard.tsx` - 水产大屏
|
|
|
+ - `FreshFoodDashboard.tsx` - 鲜食大屏
|
|
|
+ - `SaltDashboard.tsx` - 泛盐大屏
|
|
|
- `DashboardNavigation.tsx` - 导航组件
|
|
|
- `SupplyChainMap.tsx` - 地图可视化组件
|
|
|
+ - `DataCard.tsx` - 数据卡片组件
|
|
|
+ - `IndustryIcon.tsx` - 产业图标组件
|
|
|
|
|
|
### 样式系统
|
|
|
- **技术**:Tailwind CSS + 自定义CSS变量
|
|
|
- **设计规范**:严格遵循Figma设计稿
|
|
|
- **响应式**:支持1920x1080大屏显示
|
|
|
+- **字体规范**:HarmonyOS Sans SC Bold字体族
|
|
|
+- **颜色系统**:
|
|
|
+ - 粮食产业:主色 #C5FF92
|
|
|
+ - 油脂产业:主色 #F6B02E
|
|
|
+ - 种业产业:主色 #5DEF8B
|
|
|
+ - 果蔬产业:主色 #FFF586
|
|
|
+ - 畜牧产业:主色 #F593A5
|
|
|
+ - 水产产业:主色 #6BE9FF
|
|
|
+ - 鲜食产业:主色 #DE7E66
|
|
|
+ - 泛盐产业:主色 #92A5FE
|
|
|
|
|
|
### 数据集成
|
|
|
- **API端点**:新增供应链相关API
|
|
|
@@ -137,11 +185,14 @@
|
|
|
## 验收标准
|
|
|
|
|
|
### 功能验收
|
|
|
-- [ ] 4个大屏页面正常显示
|
|
|
+- [ ] 8个大屏页面正常显示
|
|
|
- [ ] 地图可视化效果正确
|
|
|
- [ ] 供应链网络展示完整
|
|
|
- [ ] 关键数据指标准确
|
|
|
- [ ] 导航切换功能正常
|
|
|
+- [ ] 产业图标和颜色系统正确
|
|
|
+- [ ] 数据卡片组件统一规范
|
|
|
+- [ ] 严格遵循1920*1080分辨率
|
|
|
|
|
|
### 性能验收
|
|
|
- [ ] 页面加载时间 < 3秒
|
|
|
@@ -153,4 +204,38 @@
|
|
|
- [ ] 与Figma设计稿一致
|
|
|
- [ ] 颜色、字体、间距符合规范
|
|
|
- [ ] 图标和图形显示正确
|
|
|
-- [ ] 响应式布局适配良好
|
|
|
+- [ ] 响应式布局适配良好
|
|
|
+
|
|
|
+## 开发规范(基于财务数据可视化大屏最佳实践)
|
|
|
+
|
|
|
+### 图片资源管理
|
|
|
+- **位置**:所有静态图片统一放在 `public/supply-chain/` 目录下
|
|
|
+- **下载方法**:使用 `wget` 直接从Figma提供的图片URL下载
|
|
|
+- **格式检查**:必须检查下载文件的实际格式,使用 `file` 命令验证文件是PNG还是SVG格式
|
|
|
+- **重命名规则**:如果文件实际是SVG格式但使用.png扩展名,必须重命名为.svg扩展名
|
|
|
+- **引用方式**:使用绝对路径 `/supply-chain/{图片文件名}` 引用
|
|
|
+
|
|
|
+### 组件开发流程
|
|
|
+1. **先查看JSXMD文件**:每个组件实现前必须仔细阅读对应figma-jsx.md中的设计规范
|
|
|
+2. **严格分辨率要求**:所有布局和尺寸必须严格按照1920*1080分辨率实现
|
|
|
+3. **组件复用**:基础组件(图标、容器、数据标签等)应设计为可复用组件
|
|
|
+4. **样式一致性**:保持与设计文档中完全一致的组件结构和样式
|
|
|
+
|
|
|
+### 技术栈适配
|
|
|
+- **Figma转JSX代码转换**:将生成的React+Tailwind代码转换为项目现有技术栈
|
|
|
+- **样式系统转换**:将Tailwind类名转换为项目现有样式系统,同时保持精确的视觉设计
|
|
|
+- **组件模式**:遵循项目现有的组件模式和约定
|
|
|
+- **依赖管理**:不安装Tailwind作为依赖,除非用户明确指示
|
|
|
+
|
|
|
+### 设计组件规范
|
|
|
+基于Figma设计文档,需要实现以下核心组件:
|
|
|
+- **基础组件**:图标组件、报表头部组件、底框容器组件、数据标签组件
|
|
|
+- **地图组件**:供应链网络连接线、基地定位点、产业链定位点
|
|
|
+- **数据组件**:数据卡片、指标展示、图表组件
|
|
|
+- **导航组件**:左侧导航栏、产业切换按钮
|
|
|
+
|
|
|
+### 重要开发原则
|
|
|
+- **在实现每个组件和每个步骤时,必须先查看JSXMD文件**
|
|
|
+- **确保准确重现Figma设计的视觉效果和布局**
|
|
|
+- **严格按照1920*1080分辨率实现所有尺寸和间距**
|
|
|
+- **保持与设计文档中完全一致的组件结构和样式**
|