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

8.2 KiB
Raw Permalink Blame History

⚠️ 已归档(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 审批已先行上线)