feat(settlement): redesign factory/partner/store statement bills

Add WineryBill/StoreBill tables, partner review-send-confirm flow, daily/monthly cron, and admin multi-select confirm with status filters.

Co-authored-by: Cursor <cursoragent@cursor.com>

apps/admin-web/src/pages/StoreBillsPage.tsx

@@ -6,6 +6,7 @@ import {
   Descriptions,
   Drawer,
   Form,
+  Modal,
   Select,
   Space,
   Statistic,
@@ -23,26 +24,26 @@ import { useAdminList } from '../lib/useAdminList';
 
 type Row = {
   id: string;
+  billNo: string;
+  billDate: string;
+  redeemCount: number;
   redeemAmount: number;
-  payoutAmount: number;
   settlementRate: number;
+  payoutAmount: number;
   status: string;
-  expectedPayAt: string;
-  paidAt?: string;
-  createdAt: string;
+  paidAt?: string | null;
   store?: { id: string; name: string; cityName: string; phone?: string };
-  redeemRecord?: { redeemNo: string; amount?: number; createdAt?: string };
 };
 
 type StoreOption = { id: string; name: string; phone: string };
 
-const PAYOUT_STATUS_LABELS: Record<string, string> = {
-  PENDING: '待打款',
+const STATUS_LABELS: Record<string, string> = {
+  UNPAID: '未打款',
   PAID: '已打款',
 };
 
-const PAYOUT_STATUS_COLORS: Record<string, string> = {
-  PENDING: 'orange',
+const STATUS_COLORS: Record<string, string> = {
+  UNPAID: 'red',
   PAID: 'green',
 };
 
@@ -51,7 +52,7 @@ export default function StoreBillsPage() {
   const [filters, setFilters] = useState<Record<string, string>>({});
   const [stores, setStores] = useState<StoreOption[]>([]);
   const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList<Row>(
-    '/admin/store-payouts',
+    '/admin/store-bills',
     () => {
       const qs = new URLSearchParams();
       if (filters.status) qs.set('status', filters.status);
@@ -65,6 +66,8 @@ export default function StoreBillsPage() {
   const [detail, setDetail] = useState<Record<string, unknown> | null>(null);
   const [drawerOpen, setDrawerOpen] = useState(false);
   const [exporting, setExporting] = useState(false);
+  const [selectedKeys, setSelectedKeys] = useState<React.Key[]>([]);
+  const [batchLoading, setBatchLoading] = useState(false);
 
   useEffect(() => {
     void request<Paginated<StoreOption>>(`/admin/stores?pageSize=${ADMIN_OPTIONS_PAGE_SIZE}`)
@@ -72,13 +75,37 @@ export default function StoreBillsPage() {
       .catch(() => {});
   }, []);
 
-  async function confirmPayout(id: string) {
-    await request(`/admin/store-payouts/${id}/confirm`, {
-      method: 'POST',
-      body: JSON.stringify({ remark: '财务确认打款' }),
+  function confirmPay(ids: string[], amountHint?: number) {
+    Modal.confirm({
+      title: '确认打款？',
+      content: `将确认 ${ids.length} 笔门店对账单${amountHint != null ? `，合计约 ¥${amountHint.toFixed(2)}` : ''}。此操作不可撤销。`,
+      okText: '确认打款',
+      cancelText: '取消',
+      onOk: async () => {
+        if (ids.length === 1) {
+          await request(`/admin/store-bills/${ids[0]}/confirm`, { method: 'POST' });
+        } else {
+          setBatchLoading(true);
+          try {
+            await request('/admin/store-bills/batch-confirm', {
+              method: 'POST',
+              body: JSON.stringify({ ids }),
+            });
+          } finally {
+            setBatchLoading(false);
+          }
+        }
+        message.success('已确认打款');
+        setSelectedKeys([]);
+        reload();
+      },
     });
-    message.success('已确认打款');
-    reload();
+  }
+
+  async function openDetail(id: string) {
+    const d = await request<Record<string, unknown>>(`/admin/store-bills/${id}`);
+    setDetail(d);
+    setDrawerOpen(true);
   }
 
   async function exportExcel() {
@@ -89,10 +116,8 @@ export default function StoreBillsPage() {
       if (filters.storeId) qs.set('storeId', filters.storeId);
       if (filters.dateFrom) qs.set('dateFrom', filters.dateFrom);
       if (filters.dateTo) qs.set('dateTo', filters.dateTo);
-      const result = await request<{ csv: string; count: number }>(
-        `/admin/store-payouts/export?${qs}`,
-      );
-      downloadExcelCsv(result.csv, `门店账单_${filters.dateFrom || 'all'}_${filters.dateTo || 'all'}.csv`);
+      const result = await request<{ csv: string; count: number }>(`/admin/store-bills/export?${qs}`);
+      downloadExcelCsv(result.csv, `门店对账单_${filters.dateFrom || 'all'}_${filters.dateTo || 'all'}.csv`);
       message.success(`已导出 ${result.count} 条`);
     } finally {
       setExporting(false);
@@ -100,62 +125,56 @@ export default function StoreBillsPage() {
   }
 
   const summary = data?.summary;
+  const selectedRows = (data?.items ?? []).filter((r) => selectedKeys.includes(r.id));
+  const selectedAmount = selectedRows.reduce((s, r) => s + Number(r.payoutAmount), 0);
 
   const columns: ColumnsType<Row> = [
+    { title: '账单号', dataIndex: 'billNo', width: 170, ellipsis: true },
     {
-      title: '核销日期',
+      title: '账单日',
+      dataIndex: 'billDate',
       width: 110,
-      render: (_, r) =>
-        (r.redeemRecord?.createdAt || r.createdAt || '').toString().slice(0, 10) || '—',
+      render: (v) => String(v || '').slice(0, 10),
     },
     { title: '门店', dataIndex: ['store', 'name'], width: 140, ellipsis: true },
     { title: '登录手机', dataIndex: ['store', 'phone'], width: 120, render: (v) => v || '—' },
     { title: '城市', dataIndex: ['store', 'cityName'], width: 90 },
+    { title: '核销笔数', dataIndex: 'redeemCount', width: 90 },
     {
-      title: '核销单号',
-      dataIndex: ['redeemRecord', 'redeemNo'],
-      width: 160,
-      ellipsis: true,
-      render: (v) => v || '—',
+      title: '核销金额',
+      dataIndex: 'redeemAmount',
+      width: 110,
+      render: (v) => `¥${Number(v).toFixed(2)}`,
     },
-    { title: '核销面额', dataIndex: 'redeemAmount', width: 100, render: (v) => `¥${v}` },
     {
-      title: '核销比例',
+      title: '结算比例',
       dataIndex: 'settlementRate',
       width: 90,
-      render: (v) => (v != null ? `${Math.round(Number(v) * 100)}%` : '—'),
+      render: (v) => `${Math.round(Number(v) * 100)}%`,
     },
     {
-      title: '应付门店',
+      title: '应付金额',
       dataIndex: 'payoutAmount',
-      width: 100,
-      render: (v) => `¥${v}`,
+      width: 110,
+      render: (v) => `¥${Number(v).toFixed(2)}`,
     },
     {
-      title: '打款状态',
+      title: '状态',
       dataIndex: 'status',
-      width: 100,
-      render: (s) => <Tag color={PAYOUT_STATUS_COLORS[s] || 'default'}>{PAYOUT_STATUS_LABELS[s] || s}</Tag>,
+      width: 90,
+      render: (s) => <Tag color={STATUS_COLORS[s] || 'default'}>{STATUS_LABELS[s] || s}</Tag>,
     },
-    { title: '预计打款(T+1)', dataIndex: 'expectedPayAt', width: 160, render: fmtTime },
     {
       title: '操作',
-      width: 140,
+      width: 160,
       fixed: 'right',
       render: (_, row) => (
         <Space size={0}>
-          <Button
-            type="link"
-            size="small"
-            onClick={async () => {
-              setDetail(await request(`/admin/store-payouts/${row.id}`));
-              setDrawerOpen(true);
-            }}
-          >
-            详情
+          <Button type="link" size="small" onClick={() => void openDetail(row.id)}>
+            明细
           </Button>
-          {row.status === 'PENDING' && (
-            <Button type="link" size="small" onClick={() => void confirmPayout(row.id)}>
+          {row.status === 'UNPAID' && (
+            <Button type="link" size="small" onClick={() => confirmPay([row.id], Number(row.payoutAmount))}>
               确认打款
             </Button>
           )}
@@ -168,19 +187,19 @@ export default function StoreBillsPage() {
     <div>
       <Space direction="vertical" size={0} style={{ marginBottom: 16 }}>
         <Typography.Title level={4} style={{ margin: 0 }}>
-          门店账单
+          门店对账单
         </Typography.Title>
         <Typography.Text type="secondary">
-          T+1 结算：按日列出门店核销订单，应付 = 核销面额 × 门店核销比例
+          按核销日汇总（每日 8:00 自动出账）；未打款红色、已打款绿色
         </Typography.Text>
       </Space>
 
       {summary && (
         <Card size="small" style={{ marginBottom: 16 }}>
           <Space size="large" wrap>
-            <Statistic title="明细笔数" value={summary.count} />
-            <Statistic title="核销面额合计" value={summary.redeemAmount ?? 0} prefix="¥" precision={2} />
-            <Statistic title="应付门店合计" value={summary.payoutAmount ?? summary.totalAmount} prefix="¥" precision={2} />
+            <Statistic title="账单数" value={summary.count} />
+            <Statistic title="核销金额合计" value={summary.redeemAmount ?? 0} prefix="¥" precision={2} />
+            <Statistic title="应付合计" value={summary.payoutAmount ?? 0} prefix="¥" precision={2} />
           </Space>
         </Card>
       )}
@@ -189,16 +208,12 @@ export default function StoreBillsPage() {
         form={form}
         layout="inline"
         style={{ marginBottom: 16 }}
-        onFinish={(v: {
-          storeId?: string;
-          status?: string;
-          dateRange?: [Dayjs, Dayjs];
-        }) => {
+        onFinish={(v: { storeId?: string; status?: string; range?: [Dayjs, Dayjs] }) => {
           setFilters({
             storeId: v.storeId || '',
             status: v.status || '',
-            dateFrom: v.dateRange?.[0]?.format('YYYY-MM-DD') || '',
-            dateTo: v.dateRange?.[1]?.format('YYYY-MM-DD') || '',
+            dateFrom: v.range?.[0] ? v.range[0].format('YYYY-MM-DD') : '',
+            dateTo: v.range?.[1] ? v.range[1].format('YYYY-MM-DD') : '',
           });
           setPage(1);
         }}
@@ -210,21 +225,17 @@ export default function StoreBillsPage() {
             placeholder="全部门店"
             style={{ width: 200 }}
             optionFilterProp="label"
-            options={stores.map((s) => ({
-              value: s.id,
-              label: `${s.name}（${s.phone}）`,
-            }))}
+            options={stores.map((s) => ({ value: s.id, label: s.name || s.phone || s.id }))}
           />
         </Form.Item>
-        <Form.Item name="status" label="打款状态">
+        <Form.Item name="status" label="状态">
           <Select
             allowClear
             style={{ width: 120 }}
-            placeholder="全部"
-            options={Object.entries(PAYOUT_STATUS_LABELS).map(([value, label]) => ({ value, label }))}
+            options={Object.entries(STATUS_LABELS).map(([value, label]) => ({ value, label }))}
           />
         </Form.Item>
-        <Form.Item name="dateRange" label="核销日期">
+        <Form.Item name="range" label="账单日">
           <DatePicker.RangePicker />
         </Form.Item>
         <Form.Item>
@@ -248,6 +259,16 @@ export default function StoreBillsPage() {
             导出 Excel
           </Button>
         </Form.Item>
+        <Form.Item>
+          <Button
+            type="primary"
+            disabled={!selectedKeys.length}
+            loading={batchLoading}
+            onClick={() => confirmPay(selectedKeys.map(String), selectedAmount)}
+          >
+            批量确认打款 ({selectedKeys.length})
+          </Button>
+        </Form.Item>
       </Form>
 
       <Table
@@ -256,7 +277,12 @@ export default function StoreBillsPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1300 }}
+        rowSelection={{
+          selectedRowKeys: selectedKeys,
+          onChange: setSelectedKeys,
+          getCheckboxProps: (r) => ({ disabled: r.status !== 'UNPAID' }),
+        }}
+        scroll={{ x: 1200 }}
         pagination={{
           current: page,
           pageSize,
@@ -269,28 +295,44 @@ export default function StoreBillsPage() {
         }}
       />
 
-      <Drawer title="账单详情" width={520} open={drawerOpen} onClose={() => setDrawerOpen(false)}>
+      <Drawer title="门店对账单明细" open={drawerOpen} onClose={() => setDrawerOpen(false)} width={520}>
         {detail && (
-          <Descriptions column={1} bordered size="small">
-            <Descriptions.Item label="门店">
-              {String((detail.store as { name?: string })?.name ?? '—')}
-            </Descriptions.Item>
-            <Descriptions.Item label="核销单号">
-              {String((detail.redeemRecord as { redeemNo?: string })?.redeemNo ?? '—')}
-            </Descriptions.Item>
-            <Descriptions.Item label="核销面额">¥{String(detail.redeemAmount)}</Descriptions.Item>
-            <Descriptions.Item label="应付金额">¥{String(detail.payoutAmount)}</Descriptions.Item>
-            <Descriptions.Item label="结算比例">
-              {detail.settlementRate ? `${Math.round(Number(detail.settlementRate) * 100)}%` : '—'}
-            </Descriptions.Item>
-            <Descriptions.Item label="状态">
-              {PAYOUT_STATUS_LABELS[String(detail.status)] || String(detail.status)}
-            </Descriptions.Item>
-            <Descriptions.Item label="预计打款">{fmtTime(String(detail.expectedPayAt))}</Descriptions.Item>
-            <Descriptions.Item label="实际打款">
-              {detail.paidAt ? fmtTime(String(detail.paidAt)) : '—'}
-            </Descriptions.Item>
-          </Descriptions>
+          <>
+            <Descriptions column={1} size="small" bordered>
+              <Descriptions.Item label="账单号">{String(detail.billNo)}</Descriptions.Item>
+              <Descriptions.Item label="账单日">{String(detail.billDate || '').slice(0, 10)}</Descriptions.Item>
+              <Descriptions.Item label="应付">¥{Number(detail.payoutAmount ?? 0).toFixed(2)}</Descriptions.Item>
+              <Descriptions.Item label="状态">{STATUS_LABELS[String(detail.status)] || String(detail.status)}</Descriptions.Item>
+              <Descriptions.Item label="打款时间">
+                {detail.paidAt ? fmtTime(String(detail.paidAt)) : '—'}
+              </Descriptions.Item>
+            </Descriptions>
+            <Typography.Title level={5} style={{ marginTop: 16 }}>
+              核销明细
+            </Typography.Title>
+            <Table
+              size="small"
+              rowKey="id"
+              pagination={false}
+              dataSource={(detail.payouts as Array<Record<string, unknown>>) || []}
+              columns={[
+                {
+                  title: '核销单号',
+                  render: (_, r) => String((r.redeemRecord as { redeemNo?: string })?.redeemNo || '—'),
+                },
+                {
+                  title: '金额',
+                  dataIndex: 'payoutAmount',
+                  render: (v) => `¥${Number(v).toFixed(2)}`,
+                },
+                {
+                  title: '状态',
+                  dataIndex: 'status',
+                  render: (s) => (s === 'PAID' ? '已打款' : '未打款'),
+                },
+              ]}
+            />
+          </>
         )}
       </Drawer>
     </div>