tier3(app/clear v3.1+ P1-2 follow-up): 业务库 preview fallback 走 dacli dm list

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 模块架构差异)
This commit is contained in:
ssw committed 2026-07-21 15:56:05 +08:00
1 parent f7bc8d55d0
commit cab1bb45f3
1 file changed
+44
+44
View File
@@ -430,9 +430,53 @@ async function fetchDbPreview(appCode: string): Promise<DbClearPreview> {
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<ReturnType<typeof JnpfClient.fromToken>>,
appCode: string,
): Promise<BizTable[]> {
// 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<DbClearResult> {
const c = await JnpfClient.fromToken()
const res = await c.postJson<DbClearResult>('/ssw/db/clear', {