 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
|
bb91515590
|
feat(join): B1 名单加入申请 —— 学生提交 + 管理端审批（V7 存 AES 密文）
按契约「服务端转 HMAC、不落明文」设计会写不进名册：collect_roster.id_card_no 是
NOT NULL 的密文列，而申请表只有 hash 与 mask（三条替代路都被排除）。
V7 给 collect_join_request 补 id_card_cipher（与名册同一把密钥/算法），审批时原样搬进名册，
明文全程只在提交请求的内存里存在过。V7 之前的老申请明确提示重新提交，不静默建一条
永远过不了校验的名册行。
另修 F-20：自述班级不能借用姓名规范化（姓名要「张 三」→「张三」，班级名里的空格有意义）。
验证：scripts/e2e-m2-join.py 50/50。
|
2026-09-30 09:02:52 +08:00 |
|
|
lovife
|
465700969a
|
feat(h5): 填报页（三态 + 条件级联 + 失焦自动存草稿）
学生终于能在手机上真正填一份表了。
三态渲染（契约 §9.2）：
locked=true → 只读灰底 + 「如有误请联系班主任」
prefilled=true,locked=false → 可编辑 + 橙字「老师已填，请核对」
其余 → 普通空白
实测：姓名/身份证号/联系电话/报考职业/工种/等级 只读，学历可改并标注来源。
条件级联（visibleWhen）在前端求值，实测正确：
「是否在校生=是」→ 在读学校/所学专业/入学时间 出现；
「是否补考」未填 → 补考三科不出现。
**隐藏 ≠ 清空**：学生把「是否补考」改回"否"，已填的补考科目仍留在草稿里
（万一他改回来）。要不要清空由后端在提交时判断 —— 前端不该替用户做不可逆的事。
保存策略：**失焦即存单个字段**。不做"整表提交"——学生填到一半切出去接电话，
回来整表丢失是最让人恼火的失败。单字段保存的代价是一次请求，
远小于"白填一遍"。
进页面时若还没有草稿会先建一份（否则第一次失焦保存会因 submissionId 为空而静默不存）。
前端拦住只读字段的保存请求（能省一次必然失败的请求），但**服务端那道拒绝才是真的**。
顺带：核验页的「开始填写材料」接上了（带 taskId + scene —— H5 跳转不保留 URL 参数）。
验收：构建产物含 pages-fill-fill；用无头浏览器实测渲染，
三态与两处级联均正确，抬头显示「请在 2026-10-15 前提交」。
|
2026-09-29 11:43:45 +08:00 |
|
|
lovife
|
aa2f7f175c
|
feat(h5): 身份核验页（门禁）—— 学生流程首个可用闭环
学生填材料之前的唯一一道门：姓名 + 身份证号与老师提交的名单核对，
通过后把微信账号与名单里那一行钉死。后面所有材料都归属那个人。
交付：
· pages/verify/verify.vue —— 核验页
· 落地页「开始填报」→ 核验页（带 scene）
· 两页都加 max-width 居中（桌面查看/自动化验证时不至于拉满全屏）
三处刻意的设计：
1) 失败提示不区分"姓名错"还是"号码错"（后端统一 40007），前端也只显示
后端那一句话 —— **不在前端加"可能是身份证号错了"这类推断**。
分开提示等于给出一个身份证号枚举器。
2) 预填项标注「老师已填，请核对」并明确「学生不能改」：报考职业/工种/等级
由老师按报考计划确定（名单里实测 28/28 都有值）。让学生重填只会制造错误，
而报错工种在机构那边是直接不受理。
3) 前端只做"非空 + 长度"这类明显笔误的提示，真正的判定（校验位、名册匹配、
绑定状态）全交给后端。
修掉一个 H5 特有的坑：
**H5 的页面跳转不保留 URL 参数** —— 直接 navigateTo 到核验页的话，
那边读不到 scene、就不知道是哪个任务（小程序没有这个问题）。
所以落地页跳转时显式拼上 scene，核验页再从自己的 URL 里读出来。
验收（全程无头浏览器自动完成，除"微信授权"那一步）。
现在 task 17 已发布（收集中）并带测试名册，手机上可走完整流程。
注：task 17 现在是「收集中」并带 1 行测试名册（张同学 / 361029200912100015），
是我为验证留的演示数据。
|
2026-09-29 11:24:32 +08:00 |
|