You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

38 KiB

Raw Blame History Unescape Escape

统计报表

模块编码：statistics 端侧：Web专属关联文档：01-模块划分 §3.7 / 02-功能清单-物业公司 §7 / 03-业务流转逻辑-物业公司 §7 / 05-接口规范 §9.2 强制规范遵循 07-前端界面开发规范.md

功能概览

项目	说明
菜单名称	统计报表
子菜单	报修统计、巡检统计、保洁统计、评价统计、考勤统计、综合看板、自定义报表
功能编号	PR-ST-01 ~ PR-ST-07
权限编码前缀	statistics:repair:* / statistics:inspection:* / statistics:cleaning:* / statistics:evaluation:* / statistics:attendance:* / statistics:dashboard:* / statistics:custom:*

页面1：报修统计页

页面编号：PR-ST-01-P01 端侧归属：Web专属 页面路径：/statistics/repair

界面布局

┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 统计报表 > 报修统计                                       │
├──────────────────────────────────────────────────────────────────┤
│ [时间选择]  今天 / 本周 / 本月 / 本年 / 自定义 [起始]~[结束]       │
│ [筛选]  班组[▼] 区域[▼] 紧急程度[▼]                               │
├──────────────────────────────────────────────────────────────────┤
│ [统计卡片区]                                                       │
│ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐          │
│ │总工单│ │待分配│ │处理中│ │已完成│ │已关闭│ │完成率│          │
│ │ 156  │ │  12  │ │  23  │ │ 108  │ │  13  │ │ 69% │          │
│ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘          │
├──────────────────────────────────────────────────────────────────┤
│ [图表区]                                                          │
│ ┌─────────────────────────┐ ┌─────────────────────────┐         │
│ │ 工单趋势（折线图）        │ │ 类型分布（饼图）          │         │
│ └─────────────────────────┘ └─────────────────────────┘         │
│ ┌─────────────────────────┐                                       │
│ │ 班组工单量排名（柱状图）  │                                       │
│ └─────────────────────────┘                                       │
├──────────────────────────────────────────────────────────────────┤
│ [数据表格]                                                        │
│ 班组 | 总工单 | 已完成 | 完成率 | 平均处理时长 | 评分              │
│ 水电班 | 56  | 42    | 75%   | 4.2小时     | 4.3              │
│ 木工班 | 32  | 28    | 87%   | 3.8小时     | 4.5              │
├──────────────────────────────────────────────────────────────────┤
│ [操作]  [导出Excel] [导出PDF]                                     │
└──────────────────────────────────────────────────────────────────┘

操作按钮

按钮	权限编码	位置	显示条件	说明
导出Excel	statistics:repair:export	操作栏	始终	—
导出PDF	statistics:repair:export	操作栏	始终	—

API端点

页面操作	API路径	方法	说明
统计数据	/api/v1/statistics/repair	GET	含卡片+图表+表格
导出	/api/v1/statistics/repair/export	GET	支持Excel/PDF

交互流程要求

