// 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') }) })