Files
dacli/tests/unit/relation_form_complete.test.ts
sushub f403a7e80e import: ssw/dacli@eea0ebc (2026-08-12) 起点版本
本仓 2026-08-12 从 ssw main (192.168.1.18:13300/ssw/ssw-mvp) 的
dacli/ subpath 抽取,作为独立仓托管到 gitea:3000/ssw/dacli.git。

- 工作树为 ssw main dacli subpath 最新版 (110 commit, 08-12)
- 历史未带 ssw main 整体历史(避免大仓污染)
- 此为新仓基线 commit,未来以本仓历史为主
2026-08-12 15:58:06 +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')
})
})