Files
dacli/tests/unit/relation_form_complete.test.ts
T
ssw 0b14466681 fix(dacli): 5 项 tdd8 smoke test 命中修复 — relationForm 4 字段闭环
#1 新增 dacli form relation-form-complete 命令
  - 自动补 relationForm 4 字段 (jnpfKey/modelId/propsValue/relationField)
  - propsValue 从 target 表 f_*_name 字段自动推
  - relationField 默认 = source FK 字段自身
  - --dry-run 模式只推导不写
  - 19 个单测覆盖 (isRelationFormComplete/pickDisplayField/deriveCompletion)

#2 form update --fields 加 --strict 校验 (默认 ON)
  - relationForm 4 字段缺任一 → ctx.fail + 提示用 relation-form-complete 自动补
  - --no-strict 兼容老用法
  - 7 个单测覆盖 (validateRelationFormFields)

#4 --json 模式 log.* 走 stderr
  - log.ts 加 setJsonMode()/isJsonMode()
  - info/ok/warn/dim/raw 在 jsonMode 时走 stderr
  - setupOutputFilter 自动联动
  - 修 menu/info.ts 启用 setupOutputFilter (之前直接 log.* 污染 stdout)
  - 修 4 个测试 mock 补 setJsonMode + isJsonMode

#6 menu info 加 formEnCode 反查
  - 从 propertyJson.moduleId → form list 反查
  - 输出 relatedForms[] 含 formEnCode/formId/fullName
  - 解决 form enCode 与 menu enCode hash 后缀不一致问题

#8 TC-A 报告 PASS 显式标 SKIP/FAIL 区分
  - '通过: 4/5 (4 PASS + 0 FAIL + 1 SKIP)' 而非仅 '4/5'

实测 tdd8 (本轮 smoke test) 43/46 → 应能提升 (TC-C relationForm FAIL 修复)

质量门 (scripts/quality-gate.sh):
  [1/4] tsc --noEmit: 0 错误
  [2/4] vitest run tests/unit: 415 passed (含 26 个新测)
  [3/4] doc:check: 0 drift (272 文件扫过)
  [4/4] backend smoke: dacli form list PASS
2026-07-24 22:29:54 +08:00

221 lines
6.5 KiB
TypeScript