页面加载流程：页面加载时默认查询"本月"时间范围的报修统计数据，依次渲染统计卡片区→图表区→数据表格，加载期间各区域显示骨架屏（Skeleton），全部数据加载完成后隐藏骨架屏
查询/筛选交互流程：用户点击快捷时间按钮（今天/本周/本月/本年）立即切换并重新请求；选择"自定义"时弹出el-date-picker日期范围选择器，确认后触发查询；班组、区域、紧急程度下拉筛选变更后自动触发查询，多个筛选条件组合生效
表单填写与提交流程：本页面无表单提交，仅筛选查询；导出操作点击后弹出确认弹窗选择导出格式（Excel/PDF），确认后触发下载
弹窗/抽屉交互流程：导出格式选择弹窗居中展示，宽度400px；点击弹窗外部或按ESC键关闭弹窗，不触发导出
行内操作流程：数据表格行暂无行内操作，鼠标悬停行高亮背景色
异常与错误处理：接口请求失败时页面顶部显示el-notification错误提示"数据加载失败，请稍后重试"；无数据时图表区显示空状态插图+提示文字"暂无统计数据"；导出失败时弹窗提示"导出失败，请重试"
联动/级联交互：时间范围变更后统计卡片、图表、表格三区联动刷新；筛选条件变更后同样全区域联动
权限控制交互表现：无statistics:repair:export权限时，导出Excel和导出PDF按钮隐藏；无statistics:repair:view权限时页面显示403提示
H1 防重复请求(强制)：快捷时间按钮/筛选条件变更时按钮组disabled+loading态；导出按钮点击后disabled+loading直到下载完成；筛选变更触发查询时abort前一次未完成请求；统计卡片与图表区并发请求互不阻塞
H2 超时配置(强制)：统计数据GET请求设置30s超时（统计档）；导出操作GET请求设置60s超时（上传导出档）；任何请求耗时>3s时展示全局ElLoading
H6 批量限制(建议)：数据表格行数超过500条时提示"数据量过大，建议缩小时间范围后查看或导出"；单次导出上限500条记录
H8 反馈规范(建议)：数据加载完成后各区域正常渲染无额外成功提示；导出成功ElMessage.success 2秒自动消失；加载失败区域显示"点击重试"及重试按钮；网络异常提供全局重试入口

组件规范

元素	组件	配置参数
时间快捷按钮	el-radio-group + el-radio-button	v-model="timeRange", size="default"
自定义日期范围	el-date-picker	type="daterange", value-format="YYYY-MM-DD", range-separator="至"
班组筛选	el-select	v-model="filters.team", clearable, placeholder="选择班组"
区域筛选	el-select	v-model="filters.area", clearable, placeholder="选择区域"
紧急程度筛选	el-select	v-model="filters.urgency", clearable, placeholder="选择紧急程度"
统计卡片	el-card	shadow="hover", body-style="{padding: '20px'}"
工单趋势图	echarts (折线图)	smooth=true, tooltip.trigger="axis", grid.containLabel=true
类型分布图	echarts (饼图)	roseType="radius", tooltip.trigger="item"
班组工单排名	echarts (柱状图)	tooltip.trigger="axis", series.type="bar"
数据表格	el-table	stripe, border, size="default", :data="tableData"
导出Excel按钮	el-button	type="success", icon="Download", :loading="exportLoading"
导出PDF按钮	el-button	type="danger", icon="Document", :loading="exportLoading"
导出格式弹窗	el-dialog	title="选择导出格式", width="400px", :close-on-click-modal="false"

校验规则

字段	规则	错误提示
自定义日期范围-起始日期	必须早于或等于结束日期	开始日期不能晚于结束日期
自定义日期范围-结束日期	必须晚于或等于起始日期	结束日期不能早于开始日期
自定义日期范围-跨度	时间跨度不超过1年	查询时间范围不能超过1年

响应式布局

断点	布局调整
≥1280px（桌面端）	统计卡片6列横排；图表区2列布局（趋势图+饼图），下方柱状图全宽；表格全宽展示
1024-1279px（Pad横屏）	统计卡片3列×2行排列；图表区改为单列堆叠，ECharts图表宽度100%，高度自适应最小350px；表格列宽自适应
768-1023px（Pad竖屏）	统计卡片2列×3行排列；图表区单列堆叠，ECharts图表宽度100%，高度最小300px，饼图改为环形图节省空间；表格启用横向滚动；筛选条件区折叠为展开/收起模式

页面2：巡检统计页

页面编号：PR-ST-02-P01 端侧归属：Web专属 页面路径：/statistics/inspection

统计指标

指标	说明
总巡检任务数	统计时间段内任务总数
完成率	已完成/总数
异常率	有异常记录数/已完成数
补录率	补录记录数/总记录数
蓝牙打卡率	蓝牙打卡数/总打卡数

操作按钮

按钮	权限编码	位置	显示条件	说明
导出	statistics:inspection:export	操作栏	始终	—

交互流程要求

