/** * core/dbLinkId.ts — dbLinkId 别名解析 * * 规则: * - undefined / '' / 'default' / 'DEFAULT' / '0' / '主库' / '业务库' * → ctx.dbLinkId (从 token 读; ctx 缺失时回退 '0') * - 其他 → 原值透传 * * 兼容 web formDesign 自动解析行为: * - web formDesign Form.vue 在 dbLinkId 字段如果用户选 "默认" / 留空, * 会自动使用当前应用 systemId 对应的业务库 (来自 token). * - dacli 必须等价地解析 'default' 别名, 否则 dispatch 的命令全部因 * 后端找不到 dbLinkEntity 而失败 (BS-48 假 PASS 案例). */ import type { AppContext } from './types.ts' /** * 解析 dbLinkId 别名. * * @param input 命令行传入的原始值 (来自 opts.dbLinkId) * @param ctx AppContext (loadContextSafe() 返回; null/undefined 时容错) * @returns 实际传给后端的 dbLinkId (string) */ export function resolveDbLinkId( input: string | null | undefined, ctx: AppContext | null | undefined, ): string { // 别名集合: 空 / 'default' / '主库' / '业务库' / '0' 都映射到 ctx.dbLinkId // '0' 也走别名 (兼容历史代码), 但 ctx 必须有有效 dbLinkId 才返回它, // 否则保留 '0' (BS-1 业务表误用主库由 guard 拦截) if ( !input || /^default$/i.test(input) || input === '主库' || input === '业务库' ) { return ctx?.dbLinkId || '0' } return input }