xiaotutongxue

lovife/xiaotutongxue

Fork 0

Commit Graph

Author	SHA1	Message	Date
lovife	0bbac7d228	feat(pc,platform): 验收走查修复（平台按学校代管 + 菜单/403/日志范围/分页）客户在验收里点出来的问题，一次改完。两段改动：一、平台运营与租户范围（后端为主） - 新增请求头 X-Tenant-Id：平台运营是唯一跨租户身份，租户拦截器对它整体关掉了过滤，于是「组织架构 / 账号管理 / 工作台」拿到的是所有租户混在一起的数据 —— 而只有一所学校有数据时，它和学校管理员看到的完全一样，看不出错（这是最危险的一点）。现在这些页面必须先选定学校，服务端再把本次请求的租户上下文换成目标租户：只认平台身份（其它身份带头一律忽略）、目标租户必须存在且启用。 - OrgService.tree / UserService.list 补显式 tenant_id 条件（原来只靠拦截器，而拦截器对平台不生效）；TaskService.seesWholeTenant 改用新的 LoginUser.isPlatformStaff() —— isPlatformAdmin 回答"当前租户是不是平台租户"，代管时它为 false，会让平台退化成普通用户（任务列表掉进"班主任只看自己带的班"分支，得到空列表）；PLATFORM_ADMIN 补 TASK_VIEW（PRD §3.2「查看填报进度看板：平台运营 ✅」）。 - 操作日志对平台永远是空的：SQL 写死 tenant_id = 当前租户，而平台的 tenantId 是 0。按契约 §13.4 补 tenantId 参数与 log:viewAll：平台默认看全量、可指定某所学校；学校管理员恒为本租户，传别家返回 40301（不静默忽略，否则会让人以为"筛过了"）。 - 开放接口"推送重试"从未生效（F-112）：定时扫描缺 @InterceptorIgnore，异常被 log.warn 吞掉；同一方法里"接入方已停用"那条 update 也没有租户上下文，会每 10 秒重试到永远。 E2E 补了"真的重试了"的断言（原来只断言"安排了下次重试"）。二、PC 端走查体验 - 去掉 3 条无用菜单（名单管理 / 表单设计器 / 材料规则）：功能都在「收集任务」行内入口，菜单里那一条点进去只有指路；后端菜单键同步删除，entryAt 那套机制一并删掉。 - 班主任点工作台必弹 403：工作台无条件调了要 org:view / progress:viewAll 的两个接口。 403 走 HTTP 状态码，try/catch 拦不住它的弹窗 —— 改成按权限决定发不发请求。 - 操作日志：分页器被裁在可视区外（新增 .g-list-card 让表体自己滚、表头钉住、分页器留在卡片底部）+ 去掉页面上那段免责声明；收集任务的状态切换改成单独一行 tab；去掉顶栏假数据铃铛；配色按客户要求还原。顺带修两处"检查器自己不严"：check-wiring 新增第 ⑦ 项（PC 端引用的权限码必须存在于 PermissionDef —— 本轮我自己把 progress:viewAll 写成 progress:view:all，判断恒为 false，而编译 / typecheck / lint / E2E 全都不红）；verify-docs 的表格列数检查不再把 GFM 转义竖线当成列分隔符。两个检查器都拿"故意写错的样例"试过，确认真的会红。验证：typecheck / mvn package / check-wiring（未接线声明 0 条）/ verify-docs（22 项）全过； e2e-m0 36、e2e-m1-orgs 48、e2e-m0-user 55、e2e-m5-logs 44、e2e-m5-notify-wiring 43、 e2e-m1-tenant-domain 6、e2e-m8-open 61 全绿；浏览器按角色逐个真点复验。详见 docs/交接摘要.md §一·三十三与 §一·三十四。	2026-10-09 17:29:20 +08:00
lovife	8480f431ba	feat(user): 账号管理（CRUD、Excel 导入、改密）并修掉 5 处缺陷后端补齐 /users 全套（列表/新增/修改/软删/启停/重置密码/批量导入）与 PUT /auth/password；前端加「组织与账号 → 账号管理」一屏（左组织树 + 右列表、新增编辑弹窗、导入体检报告、初始密码只显示一次的强确认）。验收：e2e-m0-user.py 55/55；e2e-m0.py 回归 36/36；typecheck 0 错、build 通过。账号管理页已在浏览器肉眼确认（首屏与切页均可见、数据与分页正确）。本轮修掉的 5 个真问题 —— 都不是功能没做完，而是做完了但错的： 1) 学校租户也发放 PLATFORM_ADMIN 角色行学校管理员在新增账号时传 roleCodes=[PLATFORM_ADMIN] 就能造出带 tenant:manage 的账号，而 /tenants 只校验权限码、不校验是否真在平台租户下 → 任何学校管理员都能开通租户、拉全平台租户列表（租户级越权到平台级）。 RoleProvisioner 不再给非平台租户发该角色行 + 服务端按租户白名单校验。 2) UserUpsertReq.username 的 @NotBlank 对修改也生效 PUT /users/{id} 永远返回 40001，且明细只说存在阻断性校验问题，看不出是登录名 —— 改账号功能整体不可用。去掉该注解，必填性改由 UserService.create 判定。 3) Main.vue 的 <transition appear> 首次渲染被当成一次过渡，元素被加上 zoom-fade-enter-from（opacity:0）后永不清理 → DOM 内容齐全、接口数据正常、文字可选中，但整块内容区肉眼不可见。极易误判成页面没渲染而往路由/接口方向排查。去掉 appear。 4) assertAnotherAdminExists 在停用/删除路径上不可达能调这两个接口的人自己必然是活跃管理员，所以除目标外还有管理员恒成立；而真正会锁死租户的路径 —— 把管理员改成普通角色（目标可以是操作者自己）—— 当时没有拦。补 losingAdminRole() + UserMapper.countAdminRoles()，并在方法注释里写明哪条路径真生效、哪条只是防御性的。 5) sys_user.user_type 有两套互相冲突的枚举 DDL/实体注释写「1教师/管理员 2填报人(学生) 3社会人员」，而权威契约（03-接口设计 §2.7）与 BuiltinRole.UserType 是「1平台运营 2学校管理员 3班主任 4学生」—— 2 和 3 完全错位。后果：userType=3（班主任，最高频的账号）被当成社会人员（二期）直接拒掉，建班主任账号会失败；前端还把学校管理员显示成填报人（学生）。改法：后端从角色反推用户类型再比对；新增 V3 迁移更正库注释（V1 已应用不能改，Flyway 会校验 checksum）；更正 PRD 与 schema DDL 的同一行；前端「用户类型」从手选改为由角色推导，从根上消除矛盾组合； E2E 加 3 条回归断言锁住这个语义。顺带修掉： · components/index.ts 里 6 个指向已删组件的悬空导出（构建不报错、用到才炸） · tsconfig 的 lib 停在 ES2020 而代码用了 Array.prototype.at · 两处 .at() 的空值风险（useBreakpoint / useTabsStore） · dashboard 的 userStore.menus 拼错，导致平台判断恒为 false · http.ts 里两个永不命中的错误码常量 · 账号列表的 fixed 列缺 :scroll 配置，会浮在其它列上面 · .gitignore 补 __pycache__ 新增脚本： · scripts/e2e-m0-user.py 账号管理 55 项验收（含越权与自锁的负向断言） · scripts/dev-clean-test-users.py 清理 E2E 残留的测试账号	2026-09-28 22:25:01 +08:00
lovife	87ece5a971	feat(frontend): 管理端改用 Gi Admin Pro 框架 + 腾讯云主题前端此前只有本地实现、从未入库，本次首次纳入版本管理。框架切换 · 以 Gi Admin Pro（Vue3 + Vite + TS + Arco Design Vue + Pinia）为底 · 剥离 14 个演示页面目录 / 121 个文件（demo 28、file 20、form 19、system 18…） · 依赖 dependencies 35 → 19，devDependencies 31 → 27 · 保留框架核心：layout、Gi* 组件库、hooks、权限指令、错误页、登录页主题：腾讯云 / TDesign 官方色板 · 主色 #0052D9（腾讯蓝）、成功 #00A870、警告 #ED7B2F、危险 #E34D59 · 页面底色 #f3f3f3、文字 rgba(0,0,0,90/60/40/26%) · 覆盖 Arco 底层色板 + 显式语义别名（primary/success/warning/danger/link/neutral） · 三个改了不生效也不报错的坑已记入注释： 1) Arco 色值是逗号分隔 RGB 三元组，不是 #RRGGBB 2) Arco 把色板定义在 body 而非 :root，必须写 `:root, body` 3) setting.json 的 themeColor 会以内联样式写进 body，优先级高于样式表对接后端（三处契约差异在 @/utils/http 统一适配） · 响应信封 {code,msg,data} → {code,success,message,data} · Token 头 token → Authorization: Bearer · 分页 {list,total} → 补一份 records，list 原样保留 · 40101 → 登录页；登录密码 RSA 加密（公钥走 /auth/public-key，轮换无需重建前端） · 路由：后端只下发菜单键，前端在本地路由表上过滤（有哪些页面归代码，谁能看归后端）已实现页面（浏览器实测通过） · 登录：RSA 加密 + 自适应验证码/租户码 + 账号锁定提示 · 工作台：真实数据（组织 6 个 / 角色 1 个 / 权限 25 项） · 组织架构：三级树 + CRUD + 占用校验 · 租户管理：开通租户 + 初始密码只显示一次的强确认 · 待建页：未实现菜单显示所属里程碑 · 权限菜单：学校管理员看不到「租户管理」视觉资产按腾讯云主题重做 · logo.svg（渐变圆角方 + 填）、favicon.svg（小尺寸做减法）、login-hero.svg（材料归集） · 登录页点阵纹理走主题变量，换主色自动跟随 · 文案改为产品实际能力：自动改名 / 强制压缩 / 隐私保护清理模板遗留（约 17MB + 三处外部依赖） · 百度统计脚本（上报到 gi-demo 作者的统计账号） · 用户菜单「项目地址」（跳转模板作者的 Gitee 仓库） · 两份 8.8MB mp3、388KB favicon.ico、57KB 模板插画、未引用字体与 loading.gif · 「个人中心」指向已删除的 /system/account（点了 404） · 头部头像在无 avatarUrl 时渲染成裂图 → 改为姓名首字兜底后端修复 · 新增 GET /auth/public-key（前端加密登录密码用） · DataSeeder.ancestor_path 生成错误：子节点本该是 /16/17/ 却写成 /17/ 该字段是「按院系统计」的索引，错了会漏人/多人且不报错 —— 改为从库里读父节点路径 · seedDemoOrgs 曾放在租户作用域外 + admin 早退分支之后，导致启动失败 / 永不执行 · 示范租户补一套三级组织树（1 学校 / 2 院系 / 3 班级），供界面演示	2026-09-28 20:49:55 +08:00