页面加载流程：页面加载时默认查询"本月"巡检统计数据，统计卡片区与图表区并发请求，渲染顺序：统计卡片→趋势折线图→异常率分布饼图→数据表格，加载中显示骨架屏
查询/筛选交互流程：时间快捷按钮（今天/本周/本月/本年）点击即刷新；自定义日期范围确认后触发；班组、区域筛选变更自动刷新；补录数据"包含/排除"切换后立即重新查询
表单填写与提交流程：无表单提交；导出操作点击后直接触发文件下载，按钮显示loading状态直到下载完成
弹窗/抽屉交互流程：本页面无弹窗交互
行内操作流程：数据表格行无行内操作，悬停高亮
异常与错误处理：数据加载失败显示el-notification错误提示；无数据时展示空状态插图；导出失败提示"导出失败，请重试"
联动/级联交互：时间范围或筛选条件变更后统计卡片、图表、表格全区域联动刷新
权限控制交互表现：无statistics:inspection:export权限时导出按钮隐藏
H1 防重复请求(强制)：快捷时间按钮/筛选条件变更时立即disabled+loading；导出按钮点击后disabled+loading直到下载完成；查询触发时abort前一次未完成请求；卡片与图表区并发请求互不阻塞
H2 超时配置(强制)：统计数据GET请求设置30s超时（统计档）；导出操作设置60s超时（上传导出档）；>3s展示全局ElLoading
H6 批量限制(建议)：单次导出上限500条记录，超出时提示"数据量过大，请缩小筛选范围"
H8 反馈规范(建议)：加载完成正常渲染无额外提示；导出成功ElMessage.success 2秒自动消失；加载失败区域提供"点击重试"按钮；网络异常提供重试

组件规范

元素	组件	配置参数
时间快捷按钮	el-radio-group + el-radio-button	v-model="timeRange", size="default"
自定义日期范围	el-date-picker	type="daterange", value-format="YYYY-MM-DD"
班组筛选	el-select	v-model="filters.team", clearable
区域筛选	el-select	v-model="filters.area", clearable
补录数据筛选	el-switch	v-model="filters.includeSupplement", active-text="包含", inactive-text="排除"
统计卡片	el-card	shadow="hover", body-style="{padding: '20px'}"
完成率趋势图	echarts (折线图)	smooth=true, tooltip.trigger="axis"
异常率分布图	echarts (饼图)	tooltip.trigger="item"
数据表格	el-table	stripe, border, size="default"
导出按钮	el-button	type="success", icon="Download", :loading="exportLoading"

校验规则

字段	规则	错误提示
自定义日期范围-起始日期	必须早于或等于结束日期	开始日期不能晚于结束日期
自定义日期范围-跨度	时间跨度不超过1年	查询时间范围不能超过1年

响应式布局

断点	布局调整
≥1280px（桌面端）	统计卡片5列横排；图表区2列布局（趋势图+饼图），下方表格全宽
1024-1279px（Pad横屏）	统计卡片3列+2列排列；图表区单列堆叠，ECharts图表宽度100%，高度最小350px；表格列宽自适应
768-1023px（Pad竖屏）	统计卡片2列+3列排列；图表区单列堆叠，ECharts图表宽度100%，高度最小300px；表格启用横向滚动；筛选区折叠

页面3：保洁统计页

页面编号：PR-ST-03-P01 端侧归属：Web专属 页面路径：/statistics/cleaning

统计指标

指标	说明
总保洁任务数	—
完成率	—
超时率	超时任务数/总数
抽查合格率	抽查合格数/抽查总数
补录率	—

交互流程要求

页面加载流程：进入页面 → 默认查询"本月"时间范围 → 调用保洁统计API → 渲染统计卡片区（总任务数/完成率/超时率/抽查合格率/补录率）→ 图表区（趋势图+分布图）→ 数据表格
查询/筛选交互流程：点击快捷时间按钮立即切换并重新请求；选择自定义日期范围确认后触发查询；班组/区域筛选变更后自动触发查询
表单填写与提交流程：无表单提交；导出操作点击后触发下载
弹窗/抽屉交互流程：本页面无弹窗交互
行内操作流程：数据表格行无行内操作，悬停高亮；超时率列红色标记
异常与错误处理：数据加载失败显示el-notification错误提示；无数据时展示空状态插图；导出失败提示"导出失败，请重试"
联动/级联交互：时间范围或筛选条件变更后全区域联动刷新
权限控制交互表现：无 statistics:cleaning:export 权限时导出按钮隐藏

