5 路并行核对总览 §9/§10/§11 + A/B 矩阵声明 vs 两仓代码(48 条 46 条完全一致,无虚报),修正不一致处: - A10 行 🔴→🟡:W1 Flyway(V1-V3)+W2-W4 容器化/nginx/compose 骨架 06-25 已合 main,文档此前低报;§10.2 Flyway/compose 两条标 ✅ - §9 P0② 表格「同族扩长」与对抗审查①矛盾(代码一律拒 TYPE 变更)改齐 - §10.2 render-plan 行号迁 AiDraftGateValidator.java:246(SRP 拆分后位置) - §11 报表单测 73→79;§2「五步编排壳」改四步向导 - CandidateUsersHandler 类级 javadoc:scriptUser 已于 06-26 接入(resolveScriptUsers),删「WARN 降级未接入」陈旧表述(纯注释零行为变更) 归档整理(总览 §8 归档候选落地): - 10 份已完成/被取代文档 git mv 入 docs/归档/(06-14×3/06-15/06-16/06-20 plans、CRUD-QA、C3/C5、总览-06-17) - 引用同步改路径:README 索引、M0剩余项登记、通用模板收口计划、架构方向-design、新闻管理plan - README 刷新至 07-02:补 06-22→06-26 增量一节、审批/报表行状态、§2 补登 06-25/06-26 四份 design/计划、§4 过时「未 push」表述修正 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
12 KiB
✅ 已完成·归档候选(2026-06-21):新闻管理切片已修复上线 + live 验收。可后续
git mv入docs/归档/。
新闻管理 功能垂直切片 全 parity Implementation Plan
For Claude: REQUIRED SUB-SKILL: Use superpowers:executing-plans / superpowers:subagent-driven-development 逐任务实施。每条修复 TDD + 浏览器端到端对老系统验收,修完作为其余 ~150 功能的模板再泛化。
Goal: 把「新闻管理」整套功能(管理列表/查看/新闻收藏/新闻收藏分类/查看审批)在 EIP4 做到与老系统 parity 可用,覆盖 5 个已 live 实测的缺口;每个修法可泛化到其余功能。
Architecture: 缺口分布在 4 层:菜单裁剪(MenuController)、转换器 onEvent 脚本挂回、转换器树可编辑性、转换器表单/显示列。逐层定位根因后最小修 + 全量重转(涉及产物的)+ 浏览器验收。
Tech Stack: Java 21(JAVA_HOME=/opt/homebrew/opt/openjdk@21,mvn 默认 Java26 崩 Groovy)、dom4j、JUnit5、Spring Boot 3、amis 6.13(前端 TS/Vitest)、PG15(localhost:5433/eip4dev schema eip3)。运行时 8093(platform)/8089(flowable)/5173(vite)。登录 admin/111111。
缺口总览(均 2026-06-14 live 实测 + 根因定位)
| WS | 现象(对老系统) | 根因 file:line | 修复层 | 是否需重转 |
|---|---|---|---|---|
| A | 管理列表菜单 admin 看不到(ddb75614 不可达) | MenuController.java:102 按 view_sys_usermenuid 裁剪;admin 未授权 b6d6be5a |
后端菜单/权限 | 否 |
| B | 列表选中按钮不联动 + 满屏 ajax 报错 | P0(已修) + attachScriptOnEvent:1644 只挂 FULL_AUTO 漏 NO_S3 + 不分事件/组件 |
转换器 onEvent | 是 |
| C | 新闻收藏(浏览)左树能编辑分类(应只读) + 新闻收藏分类(管理)只读且 label=undefined(应可编辑) | convertTreeGrid:1224 对 type=4 调 applyTreeNodeCrud 传播编辑按钮;convertTree:1185 对 type=3 只 degrade 不映射;tree source label 未解析 |
转换器树 | 是 |
| D | 查看页无附件下载列表 + 发布人列显「-」 | DOCUMENT→input-file 只读态空;发布人(USERSEND_ID)引用列 NVARCHAR 未解析 | 转换器表单/显示列 | 是 |
| E | (验收)查看审批入口未接业务页 | 见 docs/EIP4-架构与缺口现状 / 待办中心已有 TraceTimeline |
接线 feature | — |
执行顺序建议:B(已出详细计划,最高杠杆 ~380 页)→ C(树,影响 ~95 收藏/分类页)→ A(菜单,决策项小修)→ D(显示,P1)→ E(验收+查看审批,单独评估)。每 WS 修完即浏览器验收。
WS-A:管理列表菜单可达(admin/超管见全部)
根因(已证据级): sys_menu 有叶子 新闻管理 b6d6be5a → view_templateid=ddb75614(seq10),但 MenuController(:85-102) SELECT trim(menuid) FROM view_sys_usermenuid WHERE userid=? 裁剪可见叶子;admin(ADMIN) 在该视图有 查看新闻/新闻收藏/收藏分类、无 b6d6be5a → 管理列表整页不可达。老系统截图 admin 在用该页。
决策项(实施前与用户确认;默认推荐①):
- ① MenuController 对 admin/超管 bypass 裁剪(见全部 isactive 菜单)——robust,符合"系统管理员见全部"直觉。需确认本系统超管判定信号(userid='ADMIN'?某超管角色?grep sys_user/role 超管标记)。
- ② 数据层给 admin 授权 b6d6be5a(view_sys_usermenuid 是计算视图,须溯源 role/user 授权表补授权)——更"忠实老数据"但需查老系统 admin 是否本就被授权。
Task A.1(Spike):确认超管判定信号 + 老系统 admin 是否本应见全部
- 查 sys_user/sys_role 是否有超管标记;查老系统(EIP-3.0 / framework)菜单裁剪是否对 admin bypass。
- 产出:判定信号 + ①/②决策。
Task A.2:实现(按决策,默认①)
Files: Modify platform-metadata/src/main/java/com/eip4/platform/metadata/web/MenuController.java(visibleLeaf 集合构建处);Test 同包 controller test。
- Step1 失败测试:mock 当前用户=admin/超管 →
/api/menuroots 含 b6d6be5a(新闻管理 leaf, templateId=ddb75614)。 - Step2 运行失败。
- Step3 实现:超管短路——visibleMenuIds = 全部 isactive menuid(不 JOIN usermenuid)。
- Step4 通过。 Step5 commit
feat(menu): admin/超管菜单见全部(管理列表可达)。 - Step6 浏览器验收:admin 登录 → 信息站/新闻管理 下出现「新闻管理」管理列表叶子 → 点开 = ddb75614 列表(13 按钮)。
WS-B:onEvent 脚本挂回(按钮联动 / 表单只读联动)
P0(rewritten-root 路径)已修并提交
7b76dce。本 WS 修 P0+(seq 映射/覆盖/事件类型/组件)。完整 TDD 细化见原稿docs/归档/2026-06-14-onEvent脚本挂回修复-plan.md(Phase 0 Spike→Phase 4 验收),此处仅列要点,实施以原稿为准。
根因: TemplateToAmisConverter.attachScriptOnEvent:1644 只挂 full_auto_index.json 的 FULL_AUTO 脚本(漏 NO_S3 的「按钮状态控制」onselectedscript),且每段同挂 inited+change 不分事件/组件;工具栏按钮无 id 致 enableButton 指令定位不到。影响 930 onselected/422 onload/259 enableButton 模板。
要点(详见原稿):
- Phase 0 Spike:crud 行选中事件名(预期 selectedChange)/item 表达式(${selectedItems[0]});
disabled/enabled按 id 定位 headerToolbar 按钮可行性;componentId↔按钮 id 对齐。 - Phase 1:
scriptKeyToSeq(解析 文档序) +extractEventBindings(onselectedscript/onloadscript 属性→key)。 - Phase 2:重写
attachScriptOnEvent按事件类型挂(onselected→selectedChange item=选中行 / onload→inited),覆盖 NO_S3+FULL_AUTO;scriptActionChain支持自定义 item 表达式;BatchConvertCli 改由 XML 绑定驱动。 - Phase 3:
buildToolbar按钮补id(:431) + 必要时 ScriptFacade.enableButton/scriptCommands 适配。 - Phase 4:全量重转(rewriterDir=tools/s3_rewriter/output 保 onEvent)+SchemaImportCli 入库 + 重启 8093 + 浏览器强断言(选中 STATUS=3/ISSEND=0 行→发布点亮)+回归。
WS-C:收藏树可编辑性(type=3 可编辑 / type=4 只读)+ undefined 标签
根因(已证据级):
- type=4(新闻收藏 50ac13b2,convertTreeGrid:1197)::1224 调
applyTreeNodeCrud,读被引用分类树(a763d48d)的<node><buttons>→ 给浏览页左树加 editable/removable/「新增分类」按钮。浏览页本应只读导航。 - type=3(新闻收藏分类 a763d48d,convertTree:1165)::1185 对
<node><buttons>只result.degrade不映射 → 输出只读 input-tree。管理页本应可编辑。 - undefined 标签:type=3 树 source=
/api/flow/{selectservice}(:1174),返回项的 label 字段未解析(树节点显「undefined」)——类同 GeneralPO 虚拟显示列问题(3feefb3)。
修复策略:把可编辑逻辑从 type=4 挪到 type=3。 即 applyTreeNodeCrud 抽成可复用的「给 input-tree 加节点 CRUD」,type=3 调用它(管理页可编辑),type=4 不调用(浏览页只读)。
Task C.1(Spike):定位 undefined 标签源
- 浏览器/curl
/api/flow/{a763d48d 的 selectservice}看返回项字段(label/value/名称列),定位为什么 amis 树显 undefined(label 字段名不符 or 显示列未算)。读 TemplateTreeController / 树 source builder。 - 产出:label 解析修法(树 source 返回 {label:显示列, value:主键} 或转换器/后端补显示列)。
Task C.2:type=3 convertTree 支持可编辑(含 undefined 修)
Files: Modify TemplateToAmisConverter.java convertTree(:1165-1194);复用/抽取 applyTreeNodeCrud 的按钮→editable/creatable/removable+addApi/editApi/deleteApi 映射;Test 同测试类。
- Step1 失败测试:type=3 树 XML 含
<node><buttons>(insert/update/delete/save+servicename) → 转出 input-tree 含creatable/editable/removable+ 对应 addApi/editApi/deleteApi(/api/flow/{svc})。 - Step2 失败。
- Step3 实现:convertTree 检测 buttons → 调抽取后的节点 CRUD 映射(取代 :1185 的纯 degrade);新增=弹窗表单(复用 buildTreeNodeAddButton)或内联 creatable(取 C.1 实体必填列结论)。label 按 C.1 修。
- Step4 通过。 Step5 commit
feat(converter): type=3 声明式树支持节点增删改(收藏分类管理页可编辑)。
Task C.3:type=4 convertTreeGrid 左树只读
Files: Modify convertTreeGrid(:1224)。
- Step1 失败测试:type=4(tree+grid) 转出左 input-tree 不含 editable/removable/新增按钮(即不调 applyTreeNodeCrud 的编辑传播)。
- Step2 失败。
- Step3 实现:移除 :1224 的 applyTreeNodeCrud 调用(或改为只构树不加编辑);左 body 仅树。
- Step4 通过。 Step5 commit
fix(converter): 树+列表浏览页左树只读(收藏页不再误带新增分类)。
Task C.4:重转 + 入库 + 浏览器验收
- 全量重转(保 onEvent)+SchemaImportCli + 重启 8093。
- 验收:新闻收藏(50ac13b2) 左树无新增分类、只读筛选;新闻收藏分类(a763d48d) 树可增/改/删节点、节点名正常(非 undefined)。通知收藏/通知收藏分类(22786b70/f359a080) 同样正确。
WS-D:查看页附件下载列表 + 发布人显示列
Task D.1(Spike):附件数据模型
- 查老系统附件如何存取(EIP-3.0/framework grep 附件/attachment/BLOB/file;DB 看 OA_NEWSMANAGE 附件挂在哪:DOCUMENT 列? 独立附件表 keyed by 业务id?)。
- 查 EIP4 现有
/api/file/*(FileController)能否按业务 id 列出已有附件。 - 产出:查看(只读)态渲染已有附件列表+下载的方案(amis input-file 静态值/只读 file 列表组件 + source api)。
Task D.2:查看表单附件只读下载列表
Files: Modify TemplateToAmisConverter(DOCUMENT/附件字段映射,convertViewPage/convertForm 只读分支);可能后端补「按业务 id 列附件」端点。
- TDD:查看表单 DOCUMENT 字段 → 只读态渲染已有附件(文件名+大小+下载/全部下载),非空上传按钮。
- 浏览器验收:有附件的新闻查看 → 显示附件可下载(对齐老系统截图)。
Task D.3:发布人等用户引用列显示
Files: Modify UserColumnResolver(CRUD QA 已记「用户类引用列 NVARCHAR 同病未覆盖」)——CREATEBY/USERSEND_ID/发布人列 id→姓名。
- TDD + 浏览器:查看新闻/新闻收藏列表 发布人显姓名(非「-」/裸 id)。
WS-E:端到端验收 + 查看审批 + 泛化
Task E.1:新闻管理整套端到端走查(对老系统截图逐屏)
- 管理列表(添加/修改/删除/查看/发布/显示/隐藏/置顶/文件归档/取消置顶/提交审批/查看审批/导出Excel 13 按钮,选中联动)、查看(附件)、新闻收藏(只读浏览)、新闻收藏分类(可编辑)、提交/查看审批。强断言+截图。
Task E.2:查看审批入口(评估,可能拆独立 feature)
- 引擎层已统一(FlowableClient.trace+8089+ApprovalBar/TraceTimeline 在待办中心)。给列表/查看页注入「查看审批」按钮→复用 TraceTimeline 抽屉;BPMN 图为较大件可后置。详见 E 调查(本会话 agent 已出缺口清单)。
Task E.3:泛化清单
- 每个 WS 修法对其余功能的影响面与回归点:WS-B 930/422 页;WS-C ~95 收藏/分类页(type3=50、type4=45);WS-A 全菜单;WS-D 全用户引用列/全附件查看页。记录回归比对口径。
全局验收 / 回滚
- 每 WS 改转换器后:
JAVA_HOME=…@21 mvn -o -pl platform-converter -am test绿 → 全量重转 → SchemaImportCli 入库(幂等 upsert) → 重启 8093 → 浏览器强断言。 - 回滚:转换器 git 还原 + 重转上一版;菜单/后端改动 git 还原。
- REQUIRED:superpowers:verification-before-completion(每 WS 浏览器实证后才算完成,不停在「组件出现」)。
提交
- 两仓本地 main、无 remote;按既有协议本地原子 commit,不自动 push。P0 已提交 7b76dce。