vscode-workbench/.trae/specs/air-quality-api/checklist.md

Checklist

后端验证

• air_quality 应用目录结构完整（__init__.py, apps.py, views.py, urls.py, tests.py, admin.py, models.py, migrations/__init__.py）
• AirQualityView 类正确实现 GET 和 POST 方法
• 地理编码逻辑正确调用 Open-Meteo Geocoding API
• 空气质量数据正确解析（包含 pm2_5, pm10, ozone, nitrogen_dioxide, sulphur_dioxide, carbon_monoxide, air_quality_level）
• 参数校验：city 为空时返回 400
• 城市不存在时返回 404
• 第三方API超时/异常时返回 502/503
• Swagger 文档装饰器正确配置（tags, operation_summary, parameters, responses）
• URL 路由注册正确（/api/air-quality/）
• INSTALLED_APPS 包含 air_quality
• 响应格式遵循 {code, message, data} 标准

前端验证

• AQIDetails.tsx 桌面端页面正确渲染
• AQIDetailsMobile.tsx 移动端页面正确渲染
• AQIDetails.css 样式文件存在且与设计系统一致
• Hero 区域显示页面标题和描述
• "文档" 标签显示：接口描述、请求参数表、响应示例、错误码
• "测试" 标签显示：URL输入框、发送按钮、响应结果区域
• 发送请求功能正确调用 /api/air-quality/ 后端API
• 响应结果正确显示（状态码、耗时、响应体）
• 错误处理正确（网络错误、参数错误等）
• 路由 /api/air-quality-details 正确注册
• i18n 翻译在所有支持的语言中完整

集成验证

• 后端API可通过 curl 或 Postman 正常访问
• Swagger UI (/swagger/) 显示空气质量API文档
• 前端页面可通过浏览器正常访问
• 前端测试功能可正确调用后端并显示结果
• 移动端响应式布局正常