xiaotutongxue

lovife/xiaotutongxue

Fork 0

Commit Graph

Author	SHA1	Message	Date
lovife	1f3c485ceb	feat(role,scope)!: 角色与授权可配 + 需求收敛（4 角色 / 10 菜单 / 删两模块）角色与授权（交接摘要 §一·三十五）： - 权限判定合并两个来源：内置角色按代码（BuiltinRole）、自定义角色按库（sys_role_permission）。实现放 module 层的 DbRoleGrantSource，security 只依赖接口 RoleGrantSource —— 否则角色服务要调 permissionChecker，两个包迟早成环 - 权限判定必须加缓存：此前是零 IO，而压测基线是"SQL 条数恒定"。缓存放 Redis，空结果也缓存（否则已删角色的 token 会把库打穿）、Redis 挂了退化成直读库、TTL 只兜底 - V18 建 sys_role.user_type（账号的 user_type 一直从角色反推，自定义角色不在代码映射里）与 sys_role_menu；8 个接口 + 错误码 40045；契约 119 -> 129 - 内置角色只读（权限码是前后端契约，做成可改 = 一次误操作就能把管理员锁在系统外）；平台级能力两道防线（界面禁用 + 服务端 40301）；防自锁；改完立即生效（写授权清缓存） - RoleProvisioner 从"已存在就 continue"改成幂等回填 + 每日 03:20 定时任务 —— 修的是"代码改了权限、已开通租户永远停在发放那一刻"，这种漂移不报错也没测试会红 - scripts/e2e-m10-role.py 77/77 需求收敛（交接摘要 §一·三十六，本节的数字为准）： - 删副班主任 / 审核员两个内置角色（6 -> 4）、历史整理器（module/cleanup）、加入申请（module/join + 学生端 pages/join）、collect_task_org.deputy_user_ids 整列；审核范围三级回退 -> 两级，连带 6 个 mapper 的 LIKE '%,id,%' 分支 - V19 迁移处理存量：先解 sys_user_role 绑定再软删角色；账号只在"除这两个角色外没有别的角色"时才软删。必须迁而不能只删代码 —— 角色码删掉后 mergePermissions 返回空集，存量账号会"能登录、处处 40301"，不抛异常不打日志 - 契约 129 -> 119、错误码 59 -> 54、权限码 30 -> 28、PC 菜单 12 -> 10、小程序页 10 -> 9、原型 32 -> 29 屏、E2E 39 -> 37 个（断言 1695 条） - UserService.list 对不认识的角色码由"静默丢掉过滤条件"改成失败关闭（之前传个不存在的 roleCode 会返回全校账号，且看起来完全正常） - 品牌元信息同步改名「深学在线」：pom 名称、/doc.html 标题、配置与启动类注释、存储自检探针内容；学生端 app 名与全局导航栏标题	2026-10-10 16:48:54 +08:00
lovife	8f80744d63	feat(task): 规则模板 FORM 真正可套用 + 已归档任务可删（客户确认的两项）一、规则模板的 FORM 部分（F-57/F-64）—— 此前只能「跳过并说明」，等于装饰 · FormSchemaService.saveRawVersion：用已存在的 schemaJson 存为新版本。与手工保存的区别：内容不再校验/归一化（它当初就是按本服务规则存出来的，再走一遍解析→序列化只会丢未建模字段）；状态检查与版本管理保留 —— 版本化逻辑只有一份 · RuleTemplateService 的 FORM 分支接上它（不再 skipped） · 顺带补上另一半：saveAsTemplate 此前不存表单（存模板不存、套模板用不上，两头各缺一半）—— 现在把源任务的当前表单一并带走；没存过 = null = 套用时按「用系统默认，不覆盖」跳过二、已归档任务可删（F-14 / §17.2 D-9）—— 此前「已发布即删不掉」，演示/测试任务只能改名挪开，库只增不减 · DELETE /tasks/{id} 支持 status=3：收集中/已截止仍拒（归档是最后的后悔药），拒绝的话说清「先归档」 · 子表级联物理删 14 张表（TaskCascadeMapper 集中放置，表清单来自 information_schema 的事实核对）—— 大头是名册（证件号密文）、材料、审核记录 · ★ 任务行本身软删：它必须占住 task_code —— maxSeqByCodePrefix 靠「含软删行的最大序号」保证编码永不复用（编码同时是文件目录名，重号会把两批任务的文件混进同一目录）。第一版做成了物理删，e2e-m1-task 的「编码递增」断言当场抓到重号 —— 这条回归现在被 e2e-m1-task-delete 的「删除后新建不重号」断言守住 · 物理文件尽力删（先取路径再删行，顺序反了文件就永远留在磁盘上；删不掉只记日志不阻断）；全程留痕（sys_operation_log 记 DELETE_TASK + 行数/文件数）验证：e2e-m7-taskconfig → 75/75（新增 FORM 完整链路 7 条断言） e2e-m1-task-delete（新增）→ 20/20（拒删/删净/占号软删/留痕/再删报错/草稿直删） e2e-m1-task → 71/71（旧口径断言更新为新口径）	2026-09-30 12:38:47 +08:00
lovife	30c3714d35	test(scripts): 36 个 E2E 与 6 个机械校验工具（1548 条断言）+ 一键交付自检新增：check-api-parity（契约 121 接口 ↔ 控制器，自带「必须恰好 121」自检）、 check-entity-columns（基类要求的列 vs 迁移建表列，F-35 那个坑踩了四次之后上的工具）、 check-manual（手册引用的错误码与提示文案对得上代码）、check-test-profile（test profile 真起一次）、 e2e-prodguard、load-test（四场景、按端点分别统计）、verify-all（一条命令跑完交付自检）、 dev-seed-audit（界面验收用的演示数据），以及 M1~M9 各轮 E2E。压测抓到一个真缺陷并修掉（F-92）：门禁 IP 限流原来计「所有请求」，于是一个班连同一个 WiFi 时 60 个不同学生同时核验只过了 20 个 → 改为只计失败 + 单独的成功上限，20/60 → 60/60。度量工具的偏差会伪装成产品缺陷（F-60/F-77/F-97），所以每个脚本都断言「动作自己的结论字段」（submitted / created / canExport），而不是 HTTP 200 + code 0。验证：verify-all.py --quick 5/5；--with-e2e 见 docs/09 §8。	2026-09-30 09:02:57 +08:00

