root/vscode-workbench
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
54422f44ba8589effda0733933ada94de70b186a
vscode-workbench/.trae/specs/air-quality-api/tasks.md
T

2.3 KiB
Raw Blame History

Tasks

后端实现

  • Task 1: 创建 air_quality Django应用

    • SubTask 1.1: 创建 air_quality/ 目录结构（__init__.py, apps.py, views.py, urls.py, tests.py, admin.py, models.py, migrations/）
    • SubTask 1.2: 配置 apps.py 应用元数据

  • Task 2: 实现空气质量查询API视图

    • SubTask 2.1: 实现 AirQualityView 类（GET和POST方法）
    • SubTask 2.2: 实现城市名称地理编码（复用 Open-Meteo Geocoding API）
    • SubTask 2.3: 调用 Open-Meteo 空气质量API获取数据
    • SubTask 2.4: 解析并格式化AQI数据（PM2.5, PM10, O3, NO2, SO2, CO, 等级）
    • SubTask 2.5: 添加参数校验和错误处理
    • SubTask 2.6: 添加Swagger文档装饰器

  • Task 3: 注册URL路由和应用

    • SubTask 3.1: 配置 air_quality/urls.py 路由
    • SubTask 3.2: 在 api/urls.py 中添加 path('air-quality/', include('air_quality.urls'))
    • SubTask 3.3: 在 settings.py 的 INSTALLED_APPS 中添加 air_quality

前端实现

  • Task 4: 创建AQIDetails页面组件

    • SubTask 4.1: 创建 pages/AQIDetails/ 目录
    • SubTask 4.2: 实现 AQIDetails.tsx 桌面端页面（Hero + Tabs + 文档 + 测试）
    • SubTask 4.3: 实现 AQIDetailsMobile.tsx 移动端页面
    • SubTask 4.4: 创建 AQIDetails.css 样式文件（复用ApiDetail设计风格）

  • Task 5: 添加路由和翻译

    • SubTask 5.1: 在 App.tsx 中添加 /api/air-quality-details 路由
    • SubTask 5.2: 在 locales/zh.json 中添加中文翻译键
    • SubTask 5.3: 在 locales/en.json 中添加英文翻译键
    • SubTask 5.4: 在 locales/ja.json, locales/ko.json, locales/zh-TW.json, locales/ru.json 中添加翻译

集成与验证

  • Task 6: 端到端测试
    • SubTask 6.1: 验证后端API可通过 /api/air-quality/?city=北京 访问
    • SubTask 6.2: 验证Swagger文档包含新API
    • SubTask 6.3: 验证前端页面可通过 /api/air-quality-details 访问
    • SubTask 6.4: 验证前端测试功能可正确调用后端API

Task Dependencies

  • Task 2 依赖 Task 1（需要先创建应用结构）
  • Task 3 依赖 Task 2（需要先实现视图）
  • Task 5 依赖 Task 4（需要先实现页面）
  • Task 6 依赖 Task 3 和 Task 5（需要前后端都完成）
Reference in New Issue View Git Blame Copy Permalink