docs: consolidate usage stats documentation
This commit is contained in:
wren
@@ -0,0 +1,222 @@
|
||||
# 系统使用统计最终版
|
||||
|
||||
## 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`
|
||||
|
||||
其中：
|
||||
|
||||
- 最终版负责定义业务口径与交付边界
|
||||
- 实施版负责定义表结构、接口、权限、开发拆解与上线顺序
|
||||
Reference in New Issue
Block a user