Author

SHA1

Message

Date

lovife

1f3c485ceb

feat(role,scope)!: 角色与授权可配 + 需求收敛（4 角色 / 10 菜单 / 删两模块）

角色与授权（交接摘要 §一·三十五）：
- 权限判定合并两个来源：内置角色按代码（BuiltinRole）、自定义角色按库
  （sys_role_permission）。实现放 module 层的 DbRoleGrantSource，security 只依赖
  接口 RoleGrantSource —— 否则角色服务要调 permissionChecker，两个包迟早成环
- 权限判定必须加缓存：此前是零 IO，而压测基线是"SQL 条数恒定"。缓存放 Redis，
  空结果也缓存（否则已删角色的 token 会把库打穿）、Redis 挂了退化成直读库、TTL 只兜底
- V18 建 sys_role.user_type（账号的 user_type 一直从角色反推，自定义角色不在代码映射里）
  与 sys_role_menu；8 个接口 + 错误码 40045；契约 119 -> 129
- 内置角色只读（权限码是前后端契约，做成可改 = 一次误操作就能把管理员锁在系统外）；
  平台级能力两道防线（界面禁用 + 服务端 40301）；防自锁；改完立即生效（写授权清缓存）
- RoleProvisioner 从"已存在就 continue"改成幂等回填 + 每日 03:20 定时任务 ——
  修的是"代码改了权限、已开通租户永远停在发放那一刻"，这种漂移不报错也没测试会红
- scripts/e2e-m10-role.py 77/77

需求收敛（交接摘要 §一·三十六，本节的数字为准）：
- 删副班主任 / 审核员两个内置角色（6 -> 4）、历史整理器（module/cleanup）、
  加入申请（module/join + 学生端 pages/join）、collect_task_org.deputy_user_ids 整列；
  审核范围三级回退 -> 两级，连带 6 个 mapper 的 LIKE '%,id,%' 分支
- V19 迁移处理存量：先解 sys_user_role 绑定再软删角色；账号只在"除这两个角色外没有
  别的角色"时才软删。必须迁而不能只删代码 —— 角色码删掉后 mergePermissions 返回空集，
  存量账号会"能登录、处处 40301"，不抛异常不打日志
