feat: PLANNING体系首版（00路线图/02任务总表/03执行协议/I-03/I-04/registry42口径）+M1止血交付

2026-09-12 14:25:25 +08:00
commit 39af400fc8
472 changed files with 36277 additions and 0 deletions
@@ -0,0 +1,20 @@
+# Checklist
+
+## 功能验证
+- [ ] 页面加载时显示loading状态
+- [ ] 工具列表正确显示从API获取的数据
+- [ ] 分类Tab正确显示从API获取的分类
+- [ ] 点击分类Tab可筛选工具
+- [ ] 点击工具卡片跳转到详情页
+- [ ] API请求失败时显示错误提示
+
+## UI验证
+- [ ] 加载状态显示正确
+- [ ] 卡片样式与原有设计一致
+- - [ ] 响应式布局正常工作
+
+## 数据验证
+- [ ] 工具名称、描述正确显示
+- [ ] 使用次数(usage_count)正确显示
+- [ ] 收藏数(favorites_count)正确显示
+- [ ] 分类名称正确显示
@@ -0,0 +1,48 @@
+# Tools页面动态数据加载 Spec
+
+## Why
+当前Tools页面使用静态硬编码数据，无法动态管理工具列表。需要改为从数据库通过API获取，实现后台管理动态配置。
+
+## What Changes
+- 修改 `Tools.tsx` 从API动态获取分类和工具数据
+- 添加加载状态和错误处理
+- 保持现有UI结构和样式风格
+- 添加工具详情跳转逻辑
+
+## Impact
+- Affected code: 
+  - `chunyu_project_react/src/pages/Tools/Tools.tsx`
+
+## ADDED Requirements
+
+### Requirement: 动态加载工具列表
+系统SHALL从后端API `/tool/list/` 动态获取工具列表数据。
+
+#### Scenario: 页面加载时获取数据
+- **WHEN** 用户访问Tools页面
+- **THEN** 页面从API获取工具列表并展示加载状态
+
+#### Scenario: 分类筛选
+- **WHEN** 用户点击分类Tab
+- **THEN** 页面根据所选分类过滤工具列表
+
+### Requirement: 动态加载分类列表
+系统SHALL从后端API `/tool/categories/` 动态获取分类数据。
+
+#### Scenario: 分类Tab动态渲染
+- **WHEN** 页面加载完成
+- **THEN** 分类Tab从API获取并渲染
+
+### Requirement: 错误处理
+系统SHALL在API请求失败时显示友好的错误信息。
+
+#### Scenario: 网络错误
+- **WHEN** API请求失败
+- **THEN** 显示错误提示和重试按钮
+
+### Requirement: 工具详情跳转
+系统SHALL根据工具类型跳转到对应详情页面。
+
+#### Scenario: 点击工具卡片
+- **WHEN** 用户点击工具卡片
+- **THEN** 跳转到工具详情页或外部URL
@@ -0,0 +1,17 @@
+# Tasks
+
+- [ ] Task 1: 修改Tools.tsx动态加载数据
+  - [ ] SubTask 1.1: 添加useEffect获取分类和工具数据
+  - [ ] SubTask 1.2: 添加loading和error状态
+  - [ ] SubTask 1.3: 使用api_request.tool.getCategories()获取分类
+  - [ ] SubTask 1.4: 使用api_request.tool.getList()获取工具列表
+  - [ ] SubTask 1.5: 实现分类筛选功能
+  - [ ] SubTask 1.6: 添加错误处理和重试按钮
+  - [ ] SubTask 1.7: 实现工具卡片点击跳转
+
+- [ ] Task 2: 验证数据映射正确性
+  - [ ] SubTask 2.1: 确认API返回字段与UI展示字段对应
+  - [ ] SubTask 2.2: 处理空数据状态
+
+# Task Dependencies
+- Task 2 依赖于 Task 1