feat(crm): 新增独立潜客经营与漏斗统计中心(pages/owner/stats.uvue),解耦高频潜客管理并支持全渠道转化分析
这个提交包含在:
270
mpuniapp/pages/owner/useStats.uts
普通文件
270
mpuniapp/pages/owner/useStats.uts
普通文件
@@ -0,0 +1,270 @@
|
||||
/**
|
||||
* OmniCard AI (CRMmp) - 名片主独立数据统计与销售漏斗业务驱动层
|
||||
* 纯函数计算转化率、漏斗阶段折损、渠道成效矩阵与国际化
|
||||
*/
|
||||
|
||||
import { LeadEntity, OwnerPageQuery } from '../../common/types.uts';
|
||||
import { fetchOwnerLeadPage } from '../../common/api.uts';
|
||||
import { getCurrentLocale, getOmniText } from '../../common/locale.uts';
|
||||
|
||||
export type StatsPeriod = 'today' | '7d' | '30d' | 'all';
|
||||
|
||||
export type FunnelStep = {
|
||||
key: string;
|
||||
label: string;
|
||||
count: number;
|
||||
rate: number;
|
||||
};
|
||||
|
||||
export type ChannelMetric = {
|
||||
source: 'nfc' | 'qr' | 'link' | 'ai_chat';
|
||||
label: string;
|
||||
leadsCount: number;
|
||||
wonCount: number;
|
||||
conversionRate: number;
|
||||
};
|
||||
|
||||
export type StatsSummary = {
|
||||
totalLeads: number;
|
||||
hotLeads: number;
|
||||
wonLeads: number;
|
||||
overallRate: number;
|
||||
};
|
||||
|
||||
export type StatsState = {
|
||||
period: StatsPeriod;
|
||||
summary: StatsSummary;
|
||||
funnel: FunnelStep[];
|
||||
channels: ChannelMetric[];
|
||||
loading: boolean;
|
||||
errorMessage: string;
|
||||
};
|
||||
|
||||
function isZhLocale(): boolean {
|
||||
return getCurrentLocale() === 'zh-CN';
|
||||
}
|
||||
|
||||
export function calcConversionRate(total: number, won: number): number {
|
||||
if (total <= 0 || won <= 0) {
|
||||
return 0;
|
||||
}
|
||||
const rate = (won / total) * 100;
|
||||
return Math.round(rate * 10) / 10;
|
||||
}
|
||||
|
||||
export function calcFunnelStepRate(currentCount: number, baseCount: number): number {
|
||||
if (baseCount <= 0 || currentCount <= 0) {
|
||||
return 0;
|
||||
}
|
||||
const rate = (currentCount / baseCount) * 100;
|
||||
return Math.round(rate * 10) / 10;
|
||||
}
|
||||
|
||||
export function resolveStatsText(key: string): string {
|
||||
const locale = getCurrentLocale();
|
||||
if (key === 'title') {
|
||||
return isZhLocale() ? '经营与漏斗统计' : 'Pipeline & Analytics';
|
||||
}
|
||||
if (key === 'subtitle') {
|
||||
return isZhLocale() ? '全渠道商机转化与意向大盘' : 'Full-funnel lead insights & radar score';
|
||||
}
|
||||
if (key === 'empty') {
|
||||
return getOmniText(locale, 'common.empty');
|
||||
}
|
||||
if (key === 'error') {
|
||||
return getOmniText(locale, 'common.error');
|
||||
}
|
||||
if (key === 'loading') {
|
||||
return getOmniText(locale, 'common.loading');
|
||||
}
|
||||
if (key === 'retry') {
|
||||
return getOmniText(locale, 'portal.retry');
|
||||
}
|
||||
|
||||
// Periods
|
||||
if (key === 'periodToday') {
|
||||
return isZhLocale() ? '今日' : 'Today';
|
||||
}
|
||||
if (key === 'period7d') {
|
||||
return isZhLocale() ? '近7天' : '7 Days';
|
||||
}
|
||||
if (key === 'period30d') {
|
||||
return isZhLocale() ? '近30天' : '30 Days';
|
||||
}
|
||||
if (key === 'periodAll') {
|
||||
return isZhLocale() ? '全部' : 'All Time';
|
||||
}
|
||||
|
||||
// Funnel & Metrics
|
||||
if (key === 'metricTotal') {
|
||||
return isZhLocale() ? '潜客总量' : 'Total Leads';
|
||||
}
|
||||
if (key === 'metricHot') {
|
||||
return isZhLocale() ? '高意向商机' : 'High Intent';
|
||||
}
|
||||
if (key === 'metricWon') {
|
||||
return isZhLocale() ? '签约成交' : 'Deals Won';
|
||||
}
|
||||
if (key === 'metricRate') {
|
||||
return isZhLocale() ? '综合转化率' : 'Conversion';
|
||||
}
|
||||
if (key === 'funnelTitle') {
|
||||
return isZhLocale() ? '商机转化漏斗' : 'Pipeline Funnel';
|
||||
}
|
||||
if (key === 'channelTitle') {
|
||||
return isZhLocale() ? '获客渠道成效' : 'Acquisition Channels';
|
||||
}
|
||||
if (key === 'stepNew') {
|
||||
return isZhLocale() ? '新建线索' : 'New Leads';
|
||||
}
|
||||
if (key === 'stepHot') {
|
||||
return isZhLocale() ? '高意向' : 'Hot Intent';
|
||||
}
|
||||
if (key === 'stepContacted') {
|
||||
return isZhLocale() ? '已接洽' : 'Contacted';
|
||||
}
|
||||
if (key === 'stepWon') {
|
||||
return isZhLocale() ? '赢单成单' : 'Deals Won';
|
||||
}
|
||||
if (key === 'sourceNfc') {
|
||||
return isZhLocale() ? 'NFC 贴卡' : 'NFC Touch';
|
||||
}
|
||||
if (key === 'sourceQr') {
|
||||
return isZhLocale() ? '海报码' : 'Poster QR';
|
||||
}
|
||||
if (key === 'sourceLink') {
|
||||
return isZhLocale() ? '直链分享' : 'Direct Link';
|
||||
}
|
||||
if (key === 'sourceAi') {
|
||||
return isZhLocale() ? 'AI顾问' : 'AI Concierge';
|
||||
}
|
||||
|
||||
return key;
|
||||
}
|
||||
|
||||
export function createStatsState(): StatsState {
|
||||
return {
|
||||
period: 'all',
|
||||
summary: {
|
||||
totalLeads: 0,
|
||||
hotLeads: 0,
|
||||
wonLeads: 0,
|
||||
overallRate: 0,
|
||||
},
|
||||
funnel: [
|
||||
{ key: 'new', label: resolveStatsText('stepNew'), count: 0, rate: 0 },
|
||||
{ key: 'hot', label: resolveStatsText('stepHot'), count: 0, rate: 0 },
|
||||
{ key: 'contacted', label: resolveStatsText('stepContacted'), count: 0, rate: 0 },
|
||||
{ key: 'won', label: resolveStatsText('stepWon'), count: 0, rate: 0 },
|
||||
],
|
||||
channels: [
|
||||
{ source: 'nfc', label: resolveStatsText('sourceNfc'), leadsCount: 0, wonCount: 0, conversionRate: 0 },
|
||||
{ source: 'qr', label: resolveStatsText('sourceQr'), leadsCount: 0, wonCount: 0, conversionRate: 0 },
|
||||
{ source: 'link', label: resolveStatsText('sourceLink'), leadsCount: 0, wonCount: 0, conversionRate: 0 },
|
||||
{ source: 'ai_chat', label: resolveStatsText('sourceAi'), leadsCount: 0, wonCount: 0, conversionRate: 0 },
|
||||
],
|
||||
loading: false,
|
||||
errorMessage: '',
|
||||
};
|
||||
}
|
||||
|
||||
export function computeStatsFromLeads(leads: LeadEntity[], period: StatsPeriod): StatsState {
|
||||
const state = createStatsState();
|
||||
state.period = period;
|
||||
|
||||
let totalCount = 0;
|
||||
let hotCount = 0;
|
||||
let newCount = 0;
|
||||
let contactedCount = 0;
|
||||
let wonCount = 0;
|
||||
|
||||
const channelMap: Record<string, { leads: number; won: number }> = {
|
||||
nfc: { leads: 0, won: 0 },
|
||||
qr: { leads: 0, won: 0 },
|
||||
link: { leads: 0, won: 0 },
|
||||
ai_chat: { leads: 0, won: 0 },
|
||||
};
|
||||
|
||||
for (let i = 0; i < leads.length; i++) {
|
||||
const item = leads[i];
|
||||
totalCount++;
|
||||
|
||||
if (item.status === 'hot' || item.intentScore >= 80) {
|
||||
hotCount++;
|
||||
}
|
||||
if (item.status === 'new') {
|
||||
newCount++;
|
||||
} else if (item.status === 'contacted') {
|
||||
contactedCount++;
|
||||
} else if (item.status === 'won') {
|
||||
wonCount++;
|
||||
}
|
||||
|
||||
const src = item.source != null ? item.source : 'link';
|
||||
if (channelMap[src] != null) {
|
||||
channelMap[src].leads++;
|
||||
if (item.status === 'won') {
|
||||
channelMap[src].won++;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
state.summary.totalLeads = totalCount;
|
||||
state.summary.hotLeads = hotCount;
|
||||
state.summary.wonLeads = wonCount;
|
||||
state.summary.overallRate = calcConversionRate(totalCount, wonCount);
|
||||
|
||||
// 漏斗阶梯与转化率
|
||||
state.funnel[0].count = totalCount;
|
||||
state.funnel[0].rate = totalCount > 0 ? 100 : 0;
|
||||
|
||||
state.funnel[1].count = hotCount;
|
||||
state.funnel[1].rate = calcFunnelStepRate(hotCount, totalCount);
|
||||
|
||||
state.funnel[2].count = contactedCount;
|
||||
state.funnel[2].rate = calcFunnelStepRate(contactedCount, totalCount);
|
||||
|
||||
state.funnel[3].count = wonCount;
|
||||
state.funnel[3].rate = calcFunnelStepRate(wonCount, totalCount);
|
||||
|
||||
// 渠道成效
|
||||
state.channels[0].leadsCount = channelMap['nfc'].leads;
|
||||
state.channels[0].wonCount = channelMap['nfc'].won;
|
||||
state.channels[0].conversionRate = calcConversionRate(channelMap['nfc'].leads, channelMap['nfc'].won);
|
||||
|
||||
state.channels[1].leadsCount = channelMap['qr'].leads;
|
||||
state.channels[1].wonCount = channelMap['qr'].won;
|
||||
state.channels[1].conversionRate = calcConversionRate(channelMap['qr'].leads, channelMap['qr'].won);
|
||||
|
||||
state.channels[2].leadsCount = channelMap['link'].leads;
|
||||
state.channels[2].wonCount = channelMap['link'].won;
|
||||
state.channels[2].conversionRate = calcConversionRate(channelMap['link'].leads, channelMap['link'].won);
|
||||
|
||||
state.channels[3].leadsCount = channelMap['ai_chat'].leads;
|
||||
state.channels[3].wonCount = channelMap['ai_chat'].won;
|
||||
state.channels[3].conversionRate = calcConversionRate(channelMap['ai_chat'].leads, channelMap['ai_chat'].won);
|
||||
|
||||
return state;
|
||||
}
|
||||
|
||||
export async function loadStatsData(state: StatsState): Promise<void> {
|
||||
state.loading = true;
|
||||
state.errorMessage = '';
|
||||
|
||||
try {
|
||||
const query: OwnerPageQuery = {
|
||||
page: 1,
|
||||
size: 100,
|
||||
};
|
||||
const res = await fetchOwnerLeadPage(query);
|
||||
const computed = computeStatsFromLeads(res.list, state.period);
|
||||
state.summary = computed.summary;
|
||||
state.funnel = computed.funnel;
|
||||
state.channels = computed.channels;
|
||||
} catch (err: unknown) {
|
||||
const msg = err instanceof Error ? err.message : String(err);
|
||||
state.errorMessage = msg !== '' ? msg : resolveStatsText('error');
|
||||
} finally {
|
||||
state.loading = false;
|
||||
}
|
||||
}
|
||||
在新工单中引用
屏蔽一个用户