neo-cmp-cli 1.13.11 → 1.13.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neo-cmp-cli",
-  "version": "1.13.11",
+  "version": "1.13.12",
   "description": "Neo 自定义组件开发工具，支持react 和 vue2.0技术栈。",
   "keywords": [
     "neo-cli",

package/template/antd-custom-cmp-template/package.json

@@ -48,7 +48,7 @@
     "@commitlint/config-conventional": "^18.0.0",
     "@types/react": "^16.9.11",
     "@types/react-dom": "^16.9.15",
-    "neo-cmp-cli": "^1.13.11",
+    "neo-cmp-cli": "^1.13.12",
     "husky": "^4.2.5",
     "lint-staged": "^10.2.9",
     "prettier": "^2.0.5"

package/template/asset-manage-template/package.json

@@ -52,7 +52,7 @@
     "@types/react": "^16.9.11",
     "@types/react-dom": "^16.9.15",
     "@types/axios": "^0.14.0",
-    "neo-cmp-cli": "^1.13.11",
+    "neo-cmp-cli": "^1.13.12",
     "husky": "^4.2.5",
     "lint-staged": "^10.2.9",
     "prettier": "^2.0.5",

package/template/echarts-custom-cmp-template/package.json

@@ -48,7 +48,7 @@
     "@commitlint/config-conventional": "^18.0.0",
     "@types/react": "^16.9.11",
     "@types/react-dom": "^16.9.15",
-    "neo-cmp-cli": "^1.13.11",
+    "neo-cmp-cli": "^1.13.12",
     "husky": "^4.2.5",
     "lint-staged": "^10.2.9",
     "prettier": "^2.0.5",

package/template/empty-custom-cmp-template/package.json

@@ -41,7 +41,7 @@
     "@commitlint/config-conventional": "^18.0.0",
     "@types/react": "^16.9.11",
     "@types/react-dom": "^16.9.15",
-    "neo-cmp-cli": "^1.13.11",
+    "neo-cmp-cli": "^1.13.12",
     "husky": "^4.2.5",
     "lint-staged": "^10.2.9",
     "prettier": "^2.0.5"

package/template/map-custom-cmp-template/package.json

@@ -47,7 +47,7 @@
     "@commitlint/config-conventional": "^18.0.0",
     "@types/react": "^16.9.11",
     "@types/react-dom": "^16.9.15",
-    "neo-cmp-cli": "^1.13.11",
+    "neo-cmp-cli": "^1.13.12",
     "husky": "^4.2.5",
     "lint-staged": "^10.2.9",
     "prettier": "^2.0.5"

package/template/neo-bi-cmps/docs/gartner-pipeline-apis.md

@@ -0,0 +1,279 @@
+> **更新时间**：2026-04-01
+> **模块**：商机Pipeline管理
+> **状态**：初步设计
+> **原型参考**：`docs/htmls/forecasting-prototype.html` — Pipeline Tab
+
+---
+
+# 商机Pipeline管理 — 接口设计文档
+
+---
+
+# 一、自定义API相关对象和查询接口
+
+本章列出Pipeline功能涉及的核心数据实体及其关键字段，供接口设计和数据建模参考。
+
+## 1.1 商机阶段信息
+
+Open API：根据商机业务类型查询商机阶段
+
+接口URL：`/rest/neobi/v2.0/query/queryByCustomSQL`
+
+| 字段      | 类型   | 说明                     |
+| --------- | ------ | ------------------------ |
+| id        | String | 商机阶段ID               |
+| stageName | String | 商机阶段名称             |
+| order     | Number | 序号                     |
+| status    | String | 状态（进行中/输单/赢单） |
+
+## 1.2 商机信息
+
+Open API：获取销售机会信息
+
+接口URL：`/rest/data/v2.0/xobjects/opportunity/{id}`
+
+| 字段             | 类型            | 说明                                                  |
+| ---------------- | --------------- | ----------------------------------------------------- |
+| opportunityId    | String          | 商机ID                                                |
+| opportunityName  | String          | 商机名称                                              |
+| accountName      | String          | 客户名称                                              |
+| amount           | Number          | 商机金额                                              |
+| closeDate        | Date            | 预计结单日期                                          |
+| stageId          | String          | 当前阶段ID                                            |
+| stageName        | String          | 当前阶段名称                                          |
+| ownerUserId      | String          | 商机负责人用户ID                                      |
+| ownerDeptId      | String          | 商机负责人所属部门ID                                  |
+| businessType     | String          | 业务类型                                              |
+| lastActivityDate | DateTime        | 最近活动时间                                          |
+| createdTime      | DateTime        | 商机创建时间                                          |
+| winRate          | Number          | （自定义字段）最终AI赢率（0-100）                     |
+| baseline         | Number          | （自定义字段）基线概率（0-100），基于历史同类商机统计 |
+| positiveFactors  | Array\<Object\> | （自定义字段）正向因素列表，每项含description和impact |
+| negativeFactors  | Array\<Object\> | （自定义字段）负向因素列表，每项含description和impact |
+
+## 1.3 自定义实体数据查询
+
+
+## 1.4 商机历史快照
+
+使用BI提供的自定义SQL查询接口获取快照数据。
+
+> Open API：数据平台接口 — 自定义 SQL 查询
+
+> 接口URL：`/rest/neobi/v2.0/query/queryByCustomSQL`
+
+商机历史快照接口示例
+
+select opportunity_1_opportunityName,
+opportunity_1_money
+from biCustomModel_397169_20260401104916618 limit 100
+
+
+## 1.5 商机健康度评估信息
+
+> Open API：没有Open API，内部可调用业务接口，获取商机健康度结果接口
+
+> 接口URL：/rest/ai/v2.0/agent/apps/health_assessment/get_health_assessment_result
+
+| 字段                         | 类型   | 说明                                       |
+| ---------------------------- | ------ | ------------------------------------------ |
+| opportunityId                | String | 商机ID                                     |
+| level                        | String | 评分等级：`High` / `Medium` / `Low`  |
+| summary                      | String | AI生成的自然语言摘要，概述商机当前健康状态 |
+| dimensions                   | Object | 四维评分明细                               |
+| dimensions.demand            | String | 需求维度评级                               |
+| dimensions.decisionChain     | String | 决策链维度评级                             |
+| dimensions.budgetProcurement | String | 预算和采购流程维度评级                     |
+| dimensions.competition       | String | 竞争维度评级                               |
+
+## 1.6 部门人员信息
+
+Open API：获取当前用户可见的人员列表
+
+接口URL：待确认（平台标准接口）
+
+## 1.7 权限内业务类型
+
+Open API：获取当前用户权限内的商机业务类型列表及系统默认值
+
+接口URL：待确认
+
+| 字段                 | 类型            | 说明                                        |
+| -------------------- | --------------- | ------------------------------------------- |
+| businessTypes        | Array\<Object\> | 业务类型列表                                |
+| businessTypes[].id   | String          | 业务类型ID                                  |
+| businessTypes[].name | String          | 业务类型名称                                |
+| defaultBusiType      | String          | 系统默认业务类型ID（固定为defaultBusiType） |
+
+## 1.8 提示词模板调用接口
+
+PromptTemplateResponse execute = ScriptAIPromptTemplateService.instance().execute(template);
+int code = execute.getCode();
+String errorMessage = execute.getErrorMsg();
+
+## 1.9 查询BI视图数据
+
+Open API：按照筛选条件查询视图数据
+
+接口URL：`/rest/neobi/v2.0/bestoractices/queryDataTask`
+
+---
+
+# 二、聚合接口设计
+
+基于Pipeline Tab各组件的数据需求，设计以下聚合接口。聚合接口在BFF层实现，内部调用第一章的单接口进行数据组装。
+
+## 2.0 接口总览
+
+| 编号  | 聚合接口             | 触发时机                         | 服务的组件              | 调用的单接口                |
+| ----- | -------------------- | -------------------------------- | ----------------------- | --------------------------- |
+| AGG-1 | 获取筛选项初始化数据 | 页面初始化（仅一次）             | 全局筛选栏              | 部门架构接口 + 业务类型接口 |
+| AGG-2 | 获取BI视图与AI洞察   | 页面初始化 / 点击✨按钮          | BI视图图表 + AI分析弹窗 | 1.9 + 1.8                   |
+| AGG-3 | 获取阶段切换区数据   | 页面初始化 / 筛选变更            | Stage Tabs              | 1.1 + 1.2 + 1.4             |
+| AGG-4 | 获取商机列表数据     | 页面初始化 / 筛选变更 / 阶段切换 | 商机明细表格            | 1.2 + 1.5 + 1.6             |
+
+## 2.1 AGG-1：获取筛选项初始化数据
+
+页面初始化时调用一次，获取筛选栏所需的选项数据和默认值。
+
+**请求**：无入参，根据当前登录用户自动获取。
+
+**返回**：
+
+| 字段            | 类型   | 说明                                                    |
+| --------------- | ------ | ------------------------------------------------------- |
+| currentUser     | Object | 当前登录用户信息（userId, name）                        |
+| departments     | Array  | 当前用户可见的部门列表（含部门下人员）                  |
+| businessTypes   | Array  | 当前用户权限内的业务类型列表                            |
+| defaultBusiType | String | 系统默认业务类型ID，用于筛选栏Business Type的默认选中值 |
+
+**处理流程**：
+
+1. 调用1.7部门人员信息接口，获取当前用户可见的部门架构及人员列表
+2. 调用1.8权限内业务类型接口，获取业务类型列表及系统默认值（defaultBusiType）
+3. 获取当前登录用户信息（userId, name）
+4. 组装返回
+
+## 2.2 AGG-2：获取BI视图与AI洞察
+
+本接口分为两部分，分步调用。
+
+### 2.2.1 BI视图数据
+
+页面初始化或筛选变更时调用，分别调用1.9查询两个BI看板的视图数据，以3个筛选项（结单日期、业务类型、所有人）作为入参。对于阶段平均停留时间视图，还需额外调用1.3查询各阶段的基准值和保底值。
+
+**BI看板ID**：
+
+| 看板 | BI看板ID |
+|------|---------|
+| 商机漏斗(Pipeline Funnel) | 4264464770007375 |
+| 平均停留时间(Avg. Time in Stage) | 4264466340118875 |
+
+
+**处理流程**：
+
+1. **商机漏斗**：前端按当前筛选条件组装请求参数，调用1.9接口（viewId=4264464770007375），将返回的数据用于漏斗图渲染（各阶段金额、数量、转化率等）
+2. **平均停留时间**：
+   - 调用1.9接口（viewId=4264466340118875），获取各阶段的实际平均停留时间
+   - 调用1.3自定义实体数据查询接口，查询自定义对象**Opportunity Stage Plan**（APIKey:customEntity105__c），根据当前商机业务类型opp type+阶段Stage Name，获取各阶段的Target（基准值Reference Advancing Duration）和Limit（保底值Longest Advancing Duration）
+   - 前端将实际停留时间与Target/Limit合并渲染条形图
+
+
+### 2.2.2 AI洞察分析
+
+点击✨按钮时调用，将2.2.1已获取的BI视图数据作为上下文，调用1.8提示词模板接口生成AI洞察文本。
+
+**提示词模板**：API Key = `analyze_BI_insight__c`
+
+**模板入参**：
+
+| 参数 | 类型 | 说明 |
+|------|------|------|
+| Raw Data | String | BI看板数据（2.2.1返回的columns+rows）+ 基准值/保底值（仅平均停留时间看板需要附加） |
+| business_context | String | 背景说明，根据当前BI看板类型传入固定文案（见下方） |
+
+**business_context固定文案**：
+
+- **商机漏斗**：`This funnel visualizes the end-to-end sales conversion from each opportunity stage to closed-won, tracking opportunity count, sales amount and stage-by-stage conversion rate across sales stages, to identify pipeline bottlenecks and evaluate sales conversion efficiency.`
+- **平均停留时间**：`This bar chart displays the average time opportunities spend in each sales stage, measured as a percentage of the total sales cycle, to pinpoint process bottlenecks and optimize sales cycle efficiency.`
+
+**处理流程**：
+
+1. 前端将2.2.1已获取的BI视图数据作为Data传入，避免重复查询；平均停留时间看板需同时附加1.3查询到的Target/Limit数据
+2. 根据当前BI看板类型，传入对应的business_context固定文案
+3. 调用1.8提示词模板接口（API Key: `analyze_BI_insight__c`）执行AI生成
+4. 返回洞察文本，前端展示在AI Insight弹窗中
+
+
+
+## 2.3 AGG-3：获取阶段切换区数据
+
+筛选条件变更时调用，返回Stage Tabs阶段切换区组件的数据（各阶段汇总及变动信息）。
+             |
+
+**处理流程**：
+
+1. 调用1.1商机阶段信息接口，获取当前业务类型的阶段列表（含排序）
+2. 调用1.2商机信息接口，按筛选条件（Close Date、Owner、Business Type）批量查询商机，按阶段分组汇总当前金额和数量
+3. 调用1.4商机历史快照接口，查询changesSince基准日期的快照数据，按阶段分组汇总基准金额和基准数量
+
+   **历史快照字段参数**：
+    
+    Dataset API Key：biCustomModel_397169_20260401104916618
+
+   | Field | API Key |
+   |-------|---------|
+   | ID | id |
+   | Amount | opportunity_1_money |
+   | Owner department | opportunity_1_dimDepartEntity |
+   | Type | opportunity_1_entityType |
+   | Forecast Category | opportunity_1_forecastCategory |
+   | Status | opportunity_1_status |
+   | version | version |
+   | Close Date | opportunity_1_closeDate |
+   | Recent Activity Record Time | opportunity_1_recentActivityRecordTime |
+   | ID | opportunity_1__id |
+   | Opportunity | opportunity_1_id |
+   | Account Name | opportunity_1_accountId |
+   | Sales Stage | opportunity_1_saleStageId |
+   | Opportunity Name | opportunity_1_opportunityName |
+   | Forecast Category | opportunity_1_ForecastCategory__c |
+   | Opportunity Owner | opportunity_1_ownerId |
+4. 金额变动 = 当前阶段金额 − 基准快照阶段金额；数量变动 = 当前阶段数量 − 基准快照阶段数量
+5. 判断变动方向（up/down/none）
+6. 组装stageTabs数据返回
+
+
+## 2.4 AGG-4：获取商机列表数据
+
+阶段切换或筛选变更时调用，分两个阶段加载数据：列表首屏加载和Hover按需加载。
+
+### 2.4.1 列表首屏加载
+
+**处理流程**：
+
+1. 调用1.2商机信息接口，按筛选条件+阶段（默认选择第一个阶段）+排序（默认按照销售金额倒叙）+分页查询商机列表，获取所有列表展示字段
+2. AI Score等级标签（level字段）可从商机对象直接获取，无需调用1.6，随列表一并返回
+
+### 2.4.2 Hover按需加载
+
+以下数据仅在用户鼠标hover时触发，按需调用，避免首屏加载过重。
+
+**变动详情（Amount / Close Date / Stage）**：
+
+- 触发时机：用户hover某条商机的变动箭头
+- 调用接口：1.5商机历史快照接口
+- 入参：opportunityId + changesSince基准日期
+- 处理：查询该商机在基准日期的快照，与当前实时数据逐字段（Amount/CloseDate/Stage）比对，用当前值-基准日期的值，计算变动方向、变动前后值
+
+- 变动时间：调用1.2接口，取商机上的3个时间字段，AmoutChanged、ClosedDateChanged、StageChanged
+
+
+
+
+**AI Score详情**：
+
+- 触发时机：用户hover某条商机的AI Score标签
+- 调用接口：1.6商机健康度评估信息接口
+- 入参：opportunityId
+- 返回：四维评分及AI摘要summary