根因 (2026-06-24 tdd8 调试):
- dacli wrapSimplifiedFields 的 vmodel fallback 链全空时返回 ''
- 后端 INSERT SQL 用 tables.fields[].field 作列名 (JNPF 老规范)
- dacli dm create 建表 column 用 f_xxx (v0.7+ 新规范)
- 两者不匹配 → 保存报 'Unknown column comInputField101'
修复:
- _simplify.ts:165 加 fallback, 从 rawField 顶层找第一个 f_ 开头的 key
- _blindspot_guards.ts 加 BS-60 WARN 预警, 字段缺 vmodel/field/vmodel/f_xxx 时打印修复指引
- field_normalize.test.ts 加 3 单元测试 (fallback 触发/优先级/多字段)
- blindspot_guards.test.ts 加 3 触发测试 (WARN/no-WARN/no-WARN)
tdd8 验证:
- form 1 (tdd8_inspection) PUT 修复后保存 'New created successfully' ✓
- form 2/3 暴露 datetime/userSelect 序列化问题 (后续 polish 范围)
🤖 Generated with Claude Code
310 lines
12 KiB
TypeScript
310 lines
12 KiB
TypeScript
/**
|
|
* blindspot_guards.test.ts — _blindspot_guards.ts 单测 (P2.1)
|
|
*
|
|
* 覆盖:
|
|
* - 22 条 guard 全部存在 (BS-1/4/5/7/8/14/15b/28/32b/37/38/39/40/41/42/43/44/45/46/47/48/49/50/51)
|
|
* - 关键 ERROR guard 触发 (BS-48/49/47/50/4/1/7/38/39/8/5/32b/51)
|
|
* - 正常场景 0 ERROR
|
|
* - 占位符插值 (${enCode}/${table}/${formId})
|
|
* - 容错: ctx=null 不抛
|
|
*/
|
|
import { describe, it, expect } from 'vitest'
|
|
import { BLINDSPOT_GUARDS, runGuards, hasErrors, formatIssues, type BlindspotIssue } from '../../src/commands/_blindspot_guards.ts'
|
|
import type { AppContext } from '../../src/core/types.ts'
|
|
|
|
const baseCtx: AppContext = {
|
|
appCode: 'tds',
|
|
dbLinkId: '446561733648563553',
|
|
tokenStatus: 'valid',
|
|
existingEnCodes: ['leaveApply', 'project', 'tds_leave', 'f_description_conflict'],
|
|
unreleasedForms: ['form_draft1'],
|
|
releasedForms: ['form_leaveApply', 'form_project', 'form_tds_leave'],
|
|
modifiedAfterPublishForms: [],
|
|
existingTables: ['tds_leave', 'tds_project'],
|
|
menus: ['leaveApply', 'project'],
|
|
currentVersion: 'v0.9',
|
|
warnings: [],
|
|
}
|
|
|
|
describe('blindspot guards — 完整性', () => {
|
|
it('guard 数量 ≥ 22 (高频盲点覆盖)', () => {
|
|
expect(BLINDSPOT_GUARDS.length).toBeGreaterThanOrEqual(22)
|
|
})
|
|
|
|
it('guard id 唯一', () => {
|
|
const ids = BLINDSPOT_GUARDS.map(g => g.id)
|
|
expect(new Set(ids).size).toBe(ids.length)
|
|
})
|
|
|
|
it('必备 id 都存在 (BS-1/4/5/7/8/14/15b/28/38/39/47/48/49/50/51)', () => {
|
|
const ids = BLINDSPOT_GUARDS.map(g => g.id)
|
|
const required = ['BS-1', 'BS-4', 'BS-5', 'BS-7', 'BS-8', 'BS-14', 'BS-15b', 'BS-28', 'BS-38', 'BS-39', 'BS-47', 'BS-48', 'BS-49', 'BS-50', 'BS-51']
|
|
for (const r of required) {
|
|
expect(ids).toContain(r)
|
|
}
|
|
})
|
|
})
|
|
|
|
describe('blindspot guards — 关键 ERROR 触发', () => {
|
|
it('BS-48: dbLinkId="0" 应触发', () => {
|
|
const issues = runGuards(baseCtx, { dbLinkId: '0' })
|
|
expect(issues.some(i => i.id === 'BS-48' && i.level === 'ERROR')).toBe(true)
|
|
})
|
|
|
|
it('BS-48: type=4 + dbLinkId="0" 不应触发 (视图允许)', () => {
|
|
const issues = runGuards(baseCtx, { dbLinkId: '0', type: 4 })
|
|
expect(issues.some(i => i.id === 'BS-48')).toBe(false)
|
|
})
|
|
|
|
it('BS-48: dbLinkId="default" 应触发 (v0.11 别名拦截)', () => {
|
|
const issues = runGuards(baseCtx, { dbLinkId: 'default' })
|
|
expect(issues.some(i => i.id === 'BS-48' && i.level === 'ERROR')).toBe(true)
|
|
})
|
|
|
|
it('BS-48: dbLinkId="DEFAULT" (大写) 应触发 (case-insensitive)', () => {
|
|
const issues = runGuards(baseCtx, { dbLinkId: 'DEFAULT' })
|
|
expect(issues.some(i => i.id === 'BS-48' && i.level === 'ERROR')).toBe(true)
|
|
})
|
|
|
|
it('BS-48: 显式有效 dbLinkId 不应触发', () => {
|
|
const issues = runGuards(baseCtx, { dbLinkId: '2068901937849257984' })
|
|
expect(issues.some(i => i.id === 'BS-48')).toBe(false)
|
|
})
|
|
|
|
it('BS-49: enCode 重复应触发', () => {
|
|
const issues = runGuards(baseCtx, { enCode: 'leaveApply' })
|
|
expect(issues.some(i => i.id === 'BS-49' && i.level === 'ERROR')).toBe(true)
|
|
})
|
|
|
|
it('BS-47: dict fullName 重复应触发', () => {
|
|
const issues = runGuards(baseCtx, { fullName: 'leaveApply' })
|
|
expect(issues.some(i => i.id === 'BS-47' && i.level === 'ERROR')).toBe(true)
|
|
})
|
|
|
|
it('BS-50: menu create --formId 不可见 form 应触发', () => {
|
|
const issues = runGuards(baseCtx, { formId: '999999999' })
|
|
expect(issues.some(i => i.id === 'BS-50' && i.level === 'ERROR')).toBe(true)
|
|
})
|
|
|
|
it('BS-4: form 未发布就绑菜单应触发', () => {
|
|
const issues = runGuards(baseCtx, { formId: 'form_draft1' })
|
|
expect(issues.some(i => i.id === 'BS-4' && i.level === 'ERROR')).toBe(true)
|
|
})
|
|
|
|
it('BS-1: 业务表 + dbLinkId="0" 应触发', () => {
|
|
const issues = runGuards(baseCtx, { table: 'tds_xxx', dbLinkId: '0' })
|
|
expect(issues.some(i => i.id === 'BS-1' && i.level === 'ERROR')).toBe(true)
|
|
})
|
|
|
|
it('BS-7: type=2 + enableFlow=true 应触发', () => {
|
|
const issues = runGuards(baseCtx, { type: 2, enableFlow: true })
|
|
expect(issues.some(i => i.id === 'BS-7' && i.level === 'ERROR')).toBe(true)
|
|
})
|
|
|
|
it('BS-7: type=3 + enableFlow=true 应触发', () => {
|
|
const issues = runGuards(baseCtx, { type: 3, enableFlow: '1' })
|
|
expect(issues.some(i => i.id === 'BS-7' && i.level === 'ERROR')).toBe(true)
|
|
})
|
|
|
|
it('BS-38: 业务字段含 f_description 应触发', () => {
|
|
const issues = runGuards(baseCtx, { fields: [{ field: 'f_description', fieldName: '描述' }] })
|
|
expect(issues.some(i => i.id === 'BS-38' && i.level === 'ERROR')).toBe(true)
|
|
})
|
|
|
|
it('BS-39: 业务字段含 f_version 应触发', () => {
|
|
const issues = runGuards(baseCtx, { fields: [{ field: 'f_version', __vModel__: 'f_version' }] })
|
|
expect(issues.some(i => i.id === 'BS-39' && i.level === 'ERROR')).toBe(true)
|
|
})
|
|
|
|
it('BS-8: token expired 应触发', () => {
|
|
const ctx: AppContext = { ...baseCtx, tokenStatus: 'expired' }
|
|
const issues = runGuards(ctx, {})
|
|
expect(issues.some(i => i.id === 'BS-8' && i.level === 'ERROR')).toBe(true)
|
|
})
|
|
|
|
it('BS-5: AppContext 缺 existingEnCodes 应触发', () => {
|
|
const ctx: AppContext = { ...baseCtx, existingEnCodes: [] }
|
|
const issues = runGuards(ctx, {})
|
|
expect(issues.some(i => i.id === 'BS-5' && i.level === 'ERROR')).toBe(true)
|
|
})
|
|
|
|
it('BS-32b: 依赖 create 响应 id 应触发', () => {
|
|
const issues = runGuards(baseCtx, { expectResponseId: true })
|
|
expect(issues.some(i => i.id === 'BS-32b' && i.level === 'ERROR')).toBe(true)
|
|
})
|
|
|
|
it('BS-51: 简化 columnList (fields+无 tables) 应触发', () => {
|
|
const issues = runGuards(baseCtx, { fields: [{ field: 'f_name' }] })
|
|
expect(issues.some(i => i.id === 'BS-51' && i.level === 'ERROR')).toBe(true)
|
|
})
|
|
})
|
|
|
|
describe('blindspot guards — WARN 触发', () => {
|
|
it('BS-28: --autoRelease bare flag 应触发 WARN', () => {
|
|
const issues = runGuards(baseCtx, { autoRelease: true })
|
|
expect(issues.some(i => i.id === 'BS-28' && i.level === 'WARN')).toBe(true)
|
|
})
|
|
|
|
it('BS-15b: 缺系统列应触发 WARN', () => {
|
|
const issues = runGuards(baseCtx, { fields: [{ field: 'f_name', fieldName: '名称' }] })
|
|
expect(issues.some(i => i.id === 'BS-15b' && i.level === 'WARN')).toBe(true)
|
|
})
|
|
|
|
it('BS-14: type=4 + autoRelease 应触发 WARN', () => {
|
|
const issues = runGuards(baseCtx, { type: 4, autoRelease: true })
|
|
expect(issues.some(i => i.id === 'BS-14' && i.level === 'WARN')).toBe(true)
|
|
})
|
|
|
|
it('BS-37: form 已发布但未挂菜单应触发 WARN', () => {
|
|
const issues = runGuards(baseCtx, { enCode: 'tds_leave' })
|
|
// tds_leave 在 releasedForms 但不在 menus → 应触发
|
|
expect(issues.some(i => i.id === 'BS-37' && i.level === 'WARN')).toBe(true)
|
|
})
|
|
|
|
it('BS-44: type=1 不传 tables 应触发 WARN', () => {
|
|
const issues = runGuards(baseCtx, { type: 1 })
|
|
expect(issues.some(i => i.id === 'BS-44' && i.level === 'WARN')).toBe(true)
|
|
})
|
|
|
|
it('BS-43: v0.6.x 版本 form release 应触发 WARN', () => {
|
|
const ctx: AppContext = { ...baseCtx, currentVersion: 'v0.6.5' }
|
|
const issues = runGuards(ctx, {})
|
|
expect(issues.some(i => i.id === 'BS-43' && i.level === 'WARN')).toBe(true)
|
|
})
|
|
})
|
|
|
|
describe('blindspot guards — 正常场景不误报', () => {
|
|
it('标准 form create (type=1, webType=2, 业务库, 唯一 enCode, 带 fields+tables) 应 0 ERROR', () => {
|
|
const issues = runGuards(baseCtx, {
|
|
enCode: 'new_form',
|
|
fullName: '新表单',
|
|
dbLinkId: '446561733648563553',
|
|
table: 'tds_new_form',
|
|
type: 1,
|
|
webType: 2,
|
|
fields: [
|
|
{ field: 'f_id', __vModel__: 'f_id' },
|
|
{ field: 'f_tenant_id', __vModel__: 'f_tenant_id' },
|
|
{ field: 'f_name', __vModel__: 'f_name', __config__: { jnpfKey: 'input', label: '名称' } },
|
|
],
|
|
tables: [{ table: 'tds_new_form', tableName: '新表单', fields: [{ field: 'f_id' }, { field: 'f_tenant_id' }, { field: 'f_name' }] }],
|
|
})
|
|
const errors = issues.filter(i => i.level === 'ERROR')
|
|
expect(errors).toHaveLength(0)
|
|
})
|
|
|
|
it('空 opts 应 0 ERROR (ctx 有效, 触发依赖 ctx 的 guard)', () => {
|
|
const issues = runGuards(baseCtx, {})
|
|
const errors = issues.filter(i => i.level === 'ERROR')
|
|
expect(errors).toHaveLength(0)
|
|
})
|
|
})
|
|
|
|
describe('blindspot guards — 占位符插值', () => {
|
|
it('BS-49 message 应含 enCode 实际值', () => {
|
|
const issues = runGuards(baseCtx, { enCode: 'leaveApply' })
|
|
const issue = issues.find(i => i.id === 'BS-49')
|
|
expect(issue?.message).toContain('leaveApply')
|
|
})
|
|
|
|
it('BS-1 message 应含 table 实际值', () => {
|
|
const issues = runGuards(baseCtx, { table: 'tds_x', dbLinkId: '0' })
|
|
const issue = issues.find(i => i.id === 'BS-1')
|
|
expect(issue?.message).toContain('tds_x')
|
|
})
|
|
|
|
it('BS-50 message 应含 formId 实际值', () => {
|
|
const issues = runGuards(baseCtx, { formId: '999999' })
|
|
const issue = issues.find(i => i.id === 'BS-50')
|
|
expect(issue?.message).toContain('999999')
|
|
})
|
|
})
|
|
|
|
describe('blindspot guards — 容错', () => {
|
|
it('ctx=null 不应抛异常', () => {
|
|
expect(() => runGuards(null, { enCode: 'X' })).not.toThrow()
|
|
})
|
|
|
|
it('ctx=null + 触发 ctx 依赖的 guard 应被跳过 (不抛)', () => {
|
|
const issues = runGuards(null, { enCode: 'X' })
|
|
expect(Array.isArray(issues)).toBe(true)
|
|
})
|
|
|
|
it('opts=null 应不抛', () => {
|
|
expect(() => runGuards(baseCtx)).not.toThrow()
|
|
})
|
|
|
|
it('guard check 内部抛错应被捕获 (容错单个 guard)', () => {
|
|
// 用一个会 throw 的 guard 测试容错
|
|
// 这里通过现有 guard 验证: 传 weird 类型的 opts 不应让 runGuards 整体挂掉
|
|
const issues = runGuards(baseCtx, { fields: null as any, tables: undefined })
|
|
expect(Array.isArray(issues)).toBe(true)
|
|
})
|
|
})
|
|
|
|
describe('hasErrors / formatIssues 工具方法', () => {
|
|
it('hasErrors: 有 ERROR → true', () => {
|
|
const issues: BlindspotIssue[] = [{ id: 'BS-X', level: 'ERROR', trigger: 't', message: 'm', fix: 'f' }]
|
|
expect(hasErrors(issues)).toBe(true)
|
|
})
|
|
|
|
it('hasErrors: 仅 WARN → false', () => {
|
|
const issues: BlindspotIssue[] = [{ id: 'BS-X', level: 'WARN', trigger: 't', message: 'm', fix: 'f' }]
|
|
expect(hasErrors(issues)).toBe(false)
|
|
})
|
|
|
|
it('hasErrors: 空 → false', () => {
|
|
expect(hasErrors([])).toBe(false)
|
|
})
|
|
|
|
it('formatIssues: 空 → 空串', () => {
|
|
expect(formatIssues([])).toBe('')
|
|
})
|
|
|
|
it('formatIssues: 有 issues → 含 [ERROR]/[WARN] + id + fix', () => {
|
|
const issues: BlindspotIssue[] = [
|
|
{ id: 'BS-48', level: 'ERROR', trigger: 't', message: 'm1', fix: 'f1' },
|
|
{ id: 'BS-28', level: 'WARN', trigger: 't', message: 'm2', fix: 'f2' },
|
|
]
|
|
const out = formatIssues(issues)
|
|
expect(out).toContain('[ERROR]')
|
|
expect(out).toContain('BS-48')
|
|
expect(out).toContain('[WARN]')
|
|
expect(out).toContain('BS-28')
|
|
expect(out).toContain('f1')
|
|
expect(out).toContain('f2')
|
|
})
|
|
})
|
|
|
|
describe('blindspot guards — BS-60 vmodel 缺失', () => {
|
|
it('BS-60: 字段没 vmodel/field 且无 f_xxx 占位应 WARN', () => {
|
|
const issues = runGuards(baseCtx, {
|
|
fields: [
|
|
{ __config__: { label: '设备名称', jnpfKey: 'input' } }, // 无 __vModel__/field/vmodel/f_xxx
|
|
],
|
|
type: 1, webType: 1,
|
|
})
|
|
expect(issues.some(i => i.id === 'BS-60' && i.level === 'WARN')).toBe(true)
|
|
})
|
|
|
|
it('BS-60: 字段有 f_xxx 占位不应触发 (修复后路径)', () => {
|
|
const issues = runGuards(baseCtx, {
|
|
fields: [
|
|
{ f_device_name: '', __config__: { label: '设备名称', jnpfKey: 'input' } },
|
|
],
|
|
type: 1, webType: 1,
|
|
})
|
|
expect(issues.some(i => i.id === 'BS-60')).toBe(false)
|
|
})
|
|
|
|
it('BS-60: 字段显式 __vModel__ 不应触发', () => {
|
|
const issues = runGuards(baseCtx, {
|
|
fields: [
|
|
{ __vModel__: 'f_name', __config__: { label: 'x', jnpfKey: 'input' } },
|
|
],
|
|
type: 1, webType: 1,
|
|
})
|
|
expect(issues.some(i => i.id === 'BS-60')).toBe(false)
|
|
})
|
|
})
|