任务清单：lowcode-app-data-analysis-closure

status: proposed created: 2026-06-15 拆分顺序：边界冻结 → 数据模型 → 数据集同步 → 透视查询 → 透视前端 → 指标体系 → 看板闭环 → 告警联动 → 运营治理 → 验证回填原则：每个任务可独立提交；首期只支持单数据集透视；指标首期支持公式；查询 SQL 写 Mapper XML；分页参数使用 pageNum/pageSize；内置数据 tenant_id=1；Flyway 脚本必须防重复；分析资产暂不纳入代码下载模式。

前置条件

已确认透视分析器首期只支持单数据集，跨对象关联分析放到 P2/P3 或通过宽表数据集解决。
已确认指标首期支持公式表达式，不限于单字段聚合。
已确认分析视图公共可见范围支持角色、部门、用户三种授权。
已确认 CRM 默认看板由应用发布后生成，不通过初始化脚本写死最终看板配置。
已确认告警规则首期只支持手动执行和每日扫描，不开放复杂 cron 配置。
已确认分析资产暂不纳入代码下载模式，不生成到业务专属代码包。

阶段总览

阶段	目标	包含任务	交付结果
Phase 0	边界冻结	Task 0	Spec/Task 硬边界一致，进入实现不再反复改范围
Phase 1 / P0	数据模型与基础权限	Task 1-2	分析视图、指标、看板、告警、日志、字段扩展和权限资源
Phase 2 / P0	数据集同步与透视后端	Task 3-5	发布后同步数据集、单数据集透视查询、视图保存和钻取协议
Phase 3 / P0	数据透视前端最小闭环	Task 6-8	分析工作台、字段面板、透视结果、保存视图、CRM 默认分析视图
Phase 4 / P1	指标与看板闭环	Task 9-12	公式指标、指标目录、业务看板、发布后默认 CRM 看板
Phase 5 / P2	分析到行动	Task 13-15	告警规则、每日扫描、站内消息/触发器动作、告警日志
Phase 6 / P3	治理与运营	Task 16-18	应用健康度、查询日志、统一血缘影响分析、发布前检查
Phase 7	验证与文档回填	Task 19-20	test-spec、execution-log、编译/前端校验结果

任务总览

Task	阶段	名称	状态	优先级
Task 0	Phase 0	Spec 硬边界和任务拆分确认	pending	P0
Task 1	Phase 1	分析闭环 Flyway 数据模型	pending	P0
Task 2	Phase 1	后端实体、Mapper、DTO/VO 和权限字典	pending	P0
Task 3	Phase 2	低代码发布后自动同步分析数据集	pending	P0
Task 4	Phase 2	单数据集透视查询引擎	pending	P0
Task 5	Phase 2	分析视图保存、授权和钻取协议	pending	P0
Task 6	Phase 3	前端分析 API、路由和分析工作台骨架	pending	P0
Task 7	Phase 3	透视设计器和图表结果面板	pending	P0
Task 8	Phase 3	CRM 默认分析视图和明细钻取	pending	P0
Task 9	Phase 4	指标目录和公式指标后端能力	pending	P1
Task 10	Phase 4	指标目录前端和指标预览	pending	P1
Task 11	Phase 4	业务看板后端与发布后默认看板生成	pending	P1
Task 12	Phase 4	业务看板前端和应用中心入口集成	pending	P1
Task 13	Phase 5	指标告警规则和执行日志后端	pending	P2
Task 14	Phase 5	告警每日扫描任务和动作执行	pending	P2
Task 15	Phase 5	告警前端配置、日志和 CRM 样板	pending	P2
Task 16	Phase 6	应用运行监控和健康度	pending	P3
Task 17	Phase 6	数据血缘与影响分析统一服务	pending	P3
Task 18	Phase 6	发布前检查和就绪度扩展	pending	P3
Task 19	Phase 7	自动化测试规格和增量验证	pending	P0
Task 20	Phase 7	文档回填、审查和确认记录	pending	P0

Phase 0：边界冻结

Task 0: Spec 硬边界和任务拆分确认

目标: 确认实现范围和阶段边界，避免 P0 实现时滑入完整 BI、跨对象分析或代码下载生成。

