merge(dev_jacy): store bill issue date to today

HQ 门店账单列名改为出账日；billDate 记今日（昨日 00:00–今日 00:00 右端），启动时把旧数据从核销自然日对齐过来。

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

apps/admin-web/src/admin.css

@@ -74,6 +74,56 @@ body.admin-col-resizing * {
   user-select: none !important;
 }
 
+/* 订单页筛选：第一行常驻，第二行起可收起 */
+.admin-orders-filter-row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px 16px;
+  align-items: flex-end;
+  margin-bottom: 12px;
+}
+
+.admin-orders-filter-row--tools {
+  justify-content: space-between;
+  align-items: center;
+  margin-bottom: 16px;
+}
+
+.admin-orders-filter-item {
+  margin-bottom: 0 !important;
+}
+
+.admin-orders-filter-item--sm {
+  width: 140px;
+}
+
+.admin-orders-filter-item--md {
+  width: 168px;
+}
+
+.admin-orders-filter-item--search {
+  width: 180px;
+}
+
+.admin-orders-filter-item--status {
+  width: 220px;
+  min-width: 180px;
+  flex: 1 1 180px;
+  max-width: 280px;
+}
+
+.admin-orders-filter-item--date {
+  flex: 1 1 auto;
+}
+
+.admin-orders-filter-actions {
+  margin-left: auto;
+}
+
+.admin-orders-date-picker {
+  width: 240px;
+}
+
 /* 列表页顶栏：标题左、主操作右、列设置最右 */
 .admin-list-header {
   display: flex;

apps/admin-web/src/components/RedeemRecordDetailDescriptions.tsx

@@ -15,7 +15,13 @@ type Props = {
 
 export default function RedeemRecordDetailDescriptions({ detail, maskUserPhone = false }: Props) {
   const user = detail.user as
-    | { userNo?: string; nickname?: string | null; phone?: string | null }
+    | {
+        id?: string;
+        userNo?: string;
+        nickname?: string | null;
+        phone?: string | null;
+        hqRemark?: string | null;
+      }
     | undefined;
   const store = detail.store as
     | {
@@ -41,7 +47,13 @@ export default function RedeemRecordDetailDescriptions({ detail, maskUserPhone =
       <Descriptions.Item label="结算额">¥{Number(detail.settleAmount ?? 0).toFixed(2)}</Descriptions.Item>
       <Descriptions.Item label="时间">{fmtTime(String(detail.createdAt ?? ''))}</Descriptions.Item>
       <Descriptions.Item label="用户编号">{user?.userNo ?? '—'}</Descriptions.Item>
-      <Descriptions.Item label="用户昵称">{user?.nickname?.trim() || '—'}</Descriptions.Item>
+      <Descriptions.Item label="用户昵称">
+        {(() => {
+          const name = user?.nickname?.trim() || '—';
+          const remark = user?.hqRemark?.trim();
+          return remark ? `${name}（${remark}）` : name;
+        })()}
+      </Descriptions.Item>
       <Descriptions.Item label="用户手机">
         {maskUserPhone ? maskPhone(user?.phone) : user?.phone || '—'}
       </Descriptions.Item>

apps/admin-web/src/lib/api.ts

@@ -229,7 +229,7 @@ export type AdminOrderRow = {
   proxyPartnerName?: string | null;
   proxyPartnerPhone?: string | null;
   isTest?: boolean;
-  user?: { id: string; userNo: string; phone: string | null; nickname: string | null };
+  user?: { id: string; userNo: string; phone: string | null; nickname: string | null; hqRemark?: string | null };
   delivery?: {
     provider: string;
     trackingNo: string | null;

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

@@ -1,5 +1,5 @@
-import { useState } from 'react';
-import { useNavigate } from 'react-router-dom';
+import { useEffect, useRef, useState } from 'react';
+import { useLocation, useNavigate, useSearchParams } from 'react-router-dom';
 import {
   Button,
   Descriptions,
@@ -111,9 +111,16 @@ type CouponDetail = Row & {
 
 export default function BenefitCouponsPage() {
   const navigate = useNavigate();
+  const location = useLocation();
+  const [searchParams] = useSearchParams();
+  const initialCouponNo = searchParams.get('couponNo')?.trim() || '';
   const [form] = Form.useForm();
   const [grantForm] = Form.useForm<AdminBenefitGrantRequest>();
-  const [filters, setFilters] = useState<Record<string, string>>({});
+  const [filters, setFilters] = useState<Record<string, string>>(() => {
+    const init: Record<string, string> = {};
+    if (initialCouponNo) init.couponNo = initialCouponNo;
+    return init;
+  });
   const [grantOpen, setGrantOpen] = useState(false);
   const [granting, setGranting] = useState(false);
   const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList<Row>(
@@ -132,6 +139,35 @@ export default function BenefitCouponsPage() {
   const [redeemDetail, setRedeemDetail] = useState<Record<string, unknown> | null>(null);
   const [redeemDrawerOpen, setRedeemDrawerOpen] = useState(false);
   const [redeemDetailLoading, setRedeemDetailLoading] = useState(false);
+  const deepLinkOpenedRef = useRef(false);
+
+  async function openCouponDetail(id: string) {
+    setDetail(await request<CouponDetail>(`/admin/benefit/coupons/${id}`));
+    setDrawerOpen(true);
+  }
+
+  useEffect(() => {
+    if (initialCouponNo) form.setFieldsValue({ couponNo: initialCouponNo });
+  }, [form, initialCouponNo]);
+
+  useEffect(() => {
+    const openCouponId = (location.state as { openCouponId?: string } | null)?.openCouponId;
+    if (openCouponId && !deepLinkOpenedRef.current) {
+      deepLinkOpenedRef.current = true;
+      void openCouponDetail(openCouponId).catch((e) => {
+        message.error(e instanceof Error ? e.message : '加载权益券失败');
+      });
+      return;
+    }
+    if (!initialCouponNo || deepLinkOpenedRef.current || loading) return;
+    const first = data?.items?.[0];
+    if (first && String(first.couponNo) === initialCouponNo) {
+      deepLinkOpenedRef.current = true;
+      void openCouponDetail(first.id).catch((e) => {
+        message.error(e instanceof Error ? e.message : '加载权益券失败');
+      });
+    }
+  }, [data, initialCouponNo, loading, location.state]);
 
   async function openRedeemDetail(redeemId: string) {
     setRedeemDetailLoading(true);
@@ -154,12 +190,7 @@ export default function BenefitCouponsPage() {
       width: 200,
       ellipsis: false,
       render: (v, row) => (
-        <AdminPrimaryLink
-          onClick={async () => {
-            setDetail(await request(`/admin/benefit/coupons/${row.id}`));
-            setDrawerOpen(true);
-          }}
-        >
+        <AdminPrimaryLink onClick={() => void openCouponDetail(row.id)}>
           {v}
         </AdminPrimaryLink>
       ),
@@ -211,10 +242,7 @@ export default function BenefitCouponsPage() {
         <Button
           type="link"
           size="small"
-          onClick={async () => {
-            setDetail(await request(`/admin/benefit/coupons/${row.id}`));
-            setDrawerOpen(true);
-          }}
+          onClick={() => void openCouponDetail(row.id)}
         >
           详情
         </Button>

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

@@ -71,11 +71,11 @@ export default function DevPlanTasksPage() {
   const [batchForm] = Form.useForm<{ status?: DevPlanTaskStatusDto; versionId?: string }>();
 
   useEffect(() => {
-    if (!batchEditOpen) return;
+    if (!modalOpen && !batchEditOpen) return;
     request<{ items: DevPlanVersionDto[] }>('/admin/dev-plan/versions?pageSize=100')
       .then((res) => setVersions(res.items ?? []))
       .catch(() => setVersions([]));
-  }, [batchEditOpen]);
+  }, [modalOpen, batchEditOpen]);
 
   useEffect(() => {
     if (!modalOpen || editing) return;
@@ -108,6 +108,7 @@ export default function DevPlanTasksPage() {
       content: row.content,
       type: row.type,
       status: row.status,
+      versionIds: row.versionIds?.length ? row.versionIds : row.versions?.map((v) => v.id) ?? [],
       attachmentUrls: row.attachmentUrls?.length ? row.attachmentUrls : [''],
     });
     setModalOpen(true);
@@ -121,7 +122,11 @@ export default function DevPlanTasksPage() {
       if (editing) {
         await request(`/admin/dev-plan/tasks/${editing.id}`, {
           method: 'PUT',
-          body: JSON.stringify({ ...values, attachmentUrls }),
+          body: JSON.stringify({
+            ...values,
+            attachmentUrls,
+            versionIds: values.versionIds ?? [],
+          }),
         });
         message.success('已更新');
       } else {
@@ -285,6 +290,21 @@ export default function DevPlanTasksPage() {
         ),
     },
     { title: '来源工单', dataIndex: 'supportTicketNo', width: 140, render: (v) => v || '—' },
+    {
+      title: '关联版本',
+      dataIndex: 'versions',
+      width: 140,
+      render: (_, row) =>
+        row.versions?.length ? (
+          <Space size={4} wrap>
+            {row.versions.map((v) => (
+              <Tag key={v.id}>{v.versionNo}</Tag>
+            ))}
+          </Space>
+        ) : (
+          '—'
+        ),
+    },
     { title: '创建人', dataIndex: 'creatorName', width: 90 },
     { title: '创建时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
     {
@@ -405,9 +425,21 @@ export default function DevPlanTasksPage() {
             <Select options={TYPE_OPTIONS} />
           </Form.Item>
           {editing ? (
-            <Form.Item name="status" label="状态" rules={[{ required: true }]}>
-              <Select options={STATUS_OPTIONS} />
-            </Form.Item>
+            <>
+              <Form.Item name="status" label="状态" rules={[{ required: true }]}>
+                <Select options={STATUS_OPTIONS} />
+              </Form.Item>
+              <Form.Item name="versionIds" label="关联版本">
+                <Select
+                  mode="multiple"
+                  allowClear
+                  showSearch
+                  optionFilterProp="label"
+                  placeholder="可选：关联版本"
+                  options={versions.map((v) => ({ value: v.id, label: v.versionNo }))}
+                />
+              </Form.Item>
+            </>
           ) : (
             <Form.Item name="supportTicketId" label="绑定技术支持工单">
               <Select

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

@@ -1,10 +1,9 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
-import { Link, useNavigate, useSearchParams } from 'react-router-dom';
+import { Link, useLocation, useNavigate, useSearchParams } from 'react-router-dom';
 import {
   Alert,
   Button,
   Checkbox,
-  Col,
   Collapse,
   DatePicker,
   Descriptions,
@@ -14,7 +13,6 @@ import {
   InputNumber,
   Modal,
   Radio,
-  Row,
   Select,
   Space,
   Table,
@@ -24,6 +22,7 @@ import {
 } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
 import dayjs, { type Dayjs } from 'dayjs';
+import { DownOutlined, UpOutlined } from '@ant-design/icons';
 import { ORDER_TYPE_LABELS } from '@dukang/shared-types';
 import { request, type AdminOrderItem, type AdminOrderRow, type HqProfile, type Paginated } from '../lib/api';
 import { useAdminListColumns } from '../lib/useAdminListColumns';
@@ -150,9 +149,11 @@ type OrderExportFilters = {
   orderType?: string;
   cityId?: string;
   receiverPhone?: string;
+  userKeyword?: string;
+  productKeyword?: string;
   fulfillmentHold?: boolean;
-  excludeTest?: boolean;
   deliveryType?: string;
+  promoCodeId?: string;
   dateRange?: [Dayjs, Dayjs];
 };
 
@@ -212,6 +213,17 @@ const DATE_PRESETS: Array<{ key: 'day' | 'week' | 'month' | 'quarter' | 'year';
   { key: 'year', label: '当年' },
 ];
 
+const FILTERS_COLLAPSED_KEY = 'admin-orders-filters-collapsed';
+
+function formatUserWithRemark(user?: {
+  userNo?: string;
+  hqRemark?: string | null;
+} | null) {
+  const userNo = user?.userNo || '—';
+  const remark = user?.hqRemark?.trim();
+  return remark ? `${userNo}（${remark}）` : userNo;
+}
+
 function formatBenefitBrief(row: AdminOrderRow) {
   const coupon = row.benefitCoupon;
   if (coupon) {
@@ -244,9 +256,11 @@ function buildExportPayload(
   if (filters.orderType) payload.orderType = filters.orderType;
   if (filters.cityId) payload.cityId = filters.cityId;
   if (filters.receiverPhone) payload.receiverPhone = filters.receiverPhone;
+  if (filters.userKeyword) payload.userKeyword = filters.userKeyword;
+  if (filters.productKeyword) payload.productKeyword = filters.productKeyword;
   if (filters.deliveryType) payload.deliveryType = filters.deliveryType;
   if (filters.fulfillmentHold) payload.fulfillmentHold = true;
-  if (filters.excludeTest) payload.excludeTest = true;
+  if (filters.promoCodeId) payload.promoCodeId = filters.promoCodeId;
   if (filters.dateRange?.[0]) payload.createdFrom = filters.dateRange[0].format('YYYY-MM-DD');
   if (filters.dateRange?.[1]) payload.createdTo = filters.dateRange[1].format('YYYY-MM-DD');
   return payload;
@@ -285,8 +299,15 @@ function warehouseToDefaults(wh: WarehouseOption, base?: ShipDefaults | null): S
 
 export default function OrdersPage() {
   const navigate = useNavigate();
+  const location = useLocation();
   const [searchParams] = useSearchParams();
   const initialOrderNo = searchParams.get('orderNo')?.trim() || '';
+  const initialPromoCodeId = searchParams.get('promoCodeId')?.trim() || '';
+  const initialStatusParam = searchParams.getAll('status').join(',');
+  const initialStatuses = useMemo(
+    () => initialStatusParam.split(',').map((s) => s.trim()).filter(Boolean),
+    [initialStatusParam],
+  );
   const [form] = Form.useForm();
   const [shipForm] = Form.useForm();
   const [logisticsForm] = Form.useForm();
@@ -317,6 +338,13 @@ export default function OrdersPage() {
   const [trackOpen, setTrackOpen] = useState(false);
   const [exporting, setExporting] = useState(false);
   const [exportFormat, setExportFormat] = useState<OrderExportFormat>('xlsx');
+  const [filtersCollapsed, setFiltersCollapsed] = useState(() => {
+    try {
+      return localStorage.getItem(FILTERS_COLLAPSED_KEY) === '1';
+    } catch {
+      return false;
+    }
+  });
   const canDeleteOrders = (profile?.permissionKeys ?? []).includes('orders_delete');
   const canProxyOrder = (profile?.permissionKeys ?? []).includes('orders');
   const canExportOrders = (profile?.permissionKeys ?? []).includes('orders');
@@ -336,6 +364,20 @@ export default function OrdersPage() {
     }
   }, [form, initialOrderNo]);
 
+  useEffect(() => {
+    if (initialStatuses.length) {
+      form.setFieldsValue({ status: initialStatuses });
+    }
+  }, [form, initialStatuses]);
+
+  useEffect(() => {
+    const openOrderId = (location.state as { openOrderId?: string } | null)?.openOrderId;
+    if (openOrderId) {
+      void openDetail(openOrderId);
+      navigate(`${location.pathname}${location.search}`, { replace: true, state: null });
+    }
+  }, [location.state, location.pathname, location.search, navigate]);
+
   useEffect(() => {
     if (!initialOrderNo || deepLinkOpenedRef.current || loading) return;
     const first = data?.items?.[0];
@@ -366,13 +408,17 @@ export default function OrdersPage() {
       const qs = new URLSearchParams({ page: String(page), pageSize: String(pageSize) });
       if (initialOrderNo) qs.set('orderNo', initialOrderNo);
       if (values.orderNo) qs.set('orderNo', values.orderNo);
-      for (const status of selectedStatuses(values.status)) qs.append('status', status);
+      const statuses = selectedStatuses(values.status);
+      const statusList = statuses.length ? statuses : initialStatuses;
+      for (const status of statusList) qs.append('status', status);
       if (values.orderType) qs.set('orderType', values.orderType);
       if (values.cityId) qs.set('cityId', values.cityId);
       if (values.receiverPhone) qs.set('receiverPhone', values.receiverPhone);
+      if (values.userKeyword) qs.set('userKeyword', values.userKeyword);
+      if (values.productKeyword) qs.set('productKeyword', values.productKeyword);
       if (values.fulfillmentHold) qs.set('fulfillmentHold', 'true');
-      if (values.excludeTest) qs.set('excludeTest', 'true');
       if (values.deliveryType) qs.set('deliveryType', values.deliveryType);
+      if (initialPromoCodeId) qs.set('promoCodeId', initialPromoCodeId);
       if (values.dateRange?.[0]) qs.set('createdFrom', values.dateRange[0].format('YYYY-MM-DD'));
       if (values.dateRange?.[1]) qs.set('createdTo', values.dateRange[1].format('YYYY-MM-DD'));
       const res = await request<Paginated<AdminOrderRow>>(`/admin/orders?${qs}`);
@@ -380,7 +426,7 @@ export default function OrdersPage() {
     } finally {
       setLoading(false);
     }
-  }, [form, page, pageSize, initialOrderNo]);
+  }, [form, page, pageSize, initialOrderNo, initialPromoCodeId, initialStatuses]);
 
   useEffect(() => {
     void load();
@@ -589,7 +635,16 @@ export default function OrdersPage() {
     }
     setExporting(true);
     try {
-      const payload = buildExportPayload(scope, exportFormat, values, selectedRowKeys);
+      const payload = buildExportPayload(
+        scope,
+        exportFormat,
+        {
+          ...values,
+          promoCodeId: initialPromoCodeId || values.promoCodeId,
+          status: selectedStatuses(values.status).length ? values.status : initialStatuses,
+        },
+        selectedRowKeys,
+      );
       const result = await request<OrderExportResult>('/admin/orders/export', {
         method: 'POST',
         body: JSON.stringify(payload),
@@ -618,14 +673,14 @@ export default function OrdersPage() {
     {
       title: '用户',
       key: 'user',
-      width: 120,
+      width: 200,
       render: (_, row) =>
         row.user?.id ? (
-          <AdminPrimaryLink onClick={() => navigate('/users', { state: { openUserId: String(row.user!.id) } })}>
-            {row.user.userNo}
+          <AdminPrimaryLink onClick={() => navigate(`/users?userId=${encodeURIComponent(String(row.user!.id))}`)}>
+            {formatUserWithRemark(row.user)}
           </AdminPrimaryLink>
         ) : (
-          (row.user?.userNo || '—')
+          formatUserWithRemark(row.user)
         ),
     },
     {
@@ -778,15 +833,93 @@ export default function OrdersPage() {
         />
       ) : null}
 
+      {initialPromoCodeId ? (
+        <Alert
+          type="info"
+          showIcon
+          closable
+          style={{ marginBottom: 16 }}
+          message={
+            initialStatuses.includes('COMPLETED') && initialStatuses.length === 1
+              ? '已按推广码筛选已完成订单'
+              : '已按推广码筛选订单'
+          }
+          action={
+            <Button size="small" onClick={() => navigate('/orders')}>
+              清除筛选
+            </Button>
+          }
+          onClose={() => navigate('/orders')}
+        />
+      ) : null}
+
       <Form form={form} layout="vertical" onFinish={() => { setPage(1); void load(); }}>
-        <Row gutter={[16, 8]}>
-          <Col xs={24} md={14} lg={12}>
-            <Form.Item label="下单日期" style={{ marginBottom: 12 }}>
-              <Space direction="vertical" size={8} style={{ width: '100%' }}>
-                <Form.Item name="dateRange" noStyle>
-                  <DatePicker.RangePicker allowClear style={{ width: '100%' }} />
-                </Form.Item>
+        <div className="admin-orders-filter-row">
+          <Form.Item name="cityId" label="城市" className="admin-orders-filter-item admin-orders-filter-item--sm">
+            <Select
+              allowClear
+              showSearch
+              optionFilterProp="label"
+              placeholder="全部"
+              options={cities.map((c) => ({ value: c.id, label: c.name }))}
+            />
+          </Form.Item>
+          <Form.Item name="receiverPhone" label="手机号" className="admin-orders-filter-item admin-orders-filter-item--md">
+            <Input allowClear placeholder="手机号" />
+          </Form.Item>
+          <Form.Item name="userKeyword" label="用户" className="admin-orders-filter-item admin-orders-filter-item--search">
+            <Input allowClear placeholder="编号/昵称/备注/手机" />
+          </Form.Item>
+          <Form.Item name="productKeyword" label="商品" className="admin-orders-filter-item admin-orders-filter-item--search">
+            <Input allowClear placeholder="名称/规格" />
+          </Form.Item>
+          <Form.Item name="status" label="状态" className="admin-orders-filter-item admin-orders-filter-item--status">
+            <Select
+              mode="multiple"
+              allowClear
+              maxTagCount="responsive"
+              placeholder="全部"
+              options={Object.entries(ORDER_STATUS_LABELS).map(([value, label]) => ({ value, label }))}
+            />
+          </Form.Item>
+          <Form.Item name="orderType" label="类型" className="admin-orders-filter-item admin-orders-filter-item--sm">
+            <Select allowClear placeholder="全部" options={ORDER_TYPE_OPTIONS} />
+          </Form.Item>
+          <Form.Item name="deliveryType" label="配送" className="admin-orders-filter-item admin-orders-filter-item--sm">
+            <Select allowClear placeholder="全部" options={DELIVERY_TYPE_OPTIONS} />
+          </Form.Item>
+          <Form.Item label=" " colon={false} className="admin-orders-filter-item admin-orders-filter-actions">
+            <Space size={8} wrap>
+              <Button type="primary" htmlType="submit">查询</Button>
+              <Button
+                type="link"
+                icon={filtersCollapsed ? <DownOutlined /> : <UpOutlined />}
+                onClick={() => {
+                  setFiltersCollapsed((prev) => {
+                    const next = !prev;
+                    try {
+                      localStorage.setItem(FILTERS_COLLAPSED_KEY, next ? '1' : '0');
+                    } catch {
+                      /* ignore */
+                    }
+                    return next;
+                  });
+                }}
+              >
+                {filtersCollapsed ? '展开' : '收起'}
+              </Button>
+            </Space>
+          </Form.Item>
+        </div>
+
+        {!filtersCollapsed ? (
+          <>
+            <div className="admin-orders-filter-row">
+              <Form.Item label="下单日期" className="admin-orders-filter-item admin-orders-filter-item--date">
                 <Space size={8} wrap>
+                  <Form.Item name="dateRange" noStyle>
+                    <DatePicker.RangePicker allowClear className="admin-orders-date-picker" />
+                  </Form.Item>
                   {DATE_PRESETS.map((preset) => (
                     <Button
                       key={preset.key}
@@ -797,98 +930,60 @@ export default function OrdersPage() {
                     </Button>
                   ))}
                 </Space>
-              </Space>
-            </Form.Item>
-          </Col>
-          <Col xs={24} sm={12} md={8} lg={6}>
-            <Form.Item name="status" label="状态" style={{ marginBottom: 12 }}>
-              <Select
-                mode="multiple"
-                allowClear
-                maxTagCount="responsive"
-                placeholder="全部"
-                options={Object.entries(ORDER_STATUS_LABELS).map(([value, label]) => ({ value, label }))}
-              />
-            </Form.Item>
-          </Col>
-          <Col xs={12} sm={6} md={5} lg={3}>
-            <Form.Item name="orderType" label="类型" style={{ marginBottom: 12 }}>
-              <Select allowClear placeholder="全部" options={ORDER_TYPE_OPTIONS} />
-            </Form.Item>
-          </Col>
-          <Col xs={12} sm={6} md={5} lg={3}>
-            <Form.Item name="deliveryType" label="配送" style={{ marginBottom: 12 }}>
-              <Select allowClear placeholder="全部" options={DELIVERY_TYPE_OPTIONS} />
-            </Form.Item>
-          </Col>
-          <Col xs={12} sm={6} md={5} lg={3}>
-            <Form.Item name="cityId" label="城市" style={{ marginBottom: 12 }}>
-              <Select
-                allowClear
-                showSearch
-                optionFilterProp="label"
-                placeholder="全部"
-                options={cities.map((c) => ({ value: c.id, label: c.name }))}
-              />
-            </Form.Item>
-          </Col>
-          <Col xs={12} sm={8} md={6} lg={6}>
-            <Form.Item name="receiverPhone" label="收货手机" style={{ marginBottom: 12 }}>
-              <Input allowClear placeholder="手机号" />
-            </Form.Item>
-          </Col>
-          <Col xs={12} sm={8} md={8} lg={8}>
-            <Form.Item label=" " colon={false} style={{ marginBottom: 12 }}>
-              <Space size={16} wrap>
+              </Form.Item>
+            </div>
+
+            <div className="admin-orders-filter-row admin-orders-filter-row--tools">
+              {canExportOrders ? (
+                <Space size={12} wrap>
+                  <Radio.Group
+                    optionType="button"
+                    buttonStyle="solid"
+                    value={exportFormat}
+                    onChange={(e) => setExportFormat(e.target.value)}
+                  >
+                    <Radio.Button value="xlsx">Excel</Radio.Button>
+                    <Radio.Button value="pdf">PDF</Radio.Button>
+                  </Radio.Group>
+                  <Button
+                    disabled={!selectedRowKeys.length}
+                    loading={exporting}
+                    onClick={() => void submitExport('selected')}
+                  >
+                    导出已勾选{selectedRowKeys.length ? `（${selectedRowKeys.length}）` : ''}
+                  </Button>
+                  <Button loading={exporting} onClick={() => void submitExport('filter')}>
+                    导出全部筛选
+                  </Button>
+                </Space>
+              ) : <span />}
+              <Space size={12} wrap>
                 <Form.Item name="fulfillmentHold" valuePropName="checked" noStyle>
                   <Checkbox>大单拦截</Checkbox>
                 </Form.Item>
-                <Form.Item name="excludeTest" valuePropName="checked" noStyle>
-                  <Checkbox>过滤测试</Checkbox>
-                </Form.Item>
+                <Button
+                  onClick={() => {
+                    form.resetFields();
+                    setPage(1);
+                    if (initialPromoCodeId || initialOrderNo || initialStatuses.length) navigate('/orders');
+                    else void load();
+                  }}
+                >
+                  重置
+                </Button>
+                {canDeleteOrders ? (
+                  <Button
+                    danger
+                    disabled={!selectedRowKeys.length}
+                    onClick={() => setBatchDeleteOpen(true)}
+                  >
+                    批量删除{selectedRowKeys.length ? `（${selectedRowKeys.length}）` : ''}
+                  </Button>
+                ) : null}
               </Space>
-            </Form.Item>
-          </Col>
-        </Row>
-
-        <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'center', margin: '8px 0 16px', gap: 12, flexWrap: 'wrap' }}>
-          {canExportOrders ? (
-            <Space size={12} wrap>
-              <Radio.Group
-                optionType="button"
-                buttonStyle="solid"
-                value={exportFormat}
-                onChange={(e) => setExportFormat(e.target.value)}
-              >
-                <Radio.Button value="xlsx">Excel</Radio.Button>
-                <Radio.Button value="pdf">PDF</Radio.Button>
-              </Radio.Group>
-              <Button
-                disabled={!selectedRowKeys.length}
-                loading={exporting}
-                onClick={() => void submitExport('selected')}
-              >
-                导出已勾选{selectedRowKeys.length ? `（${selectedRowKeys.length}）` : ''}
-              </Button>
-              <Button loading={exporting} onClick={() => void submitExport('filter')}>
-                导出全部筛选
-              </Button>
-            </Space>
-          ) : <span />}
-          <Space size={12} wrap>
-            <Button type="primary" htmlType="submit">查询</Button>
-            <Button onClick={() => { form.resetFields(); setPage(1); void load(); }}>重置</Button>
-            {canDeleteOrders ? (
-              <Button
-                danger
-                disabled={!selectedRowKeys.length}
-                onClick={() => setBatchDeleteOpen(true)}
-              >
-                批量删除{selectedRowKeys.length ? `（${selectedRowKeys.length}）` : ''}
-              </Button>
-            ) : null}
-          </Space>
-        </div>
+            </div>
+          </>
+        ) : null}
       </Form>
 
       <Table
@@ -987,7 +1082,18 @@ export default function OrdersPage() {
                   {[detail.proxyPartnerName, detail.proxyPartnerPhone].filter(Boolean).join(' / ') || '—'}
                 </Descriptions.Item>
               ) : null}
-              <Descriptions.Item label="用户">{detail.user?.userNo} / {detail.user?.nickname}</Descriptions.Item>
+              <Descriptions.Item label="用户">
+                {detail.user?.id ? (
+                  <AdminPrimaryLink
+                    onClick={() => navigate(`/users?userId=${encodeURIComponent(String(detail.user!.id))}`)}
+                  >
+                    {formatUserWithRemark(detail.user)}
+                  </AdminPrimaryLink>
+                ) : (
+                  formatUserWithRemark(detail.user)
+                )}
+                {detail.user?.nickname ? ` / ${detail.user.nickname}` : ''}
+              </Descriptions.Item>
               <Descriptions.Item label="商品额">¥{detail.productAmount}</Descriptions.Item>
               <Descriptions.Item label="实付">¥{detail.payAmount}</Descriptions.Item>
               <Descriptions.Item label="好客权益">¥{detail.benefitAmount}</Descriptions.Item>

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

@@ -1,7 +1,7 @@
 import { useEffect, useState } from 'react';
 import { useNavigate } from 'react-router-dom';
 import {
-  Button, Form, Input, Modal, Select, Space, Table, Tag, Typography, message,
+  Button, Form, Input, Modal, Select, Space, Table, Tag, Tooltip, Typography, message,
 } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
 import {
@@ -23,21 +23,6 @@ type Row = PromoCodeItem;
 
 type SceneOption = { value: PromoCodeScene; label: string };
 
-async function downloadQrcode(url: string, filename: string) {
-  try {
-    const res = await fetch(url);
-    const blob = await res.blob();
-    const objectUrl = URL.createObjectURL(blob);
-    const a = document.createElement('a');
-    a.href = objectUrl;
-    a.download = filename;
-    a.click();
-    URL.revokeObjectURL(objectUrl);
-  } catch {
-    window.open(url, '_blank');
-  }
-}
-
 export default function PromoCodesPage() {
   const navigate = useNavigate();
   const [filterForm] = Form.useForm();
@@ -104,8 +89,26 @@ export default function PromoCodesPage() {
         </Tag>
       ),
     },
-    { title: '扫码', dataIndex: 'scanCount', width: 70 },
-    { title: '订单', dataIndex: 'orderCount', width: 70 },
+    {
+      title: '扫码',
+      dataIndex: 'scanCount',
+      width: 70,
+      render: (v: number, row) => (
+        <AdminPrimaryLink onClick={() => navigate(`/promo-codes/${row.id}?eventType=SCAN`)}>
+          {v}
+        </AdminPrimaryLink>
+      ),
+    },
+    {
+      title: <Tooltip title="仅统计已完成订单">订单</Tooltip>,
+      dataIndex: 'orderCount',
+      width: 70,
+      render: (v: number, row) => (
+        <AdminPrimaryLink onClick={() => navigate(`/orders?promoCodeId=${row.id}&status=COMPLETED`)}>
+          {v}
+        </AdminPrimaryLink>
+      ),
+    },
     {
       title: '转化率',
       width: 90,
@@ -119,24 +122,13 @@ export default function PromoCodesPage() {
     { title: '创建', dataIndex: 'createdAt', width: 160, render: fmtTime },
     {
       title: '操作',
-      width: 220,
+      width: 140,
       fixed: 'right',
       render: (_, row) => (
         <Space size="small" wrap>
           <Button type="link" size="small" onClick={() => navigate(`/promo-codes/${row.id}`)}>
             详情
           </Button>
-          <Button
-            type="link"
-            size="small"
-            disabled={!row.qrcodeUrl}
-            onClick={() => {
-              if (!row.qrcodeUrl) return;
-              void downloadQrcode(row.qrcodeUrl, `${row.code}-wxacode.png`);
-            }}
-          >
-            下载小程序码
-          </Button>
           <Button type="link" size="small" onClick={() => navigate(`/promo-codes/${row.id}/users`)}>
             关联用户
           </Button>

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

@@ -1,5 +1,5 @@
 import { useEffect, useRef, useState } from 'react';
-import { useSearchParams } from 'react-router-dom';
+import { useNavigate, useSearchParams } from 'react-router-dom';
 import { Button, Checkbox, Drawer, Form, Input, Select, Table, Tag, Typography } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
 import { REDEEM_CHANNEL_LABELS, type RedeemChannel } from '@dukang/shared-types';
@@ -20,17 +20,28 @@ type Row = {
   channel?: RedeemChannel;
   createdAt: string;
   isTest?: boolean;
-  user?: { userNo: string; phone: string | null; nickname?: string | null };
+  user?: {
+    id?: string;
+    userNo: string;
+    phone: string | null;
+    nickname?: string | null;
+    hqRemark?: string | null;
+  };
   store?: { name: string; cityName: string };
-  coupon?: { couponNo: string };
+  coupon?: { id?: string; couponNo: string };
 };
 
-function maskPhone(phone: string | null | undefined) {
-  if (!phone || phone.length < 7) return phone ?? '—';
-  return `${phone.slice(0, 3)}****${phone.slice(-4)}`;
+function formatNicknameWithRemark(user?: {
+  nickname?: string | null;
+  hqRemark?: string | null;
+} | null) {
+  const name = user?.nickname?.trim() || '—';
+  const remark = user?.hqRemark?.trim();
+  return remark ? `${name}（${remark}）` : name;
 }
 
 export default function RedeemRecordsPage() {
+  const navigate = useNavigate();
   const [searchParams] = useSearchParams();
   const initialRedeemNo = searchParams.get('redeemNo')?.trim() || '';
   const [form] = Form.useForm();
@@ -108,23 +119,60 @@ export default function RedeemRecordsPage() {
         );
       },
     },
-    { title: '用户编号', dataIndex: ['user', 'userNo'], width: 110 },
+    { title: '用户编号', dataIndex: ['user', 'userNo'], width: 110, render: (v: string | undefined, row) =>
+      row.user?.id ? (
+        <AdminPrimaryLink
+          onClick={() => navigate('/users', { state: { openUserId: String(row.user!.id) } })}
+        >
+          {v || '—'}
+        </AdminPrimaryLink>
+      ) : (
+        v || '—'
+      ),
+    },
     {
       title: '用户昵称',
       dataIndex: ['user', 'nickname'],
-      width: 100,
-      render: (v: string | null | undefined) => v || '—',
+      width: 160,
+      render: (_: string | null | undefined, row) =>
+        row.user?.id ? (
+          <AdminPrimaryLink
+            onClick={() => navigate('/users', { state: { openUserId: String(row.user!.id) } })}
+          >
+            {formatNicknameWithRemark(row.user)}
+          </AdminPrimaryLink>
+        ) : (
+          formatNicknameWithRemark(row.user)
+        ),
     },
     {
       title: '用户手机',
       dataIndex: ['user', 'phone'],
       width: 120,
-      render: (v: string | null | undefined) => maskPhone(v),
+      render: (v: string | null | undefined) => v || '—',
     },
     { title: '门店', dataIndex: ['store', 'name'] },
     { title: '核销额', dataIndex: 'amount', width: 90, render: (v) => `¥${v}` },
     { title: '结算额', dataIndex: 'settleAmount', width: 90, render: (v) => `¥${v}` },
-    { title: '券号', dataIndex: ['coupon', 'couponNo'], width: 160 },
+    {
+      title: '券号',
+      dataIndex: ['coupon', 'couponNo'],
+      width: 160,
+      render: (v: string | undefined, row) =>
+        v ? (
+          <AdminPrimaryLink
+            onClick={() =>
+              navigate(`/benefit/coupons?couponNo=${encodeURIComponent(v)}`, {
+                state: row.coupon?.id ? { openCouponId: String(row.coupon.id) } : undefined,
+              })
+            }
+          >
+            {v}
+          </AdminPrimaryLink>
+        ) : (
+          '—'
+        ),
+    },
     { title: '时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
     {
       title: '操作',

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

@@ -1,5 +1,5 @@
 import { useEffect, useState } from 'react';
-import { useSearchParams } from 'react-router-dom';
+import { useSearchParams, useNavigate } from 'react-router-dom';
 import {
   Button,
   Card,
@@ -14,6 +14,7 @@ import {
   Statistic,
   Table,
   Tag,
+  Tooltip,
   Typography,
   message,
 } from 'antd';
@@ -75,6 +76,7 @@ const KIND_COLORS: Record<StoreSettlementKind, string> = {
 };
 
 export default function StoreBillsPage() {
+  const navigate = useNavigate();
   const [searchParams] = useSearchParams();
   const initialKind = searchParams.get('kind') === 'WITHDRAW' ? 'WITHDRAW' : '';
   const initialStoreId = searchParams.get('storeId') || '';
@@ -294,7 +296,11 @@ export default function StoreBillsPage() {
       ),
     },
     {
-      title: '日期',
+      title: (
+        <Tooltip title="T+1 为出账日（昨日 00:00–今日 00:00 窗口中的今天，不是该账单里最后一笔核销时间）；手动提现为申请时间">
+          出账日
+        </Tooltip>
+      ),
       dataIndex: 'date',
       width: 160,
       render: (v, row) => (row.kind === 'T1_BILL' ? String(v || '').slice(0, 10) : fmtTime(v)),
@@ -389,6 +395,7 @@ export default function StoreBillsPage() {
           <>
             含 T+1 自动出账与门店手动提现；按类型筛选，详情与审核动作沿用原接口。
             「已打款」= T+1 出账终态，「已结算」= 手动提现终态。
+            T+1「出账日」是任务跑的那天（昨日 00:00–今日 00:00 窗口中的今天），不是最后一笔核销时间。
             {overdueSummary && overdueSummary.overdueCount > 0 ? (
               <div>
                 <Typography.Text type="danger">
@@ -469,7 +476,7 @@ export default function StoreBillsPage() {
             }))}
           />
         </Form.Item>
-        <Form.Item name="range" label="日期">
+        <Form.Item name="range" label="出账日">
           <DatePicker.RangePicker />
         </Form.Item>
         <Form.Item>
@@ -543,7 +550,7 @@ export default function StoreBillsPage() {
           <>
             <Descriptions column={1} size="small" bordered>
               <Descriptions.Item label="账单号">{String(detail.billNo)}</Descriptions.Item>
-              <Descriptions.Item label="账单日">
+              <Descriptions.Item label="出账日">
                 {String(detail.billDate || '').slice(0, 10)}
               </Descriptions.Item>
               <Descriptions.Item label="应付">
@@ -592,8 +599,22 @@ export default function StoreBillsPage() {
               columns={[
                 {
                   title: '核销单号',
-                  render: (_, r) =>
-                    String((r.redeemRecord as { redeemNo?: string })?.redeemNo || '—'),
+                  render: (_, r) => {
+                    const redeemNo = String(
+                      (r.redeemRecord as { redeemNo?: string } | undefined)?.redeemNo || '',
+                    );
+                    return redeemNo ? (
+                      <AdminPrimaryLink
+                        onClick={() =>
+                          navigate(`/redeem-records?redeemNo=${encodeURIComponent(redeemNo)}`)
+                        }
+                      >
+                        {redeemNo}
+                      </AdminPrimaryLink>
+                    ) : (
+                      '—'
+                    );
+                  },
                 },
                 {
                   title: '金额',
@@ -662,7 +683,18 @@ export default function StoreBillsPage() {
                     const payout = r.storePayout as
                       | { redeemRecord?: { redeemNo?: string }; payoutAmount?: number }
                       | undefined;
-                    return String(payout?.redeemRecord?.redeemNo || '—');
+                    const redeemNo = payout?.redeemRecord?.redeemNo || '';
+                    return redeemNo ? (
+                      <AdminPrimaryLink
+                        onClick={() =>
+                          navigate(`/redeem-records?redeemNo=${encodeURIComponent(redeemNo)}`)
+                        }
+                      >
+                        {redeemNo}
+                      </AdminPrimaryLink>
+                    ) : (
+                      '—'
+                    );
                   },
                 },
                 {

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

@@ -47,6 +47,7 @@ import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
 import OssUpload from '../components/OssUpload';
 import { useAdminListColumns } from '../lib/useAdminListColumns';
+import { AdminListHeader } from '../components/AdminListHeader';
 import { AdminPrimaryLink } from '../components/AdminPrimaryLink';
 
 
@@ -560,50 +561,43 @@ export default function SupportTicketsPage() {
   return (
     <div>
       {settingsModal}
-      <div
-        style={{
-          display: 'flex',
-          justifyContent: 'space-between',
-          alignItems: 'center',
-          marginBottom: 16,
-        }}
-      >
-        <Typography.Title level={4} style={{ margin: 0 }}>
-          技术支持
-        </Typography.Title>
-          {settingsButton}
-        <Space>
-          {isSuperAdmin ? (
-            <>
-              <Button
-                disabled={!selectedRowKeys.length}
-                loading={batchCreateSaving}
-                onClick={() => void submitBatchCreateTasks()}
-              >
-                一键创建任务
-              </Button>
-              <Button disabled={!selectedRowKeys.length} onClick={openBatchPublish}>
-                一键发布
-              </Button>
-              <Button disabled={!selectedRowKeys.length} loading={acting} onClick={() => void startBatchPreview()}>
-                批量审核
-              </Button>
-              <Button
-                disabled={!selectedRowKeys.length}
-                onClick={() => {
-                  batchStatusForm.setFieldsValue({ status: 'TESTING', rejectReason: '', note: '' });
-                  setBatchStatusOpen(true);
-                }}
-              >
-                批量改状态
-              </Button>
-            </>
-          ) : null}
-          <Button type="primary" onClick={() => setCreateOpen(true)}>
-            创建工单
-          </Button>
-        </Space>
-      </div>
+      <AdminListHeader
+        title="技术支持"
+        settings={settingsButton}
+        actions={
+          <>
+            {isSuperAdmin ? (
+              <>
+                <Button
+                  disabled={!selectedRowKeys.length}
+                  loading={batchCreateSaving}
+                  onClick={() => void submitBatchCreateTasks()}
+                >
+                  一键创建任务
+                </Button>
+                <Button disabled={!selectedRowKeys.length} onClick={openBatchPublish}>
+                  一键发布
+                </Button>
+                <Button disabled={!selectedRowKeys.length} loading={acting} onClick={() => void startBatchPreview()}>
+                  批量审核
+                </Button>
+                <Button
+                  disabled={!selectedRowKeys.length}
+                  onClick={() => {
+                    batchStatusForm.setFieldsValue({ status: 'TESTING', rejectReason: '', note: '' });
+                    setBatchStatusOpen(true);
+                  }}
+                >
+                  批量改状态
+                </Button>
+              </>
+            ) : null}
+            <Button type="primary" onClick={() => setCreateOpen(true)}>
+              创建工单
+            </Button>
+          </>
+        }
+      />
 
       <Form
         layout="inline"

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

@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { Link, useLocation, useNavigate } from 'react-router-dom';
+import { Link, useLocation, useNavigate, useSearchParams } from 'react-router-dom';
 import {
   Alert,
   Button,
@@ -155,6 +155,7 @@ type BatchDeletePreview = {
 export default function UsersPage() {
   const navigate = useNavigate();
   const location = useLocation();
+  const [searchParams, setSearchParams] = useSearchParams();
   const [form] = Form.useForm();
   const [profile, setProfile] = useState<HqProfile | null>(null);
   const [data, setData] = useState<Paginated<AdminUserRow> | null>(null);
@@ -185,6 +186,8 @@ export default function UsersPage() {
     try {
       const values = form.getFieldsValue();
       const qs = new URLSearchParams({ page: String(page), pageSize: String(pageSize) });
+      const userId = String(values.userId || '').trim();
+      if (userId) qs.set('userId', userId);
       if (values.phone) qs.set('phone', values.phone);
       if (values.userNo) qs.set('userNo', values.userNo);
       if (values.deviceKey) qs.set('deviceKey', values.deviceKey);
@@ -202,17 +205,26 @@ export default function UsersPage() {
     }
   }, [form, page, pageSize]);
 
+  useEffect(() => {
+    const userId = searchParams.get('userId');
+    if (userId) form.setFieldsValue({ userId });
+  }, [searchParams, form]);
+
   useEffect(() => {
     void load();
-  }, [load]);
+  }, [load, searchParams]);
 
   useEffect(() => {
     const openUserId = (location.state as { openUserId?: string } | null)?.openUserId;
-    if (openUserId) {
-      void openDetail(openUserId);
-      navigate(location.pathname, { replace: true, state: null });
-    }
-  }, [location.state, location.pathname, navigate]);
+    if (!openUserId) return;
+    form.setFieldsValue({ userId: openUserId });
+    setPage(1);
+    void openDetail(openUserId);
+    navigate(`${location.pathname}?userId=${encodeURIComponent(openUserId)}`, {
+      replace: true,
+      state: null,
+    });
+  }, [location.state, location.pathname, navigate, form]);
 
   async function openDetail(id: string) {
     const [res, logs] = await Promise.all([
@@ -498,13 +510,30 @@ export default function UsersPage() {
           ) : null
         }
       />
-      <Form form={form} layout="inline" style={{ marginBottom: 16 }} onFinish={() => { setPage(1); void load(); }}>
+      <Form
+        form={form}
+        layout="inline"
+        style={{ marginBottom: 16 }}
+        onFinish={() => {
+          setPage(1);
+          const userId = String(form.getFieldValue('userId') || '').trim();
+          const current = searchParams.get('userId') ?? '';
+          if (userId !== current) {
+            if (userId) setSearchParams({ userId }, { replace: true });
+            else setSearchParams({}, { replace: true });
+          }
+          void load();
+        }}
+      >
         <Form.Item name="phone" label="手机号">
           <Input placeholder="模糊搜索" allowClear />
         </Form.Item>
         <Form.Item name="userNo" label="用户编号">
           <Input placeholder="DK..." allowClear />
         </Form.Item>
+        <Form.Item name="userId" label="用户ID">
+          <Input placeholder="精确匹配" allowClear style={{ width: 140 }} />
+        </Form.Item>
         <Form.Item name="deviceKey" label="deviceKey">
           <Input placeholder="UUID" allowClear style={{ width: 200 }} />
         </Form.Item>
@@ -526,7 +555,19 @@ export default function UsersPage() {
         <Form.Item>
           <Space>
             <Button type="primary" htmlType="submit">查询</Button>
-            <Button onClick={() => { form.resetFields(); setPage(1); void load(); }}>重置</Button>
+            <Button
+              onClick={() => {
+                form.resetFields();
+                setPage(1);
+                if (searchParams.get('userId')) {
+                  setSearchParams({}, { replace: true });
+                } else {
+                  void load();
+                }
+              }}
+            >
+              重置
+            </Button>
           </Space>
         </Form.Item>
       </Form>
@@ -570,7 +611,7 @@ export default function UsersPage() {
               <Descriptions.Item label="用户编号">{detail.userNo}</Descriptions.Item>
               <Descriptions.Item label="昵称">{detail.nickname || '—'}</Descriptions.Item>
               <Descriptions.Item label="备注">{detail.hqRemark || '—'}</Descriptions.Item>
-              <Descriptions.Item label="手机号">{maskPhone(detail.phone)}</Descriptions.Item>
+              <Descriptions.Item label="手机号">{detail.phone || '—'}</Descriptions.Item>
               <Descriptions.Item label="验手机时间">
                 {detail.phoneVerifiedAt ? new Date(detail.phoneVerifiedAt).toLocaleString('zh-CN') : '未验证'}
               </Descriptions.Item>
@@ -604,7 +645,7 @@ export default function UsersPage() {
               <Descriptions.Item label="deviceKey">{detail.deviceKey || '—'}</Descriptions.Item>
               <Descriptions.Item label="合并至">
                 {detail.mergedInto
-                  ? `${detail.mergedInto.userNo} (${detail.mergedInto.phone ? maskPhone(detail.mergedInto.phone) : '无手机'})`
+                  ? `${detail.mergedInto.userNo} (${detail.mergedInto.phone || '无手机'})`
                   : '—'}
               </Descriptions.Item>
               <Descriptions.Item label="被合并访客数">{detail.mergedFromCount ?? 0}</Descriptions.Item>

apps/admin-web/src/pages/promo/PromoCodeDetailPage.tsx

@@ -1,5 +1,6 @@
 import { useState, type CSSProperties } from 'react';
-import { useOutletContext } from 'react-router-dom';
+import { useNavigate, useOutletContext } from 'react-router-dom';
+import { QuestionCircleOutlined } from '@ant-design/icons';
 import {
   Button,
   Card,
@@ -13,6 +14,7 @@ import {
   Select,
   Space,
   Statistic,
+  Tooltip,
   Typography,
   message,
 } from 'antd';
@@ -35,6 +37,9 @@ const descContentStyle: CSSProperties = {
   wordBreak: 'break-all',
 };
 
+const ATTRIBUTION_HINT =
+  '首次触达本推广码的用户。每人只归因一次、只归一个码：已登录用户扫码或带参进入时，若还没有归因记录，则记到本码；之后再扫其他码不会改。与「扫码注册」不同：注册只统计来源仍是自然量并被标记为本码的用户；已有其他来源（如分享）的用户仍可计入归因，但不计入扫码注册。';
+
 async function downloadQrcode(url: string, filename: string) {
   try {
     const res = await fetch(url);
@@ -51,6 +56,7 @@ async function downloadQrcode(url: string, filename: string) {
 }
 
 export default function PromoCodeDetailPage() {
+  const navigate = useNavigate();
   const { detail, reload } = useOutletContext<PromoCodeDetailContext>();
   const [editForm] = Form.useForm();
   const [editOpen, setEditOpen] = useState(false);
@@ -209,14 +215,26 @@ export default function PromoCodeDetailPage() {
 
       <Row gutter={16} style={{ marginTop: 16 }}>
         <Col xs={12} sm={6}>
-          <Card size="small">
+          <Card
+            size="small"
+            hoverable
+            style={{ cursor: 'pointer' }}
+            onClick={() => navigate(`/promo-codes/${detail.id}?eventType=SCAN`)}
+          >
             <Statistic title="扫码进入次数" value={stats?.scanCount ?? detail.scanCount} />
           </Card>
         </Col>
         <Col xs={12} sm={6}>
           <Card size="small">
             <Statistic
-              title="归因用户数"
+              title={
+                <span>
+                  归因用户数
+                  <Tooltip title={ATTRIBUTION_HINT} overlayInnerStyle={{ maxWidth: 360 }}>
+                    <QuestionCircleOutlined style={{ marginLeft: 6, color: 'rgba(0,0,0,0.45)' }} />
+                  </Tooltip>
+                </span>
+              }
               value={stats?.attributionCount ?? 0}
             />
           </Card>
@@ -230,8 +248,23 @@ export default function PromoCodeDetailPage() {
           </Card>
         </Col>
         <Col xs={12} sm={6}>
-          <Card size="small">
-            <Statistic title="订单数" value={stats?.orderCount ?? detail.orderCount} />
+          <Card
+            size="small"
+            hoverable
+            style={{ cursor: 'pointer' }}
+            onClick={() => navigate(`/orders?promoCodeId=${detail.id}&status=COMPLETED`)}
+          >
+            <Statistic
+              title={
+                <span>
+                  订单数
+                  <Tooltip title="仅统计已完成订单" overlayInnerStyle={{ maxWidth: 280 }}>
+                    <QuestionCircleOutlined style={{ marginLeft: 6, color: 'rgba(0,0,0,0.45)' }} />
+                  </Tooltip>
+                </span>
+              }
+              value={stats?.orderCount ?? detail.orderCount}
+            />
           </Card>
         </Col>
         <Col xs={12} sm={6}>

apps/admin-web/src/pages/promo/PromoCodeMetricsPanel.tsx

@@ -1,4 +1,5 @@
 import { useCallback, useEffect, useMemo, useState } from 'react';
+import { useNavigate, useSearchParams } from 'react-router-dom';
 import {
   Card,
   DatePicker,
@@ -21,6 +22,7 @@ import {
 } from '@dukang/shared-types';
 import { request, type Paginated } from '../../lib/api';
 import { fmtTime } from '../../lib/constants';
+import { AdminPrimaryLink } from '../../components/AdminPrimaryLink';
 
 type Props = {
   promoId: string;
@@ -57,11 +59,45 @@ function buildEventsQs(
   return `/admin/promo-codes/${promoId}/metrics/events?${qs.toString()}`;
 }
 
-function formatRefId(row: PromoMetricEventItem): string {
-  if (row.orderId) return `订单 ${row.orderId}`;
-  if (row.userId) return `用户 ${row.userId}`;
-  if (row.sessionId) return `会话 ${row.sessionId}`;
-  return '—';
+function parseEventType(raw: string | null): PromoMetricEventType | undefined {
+  if (raw === 'SCAN' || raw === 'ATTRIBUTION' || raw === 'REGISTER' || raw === 'ORDER') return raw;
+  return undefined;
+}
+
+function EventRefLinks({ row }: { row: PromoMetricEventItem }) {
+  const navigate = useNavigate();
+  const links = [];
+  if (row.orderId) {
+    links.push(
+      <AdminPrimaryLink
+        key="order"
+        onClick={() => {
+          if (row.orderNo) {
+            navigate(`/orders?orderNo=${encodeURIComponent(row.orderNo)}`);
+          } else {
+            navigate('/orders', { state: { openOrderId: String(row.orderId) } });
+          }
+        }}
+      >
+        订单 {row.orderNo || row.orderId}
+      </AdminPrimaryLink>,
+    );
+  }
+  if (row.userId) {
+    links.push(
+      <AdminPrimaryLink
+        key="user"
+        onClick={() => navigate('/users', { state: { openUserId: String(row.userId) } })}
+      >
+        用户 {row.userNo || row.userId}
+      </AdminPrimaryLink>,
+    );
+  }
+  if (links.length) {
+    return <Space size={12}>{links}</Space>;
+  }
+  if (row.sessionId) return <>会话 {row.sessionId}</>;
+  return <>—</>;
 }
 
 function formatLocation(row: PromoMetricEventItem): string {
@@ -71,15 +107,27 @@ function formatLocation(row: PromoMetricEventItem): string {
 }
 
 export default function PromoCodeMetricsPanel({ promoId }: Props) {
+  const [searchParams, setSearchParams] = useSearchParams();
+  const urlEventType = parseEventType(searchParams.get('eventType'));
   const [range, setRange] = useState<[Dayjs, Dayjs]>([dayjs().subtract(6, 'day'), dayjs()]);
   const [granularity, setGranularity] = useState<'day' | 'hour'>('day');
   const [timeline, setTimeline] = useState<PromoMetricTimelineDto | null>(null);
   const [timelineLoading, setTimelineLoading] = useState(false);
-  const [eventType, setEventType] = useState<PromoMetricEventType | undefined>();
+  const [eventType, setEventType] = useState<PromoMetricEventType | undefined>(urlEventType);
   const [eventsPage, setEventsPage] = useState(1);
   const [events, setEvents] = useState<Paginated<PromoMetricEventItem> | null>(null);
   const [eventsLoading, setEventsLoading] = useState(false);
 
+  useEffect(() => {
+    setEventType(urlEventType);
+    setEventsPage(1);
+    if (urlEventType) {
+      window.requestAnimationFrame(() => {
+        document.getElementById('promo-metric-events')?.scrollIntoView({ behavior: 'smooth', block: 'start' });
+      });
+    }
+  }, [urlEventType]);
+
   const loadTimeline = useCallback(() => {
     setTimelineLoading(true);
     return request<PromoMetricTimelineDto>(buildTimelineQs(promoId, range, granularity))
@@ -164,7 +212,7 @@ export default function PromoCodeMetricsPanel({ promoId }: Props) {
     {
       title: 'ID',
       key: 'ref',
-      render: (_, row) => formatRefId(row),
+      render: (_, row) => <EventRefLinks row={row} />,
     },
     {
       title: 'IP',
@@ -220,7 +268,7 @@ export default function PromoCodeMetricsPanel({ promoId }: Props) {
         notMerge
       />
 
-      <Typography.Title level={5} style={{ marginTop: 24, marginBottom: 12 }}>
+      <Typography.Title id="promo-metric-events" level={5} style={{ marginTop: 24, marginBottom: 12 }}>
         事件日志
       </Typography.Title>
       <Space wrap style={{ marginBottom: 12 }}>
@@ -232,6 +280,10 @@ export default function PromoCodeMetricsPanel({ promoId }: Props) {
           onChange={(v) => {
             setEventType(v);
             setEventsPage(1);
+            const next = new URLSearchParams(searchParams);
+            if (v) next.set('eventType', v);
+            else next.delete('eventType');
+            setSearchParams(next, { replace: true });
           }}
           options={Object.entries(PROMO_METRIC_EVENT_LABELS).map(([value, label]) => ({
             value,

apps/admin-web/src/pages/promo/PromoCodeUsersPage.tsx

@@ -1,5 +1,5 @@
 import { useNavigate, useOutletContext, useParams } from 'react-router-dom';
-import { Button, Space, Table, Tag } from 'antd';
+import { Button, Space, Table, Tag, Tooltip } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
 import {
   USER_SOURCE_TYPE_LABELS,
@@ -66,7 +66,7 @@ export default function PromoCodeUsersPage() {
       width: 160,
       render: (v) => (v ? fmtTime(v) : '—'),
     },
-    { title: '订单数', dataIndex: 'orderCount', width: 80 },
+    { title: <Tooltip title="仅统计已完成订单">订单数</Tooltip>, dataIndex: 'orderCount', width: 80 },
     { title: '注册时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
     {
       title: '操作',

docs/杜康好客-v3-PRD.md

@@ -30,8 +30,9 @@
 | 3.5.8 | 08-24 | HQ 单账号追加/撤销权限；运营改客服修复；城市门店服务+城市范围 | [`v3.5.8`](./杜康好客-v3.5.8-开发文档.md) |
 | 3.5.9 | 08-25 | 门店累计核销好客权益；HQ 表格去省略号；序号列 + 列设置 + 拖表头改列宽；用户备注 / 手机号不脱敏 | [`v3.5.9`](./杜康好客-v3.5.9-开发文档.md) |
 | 3.5.10 | 08-25 | C 端门店详情去掉分享按钮；同城送提示改承运商 HTML；小程序客服接通企微微信客服 | [`v3.5.10`](./杜康好客-v3.5.10-开发文档.md) |
-| 3.5.11 | 08-26 | 城市三种履约起购；企微通知补提交人/规格物流/核销用户；结算任务失败通知 + 提现通过/四账单 | [`v3.5.11`](./杜康好客-v3.5.11-开发文档.md) |
+| 3.5.11 | 08-26 | 城市三种履约起购；企微通知补提交人/规格物流/核销用户（明文手机+备注）；结算任务失败通知 + 提现通过/四账单（城市合伙人、笔数、累计金额） | [`v3.5.11`](./杜康好客-v3.5.11-开发文档.md) |
 | 3.5.12 | 08-26 | 发布会订单大屏循环 BGM；HQ 日志/订单状态流转/用户行为时间线展示中文；修复删除门店分类被默认树回种；HQ 侧栏顺序（业务前 11 项，系统设置置底） | [`v3.5.12`](./杜康好客-v3.5.12-开发文档.md) |
+| 3.5.14 | 08-26 | 修复 C 端提交订单/支付成功日志误标 H5；线上 `order_submit`/`pay_success` 回填为小程序 | [`v3.5.14`](./杜康好客-v3.5.14-开发文档.md) |
 
 ---
 
@@ -111,6 +112,7 @@
 - 门店/合伙人/酒厂/物流账单列表、详情、导出展示收款账户（户名、账号、开户行）
 - 确认打款时可填写打款凭证号（`paymentRef`），已打款后在详情与导出中展示
 - 门店账单统一列表：T+1 终态「已打款」、手动提现终态「已结算」（均为 `PAID`，文案区分业务类型）
+- 门店 T+1「出账日」= 出账当天（核销窗口「昨日 00:00–今日 00:00」中的今天）
 - 核销详情展示核销门店主账户收款信息
 
 ### 3.4~3.8 Wave 能力

docs/杜康好客-v3-埋点规范.md

@@ -9,6 +9,7 @@
 2. 携带 `sessionId`（`dukang_session_id`）
 3. `extraJson` 无密码/令牌；手机号脱敏
 4. eventName 先登记 taxonomy 再 emit
+5. C 端后端埋点 `clientApp` 取 JWT / `X-Client-App`（`USER_MINI` 或 `USER_H5`），禁止写死 H5。`order_submit` / `pay_success` 见 v3.5.14。
 
 ## API
 

docs/杜康好客-v3-现状对照.md

@@ -67,11 +67,13 @@
 | 3.5.10 | [`门店详情去分享按钮 + 同城提示改承运商 HTML + 小程序客服接企微`](./杜康好客-v3.5.10-开发文档.md) | 🔶 开发完成 |
 | 3.5.11 | [`城市履约起购 + 企微通知字段与结算通知`](./杜康好客-v3.5.11-开发文档.md) | 🔶 开发完成 |
 | 3.5.12 | [`订单大屏 BGM + HQ 中文展示 + 修复删除门店分类 + HQ 侧栏顺序`](./杜康好客-v3.5.12-开发文档.md) | 🔶 开发完成 |
+| 3.5.14 | [`提交订单/支付成功日志端回填 USER_MINI`](./杜康好客-v3.5.14-开发文档.md) | 🔶 开发完成 |
 
 | 日期 | 说明 |
 |------|------|
+| 2026-08-26 | v3.5.14：`order_submit`/`pay_success` 埋点改用真实 `clientApp`；线上这两类 `USER_H5` 回填为 `USER_MINI` |
 | 2026-08-26 | v3.5.12：订单大屏循环 BGM；HQ 日志/订单状态流转/用户行为时间线英文码改中文；修复删除门店分类后被 `ensureDefaults` 回种；HQ 侧栏按业务前 11 项重排、系统设置置底 |
-| 2026-08-26 | v3.5.11：城市三种履约起购；企微补提交人/订单规格物流收货/核销用户；`alert.settlement` 改名「结算任务失败通知」归入系统监控；补提现通过与四账单 |
+| 2026-08-26 | v3.5.11：城市三种履约起购；企微补提交人/订单规格物流收货/核销用户（昵称+明文手机+HQ备注）；`alert.settlement` 改名「结算任务失败通知」归入系统监控；补提现通过与四账单（城市/合伙人、笔数、累计金额、收款人账号开户行） |
 | 2026-08-25 | v3.5.10：门店详情去掉分享按钮；同城送提示改承运商 HTML（`GET /catalog/local-deliveries`）；小程序客服接通企微（需填 CorpID） |
 | 2026-08-25 | v3.5.9：门店列表累计核销好客权益；HQ 表格去省略号；主列表序号 + 列设置/列宽存 HQ 账号；用户列表备注（不改昵称）、手机号不脱敏；订单列表状态可多选 |
 | 2026-08-24 | v3.5.8：HQ 单账号追加/撤销权限；运营改客服；城市门店服务与城市范围；分类删除权限与概览按权限/城市裁剪 |

docs/杜康好客-v3.5.11-开发文档.md

@@ -13,7 +13,7 @@
 | 2 | 现场提货 | 体验 | 默认数量对齐起购；文案用销售单位 |
 | 3 | 承运商 | 文案 | 「起送瓶数」标明不影响用户起购 |
 | 4 | 企微提交人 | 优化 | 门店新建/信息变更/套餐待审显示提交人名称 |
-| 5 | 成交播报 | 优化 | 支付成功补规格/物流/收货；核销成功补用户 |
+| 5 | 成交播报 | 优化 | 支付成功补规格/物流/收货；支付与核销补用户昵称、明文手机、HQ 备注 |
 | 6 | 结算通知 | 需求 | `alert.settlement` 改名为「结算任务失败通知」并归入系统监控；提现通过 + 财务四账单（含收款账户） |
 
 **不做**：起购迁到承运商；多城按地址匹配起购（仍读当前 ACTIVE 城市）；HQ 直改已营业门店不发待审通知。
@@ -63,11 +63,12 @@
 - 商品：`{名称} {规格} {瓶\|箱}×{数量}`
 - 物流：现场提货 / 同城 / 跨城
 - 收货：提货=姓名+手机；同城/跨城=姓名+手机+详细地址
+- 用户：昵称、手机号（明文）、HQ 备注 `hq_remark`（空则 —）
 - 测试单不推
 
 ### 4.3 核销成功 `redeem.success`
 
-补 `userName`、`userPhone`（脱敏，与支付播报一致）。
+补 `userName`、`userPhone`（明文）、`userRemark`（HQ 用户备注，空则 —）。
 
 ---
 
@@ -84,7 +85,7 @@
 | `finance.winery_bill` | 酒厂日账单未 skip | 系统配置酒厂账户 |
 | `finance.logistics_bill` | 物流月账成功且未 skip | 承运商卡 |
 
-账单一次摘要（多店多行，最多 15 行）；缺卡写「未登记收款账户」；内部群账号不脱敏。`created=0` / `skipped` 不推。
+账单一次摘要：抬头含账期 / 账单笔数 / 累计金额；每笔分块写城市、门店或承运商、合伙人（公司-姓名）、核销/订单笔数、账单金额、收款人 / 账户 / 开户行。缺卡写「未登记」。内部群账号不脱敏。`created=0` / `skipped` 不推。正文过长时截断并提示到 HQ 查看。
 
 启动 upsert「结算通知群」（占位 webhook + 禁用）。已有「运营告警」若勾了 `alert.settlement`，会收到任务失败/超时，**不会**自动勾上 5 个新业务事件。
 
@@ -95,8 +96,8 @@
 - [ ] 城市三字段起购；提货默认数量对齐；承运商起送不影响下单
 - [ ] 合伙人新建/信息变更/套餐：企微可见「企业 · 姓名」
 - [ ] HQ 新建门店：企微可见 HQ 名称
-- [ ] 支付成功：规格单位、物流方式、收货信息按提货/配送分支正确
-- [ ] 核销成功：有用户昵称与脱敏手机
+- [ ] 支付成功：规格单位、物流方式、收货信息按提货/配送分支正确；用户昵称、明文手机、备注
+- [ ] 核销成功：有用户昵称、明文手机、备注
 - [ ] HQ 推送条件展示「结算任务失败通知」，在系统监控组
 - [ ] 账单任务失败 / 提现超时出现在勾了「结算任务失败通知」的群
-- [ ] 提现通过、四类账单生成含收款账户；无账单不刷屏
+- [ ] 提现通过、四类账单生成含城市/合伙人、笔数、累计金额、收款人/账号/开户行；无账单不刷屏

docs/杜康好客-v3.5.14-开发文档.md

@@ -0,0 +1,95 @@
+# 杜康好客 · v3.5.14 修复文档
+
+> **2026-08-26** · API / 生产数据  
+> **主题**：C 端「提交订单 / 支付成功」用户日志 `client_app` 误标为 H5，改为真实端（小程序）
+
+---
+
+## 1. 版本目标
+
+1. 修复后端埋点：`order_submit`、`pay_success` 不再写死 `USER_H5`。
+2. 回填线上 `log_user_analytics`：这两类事件里所有 `USER_H5` 改为 `USER_MINI`。
+
+**不做**：核销埋点（`benefit_redeem_*`）；未登录 `POST /analytics/events` 的 H5 回退；H5 预览（`TARO_ENV=h5`）仍报 `USER_H5`。
+
+---
+
+## 2. 根因
+
+`TradeService.createOrder` / `payOrder`（Mock 支付成功）/ `handlePaySuccess`（微信支付回调）调用 `analyticsService.trackOneSafe` 时把 `clientApp` 写死为 `'USER_H5'`。
+
+当前生产 C 端是 `apps/mini-user` 小程序，请求头为 `X-Client-App: USER_MINI`（写入 JWT）。同链路的 `pay_fail` 已使用 JWT 的 `clientApp`，故 HQ「用户日志」里提交订单显示「C 端 H5」，支付失败却可能显示「C 端小程序」。
+
+---
+
+## 3. 代码规则
+
+| 写入点 | 事件 | `clientApp` |
+|--------|------|-------------|
+| `POST /trade/orders` → `createOrder` | `order_submit` | JWT `user.clientApp`（缺省 `USER_H5`） |
+| `POST /trade/orders/:id/pay` Mock 成功 | `pay_success` | 入参 `clientApp`（缺省 `USER_H5`） |
+| 微信支付回调 `handlePaySuccess` | `pay_success` | 该订单已有 `order_submit` / `pay_fail`；没有则默认 `USER_MINI` |
+
+小程序原生：`USER_MINI`。`mini-user` H5 预览：仍为 `USER_H5`（公众号 JSAPI，见 `apps/mini-user/src/lib/api.ts`）。
+
+---
+
+## 4. 线上数据回填
+
+表：`log_user_analytics`  
+范围：`event_name IN ('order_submit', 'pay_success') AND client_app = 'USER_H5'`  
+动作：`client_app` → `USER_MINI`
+
+```sql
+SELECT event_name, client_app, COUNT(*) AS cnt
+FROM log_user_analytics
+WHERE event_name IN ('order_submit', 'pay_success')
+GROUP BY event_name, client_app;
+
+UPDATE log_user_analytics
+SET client_app = 'USER_MINI'
+WHERE event_name IN ('order_submit', 'pay_success')
+  AND client_app = 'USER_H5';
+```
+
+回填结果（生产，2026-08-26）：
+
+| 事件 | 回填前 USER_H5 | 回填后 USER_MINI |
+|------|----------------|------------------|
+| `order_submit` | 55 | 55 |
+| `pay_success` | 28 | 28 |
+
+共更新 **83** 行。回填后这两类事件已无 `USER_H5`。
+
+不改其它事件名，不改 `common_event`。
+
+---
+
+## 5. 关键路径
+
+| 域 | 路径 |
+|----|------|
+| 建单 / 支付埋点 | `server/dukang-api/src/modules/trade/trade.service.ts` |
+| 建单入参 | `server/dukang-api/src/modules/trade/trade.controller.ts` |
+| HQ 展示 | `order_submit` → 提交订单；`USER_MINI` → C 端小程序 |
+
+无 Prisma 迁移。
+
+---
+
+## 6. 发版步骤
+
+| 步骤 | 动作 |
+|------|------|
+| 1 | 生产已执行上述 `UPDATE`（历史行） |
+| 2 | 发 `dukang-api`（新单按 JWT 写端）；`--skip-db` |
+
+---
+
+## 7. 验收清单
+
+- [x] 历史 `order_submit` / `pay_success` 在 HQ 不再显示「C 端 H5」（已回填 83 行）
+- [ ] 小程序提交订单后，HQ 用户日志「提交订单」端为「C 端小程序」（需发 `dukang-api`）
+- [ ] 小程序支付成功后，「支付成功」端为「C 端小程序」（需发 `dukang-api`）
+- [ ] `mini-user` H5 预览下单仍为「C 端 H5」
+- [ ] 浏览类埋点（`home_view` 等）端字段不变

docs/杜康好客-v3编码手册.md

@@ -51,6 +51,8 @@ C 端购酒核销 · 门店扫码核销+打款 · 合伙人拓店履约 · WebAd
 
 **订单大屏（v3.5.12）**：循环 BGM；右上角「播放 BGM」开关（需点击才出声）；成交撒花时压低背景音。HQ 日志 / 订单状态流转 / 用户行为时间线展示中文（存储码不变）。删除门店分类后列表不再自动补种默认树（「同步默认分类」才补）。HQ 侧栏：概览→用户→商品→订单→开城→门店→财务→好客权益→配送单→工单→发票，其余运营/工具项随后，**系统设置最后**。
 
+**用户日志端（v3.5.14）**：`order_submit` / `pay_success` 的 `clientApp` 取 JWT（小程序 `USER_MINI`）；微信支付回调沿用该订单已有埋点，缺省小程序。禁止再写死 `USER_H5`。
+
 ## 5. 验收用例（必过）
 
 **主链路 15 项**：登录、4 SKU、起购、支付+权益、双通道核销、payout、关店不可见、拓店审核、配送完成、退款、T+1/T+30…  

packages/shared-types/src/dev-plan.ts

@@ -94,6 +94,10 @@ export interface DevPlanTaskDto {
 
   attachmentUrls?: string[] | null;
 
+  versions?: Array<{ id: string; versionNo: string }>;
+
+  versionIds?: string[];
+
 }
 
 
@@ -166,6 +170,8 @@ export interface UpdateDevPlanTaskInput {
 
   attachmentUrls?: string[];
 
+  versionIds?: string[];
+
 }
 
 

packages/shared-types/src/ops.ts

@@ -9,6 +9,8 @@ export interface AdminOrdersListQuery extends AdminListQuery {
   status?: string | string[];
   orderType?: string;
   userId?: string;
+  userKeyword?: string;
+  productKeyword?: string;
   cityId?: string;
   receiverPhone?: string;
   fulfillmentHold?: string | boolean;
@@ -18,6 +20,16 @@ export interface AdminOrdersListQuery extends AdminListQuery {
   deliveryType?: string;
 }
 
+export interface AdminUsersListQuery extends AdminListQuery {
+  phone?: string;
+  userNo?: string;
+  userId?: string;
+  deviceKey?: string;
+  phoneVerified?: string;
+  status?: number;
+  excludeTest?: boolean;
+}
+
 export interface UpdateAdminUserRequest {
   hqRemark: string;
 }

packages/shared-types/src/promo.ts

@@ -35,6 +35,7 @@ export type PromoCodeItem = {
   qrcodeId: string;
   status: PromoCodeStatus;
   scanCount: number;
+  /** 已完成订单数（status=COMPLETED） */
   orderCount: number;
   landingUrl: string;
   qrcodeUrl?: string | null;
@@ -47,6 +48,7 @@ export type PromoCodeItem = {
 export type PromoCodeStats = {
   /** 扫码进入次数 */
   scanCount: number;
+  /** 已完成订单数（status=COMPLETED） */
   orderCount: number;
   conversionRate: number;
   /** 归因用户数（user_promo_attribution） */
@@ -66,6 +68,7 @@ export type PromoCodeAttributedUser = {
   sourceType: string;
   sourceRefId: string | null;
   firstTouchAt: string | null;
+  /** 该用户已完成订单数 */
   orderCount: number;
   createdAt: string;
 };
@@ -98,7 +101,9 @@ export type PromoMetricEventItem = {
   id: string;
   eventType: PromoMetricEventType;
   userId: string | null;
+  userNo?: string | null;
   orderId: string | null;
+  orderNo?: string | null;
   sessionId: string | null;
   clientIp: string | null;
   ipProvince: string | null;

packages/shared-types/src/settlement.ts

@@ -146,6 +146,7 @@ export interface StoreBillDto {
   id: string;
   billNo: string;
   storeId: string;
+  /** 出账日 YYYY-MM-DD（T+1 窗口「昨日 00:00–今日 00:00」中的今天） */
   billDate: string;
   redeemCount: number;
   redeemAmount: number;

packages/shared-types/src/wecom-message-push.test.ts

@@ -4,6 +4,7 @@ import {
   WECOM_PUSH_CONDITION_LABELS,
   WECOM_PUSH_DEFAULT_SETTLEMENT_CONDITIONS,
   WECOM_SETTLEMENT_PUSH_NAME,
+  WECOM_TEMPLATE_PLACEHOLDERS,
   parseWecomPushConditions,
 } from './wecom-message-push';
 
@@ -33,4 +34,22 @@ describe('wecom-message-push', () => {
       'finance.store_bill',
     ]);
   });
+
+  it('支付与核销模板含昵称、明文手机、备注占位符', () => {
+    expect(WECOM_TEMPLATE_PLACEHOLDERS['order.paid']).toEqual(
+      expect.arrayContaining(['userName', 'userPhone', 'userRemark']),
+    );
+    expect(WECOM_TEMPLATE_PLACEHOLDERS['redeem.success']).toEqual(
+      expect.arrayContaining(['userName', 'userPhone', 'userRemark']),
+    );
+  });
+
+  it('结算账单模板含累计金额与明细摘要', () => {
+    expect(WECOM_TEMPLATE_PLACEHOLDERS['finance.store_bill']).toEqual(
+      expect.arrayContaining(['billCount', 'totalAmount', 'billSummary']),
+    );
+    expect(WECOM_TEMPLATE_PLACEHOLDERS['store.withdraw_approved']).toEqual(
+      expect.arrayContaining(['cityName', 'partnerLabel', 'payee', 'accountNo', 'bankBranch']),
+    );
+  });
 });

packages/shared-types/src/wecom-message-push.ts

@@ -197,6 +197,9 @@ export const WECOM_TEMPLATE_PLACEHOLDERS: Record<WecomTemplateEventKey, string[]
     'skuSummary',
     'deliveryLabel',
     'receiverInfo',
+    'userName',
+    'userPhone',
+    'userRemark',
     'phoneMasked',
     'time',
     'handleUrl',
@@ -209,6 +212,7 @@ export const WECOM_TEMPLATE_PLACEHOLDERS: Record<WecomTemplateEventKey, string[]
     'channel',
     'userName',
     'userPhone',
+    'userRemark',
     'time',
     'handleUrl',
     'handleLabel',
@@ -255,9 +259,14 @@ export const WECOM_TEMPLATE_PLACEHOLDERS: Record<WecomTemplateEventKey, string[]
     'storeId',
   ],
   'store.withdraw_approved': [
+    'cityName',
     'storeName',
+    'partnerLabel',
     'withdrawNo',
     'amount',
+    'payee',
+    'accountNo',
+    'bankBranch',
     'bankAccount',
     'time',
     'handleUrl',
@@ -277,6 +286,7 @@ export const WECOM_TEMPLATE_PLACEHOLDERS: Record<WecomTemplateEventKey, string[]
   'finance.store_bill': [
     'period',
     'billCount',
+    'totalAmount',
     'billSummary',
     'time',
     'handleUrl',
@@ -285,6 +295,7 @@ export const WECOM_TEMPLATE_PLACEHOLDERS: Record<WecomTemplateEventKey, string[]
   'finance.partner_bill': [
     'period',
     'billCount',
+    'totalAmount',
     'billSummary',
     'time',
     'handleUrl',
@@ -292,8 +303,17 @@ export const WECOM_TEMPLATE_PLACEHOLDERS: Record<WecomTemplateEventKey, string[]
   ],
   'finance.winery_bill': [
     'period',
-    'amount',
+    'billCount',
+    'totalAmount',
+    'cityNames',
+    'partnerNames',
     'orderCount',
+    'orderAmount',
+    'rate',
+    'amount',
+    'payee',
+    'accountNo',
+    'bankBranch',
     'bankAccount',
     'time',
     'handleUrl',
@@ -302,6 +322,7 @@ export const WECOM_TEMPLATE_PLACEHOLDERS: Record<WecomTemplateEventKey, string[]
   'finance.logistics_bill': [
     'period',
     'billCount',
+    'totalAmount',
     'billSummary',
     'time',
     'handleUrl',

server/dukang-api/prisma/seed-finance-mock.ts

@@ -91,12 +91,12 @@ async function main() {
   await prisma.storeBill.deleteMany({ where: { billNo: { startsWith: 'SBMOCK' } } });
   await prisma.partnerBill.deleteMany({ where: { billNo: { startsWith: 'PBMOCK' } } });
 
-  // ─── 1. 门店账单（昨日未打款 + 前日已打款）───
+  // ─── 1. 门店账单（今日出账未打款 + 昨日出账已打款）───
   const storeBillUnpaid = await prisma.storeBill.create({
     data: {
       billNo: billNo('SB', `${yesterday.getTime()}U`),
       storeId: store.id,
-      billDate: yesterday,
+      billDate: today,
       redeemCount: 5,
       redeemAmount: 1500,
       settlementRate: 0.6,
@@ -108,7 +108,7 @@ async function main() {
     data: {
       billNo: billNo('SB', `${dayBefore.getTime()}P`),
       storeId: store.id,
-      billDate: dayBefore,
+      billDate: yesterday,
       redeemCount: 3,
       redeemAmount: 800,
       settlementRate: 0.6,

server/dukang-api/src/integrations/wechat/wechat-trade-manage.service.ts

@@ -100,6 +100,27 @@ export class WechatTradeManageService {
           remark,
         }),
       });
+      if (order.promoCodeId) {
+        const already = await tx.logPromoEvent.findFirst({
+          where: { orderId: order.id, eventType: 'ORDER' },
+          select: { id: true },
+        });
+        if (!already) {
+          await tx.commonPromoCode.update({
+            where: { id: order.promoCodeId },
+            data: { orderCount: { increment: 1 } },
+          });
+          await tx.logPromoEvent.create({
+            data: {
+              promoCodeId: order.promoCodeId,
+              eventType: 'ORDER',
+              userId: order.userId,
+              orderId: order.id,
+              clientIp: order.clientIp,
+            },
+          });
+        }
+      }
     });
 
     await this.logEvent(evt, order.id, 'SUCCESS', methodLabel);

server/dukang-api/src/integrations/wecom/wecom-message-push.service.ts

@@ -208,8 +208,8 @@ export class WecomMessagePushService implements OnModuleInit {
         this.logger.log(`seeded wecom push template: ${def.eventKey}`);
         continue;
       }
-      const legacy = WECOM_PUSH_TEMPLATE_LEGACY_BODIES[def.eventKey];
-      if (legacy && existing.body === legacy) {
+      const legacyBodies = WECOM_PUSH_TEMPLATE_LEGACY_BODIES[def.eventKey] ?? [];
+      if (legacyBodies.includes(existing.body)) {
         await this.prisma.wecomPushTemplate.update({
           where: { eventKey: def.eventKey },
           data: {
@@ -473,7 +473,10 @@ export class WecomMessagePushService implements OnModuleInit {
           skuSummary: '杜康原浆 52度 瓶×2',
           deliveryLabel: '同城',
           receiverInfo: '张三 13800008000 河南省郑州市金水区示例路1号',
-          phoneMasked: '138****8000',
+          userName: '好客用户',
+          userPhone: '13800008000',
+          userRemark: '大客户',
+          phoneMasked: '13800008000',
         },
         handlePath: '/orders?orderNo=DK202608200001',
       },
@@ -484,7 +487,8 @@ export class WecomMessagePushService implements OnModuleInit {
           storeName: '示例门店',
           channel: '扫码',
           userName: '好客用户',
-          userPhone: '138****8000',
+          userPhone: '13800008000',
+          userRemark: '大客户',
         },
         handlePath: '/redeem-records?redeemNo=RD202608200001',
       },
@@ -531,9 +535,14 @@ export class WecomMessagePushService implements OnModuleInit {
       },
       'store.withdraw_approved': {
         vars: {
+          cityName: '郑州',
           storeName: '示例门店',
+          partnerLabel: '郑州某某商贸-张三',
           withdrawNo: 'SW202608200001',
           amount: '500.00',
+          payee: '张三',
+          accountNo: '6222000011112222',
+          bankBranch: '郑州支行',
           bankAccount: '张三 / 郑州支行 / 6222000011112222',
           storeId: '1',
         },
@@ -553,7 +562,19 @@ export class WecomMessagePushService implements OnModuleInit {
         vars: {
           period: '2026-08-25',
           billCount: '2',
-          billSummary: '示例门店 ¥300.00 张三 / 郑州支行 / 6222000011112222',
+          totalAmount: '500.00',
+          billSummary: [
+            '城市：郑州',
+            '门店：示例门店',
+            '合伙人：郑州某某商贸-张三',
+            '核销笔数：12',
+            '核销金额：¥500.00',
+            '结算比例：60%',
+            '账单：¥300.00',
+            '收款人：张三',
+            '收款账户：6222000011112222',
+            '收款开户行：郑州支行',
+          ].join('\n'),
         },
         handlePath: '/finance/store-bills?kind=T1_BILL',
       },
@@ -561,15 +582,36 @@ export class WecomMessagePushService implements OnModuleInit {
         vars: {
           period: '2026-07',
           billCount: '1',
-          billSummary: '郑州某某商贸 ¥120.00 张三 / 郑州支行 / 6222000011112222',
+          totalAmount: '120.00',
+          billSummary: [
+            '城市：郑州',
+            '合伙人：郑州某某商贸-张三',
+            '订单笔数：8',
+            '核销笔数：12',
+            '订单佣金：¥100.00',
+            '核销佣金：¥20.00',
+            '账单：¥120.00',
+            '收款人：张三',
+            '收款账户：6222000011112222',
+            '收款开户行：郑州支行',
+          ].join('\n'),
         },
         handlePath: '/finance/partner-bills',
       },
       'finance.winery_bill': {
         vars: {
           period: '2026-08-23',
+          billCount: '1',
+          totalAmount: '1990.00',
+          cityNames: '郑州、洛阳',
+          partnerNames: '郑州某某商贸-张三',
           amount: '1990.00',
           orderCount: '8',
+          orderAmount: '6633.33',
+          rate: '30%',
+          payee: '杜康酒厂',
+          accountNo: '6222000099998888',
+          bankBranch: '洛阳支行',
           bankAccount: '杜康酒厂 / 洛阳支行 / 6222000099998888',
         },
         handlePath: '/finance/winery-bills',
@@ -578,7 +620,19 @@ export class WecomMessagePushService implements OnModuleInit {
         vars: {
           period: '2026-07',
           billCount: '1',
-          billSummary: '小飞侠 ¥86.00 承运商 / 郑州支行 / 6222000033334444',
+          totalAmount: '86.00',
+          billSummary: [
+            '城市：郑州',
+            '合伙人：郑州某某商贸-张三',
+            '承运商：小飞侠',
+            '结算方式：充值扣款',
+            '发货笔数：10',
+            '瓶数：60',
+            '账单：¥86.00',
+            '收款人：承运商',
+            '收款账户：6222000033334444',
+            '收款开户行：郑州支行',
+          ].join('\n'),
         },
         handlePath: '/finance/logistics-bills',
       },

server/dukang-api/src/integrations/wecom/wecom-push-template.defaults.ts

@@ -20,7 +20,8 @@ export const WECOM_PUSH_TEMPLATE_DEFAULTS: WecomTemplateDefault[] = [
       '商品：{{skuSummary}}',
       '物流：{{deliveryLabel}}',
       '收货：{{receiverInfo}}',
-      '用户：{{phoneMasked}}',
+      '用户：{{userName}} {{userPhone}}',
+      '备注：{{userRemark}}',
       '时间：{{time}}',
       '[{{handleLabel}}]({{handleUrl}})',
     ].join('\n'),
@@ -36,6 +37,7 @@ export const WECOM_PUSH_TEMPLATE_DEFAULTS: WecomTemplateDefault[] = [
       '门店：{{storeName}}',
       '渠道：{{channel}}',
       '用户：{{userName}} {{userPhone}}',
+      '备注：{{userRemark}}',
       '时间：{{time}}',
       '[{{handleLabel}}]({{handleUrl}})',
     ].join('\n'),
@@ -102,10 +104,14 @@ export const WECOM_PUSH_TEMPLATE_DEFAULTS: WecomTemplateDefault[] = [
     title: '门店提现已通过',
     body: [
       '**门店提现已通过**',
+      '城市：{{cityName}}',
       '门店：{{storeName}}',
+      '合伙人：{{partnerLabel}}',
       '提现单号：{{withdrawNo}}',
-      '金额：¥{{amount}}',
-      '收款账户：{{bankAccount}}',
+      '账单：¥{{amount}}',
+      '收款人：{{payee}}',
+      '收款账户：{{accountNo}}',
+      '收款开户行：{{bankBranch}}',
       '时间：{{time}}',
       '[{{handleLabel}}]({{handleUrl}})',
     ].join('\n'),
@@ -132,9 +138,12 @@ export const WECOM_PUSH_TEMPLATE_DEFAULTS: WecomTemplateDefault[] = [
     body: [
       '**门店日账单已生成**',
       '账期：{{period}}',
-      '笔数：{{billCount}}',
-      '{{billSummary}}',
+      '账单笔数：{{billCount}}',
+      '累计金额：¥{{totalAmount}}',
       '时间：{{time}}',
+      '',
+      '{{billSummary}}',
+      '',
       '[{{handleLabel}}]({{handleUrl}})',
     ].join('\n'),
     handleLabel: '去处理',
@@ -145,9 +154,12 @@ export const WECOM_PUSH_TEMPLATE_DEFAULTS: WecomTemplateDefault[] = [
     body: [
       '**合伙人月账单已生成**',
       '账期：{{period}}',
-      '笔数：{{billCount}}',
-      '{{billSummary}}',
+      '账单笔数：{{billCount}}',
+      '累计金额：¥{{totalAmount}}',
       '时间：{{time}}',
+      '',
+      '{{billSummary}}',
+      '',
       '[{{handleLabel}}]({{handleUrl}})',
     ].join('\n'),
     handleLabel: '去处理',
@@ -158,10 +170,20 @@ export const WECOM_PUSH_TEMPLATE_DEFAULTS: WecomTemplateDefault[] = [
     body: [
       '**酒厂日账单已生成**',
       '账期：{{period}}',
-      '订单数：{{orderCount}}',
-      '金额：¥{{amount}}',
-      '收款账户：{{bankAccount}}',
+      '账单笔数：{{billCount}}',
+      '累计金额：¥{{totalAmount}}',
       '时间：{{time}}',
+      '',
+      '城市：{{cityNames}}',
+      '合伙人：{{partnerNames}}',
+      '订单笔数：{{orderCount}}',
+      '订单金额：¥{{orderAmount}}',
+      '结算比例：{{rate}}',
+      '账单：¥{{amount}}',
+      '收款人：{{payee}}',
+      '收款账户：{{accountNo}}',
+      '收款开户行：{{bankBranch}}',
+      '',
       '[{{handleLabel}}]({{handleUrl}})',
     ].join('\n'),
     handleLabel: '去处理',
@@ -172,62 +194,149 @@ export const WECOM_PUSH_TEMPLATE_DEFAULTS: WecomTemplateDefault[] = [
     body: [
       '**物流月对账已生成**',
       '账期：{{period}}',
-      '笔数：{{billCount}}',
-      '{{billSummary}}',
+      '账单笔数：{{billCount}}',
+      '累计金额：¥{{totalAmount}}',
       '时间：{{time}}',
+      '',
+      '{{billSummary}}',
+      '',
       '[{{handleLabel}}]({{handleUrl}})',
     ].join('\n'),
     handleLabel: '去处理',
   },
 ];
 
-/** v3.5.3 默认正文；ensureTemplates 仅在库中仍为此文案时升级，不覆盖 HQ 手改 */
-export const WECOM_PUSH_TEMPLATE_LEGACY_BODIES: Partial<Record<WecomTemplateEventKey, string>> = {
+/** 上一版默认正文；ensureTemplates 仅在库中仍为此文案时升级，不覆盖 HQ 手改 */
+export const WECOM_PUSH_TEMPLATE_LEGACY_BODIES: Partial<Record<WecomTemplateEventKey, string[]>> = {
   'order.paid': [
-    '**订单支付成功**',
-    '订单号：{{orderNo}}',
-    '实付：¥{{payAmount}}',
-    '城市：{{cityName}}',
-    '商品：{{skuSummary}}',
-    '用户：{{phoneMasked}}',
-    '时间：{{time}}',
-    '[{{handleLabel}}]({{handleUrl}})',
-  ].join('\n'),
+    [
+      '**订单支付成功**',
+      '订单号：{{orderNo}}',
+      '实付：¥{{payAmount}}',
+      '城市：{{cityName}}',
+      '商品：{{skuSummary}}',
+      '用户：{{phoneMasked}}',
+      '时间：{{time}}',
+      '[{{handleLabel}}]({{handleUrl}})',
+    ].join('\n'),
+    [
+      '**订单支付成功**',
+      '订单号：{{orderNo}}',
+      '实付：¥{{payAmount}}',
+      '城市：{{cityName}}',
+      '商品：{{skuSummary}}',
+      '物流：{{deliveryLabel}}',
+      '收货：{{receiverInfo}}',
+      '用户：{{phoneMasked}}',
+      '时间：{{time}}',
+      '[{{handleLabel}}]({{handleUrl}})',
+    ].join('\n'),
+  ],
   'redeem.success': [
-    '**门店核销成功**',
-    '核销单号：{{redeemNo}}',
-    '金额：¥{{amount}}',
-    '门店：{{storeName}}',
-    '渠道：{{channel}}',
-    '时间：{{time}}',
-    '[{{handleLabel}}]({{handleUrl}})',
-  ].join('\n'),
+    [
+      '**门店核销成功**',
+      '核销单号：{{redeemNo}}',
+      '金额：¥{{amount}}',
+      '门店：{{storeName}}',
+      '渠道：{{channel}}',
+      '时间：{{time}}',
+      '[{{handleLabel}}]({{handleUrl}})',
+    ].join('\n'),
+    [
+      '**门店核销成功**',
+      '核销单号：{{redeemNo}}',
+      '金额：¥{{amount}}',
+      '门店：{{storeName}}',
+      '渠道：{{channel}}',
+      '用户：{{userName}} {{userPhone}}',
+      '时间：{{time}}',
+      '[{{handleLabel}}]({{handleUrl}})',
+    ].join('\n'),
+  ],
   'store.audit_pending': [
-    '**门店审核待处理 · {{action}}**',
-    '门店：{{storeName}}',
-    '城市：{{cityName}}',
-    '合伙人：{{partnerLabel}}',
-    '时间：{{time}}',
-    '[{{handleLabel}}]({{handleUrl}})',
-  ].join('\n'),
+    [
+      '**门店审核待处理 · {{action}}**',
+      '门店：{{storeName}}',
+      '城市：{{cityName}}',
+      '合伙人：{{partnerLabel}}',
+      '时间：{{time}}',
+      '[{{handleLabel}}]({{handleUrl}})',
+    ].join('\n'),
+  ],
   'store.package_audit_pending': [
-    '**套餐变更待审核**',
-    '门店：{{storeName}}',
-    '城市：{{cityName}}',
-    '提交端：{{submitter}}',
-    '套餐条数：{{packageCount}}',
-    '时间：{{time}}',
-    '[{{handleLabel}}]({{handleUrl}})',
-  ].join('\n'),
+    [
+      '**套餐变更待审核**',
+      '门店：{{storeName}}',
+      '城市：{{cityName}}',
+      '提交端：{{submitter}}',
+      '套餐条数：{{packageCount}}',
+      '时间：{{time}}',
+      '[{{handleLabel}}]({{handleUrl}})',
+    ].join('\n'),
+  ],
   'store.info_change_pending': [
-    '**门店信息变更待审**',
-    '门店：{{storeName}}',
-    '城市：{{cityName}}',
-    '提交端：{{submitter}}',
-    '变更字段：{{changedFields}}',
-    '时间：{{time}}',
-    '[{{handleLabel}}]({{handleUrl}})',
-  ].join('\n'),
+    [
+      '**门店信息变更待审**',
+      '门店：{{storeName}}',
+      '城市：{{cityName}}',
+      '提交端：{{submitter}}',
+      '变更字段：{{changedFields}}',
+      '时间：{{time}}',
+      '[{{handleLabel}}]({{handleUrl}})',
+    ].join('\n'),
+  ],
+  'store.withdraw_approved': [
+    [
+      '**门店提现已通过**',
+      '门店：{{storeName}}',
+      '提现单号：{{withdrawNo}}',
+      '金额：¥{{amount}}',
+      '收款账户：{{bankAccount}}',
+      '时间：{{time}}',
+      '[{{handleLabel}}]({{handleUrl}})',
+    ].join('\n'),
+  ],
+  'finance.store_bill': [
+    [
+      '**门店日账单已生成**',
+      '账期：{{period}}',
+      '笔数：{{billCount}}',
+      '{{billSummary}}',
+      '时间：{{time}}',
+      '[{{handleLabel}}]({{handleUrl}})',
+    ].join('\n'),
+  ],
+  'finance.partner_bill': [
+    [
+      '**合伙人月账单已生成**',
+      '账期：{{period}}',
+      '笔数：{{billCount}}',
+      '{{billSummary}}',
+      '时间：{{time}}',
+      '[{{handleLabel}}]({{handleUrl}})',
+    ].join('\n'),
+  ],
+  'finance.winery_bill': [
+    [
+      '**酒厂日账单已生成**',
+      '账期：{{period}}',
+      '订单数：{{orderCount}}',
+      '金额：¥{{amount}}',
+      '收款账户：{{bankAccount}}',
+      '时间：{{time}}',
+      '[{{handleLabel}}]({{handleUrl}})',
+    ].join('\n'),
+  ],
+  'finance.logistics_bill': [
+    [
+      '**物流月对账已生成**',
+      '账期：{{period}}',
+      '笔数：{{billCount}}',
+      '{{billSummary}}',
+      '时间：{{time}}',
+      '[{{handleLabel}}]({{handleUrl}})',
+    ].join('\n'),
+  ],
 };
 
 export function getDefaultTemplate(eventKey: string): WecomTemplateDefault | undefined {

server/dukang-api/src/jobs/settlement.scheduler.ts

@@ -5,7 +5,7 @@ import { AlertService } from '../common/alert/alert.service';
 
 /**
  * 财务对账单定时任务（Asia/Shanghai）
- * - 每日 08:00：酒厂日账单（T+3：3 天前已完成订单）+ 门店日账单（昨日核销）
+ * - 每日 08:00：酒厂日账单（T+3：3 天前已完成订单）+ 门店日账单（昨日核销，出账日=今天）
  * - 每月 1 日 08:00：合伙人上一自然月账单 + 物流承运商上一自然月对账
  * - 工作日 18:05：门店提现 T+0 审完预警（FIN-003）
  */

server/dukang-api/src/modules/dev-plan/dev-plan.service.ts

@@ -156,10 +156,16 @@ export class DevPlanService {
 
     },
 
-    extras?: { creatorName?: string | null; supportTicketNo?: string | null },
+    extras?: {
+      creatorName?: string | null;
+      supportTicketNo?: string | null;
+      versions?: Array<{ id: string; versionNo: string }>;
+    },
 
   ): DevPlanTaskDto {
 
+    const versions = extras?.versions ?? [];
+
     return {
 
       id: String(row.id),
@@ -188,6 +194,10 @@ export class DevPlanService {
 
       attachmentUrls: parseAttachmentUrls(row.attachmentUrls),
 
+      versions,
+
+      versionIds: versions.map((v) => v.id),
+
     };
 
   }
@@ -306,7 +316,7 @@ export class DevPlanService {
 
     const ticketIds = rows.map((r) => r.supportTicketId).filter((id): id is bigint => id != null);
 
-    const [names, tickets] = await Promise.all([
+    const [names, tickets, versionMap] = await Promise.all([
 
       this.loadHqNames(creatorIds),
 
@@ -322,6 +332,8 @@ export class DevPlanService {
 
         : Promise.resolve([]),
 
+      this.loadTaskVersionMap(rows.map((r) => r.id)),
+
     ]);
 
     const ticketMap = new Map<string, string>(
@@ -340,6 +352,8 @@ export class DevPlanService {
 
         supportTicketNo: r.supportTicketId != null ? ticketMap.get(String(r.supportTicketId)) ?? null : null,
 
+        versions: versionMap.get(String(r.id)) ?? [],
+
       }),
 
     );
@@ -374,12 +388,16 @@ export class DevPlanService {
 
     }
 
+    const versionMap = await this.loadTaskVersionMap([row.id]);
+
     return this.mapTask(row, {
 
       creatorName: names.get(String(row.creatorHqAccountId)) ?? null,
 
       supportTicketNo,
 
+      versions: versionMap.get(String(row.id)) ?? [],
+
     });
 
   }
@@ -508,6 +526,10 @@ export class DevPlanService {
 
     await this.prisma.devPlanTask.update({ where: { id }, data });
 
+    if (dto.versionIds !== undefined) {
+      await this.replaceTaskVersions(id, dto.versionIds);
+    }
+
     return this.getTask(id);
 
   }
@@ -606,6 +628,41 @@ export class DevPlanService {
 
 
 
+  private async loadTaskVersionMap(
+    taskIds: bigint[],
+  ): Promise<Map<string, Array<{ id: string; versionNo: string }>>> {
+    const map = new Map<string, Array<{ id: string; versionNo: string }>>();
+    if (!taskIds.length) return map;
+    const links = await this.prisma.devPlanVersionTask.findMany({
+      where: { taskId: { in: taskIds } },
+      include: { version: { select: { id: true, versionNo: true } } },
+      orderBy: { versionId: 'asc' },
+    });
+    for (const link of links) {
+      const key = String(link.taskId);
+      const list = map.get(key) ?? [];
+      list.push({ id: String(link.version.id), versionNo: link.version.versionNo });
+      map.set(key, list);
+    }
+    return map;
+  }
+
+  private async replaceTaskVersions(taskId: bigint, versionIds: string[]) {
+    const unique = [...new Set(versionIds.map((id) => id.trim()).filter(Boolean))];
+    const ids = unique.map(BigInt);
+    if (ids.length) {
+      const versions = await this.prisma.devPlanVersion.findMany({
+        where: { id: { in: ids } },
+        select: { id: true },
+      });
+      if (versions.length !== ids.length) throw new BadRequestException('部分版本不存在');
+    }
+    await this.prisma.devPlanVersionTask.deleteMany({ where: { taskId } });
+    for (const versionId of ids) {
+      await this.appendVersionTasks(versionId, [String(taskId)]);
+    }
+  }
+
   private async loadVersionTasks(versionId: bigint): Promise<{ tasks: DevPlanTaskDto[]; taskIds: string[] }> {
 
     const links = await this.prisma.devPlanVersionTask.findMany({

server/dukang-api/src/modules/dev-plan/dto/dev-plan.dto.ts

@@ -62,6 +62,11 @@ export class UpdateDevPlanTaskDto {
   @IsArray()
   @IsString({ each: true })
   attachmentUrls?: string[];
+
+  @IsOptional()
+  @IsArray()
+  @IsString({ each: true })
+  versionIds?: string[];
 }
 
 export class CreateDevPlanVersionDto {

server/dukang-api/src/modules/ops/admin-orders.service.ts

@@ -30,6 +30,8 @@ type OrderFilterInput = Pick<
   | 'status'
   | 'orderType'
   | 'userId'
+  | 'userKeyword'
+  | 'productKeyword'
   | 'cityId'
   | 'receiverPhone'
   | 'fulfillmentHold'
@@ -37,6 +39,7 @@ type OrderFilterInput = Pick<
   | 'createdTo'
   | 'excludeTest'
   | 'deliveryType'
+  | 'promoCodeId'
 >;
 
 @Injectable()
@@ -94,7 +97,7 @@ export class AdminOrdersService {
         skip: (page - 1) * pageSize,
         take: pageSize,
         include: {
-          user: { select: { id: true, userNo: true, phone: true, nickname: true } },
+          user: { select: { id: true, userNo: true, phone: true, nickname: true, hqRemark: true } },
           delivery: {
             select: {
               provider: true,
@@ -176,8 +179,28 @@ export class AdminOrdersService {
     }
     if (query.orderType) where.orderType = query.orderType as Prisma.EnumOrderTypeFilter['equals'];
     if (query.userId) where.userId = BigInt(query.userId);
+    const userKeyword = query.userKeyword?.trim();
+    if (userKeyword) {
+      const userOr: Prisma.UserWhereInput[] = [
+        { userNo: { contains: userKeyword } },
+        { nickname: { contains: userKeyword } },
+        { hqRemark: { contains: userKeyword } },
+        { phone: { contains: userKeyword } },
+      ];
+      if (/^\d+$/.test(userKeyword)) {
+        userOr.push({ id: BigInt(userKeyword) });
+      }
+      where.user = { OR: userOr };
+    }
     if (query.cityId) where.cityId = BigInt(query.cityId);
     if (query.receiverPhone) where.receiverPhone = { contains: query.receiverPhone };
+    const productKeyword = query.productKeyword?.trim();
+    if (productKeyword) {
+      where.OR = [
+        { productName: { contains: productKeyword } },
+        { productSpec: { contains: productKeyword } },
+      ];
+    }
     if (query.deliveryType) {
       where.deliveryType = query.deliveryType as Prisma.EnumDeliveryTypeFilter['equals'];
     }
@@ -190,6 +213,10 @@ export class AdminOrdersService {
       if (query.createdTo) where.createdAt.lte = this.endOfDay(query.createdTo);
     }
     if (query.excludeTest) where.isTest = false;
+    const promoCodeId = query.promoCodeId?.trim();
+    if (promoCodeId && /^\d+$/.test(promoCodeId)) {
+      where.promoCodeId = BigInt(promoCodeId);
+    }
 
     return where;
   }
@@ -252,6 +279,7 @@ export class AdminOrdersService {
             userNo: true,
             phone: true,
             nickname: true,
+            hqRemark: true,
             deviceKey: true,
             phoneVerifiedAt: true,
           },

server/dukang-api/src/modules/ops/admin-redeem.service.ts

@@ -54,7 +54,7 @@ export class AdminRedeemService {
         skip: (page - 1) * pageSize,
         take: pageSize,
         include: {
-          user: { select: { id: true, userNo: true, phone: true, nickname: true } },
+          user: { select: { id: true, userNo: true, phone: true, nickname: true, hqRemark: true } },
           store: { select: { id: true, name: true, cityName: true } },
           coupon: { select: { id: true, couponNo: true, balance: true } },
         },
@@ -77,7 +77,7 @@ export class AdminRedeemService {
     const record = await this.prisma.redeemRecord.findUnique({
       where: { id },
       include: {
-        user: { select: { id: true, userNo: true, phone: true, nickname: true } },
+        user: { select: { id: true, userNo: true, phone: true, nickname: true, hqRemark: true } },
         store: {
           select: {
             id: true,

server/dukang-api/src/modules/ops/admin-users.service.ts

@@ -81,6 +81,13 @@ export class AdminUsersService {
 
     if (query.phone) where.phone = { contains: query.phone };
     if (query.userNo) where.userNo = { contains: query.userNo };
+    const userId = query.userId?.trim();
+    if (userId) {
+      if (!/^\d+$/.test(userId)) {
+        return serializeBigInt({ items: [], total: 0, page, pageSize });
+      }
+      where.id = BigInt(userId);
+    }
     if (query.deviceKey) where.deviceKey = query.deviceKey;
     if (query.status !== undefined) where.status = query.status;
     if (query.phoneVerified === '1') where.phoneVerifiedAt = { not: null };

server/dukang-api/src/modules/ops/dto/admin-query.dto.ts

@@ -48,6 +48,11 @@ export class AdminUsersQueryDto extends PaginationQueryDto {
   @IsString()
   userNo?: string;
 
+  /** 精确匹配用户主键，供订单等页的用户快链带入筛选 */
+  @IsOptional()
+  @IsString()
+  userId?: string;
+
   @IsOptional()
   @IsString()
   deviceKey?: string;
@@ -88,6 +93,16 @@ export class AdminOrdersQueryDto extends PaginationQueryDto {
   @IsString()
   userId?: string;
 
+  /** 用户编号 / 昵称 / 备注 / 手机 模糊匹配 */
+  @IsOptional()
+  @IsString()
+  userKeyword?: string;
+
+  /** 商品名称 / 规格 模糊匹配 */
+  @IsOptional()
+  @IsString()
+  productKeyword?: string;
+
   @IsOptional()
   @IsString()
   cityId?: string;
@@ -116,6 +131,11 @@ export class AdminOrdersQueryDto extends PaginationQueryDto {
   @IsOptional()
   @IsIn(['LOCAL', 'CROSS_CITY', 'ON_SITE_PICKUP'])
   deliveryType?: string;
+
+  /** 按下单时绑定的推广码筛选 */
+  @IsOptional()
+  @IsString()
+  promoCodeId?: string;
 }
 
 /** HQ 订单导出（筛选 + 勾选范围） */
@@ -149,6 +169,14 @@ export class AdminOrdersExportDto {
   @IsString()
   cityId?: string;
 
+  @IsOptional()
+  @IsString()
+  userKeyword?: string;
+
+  @IsOptional()
+  @IsString()
+  productKeyword?: string;
+
   @IsOptional()
   @IsString()
   receiverPhone?: string;
@@ -174,6 +202,10 @@ export class AdminOrdersExportDto {
   @IsOptional()
   @IsIn(['LOCAL', 'CROSS_CITY', 'ON_SITE_PICKUP'])
   deliveryType?: string;
+
+  @IsOptional()
+  @IsString()
+  promoCodeId?: string;
 }
 
 /** 概览页用户/订单 ECharts 聚合筛选 */

server/dukang-api/src/modules/promo/promo-code.service.ts

@@ -151,7 +151,7 @@ export class PromoCodeService {
     });
   }
 
-  private mapRow(row: PromoRow) {
+  private mapRow(row: PromoRow, orderCount?: number) {
     return serializeBigInt({
       id: row.id,
       code: row.code,
@@ -161,7 +161,7 @@ export class PromoCodeService {
       status: row.status,
       remark: row.remark,
       scanCount: row.scanCount,
-      orderCount: row.orderCount,
+      orderCount: orderCount ?? row.orderCount,
       landingUrl: buildLandingUrl(row.code, row.qrcodeId),
       qrcodeUrl: row.qrcodeResource?.url ?? null,
       ownerUser: this.mapOwnerUser(row.ownerUser),
@@ -207,9 +207,10 @@ export class PromoCodeService {
       }),
       this.prisma.commonPromoCode.count({ where }),
     ]);
+    const completedByPromo = await this.completedOrderCounts(items.map((r) => r.id));
 
     return serializeBigInt({
-      items: items.map((r) => this.mapRow(r)),
+      items: items.map((r) => this.mapRow(r, completedByPromo.get(r.id.toString()) ?? 0)),
       total,
       page,
       pageSize,
@@ -223,7 +224,7 @@ export class PromoCodeService {
     });
     if (!row) throw new NotFoundException('推广码不存在');
     const stats = await this.statsFromRow(row);
-    return serializeBigInt({ ...this.mapRow(row), stats });
+    return serializeBigInt({ ...this.mapRow(row, stats.orderCount), stats });
   }
 
   private async resolveOwnerUserId(ownerUserId?: string) {
@@ -519,6 +520,40 @@ export class PromoCodeService {
     this.logPromoMetric(promoCodeId, 'ORDER', { clientIp }, { userId, orderId });
   }
 
+  /** 订单完成时计入推广码订单数（下单/待付款不计入） */
+  async recordCompletedOrder(
+    promoCodeId: bigint,
+    orderId: bigint,
+    userId: bigint,
+    clientIp?: string,
+  ): Promise<void> {
+    const already = await this.prisma.logPromoEvent.findFirst({
+      where: { orderId, eventType: 'ORDER' },
+      select: { id: true },
+    });
+    if (already) return;
+    await this.prisma.commonPromoCode.update({
+      where: { id: promoCodeId },
+      data: { orderCount: { increment: 1 } },
+    });
+    this.logPromoOrderEvent(promoCodeId, orderId, userId, clientIp);
+  }
+
+  private async completedOrderCounts(promoIds: bigint[]): Promise<Map<string, number>> {
+    const map = new Map<string, number>();
+    if (!promoIds.length) return map;
+    const rows = await this.prisma.order.groupBy({
+      by: ['promoCodeId'],
+      where: { promoCodeId: { in: promoIds }, status: 'COMPLETED' },
+      _count: { _all: true },
+    });
+    for (const row of rows) {
+      if (row.promoCodeId == null) continue;
+      map.set(row.promoCodeId.toString(), row._count._all);
+    }
+    return map;
+  }
+
   private logPromoMetric(
     promoCodeId: bigint,
     eventType: PromoMetricEventType,
@@ -610,12 +645,37 @@ export class PromoCodeService {
       this.prisma.logPromoEvent.count({ where }),
     ]);
 
+    const userIds = [...new Set(items.map((row) => row.userId).filter((id): id is bigint => id != null))];
+    const orderIds = [...new Set(items.map((row) => row.orderId).filter((id): id is bigint => id != null))];
+    const [users, orders] = await Promise.all([
+      userIds.length
+        ? this.prisma.user.findMany({
+            where: { id: { in: userIds } },
+            select: { id: true, userNo: true },
+          })
+        : [],
+      orderIds.length
+        ? this.prisma.order.findMany({
+            where: { id: { in: orderIds } },
+            select: { id: true, orderNo: true },
+          })
+        : [],
+    ]);
+    const userNoById = new Map<string, string | null>(
+      users.map((u): [string, string | null] => [u.id.toString(), u.userNo]),
+    );
+    const orderNoById = new Map<string, string>(
+      orders.map((o): [string, string] => [o.id.toString(), o.orderNo]),
+    );
+
     return serializeBigInt({
       items: items.map((row) => ({
         id: row.id,
         eventType: row.eventType,
         userId: row.userId,
+        userNo: row.userId ? userNoById.get(row.userId.toString()) ?? null : null,
         orderId: row.orderId,
+        orderNo: row.orderId ? orderNoById.get(row.orderId.toString()) ?? null : null,
         sessionId: row.sessionId,
         clientIp: row.clientIp,
         ipProvince: row.ipProvince,
@@ -636,12 +696,9 @@ export class PromoCodeService {
     if (!promo) throw new NotFoundException('推广码不存在');
   }
 
-  private async statsFromRow(row: { id: bigint; scanCount: number; orderCount: number }) {
+  private async statsFromRow(row: { id: bigint; scanCount: number }) {
     const scanCount = row.scanCount;
-    const orderCount = row.orderCount;
-    const conversionRate =
-      scanCount > 0 ? Math.round((orderCount / scanCount) * 1000) / 10 : 0;
-    const [attributionCount, sourceMarkedCount] = await Promise.all([
+    const [attributionCount, sourceMarkedCount, orderCount] = await Promise.all([
       this.prisma.userPromoAttribution.count({
         where: { promoCodeId: row.id },
       }),
@@ -652,7 +709,12 @@ export class PromoCodeService {
           mergedIntoUserId: null,
         },
       }),
+      this.prisma.order.count({
+        where: { promoCodeId: row.id, status: 'COMPLETED' },
+      }),
     ]);
+    const conversionRate =
+      scanCount > 0 ? Math.round((orderCount / scanCount) * 1000) / 10 : 0;
     return {
       scanCount,
       orderCount,
@@ -695,7 +757,7 @@ export class PromoCodeService {
           sourceRefId: true,
           createdAt: true,
           promoTouch: { select: { firstTouchAt: true, promoCodeId: true } },
-          _count: { select: { orders: true } },
+          _count: { select: { orders: { where: { status: 'COMPLETED' } } } },
         },
       }),
       this.prisma.user.count({ where }),

server/dukang-api/src/modules/redeem/redeem.service.ts

@@ -8,7 +8,6 @@ import {
   calcRedeemSettleAmount,
   generateRedeemNo,
   generateRedeemPendingNo,
-  maskContactPhone,
   REDEEM_WEAKNET_FAIL_THRESHOLD,
   resolveSettlementRate,
   validateRedeemAmount,
@@ -197,7 +196,7 @@ export class RedeemService {
     const [userRow, storeRow] = await Promise.all([
       this.prisma.user.findUnique({
         where: { id: userId },
-        select: { isTest: true, nickname: true, phone: true },
+        select: { isTest: true, nickname: true, phone: true, hqRemark: true },
       }),
       this.prisma.store.findUnique({
         where: { id: account.storeId },
@@ -295,7 +294,8 @@ export class RedeemService {
           storeName: account.store.name || String(account.storeId),
           channel: channelLabel,
           userName: userRow?.nickname?.trim() || '—',
-          userPhone: maskContactPhone(userRow?.phone),
+          userPhone: (userRow?.phone || '').trim() || '—',
+          userRemark: (userRow?.hqRemark || '').trim() || '—',
         },
         {
           handlePath: `/redeem-records?redeemNo=${encodeURIComponent(record.redeemNo)}`,

server/dukang-api/src/modules/settlement/settlement.service.ts

@@ -1,8 +1,9 @@
-import { BadRequestException, Injectable, NotFoundException } from '@nestjs/common';
+import { BadRequestException, Injectable, Logger, NotFoundException, OnModuleInit } from '@nestjs/common';
 import { Prisma } from '@prisma/client';
 import {
   DEFAULT_STORE_WITHDRAW_DAILY_LIMIT,
   DEFAULT_XFX_LOGISTICS_PRICING,
+  LOGISTICS_SETTLEMENT_METHOD_LABELS,
   WINERY_SETTLEMENT_LAG_DAYS,
   WINERY_SETTLEMENT_RATE,
 } from '@dukang/shared-types';
@@ -28,6 +29,17 @@ import {
   loadWineryBankConfig,
   formatWecomBankAccount,
 } from '../../common/store/store-bank.util';
+import {
+  capBillBlocks,
+  formatLogisticsBillWecomBlock,
+  formatPartnerBillWecomBlock,
+  formatPartnerDashLabel,
+  formatPercent,
+  formatStoreBillWecomBlock,
+  joinLimited,
+  wecomBankParts,
+  type WecomBankLike,
+} from './wecom-bill-digest';
 
 function generateBillNo(prefix: string) {
   return `${prefix}${Date.now()}${Math.floor(Math.random() * 900 + 100)}`;
@@ -43,11 +55,16 @@ function startOfDay(d: Date) {
   return new Date(d.getFullYear(), d.getMonth(), d.getDate(), 0, 0, 0, 0);
 }
 
+/** 核销窗口：昨日 00:00 ≤ t < 今日 00:00；出账日 = 今日 00:00（窗口右端） */
 function dayWindow(anchor = new Date()) {
   const end = startOfDay(anchor);
   const start = new Date(end);
   start.setDate(start.getDate() - 1);
-  return { start, end, billDate: start };
+  return { start, end, billDate: end };
+}
+
+function shanghaiYmd(d: Date): string {
+  return d.toLocaleDateString('sv-SE', { timeZone: 'Asia/Shanghai' });
 }
 
 function wineryDayWindow(anchor = new Date(), lagDays = WINERY_SETTLEMENT_LAG_DAYS) {
@@ -63,12 +80,37 @@ function round2(n: number) {
   return Math.round(n * 100) / 100;
 }
 
-const BILL_DIGEST_MAX_LINES = 15;
+function sumAmounts(rows: Array<{ amount: number }>): string {
+  return rows.reduce((s, r) => s + Number(r.amount || 0), 0).toFixed(2);
+}
 
-function capBillSummary(lines: string[]): string {
-  if (!lines.length) return '无';
-  if (lines.length <= BILL_DIGEST_MAX_LINES) return lines.join('\n');
-  return `${lines.slice(0, BILL_DIGEST_MAX_LINES).join('\n')}\n…等共 ${lines.length} 笔`;
+function storeWecomMeta(
+  store:
+    | {
+        name?: string | null;
+        cityName?: string | null;
+        cityRef?: { name: string } | null;
+        partnerAccount?: {
+          name: string | null;
+          companyName: string | null;
+          parent?: { companyName: string | null } | null;
+        } | null;
+      }
+    | null
+    | undefined,
+  fallbackName: string,
+) {
+  const cityName = store?.cityRef?.name?.trim() || store?.cityName?.trim() || '—';
+  const acc = store?.partnerAccount;
+  const partnerLabel = formatPartnerDashLabel(
+    acc?.companyName || acc?.parent?.companyName,
+    acc?.name,
+  );
+  return {
+    storeName: store?.name?.trim() || fallbackName,
+    cityName,
+    partnerLabel,
+  };
 }
 
 function getStoreWithdrawDailyLimit(): number {
@@ -94,7 +136,9 @@ function isWithdrawOverdue(appliedAt: Date, now = new Date()): boolean {
 }
 
 @Injectable()
-export class SettlementService {
+export class SettlementService implements OnModuleInit {
+  private readonly logger = new Logger(SettlementService.name);
+
   constructor(
     private readonly prisma: PrismaService,
     private readonly analyticsService: AnalyticsService,
@@ -104,27 +148,59 @@ export class SettlementService {
     private readonly wecomPush: WecomMessagePushService,
   ) {}
 
+  async onModuleInit() {
+    try {
+      const shifted = await this.realignStoreBillIssueDates();
+      if (shifted > 0) this.logger.log(`Store bill dates aligned to issue day: ${shifted}`);
+    } catch (e) {
+      this.logger.warn(`Store bill date align skipped: ${e instanceof Error ? e.message : e}`);
+    }
+  }
+
+  /**
+   * 旧数据 billDate=核销自然日（窗口左端）；现改为出账日（窗口右端=今天）。
+   * 按 created_at 日历日对比，只把仍早一天的行 +1；从晚到早更新避免 (storeId,billDate) 冲突。
+   */
+  private async realignStoreBillIssueDates(): Promise<number> {
+    const locked = await this.prisma.$queryRaw<Array<{ acquired: number | bigint | null }>>`
+      SELECT GET_LOCK('store_bill_issue_date_align', 5) AS acquired
+    `;
+    if (!Number(locked[0]?.acquired)) return 0;
+    try {
+      const shifted = await this.prisma.$executeRaw`
+        UPDATE store_bill
+        SET bill_date = DATE_ADD(bill_date, INTERVAL 1 DAY)
+        WHERE DATE(bill_date) < DATE(created_at)
+        ORDER BY bill_date DESC
+      `;
+      return Number(shifted);
+    } finally {
+      await this.prisma.$queryRaw`SELECT RELEASE_LOCK('store_bill_issue_date_align')`;
+    }
+  }
+
   private notifyPartnerBillDigest(
     period: string,
     rows: Array<{
-      label: string;
+      cityName: string;
+      partnerLabel: string;
+      orderCount?: number;
+      redeemCount?: number;
+      orderCommission: number;
+      redeemCommission: number;
       amount: number;
-      bankAccountName?: string | null;
-      bankBranch?: string | null;
-      bankAccountNo?: string | null;
+      bank?: WecomBankLike | null;
     }>,
   ) {
     if (!rows.length) return;
-    const lines = rows.map(
-      (r) =>
-        `${r.label} ¥${Number(r.amount).toFixed(2)} ${formatWecomBankAccount(r)}`,
-    );
+    const blocks = rows.map((r) => formatPartnerBillWecomBlock(r));
     void this.wecomPush.dispatchEvent(
       'finance.partner_bill',
       {
         period,
         billCount: String(rows.length),
-        billSummary: capBillSummary(lines),
+        totalAmount: sumAmounts(rows),
+        billSummary: capBillBlocks(blocks),
       },
       { handlePath: '/finance/partner-bills' },
     );
@@ -133,25 +209,25 @@ export class SettlementService {
   private notifyLogisticsBillDigest(
     period: string,
     rows: Array<{
-      label: string;
+      cityNames: string;
+      partnerNames: string;
+      providerName: string;
+      settlementMethod: string;
+      orderCount: number;
+      bottleCount: number;
       amount: number;
-      bankAccountName?: string | null;
-      bankName?: string | null;
-      bankBranch?: string | null;
-      bankAccountNo?: string | null;
+      bank?: WecomBankLike | null;
     }>,
   ) {
     if (!rows.length) return;
-    const lines = rows.map(
-      (r) =>
-        `${r.label} ¥${Number(r.amount).toFixed(2)} ${formatWecomBankAccount(r)}`,
-    );
+    const blocks = rows.map((r) => formatLogisticsBillWecomBlock(r));
     void this.wecomPush.dispatchEvent(
       'finance.logistics_bill',
       {
         period,
         billCount: String(rows.length),
-        billSummary: capBillSummary(lines),
+        totalAmount: sumAmounts(rows),
+        billSummary: capBillBlocks(blocks),
       },
       { handlePath: '/finance/logistics-bills' },
     );
@@ -649,16 +725,34 @@ export class SettlementService {
     const [store, bank] = await Promise.all([
       this.prisma.store.findUnique({
         where: { id: row.storeId },
-        select: { name: true },
+        select: {
+          name: true,
+          cityName: true,
+          cityRef: { select: { name: true } },
+          partnerAccount: {
+            select: {
+              name: true,
+              companyName: true,
+              parent: { select: { companyName: true } },
+            },
+          },
+        },
       }),
       loadStorePrimaryBank(this.prisma, row.storeId),
     ]);
+    const meta = storeWecomMeta(store, String(row.storeId));
+    const bankParts = wecomBankParts(bank);
     void this.wecomPush.dispatchEvent(
       'store.withdraw_approved',
       {
-        storeName: store?.name || String(row.storeId),
+        cityName: meta.cityName,
+        storeName: meta.storeName,
+        partnerLabel: meta.partnerLabel,
         withdrawNo: row.withdrawNo,
         amount: Number(row.amount).toFixed(2),
+        payee: bankParts.payee,
+        accountNo: bankParts.accountNo,
+        bankBranch: bankParts.bankBranch,
         bankAccount: formatWecomBankAccount(bank),
         storeId: row.storeId.toString(),
       },
@@ -919,7 +1013,7 @@ export class SettlementService {
 
   // ─── Store bills (daily header) ──────────────────────
 
-  /** 生成指定自然日窗口内的门店对账单（默认昨日） */
+  /** 生成昨日核销窗口的门店对账单；billDate = 出账日（今日） */
   async generateStoreBillsForDay(anchor = new Date()) {
     const { start, end, billDate } = dayWindow(anchor);
     const payouts = await this.prisma.storePayout.findMany({
@@ -930,7 +1024,24 @@ export class SettlementService {
         withdrawItem: { is: null },
         status: 'PENDING',
       },
-      include: { store: { select: { id: true, name: true, settlementRate: true } } },
+      include: {
+        store: {
+          select: {
+            id: true,
+            name: true,
+            cityName: true,
+            settlementRate: true,
+            cityRef: { select: { name: true } },
+            partnerAccount: {
+              select: {
+                name: true,
+                companyName: true,
+                parent: { select: { companyName: true } },
+              },
+            },
+          },
+        },
+      },
     });
 
     const byStore = new Map<string, typeof payouts>();
@@ -943,10 +1054,19 @@ export class SettlementService {
 
     let created = 0;
     let skipped = 0;
-    const createdBills: Array<{ storeId: bigint; storeName: string; amount: number }> = [];
+    const createdBills: Array<{
+      storeId: bigint;
+      storeName: string;
+      cityName: string;
+      partnerLabel: string;
+      redeemCount: number;
+      redeemAmount: number;
+      settlementRate: number;
+      amount: number;
+    }> = [];
     for (const [storeIdStr, list] of byStore) {
       const storeId = BigInt(storeIdStr);
-      const storeName = list[0]?.store?.name || storeIdStr;
+      const meta = storeWecomMeta(list[0]?.store, storeIdStr);
       const existing = await this.prisma.storeBill.findUnique({
         where: { storeId_billDate: { storeId, billDate } },
       });
@@ -975,7 +1095,14 @@ export class SettlementService {
           });
         });
         created += 1;
-        createdBills.push({ storeId, storeName, amount: updatedTotal });
+        createdBills.push({
+          storeId,
+          ...meta,
+          redeemCount: existing.redeemCount + list.length,
+          redeemAmount: round2(Number(existing.redeemAmount) + redeemAmount),
+          settlementRate: rate,
+          amount: updatedTotal,
+        });
         continue;
       }
 
@@ -1001,25 +1128,35 @@ export class SettlementService {
         });
       });
       created += 1;
-      createdBills.push({ storeId, storeName, amount: payoutAmount });
+      createdBills.push({
+        storeId,
+        ...meta,
+        redeemCount: list.length,
+        redeemAmount,
+        settlementRate: rate,
+        amount: payoutAmount,
+      });
     }
 
-    const period = billDate.toISOString().slice(0, 10);
+    const period = shanghaiYmd(billDate);
     if (createdBills.length) {
       const banks = await loadStorePrimaryBanksMap(
         this.prisma,
         createdBills.map((b) => b.storeId),
       );
-      const lines = createdBills.map(
-        (b) =>
-          `${b.storeName} ¥${b.amount.toFixed(2)} ${formatWecomBankAccount(banks.get(b.storeId.toString()) ?? null)}`,
+      const blocks = createdBills.map((b) =>
+        formatStoreBillWecomBlock({
+          ...b,
+          bank: banks.get(b.storeId.toString()) ?? null,
+        }),
       );
       void this.wecomPush.dispatchEvent(
         'finance.store_bill',
         {
           period,
           billCount: String(createdBills.length),
-          billSummary: capBillSummary(lines),
+          totalAmount: sumAmounts(createdBills),
+          billSummary: capBillBlocks(blocks),
         },
         { handlePath: '/finance/store-bills?kind=T1_BILL' },
       );
@@ -1166,6 +1303,7 @@ export class SettlementService {
     return serializeBigInt({
       items: slice.map((r) => ({
         ...r,
+        date: r.kind === 'T1_BILL' ? shanghaiYmd(r.date) : r.date,
         bankAccount:
           r.kind === 'T1_BILL'
             ? bankMap.get(String(r.storeId)) ?? null
@@ -1220,7 +1358,13 @@ export class SettlementService {
       totalAmount: Number(aggregates._sum.payoutAmount ?? 0),
     };
 
-    return serializeBigInt({ items, total, page, pageSize, summary });
+    return serializeBigInt({
+      items: items.map((b) => ({ ...b, billDate: shanghaiYmd(b.billDate) })),
+      total,
+      page,
+      pageSize,
+      summary,
+    });
   }
 
   async getAdminStoreBill(id: bigint) {
@@ -1236,7 +1380,7 @@ export class SettlementService {
     });
     if (!bill) throw new NotFoundException('门店对账单不存在');
     const storeAccount = await loadStorePrimaryBank(this.prisma, bill.storeId);
-    return serializeBigInt({ ...bill, storeAccount });
+    return serializeBigInt({ ...bill, billDate: shanghaiYmd(bill.billDate), storeAccount });
   }
 
   async confirmStoreBill(id: bigint, dto: { paymentRef?: string } = {}) {
@@ -1294,7 +1438,7 @@ export class SettlementService {
     );
     const header = [
       '账单号',
-      '账单日',
+      '出账日',
       '门店',
       '城市',
       '核销笔数',
@@ -1312,7 +1456,7 @@ export class SettlementService {
       const bank = bankMap.get(String(b.storeId));
       return [
         csvEscape(b.billNo),
-        b.billDate.toISOString().slice(0, 10),
+        shanghaiYmd(b.billDate),
         csvEscape(b.store.name),
         csvEscape(b.store.cityName ?? ''),
         b.redeemCount,
@@ -1476,15 +1620,19 @@ export class SettlementService {
         bankAccountName: true,
         bankBranch: true,
         bankAccountNo: true,
+        city: { select: { name: true } },
       },
     });
     const results: Array<{ partnerId: string; companyName: string; ok: boolean; message?: string }> = [];
     const created: Array<{
-      label: string;
+      cityName: string;
+      partnerLabel: string;
+      orderCount?: number;
+      redeemCount?: number;
+      orderCommission: number;
+      redeemCommission: number;
       amount: number;
-      bankAccountName: string | null;
-      bankBranch: string | null;
-      bankAccountNo: string | null;
+      bank?: WecomBankLike | null;
     }> = [];
     for (const p of partners) {
       try {
@@ -1497,14 +1645,19 @@ export class SettlementService {
           { notify: false },
         );
         results.push({ partnerId: p.id.toString(), companyName: p.companyName ?? '', ok: true });
-        const label =
-          [p.companyName?.trim(), p.name?.trim()].filter(Boolean).join(' · ') || p.id.toString();
         created.push({
-          label,
+          cityName: p.city?.name?.trim() || '—',
+          partnerLabel: formatPartnerDashLabel(p.companyName, p.name),
+          orderCount: Number(bill.orderCount ?? 0),
+          redeemCount: Number(bill.redeemCount ?? 0),
+          orderCommission: Number(bill.orderCommission),
+          redeemCommission: Number(bill.redeemCommission),
           amount: Number(bill.totalAmount),
-          bankAccountName: p.bankAccountName,
-          bankBranch: p.bankBranch,
-          bankAccountNo: p.bankAccountNo,
+          bank: {
+            bankAccountName: p.bankAccountName,
+            bankBranch: p.bankBranch,
+            bankAccountNo: p.bankAccountNo,
+          },
         });
       } catch (e) {
         results.push({
@@ -1628,24 +1781,37 @@ export class SettlementService {
         });
 
     if (opts?.notify !== false) {
-      const label =
-        [primary.companyName?.trim(), primary.name?.trim()].filter(Boolean).join(' · ') ||
-        primary.id.toString();
-      this.notifyPartnerBillDigest(
-        `${body.year}-${String(body.month).padStart(2, '0')}`,
-        [
-          {
-            label,
-            amount: totalAmount,
+      let cityName = '—';
+      if (primary.cityId) {
+        const city = await this.prisma.commonCity.findUnique({
+          where: { id: primary.cityId },
+          select: { name: true },
+        });
+        cityName = city?.name?.trim() || '—';
+      }
+      this.notifyPartnerBillDigest(`${body.year}-${String(body.month).padStart(2, '0')}`, [
+        {
+          cityName,
+          partnerLabel: formatPartnerDashLabel(primary.companyName, primary.name),
+          orderCount: orders.length,
+          redeemCount: redeems.length,
+          orderCommission: round2(orderCommission),
+          redeemCommission: round2(redeemCommission),
+          amount: totalAmount,
+          bank: {
             bankAccountName: primary.bankAccountName,
             bankBranch: primary.bankBranch,
             bankAccountNo: primary.bankAccountNo,
           },
-        ],
-      );
+        },
+      ]);
     }
 
-    return serializeBigInt(bill);
+    return serializeBigInt({
+      ...bill,
+      orderCount: orders.length,
+      redeemCount: redeems.length,
+    });
   }
 
   /** HQ：发送给合伙人（待审核 → 待合伙人确认） */
@@ -1880,6 +2046,7 @@ export class SettlementService {
         deliveryType: { in: ['LOCAL', 'CROSS_CITY'] },
         completedAt: { gte: start, lt: end },
       },
+      include: { city: { select: { name: true } } },
       orderBy: { completedAt: 'asc' },
     });
 
@@ -1937,12 +2104,27 @@ export class SettlementService {
 
     const period = billDate.toISOString().slice(0, 10);
     const wineryBank = await loadWineryBankConfig(this.prisma);
+    const bankParts = wecomBankParts(wineryBank);
+    const cityNames = joinLimited(
+      orders.map((o) => o.city?.name || ''),
+      '城',
+    );
+    const partnerNames = await this.partnerDashLabels(orders.map((o) => o.partnerAccountIdAtPay));
     void this.wecomPush.dispatchEvent(
       'finance.winery_bill',
       {
         period,
-        amount: wineryAmount.toFixed(2),
+        billCount: '1',
+        totalAmount: wineryAmount.toFixed(2),
+        cityNames,
+        partnerNames,
         orderCount: String(orders.length),
+        orderAmount: orderAmount.toFixed(2),
+        rate: formatPercent(rate),
+        amount: wineryAmount.toFixed(2),
+        payee: bankParts.payee,
+        accountNo: bankParts.accountNo,
+        bankBranch: bankParts.bankBranch,
         bankAccount: formatWecomBankAccount(wineryBank),
       },
       { handlePath: '/finance/winery-bills' },
@@ -2171,12 +2353,14 @@ export class SettlementService {
       billId?: string;
     }> = [];
     const created: Array<{
-      label: string;
+      cityNames: string;
+      partnerNames: string;
+      providerName: string;
+      settlementMethod: string;
+      orderCount: number;
+      bottleCount: number;
       amount: number;
-      bankAccountName: string | null;
-      bankName: string | null;
-      bankBranch: string | null;
-      bankAccountNo: string | null;
+      bank?: WecomBankLike | null;
     }> = [];
 
     for (const p of providers) {
@@ -2203,15 +2387,8 @@ export class SettlementService {
                 : String(bill.bill.id)
               : undefined,
         });
-        if (!bill.skipped && bill.bill) {
-          created.push({
-            label: p.name,
-            amount: Number(bill.bill.logisticsAmount ?? 0),
-            bankAccountName: p.bankAccountName,
-            bankName: p.bankName,
-            bankBranch: p.bankBranch,
-            bankAccountNo: p.bankAccountNo,
-          });
+        if (!bill.skipped && bill.wecom) {
+          created.push(bill.wecom);
         }
       } catch (e) {
         results.push({
@@ -2237,6 +2414,20 @@ export class SettlementService {
     };
   }
 
+  private async partnerDashLabels(ids: Array<bigint | null | undefined>, max = 5): Promise<string> {
+    const uniq = [...new Set(ids.filter((id): id is bigint => id != null))];
+    if (!uniq.length) return '—';
+    const partners = await this.prisma.partnerAccount.findMany({
+      where: { id: { in: uniq } },
+      select: { name: true, companyName: true },
+    });
+    return joinLimited(
+      partners.map((p) => formatPartnerDashLabel(p.companyName, p.name)),
+      '家',
+      max,
+    );
+  }
+
   async generateLogisticsBill(
     body: { providerId: string; year: number; month: number },
     opts?: { notify?: boolean },
@@ -2291,6 +2482,8 @@ export class SettlementService {
             quantity: true,
             deliveryType: true,
             payStatus: true,
+            partnerAccountIdAtPay: true,
+            city: { select: { name: true } },
           },
         },
       },
@@ -2392,25 +2585,38 @@ export class SettlementService {
       return header;
     });
 
+    const wecom = {
+      cityNames: joinLimited(
+        eligible.map((d) => d.order.city?.name || ''),
+        '城',
+      ),
+      partnerNames: await this.partnerDashLabels(eligible.map((d) => d.order.partnerAccountIdAtPay)),
+      providerName: provider.name,
+      settlementMethod:
+        LOGISTICS_SETTLEMENT_METHOD_LABELS[
+          provider.settlementMethod as keyof typeof LOGISTICS_SETTLEMENT_METHOD_LABELS
+        ] ?? String(provider.settlementMethod),
+      orderCount,
+      bottleCount,
+      amount: Number(bill.logisticsAmount),
+      bank: {
+        bankAccountName: provider.bankAccountName,
+        bankName: provider.bankName,
+        bankBranch: provider.bankBranch,
+        bankAccountNo: provider.bankAccountNo,
+      },
+    };
+
     if (opts?.notify !== false) {
-      this.notifyLogisticsBillDigest(
-        `${body.year}-${String(body.month).padStart(2, '0')}`,
-        [
-          {
-            label: provider.name,
-            amount: Number(bill.logisticsAmount),
-            bankAccountName: provider.bankAccountName,
-            bankName: provider.bankName,
-            bankBranch: provider.bankBranch,
-            bankAccountNo: provider.bankAccountNo,
-          },
-        ],
-      );
+      this.notifyLogisticsBillDigest(`${body.year}-${String(body.month).padStart(2, '0')}`, [
+        wecom,
+      ]);
     }
 
     return {
       skipped: false,
       bill: serializeBigInt(bill),
+      wecom,
     };
   }
 

server/dukang-api/src/modules/settlement/wecom-bill-digest.ts

@@ -0,0 +1,157 @@
+/** 企微结算账单正文：分字段块 + 字节上限（机器人 markdown 约 4096 字节） */
+
+export type WecomBankLike = {
+  bankAccountName?: string | null;
+  bankName?: string | null;
+  bankBranch?: string | null;
+  bankAccountNo?: string | null;
+};
+
+export function formatYuan(n: number): string {
+  return `¥${Number(n).toFixed(2)}`;
+}
+
+export function formatPercent(rate: number): string {
+  const p = Number(rate) * 100;
+  if (!Number.isFinite(p)) return '—';
+  const rounded = Math.round(p * 100) / 100;
+  const text = Number.isInteger(rounded) ? String(rounded) : String(rounded);
+  return `${text}%`;
+}
+
+export function formatPartnerDashLabel(
+  company?: string | null,
+  name?: string | null,
+): string {
+  const person = (name || '').trim() || '—';
+  const org = (company || '').trim();
+  return org ? `${org}-${person}` : person;
+}
+
+export function wecomBankParts(bank?: WecomBankLike | null): {
+  payee: string;
+  accountNo: string;
+  bankBranch: string;
+} {
+  if (!bank) return { payee: '未登记', accountNo: '—', bankBranch: '—' };
+  const payee = bank.bankAccountName?.trim() || '';
+  const accountNo = bank.bankAccountNo?.trim() || '';
+  const bankBranch = bank.bankName?.trim() || bank.bankBranch?.trim() || '';
+  if (!payee && !accountNo) {
+    return { payee: '未登记', accountNo: '—', bankBranch: bankBranch || '—' };
+  }
+  return {
+    payee: payee || '—',
+    accountNo: accountNo || '—',
+    bankBranch: bankBranch || '—',
+  };
+}
+
+export function formatWecomFieldBlock(rows: Array<[string, string]>): string {
+  return rows.map(([k, v]) => `${k}：${v}`).join('\n');
+}
+
+export function joinLimited(names: string[], unit: string, max = 8): string {
+  const uniq = [...new Set(names.map((n) => n.trim()).filter(Boolean))];
+  if (!uniq.length) return '—';
+  if (uniq.length <= max) return uniq.join('、');
+  return `${uniq.slice(0, max).join('、')} 等${uniq.length}${unit}`;
+}
+
+const BILL_DIGEST_MAX_BYTES = 3200;
+
+export function capBillBlocks(blocks: string[]): string {
+  if (!blocks.length) return '无';
+  const out: string[] = [];
+  let bytes = 0;
+  let shown = 0;
+  for (const block of blocks) {
+    const extra = (shown ? 2 : 0) + Buffer.byteLength(block, 'utf8');
+    if (shown > 0 && bytes + extra > BILL_DIGEST_MAX_BYTES) {
+      out.push(`另有 ${blocks.length - shown} 笔未列出，请到 HQ 查看`);
+      break;
+    }
+    out.push(block);
+    bytes += extra;
+    shown += 1;
+  }
+  return out.join('\n\n');
+}
+
+export function formatStoreBillWecomBlock(row: {
+  cityName: string;
+  storeName: string;
+  partnerLabel: string;
+  redeemCount: number;
+  redeemAmount: number;
+  settlementRate: number;
+  amount: number;
+  bank?: WecomBankLike | null;
+}): string {
+  const bank = wecomBankParts(row.bank);
+  return formatWecomFieldBlock([
+    ['城市', row.cityName || '—'],
+    ['门店', row.storeName || '—'],
+    ['合伙人', row.partnerLabel || '—'],
+    ['核销笔数', String(row.redeemCount)],
+    ['核销金额', formatYuan(row.redeemAmount)],
+    ['结算比例', formatPercent(row.settlementRate)],
+    ['账单', formatYuan(row.amount)],
+    ['收款人', bank.payee],
+    ['收款账户', bank.accountNo],
+    ['收款开户行', bank.bankBranch],
+  ]);
+}
+
+export function formatPartnerBillWecomBlock(row: {
+  cityName: string;
+  partnerLabel: string;
+  orderCount?: number;
+  redeemCount?: number;
+  orderCommission: number;
+  redeemCommission: number;
+  amount: number;
+  bank?: WecomBankLike | null;
+}): string {
+  const bank = wecomBankParts(row.bank);
+  const rows: Array<[string, string]> = [
+    ['城市', row.cityName || '—'],
+    ['合伙人', row.partnerLabel || '—'],
+  ];
+  if (row.orderCount != null) rows.push(['订单笔数', String(row.orderCount)]);
+  if (row.redeemCount != null) rows.push(['核销笔数', String(row.redeemCount)]);
+  rows.push(
+    ['订单佣金', formatYuan(row.orderCommission)],
+    ['核销佣金', formatYuan(row.redeemCommission)],
+    ['账单', formatYuan(row.amount)],
+    ['收款人', bank.payee],
+    ['收款账户', bank.accountNo],
+    ['收款开户行', bank.bankBranch],
+  );
+  return formatWecomFieldBlock(rows);
+}
+
+export function formatLogisticsBillWecomBlock(row: {
+  cityNames: string;
+  partnerNames: string;
+  providerName: string;
+  settlementMethod: string;
+  orderCount: number;
+  bottleCount: number;
+  amount: number;
+  bank?: WecomBankLike | null;
+}): string {
+  const bank = wecomBankParts(row.bank);
+  return formatWecomFieldBlock([
+    ['城市', row.cityNames || '—'],
+    ['合伙人', row.partnerNames || '—'],
+    ['承运商', row.providerName || '—'],
+    ['结算方式', row.settlementMethod || '—'],
+    ['发货笔数', String(row.orderCount)],
+    ['瓶数', String(row.bottleCount)],
+    ['账单', formatYuan(row.amount)],
+    ['收款人', bank.payee],
+    ['收款账户', bank.accountNo],
+    ['收款开户行', bank.bankBranch],
+  ]);
+}

server/dukang-api/src/modules/trade/trade.controller.ts

@@ -26,7 +26,7 @@ export class TradeController {
 
   @Post()
   create(@CurrentUser() user: AuthUser, @Body() body: Record<string, unknown>, @Req() req: Request) {
-    return this.tradeService.createOrder(user.actorId, body as never, req);
+    return this.tradeService.createOrder(user.actorId, body as never, req, user.clientApp);
   }
 
   @Get()

server/dukang-api/src/modules/trade/trade.service.ts

@@ -10,7 +10,6 @@ import type { FreightPayType } from '@prisma/client';
 import {
   calcBenefitAmount,
   generateOrderNo,
-  maskContactPhone,
   minBottleQtyForDelivery,
   orderTabToStatuses,
   toMinSaleQuantity,
@@ -210,6 +209,31 @@ export class TradeService {
     };
   }
 
+  private resolveTrackedUserClientApp(
+    clientApp?: ClientApp | string | null,
+    fallback: ClientApp = ClientApp.USER_H5,
+  ): ClientApp {
+    if (clientApp === ClientApp.USER_MINI || clientApp === ClientApp.USER_H5) {
+      return clientApp;
+    }
+    return fallback;
+  }
+
+  /** 支付回调无 JWT：沿用该订单已有埋点；没有则默认小程序（当前生产 C 端） */
+  private async clientAppForPaidOrder(userId: bigint, orderId: bigint): Promise<ClientApp> {
+    const row = await this.prisma.logUserAnalytics.findFirst({
+      where: {
+        userId,
+        refType: 'ORDER',
+        refId: orderId,
+        eventName: { in: ['order_submit', 'pay_fail'] },
+      },
+      orderBy: { createdAt: 'desc' },
+      select: { clientApp: true },
+    });
+    return this.resolveTrackedUserClientApp(row?.clientApp, ClientApp.USER_MINI);
+  }
+
   async createOrder(
     userId: bigint,
     body: {
@@ -221,6 +245,7 @@ export class TradeService {
       skuId?: string;
     },
     req: Request,
+    clientApp?: ClientApp,
   ) {
     const preview = await this.preview(userId, body);
     if (preview.quantityOk === false) {
@@ -332,26 +357,10 @@ export class TradeService {
         include: { product: true, imageResource: true },
       });
 
-      if (promoCodeId) {
-        await tx.commonPromoCode.update({
-          where: { id: promoCodeId },
-          data: { orderCount: { increment: 1 } },
-        });
-      }
-
       return created;
     });
 
-    if (promoCodeId) {
-      this.promoCodeService.logPromoOrderEvent(
-        promoCodeId,
-        order.id,
-        userId,
-        location.clientIp ?? undefined,
-      );
-    }
-
-    this.analyticsService.trackOneSafe(userId, 'USER_H5', {
+    this.analyticsService.trackOneSafe(userId, this.resolveTrackedUserClientApp(clientApp), {
       eventName: 'order_submit',
       refType: 'ORDER',
       refId: order.id,
@@ -480,7 +489,7 @@ export class TradeService {
       userId,
     });
 
-    this.analyticsService.trackOneSafe(userId, 'USER_H5', {
+    this.analyticsService.trackOneSafe(userId, this.resolveTrackedUserClientApp(clientApp), {
       eventName: 'pay_success',
       refType: 'ORDER',
       refId: order.id,
@@ -496,11 +505,20 @@ export class TradeService {
       where: { id: orderId },
       include: {
         city: { select: { name: true } },
-        user: { select: { phone: true } },
+        user: { select: { phone: true, nickname: true, hqRemark: true } },
       },
     });
     if (!order) return;
 
+    if (order.status === 'COMPLETED' && order.promoCodeId) {
+      await this.promoCodeService.recordCompletedOrder(
+        order.promoCodeId,
+        order.id,
+        order.userId,
+        order.clientIp ?? undefined,
+      );
+    }
+
     if (!order.isTest) {
       const unit = order.saleUnit === 'BOX' ? '箱' : '瓶';
       const spec = (order.productSpec || '').trim();
@@ -517,7 +535,9 @@ export class TradeService {
         order.deliveryType === 'ON_SITE_PICKUP'
           ? `${order.receiverName} ${order.receiverPhone}`.trim()
           : `${order.receiverName} ${order.receiverPhone} ${order.receiverAddress}`.trim();
-      const phoneMasked = maskContactPhone(order.user?.phone || order.receiverPhone);
+      const userName = order.user?.nickname?.trim() || '—';
+      const userPhone = (order.user?.phone || '').trim() || '—';
+      const userRemark = (order.user?.hqRemark || '').trim() || '—';
       void this.wecomPush.dispatchEvent(
         'order.paid',
         {
@@ -527,7 +547,10 @@ export class TradeService {
           skuSummary,
           deliveryLabel,
           receiverInfo,
-          phoneMasked,
+          userName,
+          userPhone,
+          userRemark,
+          phoneMasked: userPhone,
         },
         { handlePath: `/orders?orderNo=${encodeURIComponent(order.orderNo)}` },
       );
@@ -653,12 +676,16 @@ export class TradeService {
         orderNo: order.orderNo,
         userId: order.userId,
       });
-      this.analyticsService.trackOneSafe(order.userId, 'USER_H5', {
-        eventName: 'pay_success',
-        refType: 'ORDER',
-        refId: order.id,
-        extraJson: { orderId: order.id.toString(), mode: 'wechat_callback' },
-      });
+      this.analyticsService.trackOneSafe(
+        order.userId,
+        await this.clientAppForPaidOrder(order.userId, order.id),
+        {
+          eventName: 'pay_success',
+          refType: 'ORDER',
+          refId: order.id,
+          extraJson: { orderId: order.id.toString(), mode: 'wechat_callback' },
+        },
+      );
     }
 
     return { orderId: order.id.toString(), alreadyPaid: false };
@@ -1559,6 +1586,15 @@ export class TradeService {
       });
     });
 
+    if (targetStatus === 'COMPLETED' && currentStatus !== 'COMPLETED' && order.promoCodeId) {
+      await this.promoCodeService.recordCompletedOrder(
+        order.promoCodeId,
+        order.id,
+        order.userId,
+        order.clientIp ?? undefined,
+      );
+    }
+
     // 发货信息管理：进入 SHIPPING 时向微信录入（解冻结算前置）
     if (targetStatus === 'SHIPPING' && currentStatus !== 'SHIPPING') {
       this.wechatOrderShipping.uploadForOrderSafe(orderId);
@@ -1900,25 +1936,9 @@ export class TradeService {
         }),
       });
 
-      if (promoCodeId) {
-        await tx.commonPromoCode.update({
-          where: { id: promoCodeId },
-          data: { orderCount: { increment: 1 } },
-        });
-      }
-
       return created;
     });
 
-    if (promoCodeId) {
-      this.promoCodeService.logPromoOrderEvent(
-        promoCodeId,
-        order.id,
-        user.id,
-        location.clientIp ?? undefined,
-      );
-    }
-
     this.analyticsService.trackPartnerOneSafe(partnerAccountId, 'PARTNER_H5', {
       partnerAccountId: primary.id,
       eventName: 'partner_proxy_order_create',
@@ -2313,25 +2333,9 @@ export class TradeService {
         }),
       });
 
-      if (promoCodeId) {
-        await tx.commonPromoCode.update({
-          where: { id: promoCodeId },
-          data: { orderCount: { increment: 1 } },
-        });
-      }
-
       return created;
     });
 
-    if (promoCodeId) {
-      this.promoCodeService.logPromoOrderEvent(
-        promoCodeId,
-        order.id,
-        user.id,
-        location.clientIp ?? undefined,
-      );
-    }
-
     return {
       id: order.id.toString(),
       orderNo: order.orderNo,