Author

SHA1

Message

Date

lovife

0bbac7d228

feat(pc,platform): 验收走查修复（平台按学校代管 + 菜单/403/日志范围/分页）

客户在验收里点出来的问题，一次改完。两段改动：

一、平台运营与租户范围（后端为主）
- 新增请求头 X-Tenant-Id：平台运营是唯一跨租户身份，租户拦截器对它整体关掉了过滤，
  于是「组织架构 / 账号管理 / 工作台」拿到的是所有租户混在一起的数据 —— 而只有一所
  学校有数据时，它和学校管理员看到的完全一样，看不出错（这是最危险的一点）。
  现在这些页面必须先选定学校，服务端再把本次请求的租户上下文换成目标租户：
  只认平台身份（其它身份带头一律忽略）、目标租户必须存在且启用。
- OrgService.tree / UserService.list 补显式 tenant_id 条件（原来只靠拦截器，而拦截器对
  平台不生效）；TaskService.seesWholeTenant 改用新的 LoginUser.isPlatformStaff() ——
  isPlatformAdmin 回答"当前租户是不是平台租户"，代管时它为 false，会让平台退化成普通
  用户（任务列表掉进"班主任只看自己带的班"分支，得到空列表）；PLATFORM_ADMIN 补
  TASK_VIEW（PRD §3.2「查看填报进度看板：平台运营 ✅」）。
