Files
eip4-platform/docs/M0交付/M0剩余项状态登记.md
zhengwr 1b02036153 docs+javadoc: 文档-代码对抗核查对齐 + 归档候选物理归档
5 路并行核对总览 §9/§10/§11 + A/B 矩阵声明 vs 两仓代码(48 条 46 条完全一致,无虚报),修正不一致处:
- A10 行 🔴→🟡:W1 Flyway(V1-V3)+W2-W4 容器化/nginx/compose 骨架 06-25 已合 main,文档此前低报;§10.2 Flyway/compose 两条标 ✅
- §9 P0② 表格「同族扩长」与对抗审查①矛盾(代码一律拒 TYPE 变更)改齐
- §10.2 render-plan 行号迁 AiDraftGateValidator.java:246(SRP 拆分后位置)
- §11 报表单测 73→79;§2「五步编排壳」改四步向导
- CandidateUsersHandler 类级 javadoc:scriptUser 已于 06-26 接入(resolveScriptUsers),删「WARN 降级未接入」陈旧表述(纯注释零行为变更)

归档整理(总览 §8 归档候选落地):
- 10 份已完成/被取代文档 git mv 入 docs/归档/(06-14×3/06-15/06-16/06-20 plans、CRUD-QA、C3/C5、总览-06-17)
- 引用同步改路径:README 索引、M0剩余项登记、通用模板收口计划、架构方向-design、新闻管理plan
- README 刷新至 07-02:补 06-22→06-26 增量一节、审批/报表行状态、§2 补登 06-25/06-26 四份 design/计划、§4 过时「未 push」表述修正

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-02 08:01:23 +08:00

14 KiB
Raw Permalink Blame History

M0 剩余项状态登记

版本:v1.0(2026-06-10)| 性质:M0 出口管理文档 用途:登记 M0 九项任务中尚未完成的技术清点、商务开放项及整体状态; 维护说明:每项状态变更时同步更新本表;M0 宣布通过前本文档必须全绿


一、JOR 报表布局客户环境清点方案

1.1 目的

锁定 P4 报表 C 类预算(JOR 布局 → univer + Web 打印替换方案)。 清点结果直接影响 C 类报表工作量估算;若存量超预期,需在 P4 启动前重锁预算(参见《EIP3工程化实施计划》第五节风险雷达:「JOR 布局存量超预期 → 报表 C 类预算重锁」)。

1.2 清点 SQL(客户环境执行)

前提:以下 SQL 在客户生产库或隔离测试副本(192.168.20.68:5435 / schema eip3)上只读执行。

-- ① 统计报表相关模板总量(TYPE 字段值待老员工确认,以下为候选值)
SELECT type, COUNT(*) AS cnt
FROM view_template
GROUP BY type
ORDER BY cnt DESC;

-- ② 定位含 JOR 布局引用的模板(关键词需老员工确认字段名)
-- 候选一:engineclass 含 JOR 相关类名
SELECT id, name, engineclass, type
FROM view_template
WHERE engineclass LIKE '%Jor%'
   OR engineclass LIKE '%JOR%'
   OR engineclass LIKE '%Report%'
   OR engineclass LIKE '%report%'
ORDER BY name;

-- ③ 扫描模板 XML 内容中是否含 JOR 布局标记
SELECT id, name, type,
       LENGTH(xml) AS xml_bytes
FROM view_template
WHERE xml LIKE '%jor%'
   OR xml LIKE '%JOR%'
   OR xml LIKE '%.jrxml%'
   OR xml LIKE '%jasper%'
ORDER BY name;

-- ④ 报表类模板汇总(用于 C 类预算锁定)
SELECT
    type,
    COUNT(*) AS total_cnt,
    SUM(CASE WHEN engineclass IS NOT NULL AND engineclass <> '' THEN 1 ELSE 0 END) AS with_engineclass,
    SUM(CASE WHEN xml LIKE '%jor%' OR xml LIKE '%JOR%' THEN 1 ELSE 0 END) AS jor_ref_cnt
