 lovife
|
daf42608d9
|
feat(task): M1-01 收集任务 CRUD 与状态机
后端：/tasks 建改删查 + publish/pause/resume/close/archive 六个动作，
按角色过滤可见范围（班主任只看自己带的班级的任务）。
前端：收集任务列表页 + 建/改任务弹窗（命名模板带实时预览与变量插入）。
验收：e2e-m1-task.py 71/71；e2e-m0.py 36/36、e2e-m0-user.py 55/55 回归通过；
前端 typecheck 0 错 / build 通过 / 浏览器肉眼确认。
三条硬约束（改动时当成规则）：
1) 「暂停」与「截止」不是一回事。暂停：学生不能交、已提交的照常审、
且可恢复；截止不可逆。做成一个会让"临时冻一下"变成不可逆操作。
2) 发布前置 5 项全是阻断级，force 绕不过：名册非空(40016)、名册含姓名与
证件号(40017)、至少 1 项必传材料(40018)、已设置覆盖班级(40019)、
命名模板可用(40020)。只有 P1 级提醒（某班未指定初审人）可 force 跳过。
3) collectMode / certType 发布后不可改 —— 它们决定审核流与材料清单，
改了会让已填过的学生面对另一份表单。
本轮修掉的 3 个真问题：
1) collect_task_org 没有 deleted 列，而我让它继承了带 @TableLogic 的基类
—— MyBatis-Plus 会给每条查询自动加 deleted = 0，运行时报"列不存在"，
编译期完全看不出来。改为不继承基类、显式声明字段；
"移除"语义走 status = 0，不要对它调 deleteById（会变成物理删除）。
2) 任务编码查重被逻辑删除遮蔽：用 MP 的 selectCount 会自动过滤 deleted = 0，
但数据库的唯一约束不看软删标记 —— 软删掉的任务仍占着那个编码，
于是"查重说没有、插进去说重复"，报 duplicate key（500）。
另外原用 COUNT+1 也错：删掉中间一个后计数会退回去，算出已占用的号。
改为 MAX(序号)+1，且查重语句刻意不加 deleted = 0（与唯一约束同口径）；
编码一次用过就不复用（它同时是文件目录名，复用会把两批文件混进同一目录）。
3) Boot 4 把 Jackson 自动配置挪到了 spring-boot-starter-jackson，项目没引，
导致容器里没有 ObjectMapper bean（@Autowired 直接启动失败），
且 application.yml 的 spring.jackson.* 静默失效 —— 其中
time-zone: Asia/Shanghai 不生效最危险：本机时区恰好是上海时看不出来，
部署到 UTC 服务器后所有时间会整体偏 8 小时。
注意 spring-boot-starter-json 在 Boot 4 已无 4.x 版本（仓库里最高 3.5.6）。
补依赖，但任务配置的 JSON 读写仍不用 Jackson —— Boot 4 用 Jackson 3
而 jjwt-jackson 带来 Jackson 2，打包后两个 jackson-databind 并存
(2.21.5 + 3.1.5)，import 哪个都是赌；改用项目已直接声明的 hutool-all。
已知缺口（都写进了代码注释与交接摘要）：
- 发布在前置数据齐备前不可达（名册属 M2、材料属 M1-04、覆盖班级属 M1-02），
E2E 用 SQL 夹具造数据才走到发布之后的状态 —— M1-02/M1-04/M2 落地后
要回来把夹具换成真实接口。
- 命名规则试跑目前只做静态校验（变量名合法 + 必含姓名/证件号/材料名），
完整形态（拿真实名册跑一遍查非空与不重名）属 M1-09 / M3-01。
- stat 恒为 null（依赖名册与提交单）。故意不返回全 0 的对象 ——
那会让界面显示"完成率 0%"，而真相是"还没有分母"；界面显示「待导入名册」。
- 任务编码并发撞号由唯一约束兜底 + 可读提示（不再 500），未做分布式锁。
顺带：
- 两个列表页的列宽按实测可用宽度重算（1366 屏：收集任务 824px、
账号管理因左侧组织树只有 574px），并把"操作列必须 fixed + 列宽口径"
写进注释 —— 之前把「状态」列整个遮住、把操作链接挤成竖排。
- 状态与最后登录并成一列，给窄屏省出 150px。
|
2026-09-28 23:48:21 +08:00 |
|