From 5946afa6e685e424715c86791958a0eed9431638 Mon Sep 17 00:00:00 2001 From: zhengwr Date: Wed, 17 Jun 2026 18:02:20 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=90=8C=E6=AD=A5=E6=9C=AC=E4=BC=9A?= =?UTF-8?q?=E8=AF=9D=E8=BF=9B=E5=B1=95=E5=88=B0=E7=8A=B6=E6=80=81=E6=80=BB?= =?UTF-8?q?=E8=A7=88(real-first/=E6=A0=91=E7=BC=96=E8=BE=91=E5=B8=83?= =?UTF-8?q?=E5=B1=80/=E6=97=B6=E9=97=B4=E6=AE=B5=E8=BF=87=E6=BB=A4+Wave=20?= =?UTF-8?q?A=E4=B8=A4=E9=A1=B9)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit README §0/§1.1/§1.3 更新: - §1.3 横向能力新增 3 个全站通用保真修复(树编辑 布局保真、搜索时间段 过滤 date-range→DateTime[]、real-first 流解析)+ 机制①扩出整页改写器。 - §1.1 功能模板下载/枚举组 → ✅,日志组 → 🟡(删除按钮接+real-first修通+时间段通)。 - §0 加本会话进展提要(6 提交已 push origin/main)。 Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/README.md | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/docs/README.md b/docs/README.md index 4a0e883..ca8b1ce 100644 --- a/docs/README.md +++ b/docs/README.md @@ -10,6 +10,8 @@ **横向地基铺得较全**(转换器通用能力 / 保真层 / 审批基础设施 / 写路径 / 机制①),但**纵向"按系统模块做到 parity 验收"目前只有「用户管理」1 个完成**。其余 ~45 个 framework 定制视图 + 业务模块,多处于"转换器产出了通用页、但 engineclass 的 Java 定制 delta 未移植 / 未逐功能验收"。详见 §1。 +> **本会话进展(2026-06-17 续,6 提交已 push origin/main `1b69f8b..fb8a37d`)**:三个**全站通用**保真修复 + Wave A 两项。详见 §1.3 横向能力(real-first 流解析 / 树编辑布局保真 / 搜索时间段过滤)与 §1.1(功能模板下载 ✅、枚举组 ✅、日志组 🟡)。这些通用修复一次性惠及全库搜索/树编辑/列表页,非单视图。 + --- ## 1. 模块完成度(诚实口径) @@ -23,13 +25,15 @@ | **用户管理** | 用户管理 629463ae | ✅ | 列表/设置主岗位/查看菜单/主部门主岗位树选/picker 显名/filterscript 级联,逐字段 dogfood 验收。剩:编辑页 org picker 查询条件、导出 Excel | | RBAC/组织 | 用户组/角色/菜单维护/部门/数据权限授权 | 🟡 | 2026-06-14 搭了 CRUD 端点 + amis 后台页,但 demo 级、未对照旧版逐功能验收 | | RBAC/组织 | 岗位管理/分公司岗位管理 | 🟠 | 通用页在;engineclass「设置(岗位↔用户 picker)」未移植 | -| 元数据/平台工具 | 实体/服务流/视图管理/功能管理/枚举组/自动编号/定时任务/数据导入配置 | 🟠 | 通用页在;重写服务/设计器/脚本编辑器等重度 delta 未移植 | +| 元数据/平台工具 | 实体/服务流/视图管理/功能管理/自动编号/定时任务/数据导入配置 | 🟠 | 通用页在;重写服务/设计器/脚本编辑器等重度 delta 未移植 | +| 元数据/平台工具 | 功能模板下载(设置 13accf09/管理 0246d4bd) | ✅ | `b5fe995` 机制①整页改写器:去右表单「添加」按钮 + 标题「编辑模板附件」+ `3276774` 布局保真。门控③(VIEW_TEMPLATEID 非空才显)暂延后 | +| 元数据/平台工具 | 实体分类-枚举组 b114351f | ✅ | 已核对:EIP4 树端点 PK 唯一+去重+全量建树,天然规避老 UUID 防重逻辑,无需移植 | | 流程/审批 | 待办/已办/我的发起任务 | 🟠 | 通用列表页在但工具栏空;「查看详细/处理」按钮未接(审批基础设施 🔵 已就绪,缺列表入口接线) | | 流程/审批 | 查看审批/流程监控/流程定义/审批表单删除 | ❌🟠 | 查看审批=bespoke 未起步;流程定义=Flowable Modeler 另案 | | 消息/邮件 | 收到/已发送消息、短消息 | 🟠 | 列表页在(有删除);查看弹窗/发送/已读联动未接 | | 消息/邮件 | 电子邮件全家桶(收件箱/发件箱/配置) | ❌ | 等同独立 webmail 子系统,另案立项 | | picker 控件 | 用户选择框×4 / 流程选择框 | ❌ | bespoke 穿梭框(机制④自定义组件),审批/表单/短消息全链路依赖,**keystone** | -| 日志/历史 | 系统日志/登录历史/登录操作 | 🟠 | 通用页在;删除按钮(systemLogManager)未接 | +| 日志/历史 | 系统日志/登录历史/登录操作 | 🟡 | `17c449c` 删除按钮组已接(机制①+LogController systemLogManager);列表经 real-first 修通(原 SYS_USERLOGIN_HISTORY_SEARCH 报 createtime 缺列);时间段过滤已通。剩:登录操作列表 VIEW_SYS_USERLOGINFO 此库缺视图 | | 其它 bespoke | 个人设置/工作日历/报表 | ❌ | 无 XML,逐个从零 | > framework 定制视图共 46 个,逐视图清单与移植项见 **`framework定制视图-engineclass移植backlog-2026-06-17.md`**(主 backlog)。 @@ -41,7 +45,10 @@ ### 1.3 🔵 横向能力(已就绪,跨模块共用) - **转换器通用能力**:navigation 按钮、type=101 树形选择框、picker 引用列显名、filterscript 级联(组织→部门→岗位,已收口静态可达部分)、title 修正、colspan 栅格、A0 控件(密码/附件/日期)、EditGrid 子表递归。 -- **机制①** `EngineclassDelta`:engineclass FQN → 工具栏按钮注册表(移植 new-button 的复用骨架)。 +- **🆕 树编辑表单布局保真**(`3276774`):type=3 可编辑树 master-detail 现按 view_page `` 的 `
` 槽位排版 + 隐藏未布局字段(VERSION/主键/引用 id 等绑提交但不显示)——与 EDITFORM 同口径 `buildFormBody`,修「树编辑泄露隐藏字段 + 裸列名标签」。影响 41 可编辑树页。 +- **🆕 搜索时间段过滤**(`fb8a37d`,全站通用):amis `input-date(time)-range` 的 `"起,止"` 串在保真层读流路径(NAMED_READ/SYNTHESIZED)转 `DateTime[]`,接通引擎 GeneralPO 区间查询 `(col>=起 AND col<=止)`;认 unix 秒/毫秒/格式化;只碰 DATE/TIME 列(零回归)。修「操作日志等时间段查不动」。 +- **🆕 real-first 流解析**(`abc32af`):`_SEARCH` 优先真实 serviceflow(忠实旧引擎,无运行时合成兜底覆盖),统一所有操作读存储流。修约 107 列表打不开(无 createtime)+ 157 排序错;A/B 新修 33。 +- **机制①** `EngineclassDelta`:engineclass FQN → 工具栏按钮注册表(REGISTRY)**+ 整页改写器(MUTATORS,`b5fe995`,覆盖非 crud 加按钮类 delta:移除/改写默认页元素)**。 - **审批基础设施**:后端 `ApprovalController`(approval-meta/business-data/action)+ `TodoController`(trace)+ BusinessRecordLoader/WfTemplateService/StatusWriteback;前端 `ApprovalDrawer.tsx`(业务表单+轨迹+动态按钮+提交)。**已建成,缺的是 amis 列表页的入口按钮接线。** - **保真层/写路径**:JUEL(jakarta.el JSR-223)跨流条件求值、增删改查 + 提交审批桥(ProcessCoreServiceBridge)、PG 升级、Flowable 升级。