docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
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:
2026-06-17 14:52:50 +08:00
parent 838669f124
commit 1b69f8b481
54 changed files with 7485 additions and 0 deletions

View 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,,,
1 flowid in_sysflow isactive iscontrol displayname
2 GB_ATTENDANCEINFO_CHART EXISTS 1 0 实名制工人考勤图表-单个项目
3 GB_ATTENDANCEINFO_PRJCHART EXISTS 1 0 实名制工人考勤图表-前十项目
4 GB_ATTENDANCEINFO_SEARCH EXISTS 1 0 实名制工人考勤概览视图查询
5 GB_ATTENDANCEINFO_SIGNPERCENTCHART EXISTS 1 0 未签合同率前十项目查询
6 GB_PRJ_WORKER_SEARCH EXISTS 1 0 实名制项目用工信息查询
7 GB_PROJECTINFO_SEARCH EXISTS 1 0 实名制项目基础信息查询
8 GB_WORKERPAYMENT_SEARCH EXISTS 1 0 实名制项目人员工资表查询
9 HR_EMPBEREGULARWORKER_SEARCH EXISTS 1 0 转正查询
10 HR_EMPLOYEE_SCHEME_SEARCH EXISTS 1 0 离职目标配置查询
11 HR_PAY_MONTHLYSCHEME_SEARCH EXISTS 1 0 月薪资方案查询
12 HR_WELFAREARCHIVES_SEARCH EXISTS 1 0 福利保险档案查询
13 HR_WELFAREPAY_SEARCH EXISTS 1 0 福利保险缴交查询
14 OA_EC_USEREGISTER_SEARCH EXISTS 1 0 企业证书复印件/电子档使用登记表查询
15 OA_VEHICLESEND_SEARCH EXISTS 1 1 派车表查询
16 PM_ACCOUNTINGADJUSTMENT_SEARCH EXISTS 1 0 账务调整查询
17 PM_BRANCHCOMPANYQUALITYTARGET_SEARCH EXISTS 1 0 (分)公司质量指标查询
18 PM_BUILDERSDIARY_SEARCH EXISTS 1 0 施工日志查询
19 PM_DANGERLISTITEM_SEARCH EXISTS 1 0 公司危险源清单项查询
20 PM_EQUIPMENTMACHINEREIVEW_SEARCH EXISTS 1 0 机械设备检查查询
21 PM_EXTERNALAPPLY_SEARCH EXISTS 1 0 项目外经证开具申请查询
22 PM_INPUTTAXINVOICE_EACHDEDUCT_SEARCH EXISTS 1 0 进项税抵扣(不同工程间抵扣)查询
23 PM_INVOICEAPPLY_SEARCH EXISTS 1 0 项目开票申请查询
24 PM_MATERIALCONTRACTREGISTER_SEARCH EXISTS 1 0 物资合同登记查询
25 PM_MATERIALCONTRACTREVIEW_SEARCH EXISTS 1 0 物资合同评审查询
26 PM_POLLUTIONLISTITEM_SEARCH EXISTS 1 0 公司污染源清单项查询
27 PM_PROJECTDEPARTMENTQUALITYTARGET_SEARCH EXISTS 1 0 项目部质量目标查询
28 PM_PROJECTIMPORTBATCH_TJ_SEARCH EXISTS 1 0 现场材料按订单进场(土建)-查询
29 PM_PROJECTSUBCONTRACT_SEARCH EXISTS 1 0 项目分包信息查询
30 PM_PROJECT_TASK_SEARCH EXISTS 1 0 项目任务查询
31 PM_REIMBURSEMENTAPPLY_SEARCH EXISTS 1 0 项目报销申请表查询
32 PM_REWARDSANDPUNISHMENTS_SEARCH EXISTS 1 0 质量内部奖罚查询
33 PM_SAFETYFEEAPPLY_SEARCH EXISTS 1 0 项目安全费用申请查询
34 PM_SECURITYDIARY_SEARCH EXISTS 1 0 安全日志查询
35 VIEW_HR_ASSESSEMP_SEARCH EXISTS 1 1 绩效管理-评估记录查询
36 VIEW_HR_ATTENDLOG_SEARCH EXISTS 1 0 考勤结果视图查询
37 VIEW_HR_INTERVIEWRESULT_TEMP_SEARCH EXISTS 1 0 面试考评报表查询
38 VIEW_OA_OFFICE_GOODSDETAILS_SEARCH EXISTS 1 0 收发存明细查询
39 VIEW_PM_MATERIALMANAGEREPORT_TJ_SEARCH EXISTS 1 0 价格分析图表
40 VIEW_PM_MREPORTINTERVAL_SEARCH EXISTS 1 0 月报区间视图-查询
41 VIEW_SYS_USERLOGINFO_SEARCH EXISTS 1 0 用户登录操作数量查询
42 GB_KQTEMPCOUNT_SEARCH MISSING
43 PM_BUDGETRCJ_SEARCH MISSING
44 PM_PAYMENTAFFIRM_SEARCH MISSING
45 VIEW_CUSTOM_SZWJ_SEARCH MISSING
46 VIEW_DM_SUBJECTS_FILE_ARCHIVE_SEARCH MISSING
47 VIEW_FPGL_SEARCH MISSING
48 VIEW_INVOICEWUJIAN_SEARCH MISSING
49 VIEW_JGGL_SEARCH MISSING
50 VIEW_OA_FORM_SEARCH MISSING
51 VIEW_OA_REALESTATEMANAGE_REPORT_SEARCH MISSING
52 VIEW_PM_HGGF_SEARCH MISSING
53 VIEW_PM_MATERIALMANAGEFORM_SEARCH MISSING
54 VIEW_PM_MATERIALMANAGEFORM_TJ_SEARCH MISSING
55 VIEW_PM_MATERIALMANAGEREPORT_SEARCH MISSING
56 VIEW_PM_MONTHCOMPLETEWORK_SEARCH MISSING
57 VIEW_PM_PROJECTCUSTOMIZATIONFORM_SEARCH MISSING
58 VIEW_PM_PROJECTFORM_SEARCH MISSING
59 VIEW_PM_PROJECTFUNDCOMREPORT_SEARCH MISSING
60 VIEW_PM_PROJECTFUNDREPORT_SEARCH MISSING
61 VIEW_PM_PROJECTMANAGEREPORT_SEARCH MISSING
62 VIEW_PM_PROJECT_SUMMARYREPORT_SEARCH MISSING
63 VIEW_PM_QUALITYMANAGEREPORT_SEARCH MISSING
64 VIEW_PM_SAFETYMANAGEREPORT_SEARCH MISSING
65 VIEW_PM_SUBCONTRACT2_SEARCH MISSING
66 VIEW_PM_TOTALCOSTCONTRACT_SEARCH MISSING
67 VIEW_PM_TURNOVERMATERIALMANAGEREPORT_SEARCH MISSING
68 VIEW_PM_WXZDY_SEARCH MISSING
69 VIEW_PROCESSMANAGEFORM_SEARCH MISSING
70 VIEW_PROJECTCOSTREPORT_SEARCH MISSING
71 VIEW_PROJECTCOSTREPORTTJ_SEARCH MISSING
72 VIEW_PROJECTTWOCALCULATIONCOMPARISON_SEARCH MISSING
73 VIEW_PROJECTUNIVERSALFORM_SEARCH MISSING
74 VIEW_TEMP_PAY_SEARCH MISSING
75 VIEW_WELFARE_SEARCH MISSING
76 VM_AQGLBD_SEARCH MISSING
77 VM_HR_SEARCH MISSING
78 VM_HTBD_SEARCH MISSING
79 VM_PM_SPIDER_LOG_SEARCH MISSING
80 VM_SHEBEIGUANLI_SEARCH MISSING

View 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
View 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
View 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
View 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
View 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
View 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)。

View 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
}
]
}