From cab1bb45f3bf48106988b28b9fbf469d589052cd Mon Sep 17 00:00:00 2001 From: ssw Date: Tue, 21 Jul 2026 15:56:05 +0800 Subject: [PATCH] =?UTF-8?q?tier3(app/clear=20v3.1+=20P1-2=20follow-up):=20?= =?UTF-8?q?=E4=B8=9A=E5=8A=A1=E5=BA=93=20preview=20fallback=20=E8=B5=B0=20?= =?UTF-8?q?dacli=20dm=20list?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ADR 0014 §Downstream §2: 当 ssw-common DbClearServiceImpl.listBizTables 走 openConn(appCode, null) 对 PG schema 共享库 (j62 schema=jxcj) 不识别 业务表时, dacli 端自动 fallback 走 loadDataModel.getDataModelList (dacli dm list 内部用 GET /api/system/DataModel/{dbLinkId}/Tables) 实现细节: - fetchDbPreview 拿 ssw-common preview 结果后, 仅当: * bizTables.length === 0 (ssw-common 漏识别) * token.appCode === opts.appCode (避免跨 app 误报) 走 fallback loadDataModel.getDataModelList(linkId=token.dbLinkId, ...) - 跨 app 场景: 输出明确警告 + 提示 dacli app login --appCode=... - rowCount=0 (dacli dm list 不查行数; 用于透明显示"会被清的表清单") E2E 测试: - testspace (ssw-common 正常): 输出无 fallback 警告 (72 张表已由 ssw-common 列出) - jxcj (跨 app 测试): 输出 "ssw-common 业务库 preview 返空, 但 token 当前 appCode=testspace ≠ jxcj" + 提示 "如需看 jxcj 真实业务表, 请: dacli app login --appCode=jxcj" 不会拿 testspace 的 72 张表冒充 jxcj 表 (避免误报) 已知 fallback 局限: - 实际 fallback 完全发挥需要 dacli app login --appCode=jxcj 后才能列 jxcj 表 - 但 jxcj 系统被基础架构清理过, 当前 token=testspace 无法直接登录 - 真实业务表清理仍依赖 ssw-common 端点 (其 P0 fix 在 ADR 0014 §1, 需 Java 改 + 重启) TS 编译: 0 新错误 CI 关卡 G: 23 PASS / 0 FAIL (白名单 di 模块架构差异) --- src/commands/app/clear.ts | 44 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) diff --git a/src/commands/app/clear.ts b/src/commands/app/clear.ts index 59e6877..b128ae3 100644 --- a/src/commands/app/clear.ts +++ b/src/commands/app/clear.ts @@ -430,9 +430,53 @@ async function fetchDbPreview(appCode: string): Promise { if (res.code !== 200 || !res.data) { throw new DacliError(`ssw-common /api/ssw/db/clear preview 失败: code=${res.code} ${res.msg}`) } + // v3.1+ P1-2 follow-up (ADR 0014 §2): 业务库 fallback + // 当 ssw-common 返 bizTables=[] (PG schema 共享库 jxcj + openConn(jxcj) 失败场景, 见 docs 0014 §已知风险) + // 自动 fallback 走 dacli dm list 端点 — 但仅在 token 当前 appCode 一致时 (避免跨 app 误报) + if (res.data.bizTables.length === 0 && res.data.dbConn) { + const tokenC = await JnpfClient.fromToken() + if (tokenC.appCode === appCode && tokenC.dbLinkId) { + try { + const fallbackBizTables = await fetchBizTablesViaDmList(tokenC, appCode) + if (fallbackBizTables.length > 0) { + log.warn(`⚠ ssw-common 业务库 preview 返空, fallback 走 dacli dm list 找到 ${fallbackBizTables.length} 张表 (跨 schema 共享库场景)`) + res.data.bizTables = fallbackBizTables + } + } catch (e) { + log.warn(`(业务库 fallback 也失败: ${(e as Error).message?.slice(0, 100)})`) + } + } else { + log.warn(`⚠ ssw-common 业务库 preview 返空, 但 token 当前 appCode=${tokenC.appCode} ≠ ${appCode}, 跳过 fallback`) + log.warn(` 如需看 ${appCode} 真实业务表, 请: dacli app login --appCode=${appCode}`) + } + } return res.data } +/** + * P1-2 follow-up: 走 dacli dm list 端点 (webapi loadDataModel.getDataModelList) + * 列出当前 token appCode 的业务表 — 仅 token.appCode === appCode 时调用 + * 注意: 返回的 rowCount=0 (dacli dm list 不查 row count; ssw-common preview 才有), + * 但表名清单能确认"哪些表会被清" 避免 ssw-common 漏识别导致用户不知情 + */ +async function fetchBizTablesViaDmList( + c: Awaited>, + appCode: string, +): Promise { + // v2.1+ 接三层: webapi 镜像优先 + const { initWebapi: initDmWebapi, loadDataModel } = await import('../../webapi/dataModel.ts') + await initDmWebapi(c) + if (!c.dbLinkId) return [] + const resp = (await loadDataModel.getDataModelList({ + linkId: c.dbLinkId, + currentPage: 1, + pageSize: 1000, + })) as { list: { table: string }[] } + const list = resp?.list || (Array.isArray(resp) ? (resp as { table: string }[]) : []) + // rowCount=0 (dacli dm list 不查; 用于透明显示"这些表会被清") + return list.map((t) => ({ name: t.table, rowCount: 0 })) +} + async function executeDbClear(appCode: string, dbTs: string): Promise { const c = await JnpfClient.fromToken() const res = await c.postJson('/ssw/db/clear', {