FROM view_template
GROUP BY type
ORDER BY total_cnt DESC;

文件系统布局文件清点命令(客户服务器执行,需 SSH 权限):

# 查找 JOR 布局文件(.jrxml / .jasper / .jor 等扩展名)
find /opt/eip3 /var/eip3 /home/eip3 -name "*.jrxml" -o -name "*.jasper" -o -name "*.jor" 2>/dev/null | sort

# 统计各类型文件数量
find /opt/eip3 -type f \( -name "*.jrxml" -o -name "*.jasper" \) 2>/dev/null | wc -l

# 查看部署目录结构(确认报表文件存放路径)
# 实际路径待老员工确认
ls -la /opt/eip3/reports/ 2>/dev/null || echo "路径待确认"

说明:文件系统路径需老员工提供实际部署目录。以上为候选路径,执行前需确认。

1.3 客户环境执行步骤

步骤 操作 执行人 输出
1 确认客户测试副本网络可达(ping 192.168.20.68) 交付团队 连通确认
2 以只读账号连接数据库,执行 1.2 节 SQL ①–④ 交付团队 CSV 导出文件
3 SSH 客户服务器,执行文件系统清点命令 交付团队(需客户授权) 文件列表
4 老员工核对 SQL 结果:确认 JOR 相关 engineclass 名称、布局文件路径、实际数量 老员工 核对记录
5 将清点结果填入 1.4 输出表格 交付团队 清点报告
6 基于清点结果,与项目负责人对齐 P4 C 类预算 项目负责人 预算确认记录

标注:步骤 1–6 需客户环境访问权限,交付团队执行;步骤 4 强制要求老员工参与核对。

1.4 输出表格模板

清点结果汇总:

分类 模板数量 JOR 布局引用数量 对应文件系统文件数 备注
报表类模板(含 engineclass) 待填 待填 待填
报表类模板(无 engineclass,纯 XML) 待填 待填 —
JOR 引用但非报表类型模板 待填 待填 —
合计 待填 待填 待填

当前状态:数据库侧已完成(2026-06-11),文件系统侧待客户 SSH

【2026-06-11 增补】数据库侧清点结果(5435 网络恢复后实测):

项 数量 说明
模板总量(type 分布) 1,516 type=1:858 / 200:339 / 100:121 / 7:70 / 3:50 / 4:45 / 6:20 / 101:11 / 5:2(type 语义待老员工标注)
XML 含 JOR/jrxml/jasper 引用 45 C 类预算锚点;明细见 JOR布局引用模板清单.txt(id/名称/type/engineclass),其中多数无 engineclass(纯模板内嵌布局引用)
engineclass 含 Report/JOR 7 与 153 视图清单 A 桶交叉
<report> 段模板 337 与《报表迁移方案》A 类口径(333)吻合,差额 4 个待逐个核对

C 类(JOR→univer+Web打印)预算按 45 个布局引用估算;最终锁定仍需:① 客户服务器文件系统 .jrxml/.jasper 文件清点(需 SSH,交付团队);② 老员工核对 45 条明细中实际在用的子集(含「-未用」「-暂时不用」命名的疑似废弃模板)。


二、决策会开放项 1/3 状态登记

来源:《EIP3架构决策会纪要》第八节开放项表格 开放项总数:6 项;其中第 1、3 项为商务/法务事项,直接影响 M0 宣布通过

2.1 开放项 1:5435 副本书面确认(PoC 写测试合规性背书)

字段 内容
事项 确认 192.168.20.68:5435 为隔离测试副本(而非客户生产库直连),为 PoC 期间写测试的合规性提供书面背书
提出方 风控评审人
责任人 项目负责人
动作 项目负责人出具书面说明(邮件或内部确认单),明确:① 5435 为测试副本,非生产;② PoC 写测试数据已全部清理(eip4-poc 实验产物「实验产物全部清理,库零残留」已在 README 确认);③ 客户已知悉并授权此副本用于技术验证
期限 立项前书面确认(即 M0 出口前)
M0 出口影响 阻塞 M0 宣布通过(风控合规要求,无此确认则 PoC 证据合法性存疑)
当前状态 🔴 待办

