wangziqi/gongxue-base
1
0
Fork 1
Code Issues Pull Requests 1 Actions 3 Packages Projects Releases Wiki Activity
675 Commits 2 Branches 0 Tags
main
Commit Graph
675 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
wangziqi 74fb09bdba fix(admin): 报读操作统一失效档案与班级查询缓存
CI / check (pull_request) Waiting to run
Details
Dependency Check / check (pull_request) Waiting to run
Details 
报读增删改/归档都会经 syncRosterMembership 变更班级花名册，4 个 mutation
统一失效 ['archive', studentId] + queryKeys.classes.all（抽 ENROLLMENT_INVALIDATE
常量），避免班级详情/花名册读到陈旧数据；操作列拍平嵌套三元。
 2026-08-12 16:18:45 +08:00
wangziqi 0ea31b8bc3 feat(server): 报读表索引迁移与存量重复清洗 
- AddIndexToStudentEnrollments：student_enrollments 补 (class_id, student_id)
  普通索引，加速幂等查找（NON_UNIQUE=1 守卫 + 1061/1091 并发幂等）
- AddActiveUniqueToStudentEnrollments：active 部分唯一函数索引（MySQL 8.0.13+
  版本守卫），闭合并发重复报读；up 前 GET_LOCK 串行化 + 清洗存量重复 active
  （保留最早、其余置 archived，keep_enrollment_id 备份可回滚），有界重试；
  down 三级恢复守卫（archived + 花名册 active + 无 up 后新建报读），
  未恢复行保留备份表供人工排查
 2026-08-12 16:18:33 +08:00
wangziqi 37b1ba45e1 fix(server): 花名册报读同步并发幂等加固 
- ensureEnrollmentsForRoster：普通读 + 分块批量插入，批内撞 active 部分唯一索引
  时逐行回退（1062 跳过），missing 去重并按 studentId 排序防死锁；
  courseCategory 仅映射 culture/professional/comprehensive，角色类型用枚举
- 导入路径恢复全量同步（不剔除 alreadyAdded，避免钉钉导入/建班等不同步
  路径导致漏建报读）
- archive add/updateEnrollment 保存 1062 转 400（saveEnrollmentWithDupGuard），
  并补 2 个单测
- isDuplicateEntryError 提取到 common/db-errors.ts 单一来源（queries re-export）
- 修复 classes.membership.spec：mock dataSource.transaction + manager，
  断言更新为新返回结构；addStudents 空输入早返回补 enrollmentsCreated: 0
 2026-08-12 16:18:18 +08:00
