Files
eip4-platform/docs/归档/2026-06-14-新闻管理垂直切片-plan.md
zhengwr 1b02036153 docs+javadoc: 文档-代码对抗核查对齐 + 归档候选物理归档
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>
2026-07-02 08:01:23 +08:00

12 KiB
Raw Blame History

✅ 已完成·归档候选(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/menu roots 含 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。