- 从工作区根 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>
8.2 KiB
⚠️ 已归档(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 审批已先行上线) |