wren
5.9 KiB
5.9 KiB
系统使用统计最终需求
1. 背景与目标
建设一个“系统使用统计”功能，用于按时间范围统计平台用户的登录、文档上传、文档评查等核心使用情况，并支持按用户、部门、地区、文档大类、文档类型、入口模块等维度进行动态汇总与明细查询。
本功能定位为“使用统计”而非“全量行为审计”，目标是让管理人员快速回答以下问题：
- 谁在使用系统
- 哪些部门、哪些地区使用更活跃
- 上传了多少文档
- 发起了多少次评查
- 哪些文档分类、入口模块使用最多
2. 建设目标
- 支持管理人员查看平台整体使用情况
- 支持按用户、按部门、按地区查看使用成效
- 支持按文档分类动态统计评查使用情况
- 支持自定义时间范围查询
- 支持查看汇总数据与明细数据
- 支持后续新增文档分类后自动纳入统计
3. 统计范围
本次仅统计平台核心业务使用数据，范围限定为以下三类：
- 登录使用数据
- 文档上传数据
- 文档评查数据
本次暂不纳入以下范围：
- 页面点击轨迹
- 全量按钮操作日志
- 文档浏览轨迹
- AI 对话细粒度行为
- 全量人工操作留痕回放
- 风险预警与异常行为识别
4. 统计维度
系统应支持以下动态维度的筛选与汇总：
- 时间范围
- 用户
- 部门
- 地区
- 入口模块
- 文档大类
- 文档类型
约束要求：
- 文档大类、文档类型、入口模块必须来源于系统实际配置或业务数据
- 不允许在代码中写死“合同类”“案卷类”等固定业务名称
- 后续若新增文档大类、文档类型或入口模块，应可自动纳入统计
5. 核心统计指标
5.1 登录使用指标
- 登录次数
- 登录用户数
- 活跃用户数
- 最近登录时间
说明：
- 活跃用户数指在指定时间范围内，发生过登录、上传或评查行为的去重用户数
5.2 文档上传指标
- 上传文档次数
- 上传附件次数
- 上传文档总数
- 上传用户数
- 按时间趋势统计上传量
说明：
- 上传文档次数仅统计主文件上传
- 上传附件次数单独统计附件上传
5.3 文档评查指标
- 评查发起次数
- 评查完成次数
- 评查失败次数
- 按文档大类统计评查次数
- 按文档类型统计评查次数
- 按入口模块统计评查次数
- 按时间趋势统计评查次数
说明：
- 评查统计应基于评查运行记录
- 分类统计应支持动态扩展，不依赖写死分类名称
5.4 用户、部门、地区汇总指标
- 按用户统计登录次数、上传次数、评查次数
- 按部门统计登录人数、上传次数、评查次数
- 按地区统计登录人数、上传次数、评查次数
- 用户排行
- 部门排行
- 地区排行
6. 地区统计口径
地区统计需同时支持以下两种口径：
6.1 用户地区口径
按用户所属地区统计，适用于回答：
- 哪个地区的人员在使用系统
- 哪个地区的用户最活跃
6.2 文档地区口径
按文档所属地区统计，适用于回答：
- 哪个地区的业务量更大
- 哪个地区的文档评查量更高
要求：
- 地区统计查询时，应允许明确指定统计口径
- 若未指定，系统应使用默认口径并在界面上清晰标注
7. 页面功能需求
7.1 使用概览页
用于查看整体汇总情况，建议包含：
- 时间范围筛选
- 登录用户数
- 活跃用户数
- 上传文档数
- 评查次数
- 用户排行
- 部门排行
- 地区排行
- 按时间趋势图
- 按文档大类分布图
- 按入口模块分布图
- 按地区分布图
7.2 明细查询页
用于查看具体记录，需支持以下筛选条件：
- 时间范围
- 用户
- 部门
- 地区
- 地区口径
- 入口模块
- 文档大类
- 文档类型
- 数据类型：登录 / 上传 / 评查
明细字段建议包括：
- 时间
- 用户名
- 所属部门
- 所属地区
- 数据类型
- 文档名称
- 文档类型
- 文档大类
- 入口模块
- 结果状态
并支持：
- 分页
- 排序
- 导出
8. 统计口径要求
为保证扩展性与可维护性，系统必须遵循以下原则：
- 固定统计项只保留通用业务指标，如登录、上传、评查
- 分类统计必须走动态维度，不得写死业务类别名称
- 文档大类应来源于系统中的实际分类结构或映射关系
- 新增文档类型后，应可自动归属到对应统计维度
- 报表展示应支持展示全部分类，而非只展示预设类别
9. 数据准确性要求
- 用户统计应以实际登录用户信息为准
- 部门统计应以用户所属部门信息为准
- 地区统计应支持“用户所属地区”与“文档所属地区”两种口径
- 上传统计应以文档上传记录为准
- 评查统计应以评查运行记录为准
- 所有统计均应支持按指定时间范围计算
- 汇总数据与明细数据应能相互追溯
10. 扩展性要求
系统应满足以下扩展能力：
- 支持新增文档大类后自动纳入统计
- 支持新增文档类型后自动纳入统计
- 支持新增入口模块后自动纳入统计
- 支持后续新增更多统计维度
- 支持后续增加导出报表能力
- 支持后续扩展为领导驾驶舱或运营看板
11. 一期交付范围建议
建议一期先实现以下能力：
- 自定义时间范围查询
- 使用概览页
- 明细查询页
- 登录、上传、评查三类核心指标
- 按用户、部门、地区、文档大类、文档类型、入口模块统计
- 导出明细
12. 一期暂不实现内容
- 全量行为审计流水
- 页面访问轨迹
- 全操作留痕回放
- AI 对话审计分析
- 风险预警模型
- 复杂多层组织分析
13. 一句话范围定义
本次“系统使用统计”功能不做全量行为追踪，仅围绕登录、上传、评查三类核心业务数据，提供按用户、部门、地区、文档大类、文档类型、入口模块的动态统计与明细查询能力。