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,10 @@
+- [x] 页面路由配置正确，从API接口大全可跳转到空气质量详情页
+- [x] API调用URL正确（`/api/air-quality/`带斜杠）
+- [x] GET请求参数正确传递
+- [x] POST请求参数正确传递
+- [x] 响应数据正确展示（包括PM2.5、PM10、O₃、NO₂、SO₂、CO等指标）
+- [x] 文档标签页显示完整（接口说明、参数说明、响应示例、错误码）
+- [x] 测试标签页功能正常（方法选择、URL输入、请求发送、响应展示）
+- [x] 页面样式与API接口大全一致
+- [x] 移动端适配正常
+- [x] 暗色模式适配正常
@@ -0,0 +1,44 @@
+# 空气质量API详情页 Spec
+
+## Why
+当前空气质量详情页（AQIDetails）已存在但可能存在与API接口大全集成不一致的问题，需要完善页面实现，确保与API接口大全风格统一、API调用正确、用户体验良好。
+
+## What Changes
+- 确保页面与API接口大全（ApiDirectory）风格一致
+- 修复API调用URL问题（后端使用`/api/air-quality/`带斜杠）
+- 完善文档标签页和测试标签页功能
+- 确保响应数据正确展示
+
+## Impact
+- Affected specs: 无
+- Affected code: 
+  - `chunyu_project_react/src/pages/AQIDetails/AQIDetails.tsx` — 完善页面实现
+  - `chunyu_project_react/src/pages/AQIDetails/AQIDetails.css` — 样式优化
+
+## ADDED Requirements
+### Requirement: 空气质量API详情页完整性
+系统 SHALL 提供一个完整的空气质量API详情页，包含文档标签页和测试标签页。
+
+#### Scenario: 访问详情页
+- **WHEN** 用户从API接口大全点击空气质量API卡片
+- **THEN** 跳转到空气质量详情页，显示API文档和测试界面
+
+#### Scenario: 查看API文档
+- **WHEN** 用户切换到文档标签页
+- **THEN** 显示API名称、接口说明、请求参数、响应示例、错误码说明
+
+#### Scenario: 测试API
+- **WHEN** 用户在测试标签页输入参数并发送请求
+- **THEN** 显示响应状态码、响应时间、响应体内容
+
+## MODIFIED Requirements
+### Requirement: API调用逻辑
+测试标签页 SHALL 正确调用后端API `/api/air-quality/`，支持GET和POST方式。
+
+#### Scenario: GET请求
+- **WHEN** 用户选择GET方式并发送请求
+- **THEN** 将参数拼接到URL查询字符串中发送
+
+#### Scenario: POST请求
+- **WHEN** 用户选择POST方式并发送请求
+- **THEN** 将参数放入请求体发送
@@ -0,0 +1,21 @@
+# Tasks
+
+- [x] Task 1: 分析现有AQIDetails页面与ApiDirectory的集成问题
+  - [x] 检查路由配置是否正确
+  - [x] 检查API调用URL是否匹配后端
+  - [x] 检查样式是否与API接口大全一致
+
+- [x] Task 2: 修复API调用逻辑
+  - [x] 修正API URL为`/api/air-quality/`（带斜杠）
+  - [x] 确保GET/POST请求参数正确传递
+  - [x] 确保响应数据正确解析和展示
+
+- [x] Task 3: 完善页面功能
+  - [x] 确保文档标签页内容完整准确
+  - [x] 确保测试标签页功能正常
+  - [x] 添加加载状态和错误处理
+
+- [x] Task 4: 验证功能
+  - [x] 验证从API接口大全能正确跳转
+  - [x] 验证API文档显示正确
+  - [x] 验证API测试功能正常