5.3 KiB
5.3 KiB
系统能力模型总结 — 道路救援企业培训系统
版本:V1.0 | 生成日期:2026-04-07 证据来源:[SRC-FEAT-01] [SRC-API-01] [SRC-CODE-01]
1. 当前系统具备的核心能力
| # | 能力名称 | 一句话描述 |
|---|---|---|
| C1 | 基于角色的访问控制(RBAC) | 三种角色(管理员/讲师/学员)+ 部门级数据隔离,统一鉴权入口 |
| C2 | 组织与人员管理 | 三级组织结构(中心→部门→小组)+ 用户生命周期管理 |
| C3 | 知识资产管理 | 支持文档/视频两种类型的知识内容创建、状态发布和多级分类 |
| C4 | 学习行为跟踪 | 防刷机制下的真实时长累计和进度记录(视频90%/文档时长判定) |
| C5 | 在线考核 | 题库管理 + 手动/自动组卷 + 在线答题 + 客观题自动判分 |
| C6 | 考试行为管控 | 时间窗口约束 + 次数限制 + 超时自动交卷 + 并发乐观锁保护 |
| C7 | 培训任务编排 | 将知识+考试组织成有时间周期的培训计划,支持必修/选修/必考/选考四维属性 |
| C8 | 培训进度可视化 | 实时计算学员对某培训计划的完成百分比(必修完成+必考通过) |
| C9 | 成绩与排名 | 交卷后立即返回成绩+答案解析+实时排名(窗口函数,同分按时间早优先) |
| C10 | 企业微信身份集成 | OAuth 登录打通企业微信用户体系,无需单独注册 |
2. 能力依赖关系图
graph TD
C10[C10 企业微信身份集成] --> C1
C1[C1 RBAC + 部门隔离] --> C2
C1 --> C3
C1 --> C5
C1 --> C7
C2[C2 组织人员管理] --> C7
C3[C3 知识资产管理] --> C4
C3 --> C7
C4[C4 学习行为跟踪] --> C8
C5[C5 在线考核] --> C6
C5 --> C9
C6[C6 考试行为管控] --> C9
C9[C9 成绩与排名] --> C8
C7[C7 培训任务编排] --> C4
C7 --> C6
C7 --> C8[C8 培训进度可视化]
3. 可复用能力清单
| 能力 | 复用场景 | 复用方式 |
|---|---|---|
| C1 RBAC + 部门隔离 | 企业内任何需要角色权限 + 数据隔离的系统 | 提取 AuthInterceptor + UserContext + department_id 注入框架 |
| C4 学习行为跟踪 | 其他类型内容(音频/直播回放/课件)的学习进度记录 | 抽象 LearningTarget 接口,替换完成判定策略(Strategy 模式) |
| C5 在线考核 | 任意客观题在线测评场景(安全培训/合规考试等) | 题库+试卷+客观题判分为独立子系统,可独立部署 |
| C6 考试行为管控 | 任何有"限时+限次"约束的在线测试 | ExamTakingService 中时间窗口/次数/乐观锁的组合控制逻辑 |
| C9 成绩排名 | 任何需要实时排名的比赛/评测场景 | SQL 窗口函数 DENSE_RANK 模式,按需修改排序条件 |
4. 平台级能力(多业务依赖的底层能力)
C1 — RBAC + 部门数据隔离
- 所有业务模块(知识/考试/培训)均依赖此能力实现权限控制和数据隔离
- 是系统安全性和多租户(多部门)能力的基础
- 扩展方向:目前硬编码三个角色,V2 可改为动态角色配置
C2 — 组织人员管理
- 每个业务操作都需要
department_id、user_id、role三个属性 - 是知识/考试/培训三大域的数据隔离依据来源
- 扩展方向:当前三级固定结构,可抽象为 n 级通用树
C10 — 企业微信身份集成
- 是唯一的用户来源(V1),后续接其他身份源也需通过此层
- 扩展方向:抽象为
IdentityProvider接口,支持插入 SSO/LDAP
5. 业务定制能力(特定场景才需要的能力)
| 能力 | 定制场景 | 为何不是平台级 |
|---|---|---|
| C3 知识资产管理(文档/视频类型) | 救援行业的操作手册、安全规范、视频讲解 | 内容类型固定(文档/视频),换行业可能需要不同类型 |
| C4 学习行为防刷(视频90%/文档时长) | 强制"真实学习"的企业培训场景 | 完成判定规则是业务决策,C端平台通常不这么严格 |
| C6 超时自动交卷 + 乐观锁 | 有严格时长限制的考试 | 休闲测试/知识问答类应用不需要这个复杂度 |
| C7 培训任务编排(必修/选修/必考/选考四维) | 企业有组织要求的培训管理 | 自学平台不需要"强制必修"的约束 |
| C9 成绩排名(DENSE_RANK + 同分按时间) | 部门内部考核的绩效排名 | 无竞争性考核场景(如自我测评)不需要排名 |
6. V2 能力规划缺口
当前 V1.0.1 尚未具备以下能力,是 V2 的扩展方向:
| 缺失能力 | 业务价值 | 实现复杂度 |
|---|---|---|
| 统计报表中心(完成率/通过率/部门排名) | 管理层查看全局培训效果 | 中(新增 statistics 模块,读现有数据) |
| 线下培训签到(扫码签到/签退) | 线上线下混合培训场景 | 中(需硬件支持) |
| 错题本(自动归集错误题目) | 学员针对性复习 | 低(从 exam_record.answers 中提取 correct=false) |
| 知识全文搜索 | 快速查找内容 | 高(需引入 Elasticsearch 或 MySQL FULLTEXT) |
| 奖励体系(积分/勋章/排行榜) | 提升学习积极性 | 中(新增独立模块) |
| 证书管理 | 培训完成凭证 | 低(基于培训计划完成状态生成 PDF) |