#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
221 lines
6.5 KiB
TypeScript
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')
|
|
})
|
|
}) |