- 操作日志对平台永远是空的：SQL 写死 tenant_id = 当前租户，而平台的 tenantId 是 0。
  按契约 §13.4 补 tenantId 参数与 log:viewAll：平台默认看全量、可指定某所学校；
  学校管理员恒为本租户，传别家返回 40301（不静默忽略，否则会让人以为"筛过了"）。
- 开放接口"推送重试"从未生效（F-112）：定时扫描缺 @InterceptorIgnore，异常被 log.warn
  吞掉；同一方法里"接入方已停用"那条 update 也没有租户上下文，会每 10 秒重试到永远。
  E2E 补了"真的重试了"的断言（原来只断言"安排了下次重试"）。

二、PC 端走查体验
- 去掉 3 条无用菜单（名单管理 / 表单设计器 / 材料规则）：功能都在「收集任务」行内入口，
  菜单里那一条点进去只有指路；后端菜单键同步删除，entryAt 那套机制一并删掉。
- 班主任点工作台必弹 403：工作台无条件调了要 org:view / progress:viewAll 的两个接口。
  403 走 HTTP 状态码，try/catch 拦不住它的弹窗 —— 改成按权限决定发不发请求。
- 操作日志：分页器被裁在可视区外（新增 .g-list-card 让表体自己滚、表头钉住、分页器留在
  卡片底部）+ 去掉页面上那段免责声明；收集任务的状态切换改成单独一行 tab；去掉顶栏假数据
  铃铛；配色按客户要求还原。

