低代码应用管理与代码生成闭环整合

status: propose created: 2026-05-25 complexity: 🔴复杂

1. 背景与目标

当前 Forge 的低代码与代码生成能力已经形成多条入口：

低代码应用管理：围绕业务领域、数据模型、应用搭建、预览、发布运行。
模型设计：维护 ai_lowcode_model，支持模型字段、DDL 预览和应用选择模型。
AI 表单生成 / 应用配置管理：围绕 ai_crud_config 直接生成 searchSchema/columnsSchema/editSchema/apiConfig，并支持高级 JSON 编辑和代码下载。
旧代码生成 / 表模型管理：围绕 gen_table/gen_table_column 导入数据库表、配置字段、预览代码、下载代码。

这些能力底层都服务于同一个目标：用户描述需求后，平台生成业务模型、应用页面和可运行/可二次开发的代码。但目前入口分散，业务用户需要理解“模型设计、JSON 配置、表模型、代码生成、应用发布”等多个概念，开发者也需要在 ai_crud_config 与 gen_table 两套模型之间切换。

本次目标是整合为一条应用交付主链路，并保留模型管理作为独立资产入口：

用户需求输入 → AI 业务模型自动生成 → 模型确认/设计 → 应用设计 → 预览发布 → 代码预览/下载 → 二次开发

完成后应达到：

用户侧保留“应用管理/应用开发”作为应用设计、发布和代码生成主入口，不再暴露纯 JSON 配置管理和旧表模型管理作为主要工作台。
模型管理保留现有独立入口，作为统一模型资产中心；模型可以被应用引用，也可以作为不参与应用设计的独立业务模型存在。
数据模型设计成为唯一模型资产能力，吸收旧 generator/table 的表导入、字段配置、AI Schema 生成能力。
代码生成迁移到应用管理，基于低代码应用配置、数据模型、页面设计和模板文件生成前后端代码包，保留直接下载 ZIP 的能力。
AI 表单生成迁移为“AI 应用生成”，不再以纯 JSON CRUD 配置为最终产物，而是生成低代码模型和应用草稿。
保留历史接口和旧数据的兼容读取能力，避免已发布应用和已有代码下载入口立即失效。

2. 代码现状（Research Findings）

2.1 低代码应用与模型入口

forge-admin-ui/src/views/ai/lowcode-apps.vue：低代码应用列表页，按业务领域组织应用，支持新建应用、进入搭建器、打开运行态、迁移领域、导入/导出配置、删除。
forge-admin-ui/src/views/ai/lowcode-models.vue：数据模型设计页，调用 lowcodeModelPage/detail/create/update/delete，使用 LowcodeModelDesigner 编辑 modelSchema，支持 lowcodeDdlPreview 预览建表 DDL。
forge-admin-ui/src/views/ai/lowcode-builder.vue：应用搭建器，选择领域和模型，维护应用基础信息、页面配置、预览和发布。
forge-admin-ui/src/api/lowcode-crud.js：低代码 API 已包含 app/domain/model 接口，也已经临时暴露 genTablePage/genTableColumnList/genDatasourceEnabled，说明模型设计与旧代码生成已有局部交叉。
forge/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/controller/LowcodeAppController.java：提供 /ai/lowcode/app/page、详情、草稿、预览、发布、版本、回滚、迁移领域。
forge/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/controller/LowcodeModelController.java：提供 /ai/lowcode/model/page/list/{id}、新增修改、启停、删除、校验、DDL 预览。

2.2 旧 AI CRUD 配置与纯 JSON 入口

