Files
dacli/tests/unit/dbLinkId.test.ts
T
ClaudeandClaude 216a02f7f1 fix(dacli): BS-56/BS-42/enableFlow/JNPF 4 步法修复 (v0.11h+, 2026-06-28)
按 CLAUDE.md §2.7.1 4 步法修 4 个 dacli 盲点:

1. BS-56 增强: enCode 禁下划线 — 错误信息明确 + 自动建议别名
   - 新增 src/commands/_encode_validator.ts (统一 ENCODE_REGEXP/FULLNAME_REGEXP + validateEnCode + suggestEnCode)
   - form/dict/menu/role 4 个 _validate.ts 切换到共享 helper
   - 错误从'只能输入英文、数字和小数点且小数点不能放在首尾'升级为
     'BS-56: enCode 只能含英文/数字/小数点, 不能含下划线/连字符/中文. 当前 enCode=X 非法. 建议改成: --enCode=Y (自动去下划线/连字符)'

2. BS-42 升级: dm 系统列冲突清晰提示
   - 加 groupMap 给每个系统列别称 (f_description=描述, f_create_user=创建人 ID 等)
   - 消息包含改名建议 (f_desc/f_remark/f_brief/f_summary) 和 code='BS-42'

3. enableFlow 兜底: BS-EFLOW-NOWF guard
   - 在 _blindspot_guards.ts 加新 guard (WARN 级)
   - enableFlow=1 但 workflow list=0 时给明确警告
   - AppContext 加 workflowList 字段, loadAppContext 调 /workflow/Engine/list 收集
   - types.ts/client.ts/context.ts 全链路补 workflowList

4. JNPF 自检: 新增 core/_health_check.ts
   - app init/status 前置 HEAD baseUrl/ 健康检查 (3s timeout)
   - 不通时给 nohup 重启指引
   - JSON 输出 health: {ok, status, error, durationMs}, 不通时退出码 1

验证 (workSystem/jxcj1 PASS):
- BS-56 form/dict/menu 3 命令输出新格式错误 + 别名建议
- BS-42 dm create f_description 输出 BS-42 清晰信息
- JNPF 自检输出 '✓ JNPF 可达: http://nginx/api/ (status=200, 27ms)'

文件 (16 改 + 2 新增):
- src/commands/_encode_validator.ts (新增)
- src/core/_health_check.ts (新增)
- src/core/types.ts (workflowList)
- src/core/client.ts (resolveDbLinkId 兜底)
- src/commands/_blindspot_guards.ts (BS-EFLOW-NOWF)
- src/commands/app/context.ts (tryFetchWorkflows)
- src/commands/app/init.ts (前置健康检查)
- src/commands/app/status.ts (前置健康检查 + JSON 输出)
- src/commands/form/_validate.ts (共享 ENCODE_REGEXP)
- src/commands/dm/_validate.ts (BS-42 升级)
- src/commands/dict/_validate.ts (共享 + BS-56 增强)
- src/commands/menu/_validate.ts (共享 + BS-56 增强)
- src/commands/role/_validate.ts (共享 + BS-56 增强)
- src/commands/form/codegen.ts (workflowList 兜底)
- tests/unit/{blindspot_guards,bs54_guard,dbLinkId,verify_option}.test.ts (workflowList 兜底)

不违反红线:
- ❌ 不动 web/uniapp/jnpf 源码 (CLAUDE.md §15)
- ❌ 不绕过 dacli
- ✅ 一轮一提交 (CLAUDE.md §14)
- ✅ npx tsc --noEmit 在改动文件无新错

Co-Authored-By: Claude <[email protected]>
2026-06-28 23:50:58 +08:00

93 lines
3.0 KiB
TypeScript

/**
* unit/dbLinkId.test.ts — resolveDbLinkId 别名解析单测
*
* 覆盖场景:
* - 'default' (小写) → ctx.dbLinkId
* - 'DEFAULT' (大写, case-insensitive) → ctx.dbLinkId
* - 'Default' (混合大小写) → ctx.dbLinkId
* - '主库' (中文别名) → ctx.dbLinkId
* - '业务库' (中文别名) → ctx.dbLinkId
* - undefined / '' (空) → ctx.dbLinkId
* - '0' (主库标识) → ctx.dbLinkId
* - 显式数字 id (如 '2068901937849257984') → 原值透传
* - ctx 缺失时 → '0' 兜底
* - ctx 缺失 + 有 input (显式 id) → 原值透传
*/
import { describe, it, expect } from 'vitest'
import { resolveDbLinkId } from '../../src/core/dbLinkId.ts'
import type { AppContext } from '../../src/core/types.ts'
const baseCtx: AppContext = {
appCode: 'jxcj',
dbLinkId: '2068901937849257984',
tokenStatus: 'valid',
existingEnCodes: [],
unreleasedForms: [],
releasedForms: [],
modifiedAfterPublishForms: [],
workflowList: [],
existingTables: [],
menus: [],
currentVersion: '0.11',
warnings: [],
}
describe('resolveDbLinkId', () => {
it("'default' 小写别名 → ctx.dbLinkId", () => {
expect(resolveDbLinkId('default', baseCtx)).toBe('2068901937849257984')
})
it("'DEFAULT' 大写别名 (case-insensitive) → ctx.dbLinkId", () => {
expect(resolveDbLinkId('DEFAULT', baseCtx)).toBe('2068901937849257984')
})
it("'Default' 混合大小写 → ctx.dbLinkId", () => {
expect(resolveDbLinkId('Default', baseCtx)).toBe('2068901937849257984')
})
it("'主库' 中文别名 → ctx.dbLinkId", () => {
expect(resolveDbLinkId('主库', baseCtx)).toBe('2068901937849257984')
})
it("'业务库' 中文别名 → ctx.dbLinkId", () => {
expect(resolveDbLinkId('业务库', baseCtx)).toBe('2068901937849257984')
})
it('undefined 输入 → ctx.dbLinkId', () => {
expect(resolveDbLinkId(undefined, baseCtx)).toBe('2068901937849257984')
})
it("'' 空字符串 → ctx.dbLinkId", () => {
expect(resolveDbLinkId('', baseCtx)).toBe('2068901937849257984')
})
it("'0' 主库标识 → 原值透传 (BS-1 由 guard 拦截)", () => {
// '0' 不是别名, 是合法的"主库"标识, 由 BS-1 guard 在业务表场景拦截
expect(resolveDbLinkId('0', baseCtx)).toBe('0')
})
it('显式数字 id → 原值透传 (向后兼容)', () => {
expect(resolveDbLinkId('664077319056394183', baseCtx)).toBe('664077319056394183')
})
it('ctx=null + 无 input → 兜底 "0"', () => {
expect(resolveDbLinkId(undefined, null)).toBe('0')
})
it('ctx=null + "default" → 兜底 "0"', () => {
expect(resolveDbLinkId('default', null)).toBe('0')
})
it('ctx=null + 显式 id → 原值透传', () => {
expect(resolveDbLinkId('664077319056394183', null)).toBe('664077319056394183')
})
it('ctx=undefined (缺省) + "default" → 兜底 "0"', () => {
expect(resolveDbLinkId('default', undefined)).toBe('0')
})
it('null 输入 (旧客户端代码) → ctx.dbLinkId', () => {
expect(resolveDbLinkId(null, baseCtx)).toBe('2068901937849257984')
})
})