组件规范

元素	组件	配置参数
时间快捷按钮	el-radio-group + el-radio-button	v-model="timeRange"
自定义日期范围	el-date-picker	type="daterange", value-format="YYYY-MM-DD"
班组筛选	el-select	clearable, placeholder="选择班组"
区域筛选	el-select	clearable, placeholder="选择区域"
统计卡片	el-card	shadow="hover", body-style="{padding:'20px'}"
超时率趋势图	echarts (折线图)	smooth=true, tooltip.trigger="axis"
任务状态分布图	echarts (饼图)	tooltip.trigger="item"
数据表格	el-table	stripe, border
导出按钮	el-button	type="success", icon="Download", :loading="exportLoading"

校验规则

字段	规则	错误提示
自定义日期范围-起始日期	必须早于或等于结束日期	"开始日期不能晚于结束日期"
自定义日期范围-跨度	时间跨度不超过1年	"查询时间范围不能超过1年"

响应式布局

断点	布局调整
≥1280px（桌面端）	统计卡片5列横排；图表区2列布局；表格全宽展示
1024-1279px（Pad横屏）	统计卡片3列+2列排列；图表区单列堆叠；表格列宽自适应
768-1023px（Pad竖屏）	统计卡片2列+3列排列；图表区单列堆叠，高度最小300px；表格启用横向滚动；筛选区折叠

页面4：评价统计页

页面编号：PR-ST-04-P01 端侧归属：Web专属 页面路径：/statistics/evaluation

统计指标

指标	说明
总评价数	—
平均评分	—
各模块评分对比	报修/巡检/保洁/综合
低评分占比	≤2分评价占比
回复率	已回复/总评价数

交互流程要求

页面加载流程：进入页面 → 默认查询"本月"时间范围 → 调用评价统计API → 渲染统计卡片区（总评价数/平均评分/低评分占比/回复率）→ 图表区（各模块评分对比柱状图+星级分布饼图+评分趋势折线图）→ 数据表格
查询/筛选交互流程：点击快捷时间按钮立即切换；自定义日期范围确认后触发；班组筛选变更后自动触发查询
表单填写与提交流程：无表单提交；导出操作点击后触发下载
弹窗/抽屉交互流程：本页面无弹窗交互
行内操作流程：数据表格行无行内操作，悬停高亮；低分占比列红色标记
异常与错误处理：数据加载失败显示el-notification错误提示；无数据时展示空状态插图；导出失败提示"导出失败，请重试"
联动/级联交互：时间范围或筛选条件变更后全区域联动刷新
权限控制交互表现：无 statistics:evaluation:export 权限时导出按钮隐藏
H1 防重复请求(强制)：快捷时间/筛选变更时disabled+loading态；导出按钮点击后disabled+loading；查询变更时abort前次未完成请求；各区域并发请求互不阻塞
H2 超时配置(强制)：统计GET请求30s超时（统计档），导出60s超时（上传导出档）；>3s展示全局ElLoading
H6 批量限制(建议)：单次导出上限500条，超出提示缩小范围
H8 反馈规范(建议)：正常渲染无额外提示；导出成功2秒自动消失；加载失败区域可重试；网络异常提供重试按钮

组件规范

元素	组件	配置参数
时间快捷按钮	el-radio-group + el-radio-button	v-model="timeRange"
自定义日期范围	el-date-picker	type="daterange", value-format="YYYY-MM-DD"
班组筛选	el-select	clearable, placeholder="选择班组"
统计卡片	el-card	shadow="hover", body-style="{padding:'20px'}"
各模块评分对比	echarts (柱状图)	tooltip.trigger="axis", series.type="bar"
星级分布图	echarts (饼图)	tooltip.trigger="item", radius=["40%","70%"]
评分趋势图	echarts (折线图)	smooth=true, tooltip.trigger="axis"
数据表格	el-table	stripe, border
导出按钮	el-button	type="success", icon="Download", :loading="exportLoading"