顺带修两处"检查器自己不严"：check-wiring 新增第 ⑦ 项（PC 端引用的权限码必须存在于
PermissionDef —— 本轮我自己把 progress:viewAll 写成 progress:view:all，判断恒为 false，
而编译 / typecheck / lint / E2E 全都不红）；verify-docs 的表格列数检查不再把 GFM 转义
竖线当成列分隔符。两个检查器都拿"故意写错的样例"试过，确认真的会红。

验证：typecheck / mvn package / check-wiring（未接线声明 0 条）/ verify-docs（22 项）全过；
e2e-m0 36、e2e-m1-orgs 48、e2e-m0-user 55、e2e-m5-logs 44、e2e-m5-notify-wiring 43、
e2e-m1-tenant-domain 6、e2e-m8-open 61 全绿；浏览器按角色逐个真点复验。
详见 docs/交接摘要.md §一·三十三 与 §一·三十四。

2026-10-09 17:29:20 +08:00

lovife

8480f431ba

feat(user): 账号管理（CRUD、Excel 导入、改密）并修掉 5 处缺陷

后端补齐 /users 全套（列表/新增/修改/软删/启停/重置密码/批量导入）与
PUT /auth/password；前端加「组织与账号 → 账号管理」一屏（左组织树 + 右列表、
新增编辑弹窗、导入体检报告、初始密码只显示一次的强确认）。

验收：e2e-m0-user.py 55/55；e2e-m0.py 回归 36/36；typecheck 0 错、build 通过。
账号管理页已在浏览器肉眼确认（首屏与切页均可见、数据与分页正确）。

本轮修掉的 5 个真问题 —— 都不是功能没做完，而是做完了但错的：

1) 学校租户也发放 PLATFORM_ADMIN 角色行
   学校管理员在新增账号时传 roleCodes=[PLATFORM_ADMIN] 就能造出带
   tenant:manage 的账号，而 /tenants 只校验权限码、不校验是否真在平台租户下
   → 任何学校管理员都能开通租户、拉全平台租户列表（租户级越权到平台级）。
   RoleProvisioner 不再给非平台租户发该角色行 + 服务端按租户白名单校验。

2) UserUpsertReq.username 的 @NotBlank 对修改也生效
   PUT /users/{id} 永远返回 40001，且明细只说存在阻断性校验问题，
   看不出是登录名 —— 改账号功能整体不可用。去掉该注解，
   必填性改由 UserService.create 判定。

3) Main.vue 的 <transition appear>
   首次渲染被当成一次过渡，元素被加上 zoom-fade-enter-from（opacity:0）后
   永不清理 → DOM 内容齐全、接口数据正常、文字可选中，但整块内容区肉眼不可见。
   极易误判成页面没渲染而往路由/接口方向排查。去掉 appear。

4) assertAnotherAdminExists 在停用/删除路径上不可达
   能调这两个接口的人自己必然是活跃管理员，所以除目标外还有管理员恒成立；
   而真正会锁死租户的路径 —— 把管理员改成普通角色（目标可以是操作者自己）——
   当时没有拦。补 losingAdminRole() + UserMapper.countAdminRoles()，
   并在方法注释里写明哪条路径真生效、哪条只是防御性的。

5) sys_user.user_type 有两套互相冲突的枚举
   DDL/实体注释写「1教师/管理员 2填报人(学生) 3社会人员」，而权威契约
   （03-接口设计 §2.7）与 BuiltinRole.UserType 是
   「1平台运营 2学校管理员 3班主任 4学生」—— 2 和 3 完全错位。
   后果：userType=3（班主任，最高频的账号）被当成社会人员（二期）直接拒掉，
   建班主任账号会失败；前端还把学校管理员显示成填报人（学生）。
   改法：后端从角色反推用户类型再比对；新增 V3 迁移更正库注释
   （V1 已应用不能改，Flyway 会校验 checksum）；更正 PRD 与 schema DDL 的同一行；
   前端「用户类型」从手选改为由角色推导，从根上消除矛盾组合；
   E2E 加 3 条回归断言锁住这个语义。

