neo-cmp-cli 1.13.16 → 1.13.18

package/template/neo-bi-cmps/src/utils/simpleTable.tsx

@@ -0,0 +1,344 @@
+/**
+ * 表格 simpleTable 专用：格式化、历史快照、趋势与单元格渲染
+ */
+import * as React from 'react';
+import { Card, Popover } from 'antd';
+import moment from 'moment';
+
+import { toFiniteNumber } from './common';
+
+/** 期间初商机快照（与当前行 id 关联） */
+export interface HistoryOppSnap {
+  id: string;
+  closeDate: unknown;
+  opportunityName: string;
+  saleStageId: string;
+  money: unknown;
+}
+
+export interface FieldInfo {
+  name: string;
+  label: string;
+  apiKey: string;
+  type: string;
+  itemType: string;
+  checkitem: any[];
+  selectitem?: any[];
+  required: boolean;
+}
+
+function parseNumberForCompare(value: unknown): number | null {
+  if (value == null || value === '') return null;
+  const n = parseFloat(String(value).replace(/,/g, '').trim());
+  return Number.isFinite(n) ? n : null;
+}
+
+function parseCloseDateMs(value: unknown): number | null {
+  if (value == null || value === '') return null;
+  const m = moment(value);
+  return m.isValid() ? m.valueOf() : null;
+}
+
+type Trend = 'up' | 'down' | 'same';
+
+function moneyTrend(
+  current: unknown,
+  history: HistoryOppSnap | null | undefined,
+): Trend | null {
+  if (!history) return null;
+  const cur = parseNumberForCompare(current);
+  const prev = parseNumberForCompare(history.money);
+  if (cur == null || prev == null) return null;
+  if (cur > prev) return 'up';
+  if (cur < prev) return 'down';
+  return 'same';
+}
+
+function closeDateTrend(
+  current: unknown,
+  history: HistoryOppSnap | null | undefined,
+): Trend | null {
+  if (!history) return null;
+  const cur = parseCloseDateMs(current);
+  const prev = parseCloseDateMs(history.closeDate);
+  if (cur == null || prev == null) return null;
+  if (cur > prev) return 'up';
+  if (cur < prev) return 'down';
+  return 'same';
+}
+
+/** 自定义 SQL 返回行：数组列顺序与 HISTORY_QUERY_FIELDS 一致；或对象字段 */
+export function historyRowToSnap(row: unknown): HistoryOppSnap | null {
+  if (row == null) return null;
+  if (Array.isArray(row)) {
+    if (row.length < 5) return null;
+    return {
+      id: String(row[0] ?? '').trim(),
+      closeDate: row[1],
+      opportunityName: row[2] != null ? String(row[2]) : '',
+      saleStageId: row[3] != null ? String(row[3]) : '',
+      money: row[4],
+    };
+  }
+  if (typeof row === 'object') {
+    const o = row as Record<string, unknown>;
+    const id = o.id ?? o.opportunity_1_id;
+    if (id == null || id === '') return null;
+    return {
+      id: String(id).trim(),
+      closeDate:
+        o.opportunity_1_closeDate ?? o.closeDate ?? o.opportunity_1_close_date,
+      opportunityName: String(
+        o.opportunity_1_opportunityName ?? o.opportunityName ?? '',
+      ),
+      saleStageId: String(
+        o.opportunity_1_saleStageId ?? o.saleStageId ?? '',
+      ),
+      money: o.opportunity_1_money ?? o.money,
+    };
+  }
+  return null;
+}
+
+export function buildHistoryMap(rows: unknown[]): Map<string, HistoryOppSnap> {
+  const map = new Map<string, HistoryOppSnap>();
+  for (const raw of rows) {
+    const snap = historyRowToSnap(raw);
+    if (snap?.id) map.set(snap.id, snap);
+  }
+  return map;
+}
+
+/** closeDate：YYYY-MM-DD */
+export function formatCloseDate(value: unknown): string {
+  if (value == null || value === '') return '—';
+  const m = moment(value);
+  return m.isValid() ? m.format('YYYY-MM-DD') : String(value);
+}
+
+/** recentActivityRecordTime：YYYY-MM-DD HH:mm:ss */
+export function formatActivityDateTime(value: unknown): string {
+  if (value == null || value === '') return '—';
+  const m = moment(value);
+  return m.isValid() ? m.format('YYYY-MM-DD HH:mm:ss') : String(value);
+}
+
+/** customItem246/247：变更记录时间（毫秒/秒时间戳或可被 moment 解析的值）→ YYYY-MM-DD */
+export function formatChangeRecordedAt(value: unknown): string {
+  if (value == null || value === '') return '—';
+  const n = toFiniteNumber(value);
+  if (n != null) {
+    const ms = n < 1e12 ? n * 1000 : n;
+    const m = moment(ms);
+    if (m.isValid()) return m.format('YYYY-MM-DD');
+  }
+  const m = moment(value);
+  return m.isValid() ? m.format('YYYY-MM-DD') : String(value);
+}
+
+/** 金额列：$ 前缀 + 千分位（不缩写） */
+export function formatMoneyCell(value: unknown): string {
+  if (value == null || value === '') return '—';
+  const n = parseFloat(String(value).replace(/,/g, '').trim());
+  if (!Number.isFinite(n)) return String(value);
+  const part = Number.isInteger(n)
+    ? n.toLocaleString('en-US')
+    : n.toLocaleString('en-US', {
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 2,
+      });
+  return `$${part}`;
+}
+
+/** oppHealthAssessmentLevel：数值 → 健康度标签（带颜色背景） */
+export function renderOppHealthAssessmentLevel(value: unknown): React.ReactNode {
+  if (value == null || value === '') return '—';
+  const n = toFiniteNumber(value);
+  if (n === 5) {
+    return (
+      <span className="opp-health-tag opp-health-tag--green">Excellent</span>
+    );
+  }
+  if (n === 6) {
+    return <span className="opp-health-tag opp-health-tag--yellow">Health</span>;
+  }
+  if (n === 7) {
+    return <span className="opp-health-tag opp-health-tag--red">Risk</span>;
+  }
+  if (n === 8) {
+    return <span className="opp-health-tag opp-health-tag--red">Problem</span>;
+  }
+  return '—';
+}
+
+/**
+ * 百分比列：末尾加 %；接口常见为 0–1 小数或 0–100 数值，均按可读方式展示
+ */
+export function formatPercentCell(value: unknown): string {
+  if (value == null || value === '') return '—';
+  const raw = String(value).replace(/,/g, '').trim();
+  const n = parseFloat(raw.replace(/%/g, ''));
+  if (!Number.isFinite(n)) return String(value);
+  let pct = n;
+  if (n > 0 && n <= 1) {
+    pct = n * 100;
+  }
+  const text = Number.isInteger(pct)
+    ? String(pct)
+    : pct.toLocaleString('en-US', {
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 2,
+      });
+  return `${text}%`;
+}
+
+export function moneyChangeTooltipTitle(
+  record: any,
+  current: unknown,
+): React.ReactNode {
+  const preset = record?.customItem246__c;
+  const h = record?.historyData as HistoryOppSnap | undefined;
+  if (!h) return null;
+  return (
+    <div className="simpleTable-change-tip">
+      <div className="simpleTable-change-tip__title">Amount</div>
+      <div className="simpleTable-change-tip__detail">
+        {formatMoneyCell(h.money)}
+        {' → '}
+        <span className="simpleTable-change-tip__to">{formatMoneyCell(current)}</span>
+      </div>
+      <div className="simpleTable-change-tip__meta">
+        Changed on {formatChangeRecordedAt(preset)}
+      </div>
+    </div>
+  );
+}
+
+export function closeDateChangeTooltipTitle(
+  record: any,
+  current: unknown,
+): React.ReactNode {
+  const preset = record?.customItem247__c;
+  const h = record?.historyData as HistoryOppSnap | undefined;
+  if (!h) return null;
+  return (
+    <div className="simpleTable-change-tip">
+      <div className="simpleTable-change-tip__title">Close Date</div>
+      <div className="simpleTable-change-tip__detail">
+        {formatCloseDate(h.closeDate)}
+        {' → '}
+        <span className="simpleTable-change-tip__to">{formatCloseDate(current)}</span>
+      </div>
+      <div className="simpleTable-change-tip__meta">
+        Changed on {formatChangeRecordedAt(preset)}
+      </div>
+    </div>
+  );
+}
+
+export function renderTrendCell(args: {
+  displayText: string;
+  trend: Trend | null;
+  tooltip: React.ReactNode;
+}): React.ReactNode {
+  const { displayText, trend, tooltip } = args;
+  const showArrow = trend === 'up' || trend === 'down';
+  const arrow =
+    trend === 'up' ? (
+      <span className="simpleTable-trend simpleTable-trend--up">↑</span>
+    ) : trend === 'down' ? (
+      <span className="simpleTable-trend simpleTable-trend--down">↓</span>
+    ) : null;
+
+  return (
+    <span className="simpleTable-cell-trend-wrap">
+      <span className="simpleTable-cell-trend-wrap__text">{displayText}</span>
+      {showArrow && arrow ? (
+        <Popover
+          content={tooltip}
+          trigger="hover"
+          placement="top"
+          overlayClassName="simpleTable-change-popover"
+          mouseEnterDelay={0.08}
+        >
+          <span className="simpleTable-cell-trend-wrap__arrow">{arrow}</span>
+        </Popover>
+      ) : null}
+    </span>
+  );
+}
+
+/** demo.html winRateTooltip 风格 */
+export function renderWinRateHoverCard(record: any): React.ReactNode {
+  const baseline = record?.customItem244__c;
+  const positives = record?.customItem241__c;
+  const negatives = record?.customItem242__c;
+  const winRate = record?.customItem239__c;
+
+  const fmtLine = (v: unknown) =>
+    v == null || v === '' ? '—' : String(v);
+
+  return (
+    <Card
+      size="small"
+      bordered={false}
+      className="simpleTable-winrate-card"
+    >
+      <div className="simpleTable-winrate-card__baseline">
+        Baseline Probability{' '}
+        <span className="simpleTable-winrate-card__baseline-val">
+          {formatPercentCell(baseline)}
+        </span>
+      </div>
+      <hr className="simpleTable-winrate-card__hr" />
+      <div className="simpleTable-winrate-card__section-title">Positive Factors</div>
+      <div className="simpleTable-winrate-card__positives">
+        {fmtLine(positives)}
+      </div>
+      <hr className="simpleTable-winrate-card__hr" />
+      <div className="simpleTable-winrate-card__section-title">Negative Factors</div>
+      <div className="simpleTable-winrate-card__negatives">
+        {fmtLine(negatives)}
+      </div>
+      <hr className="simpleTable-winrate-card__hr" />
+      <div className="simpleTable-winrate-card__footer">
+        <span>AI Win Rate</span>
+        <span className="simpleTable-winrate-card__winrate-val">
+          {formatPercentCell(winRate)}
+        </span>
+      </div>
+    </Card>
+  );
+}
+
+/** 汇总金额展示（与 formatMoneyCell 数字格式一致） */
+export function formatMoneySummaryAmount(n: number): string {
+  const part = Number.isInteger(n)
+    ? n.toLocaleString('en-US')
+    : n.toLocaleString('en-US', {
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 2,
+      });
+  return `$${part}`;
+}
+
+/** 按字段 apiKey 汇总行金额（解析规则与金额列一致） */
+export function sumMoneyRows(rows: any[], moneyFieldKey: string): number {
+  let total = 0;
+  for (const row of rows) {
+    const v = row?.[moneyFieldKey];
+    if (v == null || v === '') continue;
+    const n = parseFloat(String(v).replace(/,/g, '').trim());
+    if (Number.isFinite(n)) total += n;
+  }
+  return total;
+}
+
+export function isMoneyField(field: FieldInfo): boolean {
+  const k = field.apiKey?.toLowerCase?.() ?? '';
+  if (k === 'money' || k === 'amount') return true;
+  if (field.type === 'currency' || field.itemType === 'currency') return true;
+  return false;
+}
+
+export { moneyTrend, closeDateTrend };