2.2 开放项 3:客户合同 UI 条款核查

字段 内容
事项 核查现有客户合同是否含「UI 形态可变更」条款;即合同是否约定了具体 UI 技术(Vaadin 风格)或仅约定功能需求
提出方 风控评审人
责任人 商务
动作 商务调取合同附件,逐条核查 UI 相关条款;如合同中无 UI 形态约束,则出具「合同无 UI 技术锁定」确认函;如有约束,则评估影响范围并制定补充协议方案
期限 首客户切流方案确定前(决策会纪要第八节);建议在 M0 期间启动,不阻塞技术线,但阻塞「M0 宣布通过」
M0 出口影响 阻塞 M0 宣布通过(决策会商务条款:不确认 UI 条款则切流存在合同风险)
当前状态 🔴 待办

2.3 其余开放项状态(不阻塞技术线,不阻塞 M0)

开放项 责任人 期限 M0 影响 当前状态
旧系统可运行环境可得性(C1 逐行对拍基准) 技术负责人 P1 第一周 不阻塞 M0,阻塞 P1 推进 🟡 P1 第一周必答
153 视图「重写/降级/留旧」处置清单 项目负责人 立项后 2 周(即 M0 出口) 阻塞 M0(见《153定制视图处置清单v1.md》) 🟡 进行中
单客户复制成本模型(第二客户报价依据) 商务+技术 P4 结束前 不阻塞 M0 ⚪ 远期
amis 上游若复活(出 7.0 稳定版)的跟进决策机制 技术负责人 运维预算年审附带 不阻塞 M0 ⚪ 远期

三、M0 九项任务总状态表

对照《EIP3工程化实施计划》第一节 M0 启动周任务表 说明:C1–C5 为技术验证任务,状态见各自执行报告;此处登记整体状态与证据文件

