docs: consolidate usage stats documentation
This commit is contained in:
+36
-1
@@ -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`:前端子页权限映射规范
|
||||
|
||||
Reference in New Issue
Block a user