# 系统使用统计最终版

## 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`

其中：

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