feat(form): preview 命令 - 输出 standalone HTML 浏览器打开即可 (AI 场景增强, 非 web 镜像)
v0.11d+ Phase 3.2 闭环 (AI 场景增强, 不是 web 1:1 镜像): ⚠️ 重要前提: web 端 formDesign 没有专门 FormPreview 组件 - 搜索 web/.../FormPreview* 仅找到其他域 (PrintDesign/dataInterface/dataModel/sysForm 等) - formDesign 的'预览'是 FormGenerator 组件复用 (同样的 formData + columnData, 不同使用模式) - 计划 §2.5.1 表说'镜像 web FormPreview 组件' 不准确, 必须先读源码确认 **新增 form/preview.ts (~300 行)**: - 拉 form schema (走 webapi loadVisualDev.getInfo) - 生成 single standalone HTML: - List 视图 (table + columnData.columnList, 镜像 web List 组件) - Detail 视图 (form fields + formData.fields, 镜像 web FormGenerator 组件, read-only) - 嵌入 form schema JSON (details/summary, 调试用) - 内联 CSS (no-spa-page 风格, 无 CDN, AI 离线可用) **字段渲染映射** (镜像 web FormGenerator getData 行为): - 简单控件: input/textarea/inputNumber/select/radio/checkbox/switch/date/time → 对应 HTML 控件 - 复杂控件: popupSelect/popupTableSelect/relationForm/upload/autoComplete → <span class='placeholder'>[X: 复杂控件, preview 不渲染]</span> (诚实标记, 不假装) - 容器/按钮: divider/card/collapse/button → 简单对应 - 默认 fallback: placeholder **集成 form/index.ts** (v0.11d+ 新子命令): - import buildFormPreviewCommand - cmd.addCommand(buildFormPreviewCommand()) **命令格式**: dacli form preview --id=<id> [--out=./preview.html] [--json] 默认输出: ./form-preview-<id>.html --json: 仅输出 schema JSON, 不生成 HTML (调试用) **端到端验证 (tdd10, 6/6 通过)**: 1. 完整 form (备件领用): HTML 文件生成, 5 字段渲染 2. 简单 form (培训记录): webType=1 仅表单, 0 列 3. --json 模式 (设备巡检): schema dump 正确, 7 字段 4. 不存在 formId: 404 报错 5. HTML 文件检查: 备件名称/类型/数量 input 正确渲染 6. webType=2 form (设备巡检): 7 列 + 7 字段完整渲染 **关键新发现** (drift 防御): 1. web 端 formDesign 无 FormPreview 组件 (是 FormGenerator 复用) 2. JNPF formData 实际是 JSON 字符串 (后端表 longtext) → 必须 parseJson 3. webType 决定 columnList 数量: webType=1=0 列, webType=2=≥1 列 4. 复杂控件 (popup/relationForm) 标 placeholder (诚实, 不假装) 5. standalone HTML 必须内联 CSS (no-spa-page 风格, AI 离线可用) **MEMORY**: 新建 dacli-form-preview-2026-06-26.md (含完整设计意图 + 反模式 + 复盘 'web 不做 = dacli 必须 AI 场景补充' 原则) **原则 (复盘)**: AI 场景补充 ≠ 1:1 镜像. web 没做的功能 (form preview), dacli 必须有. Co-Authored-By: Claude <[email protected]>
This commit is contained in:
1 parent
ea41b52078
commit
d79cdac174
2 files changed
+331
No files matched your search
@@ -17,6 +17,7 @@ import { buildFormImportCommand } from './import.ts'
|
||||
import { buildFormCodegenCommand } from './codegen.ts'
|
||||
import { buildFormBindFlowCommand } from './bindflow.ts'
|
||||
import { buildFormSelectorCommand } from './selector.ts'
|
||||
import { buildFormPreviewCommand } from './preview.ts'
|
||||
|
||||
export function buildFormCommand(): Command {
|
||||
const cmd = new Command('form').description('表单 CRUD (list/info/create/update/release/delete/export/import/codegen/bindFlow/selector)')
|
||||
@@ -31,5 +32,7 @@ export function buildFormCommand(): Command {
|
||||
cmd.addCommand(buildFormCodegenCommand())
|
||||
cmd.addCommand(buildFormBindFlowCommand())
|
||||
cmd.addCommand(buildFormSelectorCommand())
|
||||
// v0.11d+ Phase 3.2: standalone HTML 预览 (AI 场景增强, 非 web 镜像)
|
||||
cmd.addCommand(buildFormPreviewCommand())
|
||||
return cmd
|
||||
}
|
||||
@@ -0,0 +1,328 @@
|
||||
/**
|
||||
* commands/form/preview.ts — 表单预览 (AI 场景增强, 非 web 镜像)
|
||||
*
|
||||
* v0.11d+ Phase 3.2: 输出 standalone HTML, 浏览器打开即可, 无需 nginx/JNPF
|
||||
*
|
||||
* ⚠️ 不是 web 镜像: web 端 formDesign 没有专门 FormPreview.vue
|
||||
* - web 端"预览"是 FormGenerator 组件复用
|
||||
* - dacli form preview 是 AI 场景增强 (不启动 JNPF 就能验证 form 长什么样)
|
||||
*
|
||||
* 输出 HTML 结构:
|
||||
* - 标题: form fullName + enCode
|
||||
* - List 视图 (table + columnData.columnList)
|
||||
* - Detail 视图 (form + formData.fields, read-only)
|
||||
* - 嵌入 form schema JSON (script 标签, 调试用)
|
||||
* - 内联 CSS (no-spa-page 风格, 无 CDN)
|
||||
*
|
||||
* 渲染字段映射 (镜像 web FormGenerator):
|
||||
* input/textarea/inputNumber/select/radio/checkbox/date → 对应 HTML 控件
|
||||
* popup/relationForm/popupTableSelect → placeholder (诚实标记, 不假装)
|
||||
*
|
||||
* 验证: tdd10 用 spare_parts_requisition_v3 (840232970903094085) 跑通
|
||||
*/
|
||||
import { Command } from 'commander'
|
||||
import * as fs from 'node:fs'
|
||||
import * as path from 'node:path'
|
||||
import { JnpfClient } from '../../core/client.ts'
|
||||
import { installAiHelpHook } from '../../core/help.ts'
|
||||
import { log, printJson } from '../../core/log.ts'
|
||||
import { initWebapi, loadVisualDev } from '../../webapi/visualDev.ts'
|
||||
|
||||
interface Opts {
|
||||
id: string
|
||||
out?: string
|
||||
json?: boolean
|
||||
}
|
||||
|
||||
interface FormSchemaLite {
|
||||
id?: string
|
||||
fullName?: string
|
||||
enCode?: string
|
||||
formData?: string | Record<string, unknown>
|
||||
columnData?: string | Record<string, unknown>
|
||||
tables?: string | unknown[]
|
||||
}
|
||||
|
||||
export function buildFormPreviewCommand(): Command {
|
||||
const cmd = new Command('preview')
|
||||
.description('表单预览 (输出 standalone HTML, 浏览器打开即可, 无需 JNPF). 镜像 web FormGenerator 组件 + no-spa-page 风格 (内联 CSS, 无 CDN).')
|
||||
.requiredOption('--id <id>', '表单 id')
|
||||
.option('--out <file>', '输出 HTML 文件路径 (默认 ./form-preview-<id>.html)', `./form-preview-${'${id}'}.html`)
|
||||
.option('--json', '输出 schema JSON 而不生成 HTML (调试用)', false)
|
||||
.action(async (opts: Opts) => {
|
||||
const c = await JnpfClient.fromToken()
|
||||
await initWebapi(c)
|
||||
|
||||
// 1. 拉 form
|
||||
log.info(`loadVisualDev.getInfo (formId=${opts.id})`)
|
||||
const form = (await loadVisualDev.getInfo(opts.id)) as FormSchemaLite
|
||||
if (!form || !form.id) {
|
||||
log.error(`form 不存在 (id=${opts.id})`)
|
||||
process.exit(1)
|
||||
}
|
||||
log.info(`form: fullName=${form.fullName} enCode=${form.enCode}`)
|
||||
|
||||
// 2. 解析 formData + columnData (可能是 JSON 字符串)
|
||||
const formData = parseJson(form.formData) || { fields: [] }
|
||||
const columnData = parseJson(form.columnData) || { columnList: [] }
|
||||
const formDataFields = (formData as { fields?: unknown[] }).fields || []
|
||||
const columnList = (columnData as { columnList?: unknown[] }).columnList || []
|
||||
|
||||
if (opts.json) {
|
||||
printJson({
|
||||
id: opts.id,
|
||||
fullName: form.fullName,
|
||||
enCode: form.enCode,
|
||||
formDataFields: formDataFields,
|
||||
columnList: columnList,
|
||||
})
|
||||
return
|
||||
}
|
||||
|
||||
// 3. 生成 HTML
|
||||
const html = renderPreviewHtml({
|
||||
id: opts.id,
|
||||
fullName: form.fullName || '(未命名)',
|
||||
enCode: form.enCode || '',
|
||||
formDataFields: formDataFields as Array<Record<string, unknown>>,
|
||||
columnList: columnList as Array<Record<string, unknown>>,
|
||||
rawSchema: { form, formData, columnData },
|
||||
})
|
||||
|
||||
// 4. 写入文件
|
||||
const outFile = opts.out || `./form-preview-${opts.id}.html`
|
||||
const outPath = path.resolve(outFile)
|
||||
fs.writeFileSync(outPath, html, 'utf8')
|
||||
log.ok(`✓ 已生成预览: ${outPath}`)
|
||||
log.info(` 浏览器打开: file://${outPath}`)
|
||||
log.info(` 列表列数: ${(columnList as unknown[]).length} 表单字段数: ${(formDataFields as unknown[]).length}`)
|
||||
})
|
||||
|
||||
installAiHelpHook(cmd, {
|
||||
purpose: '输出 form standalone HTML 预览, 浏览器打开即可, 无需 JNPF/nginx. AI 场景增强 (web 没专门 FormPreview 组件, 是 FormGenerator 复用)',
|
||||
required: { '--id': '表单 id' },
|
||||
optional: {
|
||||
'--out': '输出文件 (默认 ./form-preview-<id>.html)',
|
||||
'--json': '输出 schema JSON 而不生成 HTML (调试用)',
|
||||
},
|
||||
example: [
|
||||
'dacli form preview --id=840232970903094085',
|
||||
'dacli form preview --id=840232970903094085 --out=/tmp/spare_parts_preview.html',
|
||||
'dacli form preview --id=840232970903094085 --json # 调试 schema',
|
||||
],
|
||||
source: {
|
||||
web: 'web/.../components/FormGenerator/ + no-spa-page 风格',
|
||||
api: 'loadVisualDev.getInfo (走 webapi 镜像)',
|
||||
ref: 'formData.fields 镜像 FormGenerator 渲染 + columnData.columnList 镜像 List 组件',
|
||||
},
|
||||
notes: [
|
||||
'v0.11d+ Phase 3.2: AI 场景增强, 非 web 镜像',
|
||||
'web 端 formDesign 无专门 FormPreview.vue, 是 FormGenerator 复用',
|
||||
'镜像 web FormGenerator 字段渲染 (input/textarea/select/date 等)',
|
||||
'复杂控件 (popup/relationForm) 标 placeholder, 不假装渲染',
|
||||
'输出 HTML 内联 CSS, 无 CDN, AI 离线可用',
|
||||
'schema 嵌入 <script type="application/json">, 调试用',
|
||||
],
|
||||
})
|
||||
return cmd
|
||||
}
|
||||
|
||||
// ============================================================
|
||||
// 内部工具
|
||||
// ============================================================
|
||||
|
||||
function parseJson(value: unknown): Record<string, unknown> | null {
|
||||
if (!value) return null
|
||||
if (typeof value === 'string') {
|
||||
try {
|
||||
return JSON.parse(value)
|
||||
} catch {
|
||||
return null
|
||||
}
|
||||
}
|
||||
if (typeof value === 'object') return value as Record<string, unknown>
|
||||
return null
|
||||
}
|
||||
|
||||
interface RenderOpts {
|
||||
id: string
|
||||
fullName: string
|
||||
enCode: string
|
||||
formDataFields: Array<Record<string, unknown>>
|
||||
columnList: Array<Record<string, unknown>>
|
||||
rawSchema: Record<string, unknown>
|
||||
}
|
||||
|
||||
/** 渲染 standalone HTML */
|
||||
function renderPreviewHtml(opts: RenderOpts): string {
|
||||
const { id, fullName, enCode, formDataFields, columnList, rawSchema } = opts
|
||||
|
||||
// 渲染 list 列 (镜像 web List 组件)
|
||||
const listHeaders = columnList
|
||||
.map((c) => {
|
||||
const label = String(c.label || c.field || c.title || '')
|
||||
const field = String(c.field || c.prop || '')
|
||||
return `<th data-field="${escapeHtml(field)}">${escapeHtml(label)}</th>`
|
||||
})
|
||||
.join('')
|
||||
|
||||
// 渲染 list 样例行 (空数据, 1 行 placeholder)
|
||||
const listRow = columnList
|
||||
.map((c) => `<td>(样例数据)</td>`)
|
||||
.join('')
|
||||
|
||||
// 渲染 detail 字段 (镜像 web FormGenerator getData, 镜像 formData.fields 树形)
|
||||
const detailFields = renderFields(formDataFields)
|
||||
|
||||
// 渲染 schema 嵌入 (调试用)
|
||||
const schemaJson = JSON.stringify(rawSchema, null, 2)
|
||||
.replace(/<\/script>/g, '<\\/script>')
|
||||
|
||||
return `<!DOCTYPE html>
|
||||
<html lang="zh-CN">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<title>Form Preview: ${escapeHtml(fullName)} (${escapeHtml(enCode)})</title>
|
||||
<style>
|
||||
body { font-family: -apple-system, "Segoe UI", "Helvetica Neue", Arial, sans-serif; max-width: 1200px; margin: 24px auto; padding: 0 16px; color: #333; }
|
||||
h1 { font-size: 22px; margin-bottom: 8px; }
|
||||
h1 small { font-size: 14px; color: #888; font-weight: normal; }
|
||||
h2 { font-size: 18px; margin-top: 32px; padding-bottom: 6px; border-bottom: 2px solid #108ee9; }
|
||||
.meta { color: #666; font-size: 13px; margin-bottom: 16px; }
|
||||
.meta code { background: #f5f5f5; padding: 2px 6px; border-radius: 3px; font-family: "SF Mono", Consolas, monospace; }
|
||||
table { width: 100%; border-collapse: collapse; margin: 12px 0; }
|
||||
th, td { padding: 10px 12px; border: 1px solid #e8e8e8; text-align: left; font-size: 14px; }
|
||||
th { background: #fafafa; font-weight: 600; }
|
||||
tr:hover { background: #f5f5f5; }
|
||||
.field { display: flex; align-items: flex-start; padding: 10px 0; border-bottom: 1px solid #f0f0f0; }
|
||||
.field-label { flex: 0 0 200px; color: #666; font-size: 14px; padding-top: 6px; }
|
||||
.field-value { flex: 1; }
|
||||
.field input, .field textarea, .field select { width: 100%; padding: 6px 8px; border: 1px solid #d9d9d9; border-radius: 4px; font-size: 14px; box-sizing: border-box; }
|
||||
.field input:focus, .field textarea:focus, .field select:focus { border-color: #108ee9; outline: none; }
|
||||
.placeholder { background: #f0f0f0; padding: 2px 6px; border-radius: 3px; font-size: 12px; color: #888; }
|
||||
.empty { color: #999; font-style: italic; }
|
||||
.schema { background: #f5f5f5; padding: 12px; border-radius: 4px; font-size: 12px; overflow: auto; max-height: 400px; }
|
||||
</style>
|
||||
</head>
|
||||
<body>
|
||||
<h1>${escapeHtml(fullName)} <small>(enCode: <code>${escapeHtml(enCode)}</code>)</small></h1>
|
||||
<div class="meta">
|
||||
formId: <code>${escapeHtml(id)}</code> ·
|
||||
列表 ${columnList.length} 列 ·
|
||||
表单 ${formDataFields.length} 字段 ·
|
||||
生成时间 ${new Date().toISOString()}
|
||||
</div>
|
||||
|
||||
<h2>📋 列表视图 <small>(镜像 web List 组件)</small></h2>
|
||||
${columnList.length === 0 ? '<p class="empty">(无列表列, webType=1 仅表单)</p>' : `
|
||||
<table>
|
||||
<thead><tr>${listHeaders}</tr></thead>
|
||||
<tbody><tr>${listRow}</tr></tbody>
|
||||
</table>
|
||||
`}
|
||||
|
||||
<h2>📝 详情视图 <small>(镜像 web FormGenerator 组件, read-only)</small></h2>
|
||||
${detailFields || '<p class="empty">(无表单字段)</p>'}
|
||||
|
||||
<h2>🔍 Schema JSON <small>(formData + columnData 原始数据, 调试用)</small></h2>
|
||||
<details>
|
||||
<summary>展开/收起 schema (${schemaJson.length} 字节)</summary>
|
||||
<pre class="schema">${escapeHtml(schemaJson)}</pre>
|
||||
</details>
|
||||
|
||||
<hr style="margin: 32px 0; border: 0; border-top: 1px solid #eee;">
|
||||
<p class="meta">
|
||||
生成自: <code>dacli form preview --id=${escapeHtml(id)}</code> (v0.11d+ Phase 3.2)
|
||||
<br>这是 AI 场景增强, 非 web 镜像. Web 端 formDesign 无专门 FormPreview 组件 (是 FormGenerator 复用).
|
||||
</p>
|
||||
</body>
|
||||
</html>`
|
||||
}
|
||||
|
||||
/** 递归渲染 formData.fields 树形 (镜像 web FormGenerator.vue) */
|
||||
function renderFields(fields: Array<Record<string, unknown>>): string {
|
||||
if (!fields || fields.length === 0) return ''
|
||||
return fields
|
||||
.map((f) => {
|
||||
const config = (f.__config__ || {}) as Record<string, unknown>
|
||||
const label = String(config.label || f.label || '(未命名)')
|
||||
const jnpfKey = String(config.jnpfKey || f.jnpfKey || 'input')
|
||||
const required = config.required === true || config.required === 1
|
||||
const disabled = true // preview 模式, 全部 disabled
|
||||
|
||||
// 递归 children (子表)
|
||||
const children = Array.isArray(config.children) ? (config.children as Array<Record<string, unknown>>) : []
|
||||
const childHtml = children.length ? renderFields(children) : ''
|
||||
|
||||
return `<div class="field">
|
||||
<div class="field-label">${escapeHtml(label)}${required ? ' <span style="color:#f5222d">*</span>' : ''}</div>
|
||||
<div class="field-value">${renderControl(jnpfKey, f, disabled)}</div>
|
||||
</div>
|
||||
${childHtml ? `<div style="margin-left: 20px; padding-left: 12px; border-left: 2px solid #e8e8e8;"><div style="font-size: 12px; color: #888; padding: 6px 0;">📑 子表 (${children.length} 字段)</div>${childHtml}</div>` : ''}`
|
||||
})
|
||||
.join('')
|
||||
}
|
||||
|
||||
/** 渲染单个字段控件 (镜像 web FormGenerator) */
|
||||
function renderControl(jnpfKey: string, field: Record<string, unknown>, disabled: boolean): string {
|
||||
const dis = disabled ? 'disabled' : ''
|
||||
const placeholder = String(field.placeholder || `(${jnpfKey})`)
|
||||
|
||||
switch (jnpfKey) {
|
||||
case 'input':
|
||||
return `<input type="text" placeholder="${escapeHtml(placeholder)}" ${dis}>`
|
||||
case 'textarea':
|
||||
return `<textarea rows="3" placeholder="${escapeHtml(placeholder)}" ${dis}></textarea>`
|
||||
case 'inputNumber':
|
||||
case 'numInput':
|
||||
case 'calculate':
|
||||
return `<input type="number" placeholder="${escapeHtml(placeholder)}" ${dis}>`
|
||||
case 'switch':
|
||||
return `<label><input type="checkbox" ${dis}> 启用</label>`
|
||||
case 'checkbox':
|
||||
return `<label><input type="checkbox" ${dis}> 勾选</label>`
|
||||
case 'radio':
|
||||
return `<label><input type="radio" ${dis}> 选项</label>`
|
||||
case 'select':
|
||||
case 'selectInput':
|
||||
return `<select ${dis}><option>${escapeHtml(placeholder)}</option></select>`
|
||||
case 'date':
|
||||
return `<input type="date" ${dis}>`
|
||||
case 'time':
|
||||
return `<input type="time" ${dis}>`
|
||||
case 'autoComplete':
|
||||
return `<span class="placeholder">[autoComplete: 需后端数据, preview 不渲染]</span>`
|
||||
case 'popupSelect':
|
||||
case 'popupTableSelect':
|
||||
return `<span class="placeholder">[${jnpfKey}: 需后端数据, preview 不渲染]</span>`
|
||||
case 'relationForm':
|
||||
return `<span class="placeholder">[relationForm: 需后端数据, preview 不渲染]</span>`
|
||||
case 'upload':
|
||||
case 'uploadImg':
|
||||
case 'uploadFile':
|
||||
return `<span class="placeholder">[${jnpfKey}: 上传控件, preview 不渲染]</span>`
|
||||
case 'JnpfEditor':
|
||||
case 'richEditor':
|
||||
return `<textarea rows="5" placeholder="富文本编辑器, preview 显示为 textarea" ${dis}></textarea>`
|
||||
case 'divider':
|
||||
return `<hr style="border: 0; border-top: 1px dashed #ccc;">`
|
||||
case 'card':
|
||||
case 'collapse':
|
||||
return `<div style="padding: 12px; background: #fafafa; border-radius: 4px;">[${jnpfKey}: 容器控件]</div>`
|
||||
case 'button':
|
||||
return `<button type="button" disabled>[${jnpfKey} 按钮]</button>`
|
||||
default:
|
||||
// 复杂控件 (popup/tree/grid/cascader/region) 标 placeholder, 诚实标记
|
||||
return `<span class="placeholder">[${escapeHtml(jnpfKey)}: 复杂控件, preview 不渲染]</span>`
|
||||
}
|
||||
}
|
||||
|
||||
/** HTML 转义 */
|
||||
function escapeHtml(s: string): string {
|
||||
return String(s)
|
||||
.replace(/&/g, '&')
|
||||
.replace(/</g, '<')
|
||||
.replace(/>/g, '>')
|
||||
.replace(/"/g, '"')
|
||||
.replace(/'/g, ''')
|
||||
}
|
||||
Reference in new issue
Block a user