校验规则

字段	规则	错误提示
自定义日期范围-起始日期	必须早于或等于结束日期	"开始日期不能晚于结束日期"
自定义日期范围-跨度	时间跨度不超过1年	"查询时间范围不能超过1年"

响应式布局

断点	布局调整
≥1280px（桌面端）	统计卡片5列横排；图表区2列+1列布局；表格全宽展示
1024-1279px（Pad横屏）	统计卡片3列+2列排列；图表区单列堆叠；表格列宽自适应
768-1023px（Pad竖屏）	统计卡片2列+3列排列；图表区单列堆叠，高度最小300px；表格启用横向滚动；筛选区折叠

页面5：考勤统计页

页面编号：PR-ST-05-P01 端侧归属：Web专属 页面路径：/statistics/attendance

统计指标

指标	说明
出勤率	实际打卡人数/应打卡人数
迟到率	迟到人数/实际打卡人数
早退率	—
异常申诉率	申诉数/总打卡次数
蓝牙打卡率	蓝牙打卡数/总打卡数

交互流程要求

页面加载流程：进入页面 → 默认查询"本月"时间范围 → 调用考勤统计API → 渲染统计卡片区（出勤率/迟到率/早退率/异常申诉率/蓝牙打卡率）→ 图表区（出勤率趋势折线图+迟到早退分布图）→ 数据表格
查询/筛选交互流程：点击快捷时间按钮立即切换；自定义日期范围确认后触发查询；班组筛选变更后自动触发查询
表单填写与提交流程：无表单提交；导出操作点击后触发下载
弹窗/抽屉交互流程：本页面无弹窗交互
行内操作流程：数据表格行无行内操作，悬停高亮；迟到率/早退率列橙色标记
异常与错误处理：数据加载失败显示el-notification错误提示；无数据时展示空状态插图；导出失败提示"导出失败，请重试"
联动/级联交互：时间范围或筛选条件变更后全区域联动刷新
权限控制交互表现：无 statistics:attendance:export 权限时导出按钮隐藏
H1 防重复请求(强制)：快捷时间/筛选变更时disabled+loading态；导出按钮点击后disabled+loading；查询变更时abort前次未完成请求；各区域并发请求互不阻塞
H2 超时配置(强制)：统计GET请求30s超时（统计档），导出60s超时（上传导出档）；>3s展示全局ElLoading
H6 批量限制(建议)：单次导出上限500条，超出提示缩小范围
H8 反馈规范(建议)：正常渲染无额外提示；导出成功2秒自动消失；加载失败区域可重试；网络异常提供重试按钮

组件规范

元素	组件	配置参数
时间快捷按钮	el-radio-group + el-radio-button	v-model="timeRange"
自定义日期范围	el-date-picker	type="daterange", value-format="YYYY-MM-DD"
班组筛选	el-select	clearable, placeholder="选择班组"
统计卡片	el-card	shadow="hover", body-style="{padding:'20px'}"
出勤率趋势图	echarts (折线图)	smooth=true, tooltip.trigger="axis"
迟到早退分布图	echarts (柱状图)	tooltip.trigger="axis", series.type="bar"
数据表格	el-table	stripe, border
导出按钮	el-button	type="success", icon="Download", :loading="exportLoading"

校验规则

字段	规则	错误提示
自定义日期范围-起始日期	必须早于或等于结束日期	"开始日期不能晚于结束日期"
自定义日期范围-跨度	时间跨度不超过1年	"查询时间范围不能超过1年"

响应式布局

断点	布局调整
≥1280px（桌面端）	统计卡片5列横排；图表区2列布局；表格全宽展示
1024-1279px（Pad横屏）	统计卡片3列+2列排列；图表区单列堆叠；表格列宽自适应
768-1023px（Pad竖屏）	统计卡片2列+3列排列；图表区单列堆叠，高度最小300px；表格启用横向滚动；筛选区折叠