package/template/neo-bi-cmps/src/utils/stageSwitch.ts

@@ -0,0 +1,15 @@
+/**
+ * 阶段切换 stageSwitch 专用（商机行字段解析）
+ */
+import { parseNumberOrZero } from './common';
+
+export function rowOpportunityStage(row: Record<string, unknown>): string {
+  return String(row.customItem248__c ?? '');
+}
+
+export function rowMoney(row: Record<string, unknown>): number {
+  if (row.money !== undefined && row.money !== null && row.money !== '') {
+    return parseNumberOrZero(row.money);
+  }
+  return parseNumberOrZero(row.amount);
+}

package/template/neo-bi-cmps/src/utils/stageTimeChart.ts

@@ -0,0 +1,90 @@
+/**
+ * 阶段停留时间 stageTimeChart 专用
+ */
+import { extractStageKeyFromStageName } from './common';
+
+const COLOR_GREEN = '#22c55e';
+const COLOR_YELLOW = '#eab308';
+const COLOR_RED = '#ef4444';
+const COLOR_NEUTRAL = '#94a3b8';
+
+export interface StageTimeRow {
+  stageName: string;
+  actualTime: number;
+  actualTimeDisplay: string;
+  targetPercent: number;
+  limitPercent: number;
+}
+
+export interface StageTimeItem {
+  stageName: string;
+  actualTime: string;
+  actualPercent: number;
+  actualColor: string;
+  barActualWidthPct: number;
+  barTargetLeftPct: number;
+  barLimitLeftPct: number;
+}
+
+/**
+ * 将「16天11小时」「8天6时」等文案转为天数（浮点），如 16 + 11/24
+ */
+export function parseDurationToDays(text: unknown): number {
+  const s = String(text ?? '').trim();
+  if (!s) return 0;
+  let days = 0;
+  let hours = 0;
+  const dayMatch = s.match(/(\d+(?:\.\d+)?)\s*(天|Day)/);
+  if (dayMatch) days = parseFloat(dayMatch[1]) || 0;
+  const hourMatch = s.match(/(\d+(?:\.\d+)?)\s*(?:小时|时|Hour)/);
+  if (hourMatch) hours = parseFloat(hourMatch[1]) || 0;
+  return days + hours / 24;
+}
+
+/** 终局阶段不参与「阶段停留时间」展示 */
+export function isClosedOutcomeStage(stageName: string): boolean {
+  const key = extractStageKeyFromStageName(stageName).toLowerCase();
+  return key === 'closed won' || key === 'closed lost';
+}
+
+/** 配色：实际天数与 customItem3（目标）/customItem4（上限）比较 */
+export function resolveActualColor(
+  actualDays: number,
+  target: number,
+  limit: number,
+): string {
+  if (actualDays <= target) return COLOR_GREEN;
+  if (actualDays > limit) return COLOR_RED;
+  return COLOR_YELLOW;
+}
+
+/** 将解析后的行转为图表条数据（配色与条形比例） */
+export function buildStageTimeItems(rows: StageTimeRow[]): StageTimeItem[] {
+  return rows.map((row) => {
+    const actualPercent = row.actualTime;
+    const hasTh =
+      Number.isFinite(row.targetPercent) && Number.isFinite(row.limitPercent);
+    let targetNum = row.targetPercent;
+    let limitNum = row.limitPercent;
+    let actualColor: string;
+    const scaleMax = 60;
+
+    if (hasTh) {
+      actualColor = resolveActualColor(actualPercent, targetNum, limitNum);
+    } else {
+      targetNum = 0;
+      limitNum = 0;
+      actualColor = COLOR_NEUTRAL;
+    }
+
+    return {
+      stageName: row.stageName,
+      actualTime: row.actualTimeDisplay,
+      actualPercent,
+      actualColor,
+      barActualWidthPct: Math.min(100, (actualPercent / scaleMax) * 100),
+      barTargetLeftPct: hasTh ? (targetNum / scaleMax) * 100 : 0,
+      barLimitLeftPct: hasTh ? (limitNum / scaleMax) * 100 : 0,
+    };
+  });
+}

