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>
199 lines
14 KiB
Markdown
199 lines
14 KiB
Markdown
# 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 宣布通过后归档,不再更新。
|