引江济太数据统计模块 - Product Requirement Document
Overview
- Summary: 在statistics文件夹下生成引江济太数据统计模块，包含三个主要部分：1)实时上报统计（今日/本周/本月）；2)年度数据统计表格；3)历年统计分析（表格+图表）。
- Purpose: 提供引江济太项目数据上报情况的可视化统计分析，帮助管理者了解各单位数据上报状态和趋势。
- Target Users: 引江济太项目管理人员、水文监测人员
Goals
- 实现江苏省水文、无锡、上海水文三个单位的今日/本周/本月上报数据统计
- 实现按年份统计各单位上报数据量和监测次数
- 实现按单位查询历年测站数量、监测次数、数据量的表格和图表展示
Non-Goals (Out of Scope)
- 不涉及数据录入和修改功能
- 不涉及用户权限管理
- 不涉及其他业务模块的数据统计
Background & Context
- 系统已有YJJT_STATION（站点表）、YJJT_SL_DATA（水量数据表）、YJJT_SZ_DATA（水质数据表）
- 单位映射关系：太湖流域水文水资源监测中心→无锡，江苏省水文水资源勘测局→江苏，上海市水文总站→上海水文
- 技术栈：Vue 3 + Element Plus + ECharts + Spring Boot + MyBatis + 达梦数据库
Functional Requirements
- FR-1: 统计卡片展示江苏省水文、无锡、上海水文的今日上报数据条数
- FR-2: 统计卡片展示江苏省水文、无锡、上海水文的本周上报数据条数
- FR-3: 统计卡片展示江苏省水文、无锡、上海水文的本月上报数据条数
- FR-4: 按年份表格展示无锡、江苏、上海上报数据量和监测次数
- FR-5: 按单位筛选查询历年测站数量、监测次数、数据量
- FR-6: 使用ECharts柱状图展示历年统计数据
Non-Functional Requirements
- NFR-1: 页面加载时间≤3秒
- NFR-2: 统计数据实时更新，支持手动刷新
- NFR-3: 图表响应式布局，适配不同屏幕尺寸
Constraints
- Technical: 数据库表结构已固定，只能查询现有表数据
- Business: 单位名称映射关系固定（无锡/江苏/上海）
- Dependencies: 需要与YJJT_STATION、YJJT_SL_DATA、YJJT_SZ_DATA表交互
Assumptions
- YJJT_SL_DATA和YJJT_SZ_DATA表中ADDVCD字段用于区分数据来源（WX/JS/SH/ZJ）
- JCDW字段存储单位名称，用于统计各单位的测站数量
- 监测次数：同一天同一测站的记录算作一次监测
- 数据量：单站监测记录的总条数
Acceptance Criteria
AC-1: 今日上报统计卡片
- Given: 用户进入数据统计页面
- When: 页面加载完成
- Then: 显示江苏、无锡、上海三个统计卡片，分别展示今日上报数据条数
- Verification:
programmatic
AC-2: 本周上报统计卡片
- Given: 用户进入数据统计页面
- When: 页面加载完成
- Then: 显示江苏、无锡、上海三个统计卡片，分别展示本周上报数据条数
- Verification:
programmatic
AC-3: 本月上报统计卡片
- Given: 用户进入数据统计页面
- When: 页面加载完成
- Then: 显示江苏、无锡、上海三个统计卡片，分别展示本月上报数据条数
- Verification:
programmatic
AC-4: 年度统计表格
- Given: 用户进入数据统计页面
- When: 页面加载完成
- Then: 显示按年份分组的表格，包含无锡、江苏、上海的上报数据量和监测次数
- Verification:
human-judgment
AC-5: 单位筛选功能
- Given: 用户在数据统计页面
- When: 用户选择江苏/无锡/上海单位
- Then: 下方表格和图表更新为该单位的历年统计数据
- Verification:
programmatic
AC-6: 历年统计图表
- Given: 用户选择某个单位
- When: 页面加载完成
- Then: 显示ECharts柱状图，展示该单位历年测站数量、监测次数、数据量
- Verification:
human-judgment
Open Questions
