Files
dacli/src/commands/form/preview.ts
T
ssw df213fdfad fix(dacli-docs): 修审计报告 14 项 + 加 CI 校验防再漂 (P0/P1/P2 全清)
审计报告 docs/dacli-doc-audit-report.md 14 项全部采纳:

P0 (3 项事实错误, 直接误导 AI 执行):
- ANTI_PATTERN F_→f_ 前缀 (form update --fields 实际是小写)
- ANTI_PATTERN AP-fc-4 vs AP-fu-1 矛盾 (统一指向 form import --autoTable)
- ANTI_PATTERN form info <enCode> 误导 (改为 <id>, 加 enCode 自动解析 fallback)

P1 (3 项文档漂移):
- CLAUDE.md "含 FK 时必用 --fields" → 实际已废弃, 删除 + form/create.ts Commander 加 DEPRECATED
- doc/get.ts 引用 Java DocCommand.java → 改指 TS _parser.ts
- AP-fd-1 "--cascade 必带" 过度约束 → 改为可选

P2 (2 项衔接断裂):
- Source 路径 web/.../ → web/apps/jnpf-web-apps-main/src/ (73 文件)
- test/run TC-B 前置提示 (需 menu 挂载)

附加 (CI script 抓出的 8 条额外路径 drift, 已就近修正):
- di/create|export|copy: DataInterfaceController.java 路径补 jnpf-java-boot/ + jnpf/base/controller/
- print/delete|update: PrintDevController.java 同上
- org/create: OrganizeController.java 路径 jnpf/controller/ → jnpf/permission/controller/
- form/codegen|audit: FormGenerator/FormGenerator.vue 加 /components/ + /src/ 前缀
- workflow/create: flowEngine + FlowProcess 加 views/onlineDev/ + components/ 前缀
- workflow/syncForm: FlowableProcessDesigner.vue 不存在 → 改指 Form.vue
- msg/notice*: notice.ts 不存在 → 改指 msgMonitor.ts
- bigscreen/delete|update: 双前缀 web/.../src/jnpf-web-datascreen-vue3/ → jnpf/前端/
- app/login: api/auth.ts → api/core/auth.ts
- apis/refresh|status|info: Java ApiService 路径 → TS 化指向
- test/render: sysData/formDesign 加 views/ 前缀
- form/create: formDesign/Form.vue 加 views/onlineDev/ 前缀

Task 1.6 收尾: 删 core/help.ts legacy (~85 行 dead code):
- AI_FLAGS / getMeta / maybeInterceptAiHelp / renderAiHelp
- installAiHelpHook alias / _aiMeta 副作用 / AiHelp type alias

新增 docs/doc-drift-findings-2026-07-24.md (2 条无法自动修复的 docs 路径, 待人工)

新增 scripts/check-doc-drift.ts (scripts/check-doc-drift.ts, 218 行):
- 4 类检查: 命令引用 / arg-opt 一致性 / source 路径 / ANTI_PATTERNS 命令引用
- 接入 npm run doc:check
- 验证: 修复前 21 处 drift → 修复后 2 处 (已归档)

测试: typecheck 0 errors, 387/387 tests pass, doc:check 报告 2 known issues
2026-07-24 16:33:31 +08:00

328 lines
13 KiB
TypeScript

/**
* 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 { installHelpHook } 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}`)
})
installHelpHook(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/apps/jnpf-web-apps-main/src/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, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;')
.replace(/"/g, '&quot;')
.replace(/'/g, '&#39;')
}