cockpit.js 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457
  1. 'use strict';
  2. // 经营驾驶舱:KPI + 趋势 / 门店排行 / 转化漏斗 / 收入结构
  3. // 数据来自 GET /api/ops/dashboard(服务端已按统一口径聚合)
  4. (function () {
  5. const $ = (id) => document.getElementById(id);
  6. const COLORS = { main: '#ff6b35', soft: '#ffb08a', grey: '#b8b2ad', green: '#2e7d4f', red: '#c0392b' };
  7. const KPI_DEFS = [
  8. { key: 'revenue', label: '营业额', unit: 'money' },
  9. { key: 'orders', label: '有效订单', unit: 'int' },
  10. { key: 'avgTicket', label: '客单价', unit: 'money' },
  11. { key: 'exposure', label: '曝光人数', unit: 'int' },
  12. { key: 'conversion', label: '进店转化率', unit: 'rate' },
  13. { key: 'rating', label: '店铺评分', unit: 'num' },
  14. ];
  15. const state = {
  16. inited: false,
  17. loading: false,
  18. data: null,
  19. from: '',
  20. to: '',
  21. schools: null,
  22. shops: null,
  23. charts: {},
  24. insightPoints: [],
  25. };
  26. function esc(value) {
  27. const div = document.createElement('div');
  28. div.textContent = String(value == null ? '' : value);
  29. return div.innerHTML;
  30. }
  31. function ymdToInput(ymd) {
  32. const s = String(ymd || '');
  33. return /^\d{8}$/.test(s) ? `${s.slice(0, 4)}-${s.slice(4, 6)}-${s.slice(6, 8)}` : '';
  34. }
  35. function inputToYmd(value) {
  36. return String(value || '').replace(/-/g, '');
  37. }
  38. function shortDate(ymd) {
  39. const s = String(ymd || '');
  40. return /^\d{8}$/.test(s) ? `${Number(s.slice(4, 6))}.${Number(s.slice(6, 8))}` : s;
  41. }
  42. function fmtValue(value, unit) {
  43. if (value === null || value === undefined) return '–';
  44. const n = Number(value);
  45. if (!Number.isFinite(n)) return '–';
  46. if (unit === 'rate') return (n * 100).toFixed(2) + '%';
  47. if (unit === 'num') return n.toFixed(2);
  48. if (unit === 'money') return n.toLocaleString('zh-CN', { minimumFractionDigits: 2, maximumFractionDigits: 2 });
  49. return n.toLocaleString('zh-CN');
  50. }
  51. function fmtDelta(delta, unit) {
  52. if (delta === null || delta === undefined) return '<span class="ckpt-delta muted">—</span>';
  53. const up = delta > 0;
  54. const cls = delta === 0 ? 'muted' : (up ? 'up' : 'down');
  55. const arrow = delta === 0 ? '' : (up ? '↑' : '↓');
  56. const text = unit === 'pp' ? Math.abs(delta).toFixed(1) + 'pp' : Math.abs(delta).toFixed(1) + '%';
  57. return `<span class="ckpt-delta ${cls}">${arrow} ${text}</span>`;
  58. }
  59. async function api(url, options) {
  60. const res = await fetch(url, options);
  61. const body = await res.json().catch(() => null);
  62. return { res, body };
  63. }
  64. // ---------- 骨架 ----------
  65. function renderShell() {
  66. const root = $('cockpitRoot');
  67. if (!root) return;
  68. root.innerHTML = `
  69. <div class="ops-bar ckpt-bar">
  70. <div class="ops-bar-group">
  71. <span class="ops-bar-label">日期</span>
  72. <input type="date" class="ops-input" id="ckptFrom">
  73. <span class="ops-tilde">~</span>
  74. <input type="date" class="ops-input" id="ckptTo">
  75. </div>
  76. <div class="ops-bar-group"><span class="ops-bar-label">学校</span><div class="ops-multi" id="ckptSchool"></div></div>
  77. <div class="ops-bar-group"><span class="ops-bar-label">店铺</span><div class="ops-multi" id="ckptShop"></div></div>
  78. </div>
  79. <section class="ckpt-ai" id="ckptAi">
  80. <div class="ckpt-ai-head">
  81. <div class="ckpt-ai-title"><span class="ckpt-ai-badge">AI</span><h3>经营解读</h3><span class="ckpt-ai-meta" id="ckptAiMeta"></span></div>
  82. <div class="ckpt-ai-actions">
  83. <button class="btn btn-ghost btn-small" id="ckptAiCopy" hidden>复制</button>
  84. <button class="btn btn-primary btn-small" id="ckptAiBtn">生成解读</button>
  85. </div>
  86. </div>
  87. <div class="ckpt-ai-body" id="ckptAiBody">点击「生成解读」,模型会根据当前筛选范围的数据给出结论与建议。</div>
  88. </section>
  89. <div class="ckpt-kpis" id="ckptKpis"></div>
  90. <div class="ckpt-zero" id="ckptZero" hidden></div>
  91. <div class="ckpt-grid">
  92. <section class="ckpt-card"><div class="ckpt-card-head"><h3>营业额 / 订单趋势</h3><span id="ckptTrendNote"></span></div><div class="ckpt-chart" id="ckptTrend"></div></section>
  93. <section class="ckpt-card"><div class="ckpt-card-head"><h3>门店营业额 Top 10</h3><span></span></div><div class="ckpt-chart" id="ckptRank"></div></section>
  94. <section class="ckpt-card"><div class="ckpt-card-head"><h3>转化漏斗</h3><span>曝光 → 进店 → 下单</span></div><div class="ckpt-chart" id="ckptFunnel"></div></section>
  95. <section class="ckpt-card"><div class="ckpt-card-head"><h3>收入结构</h3><span>收入 / 支出 / 补贴</span></div><div class="ckpt-chart" id="ckptStructure"></div></section>
  96. </div>
  97. <div class="ckpt-empty" id="ckptEmpty" hidden>
  98. <p>所选范围没有数据</p>
  99. <small>调整日期,或换一个学校 / 店铺</small>
  100. </div>`;
  101. $('ckptAiBtn').addEventListener('click', () => requestInsight(true));
  102. $('ckptAiCopy').addEventListener('click', () => {
  103. const text = state.insightPoints.join('\n');
  104. if (!text) return;
  105. navigator.clipboard.writeText(text).then(() => {
  106. const btn = $('ckptAiCopy');
  107. btn.textContent = '已复制';
  108. setTimeout(() => { btn.textContent = '复制'; }, 1500);
  109. }).catch(() => {});
  110. });
  111. $('ckptFrom').addEventListener('change', (e) => { state.from = inputToYmd(e.target.value); loadData(); });
  112. $('ckptTo').addEventListener('change', (e) => { state.to = inputToYmd(e.target.value); loadData(); });
  113. state.charts.trend = echarts.init($('ckptTrend'));
  114. state.charts.rank = echarts.init($('ckptRank'));
  115. state.charts.funnel = echarts.init($('ckptFunnel'));
  116. state.charts.structure = echarts.init($('ckptStructure'));
  117. window.bindMultiSelectDismiss();
  118. window.addEventListener('resize', () => {
  119. Object.values(state.charts).forEach((chart) => chart && chart.resize());
  120. });
  121. }
  122. function mountFilters(summary) {
  123. const schools = (summary.schools || []).map((s) => ({ key: s.name, label: s.name, hint: `${s.shopCount} 家` }));
  124. window.createMultiSelect($('ckptSchool'), {
  125. label: '学校',
  126. items: schools,
  127. selected: state.schools ? [...state.schools] : [],
  128. allowEmpty: true,
  129. emptyLabel: '全部',
  130. onChange: (keys) => { state.schools = keys.length ? new Set(keys) : null; loadData(); },
  131. });
  132. const shops = (summary.shops || []).map((s) => ({
  133. key: String(s.key || s.shopId || ''),
  134. label: s.shopName || s.key,
  135. hint: s.school || '',
  136. })).filter((i) => i.key);
  137. window.createMultiSelect($('ckptShop'), {
  138. label: '店铺',
  139. items: shops,
  140. selected: state.shops ? [...state.shops] : [],
  141. allowEmpty: true,
  142. emptyLabel: '全部',
  143. onChange: (keys) => { state.shops = keys.length ? new Set(keys) : null; loadData(); },
  144. });
  145. }
  146. // ---------- 渲染 ----------
  147. function renderKpis(kpis) {
  148. const box = $('ckptKpis');
  149. if (!box) return;
  150. if (!kpis) {
  151. box.innerHTML = '';
  152. return;
  153. }
  154. box.innerHTML = KPI_DEFS.map((def) => {
  155. const item = kpis[def.key] || { value: null, delta: null, unit: def.unit };
  156. return `<div class="ckpt-kpi">
  157. <div class="ckpt-kpi-label">${def.label}</div>
  158. <div class="ckpt-kpi-value">${fmtValue(item.value, def.unit)}</div>
  159. <div class="ckpt-kpi-foot">${fmtDelta(item.delta, def.unit)}<span class="ckpt-kpi-hint">较上期</span></div>
  160. </div>`;
  161. }).join('');
  162. }
  163. function renderZeroOrder(data) {
  164. const box = $('ckptZero');
  165. if (!box) return;
  166. const items = data.zeroOrder || [];
  167. if (!items.length) {
  168. box.hidden = true;
  169. box.innerHTML = '';
  170. return;
  171. }
  172. const chips = items.map((item) => {
  173. const tone = item.reason === 'no-conversion' ? 'warn'
  174. : item.reason === 'no-visit' || item.reason === 'no-traffic' ? 'info' : 'muted';
  175. return `<span class="ckpt-zero-chip ${tone}" title="${esc(item.reasonText)}">
  176. <b>${shortDate(item.date)} ${esc(item.shopName)}</b>${esc(item.reasonText)}
  177. </span>`;
  178. }).join('');
  179. box.hidden = false;
  180. box.innerHTML = `<span class="ckpt-zero-label">零单诊断 ${items.length} 店次</span>${chips}`;
  181. }
  182. function renderTrend(data) {
  183. const chart = state.charts.trend;
  184. const dates = data.trend.map((t) => shortDate(t.date));
  185. chart.setOption({
  186. grid: { left: 56, right: 52, top: 24, bottom: 32 },
  187. tooltip: { trigger: 'axis' },
  188. legend: { right: 0, top: 0, itemWidth: 10, itemHeight: 10, textStyle: { fontSize: 11 } },
  189. xAxis: { type: 'category', data: dates, axisLine: { lineStyle: { color: '#e5e0da' } }, axisTick: { show: false }, axisLabel: { color: '#8f8880' } },
  190. yAxis: [
  191. { type: 'value', splitLine: { lineStyle: { color: '#f2efea' } }, axisLabel: { color: '#8f8880' } },
  192. { type: 'value', splitLine: { show: false }, axisLabel: { color: '#8f8880' } },
  193. ],
  194. series: [
  195. { name: '营业额', type: 'bar', barMaxWidth: 28, itemStyle: { color: COLORS.main, borderRadius: [4, 4, 0, 0] }, data: data.trend.map((t) => t.revenue) },
  196. { name: '订单', type: 'line', yAxisIndex: 1, smooth: true, symbolSize: 6, lineStyle: { width: 2, color: '#7a9cc6' }, itemStyle: { color: '#7a9cc6' }, data: data.trend.map((t) => t.orders) },
  197. ],
  198. }, true);
  199. }
  200. function renderRanking(data) {
  201. const rows = data.ranking.slice().reverse();
  202. state.charts.rank.setOption({
  203. grid: { left: 8, right: 48, top: 10, bottom: 10, containLabel: true },
  204. tooltip: { trigger: 'axis', axisPointer: { type: 'shadow' } },
  205. xAxis: { type: 'value', splitLine: { lineStyle: { color: '#f2efea' } }, axisLabel: { color: '#8f8880' } },
  206. yAxis: {
  207. type: 'category',
  208. data: rows.map((r) => r.shopName),
  209. axisLine: { show: false },
  210. axisTick: { show: false },
  211. axisLabel: { color: '#5f5852', width: 150, overflow: 'truncate', fontSize: 11 },
  212. },
  213. series: [{
  214. type: 'bar',
  215. barMaxWidth: 16,
  216. itemStyle: { color: COLORS.soft, borderRadius: [0, 4, 4, 0] },
  217. label: {
  218. show: true,
  219. position: 'right',
  220. fontSize: 11,
  221. color: '#6f6862',
  222. formatter: (p) => Number(p.value).toLocaleString('zh-CN', { maximumFractionDigits: 0 }),
  223. },
  224. data: rows.map((r) => r.revenue),
  225. }],
  226. }, true);
  227. }
  228. function renderFunnel(data) {
  229. const f = data.funnel;
  230. const stages = [
  231. { name: '曝光', value: f.exposure },
  232. { name: '进店', value: f.visit },
  233. { name: '下单', value: f.order },
  234. ];
  235. const rate = (a, b) => (b > 0 ? ((a / b) * 100).toFixed(1) + '%' : '—');
  236. state.charts.funnel.setOption({
  237. tooltip: { trigger: 'item', formatter: (p) => `${p.name}:${Number(p.value).toLocaleString('zh-CN')}` },
  238. series: [{
  239. type: 'funnel',
  240. left: '8%',
  241. right: '8%',
  242. top: 16,
  243. bottom: 16,
  244. minSize: '28%',
  245. sort: 'descending',
  246. gap: 4,
  247. label: {
  248. show: true,
  249. position: 'inside',
  250. color: '#fff',
  251. fontSize: 12,
  252. formatter: (p) => `${p.name} ${Number(p.value).toLocaleString('zh-CN')}`,
  253. },
  254. itemStyle: { borderWidth: 0 },
  255. color: [COLORS.main, '#ff9a70', '#ffc4a8'],
  256. data: stages,
  257. }],
  258. graphic: [
  259. { type: 'text', right: 10, top: 8, style: { text: `进店 ${rate(f.visit, f.exposure)}`, fill: '#8f8880', fontSize: 11 } },
  260. { type: 'text', right: 10, bottom: 8, style: { text: `下单 ${rate(f.order, f.visit)}`, fill: '#8f8880', fontSize: 11 } },
  261. ],
  262. }, true);
  263. }
  264. function renderStructure(data) {
  265. const dates = data.structure.map((s) => shortDate(s.date));
  266. state.charts.structure.setOption({
  267. grid: { left: 56, right: 20, top: 28, bottom: 32 },
  268. tooltip: { trigger: 'axis' },
  269. legend: { right: 0, top: 0, itemWidth: 10, itemHeight: 10, textStyle: { fontSize: 11 } },
  270. xAxis: { type: 'category', data: dates, axisLine: { lineStyle: { color: '#e5e0da' } }, axisTick: { show: false }, axisLabel: { color: '#8f8880' } },
  271. yAxis: { type: 'value', splitLine: { lineStyle: { color: '#f2efea' } }, axisLabel: { color: '#8f8880' } },
  272. series: [
  273. { name: '收入', type: 'bar', barMaxWidth: 22, itemStyle: { color: COLORS.main, borderRadius: [3, 3, 0, 0] }, data: data.structure.map((s) => s.income) },
  274. { name: '支出', type: 'bar', barMaxWidth: 22, itemStyle: { color: '#c9c2ba', borderRadius: [3, 3, 0, 0] }, data: data.structure.map((s) => s.expense) },
  275. { name: '补贴', type: 'bar', barMaxWidth: 22, itemStyle: { color: '#ffd6c2', borderRadius: [3, 3, 0, 0] }, data: data.structure.map((s) => s.subsidy) },
  276. ],
  277. }, true);
  278. }
  279. // ---------- AI 解读 ----------
  280. async function requestInsight(refresh) {
  281. const body = $('ckptAiBody');
  282. const btn = $('ckptAiBtn');
  283. if (!body || !btn) return;
  284. btn.disabled = true;
  285. btn.textContent = '分析中…';
  286. body.innerHTML = '<span class="ckpt-ai-loading">AI 正在读取数据并生成结论…</span>';
  287. $('ckptAiMeta').textContent = '';
  288. $('ckptAiCopy').hidden = true;
  289. const payload = {
  290. from: state.from,
  291. to: state.to,
  292. schools: state.schools ? [...state.schools].join(',') : '',
  293. shops: state.shops ? [...state.shops].join(',') : '',
  294. refresh: !!refresh,
  295. };
  296. try {
  297. const { res, body: data } = await api('/api/ops/insights', {
  298. method: 'POST',
  299. headers: { 'Content-Type': 'application/json' },
  300. body: JSON.stringify(payload),
  301. });
  302. if (!res.ok) throw new Error((data && (data.detail || data.error)) || ('HTTP ' + res.status));
  303. if (data && data.enabled === false) {
  304. body.innerHTML = '未配置对话模型。请到「系统设置 → API 设置」选择对话模型并填写 Key,然后回到这里重新生成。';
  305. return;
  306. }
  307. if (data && data.note) {
  308. body.textContent = data.note;
  309. return;
  310. }
  311. const points = (data && data.points) || [];
  312. if (!points.length) {
  313. body.textContent = '模型没有返回有效结论,请稍后重试。';
  314. return;
  315. }
  316. state.insightPoints = points;
  317. body.innerHTML = `<ul class="ckpt-ai-list">${points.map((point) => `<li>${esc(point)}</li>`).join('')}</ul>`;
  318. const time = data.generatedAt ? new Date(data.generatedAt).toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit' }) : '';
  319. $('ckptAiMeta').textContent = [data.model, time, data.cached ? '缓存' : ''].filter(Boolean).join(' · ');
  320. $('ckptAiCopy').hidden = false;
  321. } catch (e) {
  322. body.innerHTML = `<span class="ckpt-ai-error">生成失败:${esc(e.message || e)}</span>`;
  323. } finally {
  324. btn.disabled = false;
  325. btn.textContent = refresh ? '重新生成' : '生成解读';
  326. }
  327. }
  328. // ---------- 数据 ----------
  329. async function loadData() {
  330. if (state.loading) return;
  331. state.loading = true;
  332. const params = new URLSearchParams();
  333. if (state.from) params.set('from', state.from);
  334. if (state.to) params.set('to', state.to);
  335. if (state.schools && state.schools.size) params.set('schools', [...state.schools].join(','));
  336. if (state.shops && state.shops.size) params.set('shops', [...state.shops].join(','));
  337. try {
  338. const { res, body } = await api('/api/ops/dashboard?' + params.toString());
  339. if (!res.ok) throw new Error((body && (body.detail || body.error)) || ('HTTP ' + res.status));
  340. state.data = body;
  341. const empty = !body.kpis || !body.trend.length;
  342. $('ckptEmpty').hidden = !empty;
  343. $('ckptKpis').hidden = empty;
  344. document.querySelector('.ckpt-grid').hidden = empty;
  345. if (!empty) {
  346. state.from = body.from || state.from;
  347. state.to = body.to || state.to;
  348. $('ckptFrom').value = ymdToInput(state.from);
  349. $('ckptTo').value = ymdToInput(state.to);
  350. renderKpis(body.kpis);
  351. renderZeroOrder(body);
  352. renderTrend(body);
  353. renderRanking(body);
  354. renderFunnel(body);
  355. renderStructure(body);
  356. $('ckptTrendNote').textContent = body.prev ? `对比 ${shortDate(body.prev.from)} ~ ${shortDate(body.prev.to)}` : '暂无上期可比';
  357. if (state.insightPoints.length) {
  358. state.insightPoints = [];
  359. $('ckptAiBody').innerHTML = '筛选范围已变化,点击「生成解读」重新分析。';
  360. $('ckptAiMeta').textContent = '';
  361. $('ckptAiCopy').hidden = true;
  362. }
  363. Object.values(state.charts).forEach((chart) => chart && chart.resize());
  364. }
  365. } catch (e) {
  366. $('ckptEmpty').hidden = false;
  367. $('ckptEmpty').querySelector('p').textContent = '驾驶舱加载失败';
  368. $('ckptEmpty').querySelector('small').textContent = e.message || String(e);
  369. } finally {
  370. state.loading = false;
  371. }
  372. }
  373. /** 数据变更后刷新:重拉筛选选项与聚合数据,不重建图表 */
  374. async function refresh() {
  375. const { body } = await api('/api/ops/summary');
  376. if (!body || !body.enabled) return;
  377. // 清理已不存在于新数据的筛选值
  378. const schoolNames = new Set((body.schools || []).map((s) => s.name));
  379. if (state.schools) {
  380. const next = new Set([...state.schools].filter((name) => schoolNames.has(name)));
  381. state.schools = next.size ? next : null;
  382. }
  383. const shopKeys = new Set((body.shops || []).map((s) => String(s.key || s.shopId)));
  384. if (state.shops) {
  385. const next = new Set([...state.shops].filter((key) => shopKeys.has(key)));
  386. state.shops = next.size ? next : null;
  387. }
  388. mountFilters(body);
  389. await loadData();
  390. }
  391. async function init() {
  392. if (state.inited) return;
  393. state.inited = true;
  394. renderShell();
  395. const { body } = await api('/api/ops/summary');
  396. const summary = body || { enabled: false, schools: [], shops: [] };
  397. if (summary.enabled) {
  398. if (summary.coverage) {
  399. state.from = summary.coverage.from || '';
  400. state.to = summary.coverage.to || '';
  401. $('ckptFrom').value = ymdToInput(state.from);
  402. $('ckptTo').value = ymdToInput(state.to);
  403. }
  404. mountFilters(summary);
  405. await loadData();
  406. } else {
  407. $('ckptEmpty').hidden = false;
  408. $('ckptEmpty').querySelector('p').textContent = '数据暂不可用';
  409. $('ckptEmpty').querySelector('small').textContent = summary.reason || '存储未连接';
  410. }
  411. }
  412. window.addEventListener('ops:data-changed', () => {
  413. if (state.inited) refresh();
  414. });
  415. window.shanCockpitInit = function () {
  416. init();
  417. const refresh = $('btnCockpitRefresh');
  418. if (refresh && !refresh.dataset.bound) {
  419. refresh.dataset.bound = '1';
  420. refresh.addEventListener('click', () => loadData());
  421. }
  422. };
  423. })();