# 系统使用统计最终需求 ## 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. 一句话范围定义 本次“系统使用统计”功能不做全量行为追踪，仅围绕登录、上传、评查三类核心业务数据，提供按用户、部门、地区、文档大类、文档类型、入口模块的动态统计与明细查询能力。