# 引江济太数据统计模块 - 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
- [ ] 监测次数统计是否需要区分水量和水质？
- [ ] 数据量统计是否需要区分水量和水质？
