11 Commits

Include renames

Author	SHA1	Message	Date
chenxing	d7473112b0	t1~t3落地+10-22精修: 消费授权v3(owner/grant/订阅/目录)+答卷投递v2(可信提交上下文/快照/幂等关联)+答卷对账v1(清单/派发/租约/结果) ... 含10-22精修六类修复: 续租renewRunning/结果INCOMPLETE_RESULT门/终态TASK_TERMINAL/liveGrant复用ACL/hosted幂等重放绑定/错误明细整条重序列化。 合规审计与证据: 工作区docs/tasks/REFINEMENT_AUDIT.md + evidence/refinement-20261022/(patch+指纹)。SQL未执行、测试未运行(仅-skipTests编译)。	2026-10-22 10:02:57 +08:00
chenxing	c41ffebb95	t16:app 注册表——四业务字段零角色 + C17 CRUD 端点族 + 在用禁删 + 入口链接生成 ... - sql/t16_app_registry.sql：§17.2 建表（uk_app_code 全库唯一、form.app_code 逻辑引用不建 FK）。 本机核对：dev 库 ddl-auto 建的表与脚本列型逐列一致，且 Hibernate 尊重显式索引名（无漂移）； 脚本另在临时库实跑一遍校验语法后已清理。 - 实体 AppRegistry：app_code/sch_id 均 updatable=false——code 是入口链接与 routing key 的组成段，发布即冻结。 - AppRegistryService 四条写侧规则：C10 格式 + 保留字 form-center（大小写变体也算撞名）； 撞 uk 前先按 code 点名（在用=已存在 / 只剩软删行=编码不复用，都是可诊断 CUSTOM(5) 而不是库内 500，P125）； 删除保护按 countLiveByAppCode 全库统计（code 全库唯一，他校还在用同样算在用，取窄的一边）； 删除=实体 save 改标记（软删全仓保持实体写，bulk UPDATE 会绕过审计监听器）。 - 域规则：清单=本校∪平台级；改/删只动 sch_id==本次域的行，他校行按"app 不存在"回答。 超管建平台级需显式 schId=0，与两表端点同一条代查口径，零新增判据。守卫复用 requirePlatformAdmin（C4③）。 - 入口链接由后端生成：{context-path}/front/#/app/{code}/，本地无 context 段时回落 /#/app/{code}/ （同 host.config.ts 的推导），前端只补 origin。 - 新增 GET/POST/PUT/DELETE /api/form/admin/apps。 测试 AppRegistryIT（V59/V65/V69，8 例）：反射断言持久字段恰好 appCode/name/schId/isDeleted 且无 role|perm|admin|user|auth 形态列名；保留字与 6 种非法 slug + 2/64 位边界；重复注册不撞库； 本校∪平台级清单与链接后缀；普通教师 FORBIDDEN、他校"app 不存在"；改名只改 name； 草稿态即算在用（msg 带张数），表单软删后才让删；软删后 code 不复用。 门禁 mvn -B -o clean test → Tests run: 273, Failures: 0, Errors: 0。	2026-10-20 14:30:10 +08:00
chenxing	e4bf960e1b	t14:模块行退役 + 菜单自解析——守卫换 C4 三段角色门，新增 managed/capabilities 端点 ... - FormAdminGuard 整体重写：requireCreate（超管∪校管理员，G1）/requireDefinition（+该表单创建人） /requireData（该表单 ALL 档）/requirePlatformAdmin（校管理员∪超管）；答卷寻址的入口 先由 uuid 反查所属表单再判同一道门（requireDataByAnswer/requireDataByAnswers）； 租户域推导（超管可指定含 0、校级只能本校、传 0 即拒）一字未改 - 摘除 ModuleTreeSource/PlatformModuleTreeSource/FormModuleKeys 与 GetUserMod 端点 （§19 作废-10：中心不再消费授权树，B14 缺口与 H4 依赖随之消失） - 新增 GET /api/form/my/managed（C3：创建人 ∪ form_admin，role 标来源）与 GET /api/form/my/capabilities（{schoolAdmin}，"系统设置"入口唯一数据源）； managed 行额外带 formUuid/status（P120：只给 C3 的"fillable 行+role"点不进设计器/数据页） - 两表/app 注册/GetSchoolAll 守卫切到 requirePlatformAdmin；字典同样吃这一道门 - h2_userbase_app_and_modules.sql 文件头加"整份作废、不再在任何环境执行"注记（正文保留供追溯） - 测试：FormAdminGuardTest 按三段门重写（含批量入口跨表逐张判 ALL、fail-closed 与域推导）； FormBaseControllerTest 改成"GetUserMod 端点反射级不存在"断言；AdminDomainIT/MyAnswerIT/ AnswerAdminIT/AnswerReadIT 的模块行断言换角色门载体；PerfTreeCallsProbe（P44 取树次数） 随度量对象消失而删除	2026-10-20 13:20:58 +08:00
chenxing	f10b367bbc	t13:所有权模型切换——audience 多值门 + ALL/SELF 两档 + 冻结开关，三层模型与身份矩阵出清 ... - DDL sql/t12_access_simplification.sql（非幂等，先查列）：form.audience TINYINT→VARCHAR(64) + 存量迁移、form 加 creator_id/frozen/anon_cookie_minutes、answer 加 anon_ip/anon_ua + idx_answer_form_utime；实体与 @Index 同步（本地库已备份并手工执行） - audience 多值（C1/C2/C5）：FormEnums.Audience 扩 ANONYMOUS + parse/join/namesOf 单点工具； 配置通道收数组并加跨字段约束（含 ANONYMOUS 时 fill_limit 必 0，CUSTOM(5)）； FormView/ResolvedFormView/FillableRow/oapi SchemaView 出参一律数组（flow-center 需通告） - 两档范围（§2.3/D4）：DataScopeService 重写为 {all,self} + 平台级表单的租户限定变体（D9）， 身份默认矩阵与回落分支删除；5 实现器收敛为 ALL/SELF 两个，SCHOOL 谓词并入 ALL 变体、 TEACHING_CLASS 摘除；AnswerScopeQueryBuilder 改吃查询规格（V55 唯一出口不变） - audience 门替第 0 关（§3.1）：AnswerService 的 fillAccess.resolve+requireFillEntry 换成 人群门，requireSubject 指定权收敛为"该表单 ALL 档"；FillAccessService 全类删除； 代录/导入不过人群门（P116 用户裁决：§3.4 与 §5.1/V73 冲突取"功能可用"一侧） - fillable 行形状（C2）：删 canFill/myTier，入集=身份类型 ∈ audience（与提交同一公式） - 冻结开关（§4.2/V61）：config 通道 + 两条编辑通道同关，文案指路"撤回后重新提交"； 新增 AnswerFrozenIT 钉双通道与修正路径 - 创建人识别（C16）：creator_id 建列 + create_by 账号名兜底（兜底取会话线程账号， 与 create_by 同一事实源，不拿 BoaUser.account 跨系统比串） - 测试：FillAccessServiceTest 整类删除（V48 作废）、AnswerFillGateIT 按 v2 语义重写（V66）、 DataScopeServiceTest 按两档重写、AdminScopeIT/AnswerExportIT/ReadFixture 造数改自填路径	2026-10-20 12:54:07 +08:00
chenxing	7af6a98fc0	fix(post-p95): 跨版本编辑必挂/编辑不吃截止闸/自填 subject 归一/报名号并发重号 ... P95 落地后的独立修复批，四条存量逻辑硬伤（填报入口层不动）： - 跨版本编辑必挂：客户端按当前发布版渲染、服务端按钉住旧版校验，升版后编辑永远 400（含未知字段/缺必填）。改为编辑态吃 /my/detail 的钉住版 groups。 - 编辑不吃截止/停用闸：先占位、截止后随便改可绕过 deadline。editBySubmitter 补 截止/停用/已删三闸，与 submit 同口径。 - 自填 subject 落 NULL：subject_id 为空的自填行进不了"关于我的"（/my/about 与 ABOUT_ME 谓词都按 subject 查），V18"含代填"实际退化成"仅代填"。落库归一为 coalesce(subjectId, submitterId)；限次键本就是 coalesce，不受影响。 - answer_no 并发重号：count+1 的 count 与 insert 之间有并发窗口，报名号是对外凭证。 加 uk_answer_no 兜底 + 撞号重算序号重试（3 次封顶），按异常消息列名区分撞的是 报名号还是幂等键（MySQL/H2 通用）。 语义变更备案：自填行 subject 由 NULL 变本人，读矩阵"学生x面向学生=关于我"这一格 此后含自填行，可见集变大（DataScopeService/矩阵规则一字未动，变的是数据形状）。 三处断言随行为更新：AdminScopeIT、AnswerReadIT、MyAnswerIT（+ReadFixture 注释）。 验证：mvn 261 绿（+2 新用例：并发报名号不重复、编辑闸三态）。	2026-10-16 15:04:20 +08:00
chenxing	a02f47ad5c	feat(p95-fill): 填报入口收回中心——三层角色模型 + 提交第 0 关 + 我可填清单 ... 任务书 P95 W1/W2/W3/W7。发一张表单原本要 UserBase 超管加一条 /f/{code} 模块行并组授权， 实测成本不可接受（10 张表=10 次跨系统操作），人群判定收回表单中心自解析。 - FillAccessService：audience × 会话身份（roleIds ∪ currentRole）× 管理员两表 → 层集合 ADMIN/MANAGE/FILL/空=NONE，谓词 canFill/canProxy/isAdmin + topTier；与 DataScopeService 读矩阵、FormAdminGuard 管理端入口三条线正交，结论互不供给 - AnswerService.doSubmit：钉版解析之后插第 0 关（先鉴权后业务，幂等重落在闸门后）； requireSubject 吸收行为表——教师×面向学生只能代填本校学生（P33 existsInSchool 保留）， 层③代填仍沿 canManage 现路径，层①普通成员代填照旧拒 - GET /api/form/my/fillable：会话校 ∪ 平台级取域、复用 FormDefService.pickByShadowing 做 (app_code,code) 遮蔽去重、仅已发布未软删、NONE 不入集，行带 canFill + myTier 两件事， deadline 升序 null 在后；新增 MyModels.FillableRow - h2 登记脚本快应用段 5→4 行：删 /f/ 填报行与学生组授权，保留应用行/管理页面行/ path 空导入导出锚点/学校开通；H2 冻结延续，本轮未在任何环境执行 - 测试：FillAccessServiceTest 16（V48）+ AnswerFillGateIT 14（V49）+ FillableListIT 10（V50）， mvn -B -o clean test 全量 259 绿（教师×面向学生的造数据通道按新口径改代填， 读矩阵与限次等断言判据一字未改） DataScopeService 与 FormAdminGuard 两个文件本轮未被改动（红线 1/2）。	2026-10-16 12:43:31 +08:00
chenxing	dc76574118	feat(t10-admin): 管理员体系——校级管理员+单表单管理员+锚点退役 ... - 新增 school_admin/form_admin 两表（sql/t10_admin_domain.sql，含 answer.submitter_sch_id 加列）与 AdminDomainController/AdminDomainService/SchoolUserTreeService - DataScopeService 范围体系按 P80 验收口径落地：入口只认模块行、查询域=会话校、两表只升范围；新增 SchoolScopeImplementor - fc:scope:all / SCOPE_ALL_CUSTOM_ID / anchorCustomIds / MODULE_DICT 锚点全链路退役，全仓引用归零；h2 登记脚本 6→5 行（快应用段逐字未动） - AnswerScopeQueryBuilder 校域不变式：answer.sch_id 恒=会话校，基础过滤 sch_id+app_code+code+is_deleted 不变 - FormAdminGuard：targetSchId=0（基础表单）仅超管可维护；FormAdminController/AnswerReadController 等按管理员范围收口 - 测试基线 190→219/0/0/0：DataScopeServiceTest 22、FormAdminGuardTest 14、AdminScopeIT 8、AdminDomainIT 10、AnswerReadIT 改写 1、FormBaseControllerTest 7 等	2026-10-15 20:25:03 +08:00
chenxing	bf39c220f2	test(perf)+sql(h2): T9 压测探针与 UserBase 登记交接脚本 ... Perf200kProbe（20 万答卷/78 万索引行，独立库 bsch_formcenter_perf）： - V10 量化：列表首屏 p95=22ms、三条件筛选 p95=313ms、深分页 keyset p95=31ms、 统计 p95=1~334ms、导出 2 万级 4.1~8.1s（冷缓冲池首跑 22.1s 已如实记档） - 铁律取证：org.hibernate.SQL 日志抓真实语句——第一段只 select id、不含 values_json； 翻页谓词是 answer.id<游标；EXPLAIN 显示首屏/计数走 idx_answer_form_time 且 using_index=true - P26：8 线程×250 并发实测 answer_no 重号率=1392/2000（69.6%，"不限次+报名号"组合） - P37：新答卷后 cached=true、升版后 cached=false（铁律④语义与实现一致） - P35/P31：information_schema 复核索引基数与 ROW_FORMAT=Dynamic（本机 8.0.45） - 类名不带 Test/IT → 不进 mvn test 门禁（190 用例仍是快门禁），手点 -Dtest 才跑 PerfTreeCallsProbe（控制器形状，复用同一份数据）： - P44 请求级取树次数：列表/详情/导出=2、统计=3、筛选候选=1（P44 的"1~2 次"上界在统计路径实测为 3） - V10 请求级延迟：筛选 p95=163ms、导出 2297ms/1.15MB - P36 升版补建实测：19,600 行表单的发布=373,272ms 且本次补出 0 行—— P36 记档的"2 万级秒级"不成立，N+1 逐行探测是主因（数字交验收轮裁决是否触发 publish 处改造） sql/h2_userbase_app_and_modules.sql（H2 + 第一个快应用登记交接件）： 中心应用六条模块行（手册 §2.2，含 path 空 fc:scope:all 锚点）+ 快应用五条模块行 （方案 §6.2 checklist，导入/导出为 path 空锚点）+ 组/角色授权与开通 + 验收查询 + 回滚段。 AI 不代跑（沿 flow-center 先例；H2 既定路径是超管在管理端录入，脚本为批量/复核形态）。 步骤 3.5 显式记录"快应用数据视图的后端守卫仍扫中心树"这一过渡口径（T9 报告 P78 附注）。 docs/T6-report.md 已按 P69 从本仓 docs/ 挪至 form-center/docs/（本提交不含该文件）。	2026-10-15 12:57:32 +08:00
chenxing	49b095eb81	feat(read): T4 后端·检索统计+数据范围+导出 ... 四条读出路径（列表/详情/统计/导出）与管理动作行级把关共用 AnswerScopeQueryBuilder 一个谓词构造器（契约 §8 红线）；数据范围按 SysRoleEnum 矩阵×audience 解析 + customId=fc:scope:all 扫描授权模块树，多来源取并集、全不命中回落仅本人提交。 四铁律落地：两段式列表禁 SELECT values_json、keyset 仅提交时间序（游标对外是 uuid）、 覆盖索引化（新增 idx_answer_form_time）、统计缓存键含 form_uuid+version 且仅升版失效+短 TTL。 T3 验收裁决前置三项：P25 answer.form_uuid 精确钉版溯源（删平台级回退启发式）、 P33 代填 subject 存在性+同校（SubjectDirectory 策略接口，生产走 /oapi/user/byId）、 P34 附件 key 与 store_key 一致性比对；P21 FormAdminGuard 整体替换为"授权模块集"口径 （ModuleTreeSource 策略接口，与 scope 解析共用同一棵树）。 新增对外读接口 GET /oapi/form/schema（内联 options+valueSchema）与 /oapi/form/answer （钉住版本 schema+值文档）；导出 easyexcel 流式同步响应，选项列显 label、附件列显 fileName。 自验：mvn -B -o clean package 177 条全绿（本轮新增 56，23 条打真实 MySQL）， 覆盖 V9/V11/V23/V27/V28/V37/V42 + V30 读侧半边 + V39 范围半边； V9 以"发布时补建索引行"实现（方案未指定机制，记 P36）。详见 docs/T4-report.md（问题单 P35~P46）。	2026-10-14 19:00:15 +08:00
chenxing	bff0fb15fa	feat(answer): T3 后端·答卷核心——提交/幂等/限次/索引/软删留痕 + 平台标准版上传 ... 答卷域是"校验只写一遍、索引只有一份"这条选型（D2 模型 2b）的兑现处，本轮把它一次落齐。 - 提交链路按语义排死顺序：钉版解析→截止→幂等命中→subject 授权→值校验→附件同校归属 →fill_quota 占位→落 answer→写索引。幂等必须在限次之前（重放那条本就占着名额）， 限次不做先 count 再插而是事务内撞 uk 即拒（并发下 count 靠不住，方案 §5.4） - 钉版与定义域共用同一条 resolve 遮蔽实现；升版窗口旧版仍可填并钉旧版（P20）， 请求体不含 version/schId/submitterId——身份结构性不可注入（V17） - FormValueValidator 按契约 §3 逐类校验值形状：date 严格 YYYY-MM-DD 且必须是真实日期、 number 空值只认 null、选项值取内联 ∪ allowedValues(含软删条目)、 附件只认 {id,fileName,key} 且拒绝对 URL/跨目录 key - answer_index 只写显式 searchable 字段、多值一行一个、v_str 截 191；编辑按钉住版本重建， 软删同步删行且释放 fill_quota 名额；留痕只增不改，改状态无任何转移规则校验（V15） - 上传模块自写平台标准版：FILE_PATH 三层兜底链、随机存储名、平台 15 项黑名单+svg、 ≤50MB（并按 P12 显式配 spring.servlet.multipart，默认 1MB 会挡掉合法附件） - 数据面刻意不建列表/详情/统计/导出读接口：四条读出路径必须共用 T4 的 scope 构造器， 现在写一个无范围过滤的详情接口就是给 T4 留后门 - T2 已验收文件仅按裁决改动：FormAdminGuard 收紧为 {2,7}（P21）并加 canManage； FormDefService 抽出 resolvePublished/新增 pinnedForData（数据面溯源含软删表单）； FormRepository 加数据面取域查询；application.yml 只加 multipart 两行 自验：mvn -B -o clean package 绿（121 测试，本轮新增 54 条含 39 条打真实 MySQL， V32 并发面用双线程非回滚 IT 取证），逐 V 证据与问题单 P23~P32 见 docs/T3-report.md	2026-10-14 16:50:07 +08:00
chenxing	03f6a971c3	feat(definition): T2 后端·定义域——版本模型、schema 校验器、选项字典与另存副本 ... 定义与答卷物理分离的第一步：把"契约"落进可执行代码，让后续答卷域只需消费不必再解释。 - form/form_version 头表+版本行：已发布行零写路径（改版=v+1 新行，老行逐字节冻结）， 升版期间头表指针不动，使契约 §5 的钉版与 §3.2 的两层缓存声明天然成立；uuid 建草稿即生成 - FormSchemaValidator：19 项属性白名单、14/11 控件、options 只认 {label,value} 数组或 dict:{code} 引用（字符串数组被拒）、searchable 只出显式声明字段、跨版本同 key 不得换 type （否则 answer_index 分类型落值的语义与"删字段后历史仍可筛"当场失效） - 选项字典两级：管理面同层精确匹配（校级改不到平台级）、解析面 {会话校,0} 且本校遮蔽不回落； value 物理不可变而 label 可改；软删条目仍进提交放行集；引用是活引用、只在读路径内联展开 - 表单级配置（audience/fill_limit/deadline 补 23:59:59/报名号/状态定义）留在头表，不随版本快照 - 另存为副本：新 code+新 uuid+version 1、schema 深拷贝且字典引用随行，源表只读 - 出入参不出现库内 id；手写 DDL 落 sql/t2_definition_domain.sql 并按 MySQL 5.7 复核（无 native SQL） 自验：mvn -B -o clean package 绿（67 测试，含 27 条打真实 MySQL 的 IT），逐 V 证据与 9 条 实现期问题单见 docs/T2-report.md	2026-10-14 15:23:35 +08:00