wangziqi bce076ddaf feat: 班级花名册与档案报读双向同步 (#83) 2026-08-12 06:04:13 +00:00
wangziqi dfc3ffb78c refactor(admin): 清理 lint 警告（no-explicit-any / exhaustive-deps）
CI / check (pull_request) Successful in 3m36s
Details
Dependency Check / check (pull_request) Successful in 2m37s
Details
2026-08-12 11:04:06 +08:00
wangziqi fee23219ce fix(server): 清理 lint 未使用变量警告 2026-08-12 11:04:06 +08:00
wangziqi 6f805faf97 fix(server): 押金 decimal 列补 transformer，接口金额返回数字
CI / check (pull_request) Successful in 4m6s
Details
Dependency Check / check (pull_request) Successful in 1m18s
Details
2026-08-12 10:31:45 +08:00
wangziqi 68e5b9ac61 fix(admin): 修正考试列表 schema 校验（接口无 isArchived 字段，改用 status）
CI / check (pull_request) Successful in 4m5s
Details
Dependency Check / check (pull_request) Successful in 2m47s
Details
2026-08-12 10:25:15 +08:00
wangziqi 31d1fe908a fix(admin): 修复工作台 KPI 卡片在窄屏下换行
CI / check (pull_request) Successful in 2m26s
Details
Dependency Check / check (pull_request) Successful in 2m36s
Details
2026-08-12 10:12:10 +08:00
wangziqi b0e66f81ad fix(server): 考勤趋势横坐标日期改为 YYYY-MM-DD 字符串返回 2026-08-12 10:12:04 +08:00
wangziqi 7987941a3c docs: 补充仓库开发指南（AGENTS.md）
CI / check (pull_request) Successful in 2m59s
Details
Dependency Check / check (pull_request) Successful in 1m21s
Details
2026-08-12 09:36:10 +08:00
wangziqi d9cbaf0eda feat(admin): 用户菜单新增修改密码弹窗 2026-08-12 09:33:57 +08:00
wangziqi a4210a5373 feat(server): 新增用户自助修改密码接口（免原密码校验） 2026-08-12 09:33:47 +08:00
wangziqi 1f0b377a7f feat(admin): 入住记录新增编辑弹窗与操作列
CI / check (pull_request) Successful in 2m58s
Details
Dependency Check / check (pull_request) Successful in 2m15s
Details
2026-08-11 17:28:16 +08:00
wangziqi 353a6c72e1 feat(server): 入住记录新增编辑接口与权限迁移 2026-08-11 17:28:16 +08:00
wangziqi f858d90b76 fix(admin): 修复排课周视图周区间错位一天（zh-cn 下 weekday(1) 是周二）
CI / check (pull_request) Successful in 5m16s
Details
Dependency Check / check (pull_request) Successful in 2m48s
Details
2026-08-11 16:36:01 +08:00
wangziqi a0611fda25 ci(deploy): runs-on 对齐 runner 标签，部署目录改为生产实际路径
CI / check (pull_request) Successful in 5m8s
Details
Dependency Check / check (pull_request) Successful in 3m37s
Details 
runner（nonlocal-runner，个人级）注册标签为 ubuntu-latest 等，原 self-hosted
标签不匹配导致 job 无 runner 可派发。部署目录默认值 /opt/gongxue 改为生产
实际路径 /www/wwwroot/jidi.gongxue100.com（仍可用仓库变量 REMOTE_DIR 覆盖）
 2026-08-11 16:01:34 +08:00
wangziqi 30d289875b refactor(server): 迁移改官方 migrationsRun 模式，移除自定义启动 runner
CI / check (pull_request) Successful in 3m41s
Details
Dependency Check / check (pull_request) Successful in 2m22s
Details 
TypeOrmModule 连接后自动执行未跑迁移（glob 自动发现，ts-node/dist 均匹配），
删除 main.ts 启动钩子与独立 DataSource。部署脚本显式 migration:run 保留：
迁移失败在 PM2 重载前中止，不中断在跑服务；与 migrationsRun 幂等共存
 2026-08-11 15:30:13 +08:00
wangziqi d1c320b1f5 refactor(server): 移除 app.module 失效迁移清单 
migrations 配置未设 migrationsRun 从不执行，手写 12 类清单已过期（缺 2 个迁移），
删除后迁移统一由 runner glob 自动发现与 datasource.ts CLI 管理
 2026-08-11 15:18:36 +08:00
wangziqi 01ca0c6f4b fix(server,admin): 成绩/班级均分/排名超列宽写入 MySQL 报 500 
score/class_avg 为 decimal(5,2)（上限 999.99）、rank 为 int，越界值直写库抛
ER_WARN_DATA_OUT_OF_RANGE。DTO 加 @Max 与列宽对齐返回 400 清晰报错，
前端单元格与表单 InputNumber 同步加 max 阻止输入
 2026-08-11 15:18:30 +08:00
wangziqi 0a685c8ea6 feat(admin): 报读记录班级选择、已报读禁用与班级跳转 
- 班级名称列改为班级下拉（选项禁用已报读班级），保存时映射 className+classId 双字段
- 已有关联的班级名渲染为可点击链接跳转班级详情
 2026-08-11 15:18:25 +08:00
wangziqi 3e3c05b8bc fix(server): 档案子记录编辑修复 ER_BAD_FIELD_ERROR 
findOne+select+eager join 时 TypeORM 0.3.x 生成缺 id 列的 distinctAlias 子查询
（Unknown column 'distinctAlias.xxx_id'），所有档案子记录编辑/删除均 500。
改回全列读取（单行主键查询成本可忽略）
 2026-08-11 15:18:12 +08:00
wangziqi 2499f90231 feat(server): 报读记录关联班级 classId 与花名册单向同步 
- student_enrollments 新增 class_id 列（迁移幂等），报读/换班/归档/删除时同步 class_student 成员状态
- 班级名以班级表为准快照，防止前后端漂移；班级不存在直接 400
- 迁移 runner 改 glob 自动发现（ts-node/dist 均可），新增迁移文件免手改清单
 2026-08-11 15:17:58 +08:00
wangziqi 2e5e3fb7e5 fix(server): 钉钉导入配置错误改抛 BadRequestException，使 create() 补偿删除真正生效
CI / check (pull_request) Successful in 2m46s
Details
Dependency Check / check (pull_request) Successful in 2m18s
Details
2026-08-11 12:53:56 +08:00
wangziqi 2871407f76 fix(server): keepPlus 排除括号开头、钉钉导入补偿删除收窄并记录日志、rels 大小不可读保守拒绝
CI / check (pull_request) Successful in 4m40s
Details
Dependency Check / check (pull_request) Successful in 3m17s
Details
2026-08-11 12:50:59 +08:00
wangziqi 257c2065b8 fix(server): 迁移超长科目备份移到截断前、keepPlus/rels 解析加固、钉钉导入失败补偿
CI / check (pull_request) Successful in 4m26s
Details
Dependency Check / check (pull_request) Successful in 2m48s
Details 
- 迁移：超长科目原值备份移到 step 2 拆分 UPDATE 之前（原位置截断后按长度查不到原值，备份无效）
- keepPlus：'+' 后紧跟公式触发符（- + = @ 等）不保留前缀，写回 Excel 不会被当公式
- workbook rels：逐元素解析任意属性顺序/引号，声明大小超限拒绝，防文件名绕过与内存放大
- create()：钉钉导入失败时补偿删除刚建班级（成员外键 CASCADE），避免孤儿班级
 2026-08-11 12:46:12 +08:00
wangziqi 66c039ee87 fix(admin): 排课提交保留 teacherId、同名新生导入提示、冲突检测排除 cancelled
CI / check (pull_request) Successful in 4m0s
Details
Dependency Check / check (pull_request) Successful in 3m7s
Details 
- teacherId 用隐藏 Form.Item 注册：validateFields 返回、resetFields 清理，
  修复提交丢失老师选择与新建弹窗残留上次编辑老师（重构引入的回归）
- 教师添加返回空数组（全部科目已存在）时提示「未新增」而非「已添加」
- 冲突检测排除所有非 active 排课（与后端 cancelled 等状态语义一致）
- 创建弹窗打开时复位教师加载 loading，防过期请求导致永久 spinner
 2026-08-11 12:38:31 +08:00
wangziqi 122f3843a2 fix(server): 班级创建事务化、花名册同名新生兜底修正、迁移超长科目备份 
- create() 班级/学生/教师写入整体包事务，避免教师失败留下孤儿班级
- 花名册提交：行内带标识的同名新生不再复用本批姓名兜底（避免被误判冲突丢弃，与预览一致）
- 迁移：超长科目截断前备份原值，且备份表确保存在（全新部署不因缺表启动失败）
- workbook rels 解析真实工作表路径，防自定义文件名绕过 sheet/行数预扫描
- keepPlus 完整正则对齐注释意图（+ 86 前缀保留）；formatDate 用 UTC getter
- main.ts 大 JSON 路由前缀与限制提取为常量并注明耦合点
 2026-08-11 12:38:24 +08:00
wangziqi 0b3edb88aa fix(admin): 密码按字节数校验，对齐 bcrypt 72 字节上限
CI / check (pull_request) Successful in 2m51s
Details
Dependency Check / check (pull_request) Successful in 1m49s
Details 
- 共享 PASSWORD_RULES：新增账号与重置密码弹窗统一
- 原 max:72 按字符数校验，多字节密码（如中文 3 字节）会通过前端校验却被服务端
  @MaxByteLength(72) 拒绝；改为 TextEncoder 字节数校验
 2026-08-11 11:54:14 +08:00
wangziqi 48d06b29c1 feat(admin): 班级花名册导入确认流程与教师候选人 
- 提交体条件化：空数组不发送，修复全匹配/全新建两种场景被后端 @ArrayMinSize 拒 400
- 无论是否新建学生都先确认，避免已匹配学生被一键加入无提示
- 学员下拉保留学号/ID 兜底区分同名；科目去重键小写对齐后端唯一索引
- 任课老师空科目前端拦截；教师候选人相关调整
 2026-08-11 11:54:09 +08:00
wangziqi f19e72ca40 feat(admin): 排课冲突检测与教师选择状态收敛 
- findTimeConflicts：半选值/无效日期防护、日期未选不误报、坏时间按必定冲突、10 分钟缓冲命名常量
- 教师下拉完全由表单驱动，移除冗余 teacherKey 状态（消除整类双源 desync 问题）
- 教师加载加请求序号防过期覆盖 + loading 禁用下拉 + 失败提示不清空表单
- 编辑模式 teacherKey 按实际选项推导，fallback 优先任课老师行并同步科目
- 切班/切老师自动带出：仅真匹配时自动选中，显式科目无人教授时清空防错配
- 选项按复合 key 去重，冲突提示标注基于当前视图
 2026-08-11 11:53:58 +08:00
wangziqi 5f03f7a164 feat(server): class_teacher 科目列迁移——一行一科目 + 4 列唯一索引 
- 迁移确保 subject NOT NULL DEFAULT '' 并建 (class_id,user_id,role_type,subject) 唯一索引
- 历史多科目值按内容拆分（不依赖列类型），首科目截断与 TS 侧 trim 归一化一致
- 破坏性清理前备份到审计表；暂存表自包含身份列，恢复不依赖原行存活
- 4 列兜底去重防 CREATE UNIQUE INDEX 撞 ER_DUP_ENTRY；GET_LOCK 串行化多实例迁移
- 收敛后启动为纯 no-op，滚动部署不再反复清理
- init.sql 与实体对齐：subject NOT NULL DEFAULT ''，唯一索引显式命名
 2026-08-11 11:53:47 +08:00
wangziqi bfc8175277 fix(server): 花名册预览与提交匹配归一化一致，并发导入计数修正 
- 预览二次校验改 LOWER(TRIM) 归一化，与主查询/commit 路径一致，避免预览判可新建而提交判冲突
- 并发创建同标识学生重查改用锁定读刷新可见性（REPEATABLE READ 旧快照问题）
- 批量成员保存撞唯一索引后的恢复：复活行不计入并发跳过，仅新增行且已 active 才算已在本班
- 重试保存逐行执行，避免多行 INSERT 原子失败静默丢行
 2026-08-11 11:53:40 +08:00
wangziqi 545d087b3d feat(server): 教师分配 DTO 校验与实体对齐，重复分配由唯一索引兜底 
- 科目长度上限收敛到 dto MAX_SUBJECT_LENGTH(30)，subjects/subject 加 @MaxLength
- ValidateSubjectTeacherHasSubject 对非字符串元素做类型守卫，避免 500
- normalizeTeacherSubjects 去重键小写对齐 MySQL 大小写不敏感 collation
- 任课老师逐行保存并包事务：并发 1062 跳过、非重复错误整体回滚
- 非科目角色去掉无事务悲观锁，改查重 + save 捕获 1062 转 400
- 实体 subject 列对齐迁移后 NOT NULL DEFAULT ''，唯一索引显式命名
- 提交 DTO 跨字段校验：合计行数不超过文件解析上限，id 需为正整数
 2026-08-11 11:52:09 +08:00
wangziqi 386c8dd5b3 fix(server): 班级花名册导入安全加固（zip 炸弹防护/公式注入/解析错误透出） 
- assertRosterZipSafe 流式解压限流：单条目 8MB、总量 32MB 硬上限，超限即时中止
- 解压流超时兜底，防畸形 zip 挂起请求
- 工作表数量与行数在 ExcelJS 整体加载前流式预扫描拦截
- sanitizeCellText 补空格/换行公式触发符，keepPlus 支持括号且至少含一位数字
- 解析错误改 RosterParseError(400) 透出可操作提示，不再被 500 吞掉
- main.ts 仅对 /api/classes 路由放宽 JSON body 上限至 2mb
 2026-08-11 11:51:58 +08:00
wangziqi 6f421c7bd6 feat(admin): 附件上传改为拖拽并增加大小/格式提示 2026-08-10 17:29:48 +08:00
wangziqi 7df28f46e0 feat(admin): 学生基本信息枚举化并按区块分组展示 2026-08-10 17:29:48 +08:00
wangziqi de5843475f feat(admin): 课堂回访默认当天日期、跟进方式改为下拉选择 2026-08-10 17:29:48 +08:00
wangziqi 98768341e0 feat(admin): 考试成绩科目联想、单报读自动关联与考试名称自动生成 2026-08-10 17:29:48 +08:00
wangziqi b946713b61 feat(admin): 报读班型支持班级选择、自动带出与已报读识别 2026-08-10 17:29:48 +08:00
wangziqi d7d1bfaab1 feat(admin): 学生档案共享枚举常量（科目/跟进方式/性别/年级/选科方向）及单测 2026-08-10 17:29:47 +08:00
wangziqi e092ede8d8 Merge pull request 'fix: 修复 CI 时区测试失败 + 依赖安全升级 + 新增依赖检查 workflow' (#68) from fix/ci-deps-security into main
Dependency Check / check (push) Successful in 48s
Details
2026-08-10 02:13:41 +00:00
wangziqi c6e1d94510 fix: 修复 CI 时区测试失败 + 依赖安全升级 + 新增依赖检查 workflow
CI / check (pull_request) Successful in 4m11s
Details
Dependency Check / check (pull_request) Successful in 2m30s
Details 
- fix(server): getCourseClock 固定 UTC+8（Asia/Shanghai），与 attendance-settlement 保持一致，
  修复 CI（UTC 容器）下 attendance.lesson-session.spec.ts 失败
- chore(deps): @ant-design/x 2.9.0 / @ant-design/x-markdown 2.9.0 / mermaid 11.16.1；
  直接依赖 dompurify 3.4.13（修复生产依赖 audit 漏洞，mermaid/x-markdown 复用同一份）
- ci: 新增 dependency-check workflow（生产依赖 moderate+ / 全局 critical 失败，outdated 报告）
 2026-08-10 10:05:05 +08:00
wangziqi 8c437cd082 Merge pull request 'fix: 迁移读取根 .env + 部署脚本本地直跑 + 健康检查读 PORT' (#66) from fix/datasource-root-env into main 2026-08-10 01:45:19 +00:00
wangziqi 4c95de2e56 Merge pull request 'fix(admin): 修复首次进入系统后点击任意导航被拉回 dashboard' (#67) from fix/route-redirect-keepalive into main 2026-08-10 01:44:02 +00:00
wangziqi ce9bde35eb fix(admin): 修复首次进入系统后点击任意导航被拉回 dashboard
CI / check (pull_request) Failing after 2m14s
Details 
根因：RouteKeeper 保活缓存了首页 index 节点，DefaultRoute 中的声明式
<Navigate> 会随缓存节点在后续路由变化时反复触发 replace，导致所有导航
被强制拉回落地页（dashboard），刷新后因不再经过 / 而恢复正常。

修复：DefaultRoute 改为 effect 导航，仅在确实处于 / 且已算出落地页时
跳转一次；navigate 通过 ref 持有避免 effect 空转。新增集成测试覆盖
「首次进入 / → 跳转一次 → 后续导航不被劫持 → 回到 / 仍能重定向」。
 2026-08-10 09:42:46 +08:00
wangziqi 9d74bd2d51 ci(deploy): deploy.sh 支持本地直跑模式 + workflow 健康检查读取 .env PORT
CI / check (pull_request) Failing after 5m3s
Details 
- deploy.sh 默认本地直跑（./deploy.sh 或 ./deploy.sh local），不再需要 SSH；传 ssh_host 才走远程版
- workflow 健康检查从 .env 读取 PORT（默认 3000），适配 PORT=3002 等自定义端口
 2026-08-09 22:04:21 +08:00
wangziqi f4072ce93a fix(db): 迁移 CLI 默认读取仓库根目录 .env 
- datasource.ts 优先加载根目录 .env，再回退 apps/server/.env
- 生产只需维护根目录一份 .env，迁移脚本不再报 root 空密码
 2026-08-09 22:02:00 +08:00
wangziqi 29d987ab74 Merge pull request 'ci: 部署工作流改为本地 runner 直跑版（免 SSH/Secrets）' (#65) from ci/local-runner-deploy into main 2026-08-09 13:42:36 +00:00
wangziqi f0321b5bdd ci(deploy): 部署工作流改为本地 runner 直跑版（免 SSH/Secrets）
CI / check (pull_request) Failing after 3m9s
Details 
- 移除 SSH/rsync 步骤与 SSH 相关 Secrets 依赖，runs-on: self-hosted 本机直跑
- 步骤：git pull → npm ci → build → migration:run → pm2 startOrReload --update-env → 健康检查
- 新增可选输入 seed_roles：首次部署/新增权限码时强制播种 RBAC，跑完自动去掉
- .env 无需配置到 Gitea，仅放服务器部署目录
- 注释说明 runner 在 docker 容器时的挂载与宿主 pm2 要求
 2026-08-09 21:41:48 +08:00