docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
Some checks failed
ci / build-test-parity (push) Has been cancelled
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>
This commit is contained in:
80
docs/P1/D类报表服务流清单.csv
Normal file
80
docs/P1/D类报表服务流清单.csv
Normal file
@@ -0,0 +1,80 @@
|
||||
flowid,in_sysflow,isactive,iscontrol,displayname
|
||||
GB_ATTENDANCEINFO_CHART,EXISTS,1,0,实名制工人考勤图表-单个项目
|
||||
GB_ATTENDANCEINFO_PRJCHART,EXISTS,1,0,实名制工人考勤图表-前十项目
|
||||
GB_ATTENDANCEINFO_SEARCH,EXISTS,1,0,实名制工人考勤概览视图查询
|
||||
GB_ATTENDANCEINFO_SIGNPERCENTCHART,EXISTS,1,0,未签合同率前十项目查询
|
||||
GB_PRJ_WORKER_SEARCH,EXISTS,1,0,实名制项目用工信息查询
|
||||
GB_PROJECTINFO_SEARCH,EXISTS,1,0,实名制项目基础信息查询
|
||||
GB_WORKERPAYMENT_SEARCH,EXISTS,1,0,实名制项目人员工资表查询
|
||||
HR_EMPBEREGULARWORKER_SEARCH,EXISTS,1,0,转正查询
|
||||
HR_EMPLOYEE_SCHEME_SEARCH,EXISTS,1,0,离职目标配置查询
|
||||
HR_PAY_MONTHLYSCHEME_SEARCH,EXISTS,1,0,月薪资方案查询
|
||||
HR_WELFAREARCHIVES_SEARCH,EXISTS,1,0,福利保险档案查询
|
||||
HR_WELFAREPAY_SEARCH,EXISTS,1,0,福利保险缴交查询
|
||||
OA_EC_USEREGISTER_SEARCH,EXISTS,1,0,企业证书复印件/电子档使用登记表查询
|
||||
OA_VEHICLESEND_SEARCH,EXISTS,1,1,派车表查询
|
||||
PM_ACCOUNTINGADJUSTMENT_SEARCH,EXISTS,1,0,账务调整查询
|
||||
PM_BRANCHCOMPANYQUALITYTARGET_SEARCH,EXISTS,1,0,(分)公司质量指标查询
|
||||
PM_BUILDERSDIARY_SEARCH,EXISTS,1,0,施工日志查询
|
||||
PM_DANGERLISTITEM_SEARCH,EXISTS,1,0,公司危险源清单项查询
|
||||
PM_EQUIPMENTMACHINEREIVEW_SEARCH,EXISTS,1,0,机械设备检查查询
|
||||
PM_EXTERNALAPPLY_SEARCH,EXISTS,1,0,项目外经证开具申请查询
|
||||
PM_INPUTTAXINVOICE_EACHDEDUCT_SEARCH,EXISTS,1,0,进项税抵扣(不同工程间抵扣)查询
|
||||
PM_INVOICEAPPLY_SEARCH,EXISTS,1,0,项目开票申请查询
|
||||
PM_MATERIALCONTRACTREGISTER_SEARCH,EXISTS,1,0,物资合同登记查询
|
||||
PM_MATERIALCONTRACTREVIEW_SEARCH,EXISTS,1,0,物资合同评审查询
|
||||
PM_POLLUTIONLISTITEM_SEARCH,EXISTS,1,0,公司污染源清单项查询
|
||||
PM_PROJECTDEPARTMENTQUALITYTARGET_SEARCH,EXISTS,1,0,项目部质量目标查询
|
||||
PM_PROJECTIMPORTBATCH_TJ_SEARCH,EXISTS,1,0,现场材料按订单进场(土建)-查询
|
||||
PM_PROJECTSUBCONTRACT_SEARCH,EXISTS,1,0,项目分包信息查询
|
||||
PM_PROJECT_TASK_SEARCH,EXISTS,1,0,项目任务查询
|
||||
PM_REIMBURSEMENTAPPLY_SEARCH,EXISTS,1,0,项目报销申请表查询
|
||||
PM_REWARDSANDPUNISHMENTS_SEARCH,EXISTS,1,0,质量内部奖罚查询
|
||||
PM_SAFETYFEEAPPLY_SEARCH,EXISTS,1,0,项目安全费用申请查询
|
||||
PM_SECURITYDIARY_SEARCH,EXISTS,1,0,安全日志查询
|
||||
VIEW_HR_ASSESSEMP_SEARCH,EXISTS,1,1,绩效管理-评估记录查询
|
||||
VIEW_HR_ATTENDLOG_SEARCH,EXISTS,1,0,考勤结果视图查询
|
||||
VIEW_HR_INTERVIEWRESULT_TEMP_SEARCH,EXISTS,1,0,面试考评报表查询
|
||||
VIEW_OA_OFFICE_GOODSDETAILS_SEARCH,EXISTS,1,0,收发存明细查询
|
||||
VIEW_PM_MATERIALMANAGEREPORT_TJ_SEARCH,EXISTS,1,0,价格分析图表
|
||||
VIEW_PM_MREPORTINTERVAL_SEARCH,EXISTS,1,0,月报区间视图-查询
|
||||
VIEW_SYS_USERLOGINFO_SEARCH,EXISTS,1,0,用户登录操作数量查询
|
||||
GB_KQTEMPCOUNT_SEARCH,MISSING,,,
|
||||
PM_BUDGETRCJ_SEARCH,MISSING,,,
|
||||
PM_PAYMENTAFFIRM_SEARCH,MISSING,,,
|
||||
VIEW_CUSTOM_SZWJ_SEARCH,MISSING,,,
|
||||
VIEW_DM_SUBJECTS_FILE_ARCHIVE_SEARCH,MISSING,,,
|
||||
VIEW_FPGL_SEARCH,MISSING,,,
|
||||
VIEW_INVOICEWUJIAN_SEARCH,MISSING,,,
|
||||
VIEW_JGGL_SEARCH,MISSING,,,
|
||||
VIEW_OA_FORM_SEARCH,MISSING,,,
|
||||
VIEW_OA_REALESTATEMANAGE_REPORT_SEARCH,MISSING,,,
|
||||
VIEW_PM_HGGF_SEARCH,MISSING,,,
|
||||
VIEW_PM_MATERIALMANAGEFORM_SEARCH,MISSING,,,
|
||||
VIEW_PM_MATERIALMANAGEFORM_TJ_SEARCH,MISSING,,,
|
||||
VIEW_PM_MATERIALMANAGEREPORT_SEARCH,MISSING,,,
|
||||
VIEW_PM_MONTHCOMPLETEWORK_SEARCH,MISSING,,,
|
||||
VIEW_PM_PROJECTCUSTOMIZATIONFORM_SEARCH,MISSING,,,
|
||||
VIEW_PM_PROJECTFORM_SEARCH,MISSING,,,
|
||||
VIEW_PM_PROJECTFUNDCOMREPORT_SEARCH,MISSING,,,
|
||||
VIEW_PM_PROJECTFUNDREPORT_SEARCH,MISSING,,,
|
||||
VIEW_PM_PROJECTMANAGEREPORT_SEARCH,MISSING,,,
|
||||
VIEW_PM_PROJECT_SUMMARYREPORT_SEARCH,MISSING,,,
|
||||
VIEW_PM_QUALITYMANAGEREPORT_SEARCH,MISSING,,,
|
||||
VIEW_PM_SAFETYMANAGEREPORT_SEARCH,MISSING,,,
|
||||
VIEW_PM_SUBCONTRACT2_SEARCH,MISSING,,,
|
||||
VIEW_PM_TOTALCOSTCONTRACT_SEARCH,MISSING,,,
|
||||
VIEW_PM_TURNOVERMATERIALMANAGEREPORT_SEARCH,MISSING,,,
|
||||
VIEW_PM_WXZDY_SEARCH,MISSING,,,
|
||||
VIEW_PROCESSMANAGEFORM_SEARCH,MISSING,,,
|
||||
VIEW_PROJECTCOSTREPORT_SEARCH,MISSING,,,
|
||||
VIEW_PROJECTCOSTREPORTTJ_SEARCH,MISSING,,,
|
||||
VIEW_PROJECTTWOCALCULATIONCOMPARISON_SEARCH,MISSING,,,
|
||||
VIEW_PROJECTUNIVERSALFORM_SEARCH,MISSING,,,
|
||||
VIEW_TEMP_PAY_SEARCH,MISSING,,,
|
||||
VIEW_WELFARE_SEARCH,MISSING,,,
|
||||
VM_AQGLBD_SEARCH,MISSING,,,
|
||||
VM_HR_SEARCH,MISSING,,,
|
||||
VM_HTBD_SEARCH,MISSING,,,
|
||||
VM_PM_SPIDER_LOG_SEARCH,MISSING,,,
|
||||
VM_SHEBEIGUANLI_SEARCH,MISSING,,,
|
||||
|
50
docs/P1/D类报表服务流识别.sql
Normal file
50
docs/P1/D类报表服务流识别.sql
Normal file
@@ -0,0 +1,50 @@
|
||||
-- ============================================================================
|
||||
-- D 类报表服务流识别 SQL(EIP3报表迁移方案 D 节口径)
|
||||
-- ----------------------------------------------------------------------------
|
||||
-- 库:192.168.20.68:5435/postgres,schema=eip3,只读账户 ceshi/ceshi
|
||||
-- 口径:报表模板 = view_template.type=200(根元素 <report>,337/339 含脚本);
|
||||
-- 报表取数服务流 = 报表模板 XML 内 selectservice="XXX" 属性所引服务流。
|
||||
-- 去重后 = D 类「79 个 selectservice 服务流」。
|
||||
-- 注意:servicename/selectservice 值有的是真实 sys_serviceflow_id,
|
||||
-- 有的是 Java 服务方法 FQN 或已失效引用(orphan);需 left join sys_serviceflow 鉴别。
|
||||
-- ============================================================================
|
||||
set search_path to eip3;
|
||||
|
||||
-- 1) D 类去重总数(= 79)
|
||||
with raw as (
|
||||
select unnest(regexp_matches(xml::text, 'selectservice="([^"]+)"', 'g')) as svc
|
||||
from view_template where type = 200
|
||||
)
|
||||
select count(distinct trim(svc)) as d_class_distinct
|
||||
from raw where trim(svc) <> '';
|
||||
|
||||
-- 2) D 类逐条:是否在 sys_serviceflow 中存在、是否活跃、是否受控
|
||||
with raw as (
|
||||
select distinct trim(unnest(regexp_matches(xml::text, 'selectservice="([^"]+)"', 'g'))) as flowid
|
||||
from view_template where type = 200
|
||||
),
|
||||
d as (select flowid from raw where flowid <> '')
|
||||
select
|
||||
d.flowid,
|
||||
case when sf.sys_serviceflow_id is null then 'MISSING' else 'EXISTS' end as in_sysflow,
|
||||
sf.isactive,
|
||||
sf.iscontrol,
|
||||
sf.displayname
|
||||
from d
|
||||
left join sys_serviceflow sf on trim(sf.sys_serviceflow_id) = d.flowid
|
||||
order by (case when sf.sys_serviceflow_id is null then 1 else 0 end), d.flowid;
|
||||
|
||||
-- 3) 汇总:存在 40(非受控 38 + 受控 2)/ 缺失 orphan 39
|
||||
with raw as (
|
||||
select distinct trim(unnest(regexp_matches(xml::text, 'selectservice="([^"]+)"', 'g'))) as flowid
|
||||
from view_template where type = 200
|
||||
),
|
||||
d as (select flowid from raw where flowid <> '')
|
||||
select
|
||||
count(*) as d_total,
|
||||
count(sf.sys_serviceflow_id) as exists_cnt,
|
||||
count(*) - count(sf.sys_serviceflow_id) as missing_orphan_cnt,
|
||||
count(*) filter (where sf.iscontrol = 0) as exists_noncontrol,
|
||||
count(*) filter (where sf.iscontrol = 1) as exists_control
|
||||
from d
|
||||
left join sys_serviceflow sf on trim(sf.sys_serviceflow_id) = d.flowid;
|
||||
40
docs/P1/P1阶段简报.md
Normal file
40
docs/P1/P1阶段简报.md
Normal file
@@ -0,0 +1,40 @@
|
||||
# P1 阶段简报(检查点① 决策会复审输入)
|
||||
|
||||
> 2026-06-11 | P1 = 元数据服务工程化 | 六项全部完成,证据均可复跑
|
||||
> 注:仓库正规化(原 P1 首项)已在 M0 提前完成
|
||||
|
||||
## 一、完成项与证据
|
||||
|
||||
| # | 项 | 结果 | 证据 |
|
||||
|---|----|------|------|
|
||||
| P1-1 | **全实体逐行对拍**(一级交付物) | 1,166 实体:**1,099 通过(94.3%)**;55 库孤儿元数据(与盘点精确吻合);**11 个引擎真缺陷**(见下);1 个 118 万行大表夜批待办。比对 32 万+行 | `eip4-platform/platform-parity/P1-1 全库对拍报告.md` |
|
||||
| P1-2 | 服务流引擎移植 + REST 化 | 31 文件移植(含 Groovy 沙箱)、PoC 桩 GetServicesFunction 回迁;`/api/flow/{id}` 实测 6 条全过(total 与 DB 一致);**D 类 79 流中 39 个为孤儿引用,实际 40 个**(P4 报表预算利好) | `platform-metadata/P1服务流实测报告.md`;`docs/P1/D类报表服务流清单.csv` |
|
||||
| P1-3 | 标识符白名单(安全第 1 层) | 表名/列名/排序列全过元数据白名单;注入负例(`' OR 1=1--`、`;DROP`)实测 400 拒绝 | `platform-metadata/P1加固实测报告.md` |
|
||||
| P1-4 | Caffeine 缓存 + 失效钩子 | CCache 签名不变内部换 Caffeine;**C1 坑 3 回归通过**(元数据变更不重启生效);Spring Cache 抽象差距已诚实记录 | 同上 |
|
||||
| P1-5 | DDL 索引增强 | 建表自动补 FK/UPDATETIME 索引(现代层后置,引擎零改);存量补索引脚本只生成不执行(客户库排切流窗口) | 同上 |
|
||||
| P1-6 | CI 流水线 | `scripts/ci.sh` + GitHub Actions:编译→单测(含 ArchUnit)→自举→种子对拍(21 实体 100%)→权限样本(9/9+3/3),**全链路实跑全绿**;首跑即抓出权限自举顺序缺陷并修复 | `scripts/ci.sh`;`.github/workflows/ci.yml` |
|
||||
|
||||
## 二、P1 期间的关键发现(逐行对拍的价值证明)
|
||||
|
||||
1. **11 个引擎真缺陷**(计数级对拍永远查不出):
|
||||
- 行集坍缩:PM_LABORTEAM(71 行被引擎读成 2 个 distinct id 重复)、PM_SPIDER_JSBIDWIN(整页同一行)——total 正确、每行都错
|
||||
- 引擎 500:SYS_DATASTATUS/SYS_UPDATE_LOG(元数据/物理漂移)+ 7 个 VIEW_*(视图读路径 SQL 生成缺陷)
|
||||
- **处置**:已完整取证进对拍报告;修复属保真层行为变更,**须先确认旧系统是否同病**(同病=行为保真,不修;独病=移植缺陷,修)——列入 P2 初与「旧系统环境」开放项一并处理
|
||||
2. **D 类报表服务流口径修正**:79 → 实际存在 40(39 孤儿引用),P4 报表 D 类工作量利好,需回写报表迁移方案
|
||||
3. 迁移手册累计新增 §5.11–5.28(18 个坑位),P1 期间全部来自真实库实测
|
||||
|
||||
## 三、检查点① 复审清单(决策会动作)
|
||||
|
||||
- C1–C5 已全部达标(客户库口径),「有条件立项」限定可解除性:技术线证据齐备,**待商务开放项 1/3 闭环**
|
||||
- 11 个引擎缺陷的「旧系统同病验证」需要旧系统可运行环境——该开放项原计划 P1 第一周必答,现为唯一技术阻塞
|
||||
- 单测规模:M0 后 51 → P1 后 **130+ 全绿**;ArchUnit 边界纪律全程未破
|
||||
|
||||
## 四、遗留与 P2 入口
|
||||
|
||||
| 事项 | 去向 |
|
||||
|------|------|
|
||||
| 11 个引擎缺陷旧系统同病验证 | P2 初(依赖旧系统环境) |
|
||||
| GB_ATTENDANCEINFO(118 万行)夜批对拍 | 夜间批跑 |
|
||||
| 服务流 REST 读写闸(当前不区分) | P2 三层防护 |
|
||||
| 流脚本 juel 条件分支/listSelectResultBySql 限制 | P2/P3 |
|
||||
| Caffeine → Spring Cache 抽象 → Redis 路径 | 横扩需求出现时 |
|
||||
43
docs/P1/P2阶段简报.md
Normal file
43
docs/P1/P2阶段简报.md
Normal file
@@ -0,0 +1,43 @@
|
||||
# P2 阶段简报(组织/权限/数据权限)
|
||||
|
||||
> 2026-06-11 | 计划排期「月 2–4,3–4 人月」,实际与 P1 同日完成 | 四项全部交付,证据可复跑
|
||||
> 风险结论先行:**R1(数据权限多维隔离)判定成立,不触发 S1 止损**
|
||||
|
||||
## 一、完成项与证据
|
||||
|
||||
| # | 项 | 结果 | 证据 |
|
||||
|---|----|------|------|
|
||||
| P2-1 | 组织/用户/角色/功能权限移植 | 12 文件原样移植(含 OTP 私有 jar 模块内仓库解析);OrgController 7 端点实测与 DB 一致(角色 1,531/组织树层级/用户角色 360);**真实规则对拍:客户库 1,079 条活跃规则摸底,4 实体 805 行 100% + 5/5 负例拒绝(全程只读)** | `platform-auth/P2组织权限实测报告.md` |
|
||||
| P2-2 | Spring Security + 无状态 JWT | jjwt HS256 密钥配置化(启动期强度校验);**口令侦察实锤:SYS_USER 无盐 MD5(1,854 行实证)**;UserSession ThreadLocal 请求级隔离(16 线程×200 次并发单测);prod 严格 401/local 保留对拍通道;EntityController ctx 三级优先 | `platform-auth/P2认证实测报告.md` |
|
||||
| P2-3 | 横切桩真实现 | 18 文件移植;FTP→本地盘替换类(保签名,防 `../` 逃逸);异步日志链(30s 批量)落 SYS_LOG/SYS_DATA_LOGITEM 实证;邮件无配置降级 no-op;删 3 桩(ProjectSwitchService 桩保留,属 viewFramework 域,已登记) | `platform-auth/P2横切服务实测报告.md` |
|
||||
| P2-4 | **多维数据权限(成败手,R1)** | 规则形态普查(见下)+ **14/14 多维形态矩阵 100% + 7/7 负例**(含项目×组织×分包商三维场景)+ 客户库组织维只读抽测 MATCH | `platform-auth/P2多维数据权限实测报告.md` |
|
||||
|
||||
## 二、R1 判定依据(决策会关注点)
|
||||
|
||||
**客户库真实使用画像(1,079 条规则/345 实体,第一手普查)**:
|
||||
- 多规则角色 OR 合并:303/345 实体(87.8%)——主力形态
|
||||
- 条件类型:CURRENTUSERORGID 323 / OWNNERPROJECT(我的项目)165 / CURRENTUSERID 71 / CURRENTUSERDEPARTID 27;SPECIALDEPART/ORG 客户**零使用**
|
||||
- OwnProjectWhere 实配:`SELECT PM_PROJECTID FROM PM_PROJECT_USER WHERE USERID={CURRENTUSERID}`
|
||||
|
||||
**判定**:引擎多维隔离语义在全部真实形态+引擎支持形态上闭合(矩阵 14/14);真实规则单维对拍 805 行 100%。**非阻塞缺口**:G1 OWNNERPROJECT 客户库直拍待管理 UI、G2 登录时部门/机构 ctx 注入待集成、G3 SPECIALDEPART 无真实样本(客户未用)。
|
||||
|
||||
## 三、安全发现(须进客户沟通包)
|
||||
|
||||
- **客户库 1,854 个账号口令为无盐 MD5**,`md5('123456')` 可命中真实账号——本期以兼容验证为目标(登录可用),**口令加盐/慢哈希升级建议列入交付安全建议书**(老系统行为,非新平台引入)。
|
||||
|
||||
## 四、累计口径(M0+P1+P2)
|
||||
|
||||
- 单测:130+ → **190+ 全绿**(legacy-core 45/metadata 34/parity 30/auth 16+ 等);ArchUnit 全程未破
|
||||
- 迁移手册:§5.38(P2 新增 §5.29–5.38 十个坑位)
|
||||
- 保真层纪律:`com.dsasp.*` 引擎核心零修改;替换类全部登记(FTPClientTemplate 等)
|
||||
- 桩清零进度:dataPrivilege(C2)/file/log/mail 已真实现;仅剩 ProjectSwitchService(viewFramework 域,P4 处理)
|
||||
|
||||
## 五、遗留与去向
|
||||
|
||||
| 事项 | 去向 |
|
||||
|------|------|
|
||||
| G2 登录时部门/机构 ctx 注入(JWT claim 已留位) | P2 收尾小项,随首个业务联调闭环 |
|
||||
| OWNNERPROJECT 客户库直拍 | 权限管理 UI(P4)后 |
|
||||
| ProjectSwitchService 真实现 | P4 viewFramework 域 |
|
||||
| 口令加盐升级建议 | 客户沟通包/安全建议书 |
|
||||
| 11 个引擎缺陷旧系统同病验证(P1 遗留) | 仍待旧系统环境(唯一技术阻塞) |
|
||||
40
docs/P1/P3阶段简报.md
Normal file
40
docs/P1/P3阶段简报.md
Normal file
@@ -0,0 +1,40 @@
|
||||
# P3 阶段简报(Flowable 独立服务)
|
||||
|
||||
> 2026-06-11 | 计划排期「月 3.5–5,1.5–2.5 人月」| 四项全部交付,证据可复跑
|
||||
> 交付形态确认:flowable-service.jar 成为四进程之二(nginx / eip4-platform.jar / **flowable-service.jar** / postgres)
|
||||
|
||||
## 一、完成项与证据
|
||||
|
||||
| # | 项 | 结果 | 证据 |
|
||||
|---|----|------|------|
|
||||
| P3-1 | flowable-service 独立服务 | 新可执行模块:Flowable 6.8.1 引擎(`databaseSchemaUpdate=false` 硬纪律)+ 双数据源(ACT_ 本地/业务组织客户库只读,生产单库分 schema 配置示意已附)+ 待办/已办/发起/办理/挂起/委托 REST;**1,509 个真实流程定义加载无错**;挂起拒办(409)/委托语义实证,数据净零变更 | `flowable-service/P3流程服务实测报告.md` |
|
||||
| P3-2 | 3 个表达式 handler 移植 | 原包名移植 + 依赖闭包裁剪(OSGi 间接→WfBeanRegistry;组织服务闭包→OrgDirectoryJdbc 窄接口直查 SQL,避免把保真层引擎拖进独立进程);**真实表达式解析与客户库组织数据对照一致**;待办口径对账 4=4/12=12 | 同上 |
|
||||
| P3-3 | 升级工具链产品化 | 一键链(前置校验→版本串规范化→5.23→6.8.1→对账)幂等参数化;**新鲜 5.13 副本完整重演:升级链 21 秒/含拉数 84 秒,对账全绿(含 109.7 万行历史)**;rehearsal 安全闸拒指 eip4flow | `tools/flowable-upgrade/`;`docs/P3-Flowable升级/Flowable升级Runbook-v1.md` |
|
||||
| P3-4 | 网关聚合 + 事件回写 | FlowableClient(重试/熔断,引擎不可达 503 不崩单体);待办聚合拼业务摘要(无映射优雅降级);**SYS_DATASTATUS 回写逐条对齐老系统 ProcessCoreServiceImpl**(1 未提交/2 处理中/3 通过/4 未通过/5 重提交/6 作废;结束→3、未结束→2、oldstatus 单调守卫);聚合数与引擎直查一致、熔断实测、回写 1→3 实证 | `platform-flow-gateway/P3网关实测报告.md` |
|
||||
|
||||
## 二、关键发现
|
||||
|
||||
1. **scriptTask 担忧消除**:5 个 scriptTask 全部是 Activiti Explorer 演示/报表流程(`org/activiti/explorer/demo/...`),**非客户业务流**,休眠且零库写——P3 计划的核对项以"无需迁移"结案。
|
||||
2. **候选人解析类型真实分布**(4,761 处表达式普查):position 1,949 / user 1,683 / formSpecifiedDimension 601 / projectRoleType 528 / 其余 70。SQL 可解析类型覆盖 **~91%**;**降级带 WARN 的缺口:projectRoleType 528 处(项目角色维度,建筑行业定制)**+ scriptUser 26 / initiatorDepartManager 24 / fixedDimension 12 / sameToTask 5——**P4/切流前必须闭环 projectRoleType**(量级最大),已登记。
|
||||
3. **升级窗口实测:21 秒**(数据量=运行时全量+bytearray 引用过滤 9.1 万行口径);生产全量 bytearray 1.2GB 的差额外推见 Runbook——Flowable 升级停机窗口远小于 PG 升级,分窗执行无压力。
|
||||
4. Flowable 6.8.1 `TaskInfo` 无 `getBusinessKey()`(§6.8)等 6 个新坑入手册(§6.4–6.9)。
|
||||
|
||||
## 三、数据变更登记(本地迁移副本 eip4flow)
|
||||
|
||||
- 挂起/激活、委托:净零(已恢复)
|
||||
- 1 条真实 complete(实例 20334081,P3-4 回写验证需流程真实结束)——本地副本,客户库全程零写入
|
||||
|
||||
## 四、遗留与去向
|
||||
|
||||
| 事项 | 去向 |
|
||||
|------|------|
|
||||
| **projectRoleType 候选解析(528 处)** | P4 前专项:侦察项目角色维度数据模型后补 OrgDirectoryJdbc 实现 |
|
||||
| scriptUser(26)/sameToTask(5) 等长尾类型 | 切流前按实际使用频率逐个补 |
|
||||
| 待办聚合性能(businessKey 逐条 loadPOJO) | 上量后批量化(C3 口径复测) |
|
||||
| Flowable 升级生产执行 | 切流期专用窗口,与 PG 升级分窗 |
|
||||
|
||||
## 五、累计口径(M0+P1+P2+P3)
|
||||
|
||||
- 模块:8 → **10**(新增 flowable-service、platform-flow-gateway 实装)
|
||||
- 单测:190+ → **240+ 全绿**;ArchUnit 全程未破
|
||||
- 迁移手册:§6.9(P3 新增 6 坑);git 累计 35+ 提交
|
||||
40
docs/P1/P4中期简报.md
Normal file
40
docs/P1/P4中期简报.md
Normal file
@@ -0,0 +1,40 @@
|
||||
# P4 中期简报(前端与迁移工具链——已交付三线)
|
||||
|
||||
> 2026-06-11 | P4 计划口径「月 2.5–6,4–6 人月,最大不确定段」| 三条不依赖客户侧动作的线已交付
|
||||
> 暂缓线(153 重写 / JOR C 类 / editor 二开)等 Q1/Q2 评审与客户动作,见末节
|
||||
|
||||
## 一、已交付三线
|
||||
|
||||
| 线 | 结果 | 证据 |
|
||||
|----|------|------|
|
||||
| **P4-1 批量转换**(计划最大头) | 转换器五类扩展(crud/form/tree/report/group + 主子表/选择窗);**1,516 模板全量跑批:闸一官方 schema 校验 98.2%(1,489/1,516),五类型族全 100%**,仅 27 个空 XML 孤儿模板失败(库内数据问题,交客户定性——决策会红线 3);闸二无头渲染抽样 25/25;映射台账 15,973 条 | `platform-converter/P4批量转换报告.md`;`转换产物/`(1,489 个 schema+分级清单) |
|
||||
| **P4-2 脚本迁移** | 1,427 条全量改写产出(497 全自动/815 无 S3/115 人工作业单,覆盖 721 模板);**32 个 facade 动词运行时落地**(服务端 3 直执行+UI 29 捕获为 amis 事件指令);6 条真实脚本集成跑通,PoC 回归不破 | `tools/s3_rewriter/P4脚本迁移执行报告.md`;`output/` |
|
||||
| **P4-3 前端宿主** | eip4-web 脚手架(React18+Vite+amis 6.13 本地 SDK 零 CDN);**5 场景 playwright 联调全过**(登录 JWT→渲染真实库数据→401 自动跳登录→待办 503 降级);构建产物 208KB 应用+61MB SDK,Nginx 可托管 | `eip4-web/docs/P4脚手架报告.md`(5 截图) |
|
||||
|
||||
## 二、对检查点②(首批只读功能点切流)的意义
|
||||
|
||||
- 闸一 98.2% + 闸二抽样全过 ⇒ **只读类页面(列表/查询)批量就绪度高**;选择窗(937 模板)的 `/api/picker` 后端联动是切流前唯一公共后端缺口
|
||||
- 脚本侧:296 条 facade-only 的 S3 脚本可直接挂回页面;115 条人工作业单(0.5 人日/条口径)可与切流节奏并行消化
|
||||
- 前端宿主已具备"转换产物→真实渲染→真实数据"端到端通路(本地实证)
|
||||
|
||||
## 三、衔接缺口(P4 中段工作,已设计待实装)
|
||||
|
||||
| 缺口 | 设计去向 |
|
||||
|------|---------|
|
||||
| 改写后脚本挂回页面 schema(onEvent 重放) | P4-2 报告第五章,与转换器协同实装 |
|
||||
| `/api/picker` 选择窗数据源端点 | platform-metadata,937 模板等它 |
|
||||
| 生产期 schema 接口 `GET /api/page/schema/{id}` | 契约已设计(前端一行切换),随 P5 或切流前落地 |
|
||||
| 待办→业务页映射 | gateway businessKey→templateId 映射表 |
|
||||
|
||||
## 四、暂缓线与人工依赖(不变)
|
||||
|
||||
| 项 | 等什么 |
|
||||
|----|--------|
|
||||
| 153 视图重写(13 个,43 人日) | **Q1:106 个 addon 源码归属(阻塞)+ Q2:S1 止损决策** |
|
||||
| JOR C 类(45 模板 univer 替换) | 客户文件系统侧清点 + C 类预算锁定 |
|
||||
| amis-editor 二开 | 计划排 P4 后半,优先级低于批量转换(已兑现) |
|
||||
| 27 个空 XML 孤儿模板 | 客户定性(废弃 or 补数据) |
|
||||
|
||||
## 五、累计口径
|
||||
|
||||
模块 10 个、单测 270+ 全绿、迁移手册至 §8.4(P4 新增 §5.39/§8.3/§8.4)、eip4-platform 38+ 提交 + eip4-web 2 提交、四份阶段简报 + 本简报。
|
||||
52
docs/P1/P4收口简报.md
Normal file
52
docs/P1/P4收口简报.md
Normal file
@@ -0,0 +1,52 @@
|
||||
# P4 收口简报(前端与迁移工具链 + 只读切流端到端链路)
|
||||
|
||||
> 2026-06-11 | 接《P4中期简报》| 三主线 + 四衔接缺口全部交付,只读切流端到端链路闭合
|
||||
> 仍暂缓(人工/客户依赖):153 重写、JOR C 类、editor 二开、27 孤儿模板定性
|
||||
|
||||
## 一、衔接四缺口(本轮)
|
||||
|
||||
| # | 项 | 结果 | 证据 |
|
||||
|---|----|------|------|
|
||||
| P4-4 | /api/picker + schema 接口 | picker 数据源端点(过白名单+行级权限,注入负例 400/转义)+ `GET /api/page/schema/{id}`(1,489 产物入 SYS_PAGE_SCHEMA,ETag/304);前端切 `VITE_SCHEMA_SOURCE=backend` 渲染实证 | `platform-metadata/P4衔接-picker与schema接口报告.md` |
|
||||
| P4-5 | 脚本挂回 onEvent 重放 | 转换器注入 onEvent→`/api/script/execute-template`(按 templateId/seq 读改写产物,**无脚本注入面**)→前端 runActions 重放 29 UI 动词;2 真实模板端到端(字段隐藏/服务端数据闭环) | `tools/s3_rewriter/P4脚本挂回实测报告.md` |
|
||||
| P4-6 | 待办→业务页映射 | tablename→entityid→templateid(EDITFORM 表单优先);真实待办带 pageUrl 与客户库直查一致;Caffeine 缓存 | `platform-flow-gateway/P3网关实测报告.md` P4-6 节 |
|
||||
|
||||
## 二、只读切流端到端链路(闭合)
|
||||
|
||||
```
|
||||
登录(JWT)→ 待办列表(/api/todo 带 pageUrl)→ 点击进业务页
|
||||
→ schema 接口取转换产物(/api/page/schema/{id})→ amis 渲染
|
||||
→ 列表取数(/api/entity/{t}/list,行级权限)→ 选择窗联动(/api/picker)
|
||||
→ 交互触发脚本(onEvent→execute-template→指令重放)
|
||||
```
|
||||
各环节均有本地实证(playwright);这是检查点②"首批只读功能点切流"的完整技术底座。
|
||||
|
||||
## 三、本轮两个关键发现(进性能/安全清单)
|
||||
|
||||
1. **新注入点(安全)**:`GeneralPO.java:1940` 对字符串过滤值**裸拼**进 `col like '%值%'`,无参数绑定——架构第四节"值位置经 StringUtil 转义已挡最低级注入"的判断**在 LIKE 搜索路径上不成立**。picker/list 入口已在现代层转义兜底,但根治须纳入 P2 渐进参数化清单的 LIKE 路径项(原清单未单列)。
|
||||
2. **dialogid 契约修正(架构认知)**:SelectDialog 的 dialogid = view_template_id(弹窗列表模板),非 SYS_REFERENCE_ID;数据源实体在该模板 XML 根 `@entityid`。后端解析消化,937 模板产物零改动。
|
||||
|
||||
## 四、检查点② 就绪度评估
|
||||
|
||||
| 维度 | 状态 |
|
||||
|------|------|
|
||||
| 页面转换 | 闸一 98.2%(1,489 产物已服务化) |
|
||||
| 只读取数 + 行级权限 | P1/P2 已验,picker 补齐选择窗 |
|
||||
| 脚本交互 | facade-only 296 条可直接挂回;115 人工作业单并行 |
|
||||
| 前端宿主 | 端到端通,Nginx 可托管 |
|
||||
| **结论** | **只读类功能点切流的技术链路就绪**;切流执行需走决策会七条红线 + 客户签字矩阵(非技术动作) |
|
||||
|
||||
## 五、剩余工作(全是人工/客户依赖,技术线已尽)
|
||||
|
||||
| 项 | 卡点 |
|
||||
|----|------|
|
||||
| 153 视图重写(13 个) | Q1:106 addon 源码归属(阻塞)+ Q2:S1 止损决策 |
|
||||
| JOR C 类(45 模板) | 客户文件系统侧清点 |
|
||||
| 27 孤儿模板 / 58 零引用视图 | 客户/老员工定性 |
|
||||
| 11 引擎缺陷(P1) | 旧系统同病验证 |
|
||||
| editor 二开 | 排期项,P4/P5 后段 |
|
||||
| 检查点①② | 决策会评审 + 商务开放项 1/3 |
|
||||
|
||||
## 六、累计口径
|
||||
|
||||
模块 10、单测 ~300 全绿、迁移手册至 §8.9、eip4-platform 42 提交 + eip4-web 仓库、阶段简报六份(M0/P1/P2/P3/P4中期/P4收口)。SYS_PAGE_SCHEMA 是首张"现代层平台表"(Flyway 管理列 P5)。
|
||||
73
docs/P1/REST证据/GB_PROJECTINFO_SEARCH.sample.json
Normal file
73
docs/P1/REST证据/GB_PROJECTINFO_SEARCH.sample.json
Normal file
@@ -0,0 +1,73 @@
|
||||
{
|
||||
"flow": "GB_PROJECTINFO_SEARCH",
|
||||
"status": 0,
|
||||
"total": 26,
|
||||
"items_sample": [
|
||||
{
|
||||
"_id": "02f50dc0-93da-4db2-b5cf-61f4ce21e949",
|
||||
"GB_PROJECTINFO_ID": "02f50dc0-93da-4db2-b5cf-61f4ce21e949",
|
||||
"PRJNUMBER": "3205062020051302A01000",
|
||||
"PRJNAME": "轨交4号线木里公交换乘枢纽(木里站)项目",
|
||||
"COUNTY": "吴中区",
|
||||
"SSDQ": null,
|
||||
"PRJADRESS": "吴中太湖新城东太湖路南侧、竹山路东侧、车辆段环路北侧",
|
||||
"JZMJ": 15561.36,
|
||||
"GCZJ": 5882.27,
|
||||
"JSDW": "苏州太湖新城吴中管理委员会",
|
||||
"JSDWZZJGDM": null,
|
||||
"JDWLXR": "张成龙",
|
||||
"JSDWLXDH": "17625806878",
|
||||
"DATANUMBER": "e8266740-98ba-419a-b4b9-9d96bdcd772f20200519",
|
||||
"ISPHOTOCOMPARE": true,
|
||||
"USERS": [],
|
||||
"ENTERPRISEINFO": "苏州第五建筑集团有限公司",
|
||||
"DEVICETYPE": 4,
|
||||
"XMLB": null,
|
||||
"DOCUMENT": [],
|
||||
"KGRQ": null,
|
||||
"GZZHZH": null,
|
||||
"CCKQSJ": null,
|
||||
"ISBD": false,
|
||||
"BDPROJECTS": [],
|
||||
"CREATETIME": "2020-05-19T06:53:47.413Z",
|
||||
"CREATEBY": "ADMIN ",
|
||||
"UPDATETIME": "2020-07-23T06:49:52.913Z",
|
||||
"UPDATEBY": "ADMIN ",
|
||||
"ISACTIVE": false,
|
||||
"VERSION": 4
|
||||
},
|
||||
{
|
||||
"_id": "ae72ba33-1110-4517-80bb-37ea9b5bc268",
|
||||
"GB_PROJECTINFO_ID": "ae72ba33-1110-4517-80bb-37ea9b5bc268",
|
||||
"PRJNUMBER": "3205072019111103A02000",
|
||||
"PRJNAME": "贡湖产业园( 一期)东区工程",
|
||||
"COUNTY": "相城区",
|
||||
"SSDQ": "望亭镇",
|
||||
"PRJADRESS": "相城区望亭镇宅基村",
|
||||
"JZMJ": 29756.18,
|
||||
"GCZJ": 8039.33,
|
||||
"JSDW": "苏州贡湖精密制造产业发展有限公司",
|
||||
"JSDWZZJGDM": null,
|
||||
"JDWLXR": "徐勇",
|
||||
"JSDWLXDH": "15995426682",
|
||||
"DATANUMBER": "b75d2809-0e07-400f-b250-121cd3e90fb520200519",
|
||||
"ISPHOTOCOMPARE": true,
|
||||
"USERS": [],
|
||||
"ENTERPRISEINFO": "苏州第五建筑集团有限公司",
|
||||
"DEVICETYPE": 4,
|
||||
"XMLB": null,
|
||||
"DOCUMENT": [],
|
||||
"KGRQ": null,
|
||||
"GZZHZH": null,
|
||||
"CCKQSJ": null,
|
||||
"ISBD": false,
|
||||
"BDPROJECTS": [],
|
||||
"CREATETIME": "2020-05-19T02:54:52.969Z",
|
||||
"CREATEBY": "ADMIN ",
|
||||
"UPDATETIME": "2020-07-23T05:24:59.052Z",
|
||||
"UPDATEBY": "ADMIN ",
|
||||
"ISACTIVE": false,
|
||||
"VERSION": 6
|
||||
}
|
||||
]
|
||||
}
|
||||
Reference in New Issue
Block a user