- 后端:pickingBinSalesAnalysis 配置/服务/路由,仓位库存取 rpt.jst_packInventoryInfo (bin_group 空值=拣选位、存货=存货位),销量按「SKU 占用同类仓位数平均分摊」, 恒等式「全部库位销量之和 = 有库位 SKU 销量之和」差异为 0 - 动销等级(近 N 天日销,默认 15):爆款>=20、热卖款 10-20、平销款 3-10、 滞销款-1 1-3、滞销款-2 (0,1)、销售=0 - 前端:大货库存监控下新增二级菜单 + 页面(等级卡片、仓库/类型/天数/仓位筛选、 分页表格、xlsx 导出),路由/菜单/页面权限四处注册 - 测试:后端 8 项单测通过;前端 lint/test/build 通过
296 lines
11 KiB
JavaScript
296 lines
11 KiB
JavaScript
import React, { useCallback, useEffect, useMemo, useState } from 'react';
|
||
import {
|
||
Alert, Button, Card, Col, Input, Modal, Row, Select, Space, Spin, Statistic, Table, Tag, Tooltip, Typography, message,
|
||
} from 'antd';
|
||
import { DownloadOutlined, InfoCircleOutlined, ReloadOutlined } from '@ant-design/icons';
|
||
import { SycmPage } from '../../components/Common';
|
||
import {
|
||
exportPickingBinSalesAnalysis,
|
||
getPickingBinSalesAnalysis,
|
||
} from '../../api/pickingBinSalesAnalysis';
|
||
import { downloadBlobAsFile, readBlobErrorMessage } from '../../utils/tableExport';
|
||
import {
|
||
PICKING_BIN_COLUMNS,
|
||
PICKING_BIN_WINDOW_OPTIONS,
|
||
PICKING_BIN_DEFAULT_DAYS,
|
||
PICKING_BIN_TYPE_OPTIONS,
|
||
PICKING_BIN_DEFAULT_TYPES,
|
||
PICKING_BIN_GRADE_COLORS,
|
||
PICKING_BIN_DESCRIPTION,
|
||
} from '../../constants/pickingBinSalesAnalysis';
|
||
import './style.css';
|
||
|
||
const { Title, Text } = Typography;
|
||
|
||
const int = (value) => {
|
||
if (value === null || value === undefined || value === '') return '—';
|
||
return Number(value).toLocaleString('zh-CN', { maximumFractionDigits: 0 });
|
||
};
|
||
|
||
const num = (value, digits = 2) => {
|
||
if (value === null || value === undefined || value === '') return '—';
|
||
return Number(value).toLocaleString('zh-CN', {
|
||
minimumFractionDigits: digits,
|
||
maximumFractionDigits: digits,
|
||
});
|
||
};
|
||
|
||
const TipTitle = ({ tip, children }) => (
|
||
<Tooltip title={tip}>
|
||
<span className="picking-bin-th-tip">{children}</span>
|
||
</Tooltip>
|
||
);
|
||
|
||
const PickingBinSalesAnalysis = () => {
|
||
const [loading, setLoading] = useState(false);
|
||
const [error, setError] = useState('');
|
||
const [data, setData] = useState(null);
|
||
const [helpOpen, setHelpOpen] = useState(false);
|
||
const [days, setDays] = useState(PICKING_BIN_DEFAULT_DAYS);
|
||
const [binTypes, setBinTypes] = useState(PICKING_BIN_DEFAULT_TYPES);
|
||
const [warehouse, setWarehouse] = useState('');
|
||
const [grades, setGrades] = useState([]);
|
||
const [keyword, setKeyword] = useState('');
|
||
const [exporting, setExporting] = useState(false);
|
||
|
||
const params = useMemo(() => ({
|
||
days,
|
||
binType: binTypes.join(','),
|
||
...(warehouse ? { wmsCoId: warehouse } : {}),
|
||
}), [days, binTypes, warehouse]);
|
||
|
||
const load = useCallback(async (options = {}) => {
|
||
setLoading(true);
|
||
setError('');
|
||
try {
|
||
const res = await getPickingBinSalesAnalysis({
|
||
...(options.params ?? params),
|
||
...(options.force ? { refresh: '1' } : {}),
|
||
});
|
||
setData(res?.data ?? null);
|
||
} catch (err) {
|
||
setError(err?.response?.data?.error || err?.message || '拣选库位动销分析数据加载失败');
|
||
setData(null);
|
||
} finally {
|
||
setLoading(false);
|
||
}
|
||
}, [params]);
|
||
|
||
useEffect(() => { load(); }, [load]);
|
||
|
||
const items = useMemo(() => data?.items ?? [], [data]);
|
||
const gradeMap = useMemo(() => new Map((data?.grades ?? []).map((g) => [g.key, g])), [data]);
|
||
|
||
const filteredRows = useMemo(() => {
|
||
const kw = keyword.trim().toLowerCase();
|
||
return items.filter((it) => {
|
||
if (grades.length > 0 && !grades.includes(it.gradeKey)) return false;
|
||
if (kw && !String(it.binName).toLowerCase().includes(kw)) return false;
|
||
return true;
|
||
});
|
||
}, [items, grades, keyword]);
|
||
|
||
const columns = useMemo(() => PICKING_BIN_COLUMNS.map((col) => ({
|
||
title: <TipTitle tip={col.tip}>{col.label}</TipTitle>,
|
||
key: col.key,
|
||
dataIndex: col.key,
|
||
align: ['warehouse', 'binName', 'binType', 'gradeKey'].includes(col.key) ? 'left' : 'right',
|
||
width: col.key === 'warehouse' ? 240 : (col.key === 'gradeKey' ? 170 : 110),
|
||
sorter: ['stockQty', 'skuCount', 'salesQty', 'dailySales'].includes(col.key)
|
||
? (a, b) => (a[col.key] ?? 0) - (b[col.key] ?? 0)
|
||
: undefined,
|
||
render: (value) => {
|
||
if (col.key === 'gradeKey') {
|
||
const g = gradeMap.get(value);
|
||
return <Tag color={PICKING_BIN_GRADE_COLORS[value] || 'default'}>{g?.label || value}</Tag>;
|
||
}
|
||
if (col.key === 'binType') return <Text>{value || '—'}</Text>;
|
||
if (col.key === 'dailySales') return num(value, 2);
|
||
if (col.key === 'salesQty') return num(value, 2);
|
||
if (col.key === 'stockQty' || col.key === 'skuCount') return int(value);
|
||
return value || '—';
|
||
},
|
||
})), [gradeMap]);
|
||
|
||
const handleExport = useCallback(async () => {
|
||
setExporting(true);
|
||
try {
|
||
const blob = await exportPickingBinSalesAnalysis({
|
||
...params,
|
||
...(grades.length > 0 ? { grade: grades.join(',') } : {}),
|
||
format: 'xlsx',
|
||
});
|
||
const dateKey = (data?.latestBizDate || '').replace(/-/g, '') || '未知日期';
|
||
const fileName = `拣选库位动销分析-${dateKey}.xlsx`;
|
||
await downloadBlobAsFile(blob, fileName);
|
||
message.success(`已开始下载:${fileName}`);
|
||
} catch (exportError) {
|
||
message.error(await readBlobErrorMessage(exportError, '库位动销明细导出失败'));
|
||
} finally {
|
||
setExporting(false);
|
||
}
|
||
}, [params, grades, data?.latestBizDate]);
|
||
|
||
const toggleGrade = useCallback((key) => {
|
||
setGrades((prev) => (prev.includes(key) ? prev.filter((k) => k !== key) : [...prev, key]));
|
||
}, []);
|
||
|
||
const summary = data?.summary ?? [];
|
||
const total = data?.total ?? null;
|
||
|
||
return (
|
||
<SycmPage className="picking-bin-page">
|
||
<div className="picking-bin-header">
|
||
<div className="picking-bin-header__title">
|
||
<Title level={4} style={{ margin: 0 }}>拣选库位动销分析</Title>
|
||
<Button
|
||
type="text"
|
||
icon={<InfoCircleOutlined />}
|
||
onClick={() => setHelpOpen(true)}
|
||
className="picking-bin-header__help"
|
||
>
|
||
口径说明
|
||
</Button>
|
||
</div>
|
||
<div className="picking-bin-header__meta">
|
||
<span>统计基准日:{data?.latestBizDate || '—'}</span>
|
||
{data?.shipWindow ? (
|
||
<span>销量窗口:{data.shipWindow.shipFrom} ~ {data.shipWindow.shipTo}(近 {data.shipWindow.days} 天)</span>
|
||
) : null}
|
||
{data?.takenAt ? (
|
||
<span>仓位数据时间:{new Date(data.takenAt).toLocaleString('zh-CN', { hour12: false })}</span>
|
||
) : null}
|
||
</div>
|
||
<Space wrap>
|
||
<Space size={4}>
|
||
<Text type="secondary">统计天数</Text>
|
||
<Select
|
||
value={days}
|
||
options={PICKING_BIN_WINDOW_OPTIONS}
|
||
onChange={setDays}
|
||
style={{ width: 110 }}
|
||
/>
|
||
</Space>
|
||
<Select
|
||
mode="multiple"
|
||
allowClear
|
||
value={binTypes}
|
||
options={PICKING_BIN_TYPE_OPTIONS}
|
||
onChange={(v) => setBinTypes(v && v.length > 0 ? v : PICKING_BIN_DEFAULT_TYPES)}
|
||
style={{ minWidth: 170 }}
|
||
placeholder="仓位类型"
|
||
maxTagCount={2}
|
||
/>
|
||
<Select
|
||
allowClear
|
||
value={warehouse || undefined}
|
||
options={(data?.warehouses ?? []).map((w) => ({ label: w.warehouse, value: w.wmsCoId }))}
|
||
onChange={(v) => setWarehouse(v || '')}
|
||
showSearch
|
||
optionFilterProp="label"
|
||
style={{ minWidth: 240 }}
|
||
placeholder="全部仓库"
|
||
/>
|
||
<Input.Search
|
||
allowClear
|
||
value={keyword}
|
||
onChange={(e) => setKeyword(e.target.value)}
|
||
placeholder="搜索仓位"
|
||
style={{ width: 160 }}
|
||
/>
|
||
<Button icon={<ReloadOutlined />} onClick={() => load()} loading={loading}>刷新</Button>
|
||
<Tooltip title="跳过 5 分钟缓存,重新扫描订单与仓位明细重算(约 5~20 秒)">
|
||
<Button onClick={() => load({ force: true })} loading={loading}>强制重算</Button>
|
||
</Tooltip>
|
||
<Tooltip title="导出当前筛选下的库位明细(仓库 / 仓位 / 类型 / 库存数量 / SKU数 / 销量 / 日销 / 动销等级),每个仓位独立一行">
|
||
<Button icon={<DownloadOutlined />} onClick={handleExport} loading={exporting}>导出明细</Button>
|
||
</Tooltip>
|
||
</Space>
|
||
</div>
|
||
|
||
<Alert
|
||
type="info"
|
||
showIcon
|
||
message={`按「单个仓位的日均销量」把库位分成 ${summary.length} 个动销等级,全部数值来自业务库实时取数`}
|
||
description="库存取仓位库存表,销量取销售出库单并在同类仓位间平均分摊(避免同一 SKU 占用多个仓位导致销量被放大)。点击下方等级卡片可筛选。"
|
||
style={{ marginBottom: 12 }}
|
||
/>
|
||
|
||
{error ? <Alert type="error" showIcon message={error} style={{ marginBottom: 12 }} /> : null}
|
||
|
||
<Spin spinning={loading}>
|
||
<Row gutter={[8, 8]} className="picking-bin-summary">
|
||
{summary.map((s) => (
|
||
<Col key={s.key} flex="1 1 150px">
|
||
<Card
|
||
size="small"
|
||
hoverable
|
||
onClick={() => toggleGrade(s.key)}
|
||
className={grades.includes(s.key) ? 'picking-bin-card is-active' : 'picking-bin-card'}
|
||
>
|
||
<Statistic
|
||
title={s.label}
|
||
value={s.binCount}
|
||
suffix="位"
|
||
valueStyle={{ fontSize: 18 }}
|
||
/>
|
||
<div className="picking-bin-card__meta">
|
||
库存 {int(s.stockQty)} · 日销 {num(s.dailySales, 1)}
|
||
</div>
|
||
</Card>
|
||
</Col>
|
||
))}
|
||
{total ? (
|
||
<Col flex="1 1 150px">
|
||
<Card size="small" className="picking-bin-card is-total">
|
||
<Statistic title={total.label} value={total.binCount} suffix="位" valueStyle={{ fontSize: 18 }} />
|
||
<div className="picking-bin-card__meta">
|
||
库存 {int(total.stockQty)} · 日销 {num(total.dailySales, 1)}
|
||
</div>
|
||
</Card>
|
||
</Col>
|
||
) : null}
|
||
</Row>
|
||
|
||
<Table
|
||
className="picking-bin-table"
|
||
columns={columns}
|
||
dataSource={filteredRows}
|
||
rowKey={(r) => `${r.wmsCoId}::${r.binType}::${r.binName}`}
|
||
size="small"
|
||
bordered
|
||
pagination={{
|
||
pageSize: 50,
|
||
showSizeChanger: true,
|
||
pageSizeOptions: [50, 100, 200],
|
||
showTotal: (t) => `共 ${t} 个库位`,
|
||
}}
|
||
scroll={{ x: 'max-content', y: 'calc(100vh - 420px)' }}
|
||
/>
|
||
</Spin>
|
||
|
||
<Text type="secondary" className="picking-bin-footer">
|
||
当前筛选出 {filteredRows.length} 个库位
|
||
{items.length !== filteredRows.length ? `(共 ${items.length} 个)` : ''};
|
||
已选类型:{(data?.binTypes ?? []).join('、') || '—'}。
|
||
</Text>
|
||
|
||
<Modal
|
||
title="计算口径说明"
|
||
open={helpOpen}
|
||
onCancel={() => setHelpOpen(false)}
|
||
footer={null}
|
||
width={760}
|
||
>
|
||
<div className="picking-bin-help">
|
||
{PICKING_BIN_DESCRIPTION.map((line, i) => (
|
||
<p key={i} className={line.startsWith(' ') ? 'is-indent' : ''}>{line}</p>
|
||
))}
|
||
</div>
|
||
</Modal>
|
||
</SycmPage>
|
||
);
|
||
};
|
||
|
||
export default PickingBinSalesAnalysis;
|