顺带修掉：
  · components/index.ts 里 6 个指向已删组件的悬空导出（构建不报错、用到才炸）
  · tsconfig 的 lib 停在 ES2020 而代码用了 Array.prototype.at
  · 两处 .at() 的空值风险（useBreakpoint / useTabsStore）
  · dashboard 的 userStore.menus 拼错，导致平台判断恒为 false
  · http.ts 里两个永不命中的错误码常量
  · 账号列表的 fixed 列缺 :scroll 配置，会浮在其它列上面
  · .gitignore 补 __pycache__

新增脚本：
  · scripts/e2e-m0-user.py            账号管理 55 项验收（含越权与自锁的负向断言）
  · scripts/dev-clean-test-users.py   清理 E2E 残留的测试账号

2026-09-28 22:25:01 +08:00

lovife

87ece5a971

feat(frontend): 管理端改用 Gi Admin Pro 框架 + 腾讯云主题

前端此前只有本地实现、从未入库，本次首次纳入版本管理。

框架切换
  · 以 Gi Admin Pro（Vue3 + Vite + TS + Arco Design Vue + Pinia）为底
  · 剥离 14 个演示页面目录 / 121 个文件（demo 28、file 20、form 19、system 18…）
  · 依赖 dependencies 35 → 19，devDependencies 31 → 27
  · 保留框架核心：layout、Gi* 组件库、hooks、权限指令、错误页、登录页

主题：腾讯云 / TDesign 官方色板
  · 主色 #0052D9（腾讯蓝）、成功 #00A870、警告 #ED7B2F、危险 #E34D59
  · 页面底色 #f3f3f3、文字 rgba(0,0,0,90/60/40/26%)
  · 覆盖 Arco 底层色板 + 显式语义别名（primary/success/warning/danger/link/neutral）
  · 三个改了不生效也不报错的坑已记入注释：
      1) Arco 色值是逗号分隔 RGB 三元组，不是 #RRGGBB
      2) Arco 把色板定义在 body 而非 :root，必须写 `:root, body`
      3) setting.json 的 themeColor 会以内联样式写进 body，优先级高于样式表

对接后端（三处契约差异在 @/utils/http 统一适配）
  · 响应信封 {code,msg,data} → {code,success,message,data}
  · Token 头 token → Authorization: Bearer
  · 分页 {list,total} → 补一份 records，list 原样保留
  · 40101 → 登录页；登录密码 RSA 加密（公钥走 /auth/public-key，轮换无需重建前端）
  · 路由：后端只下发菜单键，前端在本地路由表上过滤（有哪些页面归代码，谁能看归后端）

已实现页面（浏览器实测通过）
  · 登录：RSA 加密 + 自适应验证码/租户码 + 账号锁定提示
  · 工作台：真实数据（组织 6 个 / 角色 1 个 / 权限 25 项）
  · 组织架构：三级树 + CRUD + 占用校验
  · 租户管理：开通租户 + 初始密码只显示一次的强确认
  · 待建页：未实现菜单显示所属里程碑
  · 权限菜单：学校管理员看不到「租户管理」

视觉资产按腾讯云主题重做
  · logo.svg（渐变圆角方 + 填）、favicon.svg（小尺寸做减法）、login-hero.svg（材料归集）
  · 登录页点阵纹理走主题变量，换主色自动跟随
  · 文案改为产品实际能力：自动改名 / 强制压缩 / 隐私保护

清理模板遗留（约 17MB + 三处外部依赖）
  · 百度统计脚本（上报到 gi-demo 作者的统计账号）
  · 用户菜单「项目地址」（跳转模板作者的 Gitee 仓库）
  · 两份 8.8MB mp3、388KB favicon.ico、57KB 模板插画、未引用字体与 loading.gif
  · 「个人中心」指向已删除的 /system/account（点了 404）
  · 头部头像在无 avatarUrl 时渲染成裂图 → 改为姓名首字兜底

后端修复
  · 新增 GET /auth/public-key（前端加密登录密码用）
  · DataSeeder.ancestor_path 生成错误：子节点本该是 /16/17/ 却写成 /17/
    该字段是「按院系统计」的索引，错了会漏人/多人且不报错 —— 改为从库里读父节点路径
  · seedDemoOrgs 曾放在租户作用域外 + admin 早退分支之后，导致启动失败 / 永不执行
  · 示范租户补一套三级组织树（1 学校 / 2 院系 / 3 班级），供界面演示

2026-09-28 20:49:55 +08:00

3 Commits