P4-6: platform-flow-gateway 待办→业务页映射(tablename→templateId→pageUrl)
- 侦察口径:sys_entity+view_templateentity+view_template 两步映射;
多模板优先级 type=7(表单)>1(列表)>其余升序,同 type 按 templateid 字典序取首个
- 新建 PageTemplateService:findTemplateId() 查只读客户库,
@Cacheable("pageTemplateByTable") Caffeine TTL=10min/maxSize=2000
- FlowGatewayConfig 启用 @EnableCaching + flowGatewayCacheManager(Caffeine)
- TodoItem 增加 pageTemplateId/pageUrl/pageUrlReason;
查不到映射时 pageUrl=null+reason,前端据此禁用跳转(优雅降级)
- TodoAggregator 注入 PageTemplateService,aggregate 逐条 fillPageTemplate
- PageTemplateMappingTest 10 单测;TodoAggregatorTest 补 @Mock PageTemplateService
- 验证:真实用户(829cdcca)3 条待办带出 templateId=7042cb37(PM_SAFE_CLARIFICATION/安全技术交底),
与客户库直查一致;全反应堆 31+ArchUnit 绿
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
@@ -182,3 +182,103 @@ platform-app 进程存活(引擎宕机不拖垮单体,明确 503 语义而非 50
|
||||
- 验证完成后 `kill` 本任务起的 8089 / 8090(8084 未动)。
|
||||
- 客户库零写入;本地 eip4m0 测试数据为可重复构造的自举工件(bootstrap-datastatus.sql)。
|
||||
- eip4flow 迁移副本上 1 条真实 complete 已完整登记(实例 20334081 结束)。
|
||||
|
||||
---
|
||||
|
||||
## P4-6 增补:待办→业务页映射(tablename → templateId → pageUrl)
|
||||
|
||||
> 日期:2026-06-11 | 任务:P4-6 —— `TodoItem` 增加 pageTemplateId/pageUrl 字段;
|
||||
> 映射口径侦察;Caffeine 缓存;单测 ≥4;真实待办验证
|
||||
|
||||
### P4-6.1 映射规则结论(侦察客户库 view_templateentity + view_template + sys_entity)
|
||||
|
||||
**两步映射**:
|
||||
1. `SYS_DATASTATUS.tablename` → `sys_entity.sys_entity_id`(entityid):`UPPER(tablename)` 归一大小写
|
||||
2. `entityid` → `view_templateentity.templateid`(经 `view_template.type` 优先级筛选,取最优一条)
|
||||
|
||||
**多模板优先级规则**(`TemplateType` 枚举语义 + 待办填写场景):
|
||||
|
||||
| 优先级 | type | 名称 | 理由 |
|
||||
|--------|------|------|------|
|
||||
| 0(最优) | 7 | EDITFORM 表单模板 | 待办详情 = 填写/审批页面,表单模板最贴近 |
|
||||
| 1 | 1 | GRID 列表模板 | 无专属表单时退回列表页 |
|
||||
| 2–5 | 3/4/6/5 | 树/树列表/组合/日历 | 功能性模板,语义次之 |
|
||||
| 6–7 | 100/101 | 弹窗选择 | 非主页面,兜底 |
|
||||
| 8 | 200 | 报表模板 | 报表展示,非流程业务页 |
|
||||
|
||||
同 type 多条时按 `templateid` 字典序取首个(稳定可重复)。
|
||||
|
||||
**数据佐证**(客户库直查):
|
||||
- `OA_SEALUSEAPPLY`:有 type=7「填写印章使用申请」→ 优先选 type=7 ✅
|
||||
- `PM_SAFE_CLARIFICATION`:仅 type=1「安全技术交底」→ 退回 type=1 ✅
|
||||
- `PM_CONTRACTACCOUNTS`:仅 type=1「项目分包合同决算」→ type=1 ✅
|
||||
|
||||
### P4-6.2 实现要点
|
||||
|
||||
| 文件 | 变更 |
|
||||
|------|------|
|
||||
| `pom.xml` | 新增 `spring-boot-starter-cache` + `caffeine` 依赖 |
|
||||
| `FlowGatewayConfig` | `@EnableCaching` + `flowGatewayCacheManager`(Caffeine,TTL=10min,maxSize=2000) |
|
||||
| `PageTemplateService`(新建) | `findTemplateId(tableName)` 查客户库两步映射,`@Cacheable("pageTemplateByTable")`;`buildPageUrl()` 静态工具 |
|
||||
| `TodoItem` | 新增 `pageTemplateId`/`pageUrl`/`pageUrlReason` 三字段 |
|
||||
| `TodoAggregator` | 注入 `PageTemplateService`;`fillPageTemplate()` 填充新字段;降级写 `pageUrlReason` |
|
||||
|
||||
**降级策略**(优雅降级,前端禁用跳转):
|
||||
- `businessTable=null`(SYS_DATASTATUS 无映射)→ `pageUrl=null`,`pageUrlReason="businessTable 未映射,无法定位模板"`
|
||||
- `sys_entity/view_templateentity` 找不到模板 → `pageUrl=null`,`pageUrlReason` 含表名
|
||||
- 数据库异常 → `PageTemplateService` 内部 catch,返回 `Optional.empty()`,降级同上
|
||||
|
||||
### P4-6.3 真实待办验证
|
||||
|
||||
服务:flowable-service 8089(本地 eip4flow 迁移数据)+ platform-app 8090(local profile,eip4m0)
|
||||
|
||||
用户 `829cdcca-4e07-4e12-9c8e-a3da2c105e31`(wangwu)待办 3 条,全部 `businessKey → PM_SAFE_CLARIFICATION`:
|
||||
|
||||
| taskId | businessKey | businessTable | pageTemplateId | pageUrl |
|
||||
|--------|-------------|--------------|----------------|---------|
|
||||
| 20334061 | 4f89dbc4-... | PM_SAFE_CLARIFICATION | 7042cb37-9581-4dfe-bb9f-18ed0e0b6b53 | /page/7042cb37-... |
|
||||
| 20333989 | 36e9763f-... | PM_SAFE_CLARIFICATION | 7042cb37-9581-4dfe-bb9f-18ed0e0b6b53 | /page/7042cb37-... |
|
||||
| 20329569 | 1ef1559b-... | PM_SAFE_CLARIFICATION | 7042cb37-9581-4dfe-bb9f-18ed0e0b6b53 | /page/7042cb37-... |
|
||||
|
||||
与客户库直查对照:`PM_SAFE_CLARIFICATION → sys_entity_id=8c3c71e9 → templateid=7042cb37(type=1 安全技术交底)` ✅ 完全一致。
|
||||
|
||||
降级形态:`pageUrl=null + pageUrlReason` 非空 —— 由单测 `PageTemplateMappingTest` 3 个降级用例覆盖。
|
||||
|
||||
### P4-6.4 单测总计
|
||||
|
||||
`PageTemplateMappingTest`(10 单测,新增):
|
||||
|
||||
| 用例 | 验证点 |
|
||||
|------|--------|
|
||||
| `tableName有映射_返回templateId` | 正常映射路径 |
|
||||
| `tableName无映射_返回empty` | 数据库 null 结果 |
|
||||
| `tableName为null_返回empty不查库` | 空保护 |
|
||||
| `tableName为空串_返回empty不查库` | 空保护 |
|
||||
| `buildPageUrl_路由格式正确` | `/page/{id}` 格式 |
|
||||
| `数据库异常_降级返回empty` | 异常静默降级 |
|
||||
| `聚合_有模板条目pageUrl正确填充` | 聚合层正常路径 |
|
||||
| `聚合_无模板映射_pageUrl为null且reason含表名` | 模板未找到降级 |
|
||||
| `聚合_businessTable为null_pageUrl为null且reason含提示` | SYS_DATASTATUS 无映射降级 |
|
||||
| `聚合_有模板与无模板条目共存_优雅降级` | 混合列表共存 |
|
||||
|
||||
全模块 `mvn test`:**31 单测(platform-flow-gateway)全绿**;`ArchitectureRulesTest` 绿;全反应堆 BUILD SUCCESS。
|
||||
|
||||
### P4-6.5 数据变更登记
|
||||
|
||||
| 操作 | 目标库.行 | 性质 |
|
||||
|------|--------|------|
|
||||
| 插入本地 wangwu 用户 | eip4m0.sys_user | 本地自举,可重复 |
|
||||
| 插入 3 条 SYS_DATASTATUS | eip4m0.sys_datastatus(PM_SAFE_CLARIFICATION) | 本地构造,演示映射 |
|
||||
| 建 view_template / view_templateentity | eip4m0(两张新表) | 本地镜像,可重复构造 |
|
||||
| 插入 sys_entity + view_template + view_templateentity | eip4m0,PM_SAFE_CLARIFICATION 的镜像数据 | 本地构造 |
|
||||
| **客户库** | 零写入 | 只读 ✅ |
|
||||
|
||||
### P4-6.6 新坑
|
||||
|
||||
1. **`mvn spring-boot:run` 用的是 classpath 而非 jar**:依赖模块(platform-flow-gateway)改动后须先 `mvn install` 再重启 platform-app,否则 platform-app 运行时仍加载旧 .class(本次 platform-app 在 flow-gateway 编译之前已启动,导致新字段/新 Service 未生效,初查误认为缓存或代理问题)。
|
||||
2. **local profile 无客户库表时 PageTemplateService 静默降级**:view_template/view_templateentity 在本地 eip4m0 需手动建镜像表(最小结构)才能在 local 验证;生产/default profile 直连客户库则无需此步骤。
|
||||
|
||||
## 七-B、P4-6 收尾
|
||||
|
||||
- 验证完成后已 `kill` 8089(PID 15942)和 8090(PID 18609)。
|
||||
- 客户库零写入;本地 eip4m0 新增镜像表为可重复构造工件。
|
||||
|
||||
Reference in New Issue
Block a user