涉及文件:

code-copilot/changes/lowcode-app-data-analysis-closure/spec.md — 保持已澄清决策和技术决策。
code-copilot/changes/lowcode-app-data-analysis-closure/tasks.md — 维护任务状态和执行边界。
code-copilot/changes/lowcode-app-data-analysis-closure/test-spec.md — Task 19 创建，执行验证前补齐。
code-copilot/changes/lowcode-app-data-analysis-closure/execution-log.md — Task 19 创建，记录命令和结果。

确认事项:

P0 只做单数据集透视、分析数据集同步、视图保存、CRM 默认分析视图。
P1 才做指标目录、公式指标和业务看板。
P2 才做告警和分析到行动。
P3 才做运行监控、健康度、统一血缘、发布前分析影响检查。
分析资产不进入代码下载模式。

验收标准:

spec.md 第 15 章没有未完成待澄清项。
tasks.md 的 P0-P3 与 spec.md 第 14 章一致。
后续任务的验收标准不包含跨对象关联分析、复杂 cron、代码下载生成分析资产。

Phase 1 / P0：数据模型与基础权限

Task 1: 分析闭环 Flyway 数据模型

目标: 创建分析视图、指标、看板、告警、运行监控和查询日志所需持久化结构，并扩展数据集来源字段。

涉及文件:

新增 forge-server/db/migration/V1.0.xx__add_lowcode_analysis_closure_tables.sql — 分析闭环表结构、索引、字典和权限资源。

数据结构:

新增 ai_analysis_view：保存透视视图配置。
新增 ai_analysis_metric：保存指标目录。
新增 ai_analysis_metric_version：保存指标口径版本。
新增 ai_analysis_dashboard：保存业务看板。
新增 ai_analysis_dashboard_widget：保存看板组件。
新增 ai_analysis_alert_rule：保存告警规则。
新增 ai_analysis_alert_log：保存告警执行日志。
新增 ai_app_usage_log：保存应用访问和运行事件。
新增 ai_analysis_query_log：保存分析查询日志。
扩展 data_dataset：source_type, source_id, object_code, config_key, auto_sync, last_sync_time。
扩展 data_dataset_field：优先复用现有 fieldRole、defaultAgg、sensitiveLevel、dictType、dataUnit；缺失时补充 source_field, analysis_role, default_time_grain, drill_enabled。

脚本约束:

使用 CREATE TABLE IF NOT EXISTS。
新增列和索引前查询 information_schema。
sys_resource、sys_dict_type、sys_dict_data 初始化必须 NOT EXISTS 防重复。
所有内置数据 tenant_id=1。
不写真实外部 URL、Token、Secret。

权限资源建议:

ai:analysis:view
ai:analysis:design
ai:analysis:metric
ai:analysis:dashboard
ai:analysis:alert
ai:analysis:lineage
ai:analysis:health

验收标准:

空库和已有库均可执行脚本。
所有分析资产表包含 tenant_id 和标准审计字段。
分析视图、指标、看板、告警编码具备租户维度唯一约束。
数据集扩展字段可追踪低代码对象和 configKey 来源。

Task 2: 后端实体、Mapper、DTO/VO 和权限字典

目标: 为分析闭环建立基础 Java 模型、XML 查询和前后端协议对象。

涉及文件:

