 lovife
|
ef903a55c3
|
feat(task): 表单设计器（M1-08）—— 填报表单在界面上也能配了
"能动态设置填报表单"是本产品的核心承诺之一，而在这之前表单定义只能用 SQL 改。
更要紧的是它有一个**不可逆的方向**：内置字段删不掉（40026），正确用法是
"用条件显示隐藏"—— 而只有界面上给这条路留了位置，用户才会照着做。
新增：
· apis/xt/form-schema.ts —— 表单定义接口 + 字段类型 + 条件选项 + 扩展字段 key 生成
· views/task/TaskFormSchemaDrawer.vue —— 21 项内置字段（必填/条件/排序/提示语就地改）
+ 扩展字段增删改 + 保存为新版本 + 版本冲突处理
· task/index.vue 操作列加「表单设计」，240→300px
浏览器实测：
· 版本标签「未保存过（当前为官方默认表单）」——服务端对没存过的任务返回内置默认定义，
让设计器从一份完整的官方表单开始，而不是从空白开始
· **21 项全在，且「条件显示」反查正确**：补考三科→仅补考时、
在读学校/专业/入学时间→仅在校生、本职业工作年限必填开关是关的。
把服务端任意 visibleWhen 对象映射回人话标签，是本界面最容易做错的一处
· 保存→库里 v1 current=1 fields=21；三次保存得到 v1/v2/v3，
旧的 is_current=0 全部保留（**版本只增不改**实测）
· 「不收集」= {field:"_never_",...}（内置字段删不掉，用一条永远不成立的条件隐藏）；
保存后原有条件（is_retake/is_student）都保住了
⭐ 端到端：学生端 字段 21→17（已获证书编号消失、补考三科消失、在校生三项保留）、
材料 4→3（工作证明消失）
⚠️ 顺带修掉一个真 bug：**材料侧的条件没求值**
上面这次验证暴露的：表单字段的条件前端有求值（21→17），材料的没有 ——
「工作证明（仅非在校生）」照样显示给在校生；而后端校验是排除它的，
于是表现成"系统让我传，我不传也不报错"，学生只能自己猜。
修法：把 visible() 抽成 whenVisible()，**字段与材料共用同一份**。
教训：同一套规则出现在两处时必须共用同一个函数 ——
抄一份的代价不是多几行，而是两边行为不一致，而两边各自看都没错。
修掉一条过期的 E2E 断言：e2e-m1-form.py 断言「联系电话不锁定」，
与实现刻意的只读相反（BuiltinFields L88-93：collect_submission 没有 phone 列，
所以一期只读；反过来做"前端允许改、后端悄悄丢掉"最糟 ——
学生以为改成功，实际提交的还是老号码）。改断言并写明理由，48/48 恢复。
frontend-mp 类型检查修干净：原先 fill.vue 还有 3 条（输入框事件、日期选择、
FormData 缺 submissionStatus），现在只剩 config/index.ts 的 2 条 ——
那是 uni-app 的 #ifdef H5/#ifndef H5 声明同一变量，vue-tsc 看不懂条件编译，设计如此。
验收：e2e-m1-form 48/48、materials 68/68、task 71/71、orgs 48/48、
m3-submit 31/31、file 29/29、draft 27/27、gate 29/29（合计 351 条断言全绿）
|
2026-09-29 13:48:11 +08:00 |
|
|
lovife
|
870c388287
|
feat(form): M1-03 表单 schema 版本化与冲突检测
学生端看到的表单终于可以按任务配置了。按计划表这一项是后端
（4 人日），表单设计器界面属 M1-07。
交付：
· GET/PUT /tasks/{id}/form-schema（§7.9 / §3.5）
· BuiltinFields：官方《考生线下报名信息导入模板》的 21 个内置字段（A~U 列）
—— 选项集逐字照抄，级联规则照官方原文
四条守住的规则：
1) 版本只增不改：每次保存插一行新版本，旧的保留（is_current=0）。
学生是按某一版填的，事后必须能回答"他当时看到的是什么"。表上没有 deleted
列也是这个道理 —— 表单版本不需要软删，它本来就不该删。
顺带：collect_form_schema 没有 deleted 列，实体刻意不继承基类
（collect_task_org 踩过同一个坑）。
2) baseVersion 是乐观锁，不符则 40025 并把最新定义一起回传。
设计器是"打开 → 改很多处 → 保存"，中间可能好几分钟；直接覆盖会静默丢掉
别人刚加的字段，而且丢失发生在"另一个人"那里。只说"版本冲突"而不给最新内容，
等于把合并推给一个信息不全的调用方 —— 所以 40025 的 data 里带着最新 schema。
3) 内置字段不可删（40026）的判断依据是「内置目录」而不是「上一版定义」：
拿上一版当依据，客户端只要让上一版先缺一个就绕过去了。E2E 也验了
把 builtin 传成 false 无法绕过 —— builtin 与 source 一律以内置目录为准。
4) 扩展字段键必须带 extra_ 前缀、不可与内置重名：扩展字段的值落 extras_json，
与内置列同处一份 form_data，一个叫 education 的扩展字段会让"这个值到底是
内置的还是扩展的"永远说不清。
契约之外必须补的一个字段 source：
§3.5 说"内置字段与 collect_submission 列名一致"，但「姓名」「身份证号」
「联系电话」「序号」根本不在 submission 里，在名册里（collect_roster）。
不标来源，填报引擎就得靠硬编码名单去猜"这个 key 去哪取值"，猜错的表现是
"学生端这两栏永远是空的"——一个不报错、只让人困惑的失败。
⚠️ source 与 locked 互相独立：「联系电话」source=ROSTER 但 locked=false
（预填可改，名册里常是家长的老号码）；「报考职业」source=SUBMISSION 且
locked=true（由计划定，学生不懂也不该改）。
21 项内置字段的口径：
· 选项集逐字照抄官方（学历 11 / 等级 5 / 补考理论 4 / 实操 6 / 综合 2）。
官方原文写着"若手动输入则只能填写下拉选项中包含的值"，多一个少一个都算改了规则。
· 级联：补考三科仅 is_retake=true 显示；在校生三项仅 is_student=true 显示；
入学时间带 ^\d{4}-\d{2}-\d{2}$ 正则（官方原文「格式必须 YYYY-MM-DD」）。
· 工作单位保留官方原文提示「没有工作单位请填「无」」。
⚠️「无」是合法业务值，不是空值，校验时不能把它当成"没填"拦掉。
· 锁定项（姓名/身份证号/报考职业/工种/等级）与 PRD 一致，另把「序号」一并锁定
（来自名册，让学生编辑"自己是第几号"没有意义）。
顺带：V6 更正 collect_form_schema.schema_json 的列注释（V1 写的是"字段定义数组"，
实际存 {"fields":[...],"extras":[...]}）。合成一个文档而不是拆两列，是因为
一版表单就是一份快照 —— 拆开就存在"只写成功一半"的可能，而"学生看到的那版"
必须是原子的。
本轮踩的坑（记进交接摘要）：
· 我的 E2E 又写错一条：测「已截止不可改表单」时先调 close，但**草稿是不能直接
截止的**（close 只允许 收集中/已暂停）。改成先用 SQL 夹具把发布前置备齐 →
发布 → 再截止。这反而验证了一件对的事：没配齐就发布，学生填了也没人审，
所以 close 把草稿挡住是合理的。
· 写 Java 时把 Map 声明成了 String，编译器直接拦住，没有代价。
已知缺口：
· 表单设计器界面未做（M1-07）。
· 报考职业/工种/等级的 options 为空：它们来自"评价计划"（由名册聚合，M2），
不是固定选项。属预期，等 M2 接上计划级联。
· 库里没有字典表，所以官方选项内联在 options 里，dictCode 暂未启用。
· 条件显示的求值引擎属 M3-10，本轮只做存取与形状校验。
验收：e2e-m1-form.py 48/48；六条 E2E 合计 326 项断言全通过；Flyway 迁移 1~6 success。
|
2026-09-29 09:47:09 +08:00 |
|