tba-gx-guochan/.trae/specs/yjjt-statistics/tasks.md

引江济太数据统计模块 - 实现计划

[x] Task 1: 创建统计查询DTO类

• Priority: high
• Depends On: None
• Description: 创建统计查询相关的DTO类，包括DailyStatistics、YearlyStatistics、UnitStatistics等数据传输对象
• Acceptance Criteria Addressed: [AC-1, AC-2, AC-3, AC-4, AC-5, AC-6]
• Test Requirements:
  • programmatic TR-1.1: DTO类字段完整，包含stcd、year、stationCount、monitorCount、dataCount等字段
  • human-judgement TR-1.2: 代码符合项目命名规范，字段命名清晰
• Notes: DTO类放在gw-gx模块的domain或dto目录下

[x] Task 2: 创建统计Mapper接口和XML

• Priority: high
• Depends On: Task 1
• Description: 创建YjjtStatisticsMapper接口，包含今日/本周/本月统计、年度统计、历年统计等SQL查询方法
• Acceptance Criteria Addressed: [AC-1, AC-2, AC-3, AC-4, AC-5, AC-6]
• Test Requirements:
  • programmatic TR-2.1: Mapper接口方法完整，包含统计查询方法
  • programmatic TR-2.2: XML映射文件SQL语法正确，适配达梦数据库
• Notes: 需要查询YJJT_STATION、YJJT_SL_DATA、YJJT_SZ_DATA三张表

[x] Task 3: 创建统计Service接口和实现类

• Priority: high
• Depends On: Task 2
• Description: 创建IYjjtStatisticsService接口和YjjtStatisticsServiceImpl实现类，封装统计业务逻辑
• Acceptance Criteria Addressed: [AC-1, AC-2, AC-3, AC-4, AC-5, AC-6]
• Test Requirements:
  • programmatic TR-3.1: Service接口方法完整
  • human-judgement TR-3.2: 业务逻辑清晰，单位映射处理正确
• Notes: 处理单位名称映射：太湖流域水文水资源监测中心→无锡，江苏省水文水资源勘测局→江苏，上海市水文总站→上海水文

[x] Task 4: 创建统计Controller

• Priority: high
• Depends On: Task 3
• Description: 创建YjjtStatisticsController控制器，提供统计数据查询API接口
• Acceptance Criteria Addressed: [AC-1, AC-2, AC-3, AC-4, AC-5, AC-6]
• Test Requirements:
  • programmatic TR-4.1: 接口路径正确，响应格式符合统一规范
  • programmatic TR-4.2: 接口返回数据结构符合预期
• Notes: 接口路径：/yjjt/statistics

[x] Task 5: 创建前端API文件

• Priority: high
• Depends On: Task 4
• Description: 创建statistics.js API文件，封装统计数据查询接口调用
• Acceptance Criteria Addressed: [AC-1, AC-2, AC-3, AC-4, AC-5, AC-6]
• Test Requirements:
  • programmatic TR-5.1: API方法完整，包含所有统计查询接口
  • human-judgement TR-5.2: 请求参数和响应处理正确
• Notes: API文件放在gw-ui/src/api/yjjt/目录下

[x] Task 6: 创建统计页面index.vue

• Priority: high
• Depends On: Task 5
• Description: 创建数据统计页面，包含三个部分：实时统计卡片、年度统计表格、历年统计分析（表格+图表）
• Acceptance Criteria Addressed: [AC-1, AC-2, AC-3, AC-4, AC-5, AC-6]
• Test Requirements:
  • human-judgement TR-6.1: 页面布局美观，符合项目UI规范
  • human-judgement TR-6.2: ECharts图表展示正确，支持单位切换
• Notes: 使用Element Plus组件和ECharts图表库

[x] Task 7: 添加菜单和权限配置

• Priority: medium
• Depends On: Task 6
• Description: 在数据库菜单表中添加数据统计菜单，并配置相关权限
• Acceptance Criteria Addressed: [AC-1, AC-2, AC-3, AC-4, AC-5, AC-6]
• Test Requirements:
  • programmatic TR-7.1: 菜单SQL语句正确，适配达梦数据库
  • human-judgement TR-7.2: 页面能够正常访问，权限控制生效
• Notes: 更新init-yjjt-report-menu.sql文件