forge-admin-ui/src/views/ai/crud-config.vue：应用配置管理页，面向 ai_crud_config，提供“高级 JSON”“AI 生成”“预览”“下载”等操作。
forge-admin-ui/src/views/ai/crud-generator.vue：AI 辅助生成页，使用流式对话生成 searchSchema/columnsSchema/editSchema/apiConfig/createTableSql，仍以纯 JSON 配置为核心产物。
forge/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/controller/AiCrudConfigController.java：提供 /ai/crud-config/page、CRUD、/render/{configKey}、/ai/generate、/ai/generateFromTable、/codegen/download/{configKey}。
forge/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/service/AiCrudConfigGenerateService.java：AI 生成服务已能解析 modelSchema/pageSchema，并通过 LowcodeRuntimeConfigBuilder 补齐运行时配置，是迁移到低代码协议的重要基础。
forge/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/controller/CrudGeneratorController.java 与 CrudGeneratorStreamService.java：提供 /ai/crud-generator/stream-generate SSE，当前请求 DTO StreamGenerateRequest 仍围绕 configKey/tableName/description/existingSearchSchema/...。

2.3 旧代码生成与表模型入口

forge-admin-ui/src/views/generator/table.vue：旧表模型管理页，调用 /generator/list 展示已导入表模型，提供列配置、代码预览、代码下载。
forge-admin-ui/src/views/generator/components/CodePreviewModal.vue：代码预览弹窗，调用 /generator/preview/{tableName}，可复用于应用代码预览。
forge-admin-ui/src/views/generator/components/ImportTableModal.vue：数据库表导入弹窗，调用 /generator/datasource/enabled、/generator/datasource/{id}/tables、/generator/importTable/{datasourceId}。
forge/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/controller/GenController.java：提供旧代码生成主接口，包括 /generator/list、/importTable、/edit、/preview/{tableName}、/download/{tableName}、/executeSql、/ai/nlToSchema、/ai/importSchema。
forge/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/domain/entity/GenTable.java 与 GenTableColumn.java：旧代码生成表模型实体，仍承载导入表结构和字段配置。
forge/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/util/VelocityUtils.java：旧代码生成模板上下文工具，围绕 GenTable/GenTableColumn 构建前后端代码所需变量。

2.4 代码下载与模板生成能力

AiCrudConfigController#downloadCode 已提供 /ai/crud-config/codegen/download/{configKey}，输出 {configKey}-code.zip。
AiCrudCodegenService#generateZip 根据 configKey 读取 AiCrudConfig，再按 AiPageTemplate.codegenType 选择 CodegenStrategy 生成 ZIP。
VelocityCodegenStrategy#generate 已能基于 AiCrudConfig 和模板生成后端 Entity/Mapper/XML/Service/Controller/DTO/Query、SQL、前端 index.vue/api.js、配置 JSON。
GenController#download 和 GenController#preview 基于 GenTable 生成旧 ZIP 和预览代码。

2.5 菜单与数据现状

forge/db/migration/V1.0.4__add_visual_lowcode_crud_builder.sql 为 ai_crud_config 增加低代码字段，并初始化低代码应用、搭建器、发布、在线 DDL 等菜单。
forge/db/migration/V1.0.9__add_lowcode_data_model.sql 新增低代码数据模型菜单和模型表能力。
forge/db/migration/V1.0.11__reparent_lowcode_menus.sql 已将低代码菜单统一挂到原“AI 代码生成/AI 低代码”目录，并将“数据模型设计”指向 /ai/lowcode-models。

2.6 发现与风险

现有 ai_crud_config 仍是运行时事实来源，不能直接删除；应用管理应继续写入它，但不再把纯 JSON 编辑暴露为主流程。
旧 GenTable 和新 LowcodeModelSchema 字段语义接近但不等价，本期不把 GenTable 作为新模型导入来源，避免引入额外适配复杂度。
代码生成模板目前依赖数据库字段元数据和 GenTableColumn，应用级代码生成若直接复用 VelocityCodegenStrategy，必须先补齐从 LowcodeModelSchema/pageSchema 到模板上下文的转换。
菜单收敛涉及权限资源变更，必须通过 Flyway 迁移脚本更新 sys_resource，并保留旧路由兼容一段时间。
AI 自动建表和代码生成涉及 DDL、权限菜单、后端代码输出，必须明确人工确认点，不能让 AI 直接执行高风险变更。