- 契约 129 -> 119、错误码 59 -> 54、权限码 30 -> 28、PC 菜单 12 -> 10、
  小程序页 10 -> 9、原型 32 -> 29 屏、E2E 39 -> 37 个（断言 1695 条）
- UserService.list 对不认识的角色码由"静默丢掉过滤条件"改成失败关闭
  （之前传个不存在的 roleCode 会返回全校账号，且看起来完全正常）
- 品牌元信息同步改名「深学在线」：pom 名称、/doc.html 标题、配置与启动类注释、
  存储自检探针内容；学生端 app 名与全局导航栏标题

2026-10-10 16:48:54 +08:00

lovife

8f80744d63

feat(task): 规则模板 FORM 真正可套用 + 已归档任务可删（客户确认的两项）

一、规则模板的 FORM 部分（F-57/F-64）—— 此前只能「跳过并说明」，等于装饰
  · FormSchemaService.saveRawVersion：用已存在的 schemaJson 存为新版本。
    与手工保存的区别：内容不再校验/归一化（它当初就是按本服务规则存出来的，
    再走一遍解析→序列化只会丢未建模字段）；状态检查与版本管理保留 —— 版本化
    逻辑只有一份
  · RuleTemplateService 的 FORM 分支接上它（不再 skipped）
  · 顺带补上另一半：saveAsTemplate 此前不存表单（存模板不存、套模板用不上，
    两头各缺一半）—— 现在把源任务的当前表单一并带走；没存过 = null =
    套用时按「用系统默认，不覆盖」跳过

二、已归档任务可删（F-14 / §17.2 D-9）—— 此前「已发布即删不掉」，
   演示/测试任务只能改名挪开，库只增不减
  · DELETE /tasks/{id} 支持 status=3：收集中/已截止仍拒（归档是最后的后悔药），
    拒绝的话说清「先归档」
  · 子表级联物理删 14 张表（TaskCascadeMapper 集中放置，表清单来自
    information_schema 的事实核对）—— 大头是名册（证件号密文）、材料、审核记录
  · ★ 任务行本身**软删**：它必须占住 task_code —— maxSeqByCodePrefix 靠
    「含软删行的最大序号」保证编码永不复用（编码同时是文件目录名，重号会把
    两批任务的文件混进同一目录）。第一版做成了物理删，e2e-m1-task 的
    「编码递增」断言当场抓到重号 —— 这条回归现在被 e2e-m1-task-delete
    的「删除后新建不重号」断言守住
  · 物理文件尽力删（先取路径再删行，顺序反了文件就永远留在磁盘上；
    删不掉只记日志不阻断）；全程留痕（sys_operation_log 记 DELETE_TASK +
    行数/文件数）

验证：e2e-m7-taskconfig → 75/75（新增 FORM 完整链路 7 条断言）
      e2e-m1-task-delete（新增）→ 20/20（拒删/删净/占号软删/留痕/再删报错/草稿直删）
      e2e-m1-task → 71/71（旧口径断言更新为新口径）

2026-09-30 12:38:47 +08:00

lovife

30c3714d35

test(scripts): 36 个 E2E 与 6 个机械校验工具（1548 条断言）+ 一键交付自检

新增：check-api-parity（契约 121 接口 ↔ 控制器，自带「必须恰好 121」自检）、
check-entity-columns（基类要求的列 vs 迁移建表列，F-35 那个坑踩了四次之后上的工具）、
check-manual（手册引用的错误码与提示文案对得上代码）、check-test-profile（test profile 真起一次）、
e2e-prodguard、load-test（四场景、按端点分别统计）、verify-all（一条命令跑完交付自检）、
dev-seed-audit（界面验收用的演示数据），以及 M1~M9 各轮 E2E。

压测抓到一个真缺陷并修掉（F-92）：门禁 IP 限流原来计「所有请求」，于是一个班连同一个
WiFi 时 60 个不同学生同时核验只过了 20 个 → 改为只计失败 + 单独的成功上限，20/60 → 60/60。

度量工具的偏差会伪装成产品缺陷（F-60/F-77/F-97），所以每个脚本都断言「动作自己的结论字段」
（submitted / created / canExport），而不是 HTTP 200 + code 0。

验证：verify-all.py --quick 5/5；--with-e2e 见 docs/09 §8。

2026-09-30 09:02:57 +08:00

3 Commits