# 任务 负责 通过标准 当前状态 证据文件 阻塞点
C1 逐行对拍框架:旧系统 SQL 录制切面 + 新引擎结果集逐行 diff 后端架构(老员工) ≥20 个代表性实体逐行一致率 100% 🟢 完成(客户库口径,2026-06-11):框架四件套落地 platform-parity;本地自举 21 实体/1,108 行 100% 后,客户库真实数据 24/24 实体通过(23 全量 442,529 行 + PM_PAYMENTAPPLY 抽样 2,000 行),零未解释差异;首轮 6/24 经四类归因迭代修 harness 达成(计算列/复合键/null 省略/布尔域/COLUMNSQL,均元数据感知、可见不判负);单测 23/23 eip4-platform/platform-parity/C1实测报告.md(含客户库口径节+归因台账);parity-reports/ 「新 vs 旧系统」录制重放对拍待旧系统环境(切面交付物已就绪);PM_PAYMENTAPPLY 全量(约 78 分钟)列夜间批跑待办
C2 数据权限最小真实现替换桩,纳入对拍样本 后端 ≥3 个行级过滤实体对拍通过 🟢 完成:framework 原版 DataPrivilegeServiceImpl/DataFilterHelper 原样移植(Jackson 1.x 共存),删桩;3 受控实体×3 用户 9/9 正例 150 行 100% 一致 + 3/3 负例 PrivilegeException 拒绝,全量回归 21/21;单测 9/9(独立复跑确认);ROLES 多值=LIST+中间表机制已查明并入手册 §5.8 eip4-platform/platform-auth/C2实测报告.md;platform-parity/parity-reports/privilege-parity-*.{json,md} P2 在 platform-auth 做组织/权限整体真实现(本实现即原版语义底座)
C3 Top 10 高频实体基础压测 + 慢查询采样 后端 + 架构 输出 P95 延迟基线文档 🟢 完成(双口径,2026-06-11):本地自举基线 + 客户库真实数据基线(9 实体含 34k 行大表与复杂视图,0 错误)。关键发现:首页延迟与表行数强相关(22ms→1.18s→4.6s),定位 DDL 索引/参数化/流式三个改造点的优先验证实体;为风险 R2 提供真实锚点 eip4-platform/docs/归档/C3压测基线.md(双口径+归因);JSON 在 eip4-platform/tools/loadtest/ 真实 Top10 待生产访问日志;正式 SLA 锚点待隔离准生产环境复测
C4 S3 脚本正则改写器原型在真实脚本上实测自动化率 后端 自动化率 ≥80% 锁定 P4 预算;<80% 按保守口径重估 🟢 完成(真实库口径,2026-06-11):全量 1,427 条实测,S3=612,自动化率 81.2%(497/612)≥80% 预算线锁定;31 条规则、单测 105/105、0 误改、硬 S3 85 条判定未放松(独立复跑确认)。教训:合成语料首测仅 7.1%,经 5 轮真实语料模式挖掘迭代达标——「文档模式 ≠ 真实写法」已记入报告附录 A eip4-platform/tools/s3_rewriter/C4实测报告.md;eval-real-20260611-final.json 剩余 115 条(PARTIAL 30+HARD 85)人工处理预算 0.5–1 人月(盘点口径内,上界 2.8 人月)
C5 amis 6.13.0 fork 可行性预演(独立构建通过) 前端 构建产物可替换 CDN 版本运行 🟢 完成:Node 22 全量构建成功(按拓扑序逐包构建),sdk.js 2.0MB 含 amisRequire,本地冒烟通过;止损 S2 不触发 eip4-platform/docs/归档/C5构建预演报告.md;产物 static/sdk-local/ + amis-local.html —
— 老员工知识转移:PoC 坑位记录整编为《迁移手册》v1 老员工 + 架构 手册过评审,backup 人选确定 🟡 进行中 eip4-platform/docs/迁移手册.md(本批交付) backup 人选待确定(项目负责人决策)
— 153 定制视图处置清单(重写/降级/留旧三分) 项目负责人 决策会开放项,2 周限期 🟡 进行中 153定制视图处置清单v1.md(本批交付,初判底稿) 需客户库 SQL 拉取完整列表 + 老员工终判
— JOR 报表布局客户环境清点 交付团队 报表 C 类预算锁定 🔴 未开始(需客户环境访问) — 客户环境网络访问权限;执行方案见本文档第一节
— 关闭决策会开放项 1/3(5435 副本书面确认、合同 UI 条款核查) 项目负责人/商务 书面记录 🔴 待办 — 商务行动项,见本文档第二节

状态说明

颜色 含义
✅ 绿 已完成,证据文件已归档
🟡 黄 进行中,有实质性进展
🔴 红 未开始 / 待办,需立即行动
⚪ 灰 远期,当前阶段不要求

M0 出口判断

M0 宣布通过的必要条件(全部变绿):

条件 当前状态
C1–C5 全部通过(或旧系统不可得时 C1 替代方案报批) 🟢 全部通过(2026-06-11,客户库口径;C1 录制重放半边待旧系统环境,自对拍口径已超额达标)
迁移手册 v1 过评审 + backup 人选确定 🟡 手册已出(含 §5.11–5.14 客户库新坑),评审和 backup 待跟进
153 视图处置清单终判完成 + 工时在止损线内 🟡 全量 153 条已拉取+初判归桶(工时初算 2.3–4.4 人月,上沿越线,终判须扩大留旧比例)
JOR 布局清点完成 + C 类预算锁定 🟡 数据库侧已完成(45 个 JOR 引用模板,清单落档);文件系统侧待客户 SSH
5435 副本书面确认(风控合规) 🔴 待办(商务)
合同 UI 条款核查结论 🔴 待办(商务)

技术线(C1–C5、手册、视图清单、JOR 清点)不依赖商务完成即可推进; 商务线(5435 确认、合同条款)不阻塞技术线,但阻塞「M0 宣布通过」; 项目负责人需并行推动两条线,确保 M0 两周内全部闭环。


文档维护:本文档由项目负责人负责维护;每次状态变更后更新版本号并注明变更日期;M0 宣布通过后归档,不再更新。