- 从工作区根 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>
14 KiB
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 宣布通过后归档,不再更新。