3. 功能点

3.1 信息架构整合

“应用管理/应用开发”作为应用设计、AI 创建应用、发布运行和代码输出主入口。
“模型管理/模型设计”保留现有独立入口，承载统一模型资产、数据库表导入和 AI 生成模型。
应用管理内提供模型选择、关联和快捷新建入口，但不要求所有模型都必须归属或绑定到某个应用。
generator/table 表模型管理从菜单隐藏；数据库表导入、字段初始化迁移到模型设计，代码预览/下载迁移到应用管理，不再从旧表模型页发起。
ai/crud-config 应用配置管理从菜单隐藏或仅保留开发者诊断入口，普通用户不能再新增/编辑纯 JSON 配置。
ai/crud-generator 不再作为独立“AI 表单生成”入口，能力迁移为应用管理内的“AI 新建应用/AI 优化应用”。

3.2 统一模型设计

数据模型设计成为唯一模型资产，底层使用 ai_lowcode_model.model_schema 保存。
支持从数据库表导入为低代码模型：选择数据源 → 选择表 → 解析字段 → 生成 LowcodeModelSchema → 用户确认保存。
模型设计导入不从旧 GenTable 选择，直接读取数据源对应的数据表结构；GenTable 旧数据在新流程中忽略。
支持 AI 从自然语言生成模型：输入需求描述后生成业务对象、字段、关系、字典、安全策略和表名建议。
旧字段列配置能力迁移到 LowcodeModelDesigner：字段名、列名、数据类型、长度、小数位、必填、默认值、字典、脱敏、加密、导入导出、显示规则。
旧 generator/column 的字段推荐能力迁移到模型设计器，输入当前字段列表和领域上下文后返回字段优化建议。

3.3 AI 应用生成闭环

应用管理新增“AI 生成业务系统”入口。
用户只输入完整业务需求；业务领域、数据模型和应用模板由 AI Agent 自动规划，不要求用户提前选择领域或模板。
若需求命中已有启用业务领域则复用；否则返回待确认的新领域草稿，确认后再保存。
后端按领域上下文、现有模型、字段模板、字典策略、安全策略构建 Prompt。
AI 输出低代码协议，不再以纯 JSON CRUD 配置为主产物：
- domainSuggestion
- domains[]
- models[]
- apps[]
- steps[]
- decisions[]
- appDraft（兼容旧单应用调用）
- modelSchema
- pageSchema
- ddlPreview
- generationNotes
用户确认后保存数据模型和应用草稿，进入应用设计器继续调整。
生成过程以 SSE 展示“需求理解 → 领域划分 → 模型生成 → 页面生成 → 协议校验”的可解释进度；前端展示决策摘要，不暴露不可审计的内部推理链。
支持 AI 优化现有应用：基于当前模型和页面草稿提出字段、布局、查询、列表、详情、权限、字典建议。
AI 生成失败时使用规则引擎降级，至少能从表结构或模型字段生成基础应用草稿。

3.4 应用设计与运行

应用设计器继续维护页面布局、查询条件、列表列、表单、详情、操作列、导入导出和发布配置。
应用设计器可从模型资产引入字段，模型字段变更后支持“同步到应用草稿”并显示差异。
运行时仍使用 /ai/crud-page/{configKey} 和 /ai/crud/{configKey}，不破坏已发布链接。
发布流程仍生成运行时 AiCrudConfig、版本快照、菜单资源和动态 CRUD 配置。

3.5 应用级代码预览与下载