// dacli/tests/unit/relation_form_complete.test.ts
/**
* _relation_form_complete.ts 纯函数单测 (2026-07-24 固化)
*
* 覆盖:
* - isRelationFormComplete: 4 字段完整性检测
* - pickDisplayField: target 表 display field 优先级选择
* - deriveCompletion: 推导 before/after + completed/skipped 分类
*/
import { describe, expect, it } from 'vitest'
import {
isRelationFormComplete,
pickDisplayField,
deriveCompletion,
} from '../../src/commands/form/relation_form_complete.ts'
describe('isRelationFormComplete', () => {
it('4 字段齐全 → complete=true', () => {
const r = isRelationFormComplete({
jnpfKey: 'relationForm',
modelId: '123',
propsValue: 'f_equipment_name',
relationField: 'f_equipment_code_ref',
})
expect(r.complete).toBe(true)
expect(r.missing).toEqual([])
})
it('缺 modelId → missing=[modelId]', () => {
const r = isRelationFormComplete({
jnpfKey: 'relationForm',
propsValue: 'f_x',
relationField: 'f_y',
})
expect(r.complete).toBe(false)
expect(r.missing).toEqual(['modelId'])
})
it('缺 propsValue → missing=[propsValue]', () => {
const r = isRelationFormComplete({
jnpfKey: 'relationForm',
modelId: '123',
relationField: 'f_y',
})
expect(r.missing).toEqual(['propsValue'])
})
it('缺 relationField → missing=[relationField]', () => {
const r = isRelationFormComplete({
jnpfKey: 'relationForm',
modelId: '123',
propsValue: 'f_x',
})
expect(r.missing).toEqual(['relationField'])
})
it('缺全部 3 字段 → missing=[modelId, propsValue, relationField]', () => {
const r = isRelationFormComplete({ jnpfKey: 'relationForm' })
expect(r.missing).toEqual(['modelId', 'propsValue', 'relationField'])
})
it('jnpfKey ≠ relationForm → complete=true (不参与补全)', () => {
const r = isRelationFormComplete({ jnpfKey: 'input', modelId: 'x' })
expect(r.complete).toBe(true)
})
it('cfg undefined → complete=false, missing=[__config__]', () => {
const r = isRelationFormComplete(undefined)
expect(r.complete).toBe(false)
expect(r.missing).toEqual(['__config__'])
})
})
describe('pickDisplayField', () => {
it('优先匹配 f_*_name', () => {
const fields = [
{ field: 'f_equipment_code', jnpfKey: 'input' },
{ field: 'f_equipment_name', jnpfKey: 'input' },
{ field: 'f_remark', jnpfKey: 'textarea' },
]
expect(pickDisplayField(fields)).toBe('f_equipment_name')
})
it('f_*_full_name 优先于 f_*_name', () => {
const fields = [
{ field: 'f_user_name', jnpfKey: 'input' },
{ field: 'f_user_full_name', jnpfKey: 'input' },
]
expect(pickDisplayField(fields)).toBe('f_user_name') // 完全匹配优先
})
it('包含 name 子串 (fallback)', () => {
const fields = [
{ field: 'f_equipment_code', jnpfKey: 'input' },
{ field: 'f_equipment_nickname', jnpfKey: 'input' }, // 含 name 子串
]
expect(pickDisplayField(fields)).toBe('f_equipment_nickname')
})
it('系统字段 (f_id/f_tenant_id/f_create_time) 不作为候选', () => {
const fields = [
{ field: 'f_id', jnpfKey: 'inputNumber' },
{ field: 'f_tenant_id', jnpfKey: 'input' },
{ field: 'f_create_time', jnpfKey: 'datePicker' },
{ field: 'f_remark', jnpfKey: 'textarea' },
]
// f_remark 不含 name, 是 fallback (第一个非系统)
expect(pickDisplayField(fields)).toBe('f_remark')
})
it('空数组 → undefined', () => {
expect(pickDisplayField([])).toBeUndefined()
})
it('全是系统字段 → undefined', () => {
const fields = [
{ field: 'f_id', jnpfKey: 'inputNumber' },
{ field: 'f_tenant_id', jnpfKey: 'input' },
]
expect(pickDisplayField(fields)).toBeUndefined()
})
it('无 name 字段 → fallback 第一个非系统字段', () => {
const fields = [
{ field: 'f_equipment_code', jnpfKey: 'input' },
{ field: 'f_quantity', jnpfKey: 'inputNumber' },
]
expect(pickDisplayField(fields)).toBe('f_equipment_code')
})
})
describe('deriveCompletion', () => {
it('已完整 → completed=[], skipped=[]', () => {
const r = deriveCompletion(
{
__vModel__: 'f_x_ref',
__config__: {
jnpfKey: 'relationForm',
modelId: '123',
propsValue: 'f_x_name',
relationField: 'f_x_ref',
},
},
[],
'tx',
)
expect(r.completed).toEqual([])
expect(r.skipped).toEqual([])
})
it('缺 propsValue + relationField → 2 个 completed', () => {
const r = deriveCompletion(
{
__vModel__: 'f_equipment_code_ref',
__config__: {
jnpfKey: 'relationForm',
modelId: 'eq-id',
// 缺 propsValue, relationField
},
},
[
{ field: 'f_equipment_code', jnpfKey: 'input' },
{ field: 'f_equipment_name', jnpfKey: 'input' },
],
'tdd8equipment',
)
expect(r.completed).toHaveLength(2)
expect(r.completed[0]).toBe('propsValue=f_equipment_name')
expect(r.completed[1]).toBe('relationField=f_equipment_code_ref')
expect(r.after.propsValue).toBe('f_equipment_name')
expect(r.after.relationField).toBe('f_equipment_code_ref')
expect(r.skipped).toEqual([])
})
it('缺 modelId → skipped 含 modelId 提示', () => {
const r = deriveCompletion(
{
__vModel__: 'f_x',
__config__: {
jnpfKey: 'relationForm',
// 缺 modelId
},
},
[{ field: 'f_x_name', jnpfKey: 'input' }],
'',
)
expect(r.skipped).toContain('modelId (无 target 信息, 需手工补)')
})
it('target 无 display 字段 → propsValue skipped', () => {
const r = deriveCompletion(
{
__vModel__: 'f_x',
__config__: {
jnpfKey: 'relationForm',
modelId: '123',
},
},
[{ field: 'f_id', jnpfKey: 'inputNumber' }], // 只有系统字段
'tx',
)
expect(r.skipped).toContain('propsValue (target 无 display 字段候选)')
})
it('不修改已有值 (propsValue 已设就不覆盖)', () => {
const r = deriveCompletion(
{
__vModel__: 'f_x',
__config__: {
jnpfKey: 'relationForm',
modelId: '123',
propsValue: 'f_manual_display', // 手工设置, 不覆盖
},
},
[{ field: 'f_x_name', jnpfKey: 'input' }],
'tx',
)
expect(r.after.propsValue).toBe('f_manual_display')
expect(r.completed).not.toContain('propsValue=f_x_name')
})
})