package/template/neo-bi-cmps/src/utils/targetNumber.ts

@@ -0,0 +1,12 @@
+/**
+ * 数值指标 targetNumber：样式辅助
+ */
+
+/** margin/padding 字符串：无单位时补上 quantity，已有 px/rem等则原样返回 */
+export function formatCssSpacing(value: string, unit: string): string {
+  if (!value || value === '0') return '0';
+  if (/\d+(px|rem|em|%)$/.test(value.trim())) {
+    return value;
+  }
+  return `${value}${unit}`;
+}

package/template/neo-custom-cmp-template/docs/README.md

@@ -11,234 +11,3 @@
 - [查询接口（通用查询接口）](https://doc.xiaoshouyi.com/#/proMan/workplaceDetailApi?url=%2F%2Fconcepts%2Fapi_queryInterfaceDescription.html&id=1405&dir=output_1757929564205&time=1758784491846): /rest/data/v2/query;
 - [获取业务类型描述](https://doc.xiaoshouyi.com/?sso-domain=login-cd.xiaoshouyi.com#/proMan/workplaceDetailApi?url=%2F%2Fconcepts%2Fapi_paas_customObject_getBusinessTypeDescription.html&id=1405&dir=output_1757929564205&time=1758798530511): /rest/data/v2.0/xobjects/{xObjectApiKey}/busiType;
 - 更多可用接口见[文档](https://doc.xiaoshouyi.com/#/proMan/workplaceDetailApi?url=%2F%2Fconcepts%2Fapi_apiIntroduction.html&id=1405&dir=output_1757929564205)。
-
-## Open API 请求方法
-
-### 基础请求工具
-
-#### axiosFetcher
-基于 axios 封装的通用请求工具，支持 GET、POST、PATCH、DELETE 等请求方法。
-
-```typescript
-import axiosFetcher from '@/utils/axiosFetcher';
-
-// 基本用法
-const result = await axiosFetcher({
-  url: '/api/endpoint',
-  method: 'GET',
-  data: { key: 'value' },
-  headers: { 'Custom-Header': 'value' },
-  timeout: 30000
-});
-```
-
-**参数说明：**
-- `url`: 请求地址
-- `method`: 请求方法，默认为 'GET'
-- `data`: 请求数据，GET 请求会转为 params
-- `headers`: 请求头，默认包含 'Content-Type': 'application/json'
-- `timeout`: 超时时间，默认 30000ms
-
-### 业务对象相关接口
-
-#### 1. 查询业务对象数据列表 (queryXObjectData)
-使用通用查询接口获取业务对象数据，支持分页和排序。
-
-```typescript
-import { queryXObjectData } from '@/utils/queryObjectData';
-
-// 基本查询
-const result = await queryXObjectData({
-  xObjectApiKey: 'Contact', // 业务对象 API Key
-  fields: ['name', 'phone', 'email'], // 查询字段
-  page: 1, // 页码
-  pageSize: 10, // 每页数量
-  orderBy: 'name asc' // 排序条件（可选）
-});
-```
-
-**参数说明：**
-- `xObjectApiKey`: 业务对象的 API Key
-- `fields`: 需要查询的字段数组，会自动添加 'id' 字段
-- `page`: 页码，默认为 1
-- `pageSize`: 每页数量，默认为 10
-- `orderBy`: 排序条件，如 'name asc' 或 'createdTime desc'
-
-**返回结果：**
-```typescript
-{
-  code: 200,
-  result: {
-    // 查询结果数据
-    records: any[],
-    // 分页信息
-    totalSize: number, // 总个数
-  }
-}
-```
-
-#### 2. 获取业务类型列表 (getEntityTypeList)
-获取指定业务对象的业务类型列表。
-
-```typescript
-import { getEntityTypeList } from '@/utils/xobjects';
-
-const result = await getEntityTypeList('Contact', {
-  // 其他请求选项
-});
-```
-
-**参数说明：**
-- `xObjectApiKey`: 业务对象的 API Key
-- `options`: 可选的请求配置
-
-#### 3. 获取对象列表 (getEntityList)
-获取系统中的对象列表，支持标准对象和自定义对象。
-
-```typescript
-import { getEntityList } from '@/utils/xobjects';
-
-// 获取标准对象列表
-const standardObjects = await getEntityList({
-  custom: false, // 获取标准对象
-  active: true   // 仅获取有权限的对象
-});
-
-// 获取自定义对象列表
-const customObjects = await getEntityList({
-  custom: true,  // 获取自定义对象
-  active: true   // 仅获取有权限的对象
-});
-```
-
-**参数说明：**
-- `custom`: 是否获取自定义对象，false 为标准对象，true 为自定义对象
-- `active`: 是否仅获取有权限的对象，默认为 true
-
-#### 4. 创建业务数据 (createXObject)
-创建新的业务数据记录。
-
-```typescript
-import { createXObject } from '@/utils/xobjects';
-
-const result = await createXObject('Contact', {
-  method: 'POST',
-  data: {
-    name: '张三',
-    phone: '13800138000',
-    email: 'zhangsan@example.com'
-  }
-});
-```
-
-**参数说明：**
-- `xObjectApiKey`: 业务对象的 API Key
-- `options.data`: 要创建的数据对象
-- `options.method`: 请求方法，默认为 'GET'（建议使用 'POST'）
-
-#### 5. 更新业务数据 (updateXObject)
-更新指定的业务数据记录。
-
-```typescript
-import { updateXObject } from '@/utils/xobjects';
-
-const result = await updateXObject('Contact', '12345', {
-  method: 'PATCH',
-  data: {
-    name: '李四',
-    phone: '13900139000'
-  }
-});
-```
-
-**参数说明：**
-- `xObjectApiKey`: 业务对象的 API Key
-- `objectId`: 要更新的记录 ID
-- `options.data`: 要更新的数据对象
-- `options.method`: 请求方法，默认为 'PATCH'
-
-#### 6. 获取业务数据信息 (getXObject)
-获取指定业务数据记录的详细信息。
-
-```typescript
-import { getXObject } from '@/utils/xobjects';
-
-const result = await getXObject('Contact', '12345', {
-  // 其他请求选项
-});
-```
-
-**参数说明：**
-- `xObjectApiKey`: 业务对象的 API Key
-- `objectId`: 要获取的记录 ID
-- `options`: 可选的请求配置
-
-#### 7. 删除业务数据 (deleteXObject)
-删除指定的业务数据记录。
-
-```typescript
-import { deleteXObject } from '@/utils/xobjects';
-
-const result = await deleteXObject('Contact', '12345');
-```
-
-**参数说明：**
-- `xObjectApiKey`: 业务对象的 API Key
-- `objectId`: 要删除的记录 ID
-
-#### 8. 获取业务对象描述 (getXObjectDesc)
-获取业务对象的描述信息。
-
-```typescript
-import { getXObjectDesc } from '@/utils/xobjects';
-
-const result = await getXObjectDesc('Contact');
-```
-
-**参数说明：**
-- `xObjectApiKey`: 业务对象的 API Key
-
-### 使用示例
-
-```typescript
-import { 
-  queryXObjectData, 
-  createXObject, 
-  updateXObject, 
-  getXObject, 
-  deleteXObject 
-} from '@/utils/xobjects';
-
-// 查询联系人列表
-const contacts = await queryXObjectData({
-  xObjectApiKey: 'Contact',
-  fields: ['name', 'phone', 'email'],
-  page: 1,
-  pageSize: 20,
-  orderBy: 'createdTime desc'
-});
-
-// 创建新联系人
-const newContact = await createXObject('Contact', {
-  method: 'POST',
-  data: {
-    name: '王五',
-    phone: '13700137000',
-    email: 'wangwu@example.com'
-  }
-});
-
-// 更新联系人
-const updatedContact = await updateXObject('Contact', newContact.id, {
-  data: {
-    name: '王五（更新）'
-  }
-});
-
-// 获取联系人详情
-const contactDetail = await getXObject('Contact', newContact.id);
-
-// 删除联系人
-await deleteXObject('Contact', newContact.id);
-```
-