应用管理列表和应用设计器均提供“代码预览”和“下载代码”。
代码生成源支持：
- 当前已保存草稿 DRAFT，作为默认来源
- 已发布版本 PUBLISHED
- 指定历史版本 VERSION
代码预览以文件树 + 编辑器方式展示，复用或重构 CodePreviewModal。
下载 ZIP 保留直接下载能力，文件名建议 {configKey}-code.zip。
代码生成应基于应用配置、模型协议、页面协议和模板文件生成：
- 后端 Entity / DTO / Query / Mapper / Mapper.xml / Service / ServiceImpl / Controller
- 前端 API 文件 / Vue 页面
- SQL 菜单脚本 / 字典脚本 / 可选建表脚本
- 原始低代码配置 JSON
代码生成参数可配置：Maven groupId、Java 基础包名、代码模块名、作者、是否包含 SQL、是否包含菜单资源、是否包含字典脚本、目标前端路径。
生成代码只下载，不直接写入当前仓库，不自动执行 SQL。

3.6 旧能力兼容与退场

旧 /ai/crud-config/codegen/download/{configKey} 保留兼容，内部委托新的应用级代码生成服务。
旧 /generator/preview/{tableName}、/generator/download/{tableName} 保留接口兼容，但菜单隐藏；后续版本再评估删除。
旧 ai/crud-config 页面仅允许拥有开发者权限的用户访问，用于排障和历史配置查看，不再作为新增入口。
旧 ai/crud-generator 页面隐藏菜单，入口迁移到应用管理；路由可保留跳转到新 AI 应用生成面板。
已有 GenTable 数据不删除，但不进入新模型设计导入流程；旧数据可忽略，仅保留旧接口兼容。

4. 业务规则

