feat(form): 发布表单字段与各模块「新建发布」页完全对齐
build / build-push (push) Successful in 54s

原来助手表单只渲染"缺失的必填项",且控件只有文本/单选/时间 —— 与各模块
自己的发布页相比缺了接收对象多选、附件、定时发送、置顶、紧急程度、回执单据、
发布方式等字段,用户没法"填得一样"。

补齐一层共享的表单能力,再把三个发布工具按模块页逐字段重写:

共享能力
- ToolParam: 新增 join(分隔符)/multiple/allOption(哨兵)/scopes(推送范围),
  array 类型有选项来源时自动用多选控件;数组 schema 补 items
- ToolDef: 新增 fullForm() —— 表单渲染全部字段(不再只渲染缺失必填)
- ToolExecutor: POST_JSON 前按 joinSeparator 把数组拼成模块要的逗号串;
  allToken 与具体项互斥(只选具体项→拼串,否则发哨兵)
- AgentOrchestrator: file 控件补 uploadPath(/<模块>/api/base/FileUpload)
- 模板/参数文件同步下发 joinSeparator/uploadPath/multiple/allToken/scopeType

三个发布工具
- notice.publish: 补重要程度/接收班级(pushScopes 对象数组)/置顶/短信/阅读回执/
  附件/定时发送/发布方式;新增 notice.stuTree(组织树)
- dorm.publish: 补紧急程度/生效时间/回执截止/回执单据/接收宿舍(多选,ALL)/
  宿管配合/置顶/短信/附件/定时发送/存草稿
- activity.publish: 补报名截止/回执方式三档/名额上限/家长随行/活动费用/
  接收班级(多选,ALL)/短信/附件/定时发送/存草稿
- leave.submit/register: 连续请假改为可填参数,补连续天数与佐证材料附件

测试:发布工具契约 + 表单字段与模块页一致性断言;90 tests 全绿
This commit is contained in:
lijing
2026-10-12 22:05:09 +08:00
parent b6a8a63b0e
commit 322d589b3e
13 changed files with 456 additions and 64 deletions
@@ -18,12 +18,45 @@ public class FormField {
/** 中文标签,如「开始时间」 */
private String label;
/** 控件类型:text / textarea / number / date / datetime / select */
/** 控件类型:text / textarea / number / date / datetime / select / multiselect / file */
private String widget;
/** 数据类型:string / integer / number / boolean */
/** 数据类型:string / integer / number / boolean / array */
private String type;
/**
* 数组值的序列化分隔符(仅 POST_JSON 有意义)。
* <p>前端展示时不需要它(用户看到的是多选),但下发给前端便于「提交前预览」如实呈现最终值。
*/
private String joinSeparator;
/**
* {@code widget=file} 时的上传地址(相对站点根),如 {@code /dormnotice/api/base/FileUpload}。
* <p>模块的附件上传只认浏览器 CAS 会话,必须由前端带用户登录态 POST(multipart),
* 拿到 {@code data.fileid} 后作为 fileIds 提交。
*/
private String uploadPath;
/** {@code widget=file} 时是否允许多个附件 */
private boolean multiple;
/**
* 「全部」哨兵值(如 {@code ALL})与其显示名(如「全部宿舍」)。
* <p>前端把它作为多选的第一个选项;用户只勾它 → 提交 {@code ["ALL"]};
* 同时勾了具体项 → 提交时折叠掉它,以具体项为准。
*/
private String allToken;
/** 「全部」选项的显示名 */
private String allTokenLabel;
/**
* {@code widget=scopes} 时的节点类型(校园公告 pushScopes):
* 1 全校 / 2 学部 / 3 年级 / 4 班级 / 5 训练队 / 6 指定学员。
* <p>前端把多选结果拼成 {@code [{scopeType,scopeId,scopeName}]}。
*/
private Integer scopeType;
private boolean required;
/** 说明(来自工具定义,写清格式与含义) */