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>
This commit is contained in:
136
docs/归档/2026-06-14-新闻管理垂直切片-plan.md
Normal file
136
docs/归档/2026-06-14-新闻管理垂直切片-plan.md
Normal file
@@ -0,0 +1,136 @@
|
||||
> ✅ **已完成·归档候选(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。
|
||||
Reference in New Issue
Block a user