新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/domain/entity/AiAnalysisView.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/domain/entity/AiAnalysisMetric.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/domain/entity/AiAnalysisMetricVersion.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/domain/entity/AiAnalysisDashboard.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/domain/entity/AiAnalysisDashboardWidget.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/domain/entity/AiAnalysisAlertRule.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/domain/entity/AiAnalysisAlertLog.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/domain/entity/AiAppUsageLog.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/domain/entity/AiAnalysisQueryLog.java
新增对应 Mapper：AnalysisViewMapper.java, AnalysisMetricMapper.java, AnalysisDashboardMapper.java, AnalysisAlertRuleMapper.java, AnalysisLineageMapper.java, AnalysisHealthMapper.java
新增对应 XML：AnalysisViewMapper.xml, AnalysisMetricMapper.xml, AnalysisDashboardMapper.xml, AnalysisAlertRuleMapper.xml, AnalysisLineageMapper.xml, AnalysisHealthMapper.xml
新增 DTO/VO 包：dto/analysis/*, vo/analysis/*

关键协议对象:

AnalysisDatasetSyncDTO：对象或 configKey 同步请求。
PivotQueryDTO：数据集、维度、指标、筛选、排序、分页、图表类型。
PivotQueryResultVO：列、行、图表数据、钻取条件。
AnalysisViewSaveDTO / AnalysisViewVO：透视视图保存和详情。
AnalysisMetricSaveDTO / AnalysisMetricVO：指标保存和详情。
AnalysisDashboardSaveDTO / AnalysisDashboardVO：看板保存和详情。
AnalysisAlertRuleSaveDTO / AnalysisAlertLogVO：告警规则和日志。
AnalysisImpactVO：统一影响分析结果。
AnalysisHealthVO：应用健康度。

验收标准:

查询类方法全部在 Mapper XML 中实现。
DTO 中所有分页字段使用 pageNum/pageSize。
运行态 VO 不暴露表名、SQL、原始 JSON 给普通业务页面。
权限字典和前端按钮权限编码一致。

Phase 2 / P0：数据集同步与透视后端

Task 3: 低代码发布后自动同步分析数据集

目标: 低代码应用发布成功后自动生成或更新分析数据集，实现业务对象到分析数据资产的闭环入口。

涉及文件:

新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/service/analysis/AnalysisDatasetSyncService.java
修改 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/service/lowcode/LowcodePublishService.java
修改 forge-server/forge-framework/forge-plugin-parent/forge-plugin-data/src/main/java/com/mdframe/forge/plugin/data/service/DataDatasetService.java
修改 forge-server/forge-framework/forge-plugin-parent/forge-plugin-data/src/main/java/com/mdframe/forge/plugin/data/service/DataDatasetFieldService.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/controller/AnalysisDatasetController.java

关键签名:

public AnalysisDatasetSyncResultVO syncByConfigKey(String configKey);

public AnalysisDatasetSyncResultVO syncByObjectCode(String objectCode);

public List<DataDatasetField> buildFieldsFromLowcodeModel(AiCrudConfig config,
                                                          LowcodeModelSchema schema,
                                                          boolean preserveManualConfig);

字段识别规则:

dictType 来自低代码字段配置。
金额字段：字段名或列名包含 amount、price、fee、cost、payment、total，默认 fieldRole=MEASURE、defaultAgg=SUM、dataUnit=cent。
日期字段：字段类型为时间或命名包含 date、time，默认 fieldRole=DATE。
状态、阶段、负责人、地区、客户类型等字段默认 fieldRole=DIMENSION。
id、tenant_id、create_by、update_by 默认隐藏但保留钻取条件能力。
已人工修改 fieldRole/defaultAgg/sensitiveLevel/dictType/dataUnit 的字段不被覆盖。

接口:

POST /ai/analysis/dataset/sync/object/{objectCode}
POST /ai/analysis/dataset/sync/config/{configKey}

验收标准:

发布 crm_customer、crm_opportunity、crm_contract、crm_payment 后生成对应 data_dataset 和字段。
重复发布不会重复创建数据集。
人工修改字段角色后再次同步不会被静默覆盖。
数据集发布状态与低代码应用发布状态保持一致。

Task 4: 单数据集透视查询引擎

目标: 在 forge-plugin-data 运行查询基础上新增受控聚合查询，支持单数据集透视表和图表数据。

涉及文件:

新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-data/src/main/java/com/mdframe/forge/plugin/data/service/DataPivotQueryService.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-data/src/main/java/com/mdframe/forge/plugin/data/support/PivotQueryBuilder.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-data/src/main/java/com/mdframe/forge/plugin/data/support/PivotQueryLimitProperties.java
修改 forge-server/forge-framework/forge-plugin-parent/forge-plugin-data/src/main/java/com/mdframe/forge/plugin/data/controller/DataDatasetRuntimeController.java
新增或复用 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/controller/AnalysisPivotController.java

关键签名:

public PivotQueryResultVO query(PivotQueryDTO dto);

public QueryBuildResult buildPivotSql(DataDataset dataset,
                                      DataConnection connection,
                                      List<DataDatasetField> fields,
                                      PivotQueryDTO dto);

查询限制:

最大行维度数：3。
最大列维度数：2。
最大指标数：5。
最大返回行数：1000。
默认超时使用数据集 timeoutSeconds，最大不超过系统配置。
首期只支持单数据集，不接受多个 datasetId。

安全规则:

维度、指标、筛选字段必须存在于数据集字段元数据。
TABLE 数据集用字段白名单构建聚合 SQL。
SQL 数据集首期默认只允许明细查询；若开启透视，必须包装为子查询并校验字段白名单。
必须复用数据集访问权限、行级权限、字典翻译和敏感字段隐藏/脱敏。
查询类 SQL Builder 不允许拼接前端字段原文，必须使用方言 quote 和白名单列名。

验收标准:

可对单个数据集按维度分组求和、计数、平均。
非法字段、未发布数据集、无权限数据集返回明确业务错误。
高基数查询超过限制时被拦截。
返回结果包含表格列、图表序列和钻取过滤条件。

Task 5: 分析视图保存、授权和钻取协议

目标: 保存用户透视配置，并支持个人/对象/套件公共视图及角色、部门、用户授权。

涉及文件:

新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/controller/AnalysisViewController.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/service/analysis/AnalysisViewService.java
修改 AnalysisViewMapper.java / AnalysisViewMapper.xml
新增 AnalysisViewAclDTO.java / AnalysisViewAclVO.java
修改 forge-admin-ui/src/api/business-app.js 或新增 forge-admin-ui/src/api/analysis.js

可见范围:

PRIVATE：仅创建人。
OBJECT_PUBLIC：对象公共视图，可追加角色、部门、用户授权。
SUITE_PUBLIC：套件公共视图，可追加角色、部门、用户授权。

钻取协议:

{
  "targetType": "CRUD_PAGE",
  "configKey": "crm_contract",
  "objectCode": "crm_contract",
  "filters": [
    { "field": "contractStatus", "operator": "eq", "value": "SIGNED" }
  ]
}

接口:

GET /ai/analysis/view/page
GET /ai/analysis/view/{id}
POST /ai/analysis/view
PUT /ai/analysis/view
DELETE /ai/analysis/view/{id}

验收标准:

个人视图只有本人可见。
公共视图支持角色、部门、用户授权。
视图保存前校验数据集、字段、指标、钻取目标均有效。
删除数据集或字段前影响分析能发现引用该字段的视图。

Phase 3 / P0：数据透视前端最小闭环

Task 6: 前端分析 API、路由和分析工作台骨架

目标: 在应用中心新增数据分析入口，提供业务对象维度的分析工作台骨架。

涉及文件:

新增 forge-admin-ui/src/api/analysis.js 或 forge-admin-ui/src/api/analysis.ts
修改 forge-admin-ui/src/router/index.js — 注册 /app-center/analysis 和可选 /app-center/object/:objectCode/analysis。
新增 forge-admin-ui/src/views/app-center/analysis.vue
修改 forge-admin-ui/src/views/app-center/object.[objectCode].vue
修改 forge-admin-ui/src/views/app-center/suite.[suiteCode].vue
修改 forge-admin-ui/src/views/app-center/components/ObjectCard.vue

前端 API:

syncAnalysisDatasetByObject(objectCode)
syncAnalysisDatasetByConfig(configKey)
queryPivot(data)
analysisViewPage(params)
analysisViewDetail(id)
saveAnalysisView(data)
deleteAnalysisView(id)

页面行为:

从业务对象进入时自动带入 suiteCode、objectCode、configKey。
若对象未同步数据集，显示“同步分析数据集”动作。
若数据集已同步，默认加载字段元数据和最近视图。
普通业务用户不显示表名、SQL、configKey。

验收标准:

应用中心可进入数据分析工作台。
对象详情可看到数据分析入口。
未同步数据集时可手动触发同步并刷新页面。

Task 7: 透视设计器和图表结果面板

目标: 实现单数据集透视配置、预览和图表展示。

涉及文件:

新增 forge-admin-ui/src/views/app-center/components/analysis/PivotDesigner.vue
新增 forge-admin-ui/src/views/app-center/components/analysis/FieldRolePanel.vue
新增 forge-admin-ui/src/views/app-center/components/analysis/PivotResultPanel.vue
新增 forge-admin-ui/src/views/app-center/components/analysis/PivotFilterBuilder.vue
新增 forge-admin-ui/src/views/app-center/components/analysis/ChartTypeSelect.vue
修改 forge-admin-ui/src/views/app-center/analysis.vue

交互能力:

字段按维度、指标、日期、明细分组展示。
支持选择行维度、列维度、指标、筛选条件、排序、TopN。
支持图表类型：指标卡、表格、柱状图、折线图、饼图、面积图、横向条形图。
支持聚合方式：计数、去重计数、求和、平均、最大、最小。
支持日期粒度：日、周、月、季、年。
展示空状态、加载态、错误态、权限不足态。

验收标准:

选择单个数据集后可以配置并执行透视查询。
非法组合在前端配置阶段给出提示，不等到后端报错。
图表和表格可以切换。
页面在 1366px 桌面和移动端宽度下不重叠。

Task 8: CRM 默认分析视图和明细钻取

目标: 为 CRM 首批对象生成默认分析视图，并实现图表到动态 CRUD 明细页的筛选钻取。

涉及文件:

修改 AnalysisDatasetSyncService.java — 同步 CRM 对象时生成默认分析视图。
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/analysis/CrmAnalysisTemplateService.java
修改 forge-admin-ui/src/views/app-center/components/analysis/PivotResultPanel.vue
修改 forge-admin-ui/src/views/ai/crud-page.vue — 支持从分析钻取参数初始化查询条件；若已有能力则复用。
修改 forge-admin-ui/src/api/business-app.js 或 forge-admin-ui/src/api/analysis.js

默认视图:

客户：客户类型分布、本月新增客户趋势。
商机：阶段分布、预计金额按负责人汇总。
合同：合同状态分布、签约月份合同金额趋势。
回款：回款状态分布、逾期金额按负责人汇总。

钻取规则:

图表点击生成 field/operator/value 筛选条件。
跳转 /ai/crud-page/:configKey。
动态 CRUD 页面按钻取条件初始化搜索区并自动查询。

验收标准:

CRM 四个对象发布后生成默认分析视图。
点击默认视图图表可进入对应 CRUD 明细。
钻取条件和图表单元格语义一致。

Phase 4 / P1：指标与看板闭环

Task 9: 指标目录和公式指标后端能力

目标: 建立可复用指标目录，支持普通指标和公式指标。

涉及文件:

新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/controller/AnalysisMetricController.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/analysis/AnalysisMetricService.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/analysis/MetricFormulaValidator.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/analysis/MetricCalculationService.java
修改 AnalysisMetricMapper.java / AnalysisMetricMapper.xml
可复用或参考 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/src/main/java/com/mdframe/forge/plugin/generator/service/formula/*

关键签名:

public AnalysisMetricVO saveMetric(AnalysisMetricSaveDTO dto);

public MetricPreviewVO previewMetric(Long metricId, MetricPreviewDTO dto);

public FormulaValidationResult validateMetricFormula(AnalysisMetricSaveDTO dto);

公式规则:

公式可引用同一数据集字段或已有指标。
支持四则运算、括号和基础函数。
发布前做语法校验、字段存在性校验、依赖分析、循环依赖检测。
指标变更写入 ai_analysis_metric_version。

验收标准:

可创建普通 SUM/COUNT 指标。
可创建回款完成率这类公式指标。
循环依赖被拦截。
指标预览返回当前值和口径说明。

Task 10: 指标目录前端和指标预览

目标: 提供业务人员和实施人员可维护的指标目录页面。

涉及文件:

新增 forge-admin-ui/src/views/app-center/components/analysis/MetricCatalogPanel.vue
新增 forge-admin-ui/src/views/app-center/components/analysis/MetricEditorDrawer.vue
新增 forge-admin-ui/src/views/app-center/components/analysis/MetricFormulaEditor.vue
修改 forge-admin-ui/src/views/app-center/analysis.vue
修改 forge-admin-ui/src/api/analysis.js

交互能力:

按套件、对象、数据集筛选指标。
新增普通指标和公式指标。
选择字段、聚合方式、时间字段、单位、负责人。
编写公式并即时校验。
预览指标结果。
查看口径说明和版本记录。

验收标准:

实施人员可创建合同金额、回款完成率等指标。
公式错误、字段不存在、循环依赖有明确提示。
指标预览结果可用于看板组件选择。

Task 11: 业务看板后端与发布后默认看板生成

目标: 建立业务看板和组件后端能力，并在 CRM 对象发布后生成默认看板。

涉及文件:

新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/controller/AnalysisDashboardController.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/analysis/AnalysisDashboardService.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/analysis/AnalysisDashboardTemplateService.java
修改 AnalysisDashboardMapper.java / AnalysisDashboardMapper.xml
修改 AnalysisDatasetSyncService.java

接口:

GET /ai/analysis/dashboard/page
GET /ai/analysis/dashboard/{id}
POST /ai/analysis/dashboard
PUT /ai/analysis/dashboard
DELETE /ai/analysis/dashboard/{id}

默认看板生成规则:

发布后按 suiteCode/objectCode/configKey 生成或更新默认看板。
初始化脚本只维护模板类基础数据，最终看板配置由发布后服务生成。
不覆盖用户手动调整过的看板布局，除非用户选择重新生成。

验收标准:

CRM 总览、商机漏斗、合同金额、回款逾期看板可生成。
看板组件可绑定指标或透视视图。
看板下线前影响分析可识别告警和入口引用。

Task 12: 业务看板前端和应用中心入口集成

目标: 在业务套件和业务对象页面展示看板，并支持看板组件配置。

涉及文件:

新增 forge-admin-ui/src/views/app-center/components/analysis/DashboardDesigner.vue
新增 forge-admin-ui/src/views/app-center/components/analysis/DashboardWidgetRenderer.vue
新增 forge-admin-ui/src/views/app-center/components/analysis/DashboardWidgetEditor.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/stats-dashboard.vue — 可保留旧入口并逐步迁移到新看板。
修改 forge-admin-ui/src/api/analysis.js

交互能力:

套件详情展示默认看板。
对象详情展示对象级看板。
看板组件支持指标卡、图表、透视表。
组件可配置数据源、标题、图表类型、钻取目标。
组件失败时展示错误态和配置入口。

验收标准:

CRM 套件详情能看到 CRM 总览看板。
客户、商机、合同、回款对象详情能看到对象级看板。
看板图表可钻取明细。

Phase 5 / P2：分析到行动

Task 13: 指标告警规则和执行日志后端

目标: 建立指标告警规则、执行日志和手动执行能力。

涉及文件:

新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/controller/AnalysisAlertController.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/analysis/AnalysisAlertRuleService.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/analysis/AnalysisAlertExecutor.java
修改 AnalysisAlertRuleMapper.java / AnalysisAlertRuleMapper.xml
修改 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/businessapp/BusinessTriggerExecutor.java — 如复用触发器动作。

接口:

GET /ai/analysis/alert/rule/page
POST /ai/analysis/alert/rule
PUT /ai/analysis/alert/rule
POST /ai/analysis/alert/rule/{id}/execute
GET /ai/analysis/alert/log/page

规则能力:

条件：大于、小于、等于、环比增长、连续 N 天满足条件。
目标：指标或透视视图。
动作：站内消息、待办、触发器动作、Webhook TODO。
去重：同一规则同一周期默认只提醒一次。

验收标准:

可手动执行告警规则并写入日志。
规则失败时记录错误原因。
无权限指标不能被告警规则引用。

Task 14: 告警每日扫描任务和动作执行

目标: 接入任务调度中心，按每日扫描方式执行启用的告警规则。

涉及文件:

新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/analysis/AnalysisAlertScanJob.java
新增或修改 Flyway 脚本注册系统任务：LOWCODE.analysisAlertScanJob
修改 AnalysisAlertExecutor.java
修改 AnalysisAlertRuleMapper.xml — 查询到期启用规则。
修改消息发送相关服务调用，复用现有消息中心。

调度规则:

首期只支持手动执行和每日扫描。
不为每条规则创建独立 Job。
支持全局扫描上限和单批执行上限。
同一规则同一周期防重复。

验收标准:

任务中心能看到并启停告警扫描任务。
扫描任务只执行启用规则。
执行站内消息或触发器动作后写入告警日志。
Webhook 动作返回 TODO 状态，不发真实外部请求。

Task 15: 告警前端配置、日志和 CRM 样板

目标: 提供告警规则配置页面和 CRM 回款逾期、商机停滞、合同金额超限样板。

涉及文件:

新增 forge-admin-ui/src/views/app-center/components/analysis/AlertRulePanel.vue
新增 forge-admin-ui/src/views/app-center/components/analysis/AlertRuleEditorDrawer.vue
新增 forge-admin-ui/src/views/app-center/components/analysis/AlertLogDrawer.vue
修改 forge-admin-ui/src/views/app-center/analysis.vue
修改 forge-admin-ui/src/api/analysis.js
修改 CRM 默认分析模板服务，发布后生成推荐告警草稿或模板。

样板规则:

回款逾期：逾期金额大于 0，每日提醒负责人。
商机停滞：阶段连续 N 天未变化，生成跟进提醒。
合同金额超限：合同金额超过阈值，提示配置流程或触发流程动作。

验收标准:

用户能创建、启停、手动执行告警规则。
告警日志可查看成功、失败、跳过和 TODO。
CRM 样板对象能生成推荐告警模板。

Phase 6 / P3：治理与运营

Task 16: 应用运行监控和健康度

目标: 记录应用访问、分析查询和异常事件，并输出应用健康度。

涉及文件:

新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/analysis/AppUsageLogService.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/analysis/AnalysisHealthService.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/controller/AnalysisHealthController.java
修改 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/businessapp/BusinessAppOpenService.java
修改 DataPivotQueryService.java — 写入 ai_analysis_query_log。
修改 AnalysisHealthMapper.java / AnalysisHealthMapper.xml
新增 forge-admin-ui/src/views/app-center/components/analysis/AppHealthPanel.vue

健康度指标:

访问量。
活跃用户。
最近访问时间。
打开失败次数。
分析查询失败次数。
慢查询数。
最近异常。
告警/触发器执行成功率。

验收标准:

打开业务应用时写入访问日志。
执行透视查询时写入查询日志。
应用中心能展示“正常、低使用、异常、待配置”。

Task 17: 数据血缘与影响分析统一服务

目标: 统一查询数据集、字段、指标、透视视图、看板、告警和 AI 大屏组件影响范围。

涉及文件:

新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/analysis/AnalysisLineageService.java
新增 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/controller/AnalysisLineageController.java
修改 AnalysisLineageMapper.java / AnalysisLineageMapper.xml
修改 forge-server/forge-framework/forge-plugin-parent/forge-plugin-ai/src/main/java/com/mdframe/forge/plugin/ai/dashboard/service/AiDashboardGenerateRecordService.java 或通过适配服务调用已有影响查询。
新增 forge-admin-ui/src/views/app-center/components/analysis/LineageImpactPanel.vue
修改 forge-admin-ui/src/api/analysis.js

影响范围:

数据集影响的指标、视图、看板、告警、AI 大屏组件。
字段影响的指标、视图、看板组件、告警条件。
指标影响的看板和告警。
视图影响的看板和告警。

验收标准:

数据集下线前可查询影响范围。
字段删除或改名前可查询影响范围。
AI 大屏已有数据集影响结果纳入统一返回。

Task 18: 发布前检查和就绪度扩展

目标: 把分析资产纳入业务对象就绪度和低代码发布前检查。

涉及文件:

修改 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/businessapp/BusinessObjectReadinessService.java
修改 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/lowcode/LowcodePublishService.java
修改 forge-server/forge-framework/forge-plugin-parent/forge-plugin-generator/service/businessapp/BusinessObjectPublishService.java
修改 forge-admin-ui/src/views/app-center/components/ReadinessPanel.vue
修改 forge-admin-ui/src/views/app-center/components/designer/BusinessPublishChecklist.vue
修改 forge-admin-ui/src/views/app-center/object.[objectCode].vue

检查项:

数据集已同步。
字段角色完整。
至少一个默认指标。
至少一个默认分析视图。
看板可打开。
告警可选配置。
血缘可追踪。
字段变更影响分析已确认。

验收标准:

对象详情显示分析就绪状态。
发布前能提示分析资产影响。
缺口项可跳转到对应配置页面。

Phase 7：验证与文档回填

Task 19: 自动化测试规格和增量验证

目标: 按项目自动化测试标准生成并执行增量验证。

涉及文件:

新增 code-copilot/changes/lowcode-app-data-analysis-closure/test-spec.md
新增 code-copilot/changes/lowcode-app-data-analysis-closure/execution-log.md
修改 code-copilot/changes/lowcode-app-data-analysis-closure/tasks.md

验证前置:

执行 /test、阶段收尾验证、Review 后修复验证或归档前验收时，必须先读取 code-copilot/rules/automated-testing-standard.md。
复用本变更已有 spec.md、tasks.md、test-spec.md、execution-log.md，按本轮差异增量验证。

建议命令:

cd forge-server && mvn -pl forge-admin-server -am compile -DskipTests
cd forge-admin-ui && source ~/.nvm/nvm.sh && nvm use v20.19.0 && pnpm exec eslint src/views/app-center src/api/analysis.js
cd forge-admin-ui && source ~/.nvm/nvm.sh && nvm use v20.19.0 && pnpm build

验收标准:

test-spec.md 明确 P0/P1/P2/P3 的测试范围和跳过项。
execution-log.md 记录命令、结果、警告、失败项和服务清理情况。
阶段完成后对应任务状态和验证结果已回填。

Task 20: 文档回填、审查和确认记录

目标: 保持 Spec、Task、测试日志和审查结论一致，形成可归档交付材料。

涉及文件:

code-copilot/changes/lowcode-app-data-analysis-closure/spec.md
code-copilot/changes/lowcode-app-data-analysis-closure/tasks.md
code-copilot/changes/lowcode-app-data-analysis-closure/test-spec.md
code-copilot/changes/lowcode-app-data-analysis-closure/execution-log.md

回填要求:

每完成一个任务，更新任务状态、实际改动文件和验证结果。
若实现中改变边界，必须先回写 spec.md 并确认。
Review 后修复必须写入执行日志。
确认记录（HARD-GATE）补齐确认时间和确认人。

验收标准:

spec.md、tasks.md、test-spec.md、execution-log.md 对同一阶段状态描述一致。
无未处理待澄清项。
可直接进入 /apply lowcode-app-data-analysis-closure。

tasks.md 35 KB Historia Raaka

任务清单：lowcode-app-data-analysis-closure

前置条件

阶段总览

任务总览

Phase 0：边界冻结

Task 0: Spec 硬边界和任务拆分确认

Phase 1 / P0：数据模型与基础权限

Task 1: 分析闭环 Flyway 数据模型

Task 2: 后端实体、Mapper、DTO/VO 和权限字典

Phase 2 / P0：数据集同步与透视后端

Task 3: 低代码发布后自动同步分析数据集

Task 4: 单数据集透视查询引擎

Task 5: 分析视图保存、授权和钻取协议

Phase 3 / P0：数据透视前端最小闭环

Task 6: 前端分析 API、路由和分析工作台骨架

Task 7: 透视设计器和图表结果面板

Task 8: CRM 默认分析视图和明细钻取

Phase 4 / P1：指标与看板闭环

Task 9: 指标目录和公式指标后端能力

Task 10: 指标目录前端和指标预览

Task 11: 业务看板后端与发布后默认看板生成

Task 12: 业务看板前端和应用中心入口集成

Phase 5 / P2：分析到行动

Task 13: 指标告警规则和执行日志后端

Task 14: 告警每日扫描任务和动作执行

Task 15: 告警前端配置、日志和 CRM 样板

Phase 6 / P3：治理与运营

Task 16: 应用运行监控和健康度

Task 17: 数据血缘与影响分析统一服务

Task 18: 发布前检查和就绪度扩展

Phase 7：验证与文档回填

Task 19: 自动化测试规格和增量验证

Task 20: 文档回填、审查和确认记录

tasks.md 35 KB

Historia Raaka