页面6：综合看板页

页面编号：PR-ST-06-P01 端侧归属：Web专属 页面路径：/statistics/dashboard

界面布局

┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 统计报表 > 综合看板                                       │
├──────────────────────────────────────────────────────────────────┤
│ [时间选择]  今天 / 本周 / 本月 / 自定义                            │
├──────────────────────────────────────────────────────────────────┤
│ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐                             │
│ │报修  │ │巡检  │ │保洁  │ │考勤  │                             │
│ │完成率│ │完成率│ │完成率│ │出勤率│                             │
│ │ 69%  │ │ 92%  │ │ 85%  │ │ 96%  │                             │
│ └──────┘ └──────┘ └──────┘ └──────┘                             │
│ ┌──────┐ ┌──────┐                                               │
│ │评价  │ │待处理│                                               │
│ │均分  │ │工单  │                                               │
│ │ 4.2  │ │  12  │                                               │
│ └──────┘ └──────┘                                               │
├──────────────────────────────────────────────────────────────────┤
│ [趋势图] 各模块指标趋势对比                                        │
└──────────────────────────────────────────────────────────────────┘

交互流程要求

页面加载流程：进入页面 → 默认查询"本月"时间范围 → 并行调用各模块汇总API → 渲染6个统计卡片（报修完成率/巡检完成率/保洁完成率/考勤出勤率/评价均分/待处理工单）→ 趋势图（各模块指标趋势对比折线图）
查询/筛选交互流程：点击快捷时间按钮（今天/本周/本月/自定义）→ 立即切换并重新请求所有数据；自定义日期范围确认后触发查询
表单填写与提交流程：本页无表单提交
弹窗/抽屉交互流程：点击统计卡片 → 跳转到对应模块的统计详情页
行内操作流程：点击卡片底部"查看详情"链接 → 跳转对应模块统计页
异常与错误处理：各卡片数据独立加载，某模块加载失败仅该卡片显示"加载失败"；趋势图加载失败显示"加载失败，点击重试"；全部加载失败显示整页错误提示
联动/级联交互：时间范围变更后所有卡片和趋势图联动刷新
权限控制交互表现：无某模块统计查看权限时对应卡片显示"无权限查看"
H1 防重复请求(强制)：快捷时间切换/自定义日期确认后立即disabled+loading态；时间变更触发全量刷新时abort前一次所有未完成并行请求；各模块API独立并发加载，单模块失败不阻塞其他模块渲染
H2 超时配置(强制)：各模块汇总GET请求设置30s超时（统计档）；>3s时对尚未返回的卡片区域展示局部ElLoading；全部超时时显示全局重试入口
H8 反馈规范(建议)：各卡片数据正常加载完成后直接渲染数值和趋势箭头，无需额外成功提示；单卡片加载失败显示"点击重试"；趋势图加载失败显示"加载失败，点击重试"及重试按钮；网络异常时提供全局重试入口

组件规范

元素	组件	配置参数
时间快捷按钮	el-radio-group + el-radio-button	v-model="timeRange"
自定义日期范围	el-date-picker	type="daterange", value-format="YYYY-MM-DD"
统计卡片	el-card	shadow="hover", body-style="{padding:'20px'}", @click="goDetail"
卡片数值	自定义组件	大字号数字+趋势箭头(↑↓)+百分比变化
趋势图	echarts (多折线图)	多条折线对比各模块，smooth=true, tooltip.trigger="axis", legend.data=[报修,巡检,保洁,考勤,评价]
查看详情链接	el-link	type="primary", :underline="false"

校验规则

字段	规则	错误提示
自定义日期范围-起始日期	必须早于或等于结束日期	"开始日期不能晚于结束日期"
自定义日期范围-跨度	时间跨度不超过1年	"查询时间范围不能超过1年"

响应式布局

断点	布局调整
≥1280px（桌面端）	统计卡片3列×2行排列；趋势图全宽展示
1024-1279px（Pad横屏）	统计卡片3列×2行排列，卡片字号略减；趋势图全宽展示
768-1023px（Pad竖屏）	统计卡片2列×3行排列；趋势图全宽展示，高度最小300px；时间选择区折叠为下拉

