refactor(boundary): 跨模块循环依赖清零(8 对 → 0),task→业务 依赖归零

共享内核下沉(跨模块共享的"身份/组织/安全"类型进 common)
- AdminUserEntity/AdminUserMapper、ShopManageGroupEntity/ShopManageGroupMapper → common
- AdminAuthSupport(33 文件 17 模块引用)、JwtService、AuthProperties、DeviceSessionPolicy
  → common/security(原先放在 admin/auth 里,任何模块用一次就多一条跨模块边)

端口化(消费方声明接口、数据方实现)
- task/spi:ResultFileJobHandler 新增 resolveResultFileUrl 钩子(BRAND 特例从 Worker 收回);
  Worker 改为调用 handler.onSuccess(该钩子历史上从未被调用,withdraw 的收尾靠 Worker 里的
  WITHDRAW 特判硬编码——现两者都归位,task 侧不再 import withdraw/brand)
- admin/spi/UserSecretCleanupPort(删除用户级联清理密钥)、notification/spi/ProxyBalancePort
  (代理余额探测)、shopdatacrawl/spi/ManagedShopNamesPort(可管店铺名)
- shopkey/spi/GroupDeletionGuardPort:分组删除守卫改由各业务模块实现(invalidasin/dedupe 两个实现),
  shopkey 不再直连它们的 Mapper

棘轮与量化(2026-09-14 实测)
- ArchitectureBoundaryTest:task→业务 119 → **0**(基线钉死为 0,新增跨模块动作必须走 task/spi)
- 跨模块 import 行数 650 → 605;双向依赖对 8 → **0**(usersecret/permission/shopkey 三向环、
  task↔withdraw、task↔brand、admin↔permission、admin↔usersecret、dedup↔shopkey、
  invalidasin↔shopkey、notification↔usersecret、shopdatacrawl↔shopduplicatecheck 全部拆解)

测试同步:接口契约 8→9、品牌 Handler 钩子契约、worker 的 10 个测试构造实参、通知/管理测试端口化。
mvn test 2881 全绿。
This commit is contained in:
2026-09-14 10:05:04 +08:00
parent f0c677e4c9
commit 96800a2c88
99 changed files with 417 additions and 228 deletions
@@ -34,9 +34,9 @@ class ArchitectureBoundaryTest {
* 本次以实测值 119 为准恢复告警能力;经 git diff 核验,当日的 task 模块改动
* (引用计数按 task 收敛、快照 upsert 缓存、心跳条件更新、锁续期重试等)未新增任何业务依赖。
*/
// 2026-09-14 心跳/陈旧修复/历史清理 SPI 化后实测 6(G5:task 只依赖 task.spi 下接口,
// 业务模块各自实现);继续按棘轮收敛,不允许回升
private static final int TASK_TO_BUSINESS_BASELINE = 6;
// 2026-09-14 心跳/陈旧修复/历史清理/结果文件 URL 全部 SPI 化后,task → 业务 依赖实测为 0。
// 基线钉死为 0:task 只允许依赖 task.spi 下的接口(业务模块各自实现),不允许回升。
private static final int TASK_TO_BUSINESS_BASELINE = 0;
private static volatile JavaClasses cached;
@@ -76,8 +76,9 @@ class ArchitectureBoundaryTest {
void taskToBusinessDependencyDoesNotGrow() {
// 冻结存量:Handler 迁移后 task→业务 依赖已大幅收敛;不允许继续增长
int violations = countViolations(taskRule());
assertTrue(violations >= 1, "task→业务 依赖仍有存量(心跳/清理等待 SPI 化)");
assertTrue(violations <= TASK_TO_BUSINESS_BASELINE,
"task→业务 依赖必须为 0(当前 " + violations + ");跨模块动作 = 在 task/spi 加接口 + 业务模块实现");
assertTrue(violations >= 0,
"task→业务 依赖不得超过基线 " + TASK_TO_BUSINESS_BASELINE + ",当前 " + violations
+ ";新增依赖走 Handler SPI 或先消除存量");
}