docs: consolidate usage stats documentation

This commit is contained in:
wren
2026-05-10 21:04:07 +08:00
parent 601811f957
commit 58ee6a1085
9 changed files with 534 additions and 2060 deletions
+36 -1
View File
@@ -238,6 +238,32 @@
- 这块产品表达要统一成“可用规则数”,不要再出现“可用版本”旧说法
- 页面上还需要继续把这些错误稳定映射成用户可理解提示
### 13. 系统使用统计口径已经收口到“两份主文档 + 一期三视角”
当前这块不要再按“需求 / 表设计 / 接口设计 / 任务拆解”四散维护,已经统一收口为两份主文档:
- `docs/系统使用统计/系统使用统计最终版.md`
- `docs/系统使用统计/系统使用统计实施版.md`
当前正式口径:
- 功能定位是“使用统计”,不是“全量行为审计”
- 一期只统计:登录、上传、评查
- 一期前端页面只做 3 个视角:
- 总览
- 按部门
- 按地区
- 页面入口放在“系统设置”
- 地区管理员只能看本地区数据,必须由后端做地区隔离
当前实现状态:
- 后端统计接口、登录补数、评查触发人补数、RBAC 与 SQL 已落地
- SQL 已统一整理到 `scripts/创建sql/`
- 上线与验收入口文档统一看:
- `scripts/创建sql/README.md`
- `docs/系统使用统计/系统使用统计实施版.md`
---
## 三、当前业务逻辑口径
@@ -294,6 +320,8 @@
| `fastapi_modules/fastapi_leaudit/controllers/evaluationPointController.py` | 评查点主数据 v3 接口 |
| `fastapi_modules/fastapi_leaudit/services/impl/evaluationPointServiceImpl.py` | 评查点列表/详情/增删改 |
| `fastapi_modules/fastapi_leaudit/services/impl/ruleServiceImpl.py` | 规则集列表、可用规则数、规则文件校验 |
| `fastapi_modules/fastapi_leaudit/controllers/usageStatsController.py` | 系统使用统计接口 |
| `fastapi_modules/fastapi_leaudit/services/impl/usageStatsServiceImpl.py` | 登录统计写入、总览/部门/地区统计查询 |
### 前端
@@ -345,7 +373,12 @@
- 明确提示“哪个规则集不可用 / 哪个入口模块配置异常 / 当前文档类型没有可用规则数”
- 避免只弹统一 400/500
4. 继续清理文档与代码中的旧术语
4. 系统使用统计前端继续按“一期三视角”联调
- 只优先保证“总览 + 按部门 + 按地区”整体可用
- 先不要继续扩展复杂驾驶舱、全量明细审计、额外统计口径页面
- 所有实现口径统一以 `docs/系统使用统计/系统使用统计最终版.md` 为准
5. 继续清理文档与代码中的旧术语
- `可用版本` 统一改为 `可用规则数`
- 避免“规则组 / 分组 / 规则集 / 评查点”混用造成误解
@@ -409,6 +442,8 @@
- `docs/README.md`:后端 `/docs` 总导航
- `docs/迁移与兼容/旧接口文档导航.md`:接口文档导航
- `docs/权限与地区隔离/权限与地区隔离文档导航.md`:权限主线导航
- `docs/系统使用统计/系统使用统计最终版.md`:系统使用统计业务口径
- `docs/系统使用统计/系统使用统计实施版.md`:系统使用统计实施与上线口径
- `docs/leaudit/README.md`:后端架构主线
- `docs/规则编辑/README.md`:规则链路主线
- `new_doc_review/docs/route-alias-guidelines.md`:前端子页权限映射规范