leaudit-platform-backend/docs/系统使用统计/系统使用统计最终版.md

系统使用统计最终版

1. 功能定位

“系统使用统计”定位为管理视角的业务使用成效统计，不做全量行为审计。

它主要回答三类问题：

• 谁在使用系统
• 哪些部门、哪些地区使用更活跃
• 上传了多少文档、发起了多少次评查

本期只围绕真实业务结果做统计，不扩展到页面点击轨迹、按钮级留痕或 AI 对话细粒度行为。

2. 一期统计范围

本期只统计以下三类数据：

• 登录使用数据
• 文档上传数据
• 文档评查数据

本期不纳入：

• 页面点击轨迹
• 全量按钮操作日志
• 文档浏览轨迹
• AI 对话细粒度行为
• 全量人工操作留痕回放
• 风险预警与异常行为识别

3. 统计目标

系统应支持：

• 按时间范围统计平台整体使用情况
• 按用户、按部门、按地区查看使用成效
• 按入口模块、文档大类、文档类型查看使用分布
• 查看汇总数据与明细数据
• 支持后续新增文档分类、入口模块后自动纳入统计

4. 统计维度

一期统一按动态维度设计，不能在代码里写死“合同类”“案卷类”等固定业务名称。

支持维度：

• 时间范围
• 用户
• 部门
• 地区
• 地区口径
• 入口模块
• 文档大类
• 文档类型

约束：

• 文档大类、文档类型、入口模块必须来源于系统真实配置或业务数据
• 新增文档大类、文档类型、入口模块后，应自动纳入统计
• 页面展示不能依赖写死业务名称

5. 核心指标口径

5.1 登录指标

• 登录次数
• 登录用户数
• 活跃用户数
• 最近登录时间

说明：

• 活跃用户数指在指定时间范围内，发生过登录、上传或评查行为的去重用户数
• 最近登录时间以成功登录为准

5.2 上传指标

• 上传文档次数
• 上传附件次数
• 上传文档总数
• 上传用户数
• 上传时间趋势

说明：

• 主文件上传统计口径：file_role = 'primary'
• 附件上传统计口径：file_role = 'attachment'

5.3 评查指标

• 评查发起次数
• 评查完成次数
• 评查失败次数
• 按文档大类统计评查次数
• 按文档类型统计评查次数
• 按入口模块统计评查次数
• 按时间趋势统计评查次数

说明：

• 评查统计以 leaudit_audit_runs 为准
• “谁发起评查”必须依赖 trigger_user_id
• 分类统计走动态维度，不写死业务类型名称

5.4 用户 / 部门 / 地区汇总指标

• 按用户统计登录次数、上传次数、评查次数
• 按部门统计登录人数、上传次数、评查次数
• 按地区统计登录人数、上传次数、评查次数
• 用户排行
• 部门排行
• 地区排行

6. 地区统计口径

地区统计需同时支持两种口径：

6.1 用户地区口径

适用于回答：

• 哪个地区的人员在使用系统
• 哪个地区的用户最活跃

6.2 文档地区口径

适用于回答：

• 哪个地区的业务量更大
• 哪个地区的文档评查量更高

要求：

• 查询时允许明确指定口径
• 未指定时使用默认口径，并在页面上明确标识
• 地区管理员只能看到本地区数据

7. 页面范围

7.1 一期先做的页面

放在“系统设置”里，先做这 3 个视角：

• 总览
• 按部门
• 按地区

说明：

• 如果这 3 个视角整体可用，本期不再继续叠加更多复杂页面
• 用户视角、明细导出、趋势增强等后续按需要再补

7.2 总览页应包含

• 时间范围筛选
• 登录用户数
• 活跃用户数
• 上传文档数
• 评查次数
• 基础趋势
• 关键分布

7.3 按部门页应包含

• 部门列表汇总
• 登录人数
• 上传次数
• 评查次数
• 支持时间范围筛选
• 支持地区过滤

7.4 按地区页应包含

• 地区列表汇总
• 登录人数
• 上传次数
• 评查次数
• 支持用户地区 / 文档地区口径切换
• 地区管理员仅能看本地区

8. 数据准确性要求

• 用户统计以实际登录用户信息为准
• 部门统计以用户所属部门信息为准
• 地区统计同时支持用户地区与文档地区两种口径
• 上传统计以文档上传记录为准
• 评查统计以评查运行记录为准
• 所有统计均支持时间范围筛选
• 汇总数据与明细数据应能相互追溯

9. 一期正式交付口径

本期正式交付范围收敛为：

• 自定义时间范围查询
• 系统设置下的“系统使用统计”页面入口
• 总览页
• 按部门页
• 按地区页
• 登录 / 上传 / 评查三类核心统计
• 地区管理员按地区隔离

本期不强行纳入：

• 复杂驾驶舱
• 全量行为审计
• 页面访问日志
• AI 对话统计
• 大规模预计算聚合

10. 文档关系

本目录后续统一只保留两份主文档：

• docs/系统使用统计/系统使用统计最终版.md
• docs/系统使用统计/系统使用统计实施版.md

其中：

• 最终版负责定义业务口径与交付边界
• 实施版负责定义表结构、接口、权限、开发拆解与上线顺序