> ⚠️ **已归档(2026-06-17)**:本文「16 视图已交付」为 demo 级、未逐功能 parity 验收,后续「数据驱动重审」已纠正。**勿据本文判断进度。** 当前状态以 `docs/README.md` + `framework定制视图-engineclass移植backlog-2026-06-17.md` 为准。 # Framework 层「系统管理」视图 EIP4 实现交付报告 > 日期:2026-06-17 | 配套:`framework系统管理视图-功能点Parity对照与实现计划-2026-06-16.md`(gap 矩阵) > 验收基准:对照旧版逐功能点核对,功能点不能丢(不是「有 controller/页面」就算)。 > 本期范围(用户决策):核心系统管理 + 设计器 + 选人器穿梭 + 服务流编辑器;**排除**数据导入、自定义模板设计器、报表/功能模板下载(留旧)、工作流批次(待办/审批等本批未选)。 ## 0. 总览 3 批并行实现(按文件归属切分不冲突车道),共落地 **16 个视图**、**~45 个新端点**、**9 个新管理页 + 3 个改造页 + 1 个 React 穿梭组件**。 | 验证维度 | 结果 | |---|---| | 后端全量 reactor 构建(`mvn -T1C clean install` 含 ArchUnit + JUEL 对拍) | ✅ 三批均绿 | | 后端单测(各车道) | A1 38 / A2 14 / 转换器 125 / Log 8→15 / 岗位 13 / 用户组+ 52 / Me 10 / UserSelect 9 / CodeRule 4 / ServiceFlow 11 | | 前端 `vite build` + `vitest` | ✅ 绿;vitest 28→35(+选人器组件 7) | | 8093 live:15 页 schema 服务 | ✅ 全 200(DB 驱动 PageSchemaController) | | 8093 live:新端点注册 | ✅ 全部 200/403(受 requireAdmin 保护),无一 404 | | DB schema 重导 sys_page_schema(eip4dev/eip3) | ✅ 12 个 upsert 全成功 | 系统管理菜单从 6 项扩到 **14 项** + Topbar「个人设置」入口。 ## 1. 逐视图交付状态(对回 parity 功能点) ### Batch 1 · 止血 + 复用已建基建 | # | 视图 | 状态 | 交付内容 | 验证 | |---|---|---|---|---| | 1 | 数据权限配置 **P0** | ✅ | 写侧改结构化条件构建器→序列化 Conditional JSON(保真层零改);裸 WHERE 拒绝;新增 `GET /api/admin/filterrules/{id}` 详情解析回填 | live 坐实:结构化条件↔JSON↔运行时全链路;现存数据已 JSON 无需迁移;单测 38 | | 2 | 客户信息 navigation | ✅代码 ⏳部署 | 转换器通用 `case "navigation"`→amis actionType=dialog + 主键注入(全库受益) | 单测 125(含 3 新);**需全库重转才 live**(见 §3.1) | | 3 | 系统日志查询 | ✅ | `LogController`(types/deleteByType/deleteAll 桥接已移植 systemLogManager)+ `sys-admin-log` 页 + 菜单 | live:SYS_LOG list 通;单测 8 | | 4 | 用户管理 | ✅ | `AdminUserController` 补:删除/扩展编辑/岗位/**设主岗位**/查看用户菜单 5 端点 + schema 按钮 | 端点注册+schema live;单测 14 | ### Batch 2 | # | 视图 | 状态 | 交付内容 | 验证 | |---|---|---|---|---| | 5 | 岗位管理(+分公司) | ✅ | `PositionController` 7 端点(部门枝/岗位叶树、岗位 CRUD、岗位人员差量授派)+ `sys-admin-position` 页 + 菜单;设主岗位复用 #4 | live:tree/users 200 实数据;单测 13 | | 6 | 用户组管理 | ✅ | 补搜索(keyword)/复制(copy)/说明列;三栏权限分配页增强 | 单测 52 | | 7 | 个人设置/改密 | ✅ | `MeController` 7 端点(自助改密 MD5 校验/手机/主岗位/上级)+ `sys-me-profile` 页 + Topbar 入口 | 端点注册+schema live;单测 10 | | 8 | 选人器穿梭组件 | 🟡组件就绪 ⏳接线 | `UserSelectController` 7 维度端点(全部/部门树/岗位类别/用户类别)+ `UserTransferPicker` React 穿梭组件(已注册 amis 自定义控件) | live:position-types 返真实「分公司经理」等;单测 16;**需转换器接线+重转才自动进 883 表单**(见 §3.2) | ### Batch 3 | # | 视图 | 状态 | 交付内容 | 验证 | |---|---|---|---|---| | 9 | 枚举组 | ✅ | `EnumController`(枚举组树/实体筛选)+ `sys-admin-enum` 页 + 菜单 | live:返真实 370 枚举组带条数 | | 11 | 数据字典 | ✅核心 🟡降级 | `sys-admin-entity` 页(实体列表 + SYS_RULE 规则 dialog,复用 EntityController/失效缓存)+ 菜单 | schema live。降级:脚本工具(任意SQL高危)/默认服务流未做 | | 12 | 编码管理 | ✅核心 🟡构建器 | `CodeRuleController`(列表解析实体/字段名、取号预览)+ `sys-admin-coderule` 页 + 菜单 | live:90 条真实规则;单测 4。规则段构建器为只读拼装预览(RULE 文本权威) | | 14 | 设计中心短板 | ✅ | 未保存守卫(beforeunload+脏标徽标)+「全部 schema」模式(新增 `GET /api/page/schema/list`) | tsc 绿;list 端点 live 注册 | | 16 | 登录历史/操作信息 | ✅ | `LogController` 扩 3 端点(按 USERID+时间区间查/桥接 deleteByLoginTime/用户选项)+ 2 页 + 菜单 | 单测 15;VIEW_SYS_USERLOGINFO 已在白名单 | | 18 | 服务流编辑器 | ✅结构化 🟡图形 | `FlowDefinitionController` 3 端点(contentxml↔结构化 JSON 双向 dom4j)+ `sys-admin-serviceflow` 页 + 菜单 | 单测 11。结构化编辑(非图形);复杂分支流降级只读源码 | ## 2. 关键技术决策 - **P0 修法**:选「写侧序列化对齐运行时」而非改保真层(DataFilterHelper/DataPrivilegeServiceImpl 零改),同时还原 EIP3 结构化条件构建器(字段/运算符/类型令牌 CURRENTUSERID 等)。 - **并行纪律**:每批按文件归属切不冲突车道(RBAC 后端 / 新控制器 / 转换器 / 前端各自独立文件),menu.ts·Topbar·白名单由集成统一加,避免并行改同文件冲突。批次间串行(Batch2 岗位/用户组改 AdminController 与 Batch1 同文件)。 - **数据驱动优先**:列表/CRUD 类尽量复用 EntityController/EntityWriteController + sys_page_schema,仅 bespoke 逻辑(设主岗位/日志删除/服务流 XML/取号预览/选人维度)新建薄端点。 ## 3. 剩余部署 / follow-up 项(精确) ### 3.1 全库重转重导(让 navigation 全库 live) navigation 转换器改动已 code+单测完成,但需重转才作用于存量页: ``` cd eip4-platform # 1) 重转(读源库→写 platform-converter/转换产物/schema/*.json) java -cp "platform-converter/target/classes:$(cat /tmp/cp.txt)" com.eip4.platform.converter.BatchConvertCli # 2) 重导(转换产物→sys_page_schema) java -cp "..." com.eip4.platform.metadata.schema.SchemaImportCli ``` 属触及 ~1489 页的部署操作,建议受控执行 + 抽查(客户信息 f897e7a6 升级历史按钮为验证样例)。**本会话未自动跑**(加性改动、回归面仅限 navigation 按钮页,但仍建议人工把关)。 ### 3.2 选人器转换器接线(让穿梭组件自动进表单) `UserTransferPicker` 组件已就绪+注册,但转换器尚未把老 `UserSelectWindow` 引用产出 `type=user-transfer-picker`。落点:`platform-converter` 的 `UiTypeMapper`——识别 dialogid 指向 UserSelectWindow 族模板(singleUserSelectTempId=1b6820ad… / departSelectTempId=138b7ca7…)的人员选择字段→产 `{type:'user-transfer-picker',name,multiple}`。改后随 §3.1 一并重转生效。(当前组件可用于手写 schema。) ### 3.3 鉴权 live dogfood 管理类写端点(设主岗位/删用户/改密/复制用户组/服务流保存等)需 admin 会话点透;本会话 admin/admin 口令不对,已用「单测覆盖逻辑 + 端点注册 + schema 服务 + 数据格式 + live 只读数据」多重替代验证。**提供 admin 口令后可一次性 dogfood 全写路径**。 ## 4. 本期未做(已定范围,非遗漏) | 视图 | 处置 | 理由 | |---|---|---| | 数据导入(配置+执行管线) | 暂缓 | 迁移期/初始化工具,非日常高频;需 POI+Groovy 导入管线 13d | | 功能/视图编辑列表-自定义(自定义模板设计器) | 暂缓 | 终端用户自建弹窗/报表模板,22d 最大项;设计中心 overlay 已兜底 | | 功能模板下载 / 报表 | 留旧 | 既定 legacy-keep(报表 P4 另立 BI 方案) | | 工作流批次(待办/已办/查看审批/流程定义/监控/我的发起/审批表单删除/流程选择框) | 后续批次 | 本轮范围用户未选(WfTemplate 审批已先行上线) |