Add lead funnel, stage conversion, and dwell reports to the report builder.
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -37,12 +37,14 @@ import type {
|
||||
ReportsFunnelStageDto,
|
||||
ReportsPeriodCompareRowDto,
|
||||
ReportsViewFilters,
|
||||
ReportsLeadsAnalyticsDto,
|
||||
SavedViewDto,
|
||||
TahesabConnectionDto,
|
||||
TeamDto,
|
||||
} from '@mento/shared';
|
||||
import {
|
||||
brand,
|
||||
isReportsLeadBuilderMetric,
|
||||
REPORTS_BUILDER_DIMENSION_LABELS,
|
||||
REPORTS_BUILDER_DIMENSIONS,
|
||||
REPORTS_BUILDER_METRIC_LABELS,
|
||||
@@ -50,7 +52,7 @@ import {
|
||||
} from '@mento/shared';
|
||||
|
||||
type PeriodKey = 'today' | 'week' | 'month' | 'quarter' | 'year' | 'custom';
|
||||
type PageMode = 'dashboard' | 'builder';
|
||||
type PageMode = 'dashboard' | 'builder' | 'leads';
|
||||
|
||||
const PERIODS: Array<{ key: PeriodKey; label: string }> = [
|
||||
{ key: 'today', label: 'امروز' },
|
||||
@@ -105,12 +107,31 @@ const builderTeamId = ref('');
|
||||
const builderLoading = ref(false);
|
||||
const builderError = ref('');
|
||||
const builderResult = ref<ReportsBuilderResultDto | null>(null);
|
||||
const leadsData = ref<ReportsLeadsAnalyticsDto | null>(null);
|
||||
const leadsLoading = ref(false);
|
||||
const leadsError = ref('');
|
||||
const orgUsers = ref<OrgUserDto[]>([]);
|
||||
const orgTeams = ref<TeamDto[]>([]);
|
||||
const teamsAvailable = ref(true);
|
||||
/** ماژول تهحساب فعال + حداقل یک اتصال تنظیمشده */
|
||||
const hasTahesabSetup = ref(false);
|
||||
|
||||
const builderMetricOptions = computed(() => REPORTS_BUILDER_METRICS);
|
||||
const builderDimensionOptions = computed(() => {
|
||||
if (isReportsLeadBuilderMetric(builderMetric.value)) {
|
||||
return REPORTS_BUILDER_DIMENSIONS.filter(
|
||||
(d) =>
|
||||
d === 'none' ||
|
||||
d === 'owner' ||
|
||||
d === 'team' ||
|
||||
d === 'source' ||
|
||||
d === 'lead_stage' ||
|
||||
d === 'month',
|
||||
);
|
||||
}
|
||||
return REPORTS_BUILDER_DIMENSIONS.filter((d) => d !== 'lead_stage');
|
||||
});
|
||||
|
||||
const showTahesabSalesReport = computed(
|
||||
() =>
|
||||
Boolean(auth.user?.enabledModules?.includes('tahesab')) &&
|
||||
@@ -263,6 +284,7 @@ function applyPeriod(key: PeriodKey, opts?: { keepView?: boolean }) {
|
||||
}
|
||||
void load().then(() => {
|
||||
if (pageMode.value === 'builder') void runBuilder();
|
||||
if (pageMode.value === 'leads') void loadLeads();
|
||||
});
|
||||
}
|
||||
|
||||
@@ -351,7 +373,12 @@ async function loadSavedViews() {
|
||||
}
|
||||
|
||||
function applyFilters(filters: ReportsViewFilters, keepView: boolean) {
|
||||
pageMode.value = filters.mode === 'builder' ? 'builder' : 'dashboard';
|
||||
pageMode.value =
|
||||
filters.mode === 'builder'
|
||||
? 'builder'
|
||||
: filters.mode === 'leads'
|
||||
? 'leads'
|
||||
: 'dashboard';
|
||||
if (filters.builder) {
|
||||
const m = filters.builder.metric;
|
||||
const d = filters.builder.dimension;
|
||||
@@ -373,6 +400,7 @@ function applyFilters(filters: ReportsViewFilters, keepView: boolean) {
|
||||
|
||||
const afterRange = () => {
|
||||
if (pageMode.value === 'builder') void runBuilder();
|
||||
if (pageMode.value === 'leads') void loadLeads();
|
||||
};
|
||||
|
||||
const p = PERIOD_KEYS.has(filters.period as PeriodKey)
|
||||
@@ -440,12 +468,46 @@ async function runBuilder() {
|
||||
}
|
||||
}
|
||||
|
||||
async function loadLeads() {
|
||||
leadsLoading.value = true;
|
||||
leadsError.value = '';
|
||||
try {
|
||||
const { data: res } = await api.get<ReportsLeadsAnalyticsDto>('/reports/leads', {
|
||||
params: {
|
||||
from: from.value || undefined,
|
||||
to: to.value || undefined,
|
||||
},
|
||||
});
|
||||
leadsData.value = res;
|
||||
} catch (e) {
|
||||
leadsData.value = null;
|
||||
leadsError.value = axios.isAxiosError(e)
|
||||
? String(
|
||||
(e.response?.data as { message?: string })?.message ??
|
||||
'بارگذاری گزارش لیدها ناموفق بود.',
|
||||
)
|
||||
: 'بارگذاری گزارش لیدها ناموفق بود.';
|
||||
} finally {
|
||||
leadsLoading.value = false;
|
||||
}
|
||||
}
|
||||
|
||||
function setPageMode(mode: PageMode) {
|
||||
pageMode.value = mode;
|
||||
if (mode === 'builder' && !builderResult.value) void runBuilder();
|
||||
if (mode === 'dashboard' && !data.value) void load();
|
||||
if (mode === 'leads') void loadLeads();
|
||||
}
|
||||
|
||||
watch(builderMetric, (metric) => {
|
||||
const allowed = builderDimensionOptions.value;
|
||||
if (!allowed.includes(builderDimension.value)) {
|
||||
builderDimension.value = isReportsLeadBuilderMetric(metric)
|
||||
? 'lead_stage'
|
||||
: 'owner';
|
||||
}
|
||||
});
|
||||
|
||||
const builderChartOption = computed<UiChartOption>(() => {
|
||||
const rows = (builderResult.value?.rows ?? []).slice(0, 12);
|
||||
const isMoney = builderResult.value?.format === 'money';
|
||||
@@ -705,6 +767,47 @@ function exportReport() {
|
||||
return;
|
||||
}
|
||||
|
||||
if (pageMode.value === 'leads') {
|
||||
if (!leadsData.value) return;
|
||||
const l = leadsData.value;
|
||||
const lines: string[] = [
|
||||
`گزارش لیدها ${brand.nameFa}`,
|
||||
`بازه,${rangeLabel()}`,
|
||||
`ایجادشده,${l.created}`,
|
||||
`تبدیلشده,${l.converted}`,
|
||||
`ازدسترفته,${l.lost}`,
|
||||
`فعال,${l.active}`,
|
||||
`نرخ تبدیل,${l.conversionRate}`,
|
||||
'',
|
||||
'قیف,تعداد,سهم٪,نسبت به قبلی٪,میانگین ماندن ساعت',
|
||||
...l.funnel.map(
|
||||
(r) =>
|
||||
`${r.stageName},${r.count},${r.sharePercent},${r.conversionFromPrevPercent ?? ''},${r.avgDwellHours ?? ''}`,
|
||||
),
|
||||
'',
|
||||
'از,به,تعداد,٪ خروجی مبدأ',
|
||||
...l.transitions.map(
|
||||
(r) =>
|
||||
`${r.fromStageName},${r.toStageName},${r.count},${r.conversionPercent}`,
|
||||
),
|
||||
'',
|
||||
'ستون,میانگین ساعت,نمونه',
|
||||
...l.dwellByStage.map(
|
||||
(r) => `${r.stageName},${r.avgHours},${r.sampleCount}`,
|
||||
),
|
||||
];
|
||||
const blob = new Blob(['\ufeff' + lines.join('\n')], {
|
||||
type: 'text/csv;charset=utf-8',
|
||||
});
|
||||
const url = URL.createObjectURL(blob);
|
||||
const a = document.createElement('a');
|
||||
a.href = url;
|
||||
a.download = `${brand.filePrefix}-leads-${from.value || 'from'}-${to.value || 'to'}.csv`;
|
||||
a.click();
|
||||
URL.revokeObjectURL(url);
|
||||
return;
|
||||
}
|
||||
|
||||
if (!data.value) return;
|
||||
const d = data.value;
|
||||
const lines: string[] = [
|
||||
@@ -1185,7 +1288,13 @@ const activityMax = computed(() =>
|
||||
</UiButton>
|
||||
<UiButton
|
||||
variant="primary"
|
||||
:disabled="pageMode === 'dashboard' ? !data : !builderResult"
|
||||
:disabled="
|
||||
pageMode === 'dashboard'
|
||||
? !data
|
||||
: pageMode === 'leads'
|
||||
? !leadsData
|
||||
: !builderResult
|
||||
"
|
||||
@click="exportReport"
|
||||
>
|
||||
<UiIcon name="document" :size="16" />
|
||||
@@ -1211,6 +1320,14 @@ const activityMax = computed(() =>
|
||||
>
|
||||
گزارشساز
|
||||
</button>
|
||||
<button
|
||||
type="button"
|
||||
class="mode-tab"
|
||||
:class="{ on: pageMode === 'leads' }"
|
||||
@click="setPageMode('leads')"
|
||||
>
|
||||
گزارش لیدها
|
||||
</button>
|
||||
</div>
|
||||
|
||||
<!-- Toolbar Filters -->
|
||||
@@ -1270,12 +1387,17 @@ const activityMax = computed(() =>
|
||||
syncViewQuery(null);
|
||||
load().then(() => {
|
||||
if (pageMode === 'builder') runBuilder();
|
||||
if (pageMode === 'leads') loadLeads();
|
||||
});
|
||||
"
|
||||
>
|
||||
<JalaliDateInput v-model="from" placeholder="از تاریخ" />
|
||||
<JalaliDateInput v-model="to" placeholder="تا تاریخ" />
|
||||
<UiButton variant="primary" type="submit" :disabled="loading || builderLoading">
|
||||
<UiButton
|
||||
variant="primary"
|
||||
type="submit"
|
||||
:disabled="loading || builderLoading || leadsLoading"
|
||||
>
|
||||
اعمال
|
||||
</UiButton>
|
||||
</form>
|
||||
@@ -1286,13 +1408,14 @@ const activityMax = computed(() =>
|
||||
<template v-if="pageMode === 'builder'">
|
||||
<UiCard class="builder-card" title="گزارشساز ساده">
|
||||
<p class="deep-hint">
|
||||
متریک و بُعد را انتخاب کنید؛ میتوانید بازه بالا و فیلتر کاربر/تیم را هم اعمال کنید.
|
||||
متریک و بُعد را انتخاب کنید (شامل متریکهای لید). میتوانید بازه بالا و فیلتر کاربر/تیم را هم
|
||||
اعمال کنید.
|
||||
</p>
|
||||
<div class="builder-form">
|
||||
<UiField label="متریک">
|
||||
<select v-model="builderMetric" class="builder-select">
|
||||
<option
|
||||
v-for="m in REPORTS_BUILDER_METRICS"
|
||||
v-for="m in builderMetricOptions"
|
||||
:key="m"
|
||||
:value="m"
|
||||
>
|
||||
@@ -1303,7 +1426,7 @@ const activityMax = computed(() =>
|
||||
<UiField label="گروهبندی (بُعد)">
|
||||
<select v-model="builderDimension" class="builder-select">
|
||||
<option
|
||||
v-for="d in REPORTS_BUILDER_DIMENSIONS"
|
||||
v-for="d in builderDimensionOptions"
|
||||
:key="d"
|
||||
:value="d"
|
||||
>
|
||||
@@ -1403,6 +1526,135 @@ const activityMax = computed(() =>
|
||||
</template>
|
||||
</template>
|
||||
|
||||
<!-- Leads analytics -->
|
||||
<template v-else-if="pageMode === 'leads'">
|
||||
<p v-if="leadsError" class="error">{{ leadsError }}</p>
|
||||
<div v-if="leadsLoading" class="loading-wrap">
|
||||
<div class="spinner"></div>
|
||||
<span>در حال بارگذاری گزارش لیدها...</span>
|
||||
</div>
|
||||
<template v-else-if="leadsData">
|
||||
<div class="kpis">
|
||||
<article class="kpi-card">
|
||||
<div class="kpi-top"><span class="kpi-label">ایجادشده در بازه</span></div>
|
||||
<strong class="kpi-val">{{ num(leadsData.created) }}</strong>
|
||||
</article>
|
||||
<article class="kpi-card">
|
||||
<div class="kpi-top"><span class="kpi-label">تبدیلشده</span></div>
|
||||
<strong class="kpi-val">{{ num(leadsData.converted) }}</strong>
|
||||
</article>
|
||||
<article class="kpi-card">
|
||||
<div class="kpi-top"><span class="kpi-label">ازدسترفته</span></div>
|
||||
<strong class="kpi-val">{{ num(leadsData.lost) }}</strong>
|
||||
</article>
|
||||
<article class="kpi-card">
|
||||
<div class="kpi-top"><span class="kpi-label">فعال فعلی</span></div>
|
||||
<strong class="kpi-val">{{ num(leadsData.active) }}</strong>
|
||||
</article>
|
||||
<article class="kpi-card">
|
||||
<div class="kpi-top"><span class="kpi-label">نرخ تبدیل بسته</span></div>
|
||||
<strong class="kpi-val">{{ toFaDigits(leadsData.conversionRate) }}٪</strong>
|
||||
<div class="kpi-change flat"><small>تبدیل ÷ (تبدیل + ازدسترفته)</small></div>
|
||||
</article>
|
||||
</div>
|
||||
|
||||
<div class="charts-grid">
|
||||
<UiCard class="chart-card span-2" title="قیف ستونهای لید (فعال فعلی)">
|
||||
<div class="table-wrap">
|
||||
<table class="crm-table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th>ستون</th>
|
||||
<th>تعداد</th>
|
||||
<th>سهم</th>
|
||||
<th>نسبت به قبلی</th>
|
||||
<th>میانگین ماندن (ساعت)</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr v-for="row in leadsData.funnel" :key="row.stageId">
|
||||
<td>{{ row.stageName }}</td>
|
||||
<td>{{ num(row.count) }}</td>
|
||||
<td>{{ toFaDigits(row.sharePercent) }}٪</td>
|
||||
<td>
|
||||
{{
|
||||
row.conversionFromPrevPercent == null
|
||||
? '—'
|
||||
: `${toFaDigits(row.conversionFromPrevPercent)}٪`
|
||||
}}
|
||||
</td>
|
||||
<td>
|
||||
{{
|
||||
row.avgDwellHours == null
|
||||
? '—'
|
||||
: toFaDigits(row.avgDwellHours)
|
||||
}}
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</UiCard>
|
||||
|
||||
<UiCard class="chart-card span-2" title="تبدیل بینمرحلهای در بازه">
|
||||
<p class="deep-hint">
|
||||
بر اساس جابهجاییهای ثبتشده (از → به). برای دادهٔ قدیمی بدون meta ممکن است خالی باشد.
|
||||
</p>
|
||||
<div v-if="!leadsData.transitions.length" class="deep-hint">
|
||||
انتقالی در این بازه ثبت نشده است.
|
||||
</div>
|
||||
<div v-else class="table-wrap">
|
||||
<table class="crm-table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th>از</th>
|
||||
<th>به</th>
|
||||
<th>تعداد</th>
|
||||
<th>٪ از خروجی مبدأ</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr
|
||||
v-for="(row, idx) in leadsData.transitions"
|
||||
:key="`${row.fromStageId}-${row.toStageId}-${idx}`"
|
||||
>
|
||||
<td>{{ row.fromStageName }}</td>
|
||||
<td>{{ row.toStageName }}</td>
|
||||
<td>{{ num(row.count) }}</td>
|
||||
<td>{{ toFaDigits(row.conversionPercent) }}٪</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</UiCard>
|
||||
|
||||
<UiCard class="chart-card span-2" title="میانگین زمان ماندن در هر ستون">
|
||||
<div v-if="!leadsData.dwellByStage.length" class="deep-hint">
|
||||
نمونهٔ کافی برای محاسبهٔ ماندگاری نیست.
|
||||
</div>
|
||||
<div v-else class="table-wrap">
|
||||
<table class="crm-table">
|
||||
<thead>
|
||||
<tr>
|
||||
<th>ستون</th>
|
||||
<th>میانگین ساعت</th>
|
||||
<th>تعداد نمونه</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr v-for="row in leadsData.dwellByStage" :key="row.stageId">
|
||||
<td>{{ row.stageName }}</td>
|
||||
<td>{{ toFaDigits(row.avgHours) }}</td>
|
||||
<td>{{ num(row.sampleCount) }}</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</UiCard>
|
||||
</div>
|
||||
</template>
|
||||
</template>
|
||||
|
||||
<!-- Dashboard mode -->
|
||||
<div v-else-if="loading" class="loading-wrap">
|
||||
<div class="spinner"></div>
|
||||
|
||||
Reference in New Issue
Block a user