页面7：自定义报表页

页面编号：PR-ST-07-P01 端侧归属：Web专属 页面路径：/statistics/custom

界面布局

┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 统计报表 > 自定义报表                                     │
├──────────────────────────────────────────────────────────────────┤
│ [配置区]                                                          │
│ 数据源：[▼多选] (报修/巡检/保洁/评价/考勤)                         │
│ 维度：[▼多选] (时间/班组/区域/人员/类型)                            │
│ 指标：[▼多选] (数量/完成率/平均时长/评分...)                        │
│ 时间范围：[起始]~[结束]                                           │
│ 筛选条件：[动态添加]                                              │
├──────────────────────────────────────────────────────────────────┤
│ [操作]  [生成报表] [保存模板] [导出]                               │
├──────────────────────────────────────────────────────────────────┤
│ [结果展示区]                                                      │
│ 图表 + 数据表格                                                   │
└──────────────────────────────────────────────────────────────────┘

操作按钮

按钮	权限编码	位置	显示条件	说明
生成报表	statistics:custom:view	操作栏	始终	—
保存模板	statistics:custom:create	操作栏	始终	保存当前配置为模板
导出	statistics:custom:export	操作栏	已生成报表	—

API端点

页面操作	API路径	方法	说明
生成报表	/api/v1/statistics/custom	POST	自定义维度+指标
保存模板	/api/v1/statistics/custom/templates	POST	—
导出	/api/v1/statistics/custom/export	GET	—

交互流程要求

页面加载流程：进入页面 → 加载配置区下拉选项（数据源/维度/指标列表）；若存在已保存的模板，在配置区下方展示"最近使用模板"快捷入口
查询/筛选交互流程：选择数据源、维度、指标、时间范围、添加筛选条件 → 点击[生成报表] → 调用自定义报表API POST /api/v1/statistics/custom → 渲染结果展示区（图表+数据表格）
表单填写与提交流程：配置报表参数 → 点击[生成报表] → 加载中显示骨架屏 → 渲染结果；点击[保存模板] → 弹窗输入模板名称 → 保存当前配置；点击[导出] → 触发下载
弹窗/抽屉交互流程：保存模板弹窗宽度420px，输入模板名称；点击遮罩层可关闭
行内操作流程：动态添加筛选条件行 → 选择字段+运算符+值 → 可删除已有条件行；生成报表后图表区可交互（缩放、筛选、下钻）
异常与错误处理：数据源和维度至少选一个，否则提示"请选择数据源和维度"；指标至少选一个，否则提示"请至少选择一个指标"；生成失败显示ElMessage.error；导出失败提示"导出失败，请重试"
联动/级联交互：数据源选择后联动可用维度和指标列表；维度选择后联动图表类型推荐；筛选条件中字段选择后联动运算符和值选项
权限控制交互表现：无 statistics:custom:view 权限时[生成报表]按钮隐藏；无 statistics:custom:create 权限时[保存模板]按钮隐藏；无 statistics:custom:export 权限时[导出]按钮隐藏
H1 防重复请求(强制)："生成报表"按钮点击后立即disabled+loading直到结果返回或超时；"保存模板""导出"按钮点击后disabled+loading防重复；筛选条件行动态添加/删除不影响已生成的报表结果
H2 超时配置(强制)：生成报表POST请求设置30s超时（统计档）；保存模板POST请求30s超时；导出GET请求60s超时（上传导出档）；>3s时展示全局ElLoading
H6 批量限制(建议)：导出操作上限500条记录，超出提示"数据量过大，请缩小维度范围后重新生成"
H8 反馈规范(建议)：生成报表成功后图表+表格正常渲染无额外成功提示；保存模板成功ElMessage.success("模板保存成功")2秒自动消失；导出成功2秒自动消失；校验错误/生成失败需手动关闭；网络异常提供重试按钮

组件规范

