Files
eip4-platform/docs/M0交付/M0剩余项状态登记.md
zhengwr 1b69f8b481
Some checks failed
ci / build-test-parity (push) Has been cancelled
docs: 统一项目文档进 eip4-platform/docs + 新增进度路线总览
- 从工作区根 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>
2026-06-17 14:53:29 +08:00

199 lines
14 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)上只读执行。
```sql
-- ① 统计报表相关模板总量(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 权限):
```bash
# 查找 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 宣布通过后归档,不再更新。