应用是面向应用交付的主聚合；页面、发布、运行和代码输出都围绕应用管理组织。
模型是独立业务资产，可以被一个或多个应用引用，也可以不参与应用设计。
数据模型是唯一业务模型资产；旧 GenTable 不作为导入来源，仅保留旧接口兼容或历史数据。
ai_crud_config 仍是运行时配置存储，不作为用户直接编辑的产品概念。
应用必须归属业务领域；历史未归属应用展示在“未归属”分组，允许迁移。
一个应用至少绑定一个主模型；首期代码生成只支持单表/单主模型。
主子表、左树右表、单表树形和多模型代码生成后续支持，首期不纳入生成范围。
AI 生成的模型和应用必须经过用户确认才保存；DDL 必须二次确认才允许执行。
代码生成默认使用已保存应用草稿 DRAFT，发布版本 PUBLISHED 和历史版本 VERSION 作为可选来源；不允许基于浏览器未保存状态直接下载。
代码生成包的目标包名按业务领域配置，不使用全局固定包名作为默认值。
代码 ZIP 中禁止包含真实密钥、数据库密码、Token、AK/SK。
生成 SQL 的业务内置数据 tenant_id 必须为 1，权限资源插入必须 NOT EXISTS 防重复。
字典字段必须绑定 sys_dict_type/sys_dict_data，禁止生成前端硬编码选项。
图片字段仍存储 fileId，生成前端代码必须使用 AuthImage 或现有文件访问归一化工具。
旧接口兼容期间，新增能力优先走 /ai/lowcode/**，不再扩展 /generator/** 的业务语义。

5. 数据变更

本变更优先复用现有表，减少结构变更。

操作	表名	字段/索引	说明
复用	`ai_lowcode_model`	`model_schema`	作为唯一模型资产，承载从 AI/数据库表导入后的模型协议
复用	`ai_lowcode_domain`	`domain_schema`	增加 `codegen` 领域配置，保存默认 groupId、Java 基础包名、代码模块名、前端路径等代码生成默认值
复用	`ai_crud_config`	`model_schema`, `page_schema`, `options`, `build_mode`, `publish_status`	作为低代码应用草稿和运行时配置，不再面向用户做纯 JSON 编辑
复用	`ai_crud_config_version`	现有版本字段	作为发布版本和代码生成 `VERSION` 来源
复用	`gen_table`, `gen_table_column`	全量保留	只作为旧接口兼容和历史数据，不作为新模型设计导入来源
修改	`sys_resource`	菜单/按钮资源	通过新 Flyway 脚本隐藏或重定向旧入口，新增应用级代码预览/下载/AI 生成权限
可选新增	`sys_dict_type/sys_dict_data`	`ai_prompt_usage_scene` 新场景	如现有字典缺少“应用生成/模型生成/代码生成”场景，则新增字典项

5.1 菜单迁移规则

“应用管理/应用开发”保留为主菜单，组件指向 ai/lowcode-apps。
“模型管理/模型设计”保留现有独立菜单，普通用户可继续维护不参与应用设计的模型资产。
“低代码搭建器”保留隐藏路由 /ai/lowcode-builder/:id?，通过应用管理进入。
“AI 辅助生成 / AI 表单生成”菜单隐藏或重定向到应用管理的 AI 生成面板。
“应用配置管理 / 高级 JSON”菜单隐藏，只给开发者权限可见。
“代码生成表管理”菜单隐藏，表导入迁移到模型设计。
“数据源管理”保留为开发者菜单。
“模板管理”菜单去掉；应用级代码生成继续使用后端模板文件或内置策略，不提供独立模板管理入口。

6. 接口变更

6.1 新增应用级接口

操作	接口	方法	说明
新增	`/ai/lowcode/app/ai/stream-generate`	POST SSE	从用户需求生成模型建议和应用草稿，替代旧 `/ai/crud-generator/stream-generate` 用户入口
新增	`/ai/lowcode/app/{id}/ai/refine`	POST SSE	基于已有应用草稿进行 AI 优化
新增	`/ai/lowcode/app/{id}/code/preview`	GET	基于应用草稿/发布版本预览代码文件 Map
新增	`/ai/lowcode/app/{id}/code/download`	GET	下载应用代码 ZIP
新增	`/ai/lowcode/app/{id}/code/options`	GET/PUT	查询/保存应用代码生成参数，存入 `options.codegen`

6.2 新增模型导入与迁移接口

操作	接口	方法	说明
新增	`/ai/lowcode/model/import-db-table`	POST	从数据源表结构生成并保存低代码模型
新增	`/ai/lowcode/model/preview-db-table`	POST	从数据源表结构预览模型，不保存
新增	`/ai/lowcode/model/ai/stream-generate`	POST SSE	从自然语言生成模型协议
新增	`/ai/lowcode/model/{id}/ai/recommend-fields`	POST	字段推荐/优化，迁移旧 `recommendColumns` 能力

6.3 修改现有接口

操作	接口	方法	变更内容
修改	`/ai/lowcode/app/page`	GET	增加 `sourceType`、`hasCodegen`、`modelId` 过滤；返回代码生成状态摘要
修改	`/ai/lowcode/app/draft`	POST	支持保存 `options.codegen` 和 AI 生成来源元数据
修改	`/ai/lowcode/app/{id}`	GET	返回模型快照、代码生成选项、可下载状态
修改	`/ai/lowcode/model/page`	GET	增加 `importSource`、`tableName` 过滤，展示是否由数据源表或 AI 生成

6.4 兼容但不再扩展的接口

接口	兼容策略
`/ai/crud-config/codegen/download/{configKey}`	保留，内部按 `configKey` 查应用并委托应用级代码生成；找不到低代码应用时走旧逻辑
`/ai/crud-generator/stream-generate`	保留，前端入口隐藏；后续只用于历史页面或开发者调试
`/generator/preview/{tableName}`	保留旧表模型预览
`/generator/download/{tableName}`	保留旧表模型下载
`/generator/importTable/**`	保留底层能力，但新前端从 `/ai/lowcode/model/import-db-table` 进入

7. 技术方案

7.1 后端服务分层

新增 LowcodeAiGenerateService：统一 AI 需求生成、模型生成、应用生成和应用优化。
新增 LowcodeCodegenService：应用级代码预览/下载入口，封装草稿/发布/版本来源选择。
新增 LowcodeModelImportService：从数据库表和 AI Schema 转换为 LowcodeModelSchema；不从旧 GenTable 导入。
新增 LowcodeCodegenContextBuilder：把 LowcodeModelSchema + LowcodePageSchema + AiCrudConfig 转换为模板引擎上下文，替代直接依赖 GenTableColumn。
保留 AiCrudCodegenService，但逐步改造成底层策略服务；应用级接口不直接暴露 configKey 下载。
保留 VelocityCodegenStrategy，第一期优先通过上下文适配复用模板，不重写全部模板。

7.2 前端页面整合

lowcode-apps.vue：应用管理主工作台，新增 AI 创建应用、代码预览、下载代码、选择/关联模型入口。
lowcode-builder.vue：应用设计器新增“代码输出”区域，可选择草稿/发布版本预览和下载。
lowcode-models.vue：保留为独立模型管理入口，新增从数据库表导入、AI 生成模型。
lowcode-crud.js：新增应用级 AI、代码生成、模型导入接口。
复用/迁移 CodePreviewModal.vue：改造为可接收 files 或应用 ID，避免只绑定 tableName。
复用/迁移 ImportTableModal.vue：将结果落到 ai_lowcode_model，不再只创建 gen_table。
隐藏 crud-config.vue、crud-generator.vue、generator/table.vue 普通菜单入口；路由保留兼容。

7.3 低代码协议与代码生成

代码生成源统一为：

AiCrudConfig
  ├─ modelSchema: LowcodeModelSchema
  ├─ pageSchema: LowcodePageSchema
  ├─ searchSchema / columnsSchema / editSchema / apiConfig
  ├─ dictConfig / desensitizeConfig / encryptConfig / transConfig
  └─ options.codegen

生成服务必须支持两种上下文：

运行时配置上下文：用于现有 AiCrudPage 动态运行。
代码模板上下文：用于生成可复制到业务模块的 Java/Vue/SQL 文件。

模型导入只读取数据源表结构：

数据源 → 数据库表结构
  → LowcodeModelImportService
  → LowcodeModelSchema
  → LowcodeDataModel

旧 GenTable/GenTableColumn 不进入新模型导入流程，仅保留旧接口兼容。

7.4 AI 生成流程

用户需求描述
  → 选择领域/AI模型
  → LowcodeAiGenerateService 构建 Prompt
  → AI 输出模型和应用协议
  → LowcodeSchemaValidator 校验
  → LowcodeRuntimeConfigBuilder 生成运行时配置
  → 用户确认保存模型和应用草稿
  → 进入应用设计器
  → 预览/发布/代码下载

失败降级：

AI 不可用：基于用户输入生成最小空模型草稿，引导用户手动补字段。
AI 输出 JSON 解析失败：返回可读错误和原始片段，不保存。
模型校验失败：展示字段级错误，允许用户修正后再保存。
代码生成失败：返回模板文件、字段、配置键等定位信息，不影响应用运行。

8. 影响范围

8.1 前端

forge-admin-ui/src/views/ai/lowcode-apps.vue
forge-admin-ui/src/views/ai/lowcode-builder.vue
forge-admin-ui/src/views/ai/lowcode-models.vue
forge-admin-ui/src/api/lowcode-crud.js
forge-admin-ui/src/components/lowcode-builder/**
forge-admin-ui/src/views/generator/components/CodePreviewModal.vue
forge-admin-ui/src/views/generator/components/ImportTableModal.vue
forge-admin-ui/src/views/ai/crud-config.vue
forge-admin-ui/src/views/ai/crud-generator.vue
forge-admin-ui/src/views/generator/table.vue

8.2 后端

LowcodeAppController / LowcodeAppService
LowcodeModelController / LowcodeDataModelService
LowcodeRuntimeConfigBuilder
LowcodeSchemaValidator
AiCrudCodegenService
VelocityCodegenStrategy
AiCrudConfigGenerateService
CrudGeneratorStreamService
GenController
GenTableServiceImpl
VelocityUtils

8.3 数据与权限

Flyway 菜单迁移脚本
sys_resource 菜单和按钮权限
ai_prompt_usage_scene 字典项（如需要）
旧 gen_table/gen_table_column 只读兼容与迁移

9. 风险与关注点

⚠️ 权限资源变更：菜单隐藏、按钮新增、发布菜单和代码下载权限涉及 sys_resource，必须人工审查。
⚠️ DDL 风险：AI 生成 DDL 和旧 /generator/executeSql 不能自动执行，必须二次确认。
⚠️ 代码生成安全：ZIP 不得包含真实密钥、数据库密码、Token、AK/SK。
⚠️ 兼容风险：已发布 configKey、运行时 URL 和历史代码下载接口必须可用。
⚠️ 模板风险：旧 Velocity 模板依赖 GenTableColumn，迁移时必须建立明确上下文适配，不能在模板里塞低代码 JSON 后临时解析。
⚠️ 用户认知风险：入口收敛后，旧页面跳转和提示必须明确，否则用户可能找不到原“下载代码”能力。

10. 测试策略

测试范围：
- 应用管理 AI 创建应用流程
- 模型从数据库表导入
- 旧 GenTable 数据不进入新模型导入流程
- 应用草稿预览/发布
- 应用级代码预览/下载
- 旧下载接口兼容
- 菜单权限和路由可访问性
覆盖率目标：
- 后端新增服务核心分支单元测试覆盖：成功、AI 失败、校验失败、旧数据兼容、代码生成失败。
- 前端至少覆盖 API 封装、关键转换函数、主流程手工验证。
独立 Test Spec：建议是。进入 /apply 前补充 code-copilot/changes/unified-lowcode-app-codegen/test-spec.md。

11. 已澄清事项

模型管理保留现有独立入口；模型可以不参与应用设计，应用管理只提供模型引用和快捷创建能力。
数据源管理保留为开发者菜单；模板管理菜单去掉。
应用级代码下载默认使用已保存草稿 DRAFT；发布版本 PUBLISHED 和历史版本 VERSION 作为可选项。
AI 自动生成后不自动保存；必须由用户确认后保存模型和应用草稿。
模型设计导入直接读取数据源对应的数据表，不从旧 GenTable 中选取；GenTable 表旧数据可以忽略。
代码生成包的目标包名按业务领域配置。
首期只支持单表/单主模型代码生成；主子表、左树右表、单表树形后续支持。

12. 技术决策

以低代码应用管理作为应用设计、发布和代码生成主入口，旧 ai_crud_config 和 gen_table 不再作为用户主工作台。
模型管理保留独立入口，统一承载 ai_lowcode_model 模型资产；模型不强制绑定应用。
ai_crud_config 继续作为运行时配置存储，避免重写动态 CRUD 内核。
ai_lowcode_model 成为唯一模型资产，旧 GenTable 不作为新模型导入来源。
代码生成从“表模型生成”升级为“应用配置生成”，但第一期复用 Velocity 模板和现有策略模式。
旧接口保留兼容，不在本变更中物理删除表和 Controller。
菜单变更全部通过 Flyway 脚本，禁止手改数据库。

13. 执行日志

Task	状态	实际改动文件	备注
Spec 草案	done	`code-copilot/changes/unified-lowcode-app-codegen/spec.md`	仅设计 Spec，未写实现代码

14. 审查结论

待 /review unified-lowcode-app-codegen 后填写。

15. 确认记录（HARD-GATE）

确认时间：2026-05-25
确认人：用户确认
已确认事项：
- 模型管理保留现有独立入口。
- 模型允许不参与应用设计，应用管理只引用或快捷创建模型。
- 数据源管理保留为开发者菜单，模板管理菜单去掉。
- 应用级代码下载默认使用已保存草稿，发布版本和历史版本作为可选项。
- AI 生成结果必须用户确认后保存。
- 新模型设计导入只读取数据源表结构，不从 GenTable 选择。
- 代码生成包目标包名按业务领域配置。
- 首期只支持单表/单主模型代码生成，主子表、左树右表、单表树形后续支持。
进入 /apply 前必须确认：无，本轮待澄清事项已确认。

spec.md 28 KB History Raw