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

137 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
> ✅ **已完成·归档候选(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`(解析 <scripts> 文档序) + `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。