AuthSessionMutexContractTest.java 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286
  1. package com.etotem.cfc.unit;
  2. import com.etotem.cfc.dto.LoginResultDTO;
  3. import com.etotem.cfc.service.UserService;
  4. import org.junit.jupiter.api.DisplayName;
  5. import org.junit.jupiter.api.Test;
  6. import java.io.InputStream;
  7. import java.lang.reflect.Field;
  8. import java.lang.reflect.Method;
  9. import java.nio.charset.StandardCharsets;
  10. import java.util.Scanner;
  11. import static org.junit.jupiter.api.Assertions.assertEquals;
  12. import static org.junit.jupiter.api.Assertions.assertTrue;
  13. import static org.junit.jupiter.api.Assertions.fail;
  14. /**
  15. * 契约级单测:多端登录/会话互斥(能力键 {@code auth.session.mutex},S-cfc-301,TDD-RED 阶段)。
  16. *
  17. * <p><b>契约锚点(溯源)</b></p>
  18. * <ul>
  19. * <li>需求:{@code tests/user-scenarios/应用场景总览.md} SC-P-85(多端登录/会话互斥——
  20. * <b>主流程:新设备登录 → 旧设备踢下线/二次验证;边界:异常设备风控;退出清 token</b>);
  21. * {@code tests/user-scenarios/02-parent.md} SC-P-85、用例 TC-P-85。</li>
  22. * <li>设计:{@code docs/superpowers/api/API_REFERENCE.md} §4.1(/api/auth 登录/token 生命周期)、
  23. * §4.63.9(SC-P-85 登录族 + SSO 票据)与契约缺口 <b>G-5</b>(无单端互斥/旧会话踢出,
  24. * JWT 无状态)。</li>
  25. * </ul>
  26. *
  27. * <p><b>实现现状(origin/cfclub @ d6dac931a 实测)</b>:src/main 无任何会话互斥载体 ——
  28. * 无 {@code UserSessionService} 服务类、无 {@code user_session} 表(schema.sql 全库检索 0 命中)、
  29. * {@code LoginResultDTO} 无 {@code sessionId}/{@code secondVerifyRequired} 字段、登录族服务方法
  30. * ({@code UserService.wechatLogin/phoneLogin/silentLogin/ssoLogin/switchRoleForLogin})
  31. * 未注入任何会话登记能力;退出为前端清 JWT(无服务端 logout,{@code SecurityConfig} STATELESS)。
  32. * 会话互斥能力整体未落地(对应设计缺口 G-5)。</p>
  33. *
  34. * <p><b>契约方法签名(实现方按此落地,GREEN 指引)</b></p>
  35. * <ul>
  36. * <li>{@code com.etotem.cfc.service.UserSessionService}:
  37. * {@code String login(Long userId, String deviceId)} —— 新设备登录登记会话,返回 sessionId;
  38. * {@code void kick(Long userId, String excludedSessionId)} —— 老设备会话踢下线(互斥);
  39. * {@code void invalidate(Long userId, String sessionId)} —— 退出清 token(服务端失效);
  40. * {@code boolean isKnownDevice(Long userId, String deviceId)} / {@code RiskResult riskCheck(...)}
  41. * —— 异常设备风控判定。</li>
  42. * <li>{@code LoginResultDTO} 增补:{@code sessionId}(会话定位凭证)、
  43. * {@code secondVerifyRequired}(新设备触发二次验证标记)。</li>
  44. * <li>{@code schema.sql} 增补 {@code user_session} 建表({@code session_id}/{@code user_id}/
  45. * {@code device_id}/{@code status}(active/kicked)/{@code risk_flag})。</li>
  46. * </ul>
  47. *
  48. * <p><b>测试范围</b>:纯契约级单测,反射锚定缺失实现 + schema.sql 静态读取
  49. * (参考 TeamProfitHookContractTest / ChildAuthLoginContractTest 风格),
  50. * 无 Spring / 无 DB / 无外部服务。</p>
  51. *
  52. * <p><b>RED 预期</b>:会话互斥载体整体缺失,下述正常流/边界流/异常流断言应失败(红);
  53. * 权限流为说明性用例(绿)。若实现已意外落地导致全绿,按编排约定交登记,不私改实现。</p>
  54. */
  55. class AuthSessionMutexContractTest {
  56. private static final String USER_SESSION_SERVICE = "com.etotem.cfc.service.UserSessionService";
  57. // ====================================================================
  58. // 正常流(主流程):新设备登录 → 旧设备踢下线
  59. // ====================================================================
  60. @Test
  61. @DisplayName("正常流-1:UserSessionService 会话互斥服务类应存在")
  62. void userSessionService_classExists() {
  63. assertTrue(loadClass(USER_SESSION_SERVICE) != null,
  64. "[auth.session.mutex/SC-P-85] UserSessionService 类不存在:契约要求服务端会话登记/互斥裁决核心"
  65. + "(新设备登录登记会话 → 旧设备踢下线,SC-P-85 主流程)。当前 src/main 无任何会话互斥"
  66. + "载体(设计缺口 G-5:JWT 无状态、无单端互斥)。实现未落地。");
  67. }
  68. @Test
  69. @DisplayName("正常流-2:UserSessionService 应提供 login(登记新会话)与 kick/invalidate(旧会话踢下线)入口")
  70. void userSessionService_hasLoginAndKickMethods() {
  71. Class<?> clazz = loadClass(USER_SESSION_SERVICE);
  72. if (clazz == null) {
  73. fail("[auth.session.mutex/SC-P-85] UserSessionService 类不存在,无法验证 login/kick 入口"
  74. + "(新设备登录 → 旧设备踢下线,SC-P-85 主流程)。实现未落地。");
  75. }
  76. boolean hasLogin = hasMethodNamed(clazz, "login");
  77. boolean hasKick = hasMethodNamed(clazz, "kick")
  78. || hasMethodNamed(clazz, "invalidate")
  79. || hasMethodNamed(clazz, "logout");
  80. assertTrue(hasLogin,
  81. "[auth.session.mutex/SC-P-85] UserSessionService 应提供 login(...) 在每次登录时登记新会话"
  82. + "(新设备登录触发,SC-P-85 主流程)。实现未落地。");
  83. assertTrue(hasKick,
  84. "[auth.session.mutex/SC-P-85] UserSessionService 应提供 kick/invalidate/logout(...) 使旧设备会话"
  85. + "踢下线(同账号仅保留新会话,SC-P-85 主流程)。实现未落地。");
  86. }
  87. @Test
  88. @DisplayName("正常流-3:登录族服务方法应注入 UserSessionService 钩子(登录即登记会话,建立单端互斥)")
  89. void userService_loginFlow_injectsUserSessionService() {
  90. boolean injected = hasFieldOfType(UserService.class, USER_SESSION_SERVICE);
  91. assertTrue(injected,
  92. "[auth.session.mutex/SC-P-85] UserService 登录族方法(wechatLogin/phoneLogin/silentLogin/"
  93. + "ssoLogin/switchRoleForLogin)应注入 UserSessionService 钩子:每次登录登记新会话并使旧会话"
  94. + "失效(新设备登录 → 旧设备踢下线,SC-P-85 主流程;当前登录只签发 JWT,无会话维度)。"
  95. + "实现未落地。");
  96. }
  97. // ====================================================================
  98. // 边界流:二次验证 / 退出清 token(旧设备踢下线结果需可观测、可失效)
  99. // ====================================================================
  100. @Test
  101. @DisplayName("边界流-1:LoginResultDTO 应携带 sessionId 与 secondVerifyRequired(二次验证标记)")
  102. void loginResultDto_carriesSessionContext() {
  103. assertTrue(hasField(LoginResultDTO.class, "sessionId"),
  104. "[auth.session.mutex/SC-P-85] LoginResultDTO 应携带 sessionId:登录返回的会话定位凭证,"
  105. + "供前端 logout/被踢下线时定位会话(SC-P-85 主流程+退出清 token)。"
  106. + "当前 LoginResultDTO 无任何会话字段。实现未落地。");
  107. assertTrue(hasField(LoginResultDTO.class, "secondVerifyRequired"),
  108. "[auth.session.mutex/SC-P-85] LoginResultDTO 应携带 secondVerifyRequired:新设备登录时服务端"
  109. + "可裁决「踢下线」或「二次验证」两种互斥策略(SC-P-85 主流程)。当前缺失。实现未落地。");
  110. }
  111. @Test
  112. @DisplayName("边界流-2:schema.sql 应有 user_session 会话登记表(承载旧设备踢下线结果)")
  113. void schemaSql_hasUserSessionTable() {
  114. assertTrue(readSchemaSql().contains("user_session"),
  115. "[auth.session.mutex/SC-P-85] schema.sql 应含 user_session 建表:服务端会话登记载体,"
  116. + "记录每次登录的会话/设备,旧设备踢下线结果(status)可被判定与清理(SC-P-85 主流程+"
  117. + "退出清 token)。当前 schema.sql 无该表(仅 users.session_key、butler_sessions 等非认证"
  118. + "会话表)。实现未落地。");
  119. }
  120. @Test
  121. @DisplayName("边界流-3:user_session 表应含 session_id/user_id/device_id/status 列(会话唯一标识与互斥状态)")
  122. void userSessionTable_hasSessionColumns() {
  123. String block = userSessionTableBlock();
  124. assertTrue(block.contains("session_id"),
  125. "[auth.session.mutex/SC-P-85] user_session 应含 session_id 列(会话唯一标识,踢除/退出的定位键)。"
  126. + "实现未落地。");
  127. assertTrue(block.contains("user_id"),
  128. "[auth.session.mutex/SC-P-85] user_session 应含 user_id 列(会话归属账号,互斥的粒度基准)。"
  129. + "实现未落地。");
  130. assertTrue(block.contains("device_id"),
  131. "[auth.session.mutex/SC-P-85] user_session 应含 device_id 列(设备维度,区分新旧设备登录)。"
  132. + "实现未落地。");
  133. assertTrue(block.contains("status"),
  134. "[auth.session.mutex/SC-P-85] user_session 应含 status 列(active/kicked 等会话状态,"
  135. + "承载「旧设备踢下线」结果判定)。实现未落地。");
  136. }
  137. @Test
  138. @DisplayName("边界流-4:退出清 token 应服务端失效会话(UserSessionService 提供 logout/invalidate 能力)")
  139. void userSessionService_hasLogoutInvalidateCapability() {
  140. Class<?> clazz = loadClass(USER_SESSION_SERVICE);
  141. boolean hasLogout = false;
  142. if (clazz != null) {
  143. for (Method m : clazz.getDeclaredMethods()) {
  144. String n = m.getName().toLowerCase();
  145. if (n.contains("logout") || n.contains("invalidate") || n.contains("revoke")) {
  146. hasLogout = true;
  147. break;
  148. }
  149. }
  150. }
  151. assertTrue(clazz != null && hasLogout,
  152. "[auth.session.mutex/SC-P-85] 退出清 token:UserSessionService 应提供 logout/invalidate/revoke"
  153. + "方法使服务端会话失效(SC-P-85 边界:退出清 token;当前退出为前端清 JWT,"
  154. + "SecurityConfig.logout().disable(),无服务端会话可清。设计缺口 G-5)。实现未落地。");
  155. }
  156. // ====================================================================
  157. // 异常/风险流:异常设备风控
  158. // ====================================================================
  159. @Test
  160. @DisplayName("异常流-1:UserSessionService 应提供异常设备风控判定能力")
  161. void userSessionService_hasRiskControlJudgment() {
  162. Class<?> clazz = loadClass(USER_SESSION_SERVICE);
  163. boolean hasRisk = false;
  164. if (clazz != null) {
  165. for (Method m : clazz.getDeclaredMethods()) {
  166. String n = m.getName().toLowerCase();
  167. if (n.contains("risk") || n.contains("abnormal") || n.contains("known")) {
  168. hasRisk = true;
  169. break;
  170. }
  171. }
  172. }
  173. assertTrue(clazz != null && hasRisk,
  174. "[auth.session.mutex/SC-P-85] UserSessionService 应提供异常设备风控判定方法 "
  175. + "(如 isKnownDevice/riskCheck:陌生/高风险设备登录 → 二次验证或拦截,SC-P-85 异常/边界)。"
  176. + "当前服务类不存在。实现未落地。");
  177. }
  178. @Test
  179. @DisplayName("异常流-2:user_session 表应有风险标记列(risk_flag,异常设备风控结果落库)")
  180. void userSessionTable_hasRiskControlColumn() {
  181. String block = userSessionTableBlock();
  182. assertTrue(block.contains("risk_flag") || block.contains("risk"),
  183. "[auth.session.mutex/SC-P-85] user_session 应含 risk_flag(或等价风险标记)列:异常设备风控结论"
  184. + "落库,供二次验证/拦截策略判定(SC-P-85 异常/边界:异常设备风控)。实现未落地。");
  185. }
  186. // ====================================================================
  187. // 权限流(适用性说明)
  188. // ====================================================================
  189. @Test
  190. @DisplayName("权限流:会话互斥为登录链路预检 + 会话生命周期管理,无独立业务权限维度")
  191. void permissionFlow_sessionMutexIsAuthLifecycle() {
  192. // 说明性用例:登录会话登记/踢下线发生在登录准入与登出生命周期(匿名可触达 → 登录后自管理),
  193. // 无独立于认证本身的业务权限维度(与 TeamProfitHookContractTest.permissionFlow_notApplicable 同风格)。
  194. assertTrue(true, "权限流说明:auth.session.mutex 属认证生命周期能力,权限随 JWT 认证本身,无独立权限断言。");
  195. }
  196. // ====================================================================
  197. // 反射 / 静态资源辅助
  198. // ====================================================================
  199. private Class<?> loadClass(String name) {
  200. try {
  201. return Class.forName(name, false, Thread.currentThread().getContextClassLoader());
  202. } catch (ClassNotFoundException e) {
  203. return null;
  204. }
  205. }
  206. private boolean hasMethodNamed(Class<?> clazz, String name) {
  207. for (Method m : clazz.getDeclaredMethods()) {
  208. if (m.getName().equals(name)) {
  209. return true;
  210. }
  211. }
  212. return false;
  213. }
  214. private boolean hasField(Class<?> clazz, String name) {
  215. for (Field f : clazz.getDeclaredFields()) {
  216. if (f.getName().equals(name)) {
  217. return true;
  218. }
  219. }
  220. return false;
  221. }
  222. private boolean hasFieldOfType(Class<?> clazz, String fieldTypeFqcn) {
  223. for (Field f : clazz.getDeclaredFields()) {
  224. if (fieldTypeFqcn.equals(f.getType().getName())) {
  225. return true;
  226. }
  227. }
  228. return false;
  229. }
  230. /** 截取 schema.sql 中 user_session 建表块(起始于其前最近的 CREATE TABLE,止于首个 ");")。 */
  231. private String userSessionTableBlock() {
  232. String schema = readSchemaSql();
  233. int idx = schema.indexOf("user_session");
  234. if (idx < 0) {
  235. return "";
  236. }
  237. int start = schema.lastIndexOf("CREATE TABLE", idx);
  238. if (start < 0) {
  239. return "";
  240. }
  241. int end = schema.indexOf(");", idx);
  242. if (end < 0) {
  243. return "";
  244. }
  245. return schema.substring(start, end + 2);
  246. }
  247. private String readSchemaSql() {
  248. try (InputStream is = getClass().getClassLoader().getResourceAsStream("schema.sql")) {
  249. if (is == null) {
  250. return "";
  251. }
  252. try (Scanner scanner = new Scanner(is, StandardCharsets.UTF_8.name())) {
  253. scanner.useDelimiter("\\A");
  254. return scanner.hasNext() ? scanner.next() : "";
  255. }
  256. } catch (Exception e) {
  257. return "";
  258. }
  259. }
  260. }