Files
eip4-platform/docs/归档/framework系统管理视图-实现交付报告-2026-06-17.md
zhengwr 1b69f8b481
Some checks failed
ci / build-test-parity (push) Has been cancelled
docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
- 从工作区根 docs/(非 git,未版本化)合并全部文档进版本控制,消除文档两头分裂
- 新增 README(状态总览+模块完成度+全文档索引)、项目进度与路线-总览-2026-06-17(A兼容/B新功能+关键路径+待拍板决策)
- 被取代的冲突状态/审计快照归入 归档/;对最易误导的两份("16视图已交付"实现交付报告、06-13架构快照)加"已归档"横幅
- 现行权威:engineclass移植backlog(46视图) + 用户管理Delta移植(方法论/交接) + 组件设计体系 + 通用模板收口 + 客户沟通
- 诚实口径:纵向模块仅用户管理 parity,横向引擎地基较全,余 153 定制视图(47 framework+106 业务)多为通用页已产·delta 未移植

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 14:53:29 +08:00

83 lines
8.2 KiB
Markdown
Raw Permalink 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-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 审批已先行上线) |