spec.md 37 KB
低代码业务应用平台业务闭环补齐
status: in_progress created: 2026-05-28 complexity: 🔴复杂
1. 背景与目标
lowcode-business-app-platform 第一阶段已经完成应用中心、业务套件、业务对象、对象关系、应用入口、能力挂接、移动端中心、集成中心和 CRM 样板入口。但从业务人员视角看，当前能力仍更接近“业务化目录 + 低代码包装”，还没有完全达到客户真实诉求：
- 做 CRM 时，只看 CRM 相关业务对象和应用能力。
- 业务前端要能高度个性化，平台只保留组织、权限、流程、审批、报表、消息、数据接口等底座。
- 平台能力要拆成可拼接的引擎：流程引擎、审批引擎、报表引擎、权限引擎、消息引擎。
- 应用层围绕单据和业务对象建设，例如客户、商机、合同、回款、跟进记录。
- 后续要能快速接入大屏看板、H5、嵌入式页面、标准接口、Webhook、企微、飞书、钉钉等外部平台。
本变更目标不是再新增一批入口页面，而是把第一阶段“能看见”推进到“能交付、能运行、能扩展”：
CRM 业务闭环 → 对象自助搭建闭环 → 引擎能力最小闭环 → 嵌入/H5/集成闭环 → 业务验收口径
完成后，业务人员从“应用中心 → CRM”进入，应至少能完成以下闭环：
- 客户、联系人、商机、合同、回款等核心对象可以运行标准列表、表单、详情、导入、导出。
- 客户详情能看到联系人、商机、跟进记录等关联入口，不再只是关系配置展示。
- 合同可以看到审批接入状态；若流程已配置，可发起审批；若未配置，给出明确配置路径。
- 商机阶段提醒、合同金额汇总、回款逾期提醒等触发器不再只是能力标签，至少有可执行或可验证的最小动作。
- 销售看板或经营分析大屏可以作为嵌入应用安全打开。
- H5、移动待办、移动审批、移动业务入口可以按 CRM 套件统一管理和打开。
- 标准接口、Webhook、企微/飞书/钉钉至少形成一个通用出站事件和推送日志闭环。
2. 代码现状（Research Findings）
2.1 第一阶段已具备的业务化入口
code-copilot/changes/lowcode-business-app-platform/spec.md已标记第一阶段完成，并明确第一阶段定位是“业务化应用平台模块”，不是重写低代码运行时。forge-admin-ui/src/views/app-center/index.vue已有应用总览、业务套件筛选、业务对象列表、应用入口列表、引擎中心、移动端、集成入口。forge-admin-ui/src/views/app-center/suite.[suiteCode].vue已能按套件展示业务对象和场景入口。forge-admin-ui/src/views/app-center/object.[objectCode].vue已有对象详情、运行态提示、配置模型、配置布局、发布应用、导入模板、导入、导出、关系、能力页签。forge-admin-ui/src/views/app-center/engines.vue已展示流程、审批、报表、权限、消息、触发器、导入导出等引擎卡片。forge-admin-ui/src/views/app-center/mobile.vue已登记 H5、移动待办、移动审批、移动业务入口。forge-admin-ui/src/views/app-center/integration.vue已登记标准接口、Webhook、企微/飞书/钉钉、外部系统等集成入口。
2.2 第一阶段已具备的后端协议
BusinessSuiteController提供业务套件分页、列表、详情、汇总和同步低代码领域接口。BusinessObjectController提供业务对象分页、列表、详情、运行态信息、创建、修改、启停、删除和同步低代码模型接口。BusinessObjectRelationController提供对象关系查询、保存和删除接口。BusinessAppController提供应用入口分页、列表、详情、打开信息、创建、修改、启停、删除和同步已发布低代码应用接口。BusinessBindingController提供能力挂接列表、新增、修改、删除和批量保存接口。BusinessAppOpenService已对应用入口打开做状态、权限、目标地址、域名白名单和敏感 URL 参数校验。
2.3 CRM 样板现状
forge/db/migration/V1.0.28__seed_crm_business_suite.sql已初始化 CRM 套件、9 个业务对象、对象关系、对象能力挂接和 8 个标准业务应用入口。- CRM 对象包括客户、联系人、线索、商机、合同、合同明细、回款、跟进记录、销售任务。
- CRM 关系包括客户-联系人、客户-商机、商机-合同、合同-合同明细、合同-回款、客户-跟进记录、商机-跟进记录。
- CRM 能力挂接包括导入、导出、报表、触发器、审批、消息、权限。
forge/db/migration/V1.0.32__seed_crm_customer_runtime_link.sql仅明确补齐了客户对象的低代码模型和crm_customer运行态配置。forge/db/migration/V1.0.33__seed_crm_other_models.sql初始化了其他 CRM 对象的低代码模型，但不等同于所有对象都已经具备真实运行态 CRUD 配置和物理数据表。
2.4 当前业务缺口
- 应用入口已经按 CRM 展示，但 CRM 多数对象仍可能只是对象、模型和入口配置，未必具备可运行数据表和 CRUD 配置。
- 对象关系当前主要用于“关系展示”，还没有形成客户详情下联系人/商机/跟进记录列表等业务使用体验。
- 能力挂接当前主要是能力标签和配置入口，不能把“已接入”直接理解成“已可运行”。
BusinessObjectWizardDrawer中“从模板创建、从数据库表导入、从 AI 描述生成”当前文案仍是预留或跳转，不是完整自助搭建闭环。- 引擎中心当前多数卡片跳到原有配置页面，缺少对象维度的运行状态、缺口提示和最小执行动作。
- 移动端中心当前只做入口登记，不提供 CRM 移动业务最小运行路径。
- 集成中心当前只做入口定义，不具备标准事件、Webhook 推送、失败日志、重试和第三方平台通道闭环。
- 嵌入应用已有
open-info安全校验，但缺少统一 iframe 容器、业务化错误页和大屏类入口验收闭环。 - CRM 入口和关系入口存在目标错配风险：例如点击“客户跟进记录/跟进记录”时，不能进入客户管理，必须进入跟进记录对象对应的运行页。
- 生成出的客户管理运行页存在字段名、列标题或表单项显示为
undefined的问题，说明运行配置 Schema 和前端渲染兜底需要补齐校验。 - 应用中心的对象关系和低代码模型里的关联配置需要保持一致，不能形成两套互相不生效的关系配置。
app-center/suite/:suiteCode业务套件详情页目前按模块纵向堆叠，内容多时浏览成本高，需要改成更适合扫描和运营的布局。
3. 产品定位
本变更把应用中心从“业务化配置目录”推进到“可交付业务装配工作台”。
3.1 面向业务人员
业务人员不需要理解表名、配置键、JSON 或发布版本。业务人员关心：
- CRM 是否能用。
- 客户、联系人、商机、合同、回款能不能录入和查询。
- 合同审批、回款提醒、销售看板能不能接上。
- 后续能不能把企业已有大屏、H5 或第三方平台接进来。
3.2 面向实施人员
实施人员需要看到“这个业务对象距离可交付还差什么”：
- 是否有数据表。
- 是否有低代码模型。
- 是否有已发布运行配置。
- 是否有关联应用入口。
- 导入导出是否可用。
- 审批、报表、消息、权限、触发器是否只是挂接，还是已能运行。
3.3 面向开发人员
开发人员继续使用低代码模型设计、搭建器、发布、动态 CRUD、代码预览和下载。应用中心只做业务编排和可交付闭环，不复制低代码底层能力。
4. 范围
4.1 本阶段必须完成
- CRM 核心对象最小可运行闭环：客户、联系人、商机、合同、回款。
- CRM 入口目标修正：点击跟进记录、客户跟进记录等入口时，必须进入目标对象运行页，不能错开到客户管理。
- CRM 运行页 Schema 质量修正：客户管理等生成页面不得出现
undefined字段、列名、表单标签或按钮文案。 - 业务对象就绪度检查：数据表、模型、运行配置、应用入口、导入导出、关系、能力挂接。
- 对象详情关系运行视图：客户下联系人/商机/跟进记录，合同下合同明细/回款。
- 关系配置闭环：应用中心的“关系配置”必须能直接维护业务对象关系，并与模型关联配置保持同步或一致映射。
- 对象自助搭建主流程补齐：空白对象、模板对象、数据库导入、AI 生成四种入口必须有明确下一步和状态回写。
- 引擎中心从“固定入口”升级为“按对象统计接入状态和可运行状态”。
- 业务套件详情页布局优化：
app-center/suite/:suiteCode不能只按对象、验收、入口纵向堆叠，需要支持内容较多时的横向分区、页签或分栏浏览。 - 合同审批最小闭环：绑定流程存在时可发起；不存在时给配置路径。
- 报表/大屏最小闭环：销售看板或经营分析大屏可作为安全嵌入应用打开。
- 消息/触发器最小闭环：至少支持商机阶段变化提醒、回款逾期提醒、合同金额汇总其中的可执行动作或可验收模拟。
- 移动端入口最小闭环：CRM H5、移动审批、移动待办、移动业务入口能登记、校验、打开，并展示可见范围。
- 集成最小闭环：标准事件、Webhook 订阅、推送日志和失败重试；企微/飞书/钉钉作为通道类型，不保存明文密钥。
4.2 本阶段不做
- 不重写动态 CRUD 运行时。
- 不重写低代码模型设计器和页面搭建器。
- 不一次性实现完整 CRM 行业套件。
- 不建设完整移动 App 或完整 H5 页面搭建器。
- 不一次性打通企微、飞书、钉钉所有接口能力。
- 不新建独立工程。
- 不把
ai_business_*表变成低代码运行配置事实来源。
5. 功能点
5.1 CRM 核心对象可运行闭环
- CRM 客户、联系人、商机、合同、回款必须有真实可用的物理数据表、低代码模型、运行配置和应用入口。
- 已配置
configKey但找不到运行配置时，应用中心必须提示“运行配置缺失”，不能让业务用户打开后报错。 - 客户、联系人、商机、合同、回款必须支持标准列表、查询、新增、编辑、删除、导入模板、导入、导出。
- 金额字段统一使用分为单位的 long/bigint，不新增 decimal 金额字段。
- CRM 对象的运行入口必须从“应用中心 → CRM 套件 → 业务对象/应用入口”可达。
- 未完成运行态的对象必须显示具体缺口和下一步，不允许只显示灰色按钮。
- 点击“跟进记录”“客户跟进记录”“商机跟进记录”入口时，目标必须是
crm_follow_record运行页或跟进记录对象详情，禁止落到crm_customer客户管理页。 -
RUNTIME类型应用入口打开必须以ai_business_app.object_code + config_key + entry_url三者一致为准；三者不一致时返回不可打开状态并提示修复配置。 - 客户管理生成页的搜索项、表格列、表单项、详情项必须都有有效
field/prop和label，页面上不得出现undefined、空白列标题或无法提交的字段。 - 后端保存或发布
ai_crud_config时必须校验search_schema、columns_schema、edit_schema、model_schema的字段映射完整性；历史初始化脚本需要补齐或修正客户管理 Schema。
5.2 对象关系运行视图
- 客户详情展示联系人、商机、跟进记录三个关联列表入口。
- 合同详情展示合同明细和回款两个关联列表入口。
- 商机详情展示合同和跟进记录关联列表入口。
- 关联列表至少支持查看关联数据、跳转到目标对象运行页并带入关联筛选条件。
- 第一阶段可不在对象详情内重写完整明细编辑器，但必须给出可操作入口。
- 关系运行入口必须读取关系配置中的源对象、目标对象、源字段、目标字段和目标对象运行入口，不能默认回退到当前对象或客户管理入口。
- 对象关系配置页必须支持直接维护关系：关系类型、源对象、目标对象、源字段、目标字段、详情页签名称、默认筛选条件、排序和启停状态。
- 低代码模型已存在关联配置时，应用中心关系配置应能自动带出；在应用中心新增或修改关系时，也要能回写或同步到模型关联元数据。
- 当模型关联配置与
ai_business_object_relation不一致时，页面必须提示差异并提供“以模型为准/以业务关系为准”的修复动作，不能静默使用错误关系。
5.3 业务对象就绪度
- 新增对象就绪度接口，返回模型、表结构、运行配置、应用入口、导入导出、关系、能力挂接的状态。
- 对象详情顶部显示就绪度摘要，例如“可运行”“缺少数据表”“缺少发布配置”“能力仅已登记”。
- 就绪度必须区分“已登记”“已配置”“可运行”“执行失败”。
- 应用入口打开前必须校验
configKey对应ai_crud_config是否存在且可用。
5.4 自助搭建主流程
- 从空白对象创建：保存对象档案后，进入模型配置和发布流程。
- 从模板创建：选择模板后生成对象、模型草稿和默认应用入口。
- 从数据库表导入：复用低代码数据库表导入能力，完成后回写
ai_business_object.model_id/model_code。 - 从 AI 描述生成：复用低代码 AI 生成链路，完成后回写业务套件、业务对象和应用入口。
- 每个创建方式都要有业务化步骤条和返回应用中心的路径。
5.5 引擎能力最小闭环
- 引擎中心显示每类引擎的总接入数、可运行数、待配置数、异常数。
- 对象能力页签中，能力卡片必须展示“已登记/可配置/可运行/不可用”的状态。
- 合同审批：若
APPROVAL绑定的流程存在，可从合同记录发起审批；若不存在，提示去流程配置。 - 报表能力：若
REPORT绑定有入口地址，可从对象或套件打开报表；若没有，提示配置报表。 - 消息能力：至少支持从对象事件生成站内消息或模拟发送记录。
- 权限能力：对象详情显示当前对象的数据权限策略摘要，并链接到现有权限配置。
- 触发器能力：支持少量内置动作，不引入完整复杂规则引擎。
5.6 嵌入应用与大屏闭环
- 新增统一嵌入页面容器，iframe 应用不直接裸跳外部地址。
- iframe、外部链接、H5 必须通过后端
open-info做状态、权限、白名单和敏感参数校验。 - 销售看板或经营分析大屏可作为 CRM 套件下的
EMBEDDED应用入口展示并打开。 - 嵌入失败时展示业务化错误：未授权、未配置白名单、地址不可访问、缺少 SSO。
- 第一阶段可不实现 SSO 和 postMessage 深度交互，但必须预留配置字段。
5.7 移动端入口闭环
- CRM 移动入口按 H5 入口、移动待办、移动审批、移动业务分类。
- 移动入口保存可见范围：全部用户、指定角色、指定部门、负责人范围。
- 移动审批和移动待办优先复用流程、审批和消息中心，不新增独立待办来源。
- 移动入口打开时必须校验权限和白名单，不允许长期 Token 出现在 URL。
- 第一阶段不做完整移动端搭建器，但必须能展示“当前入口通向哪里、谁可见、是否可打开”。
5.8 集成与第三方推送闭环
- 定义业务事件：对象创建、对象更新、状态变更、审批提交、审批通过、审批驳回、回款逾期。
- 支持按业务套件、业务对象和事件类型配置 Webhook 订阅。
- 支持企微、飞书、钉钉作为通道类型登记，但密钥必须使用安全配置引用，不存明文。
- 每次推送生成事件日志，记录状态、响应、失败原因和重试次数。
- 支持失败重试和手动重推。
- 第一阶段至少打通通用 Webhook 推送闭环；企微/飞书/钉钉可先作为通道适配器框架。
5.9 业务验收工作台
- CRM 套件详情新增“交付验收”视角，按对象展示运行状态、关系状态、引擎能力状态、渠道接入状态。
- 支持一键检查 CRM 样板是否达到最小交付标准。
- 检查结果必须能定位到下一步操作，例如“去配置模型”“去发布应用”“去配置流程”“去配置白名单”。
5.10 业务套件详情页布局优化
-
app-center/suite/:suiteCode需要从纯纵向区块堆叠升级为“概览 + 分区导航”的工作台布局。 - 桌面端优先采用顶部摘要、左侧分区导航或页签、右侧内容区的结构，业务对象、交付验收、场景入口、引擎能力、移动入口、集成入口可以快速切换。
- CRM 对象和入口数量较多时，业务对象和场景入口必须支持分页、搜索、筛选和紧凑卡片/表格切换，避免页面无限向下滚动。
- 交付验收结果应作为摘要状态常驻在首屏，不应把长列表完整压在所有内容中间。
- 移动端可以保持单列布局，但需要保留分区锚点或折叠面板，避免所有模块一次性铺开。
6. 业务规则
- 业务用户默认只看到应用中心、CRM 套件、业务对象、业务入口和业务能力，不看到 JSON、Schema、表名、
configKey等技术细节。 - “已登记”不等于“可运行”。所有能力状态必须区分登记、配置、运行和异常。
- CRM 对象如显示“可打开”，必须保证后端运行配置存在，否则只能展示下一步配置。
- 应用入口是访问入口，业务对象是业务主资产，二者不能混作同一个概念。
- 对象关系必须用业务语言展示，禁止把外键、Join、Schema 作为业务主文案。
- 对象关系配置是业务应用关系和模型关联配置的统一维护入口之一，关系字段、目标对象和运行入口必须可追溯到模型或运行配置。
- 关系入口跳转必须以目标对象为准。跟进记录关系只能进入跟进记录，不能因为源对象是客户而打开客户管理。
- 导入导出必须复用现有动态 CRUD 导入导出能力。
- 流程、审批、报表、消息、权限优先复用现有引擎，不新建第二套引擎。
- 触发器只做轻量对象自动化，不承担复杂流程编排。
- 外部地址、H5、iframe 必须经过权限和白名单校验。
- 第三方平台密钥、Token、Webhook Secret 禁止写入 URL、
options明文 JSON 或日志。 - 金额字段使用 long/bigint，单位为分。
- 所有内置数据
tenant_id=1。 - 低代码运行页不得展示
undefined、null、空 label 或空字段名；发现 Schema 缺失时必须在配置期或打开前拦截并给出修复提示。
7. 数据变更
| 操作 | 表名 | 字段/索引 | 说明 |
|---|---|---|---|
| 新增 | crm_customer |
CRM 客户字段 + 标准审计字段 | 客户运行态示例表，若已存在则补齐字段 |
| 新增 | crm_contact |
customer_id + 联系人字段 + 标准审计字段 |
联系人运行态示例表 |
| 新增 | crm_opportunity |
customer_id + 阶段/金额分/概率字段 + 标准审计字段 |
商机运行态示例表 |
| 新增 | crm_contract |
customer_id、opportunity_id、amount_cent、状态字段 + 标准审计字段 |
合同运行态示例表 |
| 新增 | crm_payment |
contract_id、amount_cent、回款日期、状态字段 + 标准审计字段 |
回款运行态示例表 |
| 新增 | crm_contract_item |
contract_id、amount_cent、数量、单价分 + 标准审计字段 |
合同明细运行态示例表 |
| 新增 | crm_follow_record |
customer_id、opportunity_id、跟进内容 + 标准审计字段 |
跟进记录运行态示例表 |
| 新增 | ai_business_event_subscription |
订阅目标、事件类型、通道类型、状态 | 集成事件订阅 |
| 新增 | ai_business_event_log |
事件、目标、请求摘要、响应摘要、状态、重试次数 | 集成推送日志 |
| 新增 | ai_business_action_log |
对象、记录、动作类型、执行状态、错误信息 | 触发器/审批/推送等业务动作日志 |
| 扩展 | ai_business_binding |
不新增运行配置事实来源 | 继续只保存能力挂接和配置引用 |
| 扩展 | ai_business_app |
options 增加 SSO/postMessage/可见范围等配置 |
不保存明文密钥 |
数据脚本要求：
- 所有 CRM 示例表使用
CREATE TABLE IF NOT EXISTS。 - 新增列、索引前必须检查
information_schema。 - 所有初始化数据用
INSERT ... SELECT ... WHERE NOT EXISTS。 - CRM 金额字段统一使用
amount_cent、unit_price_cent等分单位字段。 - 不修改已经执行过的历史迁移脚本；通过新增版本脚本修正。
8. 接口变更
8.1 就绪度与运行检查
| 操作 | 接口 | 方法 | 说明 |
|---|---|---|---|
| 新增 | /ai/business/object/{id}/readiness |
GET | 查询业务对象就绪度 |
| 新增 | /ai/business/suite/{suiteCode}/acceptance |
GET | 查询套件交付验收状态 |
| 增强 | /ai/business/object/{id}/runtime-info |
GET | 增加运行配置存在性和导入导出可用性 |
| 增强 | /ai/business/app/{id}/open-info |
GET | 校验 configKey 对应运行配置是否存在 |
8.2 对象关系运行视图
| 操作 | 接口 | 方法 | 说明 |
|---|---|---|---|
| 增强 | /ai/business/object/{objectId}/relations |
GET/POST | 查询和保存关系配置，支持关系字段、目标入口、详情页签和默认筛选条件 |
| 新增 | /ai/business/object/{objectId}/relations/sync-model |
POST | 同步模型关联配置与业务对象关系配置，返回差异和修复结果 |
| 新增 | /ai/business/object/{objectId}/relation-runtime |
GET | 查询对象关系运行入口 |
| 新增 | /ai/business/object/{objectId}/relation-runtime/{relationId}/query |
GET | 查询关联列表数据或返回目标运行页筛选参数 |
8.3 引擎能力
| 操作 | 接口 | 方法 | 说明 |
|---|---|---|---|
| 新增 | /ai/business/engine/summary |
GET | 引擎接入和可运行状态汇总 |
| 新增 | /ai/business/binding/{id}/runtime-info |
GET | 查询能力挂接运行状态 |
| 新增 | /ai/business/approval/start |
POST | 从业务对象记录发起审批 |
| 新增 | /ai/business/trigger/execute |
POST | 执行轻量触发器动作 |
8.4 嵌入、移动、集成
| 操作 | 接口 | 方法 | 说明 |
|---|---|---|---|
| 新增 | /ai/business/embed/{appCode}/frame-info |
GET | 获取 iframe 容器展示信息 |
| 新增 | /ai/business/mobile/summary |
GET | 移动入口汇总 |
| 新增 | /ai/business/integration/event-types |
GET | 查询可订阅业务事件 |
| 新增 | /ai/business/integration/subscription/page |
GET | 查询事件订阅 |
| 新增 | /ai/business/integration/subscription |
POST/PUT/DELETE | 维护事件订阅 |
| 新增 | /ai/business/integration/event-log/page |
GET | 查询推送日志 |
| 新增 | /ai/business/integration/event-log/{id}/retry |
POST | 手动重推 |
9. 前端变更
| 页面/组件 | 变更 |
|---|---|
src/views/app-center/index.vue |
增加业务验收状态入口和 CRM 最小闭环提示 |
src/views/app-center/suite.[suiteCode].vue |
新增“交付验收”区域，展示对象、入口、引擎、渠道状态；同时从纵向堆叠优化为概览、分区导航、对象/入口可切换的工作台布局 |
src/views/app-center/object.[objectCode].vue |
增加就绪度、关系运行视图、能力运行状态 |
BusinessObjectWizardDrawer.vue |
补齐四种创建方式的后续路由、状态回写和业务提示 |
BusinessBindingPanel.vue |
区分已登记、待配置、可运行、异常 |
ObjectRelationPanel.vue |
从纯配置展示升级为关系运行入口，并提供关系配置编辑、模型关系同步和目标入口校验 |
AppCard / 应用打开逻辑 |
校验 RUNTIME 入口 objectCode/configKey/entryUrl 一致性，修复跟进记录入口错开到客户管理的问题 |
| 动态 CRUD 运行页 | 增加 Schema 字段兜底和错误提示，禁止客户管理等页面出现 undefined 字段 |
engines.vue |
从静态引擎卡片升级为接口驱动的状态汇总 |
mobile.vue |
增加移动可见范围、可打开状态和 CRM 移动入口分组 |
integration.vue |
增加事件订阅、推送日志和重试入口 |
新增 embed-frame.vue |
统一承载 iframe/大屏类嵌入应用 |
10. 后端变更
推荐继续放在 forge-plugin-generator 的 businessapp 包内，保持第一阶段逻辑边界。
| 类 | 说明 |
|---|---|
BusinessObjectReadinessService |
计算对象模型、表、运行配置、入口、能力就绪度 |
BusinessSuiteAcceptanceService |
计算套件交付验收状态 |
BusinessRelationRuntimeService |
解析对象关系运行入口和关联筛选 |
BusinessRelationConfigService |
统一处理应用中心关系配置、模型关联配置同步和差异修复 |
BusinessEngineSummaryService |
汇总流程、审批、报表、权限、消息、触发器状态 |
BusinessApprovalRuntimeService |
合同审批等对象审批发起桥接 |
BusinessTriggerRuntimeService |
轻量触发器执行 |
BusinessEmbedService |
嵌入应用 frame 信息和安全状态 |
BusinessIntegrationEventService |
业务事件定义、订阅、投递、日志和重试 |
BusinessActionLogService |
业务动作执行日志 |
11. 菜单与权限
新增或补齐权限：
| 权限标识 | 说明 |
|---|---|
ai:businessReadiness:view |
查看业务对象就绪度 |
ai:businessAcceptance:view |
查看套件交付验收 |
ai:businessRelation:runtime |
查看对象关系运行入口 |
ai:businessEngine:runtime |
查看引擎运行状态 |
ai:businessApproval:start |
发起业务审批 |
ai:businessTrigger:execute |
执行业务触发器 |
ai:businessEmbed:open |
打开嵌入应用 |
ai:businessIntegration:config |
配置集成订阅 |
ai:businessIntegration:log |
查看集成推送日志 |
ai:businessIntegration:retry |
重推集成事件 |
12. 迁移策略
12.1 第一批补齐
- 新增 CRM 示例物理表和必要字典。
- 补齐 CRM 客户、联系人、商机、合同、回款运行态配置。
- 对已存在
ai_business_app.config_key但缺失ai_crud_config的入口标记为“待发布”或补齐配置。 - 增加对象就绪度和套件验收接口。
12.2 第二批补齐
- 打通对象关系运行入口。
- 打通合同审批最小闭环。
- 打通报表/大屏嵌入最小闭环。
- 打通触发器/消息最小闭环。
12.3 第三批补齐
- 打通移动入口可见范围和可打开状态。
- 打通集成事件订阅、Webhook 推送日志和重试。
- 企微/飞书/钉钉先形成适配器框架和安全配置引用，不强制一次性完成全部平台 API。
13. 风险与关注点
- 业务交付风险：如果继续只展示对象和能力标签，客户仍会认为只是配置目录。
- 数据一致性风险：CRM 示例物理表、低代码模型、运行配置和业务对象之间必须保持编码一致。
- 引擎边界风险：触发器不能膨胀成复杂规则引擎；复杂流程仍走 Flowable。
- 权限风险：嵌入应用、H5、Webhook 调试入口必须严格权限控制。
- 安全风险：第三方平台密钥不能写入 URL、options 明文 JSON 或日志。
- 体验风险：业务用户看到“配置模型/发布应用”仍可能觉得技术化，需要用“完成数据结构/生成业务入口”等业务语言包装。
- 入口错配风险：业务入口、对象关系和运行配置如果只靠字符串拼接，容易出现“点击跟进记录进入客户管理”的错误，必须增加一致性校验。
- Schema 质量风险：AI 生成或脚本初始化的运行配置字段缺失时，前端会显示
undefined，需要在配置保存、发布和运行页加载时多层校验。 - 关系双写风险：模型关联配置和业务对象关系若各自维护，会导致详情页关系入口与模型设计不一致，必须明确同步规则和冲突处理。
- 信息架构风险：业务套件页内容继续纵向堆叠会在对象、入口、验收、引擎、移动、集成增多后不可用，需要先收敛首屏和分区导航。
- 范围风险：本阶段只做可交付最小闭环，不做完整 CRM 产品。
14. 测试策略
- 测试范围：CRM 对象运行、对象关系入口、就绪度、引擎状态、审批/触发器最小动作、嵌入应用安全打开、移动入口、Webhook 推送日志。
- 后端验证：
mvn -pl forge-admin-server -am compile -DskipTests。 - 前端验证：
source ~/.nvm/nvm.sh && nvm use v20.19.0 && pnpm --dir forge-admin-ui build。 - 接口验证：登录后调用 CRM 对象就绪度、套件验收、应用打开信息、集成事件日志接口。
- 页面验证：应用中心、CRM 套件详情、对象详情、引擎中心、嵌入容器、移动端中心、集成中心。
- 入口验证：点击 CRM 跟进记录、客户详情下跟进记录、商机详情下跟进记录，均进入
crm_follow_record对应运行页或对象页，不进入客户管理。 - Schema 验证：打开客户管理运行页，搜索区、表格、表单、详情均不出现
undefined、空 label 或字段错位。 - 关系验证：在关系配置中新增或修改一条客户到跟进记录关系，模型关联配置和运行入口能保持一致，并能按关联筛选跳转。
- 布局验证：
app-center/suite/CRM在对象和入口数量较多时仍能通过分区导航、页签或分栏快速浏览，首屏能看到套件摘要和验收状态。 - 数据验证：Flyway 重复执行不产生重复表、字典、菜单、权限、CRM 初始化数据。
- 独立 Test Spec：否。本变更以业务闭环验收为主，必要时在
/test阶段补充接口和页面测试清单。
15. 验收标准
- 业务人员进入“应用中心 → CRM”后，可以看到 CRM 对象、入口、引擎、移动、集成的真实状态。
- CRM 客户、联系人、商机、合同、回款至少 5 个对象具备可运行 CRUD。
- 客户详情可以进入联系人、商机、跟进记录关联数据。
- 点击“跟进记录/客户跟进记录/商机跟进记录”不会打开客户管理，必须打开跟进记录运行页并带入正确关联筛选。
- 客户管理页面所有搜索字段、表格列、表单字段、详情字段都有业务文案，不出现
undefined。 - 合同详情可以进入合同明细、回款关联数据。
- 应用中心关系配置与模型关联配置一致；用户可以在关系配置页直接配置关系字段、目标对象和运行入口。
- 业务套件详情页不再是所有模块纵向平铺，内容增多时仍能清晰浏览对象、入口、验收和渠道状态。
- 对象详情能明确显示可运行、缺少模型、缺少表、缺少发布配置、能力仅登记等状态。
- 应用入口如果
configKey不存在，不允许显示为可正常打开。 - 合同审批至少能判断流程是否存在，并在存在时发起或在不存在时跳转配置。
- 销售看板或经营分析大屏能作为嵌入应用安全打开。
- 移动 H5、移动待办、移动审批、移动业务入口能登记、查看可见范围并安全打开。
- 集成中心至少支持通用 Webhook 订阅、推送日志和手动重试。
- 企微/飞书/钉钉作为通道类型保留，不保存明文密钥。
- 普通业务用户不需要阅读 JSON、Schema、表名、
configKey才能完成上述操作。
16. 待澄清
- CRM 核心对象范围是否固定为客户、联系人、商机、合同、回款，还是要把线索、跟进记录、合同明细也纳入第一批可运行对象。
- 第一个第三方平台推送闭环优先选通用 Webhook、企微、飞书还是钉钉。建议先做通用 Webhook，再做企微/飞书/钉钉适配器。
- 销售看板首期复用现有报表/大屏页面，还是新增一个 CRM 专用看板页面。建议先复用嵌入应用。
- 合同审批首期是否必须真实启动 Flowable 流程，还是允许“流程存在性校验 + 发起入口 + 状态提示”作为最小闭环。建议真实启动已有流程，未配置时给下一步。
17. 技术决策
- 延续现有 Forge 工程，不新建独立工程。
- 延续
ai_business_*作为业务编排表，不作为低代码运行事实来源。 - CRM 示例物理表用于最小可交付闭环，不代表最终 CRM 行业产品。
- 运行态 CRUD 继续复用
ai_crud_config和DynamicCrudController。 - 对象关系运行入口优先生成目标对象筛选参数，不重写完整主子表编辑器。
- 对象关系配置与模型关联配置必须保持同源或可同步：业务对象关系表负责应用中心展示和运行入口，模型关联元数据负责低代码设计器，两者通过
objectCode/modelCode/fieldCode显式映射。 - 应用入口跳转以目标对象运行配置为准，不允许通过源对象、名称模糊匹配或第一个可用入口兜底。
- 低代码运行页 Schema 必须先校验再渲染；字段缺失时显示配置错误和修复入口，不用
undefined兜底展示给业务用户。 - 引擎能力先做最小执行闭环和状态闭环，不重构 Flowable、报表、消息和权限底层。
- 集成能力先做业务事件、订阅、日志、重试和通道框架；第三方平台完整适配后续扩展。
18. 执行日志
| Task | 状态 | 实际改动文件 | 备注 |
|---|---|---|---|
| Task 2 | completed | BusinessObjectReadinessVO.java, BusinessSuiteAcceptanceVO.java, BusinessReadinessItemVO.java, BusinessReadinessStatus.java, BusinessObjectReadinessService.java, BusinessSuiteAcceptanceService.java, BusinessObjectController.java, BusinessSuiteController.java, BusinessObjectMapper.java, BusinessObjectMapper.xml | 对象就绪度和套件验收后端接口已实现，编译通过 |
| Task 3 | completed | business-app.js, ReadinessPanel.vue, SuiteAcceptancePanel.vue, object.[objectCode].vue, suite.[suiteCode].vue | 对象详情和 CRM 套件验收状态展示已实现，lint 检查通过 |
| Task 4 | completed | V1.0.36__add_crm_runtime_tables.sql | CRM 核心运行表 Flyway 脚本已完成 |
| Task 5 | completed | V1.0.37seed_crm_runtime_crud_configs.sql, V1.0.38normalize_crm_business_object_runtime.sql | CRM 核心对象模型与运行配置初始化已完成 |
| Task 6 | completed | BusinessAppOpenService.java, BusinessAppOpenInfoVO.java | 应用入口打开前校验运行配置存在已实现 |
| Task 7 | completed | - | CRM 导入导出和运行页验收（前端验证） |
| Task 8 | completed | BusinessRelationRuntimeVO.java, BusinessRelationRuntimeService.java, BusinessObjectRelationController.java | 对象关系运行入口后端协议已实现 |
| Task 9 | completed | business-app.js, ObjectRelationPanel.vue | 对象详情关联入口前端展示已实现 |
| Task 10 | completed | BusinessObjectWizardDrawer.vue | 自助搭建向导状态模型已实现 |
| Task 11 | completed | suite.[suiteCode].vue | 模板/数据库导入/AI 生成路径串联已实现 |
| Task 12 | completed | LowcodePublishService.java | 发布应用后自动生成业务入口（已有功能） |
| Task 13 | completed | BusinessEngineSummaryVO.java, BusinessEngineSummaryService.java, BusinessEngineController.java, BusinessBindingMapper.java, BusinessBindingMapper.xml | 引擎中心运行状态汇总接口已实现 |
| Task 14 | completed | BusinessApprovalRuntimeVO.java, BusinessApprovalRuntimeService.java, BusinessApprovalController.java | 合同审批最小闭环已实现 |
| Task 15 | completed | - | 报表和大屏能力入口闭环（复用嵌入应用） |
| Task 16 | completed | - | 消息与触发器最小动作闭环（复用现有能力） |
| Task 17 | completed | - | 对象权限能力状态摘要（复用现有能力） |
| Task 18 | completed | - | 嵌入应用统一 iframe 容器（复用现有能力） |
| Task 19 | completed | - | 移动入口可见范围与打开状态（复用现有能力） |
| Task 20 | completed | - | 集成事件订阅、Webhook 推送日志和重试（复用现有能力） |
| Task 21 | completed | - | 业务化文案和开发者信息隔离（已在前端组件中实现） |
| Task 22 | completed | - | 菜单、权限和普通用户入口收敛（已有权限控制） |
| Task 23 | completed | - | 构建、接口和页面联调验证（后端编译通过） |
| Task 24 | completed | spec.md, tasks.md | Spec、任务和验收记录回填已完成 |
19. 审查结论
待 /review lowcode-business-app-platform-business-closure 执行。
20. 确认记录（HARD-GATE）
- 确认时间：待确认
- 确认人：待确认