Per audit §7 / H1: ~37 src files hardcoded '/home/ubuntu/ccWorkDir', welding the
whole pipeline to one container (external CI / other machines crash).
- new src/core/paths.ts: getCcWorkDir() (env CCWORKDIR || default) + getWebSrc()
- swept 36 files: '/home/ubuntu/ccWorkDir<sub>' literals → `${getCcWorkDir()}<sub>`
templates; collapsed 3 inline (process.env.CCWORKDIR || '...') dupes to getCcWorkDir()
- covers webapi mirror (_loader WEB_SRC/JNPF_UTILS_UUID + 24 module *_SRC), db/verify
paths, drift/coverage/selfcheck, buildformdata, codegen, render, blindspot boot paths
- playwright .cache path + doc-comment refs left as-is (not ccWorkDir-rooted)
Verified: tsc 0 (validates every inserted import path); runtime menu webapi
initWebapi OK; smoke form list returns real data (WEB_SRC end-to-end via getCcWorkDir);
vitest unit 336 pass.
Co-Authored-By: Claude <[email protected]>
1087 lines
57 KiB
TypeScript
1087 lines
57 KiB
TypeScript
/**
|
|
* commands/form/codegen.ts — 表单代码生成器 (白皮书 5.5)
|
|
* 参考 aibridge CodeGenerator:
|
|
* /home/ubuntu/ccWorkDir/docs/aibridge/code/utils/code_generator.py
|
|
* /home/ubuntu/ccWorkDir/docs/aibridge/docs/code-rule.md
|
|
* 命名规则 (aibridge docs/code-rule.md):
|
|
* moduleArtifactId = {company}-{appCode} 例 ssw-app (Maven 模块名)
|
|
* modulePackage = {company}.{appCode} 例 ssw.app (Java 包名)
|
|
* mainClassName = PascalCase 例 TdsBillingEntity
|
|
* DB table = snake_case 无前缀 例 tds_billing
|
|
* 流程:
|
|
* 1. POST /api/visualdev/Generater/{id}/Actions/CodePreview 拿文件树
|
|
* 2. 遍历 tree, 按 fileName 后缀分类 (vue/ts → frontend, java/xml/json → backend)
|
|
* 3. 写到 --out 目录 (默认 ./generated/{company}-{appCode}/)
|
|
* 4. (--auto-alias 已实现, 写 base_visual_alias 替旧版手改 Ais_xxx 类名)
|
|
* 5. (--auto-menu 已实现, 走 webapi Actions/Module)
|
|
* 注意: 该功能白皮书 5.5 提到, Java 版 dacli 也有, TS 版 没继承。
|
|
* v1 实现是"直写", 不做 aibridge 那种深度类名修复 (那是大工程)。
|
|
* 本次 升级: 新增 --company 参数对齐 aibridge company_code + 命名校验。
|
|
*/
|
|
import { getCcWorkDir } from '../../core/paths.ts'
|
|
import { Command } from 'commander'
|
|
import { writeFileSync, mkdirSync, existsSync, readdirSync } from 'node:fs'
|
|
import { dirname, join } from 'node:path'
|
|
import { JnpfClient } from '../../core/client.ts'
|
|
import { installHelpHook } from '../../core/help.ts'
|
|
import { wrapCommand } from '../_output_filter.ts' // v2.2+ (2026-07-21): wrapCommand 收口 5c (8 process.exit + ensureAlias throw)
|
|
import { remindCodeGenMenuAttachFail, remindCodeGenPomConflict, remindCodeGenMenuMountFail } from '../_post_reminders.ts' // v2.4+ (2026-07-21): 3 codegen 兜底 → L3
|
|
import { log, printJson } from '../../core/log.ts'
|
|
import { initWebapi, loadVisualDev } from '../../webapi/visualDev.ts'
|
|
import { normalizeCodegenSearchList } from './_codegen_schema.ts'
|
|
|
|
interface CodegenOpts {
|
|
/** 企业代码 (aibridge company_code), 默认 ssw */
|
|
company?: string
|
|
/** 应用代码 (aibridge app_code), 默认取 form.enCode */
|
|
module?: string
|
|
/** 模块包名 (aibridge module_package_name), 默认 {company}.{module} */
|
|
modulePackage?: string
|
|
description?: string
|
|
dbLinkId?: string
|
|
mainClassName?: string
|
|
/** 显式传 form enCode 用于 Controller @RequestMapping 路径 (避免从 mainClassName 推导类名) */
|
|
enCode?: string
|
|
enableFlow?: string
|
|
out?: string
|
|
/**
|
|
* JNPF 原生别名系统 (推荐): 通过 POST /Alias/Save 保存表/字段别名,
|
|
* CodePreview 直接用别名生成代码, 无需 post-fix。
|
|
* (a) `--auto-alias`: 从 form.tables + mainClassName 自动推导 (主表别名 = mainClassName)
|
|
* (b) `--alias-file <path>`: 从 JSON 文件读 [{table, aliasName, fields?}, ...]
|
|
* (c) `--alias <json>`: 直接传 JSON 字符串
|
|
* 参考 web/.../formDesign/components/AliasModal.vue + jnpf/.../VisualAliasEntity.java
|
|
*/
|
|
/** --auto-alias (默认 true): 写 base_visual_alias, JNPF 用别名生成 PascalCase 类名
|
|
* --no-alias: 关闭, 走 CodePreview 原始输出 (类名 = 表名 = Jxcj_xxx) */
|
|
autoAlias?: boolean
|
|
aliasFile?: string
|
|
alias?: string
|
|
/**
|
|
* 前端输出控制:
|
|
* - --no-web: 不写 web/* 前端 (默认写)
|
|
* - --no-uniapp: 不写 uniapp/* 前端 (默认写)
|
|
* - --web-base <path>: web 输出基准 (默认 web/apps/jnpf-web-apps-main/src/views/ssw/{appCode})
|
|
* - --uniapp-base <path>: uniapp 输出基准 (默认 uniapp/pages/ssw/{appCode})
|
|
* 行为:
|
|
* - JNPF 输出 'web/Detail.vue' 'web/Form.vue' 'web/index.vue' 'web/api.ts' 等 (web Vue 3)
|
|
* - JNPF 输出 'app/index.vue' 'app/form.vue' 'app/detail.vue' 'app/columnList.js' 等 (uniapp)
|
|
* - dacli 把 web/* 写到 {webBase}/{mainClassName}/
|
|
* - dacli 把 app/* 写到 {uniappBase}/{mainClassName}/
|
|
* - 不再放到 ssw-{appCode}/web 或 ssw-{appCode}/app (历史包袱, 已废弃)
|
|
*/
|
|
web?: boolean
|
|
uniapp?: boolean
|
|
webBase?: string
|
|
uniappBase?: string
|
|
/**
|
|
* 关闭多模块归类 (旧版行为兼容): 文件直接写到 outDir 根, 不分 entity/biz/controller
|
|
* 默认开启多模块归类 (推荐, 对齐 aibridge docs/code-rule.md §POM 依赖规则)
|
|
*/
|
|
flat?: boolean
|
|
/**
|
|
* 默认把 Controller 输出到 biz 模块 (对齐 ssw-dos 模式)
|
|
* 根因: 旧版默认输出到独立 ${moduleArtifactId}-controller/ 子目录,
|
|
* 用户需手动 cp Controller 到 ssw-{app}-biz/controller/ 才能对齐 ssw-dos 模块结构.
|
|
* app 11 form codegen 后, 9 controller 需手动 cp (announcement + auditrecord 缺失)
|
|
* 镜像: ssw-dos 模块结构只分 entity + biz (controller 在 biz 里), 业务代码不需要单独 controller 模块
|
|
* 修: 默认 mode='biz', Controller 直接写到 ${moduleArtifactId}-biz/controller/
|
|
* --separate-controller (旧版行为): 输出到独立 ${moduleArtifactId}-controller/
|
|
*/
|
|
separateController?: boolean
|
|
/**
|
|
* 生成 4 个 pom.xml 占位 (parent + entity/biz/controller), 严格按 aibridge POM 模板
|
|
* 与 --flat 互斥 (pom 必须配合多模块结构才有意义)
|
|
*/
|
|
multiModulePom?: boolean
|
|
/**
|
|
* 只导出指定模块 (默认 all). 用于单模块测试/编译验证
|
|
* 值: all | entity | biz | controller | entity,biz 逗号分隔
|
|
*/
|
|
moduleOnly?: string
|
|
autoMenu?: boolean
|
|
json?: boolean
|
|
}
|
|
|
|
interface CodeTreeItem {
|
|
fileName: string
|
|
fileContent: string
|
|
folderName: string
|
|
children?: CodeTreeItem[]
|
|
}
|
|
|
|
/** form.tables 项 */
|
|
interface FormTable {
|
|
table: string
|
|
tableName: string
|
|
typeId?: string // '1' = 主表, '0' = 子表
|
|
fields?: Array<{ field: string; fieldName: string; aliasName?: string }>
|
|
}
|
|
|
|
/** Alias/Info 返回的单个别名项 */
|
|
interface AliasTable {
|
|
table: string
|
|
aliasName: string
|
|
comment?: string
|
|
fields?: Array<{ field: string; aliasName: string; fieldName?: string }>
|
|
}
|
|
|
|
/**
|
|
* 校验企业/应用代码格式 (aibridge code-rule.md §变量对应关系)
|
|
* 规则: 小写字母开头, 仅含字母数字下划线, 长度 2-32
|
|
* - 下限 2: 避免单字符歧义
|
|
* - 上限 32: 兼容 JNPF 自动生成的长 enCode (如 jxcj_notification_record = 24 字符)
|
|
* - 格式: 小写字母开头 + 仅字母数字下划线 (与 Java package 名一致; 不允许连字符/大写/数字开头)
|
|
* 例: ssw ✓, app ✓, jxcj_notification_record ✓, 123 ✗, Abc ✗ (大写), a-b ✗ (连字符)
|
|
*/
|
|
function validateCode(value: string, label: string): string | null {
|
|
if (!value) return `${label} 不能为空`
|
|
if (value.length < 2 || value.length > 32) {
|
|
return `${label} "${value}" 长度需 2-32 (当前 ${value.length})`
|
|
}
|
|
if (!/^[a-z][a-z0-9_]*$/.test(value)) {
|
|
return `${label} "${value}" 格式错误: 须小写字母开头, 仅含小写字母/数字/下划线 (与 aibridge company_code/app_code 一致)`
|
|
}
|
|
return null
|
|
}
|
|
|
|
/**
|
|
* snake_case → PascalCase 转换, 用于从 form.enCode 推导 Java 类名
|
|
* 例 (appCode=app):
|
|
* "jxcj_announcement" → "Announcement" (丢 appCode 前缀, 因包名已带)
|
|
* "jxcj_develop_project" → "DevelopProject"
|
|
* "app" → "Jxcj" (无下划线保留)
|
|
* "jxcj_notification_record" → "NotificationRecord"
|
|
* "JxcjAnnouncement" (已 PascalCase) → 原样返回
|
|
* 规则:
|
|
* - 含下划线 + 首段是 PascalCase 单段 (e.g. "Jxcj_xxx") → 丢首段, rest PascalCase
|
|
* - 含下划线 + 首段是小写 (e.g. "jxcj_xxx") → 丢首段, rest PascalCase
|
|
* - 不含下划线 + 首字母大写 → 原样返回
|
|
* - 不含下划线 + 首字母小写 → 强制大写
|
|
* 理由: 包名已带 appCode (ssw.app.mapper), 类名不重复
|
|
*/
|
|
export function snakeToPascalCase(s: string, appCode?: string): string {
|
|
if (!s) return s
|
|
// 已是 PascalCase (无下划线, 首字母大写) → 原样返回
|
|
if (!s.includes('_') && /^[A-Z]/.test(s)) return s
|
|
const parts = s.split('_').filter(p => p.length > 0)
|
|
if (parts.length === 0) return s
|
|
// 丢首段 (appCode 前缀) 的规则, 从严 (避免误删):
|
|
// 1) 首段与 appCode 匹配 (大小写不敏感) + 多段 → 丢
|
|
// 2) 首段是 PascalCase (Jxcj/Tds) + 多段 → 丢 (视为 appCode 形式)
|
|
// 不丢: 首段纯小写 + 无 appCode 参数 (避免 a_b_c → BC 误删)
|
|
let rest = parts
|
|
const firstSegment = parts[0]
|
|
if (appCode && firstSegment.toLowerCase() === appCode.toLowerCase() && parts.length > 1) {
|
|
rest = parts.slice(1)
|
|
} else if (/^[A-Z][a-z0-9]*$/.test(firstSegment) && parts.length > 1) {
|
|
// PascalCase 形式 (Jxcj_xxx) 即使无 appCode 参数也丢
|
|
rest = parts.slice(1)
|
|
}
|
|
if (rest.length === 0) {
|
|
// 极端: enCode 就是 appCode (e.g. "app") → 返回 appCode PascalCase
|
|
return appCode ? appCode.charAt(0).toUpperCase() + appCode.slice(1) : s
|
|
}
|
|
return rest.map(p => p.charAt(0).toUpperCase() + p.slice(1)).join('')
|
|
}
|
|
|
|
/** 分类文件: 前端 vs 后端, 后端再细分 */
|
|
function classifyFile(item: CodeTreeItem): 'web' | 'entity' | 'model' | 'service' | 'mapper' | 'controller' | null {
|
|
const folder = (item.folderName || '').toLowerCase()
|
|
const name = item.fileName
|
|
if (!item.fileContent) return null
|
|
if (folder === 'vue' || folder === 'ts' || folder === 'js') return 'web'
|
|
if (folder === 'xml') return 'mapper'
|
|
if (folder === 'json') return 'model'
|
|
if (folder === 'java') {
|
|
if (name.includes('Controller')) return 'controller'
|
|
if (name.includes('ServiceImpl')) return 'service'
|
|
if (name.includes('Service')) return 'service'
|
|
if (name.includes('Mapper')) return 'mapper'
|
|
if (name.includes('Entity')) return 'entity'
|
|
if (name.includes('Excel') || name.includes('Form') || name.includes('Pagination') || name.includes('Constant') || name.includes('Json')) return 'model'
|
|
return 'model'
|
|
}
|
|
return null
|
|
}
|
|
|
|
/**
|
|
* Phase 3.3: --auto-menu 实现 (调 webapi /visualdev/Base/{formId}/Actions/Module)
|
|
* 镜像 web onlineDev/formDesign/components/CreateMenuModal.vue handleSubmit (line 100-120)
|
|
* 调 platform /visualdev/Base/{formId}/Actions/Module 后端自动:
|
|
* 1. 构造 menu entity (fullName/enCode/propertyJson/urlAddress)
|
|
* 2. 选 pcParents 顶级 (从 /system/Menu/SelectorFilter/0 自动找)
|
|
* 3. 给当前用户角色授权
|
|
* 失败: warn 但不阻断 (codegen 成功, 挂菜单可手动 dacli menu create --formId=X)
|
|
*/
|
|
async function autoMountMenu(
|
|
c: JnpfClient,
|
|
formId: string,
|
|
fullName: string,
|
|
enCode: string,
|
|
// v2.3+ (2026-07-21): 接收 wrapCommand ctx (嵌套函数, 需显式传)
|
|
ctx: { addSuggestion(s: import('../../core/logfile.ts').FixEntry): void },
|
|
): Promise<void> {
|
|
log.info(`--auto-menu: 调 webapi Actions/Module 挂菜单 (formId=${formId})`)
|
|
try {
|
|
// 自动从 /system/Menu/SelectorFilter/0 找 type=1 (Web 目录) 顶级
|
|
const sel = (await c.get<{ list?: Array<{ id: string; type: number; children?: any[] }> }>(
|
|
'/system/Menu/SelectorFilter/0',
|
|
{ category: 'Web' },
|
|
)) as { data?: { list?: Array<any> } }
|
|
const root = findWebDirectoryParent(sel.data?.list || [])
|
|
if (!root) {
|
|
log.warn(`--auto-menu: 没找到 Web 目录父菜单 (SelectorFilter 返空), 跳过挂菜单`)
|
|
log.warn(' 手动: dacli menu create --formId=' + formId + ' --pcParents=<父menuId>')
|
|
// v2.3+ L3: codegen 成功但 menu 未挂, 让 AI 跑 log last 看自动 fallback 命令
|
|
ctx.addSuggestion(remindCodeGenMenuAttachFail(formId))
|
|
return
|
|
}
|
|
// 调 Actions/Module (镜像 web CreateMenuModal.vue:100-120)
|
|
const body = {
|
|
pc: 1,
|
|
app: 0,
|
|
pcModuleParentId: [root],
|
|
appModuleParentId: [],
|
|
platformRelease: JSON.stringify({ pc: 1, app: 0 }),
|
|
}
|
|
const r = (await c.postJson(`/visualdev/Base/${formId}/Actions/Module`, body)) as {
|
|
code?: number
|
|
msg?: string
|
|
}
|
|
if (r.code !== 200) {
|
|
log.warn(`--auto-menu: 挂菜单失败 (code=${r.code}): ${r.msg}`)
|
|
log.warn(` 手动: dacli menu create --formId=${formId} --pcParents=${root}`)
|
|
// v2.4+ L3: codegen 成功但 menu 未挂, 让 AI 跑 log last 看 fallback 命令
|
|
ctx.addSuggestion(remindCodeGenMenuMountFail(formId, r.code, r.msg))
|
|
return
|
|
}
|
|
log.ok(`✓ --auto-menu: 已挂菜单 (fullName=${fullName}, enCode=${enCode}, 父菜单=${root})`)
|
|
} catch (e) {
|
|
log.warn(`--auto-menu: 异常 (${(e as Error).message?.slice(0, 100)}), 跳过`)
|
|
// v2.4+ L3: 异常路径同样归档
|
|
ctx.addSuggestion(remindCodeGenMenuMountFail(formId, undefined, (e as Error).message?.slice(0, 100)))
|
|
}
|
|
}
|
|
|
|
/** 递归找 SelectorFilter 第一个 type===1 (Web 目录) 节点 (镜像 dacli menu/create.ts:150-162) */
|
|
function findWebDirectoryParent(
|
|
items: Array<{ id: string; type: number; children?: any[] }>,
|
|
): string | null {
|
|
for (const it of items) {
|
|
if (it.type === 1) return it.id
|
|
if (Array.isArray(it.children) && it.children.length) {
|
|
const found = findWebDirectoryParent(it.children)
|
|
if (found) return found
|
|
}
|
|
}
|
|
return null
|
|
}
|
|
|
|
/**
|
|
* JNPF 模板 bug 后处理: 修复 Velocity 未替换的字面 ${...} 占位符 (含方法调用)
|
|
* 根因 (多个模板): Form.java.vm / Pagination.java.vm / ServiceImpl.java.vm 用了
|
|
* `#set($x = "${y}")` 但 $y 为 undefined, Velocity 把字面字符串赋给 $x, 导致输出
|
|
* `private XXX ${y};` 或 `form.get${Field.fieldAlias.substring(...)}()` 这种非法 Java 代码
|
|
* 修复策略: 对 .java 文件中所有 ${xxx.yyy[.method(args)]} 字面占位符:
|
|
* - 简单 ${xxx}: 用 @JsonProperty 推 camelCase (Form 字段) 或通用占位符
|
|
* - 含方法调用 ${xxx.method()}: 整个表达式替换为通用驼峰名 (ServiceImpl getter 等)
|
|
* 例: Form.java 原始 → 修复后
|
|
* @JsonProperty("f_team_name")
|
|
* @JSONField(name = "f_team_name")
|
|
* private String ${html.fieldAlias}; private String fteamName;
|
|
* ServiceImpl.java 原始 → 修复后
|
|
* form.get${Field.fieldAlias.substring(0,1).toUpperCase()}${Field.fieldAlias.substring(1)}()
|
|
* → form.getFieldAlias() // 占位符, 编译过但 getter 不存在 (需手动修复或忽略)
|
|
*/
|
|
function fixUnresolvedVelocityVars(content: string): { fixed: string; count: number } {
|
|
let count = 0
|
|
const lines = content.split('\n')
|
|
let curJsonProp: string | null = null
|
|
|
|
const fixed = lines
|
|
.map((line) => {
|
|
// 跟踪 @JsonProperty 状态
|
|
const jpMatch = line.match(/@JsonProperty\(\s*"([^"]+)"\s*\)/)
|
|
if (jpMatch) curJsonProp = jpMatch[1]
|
|
if (line.match(/^\s*[}\);]/)) curJsonProp = null
|
|
|
|
// 1. 处理所有 Velocity 占位符: ${...} (简单变量或方法调用)
|
|
// - 含方法调用 (.method()): capitalize 最后 .method() 名 (Java 习惯 getter)
|
|
// - 简单变量 (private 行): 用 curJsonProp snake → camelCase
|
|
// - 简单变量 (其他行): 用最后一段 camelCase
|
|
line = line.replace(/\$\{[^}]*\}/g, (full) => {
|
|
count++
|
|
const inner = full.slice(2, -1) // 去掉 ${ 和 }
|
|
// 含方法调用 (.method()) → 用最后 .method() 名 capitalize (Java 执行顺序)
|
|
// 用 greedy match all + last one
|
|
const allMethods = [...inner.matchAll(/\.([a-zA-Z][a-zA-Z0-9_]*)\s*\(/g)]
|
|
if (allMethods.length > 0) {
|
|
const last = allMethods[allMethods.length - 1]
|
|
return last[1].charAt(0).toUpperCase() + last[1].slice(1)
|
|
}
|
|
// 简单变量: private 行 → 用 curJsonProp
|
|
if (line.match(/^\s*private\s/) && curJsonProp) {
|
|
return curJsonProp.charAt(0).toLowerCase() + curJsonProp.slice(1)
|
|
}
|
|
// 退化: 取最后一段, 保持原始大小写 (避免把 afterVModel 错改成 afterVmodel)
|
|
const shortName = inner.split('.').pop() || inner
|
|
return shortName.replace(/[._]/g, '')
|
|
})
|
|
|
|
return line
|
|
})
|
|
.join('\n')
|
|
|
|
return { fixed, count }
|
|
}
|
|
|
|
/**
|
|
* 根据文件路径 + 类型, 决定归到哪个 Maven 子模块
|
|
* aibridge docs/code-rule.md §POM 依赖规则 多模块结构:
|
|
* ssw-app/ (parent pom)
|
|
* ├── ssw-app-entity/ (Entity + Model/Form/VO)
|
|
* │ └── src/main/java/ssw/app/
|
|
* │ ├── entity/{Model}Entity.java
|
|
* │ └── model/{Model}Form.java
|
|
* ├── ssw module/ (Service + ServiceImpl + Mapper)
|
|
* │ └── src/main/java/
|
|
* │ ├── ssw/app/service/{Model}Service.java
|
|
* │ ├── ssw/app/service/impl/{Model}ServiceImpl.java
|
|
* │ └── jnpf/mapper/{Model}Mapper.java
|
|
* └── ssw-app-controller/ (Controller)
|
|
* └── src/main/java/ssw/app/controller/{Model}Controller.java
|
|
* 优先级: 路径含 /controller|/service|/entity|/model|/mapper 等目录段 → 解析模块名
|
|
* classifyFile 的 kind → 映射模块名
|
|
* 前端 vue/ts/js → null (不归 Maven 模块, 写到 outDir/web/ 或根)
|
|
*/
|
|
function pathToModule(filePath: string, kind: string, moduleArtifactId: string, separateController = false): string | null {
|
|
const lower = filePath.toLowerCase()
|
|
// Controller 默认归 biz 模块 (对齐 ssw-dos 模式)
|
|
// 默认 mode='biz': Controller 写到 ${moduleArtifactId}-biz/controller/ (与 service/mapper 同一模块)
|
|
// --separate-controller: 输出到独立 ${moduleArtifactId}-controller/ (旧版行为兼容)
|
|
const controllerModule = separateController ? `${moduleArtifactId}-controller` : `${moduleArtifactId}-biz`
|
|
// 1. 路径含 controller/service/entity/model/mapper → 解析 (最准确)
|
|
if (lower.includes('/controller/') || /controller\.java$/.test(lower)) return controllerModule
|
|
if (lower.includes('/service/') || /serviceimpl?\.java$/.test(lower)) return `${moduleArtifactId}-biz`
|
|
if (lower.includes('/mapper/') || /mapper\.(java|xml)$/.test(lower)) return `${moduleArtifactId}-biz`
|
|
if (lower.includes('/entity/') || /entity\.java$/.test(lower)) return `${moduleArtifactId}-entity`
|
|
if (lower.includes('/model/') || /form\.java$/.test(lower)) return `${moduleArtifactId}-entity`
|
|
// 2. 前端文件 → 不归 Maven 模块
|
|
if (lower.endsWith('.vue') || lower.endsWith('.ts') || lower.endsWith('.js') || lower.endsWith('.tsx')) return null
|
|
// 3. 其他 .xml 资源 (非 mapper) → 归 biz (与 mapper.xml 同目录)
|
|
if (lower.endsWith('.xml')) return `${moduleArtifactId}-biz`
|
|
// 4. 兜底用 kind 映射
|
|
if (kind === 'controller') return controllerModule
|
|
if (kind === 'service' || kind === 'mapper') return `${moduleArtifactId}-biz`
|
|
if (kind === 'entity' || kind === 'model') return `${moduleArtifactId}-entity`
|
|
return null
|
|
}
|
|
|
|
/**
|
|
* 生成 ssw-{appCode} 多模块占位 pom.xml (可选, --multi-module-pom 启用)
|
|
* 严格按 aibridge docs/code-rule.md §POM 依赖规则:
|
|
* - 父模块: packaging=pom, modules 列出 3 个子模块
|
|
* - entity: 依赖 jnpf-common-all + jnpf-generater-base
|
|
* - biz: 依赖 entity + fastjson + commons-lang3 + jnpf-common-all
|
|
* - controller: 依赖 biz + jnpf-common-all
|
|
*/
|
|
function generateModulePoms(
|
|
outDir: string,
|
|
moduleArtifactId: string,
|
|
wantedModules: Set<string> | null = null,
|
|
): void {
|
|
// 默认 3 个子模块; --module-only 过滤时只生成选中的子模块 pom
|
|
const allSubModules = [
|
|
`${moduleArtifactId}-entity`,
|
|
`${moduleArtifactId}-biz`,
|
|
`${moduleArtifactId}-controller`,
|
|
]
|
|
const subModules = wantedModules
|
|
? allSubModules.filter((m) => wantedModules.has(m))
|
|
: allSubModules
|
|
const parentPom = `<?xml version="1.0" encoding="UTF-8"?>
|
|
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
|
|
<modelVersion>4.0.0</modelVersion>
|
|
<parent>
|
|
<groupId>com.jnpf</groupId>
|
|
<artifactId>boot</artifactId>
|
|
<version>6.2.0-RELEASE</version>
|
|
</parent>
|
|
<artifactId>${moduleArtifactId}</artifactId>
|
|
<packaging>pom</packaging>
|
|
<modules>
|
|
${subModules.map((m) => ` <module>${m}</module>`).join('\n')}
|
|
</modules>
|
|
</project>
|
|
`
|
|
// lombok 1.18.42 + annotationProcessorPaths (codegen 默认加, 避免 mvn compile "cannot find symbol log/getter")
|
|
const lombokVersion = '1.18.42'
|
|
const lombokCompilerPlugin = `
|
|
<build>
|
|
<plugins>
|
|
<plugin>
|
|
<groupId>org.apache.maven.plugins</groupId>
|
|
<artifactId>maven-compiler-plugin</artifactId>
|
|
<configuration>
|
|
<source>1.8</source>
|
|
<target>1.8</target>
|
|
<annotationProcessorPaths>
|
|
<path>
|
|
<groupId>org.projectlombok</groupId>
|
|
<artifactId>lombok</artifactId>
|
|
<version>${lombokVersion}</version>
|
|
</path>
|
|
</annotationProcessorPaths>
|
|
</configuration>
|
|
</plugin>
|
|
</plugins>
|
|
</build>
|
|
`
|
|
const entityPom = `<?xml version="1.0" encoding="UTF-8"?>
|
|
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
|
|
<modelVersion>4.0.0</modelVersion>
|
|
<parent>
|
|
<artifactId>${moduleArtifactId}</artifactId>
|
|
<groupId>com.jnpf</groupId>
|
|
<version>6.2.0-RELEASE</version>
|
|
</parent>
|
|
<artifactId>${moduleArtifactId}-entity</artifactId>
|
|
<dependencies>
|
|
<dependency><groupId>com.jnpf</groupId><artifactId>jnpf-common-all</artifactId><version>\${project.version}</version></dependency>
|
|
<dependency><groupId>com.jnpf</groupId><artifactId>jnpf-generater-base</artifactId><version>\${project.version}</version></dependency>
|
|
<!-- P1-1 fix: lombok 依赖 + annotationProcessorPaths, 否则 @Data/@Slf4j 注解不生效 -->
|
|
<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>${lombokVersion}</version><scope>provided</scope></dependency>
|
|
</dependencies>${lombokCompilerPlugin}</project>
|
|
`
|
|
const bizPom = `<?xml version="1.0" encoding="UTF-8"?>
|
|
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
|
|
<modelVersion>4.0.0</modelVersion>
|
|
<parent>
|
|
<artifactId>${moduleArtifactId}</artifactId>
|
|
<groupId>com.jnpf</groupId>
|
|
<version>6.2.0-RELEASE</version>
|
|
</parent>
|
|
<artifactId>${moduleArtifactId}-biz</artifactId>
|
|
<dependencies>
|
|
<dependency><groupId>com.jnpf</groupId><artifactId>${moduleArtifactId}-entity</artifactId><version>\${project.version}</version></dependency>
|
|
<dependency><groupId>com.alibaba</groupId><artifactId>fastjson</artifactId><version>1.2.83</version></dependency>
|
|
<dependency><groupId>org.apache.commons</groupId><artifactId>commons-lang3</artifactId><version>3.12.0</version></dependency>
|
|
<dependency><groupId>com.jnpf</groupId><artifactId>jnpf-common-all</artifactId><version>\${project.version}</version></dependency>
|
|
<!-- v0.12+ BS-New-2 fix (2026-06-30 jxcj): codegen 自动补 JNPF 平台依赖
|
|
根因: 生成的 Service 引用 jnpf.permission.entity.UserEntity + jnpf.util.GeneraterSwapUtil
|
|
+ jnpf.model.QueryAllModel, 但 ssw-{app}-biz 旧 pom 没声明这两个 artifact
|
|
→ mvn compile 报 "package does not exist" / "cannot find symbol"
|
|
镜像: aibridge code-rule.md §POM 依赖规则 - biz 必须含所有 runtime 间接依赖
|
|
修: 默认加这 2 个 dep, biz 编译可直接通过 (不需要手改 pom) -->
|
|
<dependency><groupId>com.jnpf</groupId><artifactId>jnpf-permission-entity</artifactId><version>\${project.version}</version></dependency>
|
|
<dependency><groupId>com.jnpf</groupId><artifactId>jnpf-generater-base</artifactId><version>\${project.version}</version></dependency>
|
|
<!-- P1-1 fix (2026-07-16): ServiceImpl 用 @RequiredArgsConstructor + lombok.Cleanup -->
|
|
<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>${lombokVersion}</version><scope>provided</scope></dependency>
|
|
</dependencies>${lombokCompilerPlugin}</project>
|
|
`
|
|
const controllerPom = `<?xml version="1.0" encoding="UTF-8"?>
|
|
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
|
|
<modelVersion>4.0.0</modelVersion>
|
|
<parent>
|
|
<artifactId>${moduleArtifactId}</artifactId>
|
|
<groupId>com.jnpf</groupId>
|
|
<version>6.2.0-RELEASE</version>
|
|
</parent>
|
|
<artifactId>${moduleArtifactId}-controller</artifactId>
|
|
<dependencies>
|
|
<dependency><groupId>com.jnpf</groupId><artifactId>${moduleArtifactId}-biz</artifactId><version>\${project.version}</version></dependency>
|
|
<dependency><groupId>com.jnpf</groupId><artifactId>jnpf-common-all</artifactId><version>\${project.version}</version></dependency>
|
|
<!-- P1-1 fix (2026-07-16): Controller 用 @RequiredArgsConstructor + @Slf4j -->
|
|
<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>${lombokVersion}</version><scope>provided</scope></dependency>
|
|
</dependencies>${lombokCompilerPlugin}</project>
|
|
`
|
|
writeFileSync(join(outDir, 'pom.xml'), parentPom, 'utf-8')
|
|
if (subModules.includes(`${moduleArtifactId}-entity`))
|
|
writeFileSync(join(outDir, `${moduleArtifactId}-entity`, 'pom.xml'), entityPom, 'utf-8')
|
|
if (subModules.includes(`${moduleArtifactId}-biz`))
|
|
writeFileSync(join(outDir, `${moduleArtifactId}-biz`, 'pom.xml'), bizPom, 'utf-8')
|
|
if (subModules.includes(`${moduleArtifactId}-controller`))
|
|
writeFileSync(join(outDir, `${moduleArtifactId}-controller`, 'pom.xml'), controllerPom, 'utf-8')
|
|
log.info(`✓ 已生成 ${subModules.length + 1} 个 pom.xml (parent${subModules.length < 3 ? ` + ${subModules.length} 子模块` : ' + entity/biz/controller'})`)
|
|
}
|
|
async function ensureAlias(
|
|
c: JnpfClient,
|
|
formId: string,
|
|
opts: CodegenOpts,
|
|
formTables: FormTable[] | undefined,
|
|
): Promise<boolean> {
|
|
if (!opts.autoAlias && !opts.aliasFile && !opts.alias) return false
|
|
|
|
let aliasTables: AliasTable[] = []
|
|
|
|
if (opts.aliasFile) {
|
|
const fs = await import('node:fs/promises')
|
|
const content = await fs.readFile(opts.aliasFile, 'utf-8')
|
|
try {
|
|
aliasTables = JSON.parse(content)
|
|
} catch (e) {
|
|
log.error(`--alias-file JSON 解析失败: ${(e as Error).message}`)
|
|
throw new Error(`--alias-file JSON 解析失败: ${(e as Error).message}`)
|
|
}
|
|
} else if (opts.alias) {
|
|
try {
|
|
aliasTables = JSON.parse(opts.alias)
|
|
} catch (e) {
|
|
log.error(`--alias JSON 解析失败: ${(e as Error).message}`)
|
|
throw new Error(`--alias JSON 解析失败: ${(e as Error).message}`)
|
|
}
|
|
} else if (opts.autoAlias) {
|
|
// 从 form.tables 推导主表别名
|
|
const origMainClassName = opts.mainClassName || ''
|
|
if (!origMainClassName) {
|
|
log.error('--auto-alias 需要 --mainClassName (或 form.enCode 已是 camelCase)')
|
|
throw new Error('--auto-alias 需要 --mainClassName (或 form.enCode 已是 camelCase)')
|
|
}
|
|
if (!Array.isArray(formTables) || formTables.length === 0) {
|
|
log.error('--auto-alias: form.tables 为空, 无法推导 (确认 form 已发布且含主表)')
|
|
throw new Error('--auto-alias: form.tables 为空, 无法推导 (确认 form 已发布且含主表)')
|
|
}
|
|
// JNPF alias 系统强制要求前 2 字符小写 (jnpf/.../VisualAliasServiceImpl.java:160-172)
|
|
// aibridge code-rule.md 推荐 PascalCase (如 JxcjTeam), 与 JNPF 冲突, 自动转 camelCase
|
|
// 例: "JxcjTeam" → "jxcjTeam" (用户传入 PascalCase, 内部用 camelCase 走 JNPF)
|
|
const lowerFirst2 = origMainClassName.slice(0, 2).toLowerCase() + origMainClassName.slice(2)
|
|
const mainClassName = lowerFirst2
|
|
if (lowerFirst2 !== origMainClassName) {
|
|
log.warn(
|
|
`--auto-alias: JNPF alias 系统强制首 2 字符小写, 自动转 "${origMainClassName}" → "${lowerFirst2}"`,
|
|
)
|
|
log.warn(' (aibridge 推荐 PascalCase, 但 JNPF 只接受 camelCase. 生成的代码用 camelCase)')
|
|
}
|
|
// 主表 (typeId='1') 设别名 = mainClassName
|
|
const mainTable = formTables.find((t) => t.typeId === '1') || formTables[0]
|
|
aliasTables = [
|
|
{
|
|
table: mainTable.table,
|
|
aliasName: mainClassName,
|
|
comment: mainTable.tableName,
|
|
// 字段级别名 (如有 aliasName 字段) 也带上
|
|
fields: Array.isArray(mainTable.fields)
|
|
? mainTable.fields
|
|
.filter((f) => f.aliasName && f.aliasName !== f.field)
|
|
.map((f) => ({
|
|
field: f.field,
|
|
aliasName: f.aliasName as string,
|
|
fieldName: f.fieldName,
|
|
}))
|
|
: [],
|
|
},
|
|
]
|
|
}
|
|
|
|
if (aliasTables.length === 0) {
|
|
log.warn('未推导出任何 alias, 跳过 Alias/Save')
|
|
return false
|
|
}
|
|
|
|
log.info(`loadVisualDev.saveAlias (formId=${formId}, ${aliasTables.length} 个表别名)`)
|
|
// Phase 2: 改用 webapi
|
|
await initWebapi(c)
|
|
const r = (await loadVisualDev.saveAlias(formId, { tableList: aliasTables })) as { code?: number; msg?: string }
|
|
if (r.code !== 200 && r.code !== undefined) {
|
|
log.error(`Alias/Save 失败 (code=${r.code}): ${r.msg}`)
|
|
throw new Error(`Alias/Save 失败 (code=${r.code}): ${r.msg}`)
|
|
}
|
|
log.ok(`✓ 已保存 ${aliasTables.length} 个表别名 (CodePreview 将使用这些别名生成代码, 不需要 post-fix)`)
|
|
return true
|
|
}
|
|
|
|
async function repairCodegenSearchList(formId: string): Promise<number> {
|
|
const raw = await loadVisualDev.getInfo(formId) as Record<string, any>
|
|
const parseJson = (value: unknown): Record<string, any> => {
|
|
if (value && typeof value === 'object') return value as Record<string, any>
|
|
if (typeof value === 'string') {
|
|
try { return JSON.parse(value) as Record<string, any> } catch { return {} }
|
|
}
|
|
return {}
|
|
}
|
|
|
|
const formData = parseJson(raw.formData)
|
|
const columnData = parseJson(raw.columnData)
|
|
const repaired = normalizeCodegenSearchList(columnData, formData)
|
|
if (repaired.changed === 0) return 0
|
|
|
|
const body: Record<string, any> = {
|
|
...raw,
|
|
id: raw.id || formId,
|
|
columnData: JSON.stringify(repaired.columnData),
|
|
}
|
|
if (raw.appColumnData !== undefined && raw.appColumnData !== null) {
|
|
const appColumnData = parseJson(raw.appColumnData)
|
|
const appRepaired = normalizeCodegenSearchList(appColumnData, formData)
|
|
body.appColumnData = JSON.stringify(appRepaired.columnData)
|
|
}
|
|
|
|
const updated = await loadVisualDev.update(body) as { code?: number; msg?: string }
|
|
if (updated.code !== undefined && updated.code !== 200) {
|
|
throw new Error(`searchList 自动修复失败 (code=${updated.code}): ${updated.msg || ''}`)
|
|
}
|
|
const released = await loadVisualDev.release(formId) as { code?: number; msg?: string }
|
|
if (released.code !== undefined && released.code !== 200) {
|
|
throw new Error(`searchList 修复后重新发布失败 (code=${released.code}): ${released.msg || ''}`)
|
|
}
|
|
return repaired.changed
|
|
}
|
|
|
|
export function buildFormCodegenCommand(): Command {
|
|
const cmd = new Command('codegen')
|
|
.description('表单代码生成 (白皮书 5.5, 参考 aibridge CodeGenerator)')
|
|
.argument('<formId>', 'form id (要先 release, state=1)')
|
|
.option('--company <code>', '企业代码 (aibridge company_code, 默认 ssw; 模块名 = ${company}-${module}, 包名 = ${company}.${module})', 'ssw')
|
|
.option('--module <name>', '应用代码 (aibridge app_code, 默认取 form.enCode; 模块名 = ${company}-${module})')
|
|
.option('--modulePackage <pkg>', '模块包名 (默认 ${company}.${module},如 ssw.tds) — 写到 Java package 行')
|
|
.option('--description <desc>', '功能描述 (写到类注释)')
|
|
.option('--dbLinkId <id>', '数据源 id (走业务库, 默认从 token.dbLinkId)')
|
|
.option('--mainClassName <name>', '主表类名 (PascalCase, 默认从 enCode 自动转换: jxcj_develop_project → JxcjDevelopProject)')
|
|
.option('--enCode <e>', 'v0.12+ BS-New-9: 显式指定 form enCode (Controller @RequestMapping 路径用, 默认取 opts.module)')
|
|
.option('--enableFlow <0|1>', '是否启用流程 0/1', '0')
|
|
.option('--out <path>', '输出目录 (默认 ./generated/${company}-${module}/)')
|
|
// ⭐ 多模块归类 (默认开启, 对齐 aibridge ssw-{appCode} 多模块 POM 结构)
|
|
.option('--flat', '关闭多模块归类 (旧版兼容: 文件直接写到 outDir 根, 不分 entity/biz/controller)', false)
|
|
// Controller 默认归 biz 模块 (对齐 ssw-dos 模式)
|
|
.option('--separate-controller', 'Controller 输出到独立 ${moduleArtifactId}-controller/ 子目录 (旧版行为, 默认合并到 biz)', false)
|
|
.option('--multi-module-pom', '生成 4 个 pom.xml 占位 (parent + entity/biz/controller, 严格按 aibridge §POM 依赖规则; 与 --flat 互斥)', false)
|
|
// 选择性导出 (只生成指定模块, 用于单模块编译验证)
|
|
// 值: all | entity | biz | controller | 任意逗号分隔组合 (如 entity,biz)
|
|
.option('--module-only <list>', '只导出指定模块 (all 默认, 或 entity/biz/controller 逗号分隔, 用于单模块测试/编译)', 'all')
|
|
// ⭐ 默认开: JNPF 原生别名系统, 写 base_visual_alias, 消除 post-fix
|
|
// 默认 ON 原因: 不写别名 → JNPF 生成的类名 = 表名 = Jxcj_xxx_xxxMapper (历史包袱, 验证过 28 form)
|
|
// 写别名 → JNPF 生成 PascalCase 类名 (AnnouncementMapper), 0 post-fix
|
|
// 推荐保留默认 ON; 用 --no-auto-alias 显式关闭 (commander 自动处理 --no-X 否定)
|
|
.option('--auto-alias', '(默认开) 写 base_visual_alias, JNPF 用别名生成 PascalCase 类名', true)
|
|
.option('--alias-file <path>', '从 JSON 文件读 alias 表 (格式: [{table,aliasName,fields?}])')
|
|
.option('--alias <json>', '直接传 alias JSON 字符串 (与 --alias-file 二选一)')
|
|
// 前端 web/uniapp 输出控制
|
|
.option('--no-web', '不生成 web/ (web Vue 3) 前端代码, 默认生成')
|
|
.option('--no-uniapp', '不生成 uniapp/ (移动端) 前端代码, 默认生成')
|
|
.option('--web-base <path>', 'web 输出基准路径 (默认 web/apps/jnpf-web-apps-main/src/views/ssw/{appCode})')
|
|
.option('--uniapp-base <path>', 'uniapp 输出基准路径 (默认 uniapp/pages/ssw/{appCode})')
|
|
.option('--auto-menu', '生成完直接调 menu create 挂菜单', false)
|
|
.option('--json', '原始 JSON 输出 (file tree)', false)
|
|
.action(async (formId: string, opts: CodegenOpts) => {
|
|
const c = await JnpfClient.fromToken()
|
|
await wrapCommand({
|
|
command: 'form codegen',
|
|
appCode: c.appCode,
|
|
startTime: Date.now(),
|
|
json: opts.json,
|
|
fixes: [],
|
|
}, async (ctx) => {
|
|
try {
|
|
// 0. 校验 company / module 格式 (aibridge §变量对应关系)
|
|
const company = opts.company || 'ssw'
|
|
const companyErr = validateCode(company, '--company')
|
|
if (companyErr) {
|
|
log.error(companyErr)
|
|
return ctx.fail(companyErr, { formId })
|
|
}
|
|
|
|
// Phase 2: 改用 webapi
|
|
await initWebapi(c)
|
|
// '--dbLinkId=default' 字面量 → token.dbLinkId
|
|
const dbLinkId = c.resolveDbLinkId(opts.dbLinkId)
|
|
|
|
// 1. 拿 form 概要 (拿 enCode 当默认 mainClassName / module) - webapi
|
|
const info = (await loadVisualDev.getInfo(formId)) as { enCode?: string; fullName?: string }
|
|
const enCode = info.enCode || formId
|
|
const fullName = info.fullName || enCode
|
|
const module = opts.module || enCode
|
|
const moduleErr = validateCode(module, '--module (或 form.enCode)')
|
|
if (moduleErr) {
|
|
log.error(moduleErr)
|
|
return ctx.fail(moduleErr, { formId })
|
|
}
|
|
const mainClassName = opts.mainClassName || snakeToPascalCase(enCode, module)
|
|
|
|
// 1.5. 拿 form 完整配置 (含 tables) — 给 --auto-alias 用 + 拿主表名给 description 默认值
|
|
// 用 GET /Alias/Info 拿 table 列表 (比 /Config.formData 可靠, webType=2/3 都返回)
|
|
// 返回 [{typeId, table, fields, ...}], typeId='1' 为主表
|
|
let formTables: FormTable[] | undefined
|
|
let mainTableName: string | undefined
|
|
const needsTables = opts.autoAlias && !opts.aliasFile && !opts.alias
|
|
if (needsTables || !opts.description) {
|
|
try {
|
|
// Phase 2: 改用 webapi (loadVisualDev.getAliasInfo)
|
|
const aliasInfo = (await loadVisualDev.getAliasInfo(formId)) as any[]
|
|
const tables = Array.isArray(aliasInfo) ? aliasInfo : []
|
|
if (tables.length > 0) {
|
|
formTables = tables
|
|
.filter((t: any) => t.table)
|
|
.map((t: any) => ({
|
|
table: t.table,
|
|
tableName: t.tableName || t.table,
|
|
typeId: String(t.typeId || '0'),
|
|
fields: Array.isArray(t.fields)
|
|
? t.fields.map((f: any) => ({
|
|
field: f.field,
|
|
fieldName: f.fieldName || f.field,
|
|
aliasName: f.aliasName,
|
|
}))
|
|
: [],
|
|
}))
|
|
const mainTable = formTables.find((t) => t.typeId === '1') || formTables[0]
|
|
mainTableName = mainTable?.table
|
|
log.debug(`从 Alias/Info 解析 ${formTables.length} 个表, 主表: ${mainTableName}`)
|
|
}
|
|
} catch (e) {
|
|
log.debug(`解析 Alias/Info 失败 (非致命, --auto-alias 会跳过): ${(e as Error).message}`)
|
|
}
|
|
}
|
|
|
|
// 2. (可选) --auto-alias / --alias-file / --alias: 通过 JNPF 原生别名系统
|
|
// 推荐方式 (写 base_visual_alias, JNPF 原生)
|
|
await ensureAlias(c, formId, opts, formTables)
|
|
// CodeGenerateFactoryV3 currently dereferences SearchTypeModel.id. Repair
|
|
// legacy/table-generated searchList entries before calling CodePreview;
|
|
// this is a dacli-side schema repair, not a platform-source change.
|
|
const repairedSearchItems = await repairCodegenSearchList(formId)
|
|
if (repairedSearchItems > 0) {
|
|
log.warn(`⚠ codegen 预修复 searchList: ${repairedSearchItems} 项补齐 id/prop,并重新发布 form`)
|
|
}
|
|
// aibridge 派生规则: modulePackage = ${company}.${app_code}
|
|
const modulePackage = opts.modulePackage || `${company}.${module}`
|
|
// Maven 模块目录名 (aibridge §POM 依赖规则): ${company}-${app_code}
|
|
const moduleArtifactId = `${company}-${module}`
|
|
|
|
log.info(`命名规则 (aibridge code-rule.md):`)
|
|
log.info(` company_code = ${company}`)
|
|
log.info(` app_code = ${module}`)
|
|
log.info(` moduleArtifactId = ${moduleArtifactId} (Maven 父模块 / artifactId)`)
|
|
log.info(` modulePackage = ${modulePackage} (Java 包名)`)
|
|
log.info(` mainClassName = ${mainClassName} (PascalCase 主类)`)
|
|
log.info('')
|
|
|
|
// body 字段严格对齐 web/.../PreviewModal.vue:56-61 + DownloadModal.vue:63-64
|
|
// module: 来自 createModule 字典 id (web DownloadModal.vue:69 取 moduleOptions[0].id)
|
|
// description: web 默认 = mainTable.table (主表名, 不是 fullName 中文名)
|
|
// ⚠ 不要加 dataSourceId / mainClassName / contrast — FormMarco.vm:1226 对空字符串调
|
|
// substring(0,1) 会 StringIndexOutOfBoundsException → "System abnormality" 400
|
|
// (aibridge 用同 4 字段, 同因; web 实际只发 4 字段)
|
|
// ⚠ module 必须是 createModule 字典 id (默认 example=406725667942571077).
|
|
// web DownloadModal.vue:69 取 moduleOptions[0].id, 即字典第一条
|
|
// 任意字符串 (如 enCode) 会让 JNPF 内部解析失败, 触发 FormMarco.vm:1226 空串 crash
|
|
// 通过 --module-dict-id 或 DACLI_CREATE_MODULE_ID 环境变量覆盖
|
|
const moduleDictId =
|
|
process.env.DACLI_CREATE_MODULE_ID || '406725667942571077'
|
|
const body = {
|
|
module: moduleDictId, // web 端是字典 id, 不是 enCode
|
|
modulePackageName: modulePackage,
|
|
description: opts.description || mainTableName || fullName,
|
|
enableFlow: Number(opts.enableFlow || '0'),
|
|
}
|
|
|
|
log.info(`POST /visualdev/Generater/${formId}/Actions/CodePreview`)
|
|
// 走 callWithDiagnosis 让 client.diagnoseError() 触发, 输出 trigger='' 等修复指引
|
|
// DEV-5 fix : webapi _defhttp_shim 已解包 envelope, 返 data 部分
|
|
// 旧 cast `{code?, msg?, data?}` 是 envelope 形状, 但 unwrap 已返 data = {list:[...]}
|
|
// 导致 r.code=undefined → "CodePreview 失败 (code=undefined)" 假报错
|
|
// 修: cast 改 webapi 实际返 {list:CodeTreeItem[]} 形状
|
|
let r: { list?: CodeTreeItem[] }
|
|
try {
|
|
// Phase 2: 改用 webapi (loadVisualDev.codePreview)
|
|
r = (await loadVisualDev.codePreview(formId, body)) as { list?: CodeTreeItem[] }
|
|
} catch (e) {
|
|
const err = e as Error
|
|
log.error(`CodePreview 请求失败: ${err.message}`)
|
|
const causes = c.diagnoseError(err.message, {
|
|
appCode: c.appCode,
|
|
dbLinkId: c.dbLinkId ?? '',
|
|
tokenStatus: 'valid',
|
|
existingEnCodes: [],
|
|
unreleasedForms: [],
|
|
releasedForms: [],
|
|
modifiedAfterPublishForms: [],
|
|
workflowList: [],
|
|
existingTables: [],
|
|
menus: [],
|
|
topLevelMenus: [],
|
|
currentSystemId: '',
|
|
currentVersion: '',
|
|
warnings: [],
|
|
})
|
|
log.error(' 可能原因:')
|
|
for (const cause of causes) log.error(` ${cause}`)
|
|
return ctx.fail(`CodePreview 请求失败: ${err.message}`, { formId })
|
|
}
|
|
const tree = r.list || []
|
|
if (tree.length === 0) {
|
|
log.warn('CodePreview 返回空 list, 没文件可生成 (确认 form 已发布 state=1)')
|
|
return ctx.success({ formId, enCode, files: 0, note: 'empty tree' })
|
|
}
|
|
if (opts.json) {
|
|
printJson({ formId, enCode, fullName, company, module, moduleArtifactId, modulePackage, body, tree })
|
|
return ctx.success({ formId, enCode, files: tree.length })
|
|
}
|
|
|
|
// 2. 展开 tree, 分类
|
|
const files: { kind: string; path: string; content: string }[] = []
|
|
const traverse = (items: CodeTreeItem[], parent = '') => {
|
|
for (const it of items) {
|
|
const path = parent ? `${parent}/${it.fileName}` : it.fileName
|
|
if (it.children?.length) {
|
|
traverse(it.children, path)
|
|
} else {
|
|
const kind = classifyFile(it)
|
|
if (kind) files.push({ kind, path, content: it.fileContent })
|
|
}
|
|
}
|
|
}
|
|
traverse(tree)
|
|
|
|
// 3. 写到 --out (默认 ./generated/{company}-{appCode}/), 按 aibridge 多模块结构归类
|
|
// 默认行为 (推荐): 文件按 pathToModule() 自动分到 entity/biz/controller 子目录
|
|
// --flat: 关闭多模块归类, 全部文件直接写到 outDir (旧版行为, 兼容用)
|
|
const outDir = opts.out || join(process.cwd(), 'generated', moduleArtifactId)
|
|
mkdirSync(outDir, { recursive: true })
|
|
log.info(`输出目录: ${outDir}`)
|
|
if (!opts.flat) {
|
|
if (opts.separateController) {
|
|
log.info(` ssw-{appCode} 多模块归类 (entity/biz/controller), --separate-controller 模式 (Controller 独立模块)`)
|
|
} else {
|
|
log.info(` ssw-{appCode} 多模块归类 (entity/biz, 默认: Controller 合并到 biz 模块, 对齐 ssw-dos)`)
|
|
}
|
|
} else {
|
|
log.info(` --flat 模式: 不分模块, 全部文件写到 outDir 根`)
|
|
}
|
|
const counts: Record<string, number> = {}
|
|
const moduleCounts: Record<string, number> = {}
|
|
// --module-only 解析: 逗号分隔, 如 "entity,biz" 或 "controller" 或 "all"
|
|
// 空字符串/'all' → 不过滤 (默认导出全部)
|
|
const moduleOnlyList = (opts.moduleOnly || 'all')
|
|
.split(',')
|
|
.map((s) => s.trim().toLowerCase())
|
|
.filter(Boolean)
|
|
const moduleOnlyAll = moduleOnlyList.includes('all')
|
|
// 短名 → 完整模块名映射
|
|
// controller 短名映射跟随 default 行为 (--separate-controller 决定 controller 在 biz 还是独立模块)
|
|
const controllerModuleName = opts.separateController ? `${moduleArtifactId}-controller` : `${moduleArtifactId}-biz`
|
|
const shortToFull: Record<string, string> = {
|
|
entity: `${moduleArtifactId}-entity`,
|
|
biz: `${moduleArtifactId}-biz`,
|
|
controller: controllerModuleName,
|
|
}
|
|
const wantedModules = new Set(
|
|
moduleOnlyAll ? [] : moduleOnlyList.map((s) => shortToFull[s] || s),
|
|
)
|
|
if (!moduleOnlyAll && wantedModules.size > 0) {
|
|
log.info(` --module-only: 只导出 ${[...wantedModules].map((m) => m.replace(`${moduleArtifactId}-`, '')).join(',')} 模块`)
|
|
}
|
|
for (const f of files) {
|
|
// 决定 Maven 子模块 (--flat 时为 null, 文件直接写到 outDir 根)
|
|
const targetModule = opts.flat ? null : pathToModule(f.path, f.kind, moduleArtifactId, opts.separateController)
|
|
|
|
// === 前端 web/uniapp 重定向 ===
|
|
// 前端重定向 web/* → $webBase/{mainClassName}/, app/* → $uniappBase/{mainClassName}/ (默认 base = $CCWORKDIR)
|
|
const CCWORKDIR = getCcWorkDir()
|
|
let frontendRedirect: { base: string; relPath: string } | null = null
|
|
if (f.path.startsWith('app/')) {
|
|
if (opts.uniapp === false) {
|
|
counts[`__skipped:uniapp`] = (counts[`__skipped:uniapp`] || 0) + 1
|
|
continue
|
|
}
|
|
const base = opts.uniappBase || join(CCWORKDIR, 'uniapp', 'pages', 'ssw', module)
|
|
frontendRedirect = { base, relPath: f.path.slice(4) /* strip 'app/' */ }
|
|
} else if (f.path.startsWith('web/')) {
|
|
if (opts.web === false) {
|
|
counts[`__skipped:web`] = (counts[`__skipped:web`] || 0) + 1
|
|
continue
|
|
}
|
|
const base = opts.webBase || join(CCWORKDIR, 'web', 'apps', 'jnpf-web-apps-main', 'src', 'views', 'ssw', module)
|
|
frontendRedirect = { base, relPath: f.path.slice(4) /* strip 'web/' */ }
|
|
}
|
|
if (frontendRedirect) {
|
|
// P2a : 大写文件名 → 小写, 对齐现有 app/TeamInfo 约定
|
|
// JNPF 生成 web/Detail.vue, web/Form.vue (PascalCase)
|
|
// 现有 app/TeamInfo 实际是 detail.vue, form.vue (lowercase)
|
|
// lowercase 更符合 Vue 3 社区规范 + 一致性
|
|
// 例外: 不改 .ts .js (JS 文件命名 PascalCase 也常见, 如 columnList.ts)
|
|
let relPath = frontendRedirect.relPath
|
|
let content = f.content
|
|
if (relPath.endsWith('.vue')) {
|
|
const lastSlash = relPath.lastIndexOf('/')
|
|
const filename = lastSlash >= 0 ? relPath.slice(lastSlash + 1) : relPath
|
|
if (/^[A-Z]/.test(filename)) {
|
|
const lower = filename.charAt(0).toLowerCase() + filename.slice(1)
|
|
relPath = lastSlash >= 0 ? relPath.slice(0, lastSlash + 1) + lower : lower
|
|
// 同步改内容里的 import / 引用: import Form from './Form.vue' → './form.vue'
|
|
const fromPath = './' + filename
|
|
const toPath = './' + lower
|
|
content = content.split(fromPath).join(toPath)
|
|
}
|
|
}
|
|
const finalPath = join(frontendRedirect.base, mainClassName, relPath)
|
|
mkdirSync(dirname(finalPath), { recursive: true })
|
|
writeFileSync(finalPath, content, 'utf-8')
|
|
counts[f.kind] = (counts[f.kind] || 0) + 1
|
|
moduleCounts[`@${f.path.split('/')[0]}:${mainClassName}`] = (moduleCounts[`@${f.path.split('/')[0]}:${mainClassName}`] || 0) + 1
|
|
continue
|
|
}
|
|
|
|
// --module-only 过滤: 跳过不在 wantedModules 里的文件 (前端 web 文件不受限, 总导出)
|
|
const isWeb = !targetModule && !opts.flat && f.kind === 'web'
|
|
if (!moduleOnlyAll && wantedModules.size > 0 && targetModule && !wantedModules.has(targetModule) && !isWeb) {
|
|
counts[`__skipped:${targetModule}`] = (counts[`__skipped:${targetModule}`] || 0) + 1
|
|
continue
|
|
}
|
|
const finalPath = targetModule ? join(outDir, targetModule, f.path) : join(outDir, f.path)
|
|
mkdirSync(dirname(finalPath), { recursive: true })
|
|
// JNPF 模板 bug 后处理: ${html.fieldAlias} / ${search.afterVModel} 等未替换的字面 Velocity 占位符
|
|
// (FormMarco.vm:1226 不动, 但 Form.java.vm / Pagination.java.vm 输出 bug 必须修, 不然 javac 失败)
|
|
// P3 : 扩展到 .xml (MyBatis 动态 SQL 罕见) + .vue (模板罕见)
|
|
// 实测 app 28 form: vue + xml 0 残留, 仅 .java 触发修复
|
|
// 仍对 xml/vue 做检查 (WARN 而非改) — 防未来模板变动
|
|
let contentToWrite = f.content
|
|
// @RequestMapping /api/example/X → /api/{company}/{module}/{enCode} (BS-New-9, 避免 example 路径冲突)
|
|
if (f.path.includes('controller/') && f.path.endsWith('.java')) {
|
|
// 用 opts.enCode 或默认 opts.module
|
|
const enCodeForPath = opts.enCode || opts.module || 'unknown'
|
|
const updated = contentToWrite.replace(
|
|
/@RequestMapping\((["'])\/api\/example\/([A-Z][A-Za-z0-9]+)\1\)/g,
|
|
(_m, q, className) => {
|
|
// 优先用 opts.enCode (form enCode), 否则从 className 推导
|
|
return `@RequestMapping(${q}/api/${opts.company || 'ssw'}/${opts.module || ''}/${enCodeForPath}${q})`
|
|
},
|
|
)
|
|
if (updated !== contentToWrite) {
|
|
const replaced = (contentToWrite.match(/@RequestMapping\((["'])\/api\/example\//g) || []).length
|
|
contentToWrite = updated
|
|
counts['__fix:bs-new-9-path'] = (counts['__fix:bs-new-9-path'] || 0) + replaced
|
|
log.info(` BS-New-9: 改写 ${replaced} 个 Controller @RequestMapping 到 /api/${opts.company || 'ssw'}/${opts.module || ''}/${enCodeForPath}`)
|
|
}
|
|
}
|
|
if (/\$\{[a-zA-Z]/.test(contentToWrite)) {
|
|
if (f.path.endsWith('.java')) {
|
|
const { fixed, count } = fixUnresolvedVelocityVars(contentToWrite)
|
|
if (count > 0) {
|
|
contentToWrite = fixed
|
|
counts[`__fix:velocity-vars`] = (counts[`__fix:velocity-vars`] || 0) + count
|
|
}
|
|
} else if (f.path.endsWith('.xml') || f.path.endsWith('.vue')) {
|
|
// .xml: MyBatis ${} 是 SQL 参数绑定, 不是 Velocity bug
|
|
// .vue: Vue 模板用 {{ }}, 不应该有 ${}
|
|
// 当前 app 28 form 0 命中; 防未来模板变动, 仅记录不改
|
|
log.debug(` [P3] ${f.path}: 含 ${'$'}{...} 占位符, 未自动修复 (xml=SQL, vue=模板)`)
|
|
}
|
|
}
|
|
writeFileSync(finalPath, contentToWrite, 'utf-8')
|
|
counts[f.kind] = (counts[f.kind] || 0) + 1
|
|
const modLabel = targetModule || '(root)'
|
|
moduleCounts[modLabel] = (moduleCounts[modLabel] || 0) + 1
|
|
}
|
|
|
|
// 3.5. (可选) --multi-module-pom: 生成 4 个 pom.xml 占位 (parent + entity/biz/controller)
|
|
// --module-only 过滤时, 只生成选中的模块 pom (parent 仍生成, modules 列表反映)
|
|
if (opts.multiModulePom && !opts.flat) {
|
|
generateModulePoms(outDir, moduleArtifactId, wantedModules.size > 0 ? wantedModules : null)
|
|
} else if (opts.multiModulePom && opts.flat) {
|
|
log.warn('--multi-module-pom 与 --flat 互斥, 跳过 pom 生成')
|
|
// v2.3+ L3: 提示用户去掉一个 flag
|
|
ctx.addSuggestion(remindCodeGenPomConflict())
|
|
}
|
|
|
|
const skippedCount = Object.entries(counts)
|
|
.filter(([k]) => k.startsWith('__skipped:'))
|
|
.reduce((sum, [, v]) => sum + v, 0)
|
|
const generatedCount = files.length - skippedCount
|
|
if (skippedCount > 0) {
|
|
log.ok(`✓ 生成 ${generatedCount} 个文件 (跳过 ${skippedCount} 个, --module-only 过滤)`)
|
|
} else {
|
|
log.ok(`✓ 生成 ${generatedCount} 个文件`)
|
|
}
|
|
for (const [k, v] of Object.entries(counts)) {
|
|
if (k.startsWith('__skipped:')) continue
|
|
log.info(` ${k}: ${v}`)
|
|
}
|
|
if (skippedCount > 0) {
|
|
log.info(` (跳过:`)
|
|
for (const [k, v] of Object.entries(counts)) {
|
|
if (k.startsWith('__skipped:')) log.info(` ${k.replace('__skipped:', '')}: ${v}`)
|
|
}
|
|
log.info(` )`)
|
|
}
|
|
log.info(`输出到: ${outDir}`)
|
|
log.info('')
|
|
log.info('后续步骤 (按 aibridge §POM 依赖规则):')
|
|
log.info(` 1. 在 IDE 打开生成的 Java 文件, 检查 import 和 @RestController 路径 (期望 ${modulePackage}.controller.${mainClassName}Controller)`)
|
|
if (opts.separateController) {
|
|
log.info(` 2. 把目录 ${outDir} 移到 boot/${moduleArtifactId}-controller/src/main/java/${modulePackage.replace(/\./g, '/')}/`)
|
|
log.info(` 3. mvn package 编译 (boot/${moduleArtifactId}-controller)`)
|
|
} else {
|
|
log.info(` 2. 把 entity/ 移到 boot/${moduleArtifactId}-entity/, 把 biz/ 整目录 (含 controller) 移到 boot/${moduleArtifactId}-biz/`)
|
|
log.info(` 3. mvn package 编译 (boot/${moduleArtifactId}-biz)`)
|
|
}
|
|
log.info(' 4. 部署到 jnpf-admin')
|
|
log.info(` 5. 重启 JNPF 后浏览器访问 /api/${company}/${module}/... 验证`)
|
|
// Phase 3.3: --auto-menu 实际实现 (调 webapi /visualdev/Base/{formId}/Actions/Module)
|
|
if (opts.autoMenu) {
|
|
await autoMountMenu(c, formId, fullName, enCode, ctx)
|
|
}
|
|
ctx.success({ formId, enCode, module, moduleArtifactId })
|
|
} catch (e) {
|
|
ctx.fail(`form codegen 失败: ${(e as Error).message?.slice(0, 200)}`, { formId })
|
|
}
|
|
})
|
|
})
|
|
installHelpHook(cmd, {
|
|
purpose: '表单代码生成 (白皮书 5.5) — 调平台 CodePreview, 写到本地目录, 参考 aibridge CodeGenerator',
|
|
required: { '<formId>': 'form id (要先 release, state=1)' },
|
|
optional: {
|
|
'--company': '企业代码 (aibridge company_code, 默认 ssw; 模块名 = ${company}-${module}, 包名 = ${company}.${module})',
|
|
'--module': '应用代码 (aibridge app_code, 默认取 form.enCode)',
|
|
'--modulePackage': '包名 (默认 ${company}.${module}, 如 ssw.tds)',
|
|
'--description': '功能描述 (类注释)',
|
|
'--dbLinkId': '数据源 id',
|
|
'--mainClassName': '主类名 PascalCase (默认 enCode)',
|
|
'--enableFlow': '0/1',
|
|
'--out': '输出目录 (默认 ./generated/${company}-${module}/)',
|
|
// ⭐ 多模块归类 (默认开启, 对齐 aibridge ssw-{appCode} 多模块 POM 结构)
|
|
'--flat': '关闭多模块归类 (旧版兼容: 文件直接写到 outDir 根)',
|
|
// Controller 默认归 biz 模块
|
|
'--separate-controller': 'Controller 输出到独立 ${moduleArtifactId}-controller/ (旧版行为, 默认合并到 biz, 对齐 ssw-dos)',
|
|
'--multi-module-pom': '生成 4 个 pom.xml 占位 (parent + entity/biz/controller, 与 --flat 互斥)',
|
|
'--module-only <list>': '只导出指定模块 (默认 all, 或 entity/biz/controller 逗号分隔, 用于单模块编译验证)',
|
|
// ⭐ 推荐方式: JNPF 原生别名系统, 写 base_visual_alias
|
|
'--auto-alias': '从 form.tables 自动推导主表别名 (= mainClassName), JNPF 原生方式',
|
|
'--alias-file <path>': '从 JSON 文件读 alias 表',
|
|
'--alias <json>': '直接传 alias JSON 字符串',
|
|
'--auto-menu': '生成完直接挂菜单 (已实现, 走 webapi Actions/Module)',
|
|
},
|
|
example: [
|
|
// 1. 标准 ssw-{appCode} 命名 (默认 company=ssw)
|
|
'dacli form codegen <formId> --module=tds',
|
|
// 2. 自定义 company (非 ssw)
|
|
'dacli form codegen <formId> --company=abc --module=hr',
|
|
// 3. ⭐ 多模块归类 + pom (推荐: 完整 ssw-{appCode} Maven 结构)
|
|
'dacli form codegen <formId> --module=tds --auto-alias --mainClassName=tdsBilling --multi-module-pom',
|
|
// 4. ⭐ JNPF 原生别名 (消除 post-fix)
|
|
'dacli form codegen <formId> --module=tds --auto-alias --mainClassName=tdsBilling',
|
|
// 5. 从 alias JSON 文件读 (批量别名)
|
|
'dacli form codegen <formId> --module=tds --alias-file=./aliases.json',
|
|
// 6. 启用工作流
|
|
'dacli form codegen <formId> --module=tds --enable-flow=1 --auto-alias --mainClassName=tdsBilling',
|
|
],
|
|
source: {
|
|
web: 'web/.../formDesign/components/DownloadModal.vue:33-46 (dataForm 默认值) + PreviewModal.vue:56-61 (CodePreview body) + AliasModal.vue:74-100 (命名规范)',
|
|
api: 'POST /api/visualdev/Generater/{id}/Actions/CodePreview + Alias/Save (base_visual_alias)',
|
|
ref: 'docs/aibridge/docs/code-rule.md (命名规则/POM/API 路径) + jnpf/后端/.../VisualAliasEntity.java (DB 表 base_visual_alias)',
|
|
},
|
|
notes: [
|
|
'form 必须先 release (state=1), 否则 CodePreview 返空',
|
|
'默认 company=ssw (与 aibridge config.py:company_code 默认一致)',
|
|
'派生规则: moduleArtifactId=${company}-${module}, modulePackage=${company}.${module}',
|
|
'校验规则: company/module 须小写字母开头, 仅含字母/数字/下划线, 长度 2-32',
|
|
'⭐ --auto-alias: 通过 JNPF 原生 base_visual_alias 表设别名, CodePreview 直接生成符合命名规范的代码',
|
|
'--alias-file / --alias 用于批量设表/字段别名 (AliasModal.vue 等价)',
|
|
'mainClassName 默认从 enCode 推导 (snake_case → PascalCase, 丢 appCode 前缀)',
|
|
'白皮书 5.5 提到 mybatis-plus-generator 是该能力底层',
|
|
'P1-3 (2026-07-16): Controller 默认归 biz 模块, 对齐 ssw-dos 模式, 不再需要手动 cp. 用 --separate-controller 回退到旧版行为',
|
|
],
|
|
})
|
|
return cmd
|
|
}
|