Some checks failed
ci / build-test-parity (push) Has been cancelled
- 从工作区根 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>
83 lines
8.2 KiB
Markdown
83 lines
8.2 KiB
Markdown
> ⚠️ **已归档(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 审批已先行上线) |
|