fix(BS-drift-1): columnList 命名规范适配 baseline (--column-naming)
漂移问题:
baseline columnList prop 命名 3 种规范并存 (60 form 分布):
F_prefix 2/60 (F_SortCode, F_Depname — 老 jnpf 2.x)
auto 34/60 (comInputField101, billRuleField119 — JNPF 设计器默认)
snake 6/60 (f_order_code, f_real_name — 带 f_ 前缀)
dacli --ai 默认输出 snake_case 语义名 → 0% 重叠 (严重漂移)
解决方案:
- 新增 src/commands/form/_naming_convention.ts
* detectNamingConvention(form) → 'auto' | 'snake' | 'f_prefix'
* applyNamingConvention(formData, columnData, conv) → 重命名 __vModel__ + columnList prop
- dacli form create 新增 --column-naming <style> 选项
- 检测 baseline 风格, 传 --column-naming 让 dacli 适配
实测 (rerun 5 form):
testreceivable F_prefix → dacli 输出 F_<UpperCamel> ✓
testcustomer F_prefix → dacli 输出 F_<UpperCamel> ✓
baomingguanli auto → dacli 输出 comInputField<N>, dateField<N> ✓
yaofangguanli auto → dacli 输出 comInputField<N> ✓
hesuanjiancedengji auto → dacli 输出 comInputField<N> ✓
vitest 21/21 PASS (BS-drift-1 解决后 convention pattern 100% 匹配)
剩余漂移: 具体词 (F_SortCode vs F_SerialNo), 编号 (comInputField115 vs comInputField1)
都是 AI 生成或新编号, 不可比. 但 pattern 一致.
注: CI 关卡 G kb FAIL 是已知预存问题
This commit is contained in:
1 parent
e0a130c69f
commit
a2a0efaced
3 files changed
+257
-29
No files matched your search
@@ -0,0 +1,179 @@
|
||||
/**
|
||||
* _naming_convention.ts — columnList / __vModel__ 命名规范适配 (BS-drift-1 解决)
|
||||
*
|
||||
* 问题: baseline columnList 命名 3 种风格并存, dacli --ai 始终输出 snake_case 语义名,
|
||||
* 导致 0% 重叠 (严重漂移).
|
||||
* - F_prefix (2/60): F_SortCode, F_Depname, F_Username
|
||||
* - auto (34/60): comInputField101, billRuleField119 (JNPF 设计器默认)
|
||||
* - snake (6/60): f_order_code, f_real_name (注意 baseline snake 都带 f_ 前缀)
|
||||
*
|
||||
* 解决: 检测 baseline 风格, 在 dacli form create 后重命名 columnList.prop + formData.__vModel__,
|
||||
* 让重建 form 的命名规范跟 baseline 匹配.
|
||||
*
|
||||
* @author claude (2026-07-12)
|
||||
*/
|
||||
|
||||
export type NamingConvention = 'auto' | 'snake' | 'f_prefix'
|
||||
|
||||
/**
|
||||
* 检测 baseline form 使用的命名风格
|
||||
*
|
||||
* 优先级: F_prefix > auto > snake > auto (fallback)
|
||||
* - baseline 没有 columnList → 'auto' (JNPF 默认)
|
||||
*
|
||||
* @param baselineForm JNPF form schema (含 f_column_data)
|
||||
* @returns NamingConvention
|
||||
*/
|
||||
export function detectNamingConvention(baselineForm: any): NamingConvention {
|
||||
const cd = parseJsonSafe(baselineForm?.f_column_data)
|
||||
const cols = cd?.columnList || []
|
||||
if (!cols.length) return 'auto'
|
||||
|
||||
const props = cols.map((c: any) => c.prop).filter(Boolean)
|
||||
const fCount = props.filter((p: string) => p.startsWith('F_')).length
|
||||
const autoCount = props.filter((p: string) =>
|
||||
/^(comInput|comSelect|input|select|date|number|switch|radio|checkbox|table|cascader|upload|tree|area|popup|signature|rate|slider|color|organize|user|users|dep|post|area|group|relation|popupTable|popupSelect|billRule|component)Field\d+$/.test(p)
|
||||
).length
|
||||
|
||||
if (fCount > 0) return 'f_prefix'
|
||||
if (autoCount > 0) return 'auto'
|
||||
// baseline snake 都带 f_ 前缀 (e.g. f_real_name)
|
||||
return 'snake'
|
||||
}
|
||||
|
||||
/**
|
||||
* 应用命名规范: 重命名 formData.fields[].__vModel__ + columnData.columnList[].prop
|
||||
*
|
||||
* 转换规则:
|
||||
* - 'f_prefix': serial_num → F_SerialNum (UpperCamelCase + F_ 前缀)
|
||||
* - 'auto': serial_num → comInputField1, comSelectField2... (按 jnpfKey 选类型前缀)
|
||||
* - 'snake': serial_num → f_serial_num (加 f_ 前缀)
|
||||
*
|
||||
* @param formData formData 对象 (会被 mutate)
|
||||
* @param columnData columnData 对象 (会被 mutate)
|
||||
* @param convention 目标命名规范
|
||||
* @param startIndex auto 模式起始编号 (默认 1, 跟 JNPF 设计器对齐)
|
||||
* @returns 重命名统计 { renamed, skipped }
|
||||
*/
|
||||
export function applyNamingConvention(
|
||||
formData: any,
|
||||
columnData: any,
|
||||
convention: NamingConvention,
|
||||
startIndex: number = 1,
|
||||
): { renamed: number; skipped: number } {
|
||||
const fields = formData?.fields || []
|
||||
const cols = columnData?.columnList || []
|
||||
const searchList = columnData?.searchList || []
|
||||
|
||||
let renamed = 0
|
||||
let skipped = 0
|
||||
let autoCounter = startIndex
|
||||
|
||||
// 1) 收集 __vModel__ → 新名字 映射
|
||||
const renames: Record<string, string> = {}
|
||||
for (const f of fields) {
|
||||
if (!f?.__vModel__) continue
|
||||
const oldName = f.__vModel__
|
||||
if (oldName.startsWith('F_') && convention === 'f_prefix') {
|
||||
skipped++; continue // 已经是 F_ 开头, 跳过
|
||||
}
|
||||
if (convention === 'auto' && /^Field\d+$/.test(oldName)) {
|
||||
skipped++; continue // 已经是 auto 风格, 跳过
|
||||
}
|
||||
if (convention === 'snake' && oldName.startsWith('f_')) {
|
||||
skipped++; continue // 已经有 f_ 前缀, 跳过
|
||||
}
|
||||
const newName = convertName(oldName, f.__config__?.jnpfKey, convention, autoCounter)
|
||||
if (convention === 'auto') autoCounter++
|
||||
renames[oldName] = newName
|
||||
}
|
||||
|
||||
// 2) 应用到 formData.fields[].__vModel__
|
||||
for (const f of fields) {
|
||||
if (f.__vModel__ && renames[f.__vModel__]) {
|
||||
f.__vModel__ = renames[f.__vModel__]
|
||||
renamed++
|
||||
}
|
||||
}
|
||||
|
||||
// 3) 应用到 columnData.columnList[].prop + searchList[].__vModel__
|
||||
for (const c of cols) {
|
||||
if (c.prop && renames[c.prop]) {
|
||||
c.prop = renames[c.prop]
|
||||
}
|
||||
}
|
||||
for (const s of searchList) {
|
||||
if (s.__vModel__ && renames[s.__vModel__]) {
|
||||
s.__vModel__ = renames[s.__vModel__]
|
||||
}
|
||||
}
|
||||
|
||||
return { renamed, skipped }
|
||||
}
|
||||
|
||||
/**
|
||||
* 单字段命名转换
|
||||
*/
|
||||
function convertName(
|
||||
oldName: string,
|
||||
jnpfKey: string,
|
||||
convention: NamingConvention,
|
||||
autoIndex: number,
|
||||
): string {
|
||||
if (convention === 'f_prefix') {
|
||||
// serial_num → F_SerialNum
|
||||
const camel = toUpperCamel(oldName)
|
||||
return `F_${camel}`
|
||||
}
|
||||
if (convention === 'snake') {
|
||||
// serial_num → f_serial_num
|
||||
return oldName.startsWith('f_') ? oldName : `f_${oldName}`
|
||||
}
|
||||
// auto: jnpfKey 决定类型前缀
|
||||
return `${getAutoPrefix(jnpfKey)}${autoIndex}`
|
||||
}
|
||||
|
||||
function toUpperCamel(snake: string): string {
|
||||
return snake
|
||||
.split('_')
|
||||
.filter(Boolean)
|
||||
.map(w => w[0].toUpperCase() + w.slice(1).toLowerCase())
|
||||
.join('')
|
||||
}
|
||||
|
||||
function getAutoPrefix(jnpfKey: string): string {
|
||||
const map: Record<string, string> = {
|
||||
input: 'comInputField',
|
||||
textarea: 'comInputField',
|
||||
inputNumber: 'inputNumberField',
|
||||
select: 'comSelectField',
|
||||
radio: 'radioField',
|
||||
checkbox: 'checkboxField',
|
||||
switch: 'switchField',
|
||||
datePicker: 'dateField',
|
||||
timePicker: 'dateField',
|
||||
cascader: 'cascaderField',
|
||||
upload: 'uploadField',
|
||||
uploadFz: 'uploadField',
|
||||
treeSelect: 'treeSelectField',
|
||||
relationForm: 'popupTableField',
|
||||
popupSelect: 'popupSelectField',
|
||||
popupTable: 'popupTableField',
|
||||
organizeSelect: 'organizeField',
|
||||
userSelect: 'userField',
|
||||
depSelect: 'depField',
|
||||
postSelect: 'postField',
|
||||
rate: 'rateField',
|
||||
slider: 'sliderField',
|
||||
colorPicker: 'colorField',
|
||||
signature: 'signatureField',
|
||||
}
|
||||
return map[jnpfKey] || 'componentField'
|
||||
}
|
||||
|
||||
function parseJsonSafe(s: any): any {
|
||||
if (typeof s === 'string') {
|
||||
try { return JSON.parse(s) } catch { return null }
|
||||
}
|
||||
return s
|
||||
}
|
||||
@@ -27,6 +27,7 @@ import { validateFormCreate } from './_validate.ts'
|
||||
import { enhanceFromBackend, formatErrorLine } from '../_error_codes.ts'
|
||||
import { loadAppContext } from '../app/context.ts'
|
||||
import { loadToken } from '../../core/config.ts'
|
||||
import { applyNamingConvention, type NamingConvention } from './_naming_convention.ts'
|
||||
|
||||
interface CreateOpts {
|
||||
fullName?: string
|
||||
@@ -221,6 +222,12 @@ export function buildFormCreateCommand(): Command {
|
||||
.option('--verify-timeout <ms>', '浏览器验证超时 (默认 60s)', '60000')
|
||||
.option('--via <path>', '创建路径: api (默认, 走 POST /visualdev/Base) | ui (走 playwright 模拟人类操作, API 失败时兜底)', 'api')
|
||||
.option('--json', '原始 JSON 输出', false)
|
||||
// BS-drift-1 (2026-07-12): columnList / __vModel__ 命名规范适配
|
||||
// auto = comInputField101, comSelectField102... (JNPF 设计器默认, baseline 34/60)
|
||||
// snake = f_serial_num (带 f_ 前缀, baseline 6/60)
|
||||
// f_prefix = F_SerialNum (UpperCamel + F_, baseline 2/60, 老 jnpf 2.x)
|
||||
// 不传 = 默认 snake_case 语义名 (dacli --ai 旧行为, baseline 0/60)
|
||||
.option('--column-naming <style>', 'columnList 命名规范: auto | snake | f_prefix (默认 snake 语义)')
|
||||
.action(async (opts: CreateOpts) => {
|
||||
// 5.10.2: --ai-field 只问 AI, 不建表单
|
||||
if (opts.aiField) {
|
||||
@@ -991,6 +998,13 @@ export function buildFormCreateCommand(): Command {
|
||||
const skipped = aiComps ? userFormFields.length - listFields.length : 0
|
||||
log.info(`B-15 修复: --${opts.ai ? 'ai' : 'table'} 路径自动生成 columnList: ${entries.length} 列表字段 + ${columnDataObj.searchList.length} 搜索字段`
|
||||
+ (skipped ? ` (${skipped} 跳过: 只适合表单不适合列表)` : ''))
|
||||
|
||||
// BS-drift-1 (2026-07-12): 列命名规范适配 (跟 baseline 匹配)
|
||||
if (opts.columnNaming && ['auto', 'snake', 'f_prefix'].includes(opts.columnNaming)) {
|
||||
const conv = opts.columnNaming as NamingConvention
|
||||
const r = applyNamingConvention(formData, columnDataObj, conv)
|
||||
log.info(`BS-drift-1 修复: --column-naming=${conv}, 重命名 ${r.renamed} 个 __vModel__/prop (${r.skipped} 已合规跳过)`)
|
||||
}
|
||||
} else {
|
||||
log.warn(`B-15: --ai 路径 formData.fields 为空, ★ 走 Web 设计器勾选`)
|
||||
}
|
||||
|
||||
Reference in new issue
Block a user