元素	组件	配置参数
数据源选择	el-select	v-model="config.dataSources", multiple, collapse-tags, placeholder="请选择数据源"
维度选择	el-select	v-model="config.dimensions", multiple, collapse-tags, placeholder="请选择维度"
指标选择	el-select	v-model="config.metrics", multiple, collapse-tags, placeholder="请选择指标"
时间范围	el-date-picker	type="daterange", value-format="YYYY-MM-DD", range-separator="至"
筛选条件添加	el-button	type="primary", link, icon="Plus", @click="addFilter"
筛选条件行	自定义组件	字段el-select + 运算符el-select + 值el-input/el-select + 删除按钮
生成报表按钮	el-button	type="primary", :loading="generating"
保存模板按钮	el-button	type="success"
导出按钮	el-button	type="success", icon="Download", :disabled="!hasResult"
结果图表区	echarts	动态渲染，根据维度/指标配置图表类型
结果表格	el-table	stripe, border, :data="resultData"
保存模板弹窗	el-dialog	title="保存模板", width="420px"
模板名称	el-input	maxlength=30, placeholder="请输入模板名称"

校验规则

字段	规则	错误提示
数据源	至少选1个	"请选择数据源"
维度	至少选1个	"请选择维度"
指标	至少选1个	"请至少选择一个指标"
时间范围	必选，跨度不超过1年	"请选择时间范围" / "查询时间范围不能超过1年"
模板名称	保存时必填，maxlength=30	"请输入模板名称"

响应式布局

断点	布局调整
≥1280px（桌面端）	配置区水平排列，结果区2列布局（图表+表格）
1024-1279px（Pad横屏）	配置区换行排列，结果区单列堆叠
768-1023px（Pad竖屏）	配置区垂直堆叠，使用el-collapse折叠面板组织配置项；结果区单列堆叠；操作按钮full-width堆叠

需求追溯

功能点编号	功能名称	文档来源	后续服务	关联功能
PR-ST-01	报修统计	02-物业公司 §7 / 03-物业公司 §7	—	在线报修(数据源)
PR-ST-02	巡检统计	02-物业公司 §7 / 03-物业公司 §7	—	巡检管理(数据源)
PR-ST-03	保洁统计	02-物业公司 §7 / 03-物业公司 §7	—	保洁管理(数据源)
PR-ST-04	评价统计	02-物业公司 §7 / 03-物业公司 §7	—	服务评价(数据源)
PR-ST-05	考勤统计	02-物业公司 §7 / 03-物业公司 §7	—	考勤打卡(数据源)
PR-ST-06	综合看板	02-物业公司 §7	—	全部模块(数据源)
PR-ST-07	自定义报表	02-物业公司 §7	—	全部模块(数据源)

业务规则

时间维度：支持天/周/月/年/自定义时间段查询（来源：02-物业公司 §7）
导出格式：支持Excel和PDF导出（来源：02-物业公司 §7）
数据权限：物业公司管理员看本公司绑定医院数据，主管看本班组数据（来源：01 §1.3）
补录数据标记：统计报表中补录数据单独标记，可筛选排除（来源：03-物业公司 §2.3）
导出日志：每次导出操作记录审计日志（来源：06 §4.5）

38 KiB Raw Blame History Unescape Escape

统计报表

功能概览

页面1：报修统计页

界面布局

操作按钮

API端点

交互流程要求

组件规范

校验规则

响应式布局

页面2：巡检统计页

统计指标

操作按钮

交互流程要求

组件规范

校验规则

响应式布局

页面3：保洁统计页

统计指标

交互流程要求

组件规范

校验规则

响应式布局

页面4：评价统计页

统计指标

交互流程要求

组件规范

校验规则

响应式布局

页面5：考勤统计页

统计指标

交互流程要求

组件规范

校验规则

响应式布局

页面6：综合看板页

界面布局

交互流程要求

组件规范

校验规则

响应式布局

页面7：自定义报表页

界面布局

操作按钮

API端点

交互流程要求

组件规范

校验规则

响应式布局

需求追溯

业务规则

38 KiB

Raw Blame History Unescape Escape