| 项目 | 内容描述 |
| 用例名称 | 统一身份登录 |
| 用例编号 | UC-AUTH-01 |
| 主要参与者 | 学生、教师、管理员、认证服务 |
| 前置条件 | 用户已注册账号；网络连接正常。 |
| 后置条件 | 客户端获取有效令牌(Token)；系统建立会话白名单；发布“用户已登录”事件。 |
| 基本事件流 | 1.用户在登录页输入账号和密码。 2.前端对密码进行加密预处理并发送请求。 3.系统验证凭证正确性（比对数据库中的加密密文）。 4.系统调用 UC-AUTH-03 （风险检测）评估当前登录环境。 5.若无风险，系统生成身份令牌（包含用户ID、角色、有效期）。 6.系统将令牌存入会话存储，并强制踢出超限设备（如限制单用户 3 设备）。 7.系统向消息中心发布“用户已登录”事件（含 IP、时间戳）。 8.系统返回令牌，前端跳转至仪表盘。 |
| 扩展事件流 | 若风险检测判定为高危（如异地登录）： 1.系统中断标准流程，转入 UC-AUTH-04 (MFA 二次验证）。 2.验证通过后，继续执行步骤 5。 若密码连续错误超过 5 次： 1.系统锁定该账号 15 分钟。 2.返回“账号已冻结”提示。 |
| 特殊需求 | 登录接口响应需包含next_action字段，指示前端是否需要进行 MFA 或强制改密。 |
| 非功能需求关联 | 安全性 NF-SEC-01（密码传输加密）；性能 NF-PER-02（登录响应 < 500ms）。 |
| 项目 | 内容描述 |
| 用例名称 | 风险检测 |
| 用例编号 | UC-AUTH-03 |
| 主要参与者 | 认证服务 （系统后台） |
| 前置条件 | 用户凭证已校验通过，但尚未签发 Token。 |
| 后置条件 | 返回风险等级（低/中/高）及具体风险标签。 |
| 基本事件流 | 1.系统提取当前请求的 IP 地址，解析地理位置。 2.系统提取浏览器指纹（User-Agent + Canvas特征）。 3.系统查询缓存中该用户最近一次登录的 IP 和设备信息。 4.规则匹配： －计算地理位置距离：若距离 > 100km且时间差 < 1h，标记为异地。 －比对设备指纹：若为全新设备，标记为新设备。 5.返回风险评估结果。 |
| 扩展事件流 | 若 IP 在黑名单库中： 直接返回“High Risk - Blocked”，阻断登录。 |
| 特殊需求 | IP 库需定期更新；指纹计算需在前端完成并加密传输。 |
| 非功能需求关联 | 性能 NF-PER-03（风控计算延迟 < 100ms）。 |
| 项目 | 内容描述 |
| 用例名称 | 每日连胜检查 |
| 用例编号 | UC-GAME-01 |
| 主要参与者 | 学生、激励引擎 |
| 前置条件 | 监听到系统发布的“用户已登录”事件。 |
| 后置条件 | 用户连胜天数更新，触发奖励发放。 |
| 基本事件流 | 1.激励引擎消费登录事件。 2.计算当前日期在年份中的索引 (Day of Year)。 3.读取用户的历史签到记录状态。 4.检查昨日状态： 判断“昨天”是否已签到。 5.连胜逻辑： - 若昨日已签到：执行连胜计数 +1。 - 若昨日未签到：重置连胜计数为 1。 6.将“今日”的状态标记为已签到。 7.若连胜天数达到里程碑（如 3, 7, 30天），触发 UC-GAME-05 （勋章结算）。 |
| 扩展事件流 | 今日已登录过（重复事件）： 检测到今日状态已为签到，直接忽略，不执行计算。 |
| 特殊需求 | 必须处理跨年场景的连胜计算（如1月1日需检查12月31日）。 |
| 非功能需求关联 | 性能 NF-PER-05（事件处理吞吐量 > 5000TPS）。 |
| 项目 | 内容描述 |
| 用例名称 | 触发红色预警 |
| 用例编号 | UC-RISK-01 |
| 主要参与者 | 风险教研引擎 |
| 前置条件 | 实时计算作业正在运行，持续消费学习行为流。 |
| 后置条件 | 生成预警记录，推送到教师端待办列表。并为教师生成个性化干预建议（推荐习题/微课）。 |
| 基本事件流 | 1.数据聚合：引擎按用户维度聚合最近 7 天的行为数据。 2.规则判定： －活跃度检测：连续 7 天无登录记录。 －掌握度检测：模型预测当前知识点掌握概率 < 60%。 3.若满足上述任一条件，系统标记该学生为“高危 (Red Risk)”。 4.写入预警记录表，记录触发原因代码。 5.通过消息通道向该生的辅导员/教师发送实时通知。并结合AI助教分析，向教师推送针对该学生的个性化补救资源建议（如推荐特定章节的强化训练），供教师一键推送。 |
| 扩展事件流 | 数据不足（冷启动）： 若学生为新生且行为数据稀疏，不触发预警，标记为“观察期”。 |
| 特殊需求 | 预警算法需支持“防抖动”，避免同一天内重复报警。 |
| 非功能需求关联 | 实时性NF-RTM-01（从行为发生到预警触发延迟 < 5分钟）。 |
| 用例名称 | 执行 A/B 测试验证 |
| 用例编号 | UC-RISK-07 |
| 主要参与者 | 风险教研引擎 |
| 前置条件 | 资源存在 v1.0 (旧) 和 v1.1 (新) 两个版本。 |
| 后置条件 | 确定新版本是否胜出，并执行全量发布或回滚。 |
| 基本事件流 | 1.系统配置流量分配策略：10%学生访问 v1.1，90% 访问 v1.0。 2.持续运行 48 小时，分别收集两组的 CHI (健康度) 数据。 3.效果对比： - 若 v1.1 的 CHI 显著高于 v1.0（提升 > 5%）：判定胜出。 - 否则：判定失败。 4.胜出：系统自动将流量切换为 100% v1.1。 5.失败：系统自动回滚至 v1.0，并通知教师“迭代无效”。 |
| 扩展事件流 | 样本量不足： 若不足以产生统计显著性，延长测试时间或扩大流量比例至 30%。 |
| 特殊需求 | 同一学生在测试期间必须始终看到同一个版本（会话粘滞）。 |
| 非功能需求关联 | 可测试性 NF-TST-01（支持灰度路由）。 |
| 项目 | 内容描述 |
| 用例名称 | 智能路由匹配 |
| 用例编号 | UC-SOC-03 |
| 主要参与者 | 路由引擎 |
| 前置条件 | 收到求助请求；在线用户池不为空。 |
| 后置条件 | 锁定最佳候选人列表。 |
| 基本事件流 | 1.筛选候选人： －在线：在在线用户池中。 －能力：已点亮该知识点节点。 －角色：排除求助者自己。 2.计算匹配分 (Score)： Score =影响力 * 0.5 + 响应速度 * 0.3 + 知识掌握度 * 0.2。 3.按 Score 降序排列，生成候选队列。 4.将请求发送给队列首位的候选人。 |
| 扩展事件流 | 无合格候选人在线： 1.将请求转入异步论坛发帖模式。 2.通知求助者“暂无学霸在线，已转论坛”。 |
| 特殊需求 | 避免路由给刚刚拒绝过求助的用户。 |
| 非功能需求关联 | 效率 NF-EFF-01（匹配计算耗时 < 500ms）。 |
| 项目 | 内容描述 |
| 用例名称 | 评价与影响力结算 |
| 用例编号 | UC-SOC-06 |
| 主要参与者 | 学生 (求助者)、路由引擎 |
| 前置条件 | 互助会话结束。 |
| 后置条件 | 积分转移，影响力分更新。 |
| 基本事件流 | 1.求助者对解答质量进行评分（1-5星）和标签（如“耐心”“大牛”）。 2.结算：解冻积分，转入互助者账户。 3.若评分为 5 星，额外奖励系统积分。 4.更新画像： - 重新计算互助者的影响力 (Influence)。 - Influence = 旧值 + (评分 * 权重)。 5.若影响力升级，触发勋章颁发。 |
| 扩展事件流 | 求助者恶意差评（如1星无理由）： 互助者可申诉，进入UC-SOC-08 (争议仲裁)流程。 |
| 特殊需求 | 评分需去除“互刷”嫌疑（如同两人频繁互评）。 |
| 非功能需求关联 | 公平性 NF-FAI-01。 |
X=S)c=rHd7=>bo;oiUdf&
z3jv4A68z%yc?os*uq3aSDbNWtUf2e%O%-dvJoJA@<@u>|fvfFoEeVhS36KB@kN^pg
z011!)36KB@1X2PHCCs?JdM(elt&>DmHHi!Ds}M+7DV@C9v0hwXzWyrL=S4|?1W14c
zNPq-Lz<~&?O?193V*woKhOj9lKmsHX)CoA0Nb}#)Rg$s+hu3`V7hQ^mndHHe6<@m<
zygmt#011!)36KB@kN^pg011!)2?Tipjw8%ya@yc8?ntPp;etGLNAF