merge(dev): fix XFX track callback body parse

Enable urlencoded body parser, return XFX {code,message} without API envelope, and harden callback payload parsing.

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

AGENTS.md

@@ -11,7 +11,7 @@
 | **V3.0 唯一需求源** | [`杜康好客-v3-PRD.md`](./杜康好客-v3-PRD.md) | 产品需求与三波交付（**只看这个**） |
 | **现状对照** | [`杜康好客-v3-现状对照.md`](./杜康好客-v3-现状对照.md) | 已完成 / 冲突 / 缺口审计 |
 | **V3 实现验收** | [`杜康好客-v3编码手册.md`](./杜康好客-v3编码手册.md) | 核销规则、分工、闭环 |
-| ~~V2 / preV1~~ | 历史参考 | **不再作为需求依据** |
+| ~~V2 / preV1~~ | 历史参考（**已压缩**；V2 全文见 git 2026-08-06 前） | **不再作为需求依据** |
 
 **禁止**：臆造 PRD 未定义规则；依赖 `doc/` 下过时文档；跨 OWNER 直写他人 Prisma 表。
 

apps/admin-web/package.json

@@ -11,6 +11,7 @@
   "dependencies": {
     "@ant-design/icons": "^5.5.1",
     "@dukang/shared-types": "workspace:*",
+    "@dukang/shared-ui": "workspace:*",
     "antd": "^5.22.0",
     "dayjs": "^1.11.13",
     "echarts": "^6.1.0",

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

@@ -1,14 +1,14 @@
 import { useEffect, useState } from 'react';
-import { Alert, Button, Form, Input, InputNumber, Space, Typography, message } from 'antd';
+import { Alert, Button, Form, Input, InputNumber, Modal, Space, Typography, message } from 'antd';
 import { DownOutlined, UpOutlined } from '@ant-design/icons';
 import type { StorePackageItemDto } from '@dukang/shared-types';
 import { STORE_PACKAGE_MAX_COUNT } from '@dukang/shared-types';
 import { request } from '../lib/api';
-
+import OssUpload from './OssUpload';
 type PackageRow = StorePackageItemDto;
 
 function emptyRow(index = 0): PackageRow {
-  return { name: '', price: '0', dishes: '', usableTime: '', otherNotes: '', sortOrder: index };
+  return { name: '', price: '0', dishes: '', usableTime: '', otherNotes: '', imageUrl: '', sortOrder: index };
 }
 
 export default function AdminStorePackagesSection({ storeId }: { storeId: string }) {
@@ -41,18 +41,33 @@ export default function AdminStorePackagesSection({ storeId }: { storeId: string
   }
 
   function removeAt(index: number) {
-    setItems((prev) => prev.filter((_, i) => i !== index).map((item, i) => ({ ...item, sortOrder: i })));
+    const run = () => {
-    setCollapsed((prev) => {
+      setItems((prev) => {
-      const next: Record<number, boolean> = {};
+        const next = prev.filter((_, i) => i !== index).map((item, i) => ({ ...item, sortOrder: i }));
-      Object.entries(prev).forEach(([k, v]) => {
+        return next.length ? next : [];
-        const i = Number(k);
-        if (i < index) next[i] = v;
-        else if (i > index) next[i - 1] = v;
       });
-      return next;
+      setCollapsed((prev) => {
-    });
+        const next: Record<number, boolean> = {};
+        Object.entries(prev).forEach(([k, v]) => {
+          const i = Number(k);
+          if (i < index) next[i] = v;
+          else if (i > index) next[i - 1] = v;
+        });
+        return next;
+      });
+    };
+    if (items.length === 1) {
+      Modal.confirm({
+        title: '清空门店套餐',
+        content: '删除最后一条套餐后，该门店将无展示套餐，确认继续？',
+        okText: '确认删除',
+        cancelText: '取消',
+        onOk: run,
+      });
+      return;
+    }
+    run();
   }
-
   function toggleCollapse(index: number) {
     setCollapsed((prev) => ({ ...prev, [index]: !prev[index] }));
   }
@@ -65,6 +80,7 @@ export default function AdminStorePackagesSection({ storeId }: { storeId: string
         dishes: item.dishes.trim(),
         usableTime: item.usableTime?.trim() || null,
         otherNotes: item.otherNotes?.trim() || null,
+        imageUrl: item.imageUrl?.trim() || null,
         sortOrder: index,
       }))
       .filter((item) => item.name || item.dishes || item.price);
@@ -106,8 +122,21 @@ export default function AdminStorePackagesSection({ storeId }: { storeId: string
     return <Typography.Text type="secondary">加载套餐中…</Typography.Text>;
   }
 
-  return (
+  if (!items.length) {
-    <Form layout="vertical" requiredMark={false}>
+    return (
+      <Form layout="vertical" requiredMark={false}>
+        <Alert type="info" showIcon style={{ marginBottom: 16 }} message="该门店暂无套餐，可添加或保存为空。" />
+        <Button onClick={addRow} style={{ marginBottom: 16 }}>
+          添加套餐
+        </Button>
+        <Button type="primary" loading={saving} onClick={() => void save()}>
+          保存套餐
+        </Button>
+      </Form>
+    );
+  }
+
+  return (    <Form layout="vertical" requiredMark={false}>
       <Alert
         type="info"
         showIcon
@@ -140,12 +169,11 @@ export default function AdminStorePackagesSection({ storeId }: { storeId: string
                   {displayName}
                 </Typography.Title>
               </Button>
-              {items.length > 1 ? (
+              {items.length > 0 ? (
                 <Button type="link" danger onClick={() => removeAt(index)}>
                   删除
                 </Button>
-              ) : null}
+              ) : null}            </Space>
-            </Space>
 
             {!isCollapsed ? (
               <>
@@ -186,8 +214,16 @@ export default function AdminStorePackagesSection({ storeId }: { storeId: string
                   />
                 </Form.Item>
 
-                <Form.Item label="其他说明" style={{ marginBottom: 0 }}>
+                <Form.Item label="套餐图片" style={{ marginBottom: 12 }}>
-                  <Input
+                  <OssUpload
+                    bizType="STORE_PACKAGE"
+                    mediaType="IMAGE"
+                    value={item.imageUrl || undefined}
+                    onChange={(url) => updateAt(index, { imageUrl: url })}
+                  />
+                </Form.Item>
+
+                <Form.Item label="其他说明" style={{ marginBottom: 0 }}>                  <Input
                     placeholder="不可叠加"
                     value={item.otherNotes || ''}
                     onChange={(e) => updateAt(index, { otherNotes: e.target.value })}

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

@@ -15,8 +15,6 @@ type OssUploadProps = {
   placeholder?: string;
 };
 
-const DEFAULT_MAX_MB = 10;
-
 export default function OssUpload({
   value,
   onChange,
@@ -24,7 +22,6 @@ export default function OssUpload({
   bizType,
   mediaType = 'IMAGE',
   accept,
-  maxSizeMb = DEFAULT_MAX_MB,
   placeholder = '上传后自动填入，或手动粘贴 URL',
 }: OssUploadProps) {
   const [uploading, setUploading] = useState(false);
@@ -34,12 +31,6 @@ export default function OssUpload({
 
   const customRequest: UploadProps['customRequest'] = async ({ file, onSuccess, onError }) => {
     const raw = file as File;
-    if (raw.size > maxSizeMb * 1024 * 1024) {
-      const err = new Error(`文件不能超过 ${maxSizeMb}MB`);
-      message.error(err.message);
-      onError?.(err);
-      return;
-    }
     setUploading(true);
     try {
       const result = await uploadFileToOss(raw, { bizType, mediaType });

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

@@ -0,0 +1,84 @@
+import { Descriptions } from 'antd';
+import { REDEEM_CHANNEL_LABELS, type RedeemChannel } from '@dukang/shared-types';
+import { fmtTime } from '../lib/constants';
+
+function maskPhone(phone: string | null | undefined) {
+  if (!phone || phone.length < 7) return phone ?? '—';
+  return `${phone.slice(0, 3)}****${phone.slice(-4)}`;
+}
+
+type Props = {
+  detail: Record<string, unknown>;
+  /** 列表页已脱敏展示时可设为 false，详情抽屉展示完整手机号 */
+  maskUserPhone?: boolean;
+};
+
+export default function RedeemRecordDetailDescriptions({ detail, maskUserPhone = false }: Props) {
+  const user = detail.user as
+    | { userNo?: string; nickname?: string | null; phone?: string | null }
+    | undefined;
+  const store = detail.store as
+    | {
+        name?: string;
+        cityName?: string;
+        address?: string;
+        partnerAccount?: { companyName?: string };
+      }
+    | undefined;
+  const coupon = detail.coupon as { couponNo?: string; order?: { orderNo?: string } } | undefined;
+  const channel = detail.channel === 'PHONE' ? 'PHONE' : 'SCAN';
+
+  return (
+    <Descriptions column={1} bordered size="small">
+      <Descriptions.Item label="核销号">{String(detail.redeemNo ?? '—')}</Descriptions.Item>
+      <Descriptions.Item label="方式">{REDEEM_CHANNEL_LABELS[channel as RedeemChannel]}</Descriptions.Item>
+      <Descriptions.Item label="核销额">¥{Number(detail.amount ?? 0).toFixed(2)}</Descriptions.Item>
+      <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="用户手机">
+        {maskUserPhone ? maskPhone(user?.phone) : user?.phone || '—'}
+      </Descriptions.Item>
+      <Descriptions.Item label="门店">
+        {store?.name ?? '—'}
+        {store?.cityName ? `（${store.cityName}）` : ''}
+      </Descriptions.Item>
+      <Descriptions.Item label="门店地址">{store?.address ?? '—'}</Descriptions.Item>
+      <Descriptions.Item label="合伙人">{store?.partnerAccount?.companyName ?? '—'}</Descriptions.Item>
+      <Descriptions.Item label="权益券号">{coupon?.couponNo ?? '—'}</Descriptions.Item>
+      <Descriptions.Item label="关联订单">{coupon?.order?.orderNo ?? '—'}</Descriptions.Item>
+      {Array.isArray(detail.allocations) && (detail.allocations as unknown[]).length > 0 ? (
+        <Descriptions.Item label="券分摊">
+          {(
+            detail.allocations as Array<{
+              couponNo?: string;
+              orderNo?: string | null;
+              amount?: number;
+            }>
+          )
+            .map((a, idx) => {
+              const role = idx === 0 ? '主' : '次';
+              return `${role} ${a.couponNo ?? '—'}¥${Number(a.amount ?? 0).toFixed(2)}${
+                a.orderNo ? `（订单 ${a.orderNo}）` : ''
+              }`;
+            })
+            .join('；')}
+        </Descriptions.Item>
+      ) : null}
+      {detail.payout ? (
+        <Descriptions.Item label="门店结算单">
+          ¥{Number((detail.payout as { settleAmount?: number }).settleAmount ?? 0).toFixed(2)}
+          {' / '}
+          {String((detail.payout as { status?: string }).status ?? '—')}
+        </Descriptions.Item>
+      ) : null}
+      {detail.rating ? (
+        <Descriptions.Item label="评价">
+          服务 {(detail.rating as { serviceScore?: number }).serviceScore ?? '—'} 分 / 环境{' '}
+          {(detail.rating as { envScore?: number }).envScore ?? '—'} 分
+        </Descriptions.Item>
+      ) : null}
+    </Descriptions>
+  );
+}

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

@@ -1,4 +1,9 @@
 import { apiBase, CLIENT_APP, getToken, clearAuth } from './api';
+import {
+  compressImageFileIfNeeded,
+  DEFAULT_OSS_MAX_UPLOAD_BYTES,
+  formatOssMaxSizeMb,
+} from '@dukang/shared-ui/compressImage';
 
 export type OssMediaType = 'IMAGE' | 'VIDEO' | 'FILE';
 
@@ -9,14 +14,24 @@ export type UploadFileResult = {
   mock: boolean;
 };
 
+async function prepareUploadFile(file: File, mediaType: OssMediaType): Promise<File> {
+  if (mediaType !== 'IMAGE') return file;
+  const compressed = await compressImageFileIfNeeded(file);
+  if (compressed.size > DEFAULT_OSS_MAX_UPLOAD_BYTES) {
+    throw new Error(`图片压缩后仍超过 ${formatOssMaxSizeMb()}MB，请换一张较小的图片`);
+  }
+  return compressed;
+}
+
 /** 经 API 服务端转存 OSS，避免浏览器直传跨域 */
 export async function uploadFileToOss(
   file: File,
   options: { bizType: string; mediaType?: OssMediaType },
 ): Promise<UploadFileResult> {
   const mediaType = options.mediaType ?? (file.type.startsWith('video/') ? 'VIDEO' : 'IMAGE');
+  const prepared = await prepareUploadFile(file, mediaType);
   const formData = new FormData();
-  formData.append('file', file);
+  formData.append('file', prepared);
   formData.append('bizType', options.bizType);
   formData.append('mediaType', mediaType);
 

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

@@ -18,6 +18,7 @@ import type { ColumnsType } from 'antd/es/table';
 import type { AdminBenefitGrantRequest } from '@dukang/shared-types';
 import { request } from '../lib/api';
 import { COUPON_STATUS_LABELS, fmtTime } from '../lib/constants';
+import RedeemRecordDetailDescriptions from '../components/RedeemRecordDetailDescriptions';
 import { useAdminList } from '../lib/useAdminList';
 
 type Row = {
@@ -242,7 +243,8 @@ export default function BenefitCouponsPage() {
 
       <Drawer
         title="权益券详情"
-        width={720}
+        width={980}
+        styles={{ body: { paddingBottom: 24 } }}
         open={drawerOpen}
         onClose={() => setDrawerOpen(false)}
         extra={
@@ -310,14 +312,15 @@ export default function BenefitCouponsPage() {
                   size="small"
                   rowKey="id"
                   pagination={false}
+                  tableLayout="fixed"
                   locale={{ emptyText: '暂无关联核销单' }}
                   dataSource={detail.redeemRecords ?? []}
                   columns={[
-                    { title: '核销号', dataIndex: 'redeemNo', width: 160, ellipsis: true },
+                    { title: '核销号', dataIndex: 'redeemNo', ellipsis: true },
                     {
                       title: '角色',
                       dataIndex: 'role',
-                      width: 70,
+                      width: 72,
                       render: (v: string | undefined) =>
                         v === 'SECONDARY' ? <Tag color="orange">次券</Tag> : <Tag color="blue">主券</Tag>,
                     },
@@ -331,31 +334,31 @@ export default function BenefitCouponsPage() {
                     {
                       title: '本券分摊',
                       dataIndex: 'couponAmount',
-                      width: 95,
+                      width: 96,
                       render: (v: number | undefined, row: CouponRedeemRecord) =>
                         `¥${Number(v ?? row.amount).toFixed(2)}`,
                     },
                     {
                       title: '核销总额',
                       dataIndex: 'amount',
-                      width: 90,
+                      width: 96,
                       render: (v: number) => `¥${Number(v).toFixed(2)}`,
                     },
                     {
                       title: '结算额',
                       dataIndex: 'settleAmount',
-                      width: 90,
+                      width: 96,
                       render: (v: number) => `¥${Number(v).toFixed(2)}`,
                     },
                     {
                       title: '时间',
                       dataIndex: 'createdAt',
-                      width: 150,
+                      width: 148,
                       render: (v: string) => fmtTime(v),
                     },
                     {
                       title: '操作',
-                      width: 70,
+                      width: 64,
                       render: (_: unknown, row: CouponRedeemRecord) => (
                         <Button type="link" size="small" onClick={() => void openRedeemDetail(row.id)}>
                           详情
@@ -374,7 +377,7 @@ export default function BenefitCouponsPage() {
 
       <Drawer
         title="核销单详情"
-        width={520}
+        width={640}
         open={redeemDrawerOpen}
         onClose={() => {
           setRedeemDrawerOpen(false);
@@ -385,79 +388,7 @@ export default function BenefitCouponsPage() {
         {redeemDetailLoading ? (
           <Typography.Text type="secondary">加载中…</Typography.Text>
         ) : redeemDetail ? (
-          <Descriptions column={1} bordered size="small">
+          <RedeemRecordDetailDescriptions detail={redeemDetail} />
-            <Descriptions.Item label="核销号">{String(redeemDetail.redeemNo ?? '—')}</Descriptions.Item>
-            <Descriptions.Item label="核销额">
-              ¥{Number(redeemDetail.amount ?? 0).toFixed(2)}
-            </Descriptions.Item>
-            <Descriptions.Item label="结算额">
-              ¥{Number(redeemDetail.settleAmount ?? 0).toFixed(2)}
-            </Descriptions.Item>
-            <Descriptions.Item label="时间">{fmtTime(String(redeemDetail.createdAt ?? ''))}</Descriptions.Item>
-            <Descriptions.Item label="用户">
-              {String((redeemDetail.user as { userNo?: string } | undefined)?.userNo ?? '—')}
-              {(redeemDetail.user as { phone?: string | null } | undefined)?.phone
-                ? ` / ${(redeemDetail.user as { phone?: string | null }).phone}`
-                : ''}
-            </Descriptions.Item>
-            <Descriptions.Item label="门店">
-              {String((redeemDetail.store as { name?: string } | undefined)?.name ?? '—')}
-              {(redeemDetail.store as { cityName?: string } | undefined)?.cityName
-                ? `（${(redeemDetail.store as { cityName?: string }).cityName}）`
-                : ''}
-            </Descriptions.Item>
-            <Descriptions.Item label="门店地址">
-              {String((redeemDetail.store as { address?: string } | undefined)?.address ?? '—')}
-            </Descriptions.Item>
-            <Descriptions.Item label="合伙人">
-              {String(
-                (redeemDetail.store as { partnerAccount?: { companyName?: string } } | undefined)
-                  ?.partnerAccount?.companyName ?? '—',
-              )}
-            </Descriptions.Item>
-            <Descriptions.Item label="权益券号">
-              {String((redeemDetail.coupon as { couponNo?: string } | undefined)?.couponNo ?? '—')}
-            </Descriptions.Item>
-            <Descriptions.Item label="关联订单">
-              {String(
-                (redeemDetail.coupon as { order?: { orderNo?: string } } | undefined)?.order?.orderNo ??
-                  '—',
-              )}
-            </Descriptions.Item>
-            {Array.isArray(redeemDetail.allocations) &&
-            (redeemDetail.allocations as unknown[]).length > 0 ? (
-              <Descriptions.Item label="券分摊">
-                {(
-                  redeemDetail.allocations as Array<{
-                    couponNo?: string;
-                    orderNo?: string | null;
-                    amount?: number;
-                    sortOrder?: number;
-                  }>
-                )
-                  .map((a, idx) => {
-                    const role = idx === 0 ? '主' : '次';
-                    return `${role} ${a.couponNo ?? '—'}¥${Number(a.amount ?? 0).toFixed(2)}${
-                      a.orderNo ? `（订单 ${a.orderNo}）` : ''
-                    }`;
-                  })
-                  .join('；')}
-              </Descriptions.Item>
-            ) : null}
-            {redeemDetail.payout ? (
-              <Descriptions.Item label="门店结算单">
-                ¥{Number((redeemDetail.payout as { settleAmount?: number }).settleAmount ?? 0).toFixed(2)}
-                {' / '}
-                {String((redeemDetail.payout as { status?: string }).status ?? '—')}
-              </Descriptions.Item>
-            ) : null}
-            {redeemDetail.rating ? (
-              <Descriptions.Item label="评价">
-                服务 {(redeemDetail.rating as { serviceScore?: number }).serviceScore ?? '—'} 分 / 环境{' '}
-                {(redeemDetail.rating as { envScore?: number }).envScore ?? '—'} 分
-              </Descriptions.Item>
-            ) : null}
-          </Descriptions>
         ) : null}
       </Drawer>
     </div>

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

@@ -1,4 +1,4 @@
-import { useState } from 'react';
+import { useEffect, useState } from 'react';
 import {
   Button,
   Form,
@@ -16,9 +16,12 @@ import type { ColumnsType } from 'antd/es/table';
 import {
   DEV_PLAN_TASK_STATUS_LABELS,
   DEV_PLAN_TASK_TYPE_LABELS,
+  SUPPORT_TICKET_STATUS_LABELS,
   type DevPlanTaskDto,
   type DevPlanTaskStatusDto,
   type DevPlanTaskTypeDto,
+  type DevPlanVersionDto,
+  type SupportTicketDto,
 } from '@dukang/shared-types';
 import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
@@ -46,11 +49,30 @@ export default function DevPlanTasksPage() {
   const [selectedRowKeys, setSelectedRowKeys] = useState<string[]>([]);
   const [modalOpen, setModalOpen] = useState(false);
   const [dispatchOpen, setDispatchOpen] = useState(false);
+  const [batchEditOpen, setBatchEditOpen] = useState(false);
+  const [batchSaving, setBatchSaving] = useState(false);
+  const [versions, setVersions] = useState<DevPlanVersionDto[]>([]);
+  const [supportTickets, setSupportTickets] = useState<SupportTicketDto[]>([]);
   const [editing, setEditing] = useState<DevPlanTaskDto | null>(null);
   const [saving, setSaving] = useState(false);
   const [dispatching, setDispatching] = useState(false);
   const [form] = Form.useForm();
   const [dispatchForm] = Form.useForm<{ supplement?: string }>();
+  const [batchForm] = Form.useForm<{ status?: DevPlanTaskStatusDto; versionId?: string }>();
+
+  useEffect(() => {
+    if (!batchEditOpen) return;
+    request<{ items: DevPlanVersionDto[] }>('/admin/dev-plan/versions?pageSize=100')
+      .then((res) => setVersions(res.items ?? []))
+      .catch(() => setVersions([]));
+  }, [batchEditOpen]);
+
+  useEffect(() => {
+    if (!modalOpen || editing) return;
+    request<{ items: SupportTicketDto[] }>('/admin/support-tickets?pageSize=100')
+      .then((res) => setSupportTickets(res.items ?? []))
+      .catch(() => setSupportTickets([]));
+  }, [modalOpen, editing]);
 
   const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList<DevPlanTaskDto>(
     '/admin/dev-plan/tasks',
@@ -66,7 +88,7 @@ export default function DevPlanTasksPage() {
 
   function openCreate() {
     setEditing(null);
-    form.setFieldsValue({ content: '', type: 'BUG', status: 'TODO' });
+    form.setFieldsValue({ content: '', type: 'BUG', status: 'TODO', supportTicketId: undefined });
     setModalOpen(true);
   }
 
@@ -89,7 +111,11 @@ export default function DevPlanTasksPage() {
       } else {
         await request('/admin/dev-plan/tasks', {
           method: 'POST',
-          body: JSON.stringify({ content: values.content, type: values.type }),
+          body: JSON.stringify({
+            content: values.content,
+            type: values.type,
+            supportTicketId: values.supportTicketId || undefined,
+          }),
         });
         message.success('已创建');
       }
@@ -119,6 +145,38 @@ export default function DevPlanTasksPage() {
     setDispatchOpen(true);
   }
 
+  function openBatchEdit() {
+    batchForm.setFieldsValue({ status: undefined, versionId: undefined });
+    setBatchEditOpen(true);
+  }
+
+  async function submitBatchEdit() {
+    const values = await batchForm.validateFields();
+    if (!values.status && !values.versionId) {
+      message.warning('请至少选择状态或关联版本');
+      return;
+    }
+    setBatchSaving(true);
+    try {
+      await request('/admin/dev-plan/tasks/batch-update', {
+        method: 'POST',
+        body: JSON.stringify({
+          taskIds: selectedRowKeys,
+          status: values.status || undefined,
+          versionId: values.versionId || undefined,
+        }),
+      });
+      message.success('批量更新成功');
+      setBatchEditOpen(false);
+      setSelectedRowKeys([]);
+      reload();
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '批量更新失败');
+    } finally {
+      setBatchSaving(false);
+    }
+  }
+
   async function submitDispatch() {
     const values = await dispatchForm.validateFields();
     setDispatching(true);
@@ -186,6 +244,9 @@ export default function DevPlanTasksPage() {
           开发计划 · 任务列表
         </Typography.Title>
         <Space>
+          <Button disabled={!selectedRowKeys.length} onClick={openBatchEdit}>
+            批量编辑
+          </Button>
           <Button disabled={!selectedRowKeys.length} onClick={openDispatch}>
             评审
           </Button>
@@ -258,7 +319,20 @@ export default function DevPlanTasksPage() {
             <Form.Item name="status" label="状态" rules={[{ required: true }]}>
               <Select options={STATUS_OPTIONS} />
             </Form.Item>
-          ) : null}
+          ) : (
+            <Form.Item name="supportTicketId" label="绑定技术支持工单">
+              <Select
+                allowClear
+                showSearch
+                optionFilterProp="label"
+                placeholder="可选：关联工单"
+                options={supportTickets.map((t) => ({
+                  value: t.id,
+                  label: `${t.ticketNo} · ${SUPPORT_TICKET_STATUS_LABELS[t.status]} · ${t.title}`,
+                }))}
+              />
+            </Form.Item>
+          )}
         </Form>
       </Modal>
 
@@ -280,6 +354,29 @@ export default function DevPlanTasksPage() {
           </Form.Item>
         </Form>
       </Modal>
+
+      <Modal
+        title="批量编辑任务"
+        open={batchEditOpen}
+        onCancel={() => setBatchEditOpen(false)}
+        onOk={() => void submitBatchEdit()}
+        confirmLoading={batchSaving}
+        destroyOnClose
+      >
+        <Typography.Paragraph type="secondary">已选 {selectedRowKeys.length} 条任务</Typography.Paragraph>
+        <Form form={batchForm} layout="vertical">
+          <Form.Item name="status" label="状态（不修改请留空）">
+            <Select allowClear placeholder="不修改" options={STATUS_OPTIONS} />
+          </Form.Item>
+          <Form.Item name="versionId" label="关联版本（追加关联，不修改请留空）">
+            <Select
+              allowClear
+              placeholder="不修改"
+              options={versions.map((v) => ({ value: v.id, label: v.versionNo }))}
+            />
+          </Form.Item>
+        </Form>
+      </Modal>
     </div>
   );
 }

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

@@ -18,6 +18,7 @@ import type { ColumnsType } from 'antd/es/table';
 import { UploadOutlined } from '@ant-design/icons';
 import type {
   KnowledgeBaseDto,
+  KnowledgeDocumentDetailDto,
   KnowledgeDocumentDto,
 } from '@dukang/shared-types';
 import { request } from '../lib/api';
@@ -49,6 +50,10 @@ export default function KnowledgeBasesPage() {
   const [docsLoading, setDocsLoading] = useState(false);
   const [docModalOpen, setDocModalOpen] = useState(false);
   const [docSaving, setDocSaving] = useState(false);
+  const [editingDoc, setEditingDoc] = useState<KnowledgeDocumentDto | null>(null);
+  const [editDocModalOpen, setEditDocModalOpen] = useState(false);
+  const [editDocSaving, setEditDocSaving] = useState(false);
+  const [editDocForm] = Form.useForm<DocForm>();
 
   const { data, loading, page, pageSize, setPage, setPageSize, reload } =
     useAdminList<KnowledgeBaseDto>(
@@ -195,28 +200,52 @@ export default function KnowledgeBasesPage() {
     },
     {
       title: '操作',
-      width: 80,
+      width: 140,
       render: (_, row) =>
         drawerKb?.canEditFull ? (
-          <Popconfirm
+          <Space>
-            title="删除文档？"
+            <Button
-            onConfirm={async () => {
+              type="link"
-              try {
+              size="small"
-                await request(`/admin/knowledge-bases/${drawerKb.id}/documents/${row.id}`, {
+              onClick={async () => {
-                  method: 'DELETE',
+                if (!drawerKb) return;
-                });
+                try {
-                message.success('已删除');
+                  const detail = await request<KnowledgeDocumentDetailDto>(
-                void loadDocs(drawerKb);
+                    `/admin/knowledge-bases/${drawerKb.id}/documents/${row.id}`,
-                reload();
+                  );
-              } catch (e) {
+                  setEditingDoc(row);
-                message.error(e instanceof Error ? e.message : String(e));
+                  editDocForm.setFieldsValue({
-              }
+                    title: detail.title,
-            }}
+                    contentText: detail.contentText || '',
-          >
+                  });
-            <Button type="link" size="small" danger>
+                  setEditDocModalOpen(true);
-              删除
+                } catch (e) {
+                  message.error(e instanceof Error ? e.message : String(e));
+                }
+              }}
+            >
+              编辑
             </Button>
-          </Popconfirm>
+            <Popconfirm
+              title="删除文档？"
+              onConfirm={async () => {
+                try {
+                  await request(`/admin/knowledge-bases/${drawerKb.id}/documents/${row.id}`, {
+                    method: 'DELETE',
+                  });
+                  message.success('已删除');
+                  void loadDocs(drawerKb);
+                  reload();
+                } catch (e) {
+                  message.error(e instanceof Error ? e.message : String(e));
+                }
+              }}
+            >
+              <Button type="link" size="small" danger>
+                删除
+              </Button>
+            </Popconfirm>
+          </Space>
         ) : null,
     },
   ];
@@ -398,6 +427,50 @@ export default function KnowledgeBasesPage() {
           </Form.Item>
         </Form>
       </Modal>
+
+      <Modal
+        title="编辑知识文档"
+        open={editDocModalOpen}
+        onCancel={() => {
+          setEditDocModalOpen(false);
+          setEditingDoc(null);
+        }}
+        confirmLoading={editDocSaving}
+        onOk={async () => {
+          if (!drawerKb || !editingDoc) return;
+          const values = await editDocForm.validateFields();
+          setEditDocSaving(true);
+          try {
+            await request(`/admin/knowledge-bases/${drawerKb.id}/documents/${editingDoc.id}`, {
+              method: 'PUT',
+              body: JSON.stringify({
+                title: values.title,
+                contentText: values.contentText || null,
+              }),
+            });
+            message.success('已保存');
+            setEditDocModalOpen(false);
+            setEditingDoc(null);
+            void loadDocs(drawerKb);
+            reload();
+          } catch (e) {
+            message.error(e instanceof Error ? e.message : String(e));
+          } finally {
+            setEditDocSaving(false);
+          }
+        }}
+        destroyOnClose
+        width={640}
+      >
+        <Form form={editDocForm} layout="vertical">
+          <Form.Item name="title" label="标题" rules={[{ required: true }]}>
+            <Input />
+          </Form.Item>
+          <Form.Item name="contentText" label="正文（可粘贴）">
+            <Input.TextArea rows={8} placeholder="支持 Markdown / 纯文本" />
+          </Form.Item>
+        </Form>
+      </Modal>
     </div>
   );
 }

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

@@ -168,10 +168,10 @@ function ProductDetailFields({ form, aromaType }: { form: FormInstance; aromaTyp
     <>
       <ProductDetailTemplatePicker form={form} aromaType={aromaType} />
       <Divider />
-      <Typography.Text type="secondary">详情页轮播（CAROUSEL）</Typography.Text>
+      <Typography.Text type="secondary">详情页轮播（CAROUSEL，单张最大 10MB）</Typography.Text>
       <ImageUrlList name="carouselUrls" label="轮播图" bizType="CAROUSEL" />
       <Divider />
-      <Typography.Text type="secondary">详情长图（DETAIL，可逐张修改）</Typography.Text>
+      <Typography.Text type="secondary">详情长图（DETAIL，可逐张修改，单张最大 10MB）</Typography.Text>
       <DetailImageUrlList label="详情图" bizType="DETAIL" />
       <Divider />
       <Form.Item name="storyTitle" label="故事标题">

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

@@ -1,7 +1,8 @@
 import { useState } from 'react';
-import { Button, Descriptions, Drawer, Form, Input, Select, Table, Tag, Typography } from 'antd';
+import { Button, 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';
+import RedeemRecordDetailDescriptions from '../components/RedeemRecordDetailDescriptions';
 import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
@@ -13,11 +14,16 @@ type Row = {
   settleAmount: number;
   channel?: RedeemChannel;
   createdAt: string;
-  user?: { userNo: string; phone: string | null };
+  user?: { userNo: string; phone: string | null; nickname?: string | null };
   store?: { name: string; cityName: string };
   coupon?: { couponNo: string };
 };
 
+function maskPhone(phone: string | null | undefined) {
+  if (!phone || phone.length < 7) return phone ?? '—';
+  return `${phone.slice(0, 3)}****${phone.slice(-4)}`;
+}
+
 export default function RedeemRecordsPage() {
   const [form] = Form.useForm();
   const [filters, setFilters] = useState<Record<string, string>>({});
@@ -34,6 +40,17 @@ export default function RedeemRecordsPage() {
   );
   const [detail, setDetail] = useState<Record<string, unknown> | null>(null);
   const [drawerOpen, setDrawerOpen] = useState(false);
+  const [detailLoading, setDetailLoading] = useState(false);
+
+  async function openDetail(id: string) {
+    setDetailLoading(true);
+    setDrawerOpen(true);
+    try {
+      setDetail(await request(`/admin/redeem-records/${id}`));
+    } finally {
+      setDetailLoading(false);
+    }
+  }
 
   const columns: ColumnsType<Row> = [
     { title: '核销号', dataIndex: 'redeemNo', width: 180 },
@@ -50,7 +67,19 @@ export default function RedeemRecordsPage() {
         );
       },
     },
-    { title: '用户', dataIndex: ['user', 'userNo'], width: 110 },
+    { title: '用户编号', dataIndex: ['user', 'userNo'], width: 110 },
+    {
+      title: '用户昵称',
+      dataIndex: ['user', 'nickname'],
+      width: 100,
+      render: (v: string | null | undefined) => v || '—',
+    },
+    {
+      title: '用户手机',
+      dataIndex: ['user', 'phone'],
+      width: 120,
+      render: (v: string | null | undefined) => maskPhone(v),
+    },
     { title: '门店', dataIndex: ['store', 'name'] },
     { title: '核销额', dataIndex: 'amount', width: 90, render: (v) => `¥${v}` },
     { title: '结算额', dataIndex: 'settleAmount', width: 90, render: (v) => `¥${v}` },
@@ -60,14 +89,7 @@ export default function RedeemRecordsPage() {
       title: '操作',
       width: 80,
       render: (_, row) => (
-        <Button
+        <Button type="link" size="small" onClick={() => void openDetail(row.id)}>
-          type="link"
-          size="small"
-          onClick={async () => {
-            setDetail(await request(`/admin/redeem-records/${row.id}`));
-            setDrawerOpen(true);
-          }}
-        >
           详情
         </Button>
       ),
@@ -113,7 +135,7 @@ export default function RedeemRecordsPage() {
         loading={loading}
         columns={columns}
         dataSource={data?.items ?? []}
-        scroll={{ x: 1100 }}
+        scroll={{ x: 1300 }}
         pagination={{
           current: page,
           pageSize,
@@ -125,22 +147,21 @@ export default function RedeemRecordsPage() {
           },
         }}
       />
-      <Drawer title="核销详情" width={520} open={drawerOpen} onClose={() => setDrawerOpen(false)}>
+      <Drawer
-        {detail && (
+        title="核销详情"
-          <Descriptions column={1} bordered size="small">
+        width={640}
-            <Descriptions.Item label="核销号">{String(detail.redeemNo)}</Descriptions.Item>
+        open={drawerOpen}
-            <Descriptions.Item label="方式">
+        onClose={() => {
-              {
+          setDrawerOpen(false);
-                REDEEM_CHANNEL_LABELS[
+          setDetail(null);
-                  (detail.channel === 'PHONE' ? 'PHONE' : 'SCAN') as RedeemChannel
+        }}
-                ]
+        destroyOnClose
-              }
+      >
-            </Descriptions.Item>
+        {detailLoading ? (
-            <Descriptions.Item label="核销额">¥{String(detail.amount)}</Descriptions.Item>
+          <Typography.Text type="secondary">加载中…</Typography.Text>
-            <Descriptions.Item label="结算额">¥{String(detail.settleAmount)}</Descriptions.Item>
+        ) : detail ? (
-            <Descriptions.Item label="时间">{fmtTime(String(detail.createdAt))}</Descriptions.Item>
+          <RedeemRecordDetailDescriptions detail={detail} />
-          </Descriptions>
+        ) : null}
-        )}
       </Drawer>
     </div>
   );

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

@@ -376,7 +376,7 @@ type StoreRow = {
   visibilityWhitelistEnabled?: boolean;
   visibilityPhones?: string[];
   cityRef?: { name: string; code: string };
-  partner?: { companyName: string };
+  partner?: { id?: string; companyName?: string | null; name?: string | null; phone?: string | null };
   account?: {
     phone: string;
     name: string;
@@ -394,13 +394,14 @@ type StoreRow = {
   category?: { id: string; name: string; parentId?: string | null } | null;
 };
 
-type PartnerOption = { id: string; companyName: string; name?: string };
+type PartnerOption = { id: string; companyName?: string | null; name?: string | null; phone?: string | null };
 
 function partnerOptionLabel(p: PartnerOption): string {
   const company = (p.companyName || '').trim();
   const person = (p.name || '').trim();
+  const phone = (p.phone || '').trim();
   if (company && person) return `${company}-${person}`;
-  return company || person || p.id;
+  return company || person || phone || p.id;
 }
 type CityOption = {
   id: string;
@@ -867,7 +868,13 @@ export default function StoresPage() {
         );
       },
     },
-    { title: '开城合伙人', dataIndex: ['partner', 'companyName'], width: 120 },
+    {
+      title: '开城合伙人',
+      dataIndex: 'partner',
+      width: 140,
+      render: (partner: StoreRow['partner']) =>
+        partner ? partnerOptionLabel({ id: partner.id ?? '', ...partner }) : '—',
+    },
     {
       title: '可见',
       dataIndex: 'visibilityWhitelistEnabled',

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

@@ -2,8 +2,10 @@ import { useEffect, useState } from 'react';
 import {
   Button,
   Card,
+  Checkbox,
   Drawer,
   Form,
+  Image,
   Input,
   Modal,
   Radio,
@@ -28,18 +30,25 @@ import {
   DEV_PLAN_TASK_TYPE_LABELS,
   SUPPORT_TICKET_STATUS_LABELS,
   SUPPORT_TICKET_TYPE_LABELS,
+  SUPPORT_TICKET_PRIORITY_LABELS,
   mapSupportTicketTypeToDevPlanTask,
   type BatchReviewPreviewItem,
   type BatchReviewPreviewResponse,
   type DevPlanTaskTypeDto,
+  type DevPlanVersionDto,
   type SupportTicketDto,
   type SupportTicketLinkedTaskDto,
+  type SupportTicketPriorityDto,
   type SupportTicketStatusDto,
   type SupportTicketTypeDto,
 } from '@dukang/shared-types';
 import { request, type HqProfile } from '../lib/api';
 import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
+import OssUpload from '../components/OssUpload';
+
+const DISPATCH_WECOM_STORAGE_KEY = 'support_ticket_dispatch_wecom';
+const DEFAULT_DISPATCH_SUPPLEMENT = '请按以下任务进入开发流程';
 
 const STATUS_COLOR: Record<SupportTicketStatusDto, string> = {
   PENDING_REVIEW: 'orange',
@@ -47,6 +56,7 @@ const STATUS_COLOR: Record<SupportTicketStatusDto, string> = {
   DEVELOPING: 'blue',
   TESTING: 'purple',
   PASSED: 'green',
+  PUBLISHED: 'cyan',
 };
 
 const TYPE_OPTIONS = (Object.keys(SUPPORT_TICKET_TYPE_LABELS) as SupportTicketTypeDto[]).map(
@@ -57,6 +67,17 @@ const STATUS_OPTIONS = (Object.keys(SUPPORT_TICKET_STATUS_LABELS) as SupportTick
   (value) => ({ value, label: SUPPORT_TICKET_STATUS_LABELS[value] }),
 );
 
+const PRIORITY_COLOR: Record<SupportTicketPriorityDto, string> = {
+  LOW: 'default',
+  NORMAL: 'blue',
+  HIGH: 'orange',
+  URGENT: 'red',
+};
+
+const PRIORITY_OPTIONS = (Object.keys(SUPPORT_TICKET_PRIORITY_LABELS) as SupportTicketPriorityDto[]).map(
+  (value) => ({ value, label: SUPPORT_TICKET_PRIORITY_LABELS[value] }),
+);
+
 const TASK_TYPE_OPTIONS = (Object.keys(DEV_PLAN_TASK_TYPE_LABELS) as DevPlanTaskTypeDto[]).map(
   (v) => ({ value: v, label: DEV_PLAN_TASK_TYPE_LABELS[v] }),
 );
@@ -73,6 +94,7 @@ export default function SupportTicketsPage() {
       const qs = new URLSearchParams();
       if (filters.ticketType) qs.set('ticketType', filters.ticketType);
       if (filters.status) qs.set('status', filters.status);
+      if (filters.priority) qs.set('priority', filters.priority);
       return qs;
     },
     [filters],
@@ -88,15 +110,45 @@ export default function SupportTicketsPage() {
   const [batchPreviewOpen, setBatchPreviewOpen] = useState(false);
   const [batchPreview, setBatchPreview] = useState<BatchReviewPreviewItem[]>([]);
   const [batchConfirming, setBatchConfirming] = useState(false);
+  const [batchStatusOpen, setBatchStatusOpen] = useState(false);
+  const [batchStatusSaving, setBatchStatusSaving] = useState(false);
+  const [batchCreateSaving, setBatchCreateSaving] = useState(false);
+  const [batchPublishOpen, setBatchPublishOpen] = useState(false);
+  const [batchPublishSaving, setBatchPublishSaving] = useState(false);
+  const [versions, setVersions] = useState<DevPlanVersionDto[]>([]);
+  const [editOpen, setEditOpen] = useState(false);
+  const [editSaving, setEditSaving] = useState(false);
   const [reviewDecision, setReviewDecision] = useState<'APPROVE' | 'REJECT'>('APPROVE');
 
   const [createForm] = Form.useForm();
+  const [editForm] = Form.useForm();
   const [reviewForm] = Form.useForm<{ decision: 'APPROVE' | 'REJECT'; rejectReason?: string; note?: string }>();
-  const [tasksForm] = Form.useForm<{ tasks: Array<{ content: string; type: DevPlanTaskTypeDto }> }>();
+  const [tasksForm] = Form.useForm<{
+    tasks: Array<{ content: string; type: DevPlanTaskTypeDto }>;
+    dispatchToWecom?: boolean;
+    dispatchSupplement?: string;
+  }>();
   const [batchForm] = Form.useForm<{ items: BatchReviewPreviewItem[] }>();
+  const [batchStatusForm] = Form.useForm<{
+    status: SupportTicketStatusDto;
+    rejectReason?: string;
+    note?: string;
+  }>();
+  const [batchPublishForm] = Form.useForm<{
+    versionId: string;
+    dispatchToWecom?: boolean;
+    dispatchSupplement?: string;
+  }>();
 
   const isSuperAdmin = profile?.adminRole === 'SUPER_ADMIN';
 
+  useEffect(() => {
+    if (!batchPublishOpen) return;
+    request<{ items: DevPlanVersionDto[] }>('/admin/dev-plan/versions?pageSize=100')
+      .then((res) => setVersions(res.items ?? []))
+      .catch(() => setVersions([]));
+  }, [batchPublishOpen]);
+
   useEffect(() => {
     request<HqProfile>('/admin/auth/me').then(setProfile).catch(() => {});
   }, []);
@@ -117,6 +169,8 @@ export default function SupportTicketsPage() {
           title: values.title.trim(),
           content: values.content?.trim() || undefined,
           remark: values.remark?.trim() || undefined,
+          priority: values.priority,
+          attachmentUrls: (values.attachmentUrls ?? []).map((u: string) => u?.trim()).filter(Boolean),
         }),
       });
       message.success('技术支持工单已创建，等待最高管理员评审');
@@ -166,13 +220,143 @@ export default function SupportTicketsPage() {
     const summary = [detail!.title, detail!.content].filter(Boolean).join('\n').slice(0, 500);
     tasksForm.setFieldsValue({
       tasks: [{ content: summary || detail!.title, type: mapSupportTicketTypeToDevPlanTask(detail!.ticketType) }],
+      dispatchToWecom: localStorage.getItem(DISPATCH_WECOM_STORAGE_KEY) !== 'false',
+      dispatchSupplement: DEFAULT_DISPATCH_SUPPLEMENT,
     });
     setCreateTasksOpen(true);
   }
 
+  function openEdit() {
+    if (!detail) return;
+    editForm.setFieldsValue({
+      ticketType: detail.ticketType,
+      title: detail.title,
+      content: detail.content || '',
+      remark: detail.remark || '',
+      priority: detail.priority ?? 'NORMAL',
+      attachmentUrls: detail.attachmentUrls?.length ? detail.attachmentUrls : [''],
+    });
+    setEditOpen(true);
+  }
+
+  async function submitEdit() {
+    const values = await editForm.validateFields();
+    setEditSaving(true);
+    try {
+      await request(`/admin/support-tickets/${detail!.id}`, {
+        method: 'PATCH',
+        body: JSON.stringify({
+          ticketType: values.ticketType,
+          title: values.title.trim(),
+          content: values.content?.trim() || undefined,
+          remark: values.remark?.trim() || undefined,
+          priority: values.priority,
+          attachmentUrls: (values.attachmentUrls ?? []).map((u: string) => u?.trim()).filter(Boolean),
+        }),
+      });
+      message.success('已保存');
+      setEditOpen(false);
+      await openDetail(String(detail!.id));
+      reload();
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '保存失败');
+    } finally {
+      setEditSaving(false);
+    }
+  }
+
+  async function submitBatchStatus() {
+    const values = await batchStatusForm.validateFields();
+    setBatchStatusSaving(true);
+    try {
+      const res = await request<{ successCount: number; failCount: number }>(
+        '/admin/support-tickets/batch-update-status',
+        {
+          method: 'POST',
+          body: JSON.stringify({
+            ticketIds: selectedRowKeys,
+            status: values.status,
+            rejectReason: values.rejectReason?.trim() || undefined,
+            note: values.note?.trim() || undefined,
+          }),
+        },
+      );
+      message.success(`成功 ${res.successCount} 条，失败 ${res.failCount} 条`);
+      setBatchStatusOpen(false);
+      setSelectedRowKeys([]);
+      reload();
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '批量更新失败');
+    } finally {
+      setBatchStatusSaving(false);
+    }
+  }
+
+  async function submitBatchCreateTasks() {
+    if (!selectedRowKeys.length) return;
+    setBatchCreateSaving(true);
+    try {
+      const res = await request<{ successCount: number; failCount: number }>(
+        '/admin/support-tickets/batch-create-tasks',
+        {
+          method: 'POST',
+          body: JSON.stringify({ ticketIds: selectedRowKeys }),
+        },
+      );
+      message.success(`已创建 ${res.successCount} 条任务，跳过/失败 ${res.failCount} 条`);
+      setSelectedRowKeys([]);
+      reload();
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '批量创建任务失败');
+    } finally {
+      setBatchCreateSaving(false);
+    }
+  }
+
+  function openBatchPublish() {
+    batchPublishForm.setFieldsValue({
+      versionId: undefined,
+      dispatchToWecom: localStorage.getItem(DISPATCH_WECOM_STORAGE_KEY) !== 'false',
+      dispatchSupplement: DEFAULT_DISPATCH_SUPPLEMENT,
+    });
+    setBatchPublishOpen(true);
+  }
+
+  async function submitBatchPublish() {
+    const values = await batchPublishForm.validateFields();
+    localStorage.setItem(DISPATCH_WECOM_STORAGE_KEY, values.dispatchToWecom ? 'true' : 'false');
+    setBatchPublishSaving(true);
+    try {
+      const res = await request<{
+        successCount: number;
+        failCount: number;
+        linkedTaskCount: number;
+      }>('/admin/support-tickets/batch-publish', {
+        method: 'POST',
+        body: JSON.stringify({
+          ticketIds: selectedRowKeys,
+          versionId: values.versionId,
+          dispatchToWecom: !!values.dispatchToWecom,
+          dispatchSupplement: values.dispatchSupplement?.trim() || undefined,
+        }),
+      });
+      message.success(
+        `已关联 ${res.linkedTaskCount} 条任务到版本，工单成功 ${res.successCount} 条，失败 ${res.failCount} 条`,
+      );
+      setBatchPublishOpen(false);
+      setSelectedRowKeys([]);
+      reload();
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '批量发布失败');
+    } finally {
+      setBatchPublishSaving(false);
+    }
+  }
+
   async function submitCreateTasks() {
     const values = await tasksForm.validateFields();
     const note = reviewForm.getFieldValue('note') as string | undefined;
+    localStorage.setItem(DISPATCH_WECOM_STORAGE_KEY, values.dispatchToWecom ? 'true' : 'false');
     setActing(true);
     try {
       await request(`/admin/support-tickets/${detail!.id}/review`, {
@@ -181,9 +365,11 @@ export default function SupportTicketsPage() {
           decision: 'APPROVE',
           note: note?.trim() || undefined,
           tasks: values.tasks.map((t) => ({ content: t.content.trim(), type: t.type })),
+          dispatchToWecom: !!values.dispatchToWecom,
+          dispatchSupplement: values.dispatchSupplement?.trim() || undefined,
         }),
       });
-      message.success('审批通过，已创建开发任务');
+      message.success(values.dispatchToWecom ? '审批通过，已创建任务并派发企微' : '审批通过，已创建开发任务');
       setCreateTasksOpen(false);
       setDrawerOpen(false);
       reload();
@@ -283,12 +469,29 @@ export default function SupportTicketsPage() {
       width: 90,
       render: (t: SupportTicketTypeDto) => SUPPORT_TICKET_TYPE_LABELS[t] ?? t,
     },
+    {
+      title: '优先级',
+      dataIndex: 'priority',
+      width: 90,
+      render: (p: SupportTicketPriorityDto) => (
+        <Tag color={PRIORITY_COLOR[p] ?? 'default'}>
+          {SUPPORT_TICKET_PRIORITY_LABELS[p] ?? p ?? '普通'}
+        </Tag>
+      ),
+    },
     {
       title: '状态',
       dataIndex: 'status',
       width: 100,
-      render: (s: SupportTicketStatusDto) => (
+      render: (s: SupportTicketStatusDto, row) => (
-        <Tag color={STATUS_COLOR[s]}>{SUPPORT_TICKET_STATUS_LABELS[s] ?? s}</Tag>
+        <Space size={4} direction="vertical" style={{ lineHeight: 1.2 }}>
+          <Tag color={STATUS_COLOR[s]}>{SUPPORT_TICKET_STATUS_LABELS[s] ?? s}</Tag>
+          {row.releasedVersionNo ? (
+            <Typography.Text type="secondary" style={{ fontSize: 11 }}>
+              {row.releasedVersionNo}
+            </Typography.Text>
+          ) : null}
+        </Space>
       ),
     },
     { title: '标题', dataIndex: 'title', ellipsis: true },
@@ -309,9 +512,12 @@ export default function SupportTicketsPage() {
     if (!detail) return null;
     if (detail.status === 'PENDING_REVIEW' && isSuperAdmin) {
       return (
-        <Button type="primary" loading={acting} onClick={openReview}>
+        <Space>
-          审批
+          <Button onClick={openEdit}>编辑</Button>
-        </Button>
+          <Button type="primary" loading={acting} onClick={openReview}>
+            审批
+          </Button>
+        </Space>
       );
     }
     if (detail.status === 'DEVELOPING') {
@@ -346,9 +552,30 @@ export default function SupportTicketsPage() {
         </Typography.Title>
         <Space>
           {isSuperAdmin ? (
-            <Button disabled={!selectedRowKeys.length} loading={acting} onClick={() => void startBatchPreview()}>
+            <>
-              批量审核
+              <Button
-            </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)}>
             创建工单
@@ -370,6 +597,9 @@ export default function SupportTicketsPage() {
         <Form.Item name="status" label="状态">
           <Select allowClear style={{ width: 120 }} options={STATUS_OPTIONS} />
         </Form.Item>
+        <Form.Item name="priority" label="优先级">
+          <Select allowClear style={{ width: 120 }} options={PRIORITY_OPTIONS} />
+        </Form.Item>
         <Button type="primary" htmlType="submit">
           筛选
         </Button>
@@ -385,11 +615,7 @@ export default function SupportTicketsPage() {
           isSuperAdmin
             ? {
                 selectedRowKeys,
-                onChange: (keys, rows) => {
+                onChange: (keys) => setSelectedRowKeys(keys as string[]),
-                  const pending = rows.filter((r) => r.status === 'PENDING_REVIEW').map((r) => String(r.id));
-                  setSelectedRowKeys(pending.length === rows.length ? (keys as string[]) : pending);
-                },
-                getCheckboxProps: (row) => ({ disabled: row.status !== 'PENDING_REVIEW' }),
               }
             : undefined
         }
@@ -415,6 +641,9 @@ export default function SupportTicketsPage() {
                   {detail.ticketNo}
                 </Typography.Text>
                 <Tag>{SUPPORT_TICKET_TYPE_LABELS[detail.ticketType] ?? detail.ticketType}</Tag>
+                <Tag color={PRIORITY_COLOR[detail.priority ?? 'NORMAL']}>
+                  {SUPPORT_TICKET_PRIORITY_LABELS[detail.priority ?? 'NORMAL']}
+                </Tag>
               </>
             )}
           </Space>
@@ -445,6 +674,11 @@ export default function SupportTicketsPage() {
                   {detail.status === 'PASSED' && (
                     <Typography.Text type="success">此工单已测试通过</Typography.Text>
                   )}
+                  {detail.status === 'PUBLISHED' && (
+                    <Typography.Text type="success">
+                      已发布{detail.releasedVersionNo ? ` · ${detail.releasedVersionNo}` : ''}
+                    </Typography.Text>
+                  )}
                 </Space>
                 <Typography.Text type="secondary" style={{ fontSize: 12 }}>
                   创建于 {fmtTime(detail.createdAt)}
@@ -468,6 +702,7 @@ export default function SupportTicketsPage() {
                           { key: 'DEVELOPING' as SupportTicketStatusDto, label: '开发中', time: detail.reviewedAt },
                           { key: 'TESTING' as SupportTicketStatusDto, label: '测试中', time: null },
                           { key: 'PASSED' as SupportTicketStatusDto, label: '已通过', time: detail.completedAt },
+                          { key: 'PUBLISHED' as SupportTicketStatusDto, label: '已发布', time: detail.publishedAt },
                         ]
                       : [{ key: 'REJECTED' as SupportTicketStatusDto, label: '已驳回', time: detail.reviewedAt }]),
                   ];
@@ -612,6 +847,18 @@ export default function SupportTicketsPage() {
                   </div>
                 </div>
               )}
+              {detail.attachmentUrls?.length ? (
+                <div style={{ marginTop: 16 }}>
+                  <Typography.Text type="secondary" style={{ fontSize: 13 }}>
+                    附件
+                  </Typography.Text>
+                  <Space wrap style={{ marginTop: 8 }}>
+                    {detail.attachmentUrls.map((url) => (
+                      <Image key={url} src={url} width={80} height={80} style={{ objectFit: 'cover', borderRadius: 4 }} />
+                    ))}
+                  </Space>
+                </div>
+              ) : null}
             </Card>
 
             {/* 关联开发任务 */}
@@ -661,10 +908,13 @@ export default function SupportTicketsPage() {
       </Drawer>
 
       <Modal title="创建技术支持工单" open={createOpen} onCancel={() => setCreateOpen(false)} onOk={() => void submitCreate()} confirmLoading={creating} destroyOnClose okText="提交">
-        <Form form={createForm} layout="vertical" initialValues={{ ticketType: 'BUG' }}>
+        <Form form={createForm} layout="vertical" initialValues={{ ticketType: 'BUG', priority: 'NORMAL', attachmentUrls: [''] }}>
           <Form.Item name="ticketType" label="类型" rules={[{ required: true }]}>
             <Select options={TYPE_OPTIONS} />
           </Form.Item>
+          <Form.Item name="priority" label="优先级" rules={[{ required: true }]}>
+            <Select options={PRIORITY_OPTIONS} />
+          </Form.Item>
           <Form.Item name="title" label="标题" rules={[{ required: true }]}>
             <Input maxLength={128} showCount />
           </Form.Item>
@@ -674,6 +924,27 @@ export default function SupportTicketsPage() {
           <Form.Item name="remark" label="备注">
             <Input.TextArea rows={2} maxLength={512} showCount />
           </Form.Item>
+          <Form.Item label="附件图片">
+            <Form.List name="attachmentUrls">
+              {(fields, { add, remove }) => (
+                <>
+                  {fields.map((field) => (
+                    <Space key={field.key} align="start" style={{ display: 'flex', marginBottom: 8 }}>
+                      <Form.Item {...field} style={{ flex: 1, marginBottom: 0 }}>
+                        <OssUpload bizType="SUPPORT_TICKET_ATTACHMENT" mediaType="IMAGE" />
+                      </Form.Item>
+                      {fields.length > 1 ? (
+                        <MinusCircleOutlined onClick={() => remove(field.name)} style={{ marginTop: 8 }} />
+                      ) : null}
+                    </Space>
+                  ))}
+                  <Button type="dashed" onClick={() => add('')} block icon={<PlusOutlined />}>
+                    添加附件
+                  </Button>
+                </>
+              )}
+            </Form.List>
+          </Form.Item>
         </Form>
       </Modal>
 
@@ -725,6 +996,116 @@ export default function SupportTicketsPage() {
               </>
             )}
           </Form.List>
+          <Form.Item name="dispatchToWecom" valuePropName="checked" style={{ marginTop: 16 }}>
+            <Checkbox>审批通过后发送到企微开发助手</Checkbox>
+          </Form.Item>
+          <Form.Item name="dispatchSupplement" label="派发补充说明">
+            <Input.TextArea rows={2} placeholder={DEFAULT_DISPATCH_SUPPLEMENT} />
+          </Form.Item>
+        </Form>
+      </Modal>
+
+      <Modal
+        title="编辑工单"
+        open={editOpen}
+        onCancel={() => setEditOpen(false)}
+        onOk={() => void submitEdit()}
+        confirmLoading={editSaving}
+        destroyOnClose
+        width={640}
+      >
+        <Form form={editForm} layout="vertical">
+          <Form.Item name="ticketType" label="类型" rules={[{ required: true }]}>
+            <Select options={TYPE_OPTIONS} />
+          </Form.Item>
+          <Form.Item name="priority" label="优先级" rules={[{ required: true }]}>
+            <Select options={PRIORITY_OPTIONS} />
+          </Form.Item>
+          <Form.Item name="title" label="标题" rules={[{ required: true }]}>
+            <Input maxLength={128} showCount />
+          </Form.Item>
+          <Form.Item name="content" label="详细说明">
+            <Input.TextArea rows={5} maxLength={4000} showCount />
+          </Form.Item>
+          <Form.Item name="remark" label="备注">
+            <Input.TextArea rows={2} maxLength={512} showCount />
+          </Form.Item>
+          <Form.Item label="附件图片">
+            <Form.List name="attachmentUrls">
+              {(fields, { add, remove }) => (
+                <>
+                  {fields.map((field) => (
+                    <Space key={field.key} align="start" style={{ display: 'flex', marginBottom: 8 }}>
+                      <Form.Item {...field} style={{ flex: 1, marginBottom: 0 }}>
+                        <OssUpload bizType="SUPPORT_TICKET_ATTACHMENT" mediaType="IMAGE" />
+                      </Form.Item>
+                      {fields.length > 1 ? (
+                        <MinusCircleOutlined onClick={() => remove(field.name)} style={{ marginTop: 8 }} />
+                      ) : null}
+                    </Space>
+                  ))}
+                  <Button type="dashed" onClick={() => add('')} block icon={<PlusOutlined />}>
+                    添加附件
+                  </Button>
+                </>
+              )}
+            </Form.List>
+          </Form.Item>
+        </Form>
+      </Modal>
+
+      <Modal
+        title="批量改状态"
+        open={batchStatusOpen}
+        onCancel={() => setBatchStatusOpen(false)}
+        onOk={() => void submitBatchStatus()}
+        confirmLoading={batchStatusSaving}
+        destroyOnClose
+      >
+        <Typography.Paragraph type="secondary">已选 {selectedRowKeys.length} 条工单</Typography.Paragraph>
+        <Form form={batchStatusForm} layout="vertical">
+          <Form.Item name="status" label="目标状态" rules={[{ required: true }]}>
+            <Select options={STATUS_OPTIONS.filter((o) => o.value !== 'PENDING_REVIEW')} />
+          </Form.Item>
+          <Form.Item noStyle shouldUpdate={(prev, cur) => prev.status !== cur.status}>
+            {({ getFieldValue }) =>
+              getFieldValue('status') === 'REJECTED' ? (
+                <Form.Item name="rejectReason" label="驳回理由" rules={[{ required: true }]}>
+                  <Input.TextArea rows={2} maxLength={512} showCount />
+                </Form.Item>
+              ) : null
+            }
+          </Form.Item>
+          <Form.Item name="note" label="备注">
+            <Input.TextArea rows={2} maxLength={512} showCount />
+          </Form.Item>
+        </Form>
+      </Modal>
+
+      <Modal
+        title="一键发布"
+        open={batchPublishOpen}
+        onCancel={() => setBatchPublishOpen(false)}
+        onOk={() => void submitBatchPublish()}
+        confirmLoading={batchPublishSaving}
+        destroyOnClose
+      >
+        <Typography.Paragraph type="secondary">
+          已选 {selectedRowKeys.length} 条工单。将把各工单关联的开发任务追加到所选版本；无任务的工单将跳过。
+        </Typography.Paragraph>
+        <Form form={batchPublishForm} layout="vertical">
+          <Form.Item name="versionId" label="开发版本" rules={[{ required: true, message: '请选择开发版本' }]}>
+            <Select
+              placeholder="选择版本"
+              options={versions.map((v) => ({ value: v.id, label: v.versionNo }))}
+            />
+          </Form.Item>
+          <Form.Item name="dispatchToWecom" valuePropName="checked">
+            <Checkbox>同时发送到企微开发助手</Checkbox>
+          </Form.Item>
+          <Form.Item name="dispatchSupplement" label="派发补充说明">
+            <Input.TextArea rows={2} placeholder={DEFAULT_DISPATCH_SUPPLEMENT} />
+          </Form.Item>
         </Form>
       </Modal>
 

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

@@ -10,11 +10,18 @@ import {
   Select,
   Space,
   Table,
+  Tag,
   Typography,
   message,
 } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
-import { TICKET_TYPE_LABELS, type TicketTypeDto } from '@dukang/shared-types';
+import {
+  TICKET_STATUS_LABELS,
+  TICKET_TYPE_LABELS,
+  ticketStatusLabel,
+  type TicketStatusDto,
+  type TicketTypeDto,
+} from '@dukang/shared-types';
 import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
 import { useAdminList } from '../lib/useAdminList';
@@ -31,6 +38,21 @@ type Row = {
   createdAt: string;
 };
 
+const STATUS_COLOR: Partial<Record<TicketStatusDto, string>> = {
+  PENDING: 'orange',
+  OPEN: 'blue',
+  COLLABORATING: 'cyan',
+  RESOLVED: 'green',
+  REJECTED: 'red',
+  COMPLETED: 'green',
+  CLOSED: 'default',
+};
+
+const STATUS_OPTIONS = (Object.keys(TICKET_STATUS_LABELS) as TicketStatusDto[]).map((value) => ({
+  value,
+  label: TICKET_STATUS_LABELS[value],
+}));
+
 export default function TicketsPage() {
   const [filters, setFilters] = useState<Record<string, string>>({});
   const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList<Row>(
@@ -101,7 +123,14 @@ export default function TicketsPage() {
       width: 110,
       render: (t: TicketTypeDto) => TICKET_TYPE_LABELS[t] ?? t,
     },
-    { title: '状态', dataIndex: 'status', width: 90 },
+    {
+      title: '状态',
+      dataIndex: 'status',
+      width: 100,
+      render: (s: string) => (
+        <Tag color={STATUS_COLOR[s as TicketStatusDto] ?? 'default'}>{ticketStatusLabel(s)}</Tag>
+      ),
+    },
     { title: '关联', width: 140, render: (_, r) => `${r.refType}#${r.refId}` },
     { title: '备注', dataIndex: 'remark', ellipsis: true },
     { title: '时间', dataIndex: 'createdAt', width: 160, render: fmtTime },
@@ -165,7 +194,7 @@ export default function TicketsPage() {
           />
         </Form.Item>
         <Form.Item name="status" label="状态">
-          <Input allowClear placeholder="PENDING" />
+          <Select allowClear style={{ width: 140 }} placeholder="全部" options={STATUS_OPTIONS} />
         </Form.Item>
         <Button type="primary" htmlType="submit">
           筛选
@@ -212,7 +241,11 @@ export default function TicketsPage() {
             <Descriptions.Item label="类型">
               {TICKET_TYPE_LABELS[detail.ticketType] ?? detail.ticketType}
             </Descriptions.Item>
-            <Descriptions.Item label="状态">{String(detail.status)}</Descriptions.Item>
+            <Descriptions.Item label="状态">
+              <Tag color={STATUS_COLOR[detail.status as TicketStatusDto] ?? 'default'}>
+                {ticketStatusLabel(detail.status)}
+              </Tag>
+            </Descriptions.Item>
             <Descriptions.Item label="关联">
               {String(detail.refType)} #{String(detail.refId)}
             </Descriptions.Item>

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

@@ -258,7 +258,7 @@ export default function WineryBillsPage() {
             酒厂对账单
           </Typography.Title>
           <Typography.Text type="secondary">
-            每日 8:00 汇总昨日已付订单（实付 × {ratePct}%）；未打款红色、已打款绿色，可展开订单明细
+            T+3：每日 8:00 汇总 3 天前（自然日）已完成的同城/跨城订单（实付 × {ratePct}%）；未打款红色、已打款绿色，可展开订单明细
           </Typography.Text>
         </Space>
         {canEditWineryBank ? (

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

@@ -24,6 +24,7 @@ import {
 import { request } from '../../lib/api';
 import { fmtTime } from '../../lib/constants';
 import type { PromoCodeDetailContext } from './PromoCodeDetailLayout';
+import PromoCodeMetricsPanel from './PromoCodeMetricsPanel';
 
 const descLabelStyle: CSSProperties = {
   whiteSpace: 'nowrap',
@@ -212,6 +213,14 @@ export default function PromoCodeDetailPage() {
             <Statistic title="扫码进入次数" value={stats?.scanCount ?? detail.scanCount} />
           </Card>
         </Col>
+        <Col xs={12} sm={6}>
+          <Card size="small">
+            <Statistic
+              title="归因用户数"
+              value={stats?.attributionCount ?? 0}
+            />
+          </Card>
+        </Col>
         <Col xs={12} sm={6}>
           <Card size="small">
             <Statistic
@@ -235,6 +244,8 @@ export default function PromoCodeDetailPage() {
         </Col>
       </Row>
 
+      <PromoCodeMetricsPanel promoId={detail.id} />
+
       <Modal
         title="编辑推广码"
         open={editOpen}

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

@@ -0,0 +1,258 @@
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import {
+  Card,
+  DatePicker,
+  Radio,
+  Select,
+  Space,
+  Table,
+  Typography,
+  message,
+} from 'antd';
+import type { ColumnsType } from 'antd/es/table';
+import dayjs, { type Dayjs } from 'dayjs';
+import ReactECharts from 'echarts-for-react';
+import type { EChartsOption } from 'echarts';
+import {
+  PROMO_METRIC_EVENT_LABELS,
+  type PromoMetricEventItem,
+  type PromoMetricEventType,
+  type PromoMetricTimelineDto,
+} from '@dukang/shared-types';
+import { request, type Paginated } from '../../lib/api';
+import { fmtTime } from '../../lib/constants';
+
+type Props = {
+  promoId: string;
+};
+
+const SERIES = [
+  { key: 'scan', name: '扫码进入', color: '#1677ff' },
+  { key: 'attribution', name: '归因用户', color: '#52c41a' },
+  { key: 'register', name: '扫码注册', color: '#faad14' },
+  { key: 'order', name: '订单', color: '#eb2f96' },
+] as const;
+
+function buildTimelineQs(promoId: string, range: [Dayjs, Dayjs], granularity: 'day' | 'hour') {
+  const qs = new URLSearchParams();
+  qs.set('dateFrom', range[0].format('YYYY-MM-DD'));
+  qs.set('dateTo', range[1].format('YYYY-MM-DD'));
+  qs.set('granularity', granularity);
+  return `/admin/promo-codes/${promoId}/metrics/timeline?${qs.toString()}`;
+}
+
+function buildEventsQs(
+  promoId: string,
+  page: number,
+  pageSize: number,
+  range: [Dayjs, Dayjs],
+  eventType?: PromoMetricEventType,
+) {
+  const qs = new URLSearchParams();
+  qs.set('page', String(page));
+  qs.set('pageSize', String(pageSize));
+  qs.set('dateFrom', range[0].format('YYYY-MM-DD'));
+  qs.set('dateTo', range[1].format('YYYY-MM-DD'));
+  if (eventType) qs.set('eventType', eventType);
+  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 formatLocation(row: PromoMetricEventItem): string {
+  const parts = [row.ipProvince, row.ipCity].filter(Boolean);
+  if (parts.length) return parts.join(' ');
+  return '—';
+}
+
+export default function PromoCodeMetricsPanel({ promoId }: Props) {
+  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 [eventsPage, setEventsPage] = useState(1);
+  const [events, setEvents] = useState<Paginated<PromoMetricEventItem> | null>(null);
+  const [eventsLoading, setEventsLoading] = useState(false);
+
+  const loadTimeline = useCallback(() => {
+    setTimelineLoading(true);
+    return request<PromoMetricTimelineDto>(buildTimelineQs(promoId, range, granularity))
+      .then(setTimeline)
+      .catch((e) => {
+        message.error(e instanceof Error ? e.message : '加载趋势失败');
+        setTimeline(null);
+      })
+      .finally(() => setTimelineLoading(false));
+  }, [promoId, range, granularity]);
+
+  const loadEvents = useCallback(() => {
+    setEventsLoading(true);
+    return request<Paginated<PromoMetricEventItem>>(
+      buildEventsQs(promoId, eventsPage, 20, range, eventType),
+    )
+      .then(setEvents)
+      .catch((e) => {
+        message.error(e instanceof Error ? e.message : '加载事件失败');
+        setEvents(null);
+      })
+      .finally(() => setEventsLoading(false));
+  }, [promoId, eventsPage, range, eventType]);
+
+  useEffect(() => {
+    void loadTimeline();
+  }, [loadTimeline]);
+
+  useEffect(() => {
+    void loadEvents();
+  }, [loadEvents]);
+
+  const chartOption = useMemo<EChartsOption>(() => {
+    const buckets = timeline?.buckets ?? [];
+    const xData = buckets.map((b) => b.key);
+
+    return {
+      tooltip: { trigger: 'axis' },
+      legend: { data: SERIES.map((s) => s.name), bottom: 0 },
+      grid: { left: 48, right: 24, top: 24, bottom: 48 },
+      xAxis: {
+        type: 'category',
+        data: xData,
+        axisLabel: {
+          rotate: granularity === 'hour' ? 45 : 0,
+          formatter: (v: string) => (granularity === 'hour' ? v.slice(5, 16) : v.slice(5)),
+        },
+      },
+      yAxis: { type: 'value', minInterval: 1 },
+      series: SERIES.map((s) => ({
+        name: s.name,
+        type: 'line',
+        smooth: true,
+        data: buckets.map((b) => b[s.key]),
+        itemStyle: { color: s.color },
+        markPoint: {
+          symbol: 'pin',
+          symbolSize: 42,
+          data: (() => {
+            const peak = timeline?.peak[s.key];
+            if (!peak || peak.count <= 0) return [];
+            return [{ name: '高峰', coord: [peak.key, peak.count], value: peak.count }];
+          })(),
+        },
+      })),
+    };
+  }, [timeline, granularity]);
+
+  const columns: ColumnsType<PromoMetricEventItem> = [
+    {
+      title: '时间',
+      dataIndex: 'createdAt',
+      width: 168,
+      render: (v: string) => fmtTime(v),
+    },
+    {
+      title: '类型',
+      dataIndex: 'eventType',
+      width: 108,
+      render: (v: PromoMetricEventType) => PROMO_METRIC_EVENT_LABELS[v],
+    },
+    {
+      title: 'ID',
+      key: 'ref',
+      render: (_, row) => formatRefId(row),
+    },
+    {
+      title: 'IP',
+      dataIndex: 'clientIp',
+      width: 128,
+      render: (v: string | null) => v ?? '—',
+    },
+    {
+      title: '地点',
+      key: 'location',
+      width: 120,
+      render: (_, row) => formatLocation(row),
+    },
+  ];
+
+  return (
+    <Card
+      title="数据趋势"
+      style={{ marginTop: 16 }}
+      extra={
+        <Typography.Text type="secondary" style={{ fontSize: 12 }}>
+          仅统计功能上线后的新事件
+        </Typography.Text>
+      }
+    >
+      <Space wrap style={{ marginBottom: 16 }}>
+        <DatePicker.RangePicker
+          value={range}
+          onChange={(v) => {
+            if (v?.[0] && v[1]) {
+              setRange([v[0], v[1]]);
+              setEventsPage(1);
+            }
+          }}
+          allowClear={false}
+        />
+        <Radio.Group
+          value={granularity}
+          onChange={(e) => setGranularity(e.target.value as 'day' | 'hour')}
+          optionType="button"
+          buttonStyle="solid"
+          options={[
+            { label: '按日', value: 'day' },
+            { label: '按时', value: 'hour' },
+          ]}
+        />
+      </Space>
+
+      <ReactECharts
+        option={chartOption}
+        style={{ height: 360 }}
+        showLoading={timelineLoading}
+        notMerge
+      />
+
+      <Typography.Title level={5} style={{ marginTop: 24, marginBottom: 12 }}>
+        事件日志
+      </Typography.Title>
+      <Space wrap style={{ marginBottom: 12 }}>
+        <Select
+          allowClear
+          placeholder="全部类型"
+          style={{ width: 160 }}
+          value={eventType}
+          onChange={(v) => {
+            setEventType(v);
+            setEventsPage(1);
+          }}
+          options={Object.entries(PROMO_METRIC_EVENT_LABELS).map(([value, label]) => ({
+            value,
+            label,
+          }))}
+        />
+      </Space>
+      <Table
+        rowKey="id"
+        size="small"
+        columns={columns}
+        dataSource={events?.items ?? []}
+        loading={eventsLoading}
+        pagination={{
+          current: eventsPage,
+          pageSize: events?.pageSize ?? 20,
+          total: events?.total ?? 0,
+          showSizeChanger: false,
+          onChange: (p) => setEventsPage(p),
+        }}
+      />
+    </Card>
+  );
+}

apps/h5-partner/src/components/OssUploadField.tsx

@@ -19,8 +19,6 @@ type OssUploadFieldProps = {
   onWechatReadyChange?: (ready: boolean) => void;
 };
 
-const DEFAULT_MAX_MB = 10;
-
 function isCancelError(msg: string): boolean {
   return /cancel|取消/i.test(msg);
 }
@@ -79,10 +77,6 @@ export default function OssUploadField({
       showUploadError('图片读取失败，请重新选择');
       return;
     }
-    if (file.size > DEFAULT_MAX_MB * 1024 * 1024) {
-      showUploadError(`文件不能超过 ${DEFAULT_MAX_MB}MB`);
-      return;
-    }
     const result = await uploadFileToOss(file, { bizType, mediaType });
     onChange?.(result.url);
   }

apps/h5-partner/src/components/StorePackagesForm.tsx

@@ -2,6 +2,7 @@ import { useState } from 'react';
 import type { PackageFormItem } from '../lib/storePackages';
 import { STORE_PACKAGE_MAX_COUNT } from '@dukang/shared-types';
 import { emptyPackage } from '../lib/storePackages';
+import OssUploadField from './OssUploadField';
 
 type Props = {
   items: PackageFormItem[];
@@ -129,6 +130,16 @@ export default function StorePackagesForm({ items, onChange, disabled, embedded
                   </div>
                 </div>
 
+                <div className="partner-field">
+                  <label>套餐图片</label>
+                  <OssUploadField
+                    bizType="STORE_PACKAGE"
+                    value={item.imageUrl || ''}
+                    disabled={disabled}
+                    onChange={(url) => updateAt(index, { imageUrl: url })}
+                  />
+                </div>
+
                 <div className="partner-field">
                   <label>其他说明</label>
                   <div className="partner-field-input">

apps/h5-partner/src/lib/api.ts

@@ -1,4 +1,5 @@
 import type { PartnerMe, PartnerStaffRole } from '@dukang/shared-types';
+import { reportApiError } from '@dukang/client-logging';
 import { isOnAppPath, toAppPath } from '@dukang/weixin-sdk';
 import { showPartnerToast } from './toast';
 
@@ -159,6 +160,12 @@ async function rawRequest<T>(
   if (json.code !== 0) {
     const err = new Error(json.message || '请求失败') as Error & { status?: number };
     err.status = json.code === 401 ? 401 : json.code;
+    if (json.code === 400) {
+      reportApiError(
+        { apiBase, clientApp: CLIENT_APP, getToken: () => localStorage.getItem(ACCESS_TOKEN) },
+        { message: json.message || '请求失败', status: 400, url: path, category: 'validation_error' },
+      );
+    }
     throw err;
   }
   return json.data as T;

apps/h5-partner/src/lib/storePackages.ts

@@ -10,6 +10,7 @@ export function emptyPackage(index = 0): PackageFormItem {
     dishes: '',
     usableTime: '',
     otherNotes: '',
+    imageUrl: '',
     sortOrder: index,
   };
 }
@@ -22,9 +23,13 @@ export function normalizePackageFormItems(raw: PackageFormItem[]): PackageFormIt
       dishes: item.dishes.trim(),
       usableTime: item.usableTime?.trim() || '',
       otherNotes: item.otherNotes?.trim() || '',
+      imageUrl: item.imageUrl?.trim() || '',
       sortOrder: index,
     }))
-    .filter((item) => item.name || item.price || item.dishes || item.usableTime || item.otherNotes);
+    .filter(
+      (item) =>
+        item.name || item.price || item.dishes || item.usableTime || item.otherNotes || item.imageUrl,
+    );
 }
 
 export function validatePackageFormItems(items: PackageFormItem[]): string | null {

apps/h5-partner/src/lib/upload.ts

@@ -1,4 +1,9 @@
 import { apiBase, request } from './api';
+import {
+  compressImageFileIfNeeded,
+  DEFAULT_OSS_MAX_UPLOAD_BYTES,
+  formatOssMaxSizeMb,
+} from '@dukang/shared-ui/compressImage';
 
 const UPLOAD_TIMEOUT_MS = 120_000;
 
@@ -11,13 +16,23 @@ export type UploadFileResult = {
   mock: boolean;
 };
 
+async function prepareUploadFile(file: File, mediaType: OssMediaType): Promise<File> {
+  if (mediaType !== 'IMAGE') return file;
+  const compressed = await compressImageFileIfNeeded(file);
+  if (compressed.size > DEFAULT_OSS_MAX_UPLOAD_BYTES) {
+    throw new Error(`图片压缩后仍超过 ${formatOssMaxSizeMb()}MB，请换一张较小的图片`);
+  }
+  return compressed;
+}
+
 async function uploadFileToOssInner(
   file: File,
   options: { bizType: string; mediaType?: OssMediaType },
 ): Promise<UploadFileResult> {
   const mediaType = options.mediaType ?? (file.type.startsWith('video/') ? 'VIDEO' : 'IMAGE');
+  const prepared = await prepareUploadFile(file, mediaType);
   const formData = new FormData();
-  formData.append('file', file);
+  formData.append('file', prepared);
   formData.append('bizType', options.bizType);
   formData.append('mediaType', mediaType);
 

apps/h5-partner/src/lib/wechat-auth.ts

@@ -48,6 +48,19 @@ export async function canPartnerUseWechatLogin(options: {
   }
 }
 
+/** 短信登录/发码前：校验手机号对应合伙人存在且未暂停 */
+export async function checkPartnerPhoneForLogin(phone: string): Promise<PartnerPhoneCheckResponse> {
+  const normalized = phone.trim();
+  if (!/^1\d{10}$/.test(normalized)) {
+    throw new Error('请输入正确的手机号');
+  }
+  return request<PartnerPhoneCheckResponse>('PARTNER_H5', '/partner/auth/phone/check', {
+    method: 'POST',
+    body: JSON.stringify({ phone: normalized }),
+    silent: true,
+  });
+}
+
 export async function fetchClientConfig(): Promise<ClientRuntimeConfig> {
   return request<ClientRuntimeConfig>('PARTNER_H5', '/common/client-config');
 }

apps/h5-partner/src/pages/LoginPage.tsx

@@ -12,8 +12,10 @@ import {
 } from '../lib/api';
 import { usePartnerSession } from '../contexts/PartnerSessionContext';
 import { partnerHomePath } from '../lib/partnerAccess';
+import type { PartnerPhoneCheckResponse } from '@dukang/shared-types';
 import {
   bindPartnerWechatAfterSmsLogin,
+  checkPartnerPhoneForLogin,
   fetchClientConfig,
   loginPartnerWithWechat,
 } from '../lib/wechat-auth';
@@ -69,14 +71,17 @@ function formatPartnerError(e: unknown): string {
   if (text.includes('合伙人账号不存在') || text.includes('未找到合伙人账号')) {
     return '未找到合伙人账号';
   }
-  if (text.includes('合伙人账号已停用')) {
+  if (text.includes('合伙人账号已停用') || text.includes('账号已停用')) {
-    return '合伙人账号已停用';
+    return '合伙人账号已暂停，无法登录';
   }
   return text;
 }
 
 function formatWechatError(e: unknown): string {
   const text = e instanceof Error ? e.message : '微信登录失败';
+  if (text.includes('合伙人账号已停用') || text.includes('账号已停用')) {
+    return '合伙人账号已暂停，无法登录';
+  }
   if (text.includes('首次登录') || text.includes('手机验证码')) {
     return '该微信尚未绑定合伙人账号，请先使用手机验证码登录，登录后将自动关联微信';
   }
@@ -138,11 +143,21 @@ export default function LoginPage() {
 
   async function sendCode() {
     if (!ensureAgreed()) return;
+    const trimmedPhone = phone.trim();
+    if (!trimmedPhone) {
+      setMsg('请输入手机号');
+      return;
+    }
+    if (!/^1\d{10}$/.test(trimmedPhone)) {
+      setMsg('请输入正确的手机号');
+      return;
+    }
     setMsg('');
     try {
+      await checkPartnerPhoneForLogin(trimmedPhone);
       await request('PARTNER_H5', '/partner/auth/sms/send', {
         method: 'POST',
-        body: JSON.stringify({ phone, scene: 'PARTNER_LOGIN' }),
+        body: JSON.stringify({ phone: trimmedPhone, scene: 'PARTNER_LOGIN' }),
         silent: true,
       });
       setMsg('验证码已发送');
@@ -168,12 +183,27 @@ export default function LoginPage() {
 
   async function login() {
     if (!ensureAgreed()) return;
+    const trimmedPhone = phone.trim();
+    const trimmedCode = code.trim();
+    if (!trimmedPhone) {
+      setMsg('请输入手机号');
+      return;
+    }
+    if (!/^1\d{10}$/.test(trimmedPhone)) {
+      setMsg('请输入正确的手机号');
+      return;
+    }
+    if (!trimmedCode) {
+      setMsg('请输入验证码');
+      return;
+    }
     setLoading(true);
     setMsg('');
     try {
+      await checkPartnerPhoneForLogin(trimmedPhone);
       const data = await request<PartnerSessionPayload>('PARTNER_H5', '/partner/auth/login/sms', {
         method: 'POST',
-        body: JSON.stringify({ phone, code }),
+        body: JSON.stringify({ phone: trimmedPhone, code: trimmedCode }),
         silent: true,
       });
       saveRememberedSession(data);

apps/h5-shop/src/components/ShopPackagesForm.tsx

@@ -1,6 +1,7 @@
-import { useState } from 'react';
+import { useRef, useState } from 'react';
 import { STORE_PACKAGE_MAX_COUNT } from '@dukang/shared-types';
 import { emptyPackage, type PackageFormItem } from '../lib/storePackages';
+import { uploadFileToOss } from '../lib/upload';
 
 type Props = {
   items: PackageFormItem[];
@@ -10,6 +11,19 @@ type Props = {
 
 export default function ShopPackagesForm({ items, onChange, disabled }: Props) {
   const [collapsed, setCollapsed] = useState<Record<number, boolean>>({});
+  const [uploadingIndex, setUploadingIndex] = useState<number | null>(null);
+  const fileRefs = useRef<Record<number, HTMLInputElement | null>>({});
+
+  async function pickPackageImage(index: number, file?: File | null) {
+    if (!file || disabled) return;
+    setUploadingIndex(index);
+    try {
+      const result = await uploadFileToOss(file, 'STORE_PACKAGE');
+      updateAt(index, { imageUrl: result.url });
+    } finally {
+      setUploadingIndex(null);
+    }
+  }
 
   function updateAt(index: number, patch: Partial<PackageFormItem>) {
     onChange(items.map((item, i) => (i === index ? { ...item, ...patch } : item)));
@@ -116,6 +130,36 @@ export default function ShopPackagesForm({ items, onChange, disabled }: Props) {
                   />
                 </label>
 
+                <label className="shop-packages-field">
+                  <span className="shop-packages-label">套餐图片</span>
+                  {item.imageUrl ? (
+                    <img
+                      src={item.imageUrl}
+                      alt=""
+                      style={{ width: '100%', maxHeight: 160, objectFit: 'cover', borderRadius: 8, marginBottom: 8 }}
+                    />
+                  ) : null}
+                  <input
+                    ref={(el) => {
+                      fileRefs.current[index] = el;
+                    }}
+                    type="file"
+                    accept="image/*"
+                    hidden
+                    disabled={disabled}
+                    onChange={(e) => void pickPackageImage(index, e.target.files?.[0])}
+                  />
+                  <button
+                    type="button"
+                    className="shop-packages-add"
+                    style={{ marginTop: 0 }}
+                    disabled={disabled || uploadingIndex === index}
+                    onClick={() => fileRefs.current[index]?.click()}
+                  >
+                    {uploadingIndex === index ? '上传中…' : item.imageUrl ? '更换图片' : '上传图片'}
+                  </button>
+                </label>
+
                 <label className="shop-packages-field">
                   <span className="shop-packages-label">其他说明</span>
                   <input

apps/h5-shop/src/contexts/StoreSessionContext.tsx

@@ -19,6 +19,7 @@ import {
 import {
   fetchClientConfig,
   handleShopWechatCallback,
+  handleShopWechatCallbackOnce,
   handleShopWechatLoginResult,
   isShopWechatUnboundError,
   SHOP_WX_NEED_PHONE_LOGIN_MSG,
@@ -79,7 +80,7 @@ export function StoreSessionProvider({ children }: { children: ReactNode }) {
           try {
             const config = await fetchClientConfig();
             if (isWxAuthorizeEnabled(config)) {
-              const result = await handleShopWechatCallback();
+              const result = await handleShopWechatCallbackOnce();
               if (result && !cancelled) {
                 const session = handleShopWechatLoginResult(result);
                 if (session) applySession(session);

apps/h5-shop/src/lib/api.ts

@@ -1,3 +1,5 @@
+import { reportApiError } from '@dukang/client-logging';
+
 export const apiBase = '/api/v1';
 const CLIENT_APP = 'SHOP_H5';
 
@@ -213,6 +215,12 @@ async function rawRequest<T>(
   if (json.code !== 0) {
     const err = new Error(json.message || '请求失败') as Error & { status?: number };
     err.status = res.status >= 500 ? res.status : json.code;
+    if (json.code === 400) {
+      reportApiError(
+        { apiBase, clientApp: CLIENT_APP, getToken: () => localStorage.getItem(ACCESS_TOKEN) },
+        { message: json.message || '请求失败', status: 400, url: path, category: 'validation_error' },
+      );
+    }
     throw err;
   }
   return json.data as T;

apps/h5-shop/src/lib/shop-scan-auth.ts

@@ -0,0 +1,33 @@
+import { isIosDevice } from '@dukang/weixin-sdk';
+
+/** 扫码前发起 OAuth 时标记，回跳后在首页续扫 */
+export const SHOP_PENDING_SCAN_KEY = 'shop_pending_scan';
+
+export function markPendingScanAfterAuth(): void {
+  try {
+    sessionStorage.setItem(SHOP_PENDING_SCAN_KEY, '1');
+  } catch {
+    /* ignore */
+  }
+}
+
+export function peekPendingScanAfterAuth(): boolean {
+  try {
+    return sessionStorage.getItem(SHOP_PENDING_SCAN_KEY) === '1';
+  } catch {
+    return false;
+  }
+}
+
+export function clearPendingScanAfterAuth(): void {
+  try {
+    sessionStorage.removeItem(SHOP_PENDING_SCAN_KEY);
+  } catch {
+    /* ignore */
+  }
+}
+
+/** OAuth 回跳后延迟再调 scanQRCode（iOS JSSDK 离线校验更慢） */
+export function getPostAuthScanDelayMs(): number {
+  return isIosDevice() ? 1200 : 600;
+}

apps/h5-shop/src/lib/storePackages.ts

@@ -10,6 +10,7 @@ export function emptyPackage(index = 0): PackageFormItem {
     dishes: '',
     usableTime: '',
     otherNotes: '',
+    imageUrl: '',
     sortOrder: index,
   };
 }
@@ -22,9 +23,13 @@ export function normalizePackageFormItems(raw: PackageFormItem[]): PackageFormIt
       dishes: item.dishes.trim(),
       usableTime: item.usableTime?.trim() || '',
       otherNotes: item.otherNotes?.trim() || '',
+      imageUrl: item.imageUrl?.trim() || '',
       sortOrder: index,
     }))
-    .filter((item) => item.name || item.price || item.dishes || item.usableTime || item.otherNotes);
+    .filter(
+      (item) =>
+        item.name || item.price || item.dishes || item.usableTime || item.otherNotes || item.imageUrl,
+    );
 }
 
 export function validatePackageFormItems(items: PackageFormItem[]): string | null {

apps/h5-shop/src/lib/upload.ts

@@ -1,5 +1,10 @@
 import { apiBase } from './api';
 import { getStoreProfile } from './api';
+import {
+  compressImageFileIfNeeded,
+  DEFAULT_OSS_MAX_UPLOAD_BYTES,
+  formatOssMaxSizeMb,
+} from '@dukang/shared-ui/compressImage';
 
 const UPLOAD_TIMEOUT_MS = 120_000;
 
@@ -15,9 +20,13 @@ export type RegisteredResource = {
   url: string;
 };
 
-async function uploadFileToOss(file: File, bizType: string): Promise<UploadFileResult> {
+export async function uploadFileToOss(file: File, bizType: string): Promise<UploadFileResult> {
+  const compressed = await compressImageFileIfNeeded(file);
+  if (compressed.size > DEFAULT_OSS_MAX_UPLOAD_BYTES) {
+    throw new Error(`图片压缩后仍超过 ${formatOssMaxSizeMb()}MB，请换一张较小的图片`);
+  }
   const formData = new FormData();
-  formData.append('file', file);
+  formData.append('file', compressed);
   formData.append('bizType', bizType);
   formData.append('mediaType', 'IMAGE');
 

apps/h5-shop/src/lib/wechat-auth.ts

@@ -138,6 +138,20 @@ export async function handleShopWechatCallback(): Promise<WechatLoginResult | nu
   return weixinSdk.handleOAuthCallback();
 }
 
+let oauthCallbackInflight: Promise<WechatLoginResult | null> | null = null;
+
+/** 全局单例：避免 Context 与页面 effect 重复消费 OAuth code */
+export async function handleShopWechatCallbackOnce(): Promise<WechatLoginResult | null> {
+  if (!isWechatEnv()) return null;
+  const params = new URLSearchParams(window.location.search);
+  if (!params.get('code')) return null;
+  if (oauthCallbackInflight) return oauthCallbackInflight;
+  oauthCallbackInflight = handleShopWechatCallback().finally(() => {
+    oauthCallbackInflight = null;
+  });
+  return oauthCallbackInflight;
+}
+
 /**
  * 微信一键登录（已绑定微信的门店账号免验证码）。
  * 返回 session = 已登录；void = 已跳转授权页等待回调。

apps/h5-shop/src/pages/HomePage.tsx

@@ -1,285 +1,585 @@
-import { useCallback, useEffect, useState } from 'react';
+import { useCallback, useEffect, useRef, useState } from 'react';
+
 import { Link, useNavigate, useSearchParams } from 'react-router-dom';
+
 import PullToRefresh from '@dukang/shared-ui/PullToRefresh';
+
+import { isScanPermissionWarmupError } from '@dukang/weixin-sdk';
+
 import { useStoreSession } from '../contexts/StoreSessionContext';
+
 import { request } from '../lib/api';
+
 import { parseRedeemTokenFromScan } from '../lib/redeem-scan';
+
 import {
+
   authorizeShopWechat,
+
   checkNeedsWechatAuth,
+
   fetchShopAccount,
-  handleShopWechatCallback,
+
-  handleShopWechatLoginResult,
 } from '../lib/wechat-auth';
+
 import { isWechatEnv, weixinSdk } from '../lib/weixin';
-import { stripOAuthParamsFromLocation } from '@dukang/weixin-sdk';
+
+import {
+
+  clearPendingScanAfterAuth,
+
+  getPostAuthScanDelayMs,
+
+  markPendingScanAfterAuth,
+
+  peekPendingScanAfterAuth,
+
+} from '../lib/shop-scan-auth';
+
 import WechatScanAuthModal from '../components/WechatScanAuthModal';
+
 import { useStorePageView } from '../lib/usePageView';
+
 import { trackStore } from '../lib/analytics';
 
-const PENDING_SCAN_KEY = 'shop_pending_scan';
+
 
 function formatMoney(n: number) {
+
   return n.toLocaleString('zh-CN', { minimumFractionDigits: 0, maximumFractionDigits: 2 });
+
 }
 
-function formatScanError(e: unknown): string {
+
+
+function formatScanError(e: unknown, opts?: { afterAuth?: boolean }): string {
+
   const msg = e instanceof Error ? e.message : '扫码失败，请重试';
+
   if (/invalid signature/i.test(msg)) {
+
     return '微信 JSSDK 签名校验失败：请确认公众号已配置 JS 接口安全域名，并刷新页面后重试';
+
   }
-  if (/offline verifying|权限验证中|接口未就绪/i.test(msg)) {
+
+  if (isScanPermissionWarmupError(msg)) {
+
+    if (opts?.afterAuth) {
+
+      return '微信授权已完成，扫码权限仍在准备中，请再点一次「扫码核销」';
+
+    }
+
     return '微信权限校验尚未完成，请等待 1～2 秒后再次点击扫码（首次绑定微信时较常见）';
+
   }
+
   return msg;
+
 }
 
+
+
 export default function HomePage() {
+
   useStorePageView('store_home_view');
+
   const navigate = useNavigate();
-  const { applySession } = useStoreSession();
+
-  const [searchParams, setSearchParams] = useSearchParams();
+  const { ready, authenticated } = useStoreSession();
+
+  const [searchParams] = useSearchParams();
+
   const [dash, setDash] = useState<Record<string, unknown> | null>(null);
+
   const [scanMsg, setScanMsg] = useState('');
+
   const [scanning, setScanning] = useState(false);
+
   const [authModalOpen, setAuthModalOpen] = useState(false);
+
   const [authLoading, setAuthLoading] = useState(false);
+
   const [authError, setAuthError] = useState('');
 
+  const pendingScanStartedRef = useRef(false);
+
+
+
   const loadDashboard = useCallback(() => {
+
     return request<Record<string, unknown>>('SHOP_H5', '/shop/dashboard')
+
       .then((d) => {
+
         setDash(d);
+
       })
+
       .catch(() => {});
+
   }, []);
 
+
+
   useEffect(() => {
+
     void loadDashboard();
+
   }, [loadDashboard]);
 
+
+
   useEffect(() => {
+
     function onResume() {
+
       setScanning(false);
+
       void loadDashboard();
+
     }
+
     function onVisibility() {
+
       if (document.visibilityState === 'visible') onResume();
+
     }
+
     document.addEventListener('visibilitychange', onVisibility);
+
     window.addEventListener('pageshow', onResume);
+
     window.addEventListener('focus', onResume);
+
     return () => {
+
       document.removeEventListener('visibilitychange', onVisibility);
+
       window.removeEventListener('pageshow', onResume);
+
       window.removeEventListener('focus', onResume);
+
     };
+
   }, [loadDashboard]);
 
-  async function runScan(opts?: { postAuthWarmup?: boolean }) {
+
-    trackStore('store_redeem_scan_start');
+
-    if (!isWechatEnv()) {
+  const runScan = useCallback(
-      setScanMsg('请在微信内打开门店端进行扫码核销');
+
-      return;
+    async (opts?: { postAuthWarmup?: boolean }) => {
-    }
+
-    setScanning(true);
+      trackStore('store_redeem_scan_start');
-    setScanMsg('');
+
-    try {
+      if (!isWechatEnv()) {
-      // 授权回跳后强制重签，避免沿用带 code 的旧签名态
+
-      if (opts?.postAuthWarmup) {
+        setScanMsg('请在微信内打开门店端进行扫码核销');
-        weixinSdk.reset();
+
-      }
-      await weixinSdk.init();
-      const raw = await weixinSdk.scanQrCode(
-        opts?.postAuthWarmup ? { postAuthWarmup: true } : undefined,
-      );
-      if (!raw) {
-        void loadDashboard();
         return;
+
       }
-      const token = parseRedeemTokenFromScan(raw);
+
-      if (!token) {
+      setScanning(true);
-        setScanMsg('无法识别核销码，请扫描用户出示的核销二维码');
+
-        return;
+      if (!opts?.postAuthWarmup) {
+
+        setScanMsg('');
+
       }
-      navigate(`/redeem?token=${encodeURIComponent(token)}`);
+
-    } catch (e) {
+      try {
-      setScanMsg(formatScanError(e));
+
-    } finally {
+        if (opts?.postAuthWarmup) {
-      setScanning(false);
+
-    }
+          weixinSdk.reset();
-  }
+
+        }
+
+        await weixinSdk.init();
+
+        const raw = await weixinSdk.scanQrCode(
+
+          opts?.postAuthWarmup ? { postAuthWarmup: true } : undefined,
+
+        );
+
+        if (!raw) {
+
+          void loadDashboard();
+
+          return;
+
+        }
+
+        const token = parseRedeemTokenFromScan(raw);
+
+        if (!token) {
+
+          setScanMsg('无法识别核销码，请扫描用户出示的核销二维码');
+
+          return;
+
+        }
+
+        navigate(`/redeem?token=${encodeURIComponent(token)}`);
+
+      } catch (e) {
+
+        setScanMsg(formatScanError(e, { afterAuth: opts?.postAuthWarmup }));
+
+      } finally {
+
+        setScanning(false);
+
+      }
+
+    },
+
+    [loadDashboard, navigate],
+
+  );
+
+
+
+  // OAuth 由 StoreSessionContext 单例处理；此处仅在授权完成后续扫
 
   useEffect(() => {
-    if (!isWechatEnv() || !searchParams.get('code')) return;
+
-    void handleShopWechatCallback()
+    if (!ready || !authenticated || !isWechatEnv()) return;
-      .then((result) => {
+
-        if (!result) return;
+    if (searchParams.get('code')) return;
-        const session = handleShopWechatLoginResult(result);
+
-        if (session) {
+    if (!peekPendingScanAfterAuth() || pendingScanStartedRef.current) return;
-          applySession(session);
+
-        }
+
-        setAuthModalOpen(false);
+
-        setAuthError('');
+    pendingScanStartedRef.current = true;
-        // 先清 OAuth 参数再扫，保证 JSSDK 签名 URL 与当前页一致
+
-        stripOAuthParamsFromLocation();
+    clearPendingScanAfterAuth();
-        setSearchParams({}, { replace: true });
+
-        const shouldScan = sessionStorage.getItem(PENDING_SCAN_KEY) === '1';
+    setAuthModalOpen(false);
-        sessionStorage.removeItem(PENDING_SCAN_KEY);
+
-        if (shouldScan) {
+    setAuthLoading(false);
-          // OAuth 回跳后微信权限离线校验未完成；稍候再扫，失败可再点一次
+
-          window.setTimeout(() => void runScan({ postAuthWarmup: true }), 400);
+    setAuthError('');
-        }
+
-      })
+    setScanMsg('微信授权成功，正在准备扫码…');
-      .catch((e) => {
+
-        setAuthError(e instanceof Error ? e.message : '微信授权失败');
+
-      });
+
-  }, [searchParams, applySession, setSearchParams]);
+    const timer = window.setTimeout(() => {
+
+      void runScan({ postAuthWarmup: true });
+
+    }, getPostAuthScanDelayMs());
+
+
+
+    return () => window.clearTimeout(timer);
+
+  }, [ready, authenticated, searchParams, runScan]);
+
+
 
   async function handleScan() {
+
     setScanMsg('');
+
     if (!isWechatEnv()) {
+
       setScanMsg('请在微信内打开门店端进行扫码核销');
+
       return;
+
     }
+
     try {
+
       const profile = await fetchShopAccount();
+
       if (await checkNeedsWechatAuth(profile)) {
+
+        pendingScanStartedRef.current = false;
+
         setAuthModalOpen(true);
+
         return;
+
       }
+
       await runScan();
+
     } catch (e) {
+
       setScanMsg(e instanceof Error ? e.message : '无法发起扫码');
+
     }
+
   }
 
+
+
   async function startWechatAuth() {
+
     setAuthLoading(true);
+
     setAuthError('');
+
     try {
-      sessionStorage.setItem(PENDING_SCAN_KEY, '1');
+
+      pendingScanStartedRef.current = false;
+
+      markPendingScanAfterAuth();
+
       await authorizeShopWechat();
+
     } catch (e) {
-      sessionStorage.removeItem(PENDING_SCAN_KEY);
+
+      clearPendingScanAfterAuth();
+
       setAuthError(e instanceof Error ? e.message : '微信授权失败');
+
       setAuthLoading(false);
+
     }
+
   }
 
+
+
   const store = dash?.store as Record<string, unknown> | undefined;
+
   const recent = (dash?.recentRecords as Array<Record<string, unknown>>) || [];
+
   const status = String(store?.status || '');
+
   const open = status === 'OPEN';
+
   const hoursParts: string[] = [];
+
   if (store?.openTime && store?.closeTime) hoursParts.push(`${store.openTime} - ${store.closeTime}`);
+
   if (store?.openTime2 && store?.closeTime2) hoursParts.push(`${store.openTime2} - ${store.closeTime2}`);
+
   const hoursText = hoursParts.length ? hoursParts.join('，') : '10:00 - 22:00';
+
   const statusText =
+
     status === 'CLOSED' ? '永久关闭' : open ? '当前正在营业中' : '当前临时闭店';
 
+
+
   return (
+
     <PullToRefresh onRefresh={loadDashboard} className="shop-home-page">
+
       <header className="shop-home-header">
+
         <h1 className="app-page-title">门店管理中心</h1>
+
       </header>
 
+
+
       <div className="shop-home-content">
+
         <section className="shop-home-hero">
+
           <div className="shop-home-hero-store">
+
             <span className="material-symbols-outlined shop-fill-icon">store</span>
+
             <h2>{String(store?.name || '门店')}</h2>
+
           </div>
+
           <div className="shop-home-stats">
+
             <div className="shop-home-stat">
+
               <p className="shop-home-stat-label">今日核销笔数</p>
+
               <p className="shop-home-stat-value">{Number(dash?.todayCount || 0)}</p>
+
               <p className="shop-home-stat-sub">
+
                 扫码 {Number(dash?.todayScanCount || 0)} · 手机号 {Number(dash?.todayPhoneCount || 0)}
+
               </p>
+
             </div>
+
             <div className="shop-home-stat">
+
               <p className="shop-home-stat-label">今日到账金额</p>
+
               <p className="shop-home-stat-value">
+
                 <span style={{ fontSize: 18 }}>¥</span>
+
                 {formatMoney(Number(dash?.todayAmount || 0))}
+
               </p>
+
             </div>
+
           </div>
+
         </section>
 
+
+
         <section className="shop-home-scan">
+
           <button
+
             type="button"
+
             className="shop-home-scan-btn"
+
             disabled={scanning}
+
             onClick={() => void handleScan()}
+
           >
+
             <span className="material-symbols-outlined">qr_code_scanner</span>
+
           </button>
+
           <p className="shop-home-scan-label">{scanning ? '正在打开相机…' : '扫码核销'}</p>
+
           {scanMsg && <p className="shop-home-scan-msg" role="alert">{scanMsg}</p>}
+
           <Link to="/redeem/phone" className="shop-home-phone-link">
+
             <span className="material-symbols-outlined">smartphone</span>
+
             手机号核销
+
           </Link>
+
         </section>
 
+
+
         <section className="shop-home-status">
+
           <div className="shop-home-status-left">
+
             <div className={`shop-home-status-icon${open ? '' : ' closed'}`}>
+
               <span className="material-symbols-outlined shop-fill-icon">schedule</span>
+
             </div>
+
             <div>
+
               <p className="shop-home-status-title">营业状态</p>
+
               <p className="shop-home-status-sub">{statusText}</p>
+
               <p className="shop-home-status-sub">营业时间: {hoursText}</p>
+
             </div>
+
           </div>
+
           <label className="shop-home-switch" onClick={() => navigate('/status')}>
+
             <input type="checkbox" checked={open && status !== 'CLOSED'} readOnly tabIndex={-1} />
+
             <span className="shop-home-switch-track" />
+
           </label>
+
         </section>
 
+
+
         <section>
+
           <div className="shop-home-records-head">
+
             <h3 className="shop-home-records-title">核销记录</h3>
+
             <Link to="/records" className="shop-home-records-link">
+
               查看全部
+
               <span className="material-symbols-outlined" style={{ fontSize: 16 }}>chevron_right</span>
+
             </Link>
+
           </div>
+
           <div className="shop-home-record-list">
+
             {recent.length === 0 && (
+
               <p className="shop-home-status-sub" style={{ textAlign: 'center', padding: '16px 0' }}>暂无核销记录</p>
+
             )}
+
             {recent.map((r) => (
+
               <div key={String(r.id)} className="shop-home-record-item">
+
                 <div>
+
                   <p className="shop-home-record-time">核销时间</p>
+
                   <p className="shop-home-record-value">
+
                     {new Date(String(r.createdAt)).toLocaleString('zh-CN')}
+
                   </p>
+
                 </div>
+
                 <p className="shop-home-record-amount">¥{formatMoney(Number(r.amount))}</p>
+
               </div>
+
             ))}
+
           </div>
+
         </section>
+
       </div>
 
+
+
       <WechatScanAuthModal
+
         open={authModalOpen}
+
         loading={authLoading}
+
         error={authError}
+
         onAuthorize={() => void startWechatAuth()}
+
         onCancel={() => {
+
           setAuthModalOpen(false);
+
           setAuthError('');
-          sessionStorage.removeItem(PENDING_SCAN_KEY);
+
+          clearPendingScanAfterAuth();
+
+          pendingScanStartedRef.current = false;
+
         }}
+
       />
+
     </PullToRefresh>
+
   );
+
 }
+
+

apps/h5-shop/src/pages/LoginPage.tsx

@@ -18,7 +18,7 @@ import {
   consumeShopWechatLoginHint,
   fetchClientConfig,
   formatShopWechatError,
-  handleShopWechatCallback,
+  handleShopWechatCallbackOnce,
   handleShopWechatLoginResult,
   loginShopWithWechat,
 } from '../lib/wechat-auth';
@@ -88,7 +88,7 @@ export default function LoginPage() {
 
   useEffect(() => {
     if (!isWechatEnv() || !wxAuthorize || !params.get('code')) return;
-    void handleShopWechatCallback()
+    void handleShopWechatCallbackOnce()
       .then((result) => {
         if (!result) return;
         const session = handleShopWechatLoginResult(result);
@@ -140,12 +140,22 @@ export default function LoginPage() {
 
   async function login() {
     if (!ensureAgreed()) return;
+    const trimmedPhone = phone.trim();
+    const trimmedCode = code.trim();
+    if (!trimmedPhone) {
+      setMsg('phone should not be empty');
+      return;
+    }
+    if (!trimmedCode) {
+      setMsg('code should not be empty');
+      return;
+    }
     setLoading(true);
     setMsg('');
     try {
       const data = await request<ShopSessionPayload>('SHOP_H5', '/shop/auth/login/sms', {
         method: 'POST',
-        body: JSON.stringify({ phone, code }),
+        body: JSON.stringify({ phone: trimmedPhone, code: trimmedCode }),
       });
       saveRememberedSession(data);
       applySession(data);

apps/h5-shop/src/pages/MinePage.tsx

@@ -9,7 +9,7 @@ import {
   authorizeShopWechat,
   fetchClientConfig,
   fetchShopAccount,
-  handleShopWechatCallback,
+  handleShopWechatCallbackOnce,
   handleShopWechatLoginResult,
 } from '../lib/wechat-auth';
 import { isWechatEnv } from '../lib/weixin';
@@ -45,7 +45,7 @@ export default function MinePage() {
 
   useEffect(() => {
     if (!isWechatEnv() || !wxAuthorize || !searchParams.get('code')) return;
-    void handleShopWechatCallback()
+    void handleShopWechatCallbackOnce()
       .then((result) => {
         if (!result) return;
         const session = handleShopWechatLoginResult(result);

apps/h5-shop/src/pages/WithdrawPage.tsx

@@ -80,7 +80,6 @@ export default function WithdrawPage() {
   const canApply =
     !!summary?.isPrimary &&
     summary.availableAmount > 0 &&
-    !summary.hasPendingRequest &&
     summary.hasBankAccount &&
     !submitting;
 
@@ -126,7 +125,6 @@ export default function WithdrawPage() {
               info
             </span>
             单日上限 ¥{formatMoney(summary?.dailyLimit ?? 5000)}
-            {summary?.hasPendingRequest ? ' · 已有待审核申请' : ''}
             {!summary?.hasBankAccount ? ' · 请先完善收款账户' : ''}
           </p>
         </section>

apps/h5-user/src/components/ContactCustomerSheet.tsx

@@ -1,6 +1,10 @@
-import { CUSTOMER_SERVICE_PHONE } from '@dukang/shared-types';
+import { useEffect, useState } from 'react';
 import { track } from '../lib/analytics';
-import { openWecomCustomerService } from '../lib/customer-service';
+import {
+  getCustomerServicePhone,
+  loadCustomerServicePhone,
+  openWecomCustomerService,
+} from '../lib/customer-service';
 
 type ContactCustomerSheetProps = {
   orderId?: string;
@@ -9,7 +13,13 @@ type ContactCustomerSheetProps = {
 };
 
 export default function ContactCustomerSheet({ orderId, onClose }: ContactCustomerSheetProps) {
-  const tel = CUSTOMER_SERVICE_PHONE.replace(/-/g, '');
+  const [phone, setPhone] = useState(getCustomerServicePhone);
+
+  useEffect(() => {
+    void loadCustomerServicePhone().then(setPhone);
+  }, []);
+
+  const tel = phone.replace(/-/g, '');
 
   function openPhone() {
     track('cs_contact', { type: 'phone', orderId });
@@ -41,7 +51,7 @@ export default function ContactCustomerSheet({ orderId, onClose }: ContactCustom
             </div>
             <div className="contact-customer-option-body">
               <p className="contact-customer-option-title">拨打总部客服电话</p>
-              <p className="contact-customer-option-sub">{CUSTOMER_SERVICE_PHONE}</p>
+              <p className="contact-customer-option-sub">{phone}</p>
             </div>
             <span className="material-symbols-outlined contact-customer-chevron">chevron_right</span>
           </button>

apps/h5-user/src/lib/api.ts

@@ -1,3 +1,5 @@
+import { reportApiError } from '@dukang/client-logging';
+
 export const BRAND = {
   red: '#A02D30',
   yellow: '#FFC107',
@@ -83,6 +85,12 @@ async function rawRequest<T>(
   if (json.code !== 0) {
     const err = new Error(json.message || '请求失败') as Error & { status?: number };
     err.status = json.code;
+    if (json.code === 400) {
+      reportApiError(
+        { apiBase, clientApp: CLIENT_APP, getToken: () => localStorage.getItem(ACCESS_TOKEN) },
+        { message: json.message || '请求失败', status: 400, url: path, category: 'validation_error' },
+      );
+    }
     throw err;
   }
   return json.data as T;

apps/h5-user/src/lib/customer-service.ts

@@ -1,12 +1,31 @@
 import { CUSTOMER_SERVICE_PHONE, CUSTOMER_SERVICE_WECOM_URL } from '@dukang/shared-types';
+import { fetchClientConfig } from './pay-wechat';
 import { isWechatEnv } from './weixin';
 
+let cachedPhone = CUSTOMER_SERVICE_PHONE;
+
 /** 企微客服链接：优先 Vite env，否则 shared-types 默认 */
 export function getCustomerServiceWecomUrl(): string {
   const fromEnv = import.meta.env.VITE_CS_WECOM_URL?.trim();
   return fromEnv || CUSTOMER_SERVICE_WECOM_URL;
 }
 
+export function getCustomerServicePhone(): string {
+  return cachedPhone;
+}
+
+/** 从系统设置拉取客服电话（失败则保持默认常量） */
+export async function loadCustomerServicePhone(): Promise<string> {
+  try {
+    const cfg = await fetchClientConfig();
+    const phone = cfg.customerServicePhone?.trim();
+    if (phone) cachedPhone = phone;
+  } catch {
+    /* keep fallback */
+  }
+  return cachedPhone;
+}
+
 /**
  * 打开企业微信客服会话（须在微信内；需用户点击手势）。
  * @returns true 已跳转；false 非微信环境已提示
@@ -20,4 +39,5 @@ export function openWecomCustomerService(): boolean {
   return true;
 }
 
+/** @deprecated 请用 getCustomerServicePhone()，保留兼容旧引用 */
 export { CUSTOMER_SERVICE_PHONE };

apps/h5-user/src/lib/upload.ts

@@ -1,4 +1,9 @@
 import { apiBase } from './api';
+import {
+  compressImageFileIfNeeded,
+  DEFAULT_OSS_MAX_UPLOAD_BYTES,
+  formatOssMaxSizeMb,
+} from '@dukang/shared-ui/compressImage';
 
 export type OssMediaType = 'IMAGE' | 'VIDEO' | 'FILE';
 
@@ -15,8 +20,15 @@ export async function uploadFileToOss(
   options: { bizType: string; mediaType?: OssMediaType },
 ): Promise<UploadFileResult> {
   const mediaType = options.mediaType ?? (file.type.startsWith('video/') ? 'VIDEO' : 'IMAGE');
+  let prepared = file;
+  if (mediaType === 'IMAGE') {
+    prepared = await compressImageFileIfNeeded(file);
+    if (prepared.size > DEFAULT_OSS_MAX_UPLOAD_BYTES) {
+      throw new Error(`图片压缩后仍超过 ${formatOssMaxSizeMb()}MB，请换一张较小的图片`);
+    }
+  }
   const formData = new FormData();
-  formData.append('file', file);
+  formData.append('file', prepared);
   formData.append('bizType', options.bizType);
   formData.append('mediaType', mediaType);
 

apps/h5-user/src/pages/CustomerServicePage.tsx

@@ -1,11 +1,22 @@
+import { useEffect, useState } from 'react';
 import { useNavigate } from 'react-router-dom';
 import SubPageHeader from '../components/SubPageHeader';
-import { CUSTOMER_SERVICE_PHONE, openWecomCustomerService } from '../lib/customer-service';
+import {
+  getCustomerServicePhone,
+  loadCustomerServicePhone,
+  openWecomCustomerService,
+} from '../lib/customer-service';
 import { track } from '../lib/analytics';
 
 export default function CustomerServicePage() {
   const navigate = useNavigate();
-  const tel = CUSTOMER_SERVICE_PHONE.replace(/-/g, '');
+  const [phone, setPhone] = useState(getCustomerServicePhone);
+
+  useEffect(() => {
+    void loadCustomerServicePhone().then(setPhone);
+  }, []);
+
+  const tel = phone.replace(/-/g, '');
 
   function openOnline() {
     track('cs_contact', { type: 'wecom_kf' });
@@ -27,7 +38,7 @@ export default function CustomerServicePage() {
 
         <a className="customer-service-phone-link" href={`tel:${tel}`}>
           <span className="material-symbols-outlined">call</span>
-          或拨打客服电话 {CUSTOMER_SERVICE_PHONE}
+          或拨打客服电话 {phone}
         </a>
       </div>
     </div>

apps/mini-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dukang/mini-user",
-  "version": "0.1.0",
+  "version": "3.4.14",
   "private": true,
   "description": "杜康好客 · C 端用户微信小程序（Taro）",
   "scripts": {

apps/mini-user/src/app.config.ts

@@ -6,11 +6,13 @@ export default defineAppConfig({
     'pages/mine/index',
     'pages/product-detail/index',
     'pages/store-detail/index',
+    'pages/store-package-detail/index',
     'pages/order-confirm/index',
     'pages/order-confirm-pickup/index',
     'pages/pay/index',
     'pages/orders/index',
     'pages/order-detail/index',
+    'pages/order-logistics/index',
     'pages/pickup-receive/index',
     'pages/addresses/index',
     'pages/address-edit/index',

apps/mini-user/src/app.tsx

@@ -6,11 +6,13 @@ import WechatShareBootstrap from './components/WechatShareBootstrap';
 import { patchTaroH5Hooks } from './lib/patch-taro-h5-hooks';
 import { handleWechatOrderConfirmShow } from './lib/wechat-order-confirm';
 import { installClientErrorReporting } from './lib/client-error';
+import { prefetchShareBrandAssets } from './lib/wechat-share';
 import './app.css';
 
 // H5：在首屏 page hooks 执行前，把 Taro.useDidShow 等绑到与 createReactApp 同一份 runtime
 patchTaroH5Hooks();
 installClientErrorReporting();
+prefetchShareBrandAssets();
 
 function App({ children }: PropsWithChildren) {
   const handlingRef = useRef(false);

apps/mini-user/src/components/LogisticsRichText.tsx

@@ -0,0 +1,44 @@
+import { Text } from '@tarojs/components';
+import Taro from '@tarojs/taro';
+import { splitLogisticsText } from '../lib/order-logistics-utils';
+import { toast } from '../lib/api';
+
+type LogisticsRichTextProps = {
+  text: string;
+  className?: string;
+  phoneClassName?: string;
+};
+
+export default function LogisticsRichText({
+  text,
+  className = '',
+  phoneClassName = 'order-logistics-phone-link',
+}: LogisticsRichTextProps) {
+  const segments = splitLogisticsText(text);
+
+  function dial(phone: string) {
+    const normalized = phone.replace(/-/g, '');
+    Taro.makePhoneCall({ phoneNumber: normalized }).catch(() => toast('无法拨打电话'));
+  }
+
+  return (
+    <Text className={className}>
+      {segments.map((segment, index) =>
+        segment.type === 'phone' ? (
+          <Text
+            key={`${segment.value}-${index}`}
+            className={phoneClassName}
+            onClick={(e) => {
+              e.stopPropagation();
+              dial(segment.value);
+            }}
+          >
+            {segment.value}
+          </Text>
+        ) : (
+          <Text key={`${index}-text`}>{segment.value}</Text>
+        ),
+      )}
+    </Text>
+  );
+}

apps/mini-user/src/components/ProductCarousel.tsx

@@ -1,21 +1,40 @@
 import { useState } from 'react';
 import { View, Image, Swiper, SwiperItem } from '@tarojs/components';
+import Taro from '@tarojs/taro';
 
 type ProductCarouselProps = {
   images: string[];
   alt: string;
   variant?: 'home' | 'detail' | 'store';
+  previewable?: boolean;
+  /** cover=aspectFill 裁剪铺满；contain=aspectFit 缩放完整显示（门店门头固定区） */
+  imageFit?: 'cover' | 'contain';
 };
 
 /** 商品/门店轮播（对齐 h5 ProductCarousel 三变体） */
-export default function ProductCarousel({ images, alt, variant = 'detail' }: ProductCarouselProps) {
+export default function ProductCarousel({
+  images,
+  alt,
+  variant = 'detail',
+  previewable = false,
+  imageFit = 'cover',
+}: ProductCarouselProps) {
   const slides = images.length > 0 ? images : [''];
   const [activeIndex, setActiveIndex] = useState(0);
   const prefix =
     variant === 'store' ? 'store-detail-carousel' : variant === 'home' ? 'home-carousel' : 'detail-carousel';
+  const isContain = imageFit === 'contain';
+  const wrapClass = `${prefix}-wrap${isContain ? ` ${prefix}-wrap--contain` : ''}`;
+
+  function previewAt(index: number) {
+    const urls = slides.filter(Boolean);
+    if (!urls.length) return;
+    const current = slides[index] || urls[0];
+    Taro.previewImage({ current, urls }).catch(() => undefined);
+  }
 
   return (
-    <View className={`${prefix}-wrap`}>
+    <View className={wrapClass}>
       <Swiper
         className={prefix}
         circular={slides.length > 1}
@@ -24,7 +43,13 @@ export default function ProductCarousel({ images, alt, variant = 'detail' }: Pro
         {slides.map((src, index) => (
           <SwiperItem key={`${src}-${index}`} className={`${prefix}-item`}>
             {src ? (
-              <Image className={`${prefix}-image`} src={src} mode="aspectFill" alt={alt} />
+              <Image
+                className={`${prefix}-image`}
+                src={src}
+                mode={isContain ? 'aspectFit' : 'aspectFill'}
+                alt={alt}
+                onClick={previewable ? () => previewAt(index) : undefined}
+              />
             ) : (
               <View className={`${prefix}-placeholder`} />
             )}

apps/mini-user/src/components/WechatShareBootstrap.tsx

@@ -4,6 +4,7 @@ import { useEffect, useRef } from 'react';
 import { finishLoginNavigate, forceReloadAfterAccountMerge, goLogin } from '../lib/auth-nav';
 import { toast } from '../lib/api';
 import { capturePromoSceneAndTouchScan } from '../lib/promo';
+import { initClientVersionChecks } from '../lib/client-version';
 import { saveWechatLoginResult } from '../lib/pay-wechat';
 import { applyWechatShare } from '../lib/wechat-share';
 import { handleWechatAuthCallback } from '../lib/wechat-auth';
@@ -38,6 +39,7 @@ export default function WechatShareBootstrap() {
 
   useEffect(() => {
     void capturePromoSceneAndTouchScan();
+    initClientVersionChecks();
   }, []);
 
   useEffect(() => {

apps/mini-user/src/lib/api.ts

@@ -3,6 +3,7 @@ import { ClientApp } from '@dukang/shared-types';
 import { forceReloadAfterAccountMerge } from './auth-nav';
 import { resetStoresSessionBootstrap } from './stores-session';
 import { resetHomeCatalogBootstrap } from './home-catalog-session';
+import { reportClientValidationError } from './client-error';
 
 function resolveApiBase(): string {
   const origin =
@@ -113,6 +114,12 @@ export async function request<T = unknown>(path: string, options: ReqOptions = {
     throw new Error('接口不可达，请确认 API 服务已启动');
   }
   if (status >= 400 || body.code !== 0) {
+    if (status === 400 || body?.code === 400) {
+      reportClientValidationError({
+        message: body?.message || `请求失败(${status})`,
+        apiPath: path,
+      });
+    }
     throw new Error(body?.message || `请求失败(${status})`);
   }
   return (res.data as { data: T }).data;

apps/mini-user/src/lib/brand-assets.ts

@@ -0,0 +1,68 @@
+import {
+  BRAND_LOGO_MARK_URL,
+  BRAND_LOGO_URL,
+  BRAND_LOGO_WIDE_URL,
+  CUSTOMER_SERVICE_PHONE,
+  QUALIFICATION_DISCLOSURE_URL,
+  type ClientRuntimeConfig,
+} from '@dukang/shared-types';
+import { fetchClientConfig } from './pay-wechat';
+
+export type BrandAssets = {
+  brandLogoUrl: string;
+  brandLogoWideUrl: string;
+  brandLogoMarkUrl: string;
+  qualificationDisclosureUrl: string;
+  customerServicePhone: string;
+};
+
+const FALLBACK: BrandAssets = {
+  brandLogoUrl: BRAND_LOGO_URL,
+  brandLogoWideUrl: BRAND_LOGO_WIDE_URL,
+  brandLogoMarkUrl: BRAND_LOGO_MARK_URL,
+  qualificationDisclosureUrl: QUALIFICATION_DISCLOSURE_URL,
+  customerServicePhone: CUSTOMER_SERVICE_PHONE,
+};
+
+let cached: BrandAssets | null = null;
+let inflight: Promise<BrandAssets> | null = null;
+
+function fromConfig(config: ClientRuntimeConfig | null | undefined): BrandAssets {
+  return {
+    brandLogoUrl: config?.brandLogoUrl?.trim() || FALLBACK.brandLogoUrl,
+    brandLogoWideUrl: config?.brandLogoWideUrl?.trim() || FALLBACK.brandLogoWideUrl,
+    brandLogoMarkUrl: config?.brandLogoMarkUrl?.trim() || FALLBACK.brandLogoMarkUrl,
+    qualificationDisclosureUrl:
+      config?.qualificationDisclosureUrl?.trim() || FALLBACK.qualificationDisclosureUrl,
+    customerServicePhone: config?.customerServicePhone?.trim() || FALLBACK.customerServicePhone,
+  };
+}
+
+/** 同步读取最近一次缓存（未拉取前返回代码默认常量） */
+export function getBrandAssetsSync(): BrandAssets {
+  return cached ?? FALLBACK;
+}
+
+/** 拉取 /common/client-config 中的品牌与客服配置并缓存 */
+export async function loadBrandAssets(force = false): Promise<BrandAssets> {
+  if (!force && cached) return cached;
+  if (!force && inflight) return inflight;
+  inflight = fetchClientConfig()
+    .then((cfg) => {
+      cached = fromConfig(cfg);
+      return cached;
+    })
+    .catch(() => {
+      cached = FALLBACK;
+      return cached;
+    })
+    .finally(() => {
+      inflight = null;
+    });
+  return inflight;
+}
+
+export function applyBrandFromClientConfig(config: ClientRuntimeConfig | null | undefined) {
+  cached = fromConfig(config);
+  return cached;
+}

apps/mini-user/src/lib/client-error.ts

@@ -6,6 +6,7 @@ export type ClientErrorCategory =
   | 'js_error'
   | 'unhandled_rejection'
   | 'api_error'
+  | 'validation_error'
   | 'network'
   | 'render'
   | 'bridge'
@@ -57,6 +58,17 @@ export function reportClientError(payload: ClientErrorPayload): void {
   }).catch(() => {});
 }
 
+/** 上报 API 400 验证错误（失败静默） */
+export function reportClientValidationError(input: { message: string; apiPath?: string }): void {
+  if (input.apiPath?.includes('/common/client-errors')) return;
+  reportClientError({
+    level: 'warn',
+    category: 'validation_error',
+    message: input.message,
+    extra: { status: 400, url: input.apiPath },
+  });
+}
+
 let installed = false;
 
 /** 安装小程序/H5 全局未捕获错误钩子（幂等） */

apps/mini-user/src/lib/client-version.ts

@@ -0,0 +1,131 @@
+import Taro from '@tarojs/taro';
+import { fetchClientConfig } from './pay-wechat';
+
+/** 与 package.json version 同步，供服务端 minClientVersion 比对 */
+export const APP_VERSION = '3.4.14';
+
+export const APP_VERSION_LABEL = `v${APP_VERSION}`;
+
+function parseSemver(v: string): number[] {
+  return v.split('.').map((n) => parseInt(n, 10) || 0);
+}
+
+export function compareSemver(a: string, b: string): number {
+  const pa = parseSemver(a);
+  const pb = parseSemver(b);
+  const len = Math.max(pa.length, pb.length);
+  for (let i = 0; i < len; i += 1) {
+    const da = pa[i] ?? 0;
+    const db = pb[i] ?? 0;
+    if (da !== db) return da - db;
+  }
+  return 0;
+}
+
+function exitMiniProgramIfSupported() {
+  if (process.env.TARO_ENV !== 'weapp') return;
+  if (typeof Taro.exitMiniProgram !== 'function') return;
+  void Taro.exitMiniProgram({});
+}
+
+/** 微信 CDN 有新包时引导 applyUpdate；返回是否已触发更新流程 */
+function tryWeappForceUpdate(min: string): Promise<boolean> {
+  if (process.env.TARO_ENV !== 'weapp' || typeof Taro.getUpdateManager !== 'function') {
+    return Promise.resolve(false);
+  }
+
+  return new Promise((resolve) => {
+    const manager = Taro.getUpdateManager();
+    let settled = false;
+    const finish = (updated: boolean) => {
+      if (settled) return;
+      settled = true;
+      resolve(updated);
+    };
+
+    manager.onCheckForUpdate((res) => {
+      if (!res.hasUpdate) {
+        finish(false);
+        return;
+      }
+      manager.onUpdateReady(() => {
+        void Taro.showModal({
+          title: '版本过低',
+          content: `当前 ${APP_VERSION_LABEL} 低于要求版本 v${min}，已检测到新版本，请立即更新后继续使用。`,
+          showCancel: false,
+          confirmText: '立即更新',
+          success: (r) => {
+            if (r.confirm) {
+              manager.applyUpdate();
+              finish(true);
+            } else {
+              finish(false);
+            }
+          },
+          fail: () => finish(false),
+        });
+      });
+      manager.onUpdateFailed(() => finish(false));
+    });
+
+    setTimeout(() => finish(false), 4000);
+  });
+}
+
+async function enforceMinClientVersion(min: string) {
+  const updated = await tryWeappForceUpdate(min);
+  if (updated) return;
+
+  await Taro.showModal({
+    title: '版本过低',
+    content: `当前 ${APP_VERSION_LABEL} 低于要求版本 v${min}，请更新至最新版本后继续使用。`,
+    showCancel: false,
+    confirmText: '我知道了',
+  });
+
+  exitMiniProgramIfSupported();
+}
+
+export async function checkClientVersionGate() {
+  try {
+    const config = await fetchClientConfig();
+    const min = config.minClientVersion?.trim();
+    if (min && compareSemver(APP_VERSION, min) < 0) {
+      await enforceMinClientVersion(min);
+    }
+  } catch {
+    /* 配置拉取失败不阻塞启动 */
+  }
+}
+
+export function setupWeappUpdateManager() {
+  if (process.env.TARO_ENV !== 'weapp') return;
+  if (typeof Taro.getUpdateManager !== 'function') return;
+
+  const manager = Taro.getUpdateManager();
+  manager.onCheckForUpdate((res) => {
+    if (!res.hasUpdate) return;
+    manager.onUpdateReady(() => {
+      void Taro.showModal({
+        title: '更新提示',
+        content: '新版本已准备好，是否重启应用？',
+        confirmText: '立即更新',
+        success: (r) => {
+          if (r.confirm) manager.applyUpdate();
+        },
+      });
+    });
+    manager.onUpdateFailed(() => {
+      void Taro.showModal({
+        title: '更新失败',
+        content: '新版本下载失败，请删除小程序后重新搜索打开。',
+        showCancel: false,
+      });
+    });
+  });
+}
+
+export function initClientVersionChecks() {
+  setupWeappUpdateManager();
+  void checkClientVersionGate();
+}

apps/mini-user/src/lib/compress-image.ts

@@ -0,0 +1,34 @@
+import Taro from '@tarojs/taro';
+
+const MAX_BYTES = 10 * 1024 * 1024;
+
+/** 小程序临时文件超过 10MB 时用 compressImage 压缩后再上传 */
+export async function compressWeappImageIfNeeded(tempFilePath: string): Promise<string> {
+  if (process.env.TARO_ENV !== 'weapp') return tempFilePath;
+
+  let path = tempFilePath;
+  let size = await getFileSize(path);
+  if (size <= MAX_BYTES) return path;
+
+  const qualities = [80, 65, 50, 40];
+  for (const quality of qualities) {
+    const res = await Taro.compressImage({ src: path, quality });
+    path = res.tempFilePath;
+    size = await getFileSize(path);
+    if (size <= MAX_BYTES) return path;
+  }
+
+  if (size > MAX_BYTES) {
+    throw new Error('图片压缩后仍超过 10MB，请换一张较小的图片');
+  }
+  return path;
+}
+
+async function getFileSize(filePath: string): Promise<number> {
+  try {
+    const info = await Taro.getFileInfo({ filePath });
+    return typeof info.size === 'number' ? info.size : 0;
+  } catch {
+    return 0;
+  }
+}

apps/mini-user/src/lib/mini-wechat-profile.ts

@@ -69,12 +69,15 @@ export function mergeWxDisplayProfile(profile: UserProfile): UserProfile {
 /** 上传 chooseAvatar 临时文件到 OSS，并返回已登记到当前用户的真实资源。 */
 export async function uploadAvatarTempFile(tempFilePath: string): Promise<UploadedAvatarResource> {
   const { API_BASE, CLIENT_APP, getToken } = await import('./api');
+  const { compressWeappImageIfNeeded } = await import('./compress-image');
   const token = getToken();
   if (!token) throw new Error('请先登录');
 
+  const filePath = await compressWeappImageIfNeeded(tempFilePath);
+
   const res = await Taro.uploadFile({
     url: `${API_BASE}/common/resources/upload`,
-    filePath: tempFilePath,
+    filePath,
     name: 'file',
     formData: {
       bizType: 'AVATAR',

apps/mini-user/src/lib/order-logistics-utils.ts

@@ -0,0 +1,114 @@
+import type { OrderTrackDto } from '@dukang/shared-types';
+import { isXfxProviderCode } from '@dukang/shared-types';
+import { formatShanghaiDateTime } from './datetime';
+
+export type OrderDelivery = {
+  provider?: string;
+  trackingNo?: string;
+  logisticsCompany?: string;
+  manualQueryUrl?: string;
+};
+
+export type OrderTrackNode = {
+  trackInfo?: string;
+  createTime?: string;
+  createdAt?: string;
+  statusName?: string;
+};
+
+export type OrderTrackEstimatedArrival = {
+  arriveTime: string;
+  siteName?: string;
+};
+
+export type OrderTrackResponse = OrderTrackDto;
+
+/** 订单详情页展示物流摘要的状态（配送中） */
+export const ORDER_LOGISTICS_PREVIEW_STATUSES = ['SHIPPING', 'SHIPPED'] as const;
+
+const PHONE_PATTERN = /(1[3-9]\d{9}|\d{3,4}-\d{7,8})/g;
+
+function compareTrackNodeTime(a: OrderTrackNode, b: OrderTrackNode) {
+  const ta = new Date(a.createTime || a.createdAt || 0).getTime();
+  const tb = new Date(b.createTime || b.createdAt || 0).getTime();
+  if (Number.isNaN(ta) && Number.isNaN(tb)) return 0;
+  if (Number.isNaN(ta)) return 1;
+  if (Number.isNaN(tb)) return -1;
+  return ta - tb;
+}
+
+export function deliveryProviderLabel(provider?: string, company?: string) {
+  if (company) return company;
+  if (!provider || provider === 'MOCK' || isXfxProviderCode(provider)) {
+    return '小飞侠配送';
+  }
+  if (provider === 'LOGISTICS') return '快递配送';
+  return provider;
+}
+
+export function shouldLoadOrderTrack(delivery?: OrderDelivery | null) {
+  if (!delivery) return false;
+  if (delivery.trackingNo) return true;
+  return isXfxProviderCode(delivery.provider || '');
+}
+
+export function formatTrackNodeTime(node: OrderTrackNode) {
+  return formatShanghaiDateTime(node.createTime || node.createdAt);
+}
+
+export function sortTrackNodesNewestFirst(nodes: OrderTrackNode[]): OrderTrackNode[] {
+  return [...nodes].sort((a, b) => -compareTrackNodeTime(a, b));
+}
+
+export function sortTrackNodesOldestFirst(nodes: OrderTrackNode[]): OrderTrackNode[] {
+  return [...nodes].sort(compareTrackNodeTime);
+}
+
+export function latestTrackNode(nodes: OrderTrackNode[]) {
+  if (!nodes.length) return null;
+  let latest = nodes[0];
+  for (let i = 1; i < nodes.length; i += 1) {
+    if (compareTrackNodeTime(nodes[i], latest) > 0) {
+      latest = nodes[i];
+    }
+  }
+  return latest;
+}
+
+export function isLogisticsNotArrived(nodes: OrderTrackNode[], orderStatus?: string) {
+  if (['PENDING_RECEIVE', 'DELIVERED', 'COMPLETED'].includes(orderStatus || '')) {
+    return false;
+  }
+  if (nodes.length === 0) return true;
+  return !nodes.some(
+    (node) => node.statusName?.includes('签收') || node.trackInfo?.includes('签收'),
+  );
+}
+
+export function formatEstimatedArrival(eta?: OrderTrackEstimatedArrival | null) {
+  if (!eta?.arriveTime) return '';
+  const time = formatShanghaiDateTime(eta.arriveTime);
+  if (eta.siteName) return `预计送达：${time}（${eta.siteName}）`;
+  return `预计送达：${time}`;
+}
+
+export type LogisticsTextSegment = { type: 'text' | 'phone'; value: string };
+
+export function splitLogisticsText(text: string): LogisticsTextSegment[] {
+  if (!text) return [];
+  const segments: LogisticsTextSegment[] = [];
+  let lastIndex = 0;
+  const regex = new RegExp(PHONE_PATTERN.source, 'g');
+  let match: RegExpExecArray | null;
+  while ((match = regex.exec(text)) !== null) {
+    if (match.index > lastIndex) {
+      segments.push({ type: 'text', value: text.slice(lastIndex, match.index) });
+    }
+    segments.push({ type: 'phone', value: match[0] });
+    lastIndex = match.index + match[0].length;
+  }
+  if (lastIndex < text.length) {
+    segments.push({ type: 'text', value: text.slice(lastIndex) });
+  }
+  return segments.length ? segments : [{ type: 'text', value: text }];
+}

apps/mini-user/src/lib/order-logistics.ts

@@ -0,0 +1,7 @@
+export * from './order-logistics-utils';
+import type { OrderTrackResponse } from './order-logistics-utils';
+import { request } from './api';
+
+export async function fetchOrderTrack(orderId: string) {
+  return request<OrderTrackResponse>(`/trade/orders/${orderId}/track`);
+}

apps/mini-user/src/lib/wechat-share.ts

@@ -1,16 +1,126 @@
 import Taro from '@tarojs/taro';
-import { BRAND_LOGO_URL } from '@dukang/shared-types';
 import type { WechatShareData } from '@dukang/weixin-sdk';
 import { getWechatShareLink, isWechatBrowser, isMiniProgram } from '@dukang/weixin-sdk';
+import {
+  applyShareTitleTemplate,
+  DEFAULT_SHARE_DESC,
+  DEFAULT_SHARE_HINT,
+  DEFAULT_SHARE_TITLE,
+  resolveMiniShareRuntime,
+  type ClientRuntimeConfig,
+  type MiniShareRuntime,
+  type MiniShareSceneConfig,
+} from '@dukang/shared-types';
 import { toast } from './api';
+import { getBrandAssetsSync, loadBrandAssets } from './brand-assets';
+import { fetchClientConfig } from './pay-wechat';
 import { isWechatEnv, weixinSdk } from './weixin';
 
-export const DEFAULT_SHARE_TITLE = '你吃饭，杜康买单';
+export type ShareScene =
-export const DEFAULT_SHARE_DESC = '杜康好客 · 买美酒，享好礼，全城门店可用';
+  | 'home'
-export const WECHAT_SHARE_HINT = '请点击右上角 ··· 分享给好友';
+  | 'stores'
+  | 'storeDetail'
+  | 'benefit'
+  | 'mine'
+  | 'productDetail'
+  | 'orderDetail';
+
+export { DEFAULT_SHARE_TITLE, DEFAULT_SHARE_DESC };
+
+export const WECHAT_SHARE_HINT = DEFAULT_SHARE_HINT;
+
+const FALLBACK_SHARE: MiniShareRuntime = resolveMiniShareRuntime({});
+
+let shareCached: MiniShareRuntime | null = null;
+
+export function getShareRuntimeSync(): MiniShareRuntime {
+  return shareCached ?? FALLBACK_SHARE;
+}
+
+export function applyShareFromClientConfig(config?: ClientRuntimeConfig | null) {
+  if (config?.share) {
+    shareCached = config.share;
+    return shareCached;
+  }
+  return getShareRuntimeSync();
+}
+
+export async function loadShareConfig(force = false): Promise<MiniShareRuntime> {
+  if (!force && shareCached) return shareCached;
+  try {
+    const cfg = await fetchClientConfig();
+    if (cfg?.share) {
+      shareCached = cfg.share;
+      return shareCached;
+    }
+  } catch {
+    /* ignore */
+  }
+  shareCached = FALLBACK_SHARE;
+  return shareCached;
+}
 
 export function getDefaultShareImageUrl(): string {
-  return BRAND_LOGO_URL;
+  const share = getShareRuntimeSync();
+  return share.default.imageUrl || getBrandAssetsSync().brandLogoUrl;
+}
+
+export function getShareHint(): string {
+  return getShareRuntimeSync().hint || DEFAULT_SHARE_HINT;
+}
+
+/** 预热分享配置与品牌图 */
+export function prefetchShareBrandAssets() {
+  void loadBrandAssets();
+  void loadShareConfig();
+}
+
+function sceneConfig(scene?: ShareScene): MiniShareSceneConfig {
+  const runtime = getShareRuntimeSync();
+  if (!scene) return runtime.default;
+  return runtime[scene] ?? runtime.default;
+}
+
+/**
+ * 组装页面分享：场景配置优先；空字段用 dynamic → 默认分享。
+ * orderDetail 标题支持 {productName}。
+ */
+export function buildSceneSharePayload(
+  scene: ShareScene,
+  options?: {
+    path?: string;
+    /** 业务动态标题（场景配置为空时使用） */
+    dynamicTitle?: string | null;
+    dynamicDesc?: string | null;
+    dynamicImageUrl?: string | null;
+    titleVars?: Record<string, string | undefined | null>;
+  },
+): PageSharePayload {
+  const def = getShareRuntimeSync().default;
+  const sc = sceneConfig(scene);
+  let title = (sc.title || '').trim();
+  if (title && options?.titleVars) {
+    const vars = options.titleVars;
+    const missingRequired = Object.entries(vars).some(
+      ([key, value]) => title.includes(`{${key}}`) && !(value != null && String(value).trim()),
+    );
+    title = missingRequired ? '' : applyShareTitleTemplate(title, vars);
+  }
+  if (!title) {
+    title = (options?.dynamicTitle || '').trim() || def.title;
+  }
+  const desc = (sc.desc || '').trim() || (options?.dynamicDesc || '').trim() || def.desc;
+  const imgUrl =
+    (sc.imageUrl || '').trim() ||
+    (options?.dynamicImageUrl || '').trim() ||
+    def.imageUrl ||
+    getDefaultShareImageUrl();
+  return {
+    title,
+    desc,
+    path: options?.path,
+    imgUrl,
+  };
 }
 
 export function buildDefaultShareData(
@@ -24,9 +134,10 @@ export function buildDefaultShareData(
       link = '';
     }
   }
+  const def = getShareRuntimeSync().default;
   return {
-    title: overrides?.title ?? DEFAULT_SHARE_TITLE,
+    title: overrides?.title ?? def.title,
-    desc: overrides?.desc ?? DEFAULT_SHARE_DESC,
+    desc: overrides?.desc ?? def.desc,
     link,
     imgUrl: overrides?.imgUrl ?? getDefaultShareImageUrl(),
   };
@@ -68,7 +179,7 @@ export async function handleShareButtonClick(
         /* ignore */
       }
     }
-    toast(WECHAT_SHARE_HINT);
+    toast(getShareHint());
     return { showGuide: false };
   }
 
@@ -89,7 +200,7 @@ export async function handleShareButtonClick(
     if (result.invoked) {
       return { showGuide: false };
     }
-    toast(WECHAT_SHARE_HINT);
+    toast(getShareHint());
     return { showGuide: true };
   } catch (e) {
     toast(e instanceof Error ? e.message : '分享配置失败，请刷新后重试');
@@ -99,9 +210,20 @@ export async function handleShareButtonClick(
 
 /** 供 useShareAppMessage 使用的标题/路径/图 */
 export function toWeappShareMessage(payload?: PageSharePayload) {
+  const def = getShareRuntimeSync().default;
   return {
-    title: payload?.title || DEFAULT_SHARE_TITLE,
+    title: payload?.title || def.title,
     path: payload?.path || '/pages/home/index',
     imageUrl: payload?.imgUrl || getDefaultShareImageUrl(),
   };
 }
+
+/** 供 useShareTimeline */
+export function toWeappShareTimeline(payload?: PageSharePayload, query = '') {
+  const def = getShareRuntimeSync().default;
+  return {
+    title: payload?.title || def.title,
+    query,
+    imageUrl: payload?.imgUrl || getDefaultShareImageUrl(),
+  };
+}

apps/mini-user/src/pages/benefit/index.tsx

@@ -8,9 +8,9 @@ import { goLogin } from '../../lib/auth-nav';
 import { isLoggedIn, request, toast } from '../../lib/api';
 import { navBarStyle, tabNavContentStyle, useNavBarMetrics } from '../../lib/nav-bar';
 import {
-  DEFAULT_SHARE_DESC,
+  buildSceneSharePayload,
-  DEFAULT_SHARE_TITLE,
   toWeappShareMessage,
+  toWeappShareTimeline,
 } from '../../lib/wechat-share';
 import { formatMoney } from '../../lib/money';
 import iconBenefit from '../../assets/tabbar/benefit-active.png';
@@ -104,20 +104,15 @@ export default function BenefitPage() {
   const available = coupons.filter((c) => c.status === 'ACTIVE' && c.balance > 0);
 
   const sharePayload = useMemo(
-    () => ({
+    () =>
-      title: '好客权益 · 杜康好客',
+      buildSceneSharePayload('benefit', {
-      desc: DEFAULT_SHARE_DESC,
+        path: '/pages/benefit/index',
-      path: '/pages/benefit/index',
+      }),
-    }),
     [],
   );
 
   useShareAppMessage(() => toWeappShareMessage(sharePayload));
-  useShareTimeline(() => ({
+  useShareTimeline(() => toWeappShareTimeline(sharePayload));
-    title: sharePayload.title || DEFAULT_SHARE_TITLE,
-    query: '',
-    imageUrl: sharePayload.imgUrl,
-  }));
 
   return (
     <PageShell variant="tab" className="benefit-page">

apps/mini-user/src/pages/customer-service/index.tsx

@@ -1,19 +1,26 @@
+import { useEffect, useState } from 'react';
 import { View, Text } from '@tarojs/components';
 import Taro from '@tarojs/taro';
-import { CUSTOMER_SERVICE_PHONE } from '@dukang/shared-types';
 import PageShell from '../../components/PageShell';
 import SubPageHeader from '../../components/SubPageHeader';
 import ContactCsButton from '../../components/ContactCsButton';
 import { toast } from '../../lib/api';
+import { getBrandAssetsSync, loadBrandAssets } from '../../lib/brand-assets';
 
 const isWeapp = process.env.TARO_ENV === 'weapp';
-const DIAL_PHONE = CUSTOMER_SERVICE_PHONE.replace(/-/g, '');
 
-function dialPhone() {
+function dialPhone(phone: string) {
-  Taro.makePhoneCall({ phoneNumber: DIAL_PHONE }).catch(() => toast('无法拨打电话'));
+  const tel = phone.replace(/-/g, '');
+  Taro.makePhoneCall({ phoneNumber: tel }).catch(() => toast('无法拨打电话'));
 }
 
 export default function CustomerServicePage() {
+  const [phone, setPhone] = useState(() => getBrandAssetsSync().customerServicePhone);
+
+  useEffect(() => {
+    void loadBrandAssets().then((b) => setPhone(b.customerServicePhone));
+  }, []);
+
   return (
     <PageShell variant="sub" className="cs-page">
       <SubPageHeader title="联系客服" />
@@ -30,14 +37,14 @@ export default function CustomerServicePage() {
           <ContactCsButton className="cs-online-btn" session={{ from: 'customer-service' }} />
         ) : null}
 
-        <View className={isWeapp ? 'cs-phone-link' : 'cs-call-btn'} onClick={dialPhone}>
+        <View className={isWeapp ? 'cs-phone-link' : 'cs-call-btn'} onClick={() => dialPhone(phone)}>
           <Text>
-            {isWeapp ? `或拨打客服电话 ${CUSTOMER_SERVICE_PHONE}` : '拨打客服电话'}
+            {isWeapp ? `或拨打客服电话 ${phone}` : '拨打客服电话'}
           </Text>
         </View>
 
         {!isWeapp ? (
-          <Text className="cs-phone-display">{CUSTOMER_SERVICE_PHONE}</Text>
+          <Text className="cs-phone-display">{phone}</Text>
         ) : null}
       </View>
     </PageShell>

apps/mini-user/src/pages/home/index.tsx

@@ -28,10 +28,12 @@ import {
   normalizeFulfillmentFlags,
 } from '../../lib/product-fulfillment';
 import { getCityCodeForCatalog, resolveUserCity } from '../../lib/user-location';
+import type { ClientRuntimeConfig } from '@dukang/shared-types';
 import {
-  DEFAULT_SHARE_DESC,
+  applyShareFromClientConfig,
-  DEFAULT_SHARE_TITLE,
+  buildSceneSharePayload,
   toWeappShareMessage,
+  toWeappShareTimeline,
 } from '../../lib/wechat-share';
 import { trackPageView } from '../../lib/analytics';
 type Product = {
@@ -85,8 +87,9 @@ export default function HomePage() {
   }, [cityCode]);
 
   const loadMiniHome = useCallback(() => {
-    return request<{ miniHome?: MiniHomeConfig }>('/common/client-config')
+    return request<ClientRuntimeConfig>('/common/client-config')
       .then((cfg) => {
+        applyShareFromClientConfig(cfg);
         const banners = Array.isArray(cfg.miniHome?.banners)
           ? cfg.miniHome!.banners.filter((u) => typeof u === 'string' && !!u.trim())
           : [];
@@ -221,21 +224,16 @@ export default function HomePage() {
   const footerUrl = miniHome.footerUrl;
 
   const sharePayload = useMemo(
-    () => ({
+    () =>
-      title: DEFAULT_SHARE_TITLE,
+      buildSceneSharePayload('home', {
-      desc: DEFAULT_SHARE_DESC,
+        path: '/pages/home/index',
-      path: '/pages/home/index',
+        dynamicImageUrl: banners[0] || undefined,
-      imgUrl: banners[0] || undefined,
+      }),
-    }),
     [banners],
   );
 
   useShareAppMessage(() => toWeappShareMessage(sharePayload));
-  useShareTimeline(() => ({
+  useShareTimeline(() => toWeappShareTimeline(sharePayload));
-    title: sharePayload.title || DEFAULT_SHARE_TITLE,
-    query: '',
-    imageUrl: sharePayload.imgUrl,
-  }));
 
   function scrollToAroma(key: AromaKey) {
     setActiveAroma(key);

apps/mini-user/src/pages/login/index.tsx

@@ -10,7 +10,11 @@ import {
 import PageShell from '../../components/PageShell';
 import WechatLoginButton from '../../components/WechatLoginButton';
 import PhoneQuickLoginButton from '../../components/PhoneQuickLoginButton';
-import { BRAND_LOGO_WIDE_URL } from '@dukang/shared-types';
+import {
+  applyBrandFromClientConfig,
+  getBrandAssetsSync,
+  loadBrandAssets,
+} from '../../lib/brand-assets';
 import { finishLoginNavigate, forceReloadAfterAccountMerge } from '../../lib/auth-nav';
 import {
   bindWechatForUser,
@@ -98,11 +102,18 @@ export default function LoginPage() {
   const [wxAuthorize, setWxAuthorize] = useState(true);
   const [completeMode, setCompleteMode] = useState<'phone' | 'wechat' | null>(null);
   const [showSmsForm, setShowSmsForm] = useState(!IS_WEAPP);
+  const [logoWideUrl, setLogoWideUrl] = useState(() => getBrandAssetsSync().brandLogoWideUrl);
 
   useEffect(() => {
     request<ClientRuntimeConfig>('/common/client-config')
-      .then((config) => setWxAuthorize(isWxAuthorizeEnabled(config)))
+      .then((config) => {
-      .catch(() => setWxAuthorize(true));
+        setWxAuthorize(isWxAuthorizeEnabled(config));
+        setLogoWideUrl(applyBrandFromClientConfig(config).brandLogoWideUrl);
+      })
+      .catch(() => {
+        setWxAuthorize(true);
+        void loadBrandAssets().then((b) => setLogoWideUrl(b.brandLogoWideUrl));
+      });
   }, []);
 
   useEffect(() => {
@@ -394,7 +405,7 @@ export default function LoginPage() {
       <View className="login-header">
         <View className="login-logo-wrap">
           <View className="login-logo">
-            <Image className="login-logo-img" src={BRAND_LOGO_WIDE_URL} mode="aspectFit" />
+            <Image className="login-logo-img" src={logoWideUrl} mode="aspectFit" />
           </View>
           <Text className="login-logo-badge">官方</Text>
         </View>

apps/mini-user/src/pages/mine/index.tsx

@@ -2,8 +2,6 @@ import { useEffect, useMemo, useState } from 'react';
 import { View, Text, Image, Button, Input, ScrollView } from '@tarojs/components';
 import Taro, { useDidShow, usePullDownRefresh, useShareAppMessage, useShareTimeline } from '@tarojs/taro';
 import {
-  BRAND_LOGO_MARK_URL,
-  QUALIFICATION_DISCLOSURE_URL,
   isWxAuthorizeEnabled,
   type ClientRuntimeConfig,
 } from '@dukang/shared-types';
@@ -13,6 +11,11 @@ import WechatShareReady from '../../components/WechatShareReady';
 import UserTabBar, { shouldRenderPageTabBar, syncTabBarSelected } from '../../components/UserTabBar';
 import { goLogin } from '../../lib/auth-nav';
 import { bindWechatForUser } from '../../lib/wechat-auth';
+import {
+  applyBrandFromClientConfig,
+  getBrandAssetsSync,
+  loadBrandAssets,
+} from '../../lib/brand-assets';
 import {
   fetchMiniWechatUserInfo,
   isDefaultMiniNickname,
@@ -23,11 +26,13 @@ import {
 } from '../../lib/mini-wechat-profile';
 import { isLoggedIn, logout, request, toast, type UserProfile } from '../../lib/api';
 import { isWechatEnv } from '../../lib/weixin';
+import { APP_VERSION_LABEL } from '../../lib/client-version';
 import { maskPhone } from '../../lib/phone';
 import {
-  DEFAULT_SHARE_DESC,
+  applyShareFromClientConfig,
-  DEFAULT_SHARE_TITLE,
+  buildSceneSharePayload,
   toWeappShareMessage,
+  toWeappShareTimeline,
 } from '../../lib/wechat-share';
 import iconPendingPay from '../../assets/icons/待付款.png';
 import iconPaid from '../../assets/icons/已付款.png';
@@ -69,7 +74,11 @@ export default function MinePage() {
   const [savingProfile, setSavingProfile] = useState(false);
   const [profileLoadError, setProfileLoadError] = useState('');
   const [qualificationOpen, setQualificationOpen] = useState(false);
-
+  const [brandMarkUrl, setBrandMarkUrl] = useState(() => getBrandAssetsSync().brandLogoMarkUrl);
+  const [qualificationUrl, setQualificationUrl] = useState(
+    () => getBrandAssetsSync().qualificationDisclosureUrl,
+  );
+  const [shareTick, setShareTick] = useState(0);
   function resetGuestState() {
     setProfile(null);
     setBenefitBalance(0);
@@ -140,24 +149,30 @@ export default function MinePage() {
 
   useEffect(() => {
     request<ClientRuntimeConfig>('/common/client-config')
-      .then((config) => setWxAuthorize(isWxAuthorizeEnabled(config)))
+      .then((config) => {
-      .catch(() => setWxAuthorize(true));
+        setWxAuthorize(isWxAuthorizeEnabled(config));
+        const brand = applyBrandFromClientConfig(config);
+        applyShareFromClientConfig(config);
+        setBrandMarkUrl(brand.brandLogoMarkUrl);
+        setQualificationUrl(brand.qualificationDisclosureUrl);
+        setShareTick((n) => n + 1);
+      })
+      .catch(() => {
+        setWxAuthorize(true);
+        void loadBrandAssets();
+      });
   }, []);
 
   const sharePayload = useMemo(
-    () => ({
+    () =>
-      title: '杜康好客 · 我的',
+      buildSceneSharePayload('mine', {
-      desc: DEFAULT_SHARE_DESC,
+        path: '/pages/mine/index',
-      path: '/pages/mine/index',
+      }),
-    }),
+    [shareTick],
-    [],
   );
 
   useShareAppMessage(() => toWeappShareMessage(sharePayload));
-  useShareTimeline(() => ({
+  useShareTimeline(() => toWeappShareTimeline(sharePayload));
-    title: sharePayload.title || DEFAULT_SHARE_TITLE,
-    query: '',
-  }));
 
   async function ensureWechatBound(): Promise<boolean> {
     if (profile?.hasWechat) return true;
@@ -303,7 +318,7 @@ export default function MinePage() {
     if (displayAvatarUrl) {
       return <Image className="mine-avatar-img" src={displayAvatarUrl} mode="aspectFill" />;
     }
-    return <Image className="mine-avatar-img" src={BRAND_LOGO_MARK_URL} mode="aspectFit" />;
+    return <Image className="mine-avatar-img" src={brandMarkUrl} mode="aspectFit" />;
   }
 
   if (!authed) {
@@ -316,7 +331,7 @@ export default function MinePage() {
           <View className="mine-profile">
             <View className="mine-avatar-wrap mine-avatar-wrap--action" onClick={() => goLogin('/pages/mine/index')}>
               <View className="mine-avatar mine-avatar--wx-pending">
-                <Image className="mine-avatar-img" src={BRAND_LOGO_MARK_URL} mode="aspectFit" />
+                <Image className="mine-avatar-img" src={brandMarkUrl} mode="aspectFit" />
               </View>
             </View>
             <View>
@@ -499,7 +514,7 @@ export default function MinePage() {
         </View>
 
         <View className="mine-footer">
-          <Text className="mine-version">杜康好客</Text>
+          <Text className="mine-version">杜康好客 {APP_VERSION_LABEL}</Text>
           <Text className="mine-logout" onClick={() => logout()}>
             退出登录
           </Text>
@@ -525,7 +540,7 @@ export default function MinePage() {
                 {previewAvatar ? (
                   <Image className="mine-avatar-img" src={previewAvatar} mode="aspectFill" />
                 ) : (
-                  <Image className="mine-avatar-img" src={BRAND_LOGO_MARK_URL} mode="aspectFit" />
+                  <Image className="mine-avatar-img" src={brandMarkUrl} mode="aspectFit" />
                 )}
               </View>
               <Text className="mine-profile-avatar-tip">点击选择头像</Text>
@@ -578,7 +593,7 @@ export default function MinePage() {
             <View className="mine-qualification-body">
               <Image
                 className="mine-qualification-img"
-                src={QUALIFICATION_DISCLOSURE_URL}
+                src={qualificationUrl}
                 mode="widthFix"
               />
             </View>

apps/mini-user/src/pages/order-confirm-pickup/index.tsx

@@ -141,6 +141,14 @@ export default function OrderConfirmPickupPage() {
     const ready = await ensurePayReady(returnPath);
     if (!ready) return;
 
+    const { confirm } = await Taro.showModal({
+      title: '确认提交订单',
+      content: `确认提交现场提货订单？共 ${quantity} 瓶，应付 ¥${Number(preview?.payAmount ?? 0).toFixed(2)}。`,
+      confirmText: '确认提交',
+      cancelText: '再想想',
+    });
+    if (!confirm) return;
+
     setLoading(true);
     setMsg('');
     try {

apps/mini-user/src/pages/order-detail/index.tsx

@@ -6,14 +6,25 @@ import SubPageHeader from '../../components/SubPageHeader';
 import ShareNavButton from '../../components/ShareNavButton';
 import WechatShareReady from '../../components/WechatShareReady';
 import ContactCsButton from '../../components/ContactCsButton';
+import LogisticsRichText from '../../components/LogisticsRichText';
 import { request, toast } from '../../lib/api';
 import { buildPayUrl } from '../../lib/checkout-nav';
+import {
+  formatEstimatedArrival,
+  isLogisticsNotArrived,
+  latestTrackNode,
+  ORDER_LOGISTICS_PREVIEW_STATUSES,
+  shouldLoadOrderTrack,
+  type OrderTrackEstimatedArrival,
+  type OrderTrackNode,
+} from '../../lib/order-logistics-utils';
+import { fetchOrderTrack } from '../../lib/order-logistics';
 import { maskPhone } from '../../lib/phone';
 import { confirmOrderReceive, type WechatConfirmPayload } from '../../lib/wechat-order-confirm';
 import {
-  DEFAULT_SHARE_DESC,
+  buildSceneSharePayload,
-  DEFAULT_SHARE_TITLE,
   toWeappShareMessage,
+  toWeappShareTimeline,
 } from '../../lib/wechat-share';
 import { usePageView } from '../../lib/usePageView';
 
@@ -44,8 +55,15 @@ type OrderDetail = {
   orderType?: string;
   isProxyOrder?: boolean;
   proxyPartnerName?: string | null;
+  deliveryType?: string;
   items?: OrderItem[];
   wechatConfirm?: WechatConfirmPayload | null;
+  delivery?: {
+    provider?: string;
+    trackingNo?: string;
+    logisticsCompany?: string;
+    manualQueryUrl?: string;
+  } | null;
 };
 
 const STATUS_LABELS: Record<string, string> = {
@@ -78,11 +96,41 @@ export default function OrderDetailPage() {
   usePageView('order_detail_view', orderId ? { orderId } : undefined);
   const [order, setOrder] = useState<OrderDetail | null>(null);
   const [confirming, setConfirming] = useState(false);
+  const [latestTrack, setLatestTrack] = useState<OrderTrackNode | null>(null);
+  const [estimatedArrival, setEstimatedArrival] = useState<OrderTrackEstimatedArrival | null>(null);
+  const [trackLoading, setTrackLoading] = useState(false);
+
+  async function loadOrderTrack(delivery: OrderDetail['delivery'], orderStatus?: string) {
+    if (!orderId || !shouldLoadOrderTrack(delivery)) {
+      setLatestTrack(null);
+      setEstimatedArrival(null);
+      return;
+    }
+    setTrackLoading(true);
+    try {
+      const track = await fetchOrderTrack(orderId);
+      const nodes = track.nodes ?? [];
+      setLatestTrack(latestTrackNode(nodes));
+      setEstimatedArrival(
+        isLogisticsNotArrived(nodes, orderStatus) && track.estimatedArrival
+          ? track.estimatedArrival
+          : null,
+      );
+    } catch {
+      setLatestTrack(null);
+      setEstimatedArrival(null);
+    } finally {
+      setTrackLoading(false);
+    }
+  }
 
   useEffect(() => {
     if (!orderId) return;
     request<OrderDetail>(`/trade/orders/${orderId}`)
-      .then(setOrder)
+      .then((data) => {
+        setOrder(data);
+        void loadOrderTrack(data.delivery, data.status);
+      })
       .catch((e) => toast(e instanceof Error ? e.message : '加载失败'));
   }, [orderId]);
 
@@ -90,7 +138,10 @@ export default function OrderDetailPage() {
     if (!orderId) return;
     // 从微信确认收货组件返回后刷新
     request<OrderDetail>(`/trade/orders/${orderId}`)
-      .then(setOrder)
+      .then((data) => {
+        setOrder(data);
+        void loadOrderTrack(data.delivery, data.status);
+      })
       .catch(() => {});
   });
 
@@ -99,6 +150,18 @@ export default function OrderDetailPage() {
   const canPay = !!order && order.status === 'PENDING_PAY' && !isReship;
   const canConfirmReceive =
     !!order && !isReship && !isProxy && ['PENDING_RECEIVE', 'DELIVERED'].includes(order.status || '');
+  const canViewLogistics =
+    !!order &&
+    order.deliveryType !== 'ON_SITE_PICKUP' &&
+    !isReship &&
+    ['PENDING_SHIP', 'OUT_WAREHOUSE', 'SHIPPING', 'SHIPPED', 'PENDING_RECEIVE', 'DELIVERED', 'COMPLETED'].includes(
+      order.status || '',
+    );
+  const showLogisticsPreview =
+    canViewLogistics &&
+    ORDER_LOGISTICS_PREVIEW_STATUSES.includes(
+      (order?.status || '') as (typeof ORDER_LOGISTICS_PREVIEW_STATUSES)[number],
+    );
 
   const item = order?.items?.[0];
   const productName = item?.productName || order?.productName || '杜康商品';
@@ -111,19 +174,20 @@ export default function OrderDetailPage() {
     : '';
 
   const sharePayload = useMemo(
-    () => ({
+    () =>
-      title: productName !== '杜康商品' ? `我买了${productName} · 杜康好客` : DEFAULT_SHARE_TITLE,
+      buildSceneSharePayload('orderDetail', {
-      desc: DEFAULT_SHARE_DESC,
+        path: orderId ? `/pages/order-detail/index?id=${orderId}` : '/pages/home/index',
-      path: orderId ? `/pages/order-detail/index?id=${orderId}` : '/pages/home/index',
+        titleVars: {
-    }),
+          productName: productName && productName !== '杜康商品' ? productName : '',
+        },
+      }),
     [productName, orderId],
   );
 
   useShareAppMessage(() => toWeappShareMessage(sharePayload));
-  useShareTimeline(() => ({
+  useShareTimeline(() =>
-    title: sharePayload.title || DEFAULT_SHARE_TITLE,
+    toWeappShareTimeline(sharePayload, orderId ? `id=${orderId}` : ''),
-    query: orderId ? `id=${orderId}` : '',
+  );
-  }));
 
   function goPay() {
     if (!order) return;
@@ -134,6 +198,11 @@ export default function OrderDetailPage() {
     Taro.navigateTo({ url: '/pages/customer-service/index' });
   }
 
+  function goLogistics() {
+    if (!order) return;
+    Taro.navigateTo({ url: `/pages/order-logistics/index?id=${order.id}` });
+  }
+
   async function confirmReceive() {
     if (!order || !canConfirmReceive || confirming) return;
 
@@ -211,6 +280,34 @@ export default function OrderDetailPage() {
               {isProxy && order.proxyPartnerName ? (
                 <Text className="order-proxy-hint">由合伙人 {order.proxyPartnerName} 代下</Text>
               ) : null}
+              {showLogisticsPreview ? (
+                <View className="order-logistics-preview-block">
+                  <View className="order-logistics-preview" onClick={goLogistics}>
+                    <View className="order-logistics-preview-main">
+                      {trackLoading ? (
+                        <Text className="order-logistics-preview-info u-muted">物流信息加载中…</Text>
+                      ) : latestTrack?.trackInfo ? (
+                        <LogisticsRichText
+                          text={latestTrack.trackInfo}
+                          className="order-logistics-preview-info"
+                        />
+                      ) : order.delivery?.manualQueryUrl ? (
+                        <Text className="order-logistics-preview-info u-muted">物流已更新，点击查看详情</Text>
+                      ) : (
+                        <Text className="order-logistics-preview-info u-muted">物流信息待更新，请稍后查看</Text>
+                      )}
+                    </View>
+                    <Text className="order-logistics-preview-link">物流详情</Text>
+                  </View>
+                  {estimatedArrival ? (
+                    <Text className="order-logistics-eta">{formatEstimatedArrival(estimatedArrival)}</Text>
+                  ) : null}
+                </View>
+              ) : canViewLogistics ? (
+                <Text className="order-logistics-link" onClick={goLogistics}>
+                  查看物流追踪
+                </Text>
+              ) : null}
             </View>
             <View className="order-card">
               <Text className="order-card-title">商品信息</Text>

apps/mini-user/src/pages/order-logistics/index.config.ts

@@ -0,0 +1,4 @@
+export default definePageConfig({
+  navigationStyle: 'custom',
+  navigationBarTitleText: '物流详情',
+});

apps/mini-user/src/pages/order-logistics/index.tsx

@@ -0,0 +1,209 @@
+import { useEffect, useMemo, useState } from 'react';
+import { View, Text, Image } from '@tarojs/components';
+import Taro, { useRouter } from '@tarojs/taro';
+import PageShell from '../../components/PageShell';
+import SubPageHeader from '../../components/SubPageHeader';
+import LogisticsRichText from '../../components/LogisticsRichText';
+import { request, toast } from '../../lib/api';
+import {
+  deliveryProviderLabel,
+  formatTrackNodeTime,
+  shouldLoadOrderTrack,
+  sortTrackNodesOldestFirst,
+  type OrderDelivery,
+  type OrderTrackNode,
+} from '../../lib/order-logistics-utils';
+import { fetchOrderTrack } from '../../lib/order-logistics';
+import { usePageView } from '../../lib/usePageView';
+
+type OrderDetail = {
+  id: string;
+  orderNo?: string;
+  status?: string;
+  delivery?: OrderDelivery | null;
+};
+
+export default function OrderLogisticsPage() {
+  const router = useRouter();
+  const orderId = router.params.id ?? '';
+  usePageView('order_logistics_view', orderId ? { orderId } : undefined);
+  const [order, setOrder] = useState<OrderDetail | null>(null);
+  const [trackNodes, setTrackNodes] = useState<OrderTrackNode[]>([]);
+  const [signPhotoUrls, setSignPhotoUrls] = useState<string[]>([]);
+  const [trackLoading, setTrackLoading] = useState(false);
+
+  const sortedTrackNodes = useMemo(
+    () => (Array.isArray(trackNodes) ? sortTrackNodesOldestFirst(trackNodes) : []),
+    [trackNodes],
+  );
+  const timelineComplete = ['PENDING_RECEIVE', 'DELIVERED', 'COMPLETED'].includes(
+    order?.status || '',
+  );
+
+  useEffect(() => {
+    if (!orderId) return;
+    let cancelled = false;
+    (async () => {
+      try {
+        const data = await request<OrderDetail>(`/trade/orders/${orderId}`);
+        if (cancelled) return;
+        setOrder(data);
+        if (!shouldLoadOrderTrack(data.delivery)) {
+          setTrackNodes([]);
+          setSignPhotoUrls([]);
+          return;
+        }
+        setTrackLoading(true);
+        try {
+          const track = await fetchOrderTrack(orderId);
+          if (!cancelled) {
+            setTrackNodes(track.nodes ?? []);
+            setSignPhotoUrls(track.signPhotoUrls ?? []);
+          }
+        } catch {
+          if (!cancelled) {
+            setTrackNodes([]);
+            setSignPhotoUrls([]);
+          }
+        } finally {
+          if (!cancelled) setTrackLoading(false);
+        }
+      } catch (e) {
+        if (!cancelled) toast(e instanceof Error ? e.message : '加载失败');
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [orderId]);
+
+  function openManualQuery() {
+    const url = order?.delivery?.manualQueryUrl?.trim();
+    if (!url) {
+      toast('暂无物流查询链接');
+      return;
+    }
+    if (process.env.TARO_ENV === 'h5' && typeof window !== 'undefined') {
+      window.open(url, '_blank');
+      return;
+    }
+    Taro.setClipboardData({ data: url })
+      .then(() => toast('查询链接已复制，请在浏览器中打开'))
+      .catch(() => toast('无法打开物流查询'));
+  }
+
+  function previewSignPhotos(index: number) {
+    if (signPhotoUrls.length === 0) return;
+    Taro.previewImage({ current: signPhotoUrls[index], urls: signPhotoUrls }).catch(() =>
+      toast('无法预览图片'),
+    );
+  }
+
+  const delivery = order?.delivery;
+
+  return (
+    <PageShell variant="sub" className="order-logistics-page">
+      <SubPageHeader title="物流详情" />
+      <View className="sub-page-body order-logistics-body">
+        {!order ? (
+          <View className="u-empty">加载中…</View>
+        ) : (
+          <>
+            <View className="order-card order-logistics-info-card">
+              <Text className="order-card-title">物流信息</Text>
+              <View className="order-row">
+                <Text className="order-row-label">配送方式</Text>
+                <Text className="order-row-value">
+                  {deliveryProviderLabel(delivery?.provider, delivery?.logisticsCompany)}
+                </Text>
+              </View>
+              {delivery?.trackingNo ? (
+                <View className="order-row">
+                  <Text className="order-row-label">运单号</Text>
+                  <Text className="order-row-value">{delivery.trackingNo}</Text>
+                </View>
+              ) : null}
+              {delivery?.manualQueryUrl ? (
+                <View className="order-row">
+                  <Text className="order-row-label">物流查询</Text>
+                  <Text className="order-row-value order-row-value--link" onClick={openManualQuery}>
+                    查看物流
+                  </Text>
+                </View>
+              ) : null}
+              {!delivery?.trackingNo && !delivery?.manualQueryUrl ? (
+                <Text className="u-muted">物流信息待更新，请稍后查看</Text>
+              ) : null}
+            </View>
+
+            {signPhotoUrls.length > 0 ? (
+              <View className="order-card">
+                <Text className="order-card-title">签收照片</Text>
+                <View className="order-logistics-sign-photos">
+                  {signPhotoUrls.map((url, index) => (
+                    <Image
+                      key={url}
+                      className="order-logistics-sign-photo"
+                      src={url}
+                      mode="aspectFill"
+                      onClick={() => previewSignPhotos(index)}
+                    />
+                  ))}
+                </View>
+              </View>
+            ) : null}
+
+            {trackLoading ? (
+              <View className="order-card">
+                <Text className="order-card-title">物流动态</Text>
+                <Text className="u-muted">加载中…</Text>
+              </View>
+            ) : sortedTrackNodes.length > 0 ? (
+              <View className="order-card">
+                <Text className="order-card-title">物流动态</Text>
+                <View
+                  className={`order-logistics-timeline${
+                    timelineComplete ? ' order-logistics-timeline--complete' : ''
+                  }`}
+                >
+                  {sortedTrackNodes.map((node, index) => {
+                    const isLatest = index === sortedTrackNodes.length - 1;
+                    return (
+                      <View
+                        key={`${node.trackInfo}-${node.createTime}-${index}`}
+                        className={[
+                          'order-logistics-timeline-item',
+                          'order-logistics-timeline-item--done',
+                          isLatest ? 'order-logistics-timeline-item--latest' : '',
+                        ]
+                          .filter(Boolean)
+                          .join(' ')}
+                      >
+                        <View className="order-logistics-timeline-dot" />
+                        <View className="order-logistics-timeline-body">
+                          {node.statusName ? (
+                            <Text className="order-logistics-timeline-status">{node.statusName}</Text>
+                          ) : null}
+                          <LogisticsRichText
+                            text={node.trackInfo || '—'}
+                            className="order-logistics-node-info"
+                          />
+                          <Text className="order-logistics-node-time">{formatTrackNodeTime(node)}</Text>
+                        </View>
+                      </View>
+                    );
+                  })}
+                </View>
+              </View>
+            ) : shouldLoadOrderTrack(delivery) ? (
+              <View className="order-card">
+                <Text className="order-card-title">物流动态</Text>
+                <Text className="u-muted">暂无路由信息，请稍后刷新</Text>
+              </View>
+            ) : null}
+          </>
+        )}
+      </View>
+    </PageShell>
+  );
+}

apps/mini-user/src/pages/product-detail/index.tsx

@@ -11,7 +11,6 @@ import type { ProductDetailContentDto } from '@dukang/shared-types';
 import PageShell from '../../components/PageShell';
 import PageNavBar from '../../components/PageNavBar';
 import ProductCarousel from '../../components/ProductCarousel';
-import ShareNavButton from '../../components/ShareNavButton';
 import WechatShareReady from '../../components/WechatShareReady';
 import { goLogin } from '../../lib/auth-nav';
 import { ensurePayReady } from '../../lib/pay-ready';
@@ -28,9 +27,9 @@ import {
   normalizeFulfillmentFlags,
 } from '../../lib/product-fulfillment';
 import {
-  DEFAULT_SHARE_DESC,
+  buildSceneSharePayload,
-  DEFAULT_SHARE_TITLE,
   toWeappShareMessage,
+  toWeappShareTimeline,
 } from '../../lib/wechat-share';
 import iconHome from '../../assets/tabbar/home.png';
 import { usePageView } from '../../lib/usePageView';
@@ -89,21 +88,20 @@ export default function ProductDetailPage() {
   });
 
   const sharePayload = useMemo(
-    () => ({
+    () =>
-      title: product?.name || DEFAULT_SHARE_TITLE,
+      buildSceneSharePayload('productDetail', {
-      desc: product?.subtitle || DEFAULT_SHARE_DESC,
+        path: `/pages/product-detail/index?id=${productId}`,
-      path: `/pages/product-detail/index?id=${productId}`,
+        dynamicTitle: product?.name,
-      imgUrl: (product ? getProductMainImage(product) : '') || undefined,
+        dynamicDesc: product?.subtitle,
-    }),
+        dynamicImageUrl: product ? getProductMainImage(product) : undefined,
+      }),
     [product, productId],
   );
 
   useShareAppMessage(() => toWeappShareMessage(sharePayload));
-  useShareTimeline(() => ({
+  useShareTimeline(() =>
-    title: sharePayload.title || DEFAULT_SHARE_TITLE,
+    toWeappShareTimeline(sharePayload, productId ? `id=${productId}` : ''),
-    query: productId ? `id=${productId}` : '',
+  );
-    imageUrl: sharePayload.imgUrl,
-  }));
 
   function goBack() {
     const pages = Taro.getCurrentPages();
@@ -167,12 +165,11 @@ export default function ProductDetailPage() {
         solid={headerSolid}
         titleVisible={headerSolid}
         onBack={goBack}
-        right={<ShareNavButton payload={sharePayload} />}
       />
 
       <View className="product-detail-main">
         <View className="product-detail-hero full-bleed">
-          <ProductCarousel images={carouselImages} alt={product.name} variant="detail" />
+          <ProductCarousel images={carouselImages} alt={product.name} variant="detail" previewable />
         </View>
 
         <View className="product-detail-info">

apps/mini-user/src/pages/store-detail/index.tsx

@@ -15,11 +15,13 @@ import ShareNavButton from '../../components/ShareNavButton';
 import StoreRedeemMarquee from '../../components/StoreRedeemMarquee';
 import WechatShareReady from '../../components/WechatShareReady';
 import { request, toast } from '../../lib/api';
+import { maskPhone } from '../../lib/phone';
+import { track } from '../../lib/analytics';
 import { formatShanghaiDateTime } from '../../lib/datetime';
 import {
-  DEFAULT_SHARE_DESC,
+  buildSceneSharePayload,
-  DEFAULT_SHARE_TITLE,
   toWeappShareMessage,
+  toWeappShareTimeline,
 } from '../../lib/wechat-share';
 
 type StoreMedia = {
@@ -34,6 +36,7 @@ type StorePackage = {
   dishes: string;
   usableTime?: string | null;
   otherNotes?: string | null;
+  imageUrl?: string | null;
   sortOrder?: number;
 };
 
@@ -234,18 +237,15 @@ export default function StoreDetailPage() {
     void loadRecentRedeems(id);
   });
 
-  const sharePayload = useMemo(
+  const sharePayload = useMemo(() => {
-    () => {
+    const envFirst = store ? envPhotoUrls(store)[0] : undefined;
-      const envFirst = store ? envPhotoUrls(store)[0] : undefined;
+    return buildSceneSharePayload('storeDetail', {
-      return {
+      path: `/pages/store-detail/index?id=${storeId}`,
-        title: store?.name || DEFAULT_SHARE_TITLE,
+      dynamicTitle: store?.name,
-        desc: store?.intro?.trim() || store?.address || DEFAULT_SHARE_DESC,
+      dynamicDesc: store?.intro?.trim() || store?.address,
-        path: `/pages/store-detail/index?id=${storeId}`,
+      dynamicImageUrl: store?.coverUrl || envFirst || store?.carouselUrls?.[0],
-        imgUrl: store?.coverUrl || envFirst || store?.carouselUrls?.[0] || undefined,
+    });
-      };
+  }, [store, storeId]);
-    },
-    [store, storeId],
-  );
 
   const marqueeLines = useMemo(
     () => recentRedeems.map(formatRecentRedeemLine).filter(Boolean),
@@ -253,11 +253,9 @@ export default function StoreDetailPage() {
   );
 
   useShareAppMessage(() => toWeappShareMessage(sharePayload));
-  useShareTimeline(() => ({
+  useShareTimeline(() =>
-    title: sharePayload.title || DEFAULT_SHARE_TITLE,
+    toWeappShareTimeline(sharePayload, storeId ? `id=${storeId}` : ''),
-    query: storeId ? `id=${storeId}` : '',
+  );
-    imageUrl: sharePayload.imgUrl,
-  }));
 
   function goBack() {
     const pages = Taro.getCurrentPages();
@@ -270,6 +268,7 @@ export default function StoreDetailPage() {
       toast('暂无门店电话');
       return;
     }
+    track('store_phone_call', { storeId: store.id });
     Taro.makePhoneCall({ phoneNumber: store.phone }).catch(() => toast('无法拨打电话'));
   }
 
@@ -315,17 +314,20 @@ export default function StoreDetailPage() {
   }
 
   const envPhotos = envPhotoUrls(store);
-  const images = uniqueUrls([
+  const heroImages = uniqueUrls([store.coverUrl, ...(store.carouselUrls || [])]);
-    store.coverUrl,
+  const packages = store.packages ?? [];
-    ...(store.carouselUrls || []),
-    ...envPhotos,
-  ]);
 
   const intro = store.intro?.trim() || '';
   const benefitRuleRaw = store.benefitUsageRule?.trim() || '';
   const benefitRule =
     benefitRuleRaw && !/^null$/i.test(benefitRuleRaw) ? benefitRuleRaw : '';
 
+  function openPackageDetail(index: number) {
+    Taro.navigateTo({
+      url: `/pages/store-package-detail/index?storeId=${storeId}&index=${index}`,
+    });
+  }
+
   function previewEnv(index: number) {
     if (!envPhotos.length) return;
     Taro.previewImage({
@@ -346,7 +348,13 @@ export default function StoreDetailPage() {
       />
 
       <View className="store-detail-hero full-bleed">
-        <ProductCarousel images={images} alt={store.name} variant="store" />
+        <ProductCarousel
+          images={heroImages}
+          alt={store.name}
+          variant="store"
+          previewable
+          imageFit="contain"
+        />
       </View>
 
       <View className="store-detail-info-card">
@@ -377,7 +385,9 @@ export default function StoreDetailPage() {
 
         {store.phone ? (
           <View className="store-detail-row">
-            <Text className="store-detail-meta store-detail-meta--flex">电话: {store.phone}</Text>
+            <Text className="store-detail-meta store-detail-meta--flex">
+              电话: {maskPhone(store.phone)}
+            </Text>
             <Text className="store-detail-action" onClick={callStore}>
               拨打
             </Text>
@@ -399,23 +409,20 @@ export default function StoreDetailPage() {
         </View>
       ) : null}
 
-      {store.packages && store.packages.length > 0 ? (
+      {packages.length > 0 ? (
-        <View className="store-detail-section">
+        <View className="store-detail-section store-detail-section--packages">
           <Text className="store-detail-section-title">门店套餐</Text>
-          {store.packages.map((pkg, index) => (
+          <View className="store-detail-package-list">
-            <View key={`${pkg.name}-${index}`} className="store-detail-package-card">
+            {packages.map((pkg, index) => (
-              <Text className="store-detail-package-name">{pkg.name}</Text>
+              <View
-              <Text className="store-detail-package-body">
+                key={`${pkg.name}-${index}`}
-                {formatRedeemAmountYuan(pkg.price)} 元 · {pkg.dishes}
+                className="store-detail-package-list-item"
-              </Text>
+                onClick={() => openPackageDetail(index)}
-              {pkg.usableTime ? (
+              >
-                <Text className="store-detail-package-meta">使用时间：{pkg.usableTime}</Text>
+                <Text className="store-detail-package-list-title">{pkg.name}</Text>
-              ) : null}
+              </View>
-              {pkg.otherNotes ? (
+            ))}
-                <Text className="store-detail-package-meta">说明：{pkg.otherNotes}</Text>
+          </View>
-              ) : null}
-            </View>
-          ))}
         </View>
       ) : null}
 
@@ -443,7 +450,7 @@ export default function StoreDetailPage() {
                 className="store-detail-env-item"
                 onClick={() => previewEnv(index)}
               >
-                <Image className="store-detail-env-img" src={url} mode="aspectFill" />
+                <Image className="store-detail-env-img" src={url} mode="widthFix" />
               </View>
             ))}
           </View>

apps/mini-user/src/pages/store-package-detail/index.config.ts

@@ -0,0 +1,4 @@
+export default definePageConfig({
+  navigationStyle: 'custom',
+  navigationBarTitleText: '套餐详情',
+});

apps/mini-user/src/pages/store-package-detail/index.tsx

@@ -0,0 +1,175 @@
+import { useCallback, useState } from 'react';
+import { View, Text, Image } from '@tarojs/components';
+import Taro, { useLoad, useRouter } from '@tarojs/taro';
+import PageShell from '../../components/PageShell';
+import PageNavBar from '../../components/PageNavBar';
+import { request, toast } from '../../lib/api';
+
+type StorePackage = {
+  name: string;
+  price: string | number;
+  dishes: string;
+  usableTime?: string | null;
+  otherNotes?: string | null;
+  imageUrl?: string | null;
+};
+
+type Store = {
+  id: string;
+  name: string;
+  packages?: StorePackage[] | null;
+};
+
+function pickStoreId(raw?: string | null) {
+  return String(raw || '')
+    .trim()
+    .replace(/[^\d]/g, '');
+}
+
+function parsePackageIndex(raw?: string | null) {
+  const n = Number.parseInt(String(raw ?? ''), 10);
+  return Number.isFinite(n) && n >= 0 ? n : -1;
+}
+
+function formatPriceYuan(price: string | number) {
+  const n = typeof price === 'number' ? price : Number(price);
+  if (!Number.isFinite(n)) return '0';
+  if (Math.abs(n - Math.round(n)) < 1e-9) return String(Math.round(n));
+  return n.toFixed(2).replace(/\.?0+$/, '');
+}
+
+export default function StorePackageDetailPage() {
+  const router = useRouter();
+  const [storeId, setStoreId] = useState(() => pickStoreId(router.params.storeId));
+  const [storeName, setStoreName] = useState('');
+  const [pkg, setPkg] = useState<StorePackage | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [loadError, setLoadError] = useState('');
+
+  const loadPackage = useCallback(async (sid: string, index: number) => {
+    if (!sid) {
+      setLoading(false);
+      setLoadError('缺少门店参数');
+      return;
+    }
+    if (index < 0) {
+      setLoading(false);
+      setLoadError('套餐不存在');
+      return;
+    }
+    setLoadError('');
+    setLoading(true);
+    try {
+      const data = await request<Store>(`/stores/${sid}`);
+      const packages = data?.packages ?? [];
+      const item = packages[index];
+      if (!data?.id || !item) {
+        setPkg(null);
+        setLoadError('套餐不存在或已下架');
+        toast('套餐不存在或已下架');
+        return;
+      }
+      setStoreName(data.name);
+      setPkg(item);
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : '加载失败';
+      setLoadError(msg);
+      toast(msg);
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useLoad((options) => {
+    const sid = pickStoreId(options?.storeId || router.params.storeId);
+    const index = parsePackageIndex(options?.index ?? router.params.index);
+    setStoreId(sid);
+    void loadPackage(sid, index);
+  });
+
+  function goBack() {
+    const pages = Taro.getCurrentPages();
+    if (pages.length > 1) Taro.navigateBack();
+    else if (storeId) {
+      Taro.redirectTo({ url: `/pages/store-detail/index?id=${storeId}` });
+    } else {
+      Taro.switchTab({ url: '/pages/stores/index' });
+    }
+  }
+
+  function previewImage(url: string) {
+    Taro.previewImage({ urls: [url], current: url }).catch(() => toast('无法预览图片'));
+  }
+
+  if (loading) {
+    return (
+      <PageShell variant="scroll" className="store-package-detail-page">
+        <PageNavBar title="套餐详情" solid onBack={goBack} />
+        <View className="page-with-nav-bar u-empty">加载中…</View>
+      </PageShell>
+    );
+  }
+
+  if (!pkg) {
+    return (
+      <PageShell variant="scroll" className="store-package-detail-page">
+        <PageNavBar title="套餐详情" solid onBack={goBack} />
+        <View className="page-with-nav-bar u-empty">{loadError || '套餐不存在'}</View>
+      </PageShell>
+    );
+  }
+
+  const imageUrl = (pkg.imageUrl || '').trim();
+
+  return (
+    <PageShell variant="scroll" className="store-package-detail-page">
+      <PageNavBar title={pkg.name} solid titleVisible onBack={goBack} />
+
+      <View className="store-package-detail-body">
+        <View className="store-package-detail-inner">
+          <View className="store-package-detail-header">
+            <View className="store-package-detail-title-row">
+              <Text className="store-package-detail-title">{pkg.name}</Text>
+              <Text className="store-package-detail-price">¥{formatPriceYuan(pkg.price)}</Text>
+            </View>
+            {storeName ? (
+              <Text className="store-package-detail-store">{storeName}</Text>
+            ) : null}
+          </View>
+
+          {imageUrl ? (
+            <View
+              className="store-package-detail-photo"
+              onClick={() => previewImage(imageUrl)}
+            >
+              <Image
+                className="store-package-detail-photo-image"
+                src={imageUrl}
+                mode="widthFix"
+              />
+            </View>
+          ) : null}
+
+          <View className="store-package-detail-content">
+            <View className="store-detail-package-field">
+              <Text className="store-detail-package-field-label">菜品</Text>
+              <Text className="store-detail-package-field-value">{pkg.dishes || '—'}</Text>
+            </View>
+            {pkg.usableTime ? (
+              <View className="store-detail-package-field">
+                <Text className="store-detail-package-field-label">使用时间</Text>
+                <Text className="store-detail-package-field-value">{pkg.usableTime}</Text>
+              </View>
+            ) : null}
+            {pkg.otherNotes ? (
+              <View className="store-detail-package-field">
+                <Text className="store-detail-package-field-label">其他说明</Text>
+                <Text className="store-detail-package-field-value">{pkg.otherNotes}</Text>
+              </View>
+            ) : null}
+          </View>
+        </View>
+      </View>
+    </PageShell>
+  );
+}

apps/mini-user/src/pages/stores/index.tsx

@@ -36,9 +36,9 @@ import {
   setStoresListCache,
 } from '../../lib/stores-session';
 import {
-  DEFAULT_SHARE_DESC,
+  buildSceneSharePayload,
-  DEFAULT_SHARE_TITLE,
   toWeappShareMessage,
+  toWeappShareTimeline,
 } from '../../lib/wechat-share';
 
 type Store = {
@@ -341,27 +341,24 @@ export default function StoresPage() {
     }
   }
 
-  function formatHours(store: Store) {
+  function hoursLines(store: Store): string[] {
     const parts: string[] = [];
     if (store.openTime && store.closeTime) parts.push(`${store.openTime}-${store.closeTime}`);
     if (store.openTime2 && store.closeTime2) parts.push(`${store.openTime2}-${store.closeTime2}`);
-    return parts.length ? `营业时间: ${parts.join('，')}` : '营业时间: 10:00-22:00';
+    if (!parts.length) parts.push('10:00-22:00');
+    return parts.map((p, i) => (i === 0 ? `营业时间: ${p}` : p));
   }
 
   const sharePayload = useMemo(
-    () => ({
+    () =>
-      title: '杜康好客门店',
+      buildSceneSharePayload('stores', {
-      desc: DEFAULT_SHARE_DESC,
+        path: '/pages/stores/index',
-      path: '/pages/stores/index',
+      }),
-    }),
     [],
   );
 
   useShareAppMessage(() => toWeappShareMessage(sharePayload));
-  useShareTimeline(() => ({
+  useShareTimeline(() => toWeappShareTimeline(sharePayload));
-    title: sharePayload.title || DEFAULT_SHARE_TITLE,
-    query: '',
-  }));
 
   return (
     <PageShell variant="tab" className="store-page no-tab-header">
@@ -427,31 +424,40 @@ export default function StoresPage() {
               {s.coverUrl ? (
                 <Image className="store-card-cover" src={s.coverUrl} mode="aspectFill" />
               ) : (
-                <View className="store-card-cover--empty" />
+                <View className="store-card-cover store-card-cover--empty" />
               )}
               <View className="store-card-body">
-                <Text className="store-card-name">{s.name}</Text>
+                {/* 第1行：标题 + 距离 */}
-                <Text className="store-card-meta">
+                <View className="store-card-row store-card-row--head">
-                  {s.district ? `${s.district} · ` : ''}
+                  <Text className="store-card-name" numberOfLines={1}>
-                  {s.address || '地址待完善'}
+                    {s.name}
-                </Text>
+                  </Text>
-                <Text className="store-card-meta">{formatHours(s)}</Text>
-                {s.avgPrice != null && Number(s.avgPrice) > 0 ? (
-                  <Text className="store-card-meta">人均¥{Number(s.avgPrice).toFixed(0)}</Text>
-                ) : null}
-                <View className="store-card-footer">
                   <Text className="store-card-distance">
                     {formatDistanceMeters(s.distanceMeters)}
                   </Text>
-                  <Text
+                </View>
+                {/* 第2行：营业时间（多段各占一行，居左） */}
+                <View className="store-card-hours">
+                  {hoursLines(s).map((line) => (
+                    <Text key={line} className="store-card-hours-line">
+                      {line}
+                    </Text>
+                  ))}
+                </View>
+                {/* 第3行：地址（最多两行）+ 去核销 */}
+                <View className="store-card-row store-card-row--foot">
+                  <Text className="store-card-address" numberOfLines={2}>
+                    {s.address || (s.district ? `${s.district}` : '地址待完善')}
+                  </Text>
+                  <View
                     className="store-card-cta"
                     onClick={(e) => {
                       e.stopPropagation();
                       Taro.navigateTo({ url: '/pages/redeem/index' });
                     }}
                   >
-                    去核销
+                    <Text className="store-card-cta-text">去核销</Text>
-                  </Text>
+                  </View>
                 </View>
               </View>
             </View>

apps/mini-user/src/styles/order.css

@@ -488,3 +488,188 @@
   line-height: 1.5;
   text-align: center;
 }
+
+.order-logistics-page {
+  background: var(--color-background);
+  min-height: 100vh;
+}
+
+.order-logistics-body {
+  padding-top: 0;
+}
+
+.order-logistics-info-card {
+  margin-top: 0;
+}
+
+.order-logistics-link {
+  display: inline-block;
+  margin-top: 8px;
+  font-size: 14px;
+  color: var(--color-heritage-red);
+}
+
+.order-logistics-preview {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  margin-top: 12px;
+  padding: 12px;
+  border-radius: 10px;
+  background: rgba(166, 29, 36, 0.04);
+}
+
+.order-logistics-preview-main {
+  flex: 1;
+  min-width: 0;
+}
+
+.order-logistics-preview-info {
+  font-size: 13px;
+  color: var(--color-on-surface);
+  line-height: 1.5;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+}
+
+.order-logistics-preview-link {
+  flex-shrink: 0;
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--color-heritage-red);
+}
+
+.order-logistics-preview-block {
+  margin-top: 12px;
+}
+
+.order-logistics-eta {
+  display: block;
+  margin-top: 8px;
+  font-size: 12px;
+  color: var(--color-on-surface-variant);
+  line-height: 1.5;
+}
+
+.order-logistics-phone-link {
+  color: var(--color-heritage-red);
+}
+
+.order-logistics-sign-photos {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+
+.order-logistics-sign-photo {
+  width: 96px;
+  height: 96px;
+  border-radius: 8px;
+  background: var(--color-surface-container);
+}
+
+.order-row-value--link {
+  color: var(--color-heritage-red);
+}
+
+.order-logistics-timeline {
+  padding-top: 4px;
+}
+
+.order-logistics-timeline--complete .order-logistics-timeline-item:not(:last-child)::before {
+  background: rgba(166, 29, 36, 0.35);
+}
+
+.order-logistics-timeline-item {
+  display: flex;
+  gap: 12px;
+  position: relative;
+  padding-bottom: 16px;
+}
+
+.order-logistics-timeline-item:last-child {
+  padding-bottom: 0;
+}
+
+.order-logistics-timeline-item:not(:last-child)::before {
+  content: '';
+  position: absolute;
+  left: 5px;
+  top: 14px;
+  bottom: 0;
+  width: 1px;
+  background: rgba(0, 0, 0, 0.08);
+}
+
+.order-logistics-timeline-item--done .order-logistics-timeline-dot {
+  background: var(--color-heritage-red);
+  box-shadow: 0 0 0 1px var(--color-heritage-red);
+}
+
+.order-logistics-timeline-item--done:not(:last-child)::before {
+  background: rgba(166, 29, 36, 0.35);
+}
+
+.order-logistics-timeline-dot {
+  flex-shrink: 0;
+  width: 11px;
+  height: 11px;
+  margin-top: 4px;
+  border-radius: 50%;
+  background: var(--color-surface-container-high, #e8e4df);
+  border: 2px solid #fff;
+  box-shadow: 0 0 0 1px rgba(0, 0, 0, 0.08);
+}
+
+.order-logistics-timeline-item--latest .order-logistics-timeline-dot {
+  background: var(--color-heritage-red);
+  box-shadow: 0 0 0 2px rgba(166, 29, 36, 0.25);
+}
+
+.order-logistics-timeline-body {
+  flex: 1;
+  min-width: 0;
+}
+
+.order-logistics-timeline-status {
+  display: block;
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--color-on-surface);
+  margin-bottom: 4px;
+}
+
+.order-logistics-timeline-item--done .order-logistics-timeline-status {
+  color: var(--color-heritage-red);
+}
+
+.order-logistics-timeline-item--latest .order-logistics-timeline-status {
+  color: var(--color-heritage-red);
+  font-weight: 700;
+}
+
+.order-logistics-node {
+  padding: 10px 0;
+  border-bottom: 1px solid rgba(0, 0, 0, 0.06);
+}
+
+.order-logistics-node:last-child {
+  border-bottom: none;
+}
+
+.order-logistics-node-time {
+  display: block;
+  font-size: 12px;
+  color: var(--color-on-surface-variant);
+  margin-bottom: 4px;
+}
+
+.order-logistics-node-info {
+  display: block;
+  font-size: 14px;
+  color: var(--color-on-surface);
+  line-height: 1.5;
+}

apps/mini-user/src/styles/store-detail.css

@@ -10,8 +10,24 @@
 .store-detail-carousel-wrap {
   position: relative;
   width: 100%;
-  height: 280px;
+  aspect-ratio: 4 / 3;
   overflow: hidden;
+  /* background: var(--color-surface-container); */
+  background-color: #000;
+}
+
+/* 门店门头：固定 4:3 区域，图片 aspectFit 缩放完整显示（不裁剪） */
+.store-detail-carousel-wrap--contain .store-detail-carousel-item {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.store-detail-carousel-wrap--contain .store-detail-carousel-image {
+  width: 100%;
+  height: 100%;
+  object-fit: contain;
+  object-position: center center;
 }
 
 .store-detail-carousel {
@@ -26,6 +42,12 @@
   height: 100%;
 }
 
+.store-detail-carousel-image {
+  object-fit: cover;
+  object-position: center center;
+  display: block;
+}
+
 .store-detail-carousel-placeholder {
   background: var(--color-surface-container);
 }
@@ -53,7 +75,7 @@
 }
 
 .store-detail-info-card {
-  margin: -40px var(--space-page) 16px;
+  margin: 0 var(--space-page) 16px;
   position: relative;
   z-index: 2;
   background: var(--color-card);
@@ -175,24 +197,25 @@
 }
 
 .store-detail-env-grid {
-  display: grid;
+  display: flex;
-  grid-template-columns: repeat(3, 1fr);
+  flex-direction: column;
-  gap: 8px;
+  gap: 12px;
 }
 
 .store-detail-env-item {
   position: relative;
   width: 100%;
-  aspect-ratio: 1;
   border-radius: var(--radius-md, 8px);
   overflow: hidden;
   background: var(--color-surface-container);
+  box-shadow: 0 1px 4px rgba(0, 0, 0, 0.06);
 }
 
 .store-detail-env-img {
   width: 100%;
-  height: 100%;
+  height: auto;
   display: block;
+  vertical-align: top;
 }
 
 .store-detail-bar {
@@ -235,35 +258,146 @@
   margin-right: 0;
 }
 
-.store-detail-package-card {
+.store-detail-section--packages {
-  padding: 12px 0;
+  overflow: hidden;
+}
+
+.store-detail-package-list {
+  display: flex;
+  flex-direction: column;
+}
+
+.store-detail-package-list-item {
+  padding: 14px 0;
   border-bottom: 1px solid rgba(0, 0, 0, 0.06);
 }
 
-.store-detail-package-card:last-of-type {
+.store-detail-package-list-item:first-child {
-  border-bottom: none;
+  padding-top: 4px;
 }
 
-.store-detail-package-name {
+.store-detail-package-list-item:last-child {
+  border-bottom: none;
+  padding-bottom: 0;
+}
+
+.store-detail-package-list-title {
   display: block;
-  font-size: 16px;
+  font-size: 15px;
+  line-height: 1.5;
+  font-weight: 500;
+  color: var(--color-on-surface);
+  word-break: break-word;
+}
+
+.store-detail-package-list-item:active {
+  opacity: 0.72;
+}
+
+/* ── 套餐详情页（独立于门店详情） ── */
+.store-package-detail-page {
+  background: var(--color-background);
+}
+
+.store-package-detail-body {
+  /* 避开状态栏+胶囊导航，并额外 12px 顶白 */
+  padding: calc(var(--nav-bar-height, 56px) + 12px) 0 24px;
+  box-sizing: border-box;
+}
+
+.store-package-detail-inner {
+  /* 左右留白，内容不贴边 */
+  padding: 8px 16px 0;
+  box-sizing: border-box;
+}
+
+.store-package-detail-header {
+  padding: 8px 16px 4px 16px;
+}
+
+.store-package-detail-title-row {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 16px;
+}
+
+.store-package-detail-title {
+  flex: 1;
+  min-width: 0;
+  font-family: var(--font-headline);
+  font-size: 20px;
   font-weight: 700;
-  color: var(--color-text-primary, #1a1a1a);
+  line-height: 1.4;
+  color: var(--color-ink-black);
+  word-break: break-word;
+}
+
+.store-package-detail-price {
+  flex-shrink: 0;
+  font-size: 24px;
+  font-weight: 700;
+  line-height: 1.35;
+  color: #a61d24;
+  color: var(--color-heritage-red, #a61d24);
+  text-align: right;
+}
+
+.store-package-detail-store {
+  display: block;
+  margin-top: 10px;
+  font-size: 13px;
+  line-height: 1.5;
+  color: var(--color-on-surface-variant);
+  padding-left: 4px;
+}
+
+.store-package-detail-photo {
+  margin: 14px 0 0;
+  border-radius: var(--radius-lg);
+  overflow: hidden;
+  background: var(--color-card);
+  box-shadow: var(--shadow-card);
+}
+
+.store-package-detail-photo-image {
+  width: 100%;
+  display: block;
+  vertical-align: top;
+}
+
+.store-package-detail-content {
+  margin-top: 16px;
+  background: var(--color-card);
+  border-radius: var(--radius-lg);
+  padding: 16px;
+  box-shadow: var(--shadow-card);
+  box-sizing: border-box;
+}
+
+.store-detail-package-field-label {
+  display: block;
+  font-size: 13px;
+  font-weight: 600;
+  color: var(--color-on-surface-variant);
   margin-bottom: 6px;
 }
 
-.store-detail-package-body {
+.store-detail-package-field-value {
   display: block;
   font-size: 14px;
-  color: var(--color-text-secondary, #666);
+  color: var(--color-on-surface);
-  line-height: 1.5;
+  line-height: 1.7;
+  white-space: pre-wrap;
+  word-break: break-word;
 }
 
-.store-detail-package-meta {
+.store-detail-package-field {
-  display: block;
+  margin-bottom: 16px;
-  font-size: 13px;
+}
-  color: var(--color-text-tertiary, #999);
+
-  margin-top: 4px;
+.store-detail-package-field:last-child {
+  margin-bottom: 0;
 }
 
 .store-detail-package-dispute {

apps/mini-user/src/styles/stores.css

@@ -144,63 +144,141 @@
   padding: 4px var(--space-page) 16px;
 }
 
+/* 左图右文 */
 .store-card {
+  display: flex;
+  flex-direction: row;
+  align-items: flex-start;
+  gap: 12px;
+  padding: 12px;
+  box-sizing: border-box;
   background: var(--color-card);
   border-radius: var(--radius-lg);
-  overflow: hidden;
   box-shadow: var(--shadow-card);
-  margin-bottom: 16px;
+  margin-bottom: 12px;
 }
 
 .store-card-cover {
-  width: 100%;
+  flex-shrink: 0;
-  height: 160px;
+  width: 96px;
+  height: 96px;
+  border-radius: 8px;
   background: var(--color-surface-container);
   display: block;
 }
 
 .store-card-cover--empty {
-  height: 160px;
   background: var(--color-surface-container);
 }
 
 .store-card-body {
-  padding: 14px 16px 16px;
+  flex: 1;
+  min-width: 0;
+  min-height: 96px;
+  display: flex;
+  flex-direction: column;
+  justify-content: space-between;
+  gap: 4px;
+  box-sizing: border-box;
+}
+
+.store-card-row {
+  display: flex;
+  align-items: center;
+  min-width: 0;
+  overflow: hidden;
+}
+
+/* 第1行：加粗标题（单行截断）+ 右对齐距离 */
+.store-card-row--head {
+  gap: 8px;
+  height: 22px;
 }
 
 .store-card-name {
-  display: block;
+  flex: 1;
+  min-width: 0;
   font-family: var(--font-headline);
-  font-size: 16px;
+  font-size: 15px;
   font-weight: 700;
-  color: var(--color-on-surface);
+  line-height: 22px;
-  margin-bottom: 6px;
+  color: #1a1a1a;
-}
+  overflow: hidden;
-
+  text-overflow: ellipsis;
-.store-card-meta {
+  white-space: nowrap;
-  display: block;
-  font-size: 12px;
-  color: var(--color-subtle-gray);
-  margin-bottom: 4px;
-}
-
-.store-card-footer {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  margin-top: 12px;
 }
 
 .store-card-distance {
+  flex-shrink: 0;
+  max-width: 40%;
   font-size: 12px;
-  color: var(--color-on-surface-variant);
+  font-weight: 400;
+  line-height: 22px;
+  color: #999;
+  text-align: right;
+  white-space: nowrap;
+}
+
+/* 第2行：营业时间独自居左；多段各占一行 */
+.store-card-hours {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 2px;
+  min-width: 0;
+}
+
+.store-card-hours-line {
+  font-size: 11px;
+  font-weight: 400;
+  line-height: 16px;
+  color: #999;
+  text-align: left;
+}
+
+/* 第3行：地址最多两行截断 + 右对齐去核销；与按钮垂直居中 */
+.store-card-row--foot {
+  gap: 8px;
+  min-height: 28px;
+  align-items: center;
+  overflow: visible;
+}
+
+.store-card-address {
+  flex: 1;
+  min-width: 0;
+  font-size: 9px;
+  font-weight: 400;
+  line-height: 14px;
+  max-height: 28px;
+  color: #999;
+  text-align: left;
+  white-space: normal;
+  word-break: break-word;
+  overflow: hidden;
+  display: -webkit-box;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+  line-clamp: 2;
+  text-overflow: ellipsis;
 }
 
 .store-card-cta {
-  padding: 6px 14px;
+  flex-shrink: 0;
-  border-radius: var(--radius-full);
+  display: flex;
-  background: rgba(166, 29, 36, 0.08);
+  align-items: center;
-  color: var(--color-heritage-red);
+  justify-content: center;
+  padding: 0 14px;
+  height: 26px;
+  border-radius: 999px;
+  background: var(--color-heritage-red, #a61d24);
+  box-sizing: border-box;
+}
+
+.store-card-cta-text {
   font-size: 12px;
   font-weight: 600;
+  line-height: 26px;
+  color: #fff;
+  white-space: nowrap;
 }

packages/client-logging/src/client-error.ts

@@ -5,6 +5,7 @@ export type ClientErrorCategory =
   | 'js_error'
   | 'unhandled_rejection'
   | 'api_error'
+  | 'validation_error'
   | 'network'
   | 'render'
   | 'bridge'
@@ -73,6 +74,7 @@ export function reportApiError(
   input: { message: string; status?: number; url?: string; category?: ClientErrorCategory },
 ) {
   if (typeof window === 'undefined') return;
+  if (input.url?.includes('/common/client-errors')) return;
   const token = opts.getToken?.() ?? localStorage.getItem('accessToken');
   const headers: Record<string, string> = {
     'Content-Type': 'application/json',
@@ -85,7 +87,7 @@ export function reportApiError(
     headers,
     body: {
       level: 'warn',
-      category: input.category ?? 'api_error',
+      category: input.category ?? (input.status === 400 ? 'validation_error' : 'api_error'),
       message: input.message.slice(0, 1000),
       pagePath: window.location.pathname,
       clientApp: opts.clientApp,

packages/domain/src/index.test.ts

@@ -251,7 +251,6 @@ describe('validateStoreWithdraw', () => {
     requestAmount: 200,
     todayApplied: 0,
     dailyLimit: 5000,
-    hasPendingRequest: false,
     hasBankAccount: true,
   };
 
@@ -261,8 +260,7 @@ describe('validateStoreWithdraw', () => {
     ).toBe(false);
   });
 
-  it('rejects pending request / missing bank / over available', () => {
+  it('rejects missing bank / over available', () => {
-    expect(validateStoreWithdraw({ ...base, hasPendingRequest: true }).ok).toBe(false);
     expect(validateStoreWithdraw({ ...base, hasBankAccount: false }).ok).toBe(false);
     expect(validateStoreWithdraw({ ...base, requestAmount: 1001 }).ok).toBe(false);
   });

packages/domain/src/index.ts

@@ -105,20 +105,16 @@ export type ValidateStoreWithdrawInput = {
   requestAmount: number;
   todayApplied: number;
   dailyLimit: number;
-  hasPendingRequest: boolean;
   hasBankAccount: boolean;
 };
 
-/** 门店未出账提现护栏（FIN-002 单日上限 + 幂等/账户） */
+/** 门店未出账提现护栏（FIN-002 单日上限 + 账户） */
 export function validateStoreWithdraw(
   input: ValidateStoreWithdrawInput,
 ): { ok: boolean; message?: string } {
   if (!input.hasBankAccount) {
     return { ok: false, message: '请先完善入驻收款账户后再提现' };
   }
-  if (input.hasPendingRequest) {
-    return { ok: false, message: '已有待审核提现申请，请等待处理完成' };
-  }
   if (!(input.requestAmount > 0)) {
     return { ok: false, message: '提现金额必须大于 0' };
   }
@@ -354,3 +350,4 @@ export function orderTabToStatuses(tab: string): string[] | undefined {
 
 export * from './city-partner';
 export * from './dev-plan';
+export * from './support-ticket';

packages/domain/src/support-ticket.test.ts

@@ -0,0 +1,57 @@
+import { describe, expect, it } from 'vitest';
+import { validateSupportTicketStatusTransition } from './support-ticket';
+
+describe('validateSupportTicketStatusTransition', () => {
+  it('allows DEVELOPING -> TESTING', () => {
+    expect(
+      validateSupportTicketStatusTransition('DEVELOPING', 'TESTING', {
+        linkedTaskCount: 1,
+        isSuperAdmin: true,
+      }).ok,
+    ).toBe(true);
+  });
+
+  it('blocks PENDING_REVIEW -> DEVELOPING without tasks', () => {
+    expect(
+      validateSupportTicketStatusTransition('PENDING_REVIEW', 'DEVELOPING', {
+        linkedTaskCount: 0,
+        isSuperAdmin: true,
+      }).ok,
+    ).toBe(false);
+  });
+
+  it('blocks rollback PASSED -> DEVELOPING', () => {
+    expect(
+      validateSupportTicketStatusTransition('PASSED', 'DEVELOPING', {
+        linkedTaskCount: 1,
+        isSuperAdmin: true,
+      }).ok,
+    ).toBe(false);
+  });
+
+  it('allows PASSED -> PUBLISHED', () => {
+    expect(
+      validateSupportTicketStatusTransition('PASSED', 'PUBLISHED', {
+        linkedTaskCount: 1,
+        isSuperAdmin: true,
+      }).ok,
+    ).toBe(true);
+  });
+
+  it('requires super admin and reason for REJECTED', () => {
+    expect(
+      validateSupportTicketStatusTransition('DEVELOPING', 'REJECTED', {
+        linkedTaskCount: 1,
+        isSuperAdmin: false,
+        rejectReason: 'x',
+      }).ok,
+    ).toBe(false);
+    expect(
+      validateSupportTicketStatusTransition('DEVELOPING', 'REJECTED', {
+        linkedTaskCount: 1,
+        isSuperAdmin: true,
+        rejectReason: '',
+      }).ok,
+    ).toBe(false);
+  });
+});

packages/domain/src/support-ticket.ts

@@ -0,0 +1,47 @@
+export type SupportTicketStatus =
+  | 'PENDING_REVIEW'
+  | 'REJECTED'
+  | 'DEVELOPING'
+  | 'TESTING'
+  | 'PASSED'
+  | 'PUBLISHED';
+
+export type SupportTicketStatusTransitionContext = {
+  linkedTaskCount: number;
+  isSuperAdmin: boolean;
+  rejectReason?: string;
+};
+
+const FORWARD_TRANSITIONS: Record<SupportTicketStatus, SupportTicketStatus[]> = {
+  PENDING_REVIEW: ['DEVELOPING', 'REJECTED'],
+  DEVELOPING: ['TESTING', 'REJECTED'],
+  TESTING: ['PASSED', 'REJECTED'],
+  REJECTED: [],
+  PASSED: ['PUBLISHED'],
+  PUBLISHED: [],
+};
+
+/** 技术支持工单批量/人工改状态校验（禁止回退） */
+export function validateSupportTicketStatusTransition(
+  from: SupportTicketStatus,
+  to: SupportTicketStatus,
+  ctx: SupportTicketStatusTransitionContext,
+): { ok: boolean; message?: string } {
+  if (from === to) return { ok: true };
+
+  const allowed = FORWARD_TRANSITIONS[from] ?? [];
+  if (!allowed.includes(to)) {
+    return { ok: false, message: `不允许从「${from}」变更为「${to}」` };
+  }
+
+  if (to === 'REJECTED') {
+    if (!ctx.isSuperAdmin) return { ok: false, message: '仅最高管理员可驳回工单' };
+    if (!ctx.rejectReason?.trim()) return { ok: false, message: '请填写驳回理由' };
+  }
+
+  if (from === 'PENDING_REVIEW' && to === 'DEVELOPING' && ctx.linkedTaskCount < 1) {
+    return { ok: false, message: '待评审工单转入开发须至少 1 条关联开发任务' };
+  }
+
+  return { ok: true };
+}

packages/shared-types/src/config.ts

@@ -32,29 +32,29 @@ export interface AppConfig {
   userH5Url: string;
 }
 
-/** 推广码 / C 端 H5 默认落地页（未配置 USER_H5_URL 时使用） */
+/** 推广码 / C 端 H5 默认落地页（系统设置 USER_H5_URL 未配时回退；HQ 可改） */
 export const DEFAULT_USER_H5_URL = 'https://user.runxian.top/user';
 
-/** 品牌 Logo OSS 根路径（改环境时只改此处） */
+/** 品牌 Logo OSS 根路径（默认；系统设置 BRAND_LOGO_OSS_BASE 可覆盖） */
 export const BRAND_LOGO_OSS_BASE = 'https://dukang-dev.oss-cn-beijing.aliyuncs.com/logo/';
 
-/** 方形 Logo（首页等品牌展示；商品列表顶栏仍用文字标题） */
+/** 方形 Logo（默认；系统设置 BRAND_LOGO_URL 可覆盖） */
 export const BRAND_LOGO_URL = `${BRAND_LOGO_OSS_BASE}logo.png`;
 
-/** 长方形 Logo（含文字，登录等场景） */
+/** 长方形 Logo（默认；系统设置 BRAND_LOGO_WIDE_URL 可覆盖） */
 export const BRAND_LOGO_WIDE_URL = `${BRAND_LOGO_OSS_BASE}logo1.png`;
 
-/** 仅图标 Logo（默认头像：未微信授权时） */
+/** 仅图标 Logo（默认；系统设置 BRAND_LOGO_MARK_URL 可覆盖） */
 export const BRAND_LOGO_MARK_URL = `${BRAND_LOGO_OSS_BASE}logo2.png`;
 
-/** 小程序静态资源（资质公示等） */
+/** 小程序静态资源根路径（默认；系统设置 MINI_USER_STATIC_OSS_BASE 可覆盖） */
 export const MINI_USER_STATIC_OSS_BASE =
   'https://dukang-dev.oss-cn-beijing.aliyuncs.com/static/mini-user/';
 
-/** 「我的」页资质公示长图 */
+/** 「我的」页资质公示长图（默认；系统设置 QUALIFICATION_DISCLOSURE_URL 可覆盖） */
 export const QUALIFICATION_DISCLOSURE_URL = `${MINI_USER_STATIC_OSS_BASE}qualification-disclosure.png`;
 
-/** 总部客服电话（C 端联系客服） */
+/** 总部客服电话（默认；系统设置 CUSTOMER_SERVICE_PHONE 可覆盖） */
 export const CUSTOMER_SERVICE_PHONE = '13203801799';
 
 /**
@@ -64,6 +64,137 @@ export const CUSTOMER_SERVICE_PHONE = '13203801799';
 export const CUSTOMER_SERVICE_WECOM_URL =
   'https://work.weixin.qq.com/kfid/kfc8b88659a1dffa8cd';
 
+/** 从 env / 系统设置解析的 C 端品牌与客服展示配置（缺省回退常量） */
+export type ClientBrandRuntime = {
+  userH5Url: string;
+  brandLogoOssBase: string;
+  brandLogoUrl: string;
+  brandLogoWideUrl: string;
+  brandLogoMarkUrl: string;
+  miniUserStaticOssBase: string;
+  qualificationDisclosureUrl: string;
+  customerServicePhone: string;
+};
+
+export function resolveClientBrandRuntime(
+  env?: Record<string, string | undefined>,
+): ClientBrandRuntime {
+  const e = readEnv(env);
+  const brandBase = (e.BRAND_LOGO_OSS_BASE || BRAND_LOGO_OSS_BASE).trim().replace(/\/*$/, '/');
+  const staticBase = (e.MINI_USER_STATIC_OSS_BASE || MINI_USER_STATIC_OSS_BASE)
+    .trim()
+    .replace(/\/*$/, '/');
+  return {
+    userH5Url: (e.USER_H5_URL || DEFAULT_USER_H5_URL).replace(/\/$/, ''),
+    brandLogoOssBase: brandBase,
+    brandLogoUrl: (e.BRAND_LOGO_URL || '').trim() || `${brandBase}logo.png`,
+    brandLogoWideUrl: (e.BRAND_LOGO_WIDE_URL || '').trim() || `${brandBase}logo1.png`,
+    brandLogoMarkUrl: (e.BRAND_LOGO_MARK_URL || '').trim() || `${brandBase}logo2.png`,
+    miniUserStaticOssBase: staticBase,
+    qualificationDisclosureUrl:
+      (e.QUALIFICATION_DISCLOSURE_URL || '').trim() ||
+      `${staticBase}qualification-disclosure.png`,
+    customerServicePhone: (e.CUSTOMER_SERVICE_PHONE || CUSTOMER_SERVICE_PHONE).trim(),
+  };
+}
+
+/** Mock 短信固定验证码（系统设置 MOCK_SMS_FIXED_CODE 可覆盖） */
+export function resolveMockSmsFixedCode(env?: Record<string, string | undefined>): string {
+  const code = (readEnv(env).MOCK_SMS_FIXED_CODE || '').trim();
+  return code || MOCK_SMS_FIXED_CODE;
+}
+
+/** 小程序 / H5 默认分享文案与引导（系统设置「小程序分享配置」可覆盖） */
+export const DEFAULT_SHARE_TITLE = '你吃饭，我买单';
+export const DEFAULT_SHARE_DESC = '杜康好客 · 买美酒，享好礼，全城门店可用';
+export const DEFAULT_SHARE_HINT = '请点击右上角 ··· 分享给好友';
+export const DEFAULT_SHARE_STORES_TITLE = '杜康好客门店';
+export const DEFAULT_SHARE_BENEFIT_TITLE = '好客权益 · 杜康好客';
+export const DEFAULT_SHARE_MINE_TITLE = '杜康好客 · 我的';
+/** 订单详情分享标题模板，可用 {productName} */
+export const DEFAULT_SHARE_ORDER_TITLE = '我买了{productName} · 杜康好客';
+
+export type MiniShareSceneConfig = {
+  title: string;
+  desc: string;
+  imageUrl: string;
+};
+
+/** 各场景分享文案/图（空字符串表示该字段走动态内容或默认分享） */
+export type MiniShareRuntime = {
+  hint: string;
+  default: MiniShareSceneConfig;
+  home: MiniShareSceneConfig;
+  stores: MiniShareSceneConfig;
+  storeDetail: MiniShareSceneConfig;
+  benefit: MiniShareSceneConfig;
+  mine: MiniShareSceneConfig;
+  productDetail: MiniShareSceneConfig;
+  orderDetail: MiniShareSceneConfig;
+};
+
+function pickShareScene(
+  e: Record<string, string | undefined>,
+  prefix: string,
+  fallback: Partial<MiniShareSceneConfig> = {},
+): MiniShareSceneConfig {
+  return {
+    title: (e[`${prefix}_TITLE`] || '').trim() || fallback.title || '',
+    desc: (e[`${prefix}_DESC`] || '').trim() || fallback.desc || '',
+    imageUrl: (e[`${prefix}_IMAGE_URL`] || '').trim() || fallback.imageUrl || '',
+  };
+}
+
+/** 从 env / 系统设置解析小程序分享配置 */
+export function resolveMiniShareRuntime(
+  env?: Record<string, string | undefined>,
+): MiniShareRuntime {
+  const e = readEnv(env);
+  const brand = resolveClientBrandRuntime(e);
+  const defaults: MiniShareSceneConfig = {
+    title: (e.SHARE_DEFAULT_TITLE || '').trim() || DEFAULT_SHARE_TITLE,
+    desc: (e.SHARE_DEFAULT_DESC || '').trim() || DEFAULT_SHARE_DESC,
+    imageUrl: (e.SHARE_DEFAULT_IMAGE_URL || '').trim() || brand.brandLogoUrl,
+  };
+  return {
+    hint: (e.SHARE_HINT || '').trim() || DEFAULT_SHARE_HINT,
+    default: defaults,
+    home: pickShareScene(e, 'SHARE_HOME', {
+      title: defaults.title,
+      desc: defaults.desc,
+    }),
+    stores: pickShareScene(e, 'SHARE_STORES', {
+      title: DEFAULT_SHARE_STORES_TITLE,
+      desc: defaults.desc,
+    }),
+    storeDetail: pickShareScene(e, 'SHARE_STORE_DETAIL'),
+    benefit: pickShareScene(e, 'SHARE_BENEFIT', {
+      title: DEFAULT_SHARE_BENEFIT_TITLE,
+      desc: defaults.desc,
+    }),
+    mine: pickShareScene(e, 'SHARE_MINE', {
+      title: DEFAULT_SHARE_MINE_TITLE,
+      desc: defaults.desc,
+    }),
+    productDetail: pickShareScene(e, 'SHARE_PRODUCT_DETAIL'),
+    orderDetail: pickShareScene(e, 'SHARE_ORDER_DETAIL', {
+      title: DEFAULT_SHARE_ORDER_TITLE,
+      desc: defaults.desc,
+    }),
+  };
+}
+
+/** 订单等标题模板：替换 {productName} 等占位符 */
+export function applyShareTitleTemplate(
+  template: string,
+  vars: Record<string, string | undefined | null>,
+): string {
+  return template.replace(/\{(\w+)\}/g, (_, key: string) => {
+    const v = vars[key];
+    return v != null && String(v).trim() ? String(v).trim() : '';
+  }).replace(/\s{2,}/g, ' ').trim();
+}
+
 function readEnv(env?: Record<string, string | undefined>) {
   return (
     env ??
@@ -142,5 +273,5 @@ export function loadAppConfig(env?: Record<string, string | undefined>): AppConf
   };
 }
 
-/** Mock 短信环境固定验证码 */
+/** Mock 短信环境固定验证码（默认；系统设置 MOCK_SMS_FIXED_CODE 可覆盖） */
 export const MOCK_SMS_FIXED_CODE = '999888';

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

@@ -202,6 +202,18 @@ export interface DevPlanTaskDispatchInput {
 
 
 
+export interface DevPlanTaskBatchUpdateInput {
+
+  taskIds: string[];
+
+  status?: DevPlanTaskStatusDto;
+
+  versionId?: string | null;
+
+}
+
+
+
 export interface DevPlanLinkedTaskSummary {
 
   id: string;

packages/shared-types/src/knowledge-base.ts

@@ -50,6 +50,20 @@ export type CreateKnowledgeDocumentRequest = {
   sizeBytes?: number | null;
 };
 
+export type UpdateKnowledgeDocumentRequest = {
+  title?: string;
+  contentText?: string | null;
+  fileName?: string | null;
+  fileUrl?: string | null;
+  mimeType?: string | null;
+  sizeBytes?: number | null;
+};
+
+/** 编辑文档时含正文 */
+export type KnowledgeDocumentDetailDto = KnowledgeDocumentDto & {
+  contentText: string | null;
+};
+
 export type KnowledgeBaseOptionDto = {
   id: string;
   name: string;

packages/shared-types/src/promo.ts

@@ -85,6 +85,50 @@ export function promoConversion(scan: number, orders: number): string {
   return `${Math.round((orders / scan) * 1000) / 10}%`;
 }
 
+export type PromoMetricEventType = 'SCAN' | 'ATTRIBUTION' | 'REGISTER' | 'ORDER';
+
+export const PROMO_METRIC_EVENT_LABELS: Record<PromoMetricEventType, string> = {
+  SCAN: '扫码进入',
+  ATTRIBUTION: '归因用户',
+  REGISTER: '扫码注册',
+  ORDER: '订单',
+};
+
+export type PromoMetricEventItem = {
+  id: string;
+  eventType: PromoMetricEventType;
+  userId: string | null;
+  orderId: string | null;
+  sessionId: string | null;
+  clientIp: string | null;
+  ipProvince: string | null;
+  ipCity: string | null;
+  createdAt: string;
+};
+
+export type PromoMetricTimelineBucket = {
+  key: string;
+  scan: number;
+  attribution: number;
+  register: number;
+  order: number;
+};
+
+export type PromoMetricTimelinePeak = {
+  scan: { key: string; count: number } | null;
+  attribution: { key: string; count: number } | null;
+  register: { key: string; count: number } | null;
+  order: { key: string; count: number } | null;
+};
+
+export type PromoMetricTimelineDto = {
+  granularity: 'day' | 'hour';
+  dateFrom: string;
+  dateTo: string;
+  buckets: PromoMetricTimelineBucket[];
+  peak: PromoMetricTimelinePeak;
+};
+
 export function buildPromoLandingUrl(baseUrl: string, code: string, qrcodeId: string): string {
   const base = baseUrl.replace(/\/$/, '');
   return `${base}/?promo=${encodeURIComponent(code)}&pid=${encodeURIComponent(qrcodeId)}`;

packages/shared-types/src/settlement.ts

@@ -63,7 +63,6 @@ export interface StoreWithdrawSummaryDto {
   remainingDailyLimit: number;
   isPrimary: boolean;
   hasBankAccount: boolean;
-  hasPendingRequest: boolean;
   bankAccount?: StoreWithdrawBankAccountDto | null;
 }
 
@@ -184,6 +183,9 @@ export const STORE_SETTLEMENT_DEFAULT_RATE = 0.6;
 /** 酒厂账单结算比例（酒单实付 × 比例），暂定 30% */
 export const WINERY_SETTLEMENT_RATE = 0.3;
 
+/** 酒厂账单出账滞后自然日（T+3：订单完成日 + 3 天后纳入账单） */
+export const WINERY_SETTLEMENT_LAG_DAYS = 3;
+
 export type { LogisticsSettlementMethod } from './enums';
 export { LOGISTICS_SETTLEMENT_METHOD_LABELS } from './enums';
 import type { LogisticsSettlementMethod } from './enums';

packages/shared-types/src/store-package.ts

@@ -5,6 +5,7 @@ export interface StorePackageItemDto {
   dishes: string;
   usableTime?: string | null;
   otherNotes?: string | null;
+  imageUrl?: string | null;
   sortOrder: number;
 }
 

packages/shared-types/src/support-ticket.ts

@@ -15,7 +15,8 @@ export type SupportTicketStatusDto =
   | 'REJECTED'
   | 'DEVELOPING'
   | 'TESTING'
-  | 'PASSED';
+  | 'PASSED'
+  | 'PUBLISHED';
 
 export const SUPPORT_TICKET_STATUSES = [
   'PENDING_REVIEW',
@@ -23,6 +24,7 @@ export const SUPPORT_TICKET_STATUSES = [
   'DEVELOPING',
   'TESTING',
   'PASSED',
+  'PUBLISHED',
 ] as const;
 
 export const SUPPORT_TICKET_STATUS_LABELS: Record<SupportTicketStatusDto, string> = {
@@ -31,6 +33,19 @@ export const SUPPORT_TICKET_STATUS_LABELS: Record<SupportTicketStatusDto, string
   DEVELOPING: '开发',
   TESTING: '测试',
   PASSED: '通过',
+  PUBLISHED: '已发布',
+};
+
+/** 技术支持工单优先级 */
+export type SupportTicketPriorityDto = 'LOW' | 'NORMAL' | 'HIGH' | 'URGENT';
+
+export const SUPPORT_TICKET_PRIORITIES = ['LOW', 'NORMAL', 'HIGH', 'URGENT'] as const;
+
+export const SUPPORT_TICKET_PRIORITY_LABELS: Record<SupportTicketPriorityDto, string> = {
+  LOW: '低',
+  NORMAL: '普通',
+  HIGH: '高',
+  URGENT: '紧急',
 };
 
 export interface SupportTicketDto {
@@ -38,6 +53,7 @@ export interface SupportTicketDto {
   ticketNo: string;
   ticketType: SupportTicketTypeDto;
   status: SupportTicketStatusDto;
+  priority: SupportTicketPriorityDto;
   title: string;
   content?: string | null;
   rejectReason?: string | null;
@@ -47,9 +63,12 @@ export interface SupportTicketDto {
   reviewerName?: string | null;
   reviewedAt?: string | null;
   remark?: string | null;
+  attachmentUrls?: string[] | null;
   createdAt: string;
   updatedAt: string;
   completedAt?: string | null;
+  releasedVersionNo?: string | null;
+  publishedAt?: string | null;
 }
 
 export interface CreateSupportTicketRequest {
@@ -57,6 +76,17 @@ export interface CreateSupportTicketRequest {
   title: string;
   content?: string;
   remark?: string;
+  attachmentUrls?: string[];
+  priority?: SupportTicketPriorityDto;
+}
+
+export interface UpdateSupportTicketRequest {
+  ticketType?: SupportTicketTypeDto;
+  title?: string;
+  content?: string;
+  remark?: string;
+  attachmentUrls?: string[];
+  priority?: SupportTicketPriorityDto;
 }
 
 export interface RejectSupportTicketRequest {
@@ -73,6 +103,8 @@ export interface ReviewSupportTicketRequest {
   rejectReason?: string;
   note?: string;
   tasks?: CreateDevPlanTaskFromTicketInput[];
+  dispatchToWecom?: boolean;
+  dispatchSupplement?: string;
 }
 
 export interface SupportTicketLinkedTaskDto {
@@ -108,3 +140,10 @@ export interface BatchReviewConfirmItem {
 export interface BatchReviewConfirmRequest {
   items: BatchReviewConfirmItem[];
 }
+
+export interface BatchUpdateSupportTicketStatusRequest {
+  ticketIds: string[];
+  status: SupportTicketStatusDto;
+  rejectReason?: string;
+  note?: string;
+}

packages/shared-types/src/ticket.ts

@@ -27,6 +27,30 @@ export const TICKET_TYPE_LABELS: Record<TicketTypeDto, string> = {
   PACKAGE_DISPUTE: '套餐异议',
 };
 
+/** 售后工单状态（common_ticket.status） */
+export type TicketStatusDto =
+  | 'PENDING'
+  | 'OPEN'
+  | 'COLLABORATING'
+  | 'RESOLVED'
+  | 'REJECTED'
+  | 'COMPLETED'
+  | 'CLOSED';
+
+export const TICKET_STATUS_LABELS: Record<TicketStatusDto, string> = {
+  PENDING: '待处理',
+  OPEN: '处理中',
+  COLLABORATING: '协同中',
+  RESOLVED: '已解决',
+  REJECTED: '已驳回',
+  COMPLETED: '已完成',
+  CLOSED: '已关闭',
+};
+
+export function ticketStatusLabel(status: string): string {
+  return TICKET_STATUS_LABELS[status as TicketStatusDto] ?? status;
+}
+
 export interface TicketDto {
   id: string;
   ticketNo: string;

packages/shared-types/src/trade.ts

@@ -70,6 +70,30 @@ export interface DeliveryDto {
   deliveredAt?: string;
 }
 
+/** 物流路由节点（C 端 track API） */
+export interface OrderTrackNodeDto {
+  trackInfo: string;
+  createTime: string;
+  statusName?: string;
+}
+
+/** 小飞侠 cmd=100301 预估送达 */
+export interface OrderTrackEstimatedArrivalDto {
+  arriveTime: string;
+  siteName?: string;
+}
+
+/** GET /trade/orders/:id/track 响应 */
+export interface OrderTrackDto {
+  nodes: OrderTrackNodeDto[];
+  signPhotoUrls: string[];
+  estimatedArrival?: OrderTrackEstimatedArrivalDto | null;
+  manualQueryUrl?: string | null;
+  provider?: string;
+  trackingNo?: string | null;
+  logisticsCompany?: string | null;
+}
+
 /** 大单拦截原因：≥10 箱不自动推小飞侠 */
 export const FULFILLMENT_HOLD_REASON_LABELS: Record<string, string> = {
   LARGE_ORDER_GE_10_BOXES: '大单≥10箱，待总部确认推单/自配送',

packages/shared-types/src/wechat.ts

@@ -1,3 +1,5 @@
+import type { MiniShareRuntime } from './config';
+
 /** 微信 JSSDK 初始化参数（后端签名下发） */
 export interface WechatJssdkConfig {
   appId: string;
@@ -48,6 +50,22 @@ export type ClientRuntimeConfig = {
     banners: string[];
     footerUrl: string | null;
   };
+  /** 小程序最低兼容版本（semver，如 3.4.13）；客户端低于此值时提示更新 */
+  minClientVersion?: string | null;
+  /** C 端 H5 落地页（推广码等） */
+  userH5Url?: string;
+  /** 方形品牌 Logo */
+  brandLogoUrl?: string;
+  /** 长方形品牌 Logo（登录） */
+  brandLogoWideUrl?: string;
+  /** 图标 Logo（默认头像） */
+  brandLogoMarkUrl?: string;
+  /** 「我的」资质公示长图 */
+  qualificationDisclosureUrl?: string;
+  /** 总部客服电话 */
+  customerServicePhone?: string;
+  /** 小程序各场景分享文案/图 */
+  share?: MiniShareRuntime;
 };
 
 /** 是否展示微信授权入口 */

packages/shared-ui/package.json

@@ -11,7 +11,8 @@
     "./CouponBadge": "./src/CouponBadge.tsx",
     "./OrderStatusTabs": "./src/OrderStatusTabs.tsx",
     "./AppImage": "./src/AppImage.tsx",
-    "./PullToRefresh": "./src/PullToRefresh.tsx"
+    "./PullToRefresh": "./src/PullToRefresh.tsx",
+    "./compressImage": "./src/compressImage.ts"
   },
   "peerDependencies": {
     "react": "^18.3.1"

packages/shared-ui/src/compressImage.ts

@@ -0,0 +1,90 @@
+/** OSS 单文件上限（与后端 OSS_MAX_UPLOAD_BYTES 默认一致） */
+export const DEFAULT_OSS_MAX_UPLOAD_BYTES = 10 * 1024 * 1024;
+
+function isCompressibleImage(file: File): boolean {
+  if (!file.type.startsWith('image/')) return false;
+  if (file.type === 'image/svg+xml' || file.type === 'image/gif') return false;
+  return true;
+}
+
+function loadImage(file: File): Promise<HTMLImageElement> {
+  return new Promise((resolve, reject) => {
+    const url = URL.createObjectURL(file);
+    const img = new Image();
+    img.onload = () => {
+      URL.revokeObjectURL(url);
+      resolve(img);
+    };
+    img.onerror = () => {
+      URL.revokeObjectURL(url);
+      reject(new Error('图片读取失败'));
+    };
+    img.src = url;
+  });
+}
+
+function canvasToBlob(canvas: HTMLCanvasElement, type: string, quality: number): Promise<Blob> {
+  return new Promise((resolve, reject) => {
+    canvas.toBlob(
+      (blob) => (blob ? resolve(blob) : reject(new Error('图片压缩失败'))),
+      type,
+      quality,
+    );
+  });
+}
+
+async function renderScaled(
+  img: HTMLImageElement,
+  maxEdge: number,
+  quality: number,
+  mime: string,
+): Promise<Blob> {
+  const w = img.naturalWidth;
+  const h = img.naturalHeight;
+  const scale = Math.min(1, maxEdge / Math.max(w, h));
+  const cw = Math.max(1, Math.round(w * scale));
+  const ch = Math.max(1, Math.round(h * scale));
+  const canvas = document.createElement('canvas');
+  canvas.width = cw;
+  canvas.height = ch;
+  const ctx = canvas.getContext('2d');
+  if (!ctx) throw new Error('图片压缩失败');
+  ctx.drawImage(img, 0, 0, cw, ch);
+  return canvasToBlob(canvas, mime, quality);
+}
+
+/**
+ * 超过 maxBytes 的图片用 canvas 压缩后再上传；不可压缩或非图片原样返回。
+ */
+export async function compressImageFileIfNeeded(
+  file: File,
+  maxBytes = DEFAULT_OSS_MAX_UPLOAD_BYTES,
+): Promise<File> {
+  if (!isCompressibleImage(file) || file.size <= maxBytes) return file;
+
+  const img = await loadImage(file);
+  const mime = file.type === 'image/png' || file.type === 'image/webp' ? 'image/jpeg' : file.type || 'image/jpeg';
+  const edges = [4096, 3072, 2048, 1536, 1280, 1024, 800];
+  let best: Blob | null = null;
+
+  outer: for (const edge of edges) {
+    for (let quality = 0.92; quality >= 0.5; quality -= 0.08) {
+      const blob = await renderScaled(img, edge, quality, mime);
+      if (!best || blob.size < best.size) best = blob;
+      if (blob.size <= maxBytes) {
+        best = blob;
+        break outer;
+      }
+    }
+  }
+
+  if (!best || best.size >= file.size) return file;
+
+  const ext = mime === 'image/png' ? '.png' : '.jpg';
+  const baseName = file.name.replace(/\.[^.]+$/, '') || 'image';
+  return new File([best], `${baseName}${ext}`, { type: mime, lastModified: Date.now() });
+}
+
+export function formatOssMaxSizeMb(maxBytes = DEFAULT_OSS_MAX_UPLOAD_BYTES): number {
+  return Math.floor(maxBytes / 1024 / 1024);
+}

packages/weixin-sdk/src/index.ts

@@ -1,4 +1,4 @@
-export { isWechatBrowser, isMiniProgram, getRuntimePlatform } from './env';
+export { isWechatBrowser, isMiniProgram, getRuntimePlatform, isIosDevice, isWechatDevTools } from './env';
 export { getRouterBasename, toAppPath, isOnAppPath } from './app-path';
 export {
   initWechatJssdk,
@@ -10,7 +10,7 @@ export {
   resetJssdkConfig,
   stripOAuthParamsFromLocation,
 } from './jssdk';
-export { formatScanFailMessage } from './scan';
+export { formatScanFailMessage, isScanPermissionWarmupError } from './scan';
 export {
   getWechatLocation,
   getWechatLocationDetailed,

packages/weixin-sdk/src/scan.ts

@@ -38,7 +38,7 @@ export function formatScanFailMessage(errMsg: string): string {
   return msg;
 }
 
-function isScanPermissionWarmupError(msg: string): boolean {
+export function isScanPermissionWarmupError(msg: string): boolean {
   return /offline verifying|permission value is offline|权限验证中|接口未就绪|invalid signature|config:fail|signature/i.test(
     msg,
   );
@@ -134,15 +134,13 @@ export async function scanQrCode(
       throw new Error('当前微信版本不支持扫码，请升级微信后重试');
     }
 
-    // wx.ready ≠ 权限离线校验完成；授权回跳后更明显
+    const ios = isIosDevice() && !isWechatDevTools();
-    const warmupMs = options.postAuthWarmup
+
-      ? 1200
+    // wx.ready ≠ 权限离线校验完成；OAuth 回跳后 iOS 更明显
-      : isIosDevice() && !isWechatDevTools()
+    const warmupMs = options.postAuthWarmup ? (ios ? 1600 : 1000) : ios ? 800 : 300;
-        ? 800
-        : 300;
     await delay(warmupMs);
 
-    const maxAttempts = options.postAuthWarmup ? 3 : 2;
+    const maxAttempts = options.postAuthWarmup ? (ios ? 4 : 3) : 2;
     let lastError: Error | null = null;
     for (let attempt = 0; attempt < maxAttempts; attempt++) {
       if (attempt > 0) {
@@ -151,7 +149,8 @@ export async function scanQrCode(
           await initWechatJssdk({ ...jssdkOptions, url: getJssdkSignUrl() });
           await checkJsApi('scanQRCode');
         }
-        await delay(700 + attempt * 500);
+        const retryDelay = options.postAuthWarmup && ios ? 900 + attempt * 700 : 700 + attempt * 500;
+        await delay(retryDelay);
       }
       try {
         return await invokeScanQrCode();

pnpm-lock.yaml

@@ -29,6 +29,9 @@ importers:
       '@dukang/shared-types':
         specifier: workspace:*
         version: link:../../packages/shared-types
+      '@dukang/shared-ui':
+        specifier: workspace:*
+        version: link:../../packages/shared-ui
       antd:
         specifier: ^5.22.0
         version: 5.29.3(luxon@3.7.2)(moment@2.30.1)(react-dom@18.3.1(react@18.3.1))(react@18.3.1)

server/dukang-api/prisma/schema.prisma

@@ -107,6 +107,14 @@ enum SupportTicketStatus {
   DEVELOPING
   TESTING
   PASSED
+  PUBLISHED
+}
+
+enum SupportTicketPriority {
+  LOW
+  NORMAL
+  HIGH
+  URGENT
 }
 
 enum DevPlanTaskType {
@@ -174,6 +182,13 @@ enum PromoCodeScene {
   OTHER
 }
 
+enum PromoMetricEventType {
+  SCAN
+  ATTRIBUTION
+  REGISTER
+  ORDER
+}
+
 enum CityStatus {
   PENDING
   ACTIVE
@@ -646,6 +661,7 @@ model CommonSupportTicket {
   ticketNo     String               @unique @map("ticket_no") @db.VarChar(32)
   ticketType   SupportTicketType    @map("ticket_type")
   status       SupportTicketStatus  @default(PENDING_REVIEW)
+  priority     SupportTicketPriority @default(NORMAL) @map("priority")
   title        String               @db.VarChar(128)
   content      String?              @db.Text
   rejectReason String?              @map("reject_reason") @db.VarChar(512)
@@ -655,6 +671,9 @@ model CommonSupportTicket {
   reviewerName String?              @map("reviewer_name") @db.VarChar(64)
   reviewedAt   DateTime?            @map("reviewed_at") @db.DateTime(3)
   remark       String?              @db.VarChar(512)
+  attachmentUrls Json?              @map("attachment_urls")
+  releasedVersionNo String?         @map("released_version_no") @db.VarChar(32)
+  publishedAt  DateTime?            @map("published_at") @db.DateTime(3)
   createdAt    DateTime             @default(now()) @map("created_at") @db.DateTime(3)
   updatedAt    DateTime             @updatedAt @map("updated_at") @db.DateTime(3)
   completedAt  DateTime?            @map("completed_at") @db.DateTime(3)
@@ -662,6 +681,7 @@ model CommonSupportTicket {
   @@index([status, createdAt])
   @@index([ticketType, status])
   @@index([creatorId])
+  @@index([releasedVersionNo])
   @@map("common_support_ticket")
 
   devPlanTasks DevPlanTask[]
@@ -847,6 +867,7 @@ model CommonPromoCode {
   qrcodeResource CommonResource?        @relation("PromoQrcode", fields: [qrcodeResourceId], references: [id], onDelete: SetNull)
   attributions   UserPromoAttribution[]
   orders         Order[]
+  metricEvents   LogPromoEvent[]
 
   @@index([ownerUserId])
   @@index([scene, status])
@@ -1278,6 +1299,7 @@ model StorePackage {
   dishes     String   @db.Text
   usableTime String?  @map("usable_time") @db.VarChar(256)
   otherNotes String?  @map("other_notes") @db.VarChar(512)
+  imageUrl   String?  @map("image_url") @db.VarChar(512)
   sortOrder  Int      @default(0) @map("sort_order")
   createdAt  DateTime @default(now()) @map("created_at") @db.DateTime(3)
   updatedAt  DateTime @updatedAt @map("updated_at") @db.DateTime(3)
@@ -1749,6 +1771,25 @@ model LogThirdParty {
   @@map("log_third_party")
 }
 
+model LogPromoEvent {
+  id          BigInt               @id @default(autoincrement()) @db.UnsignedBigInt
+  promoCodeId BigInt               @map("promo_code_id") @db.UnsignedBigInt
+  eventType   PromoMetricEventType @map("event_type")
+  userId      BigInt?              @map("user_id") @db.UnsignedBigInt
+  orderId     BigInt?              @map("order_id") @db.UnsignedBigInt
+  sessionId   String?              @map("session_id") @db.VarChar(64)
+  clientIp    String?              @map("client_ip") @db.VarChar(45)
+  ipProvince  String?              @map("ip_province") @db.VarChar(32)
+  ipCity      String?              @map("ip_city") @db.VarChar(32)
+  createdAt   DateTime             @default(now()) @map("created_at") @db.DateTime(3)
+
+  promoCode CommonPromoCode @relation(fields: [promoCodeId], references: [id], onDelete: Cascade)
+
+  @@index([promoCodeId, eventType, createdAt])
+  @@index([createdAt])
+  @@map("log_promo_event")
+}
+
 model LogUserAnalytics {
   id         BigInt     @id @default(autoincrement()) @db.UnsignedBigInt
   userId     BigInt?    @map("user_id") @db.UnsignedBigInt

server/dukang-api/src/callbacks/callbacks.module.ts

@@ -6,9 +6,12 @@ import { WechatPayCallbackController } from './wechat-pay.controller';
 import { WechatRefundCallbackController } from './wechat-refund.controller';
 import { WechatMessageCallbackController } from './wechat-message.controller';
 import { DeliveryCallbackController } from './delivery-track.controller';
+import { DeliveryCallbackService } from './delivery-callback.service';
+import { CourierModule } from '../integrations/courier/courier.module';
 
 @Module({
-  imports: [IntegrationsModule, TradeModule, PrismaModule],
+  imports: [IntegrationsModule, TradeModule, PrismaModule, CourierModule],
+  providers: [DeliveryCallbackService],
   controllers: [
     WechatPayCallbackController,
     WechatRefundCallbackController,

server/dukang-api/src/callbacks/delivery-callback.service.ts

@@ -0,0 +1,108 @@
+import { Injectable } from '@nestjs/common';
+import { PrismaService } from '../common/prisma/prisma.module';
+import { CourierService } from '../integrations/courier/courier.service';
+import { XiaofeixiaProvider } from '../integrations/courier/xiaofeixia/xiaofeixia.provider';
+import { logCourierCall } from '../integrations/courier/courier-log.util';
+import { TradeService } from '../modules/trade/trade.service';
+
+const XFX_PROVIDER_ALIASES = new Set(['xfx', 'xiaofeixia']);
+
+@Injectable()
+export class DeliveryCallbackService {
+  constructor(
+    private readonly prisma: PrismaService,
+    private readonly courier: CourierService,
+    private readonly xiaofeixiaProvider: XiaofeixiaProvider,
+    private readonly tradeService: TradeService,
+  ) {}
+
+  async handleTrackCallback(providerKey: string, body: unknown, requestUrl: string) {
+    const normalized = providerKey.trim().toLowerCase();
+    const baseLog = {
+      scene: 'TRACK_CALLBACK',
+      requestUrl,
+      requestBody: (body && typeof body === 'object' ? body : { value: body }) as Record<
+        string,
+        unknown
+      >,
+    };
+
+    if (!XFX_PROVIDER_ALIASES.has(normalized) && normalized !== 'logistics') {
+      await logCourierCall(this.prisma, {
+        ...baseLog,
+        status: 'FAILED',
+        errorMessage: `不支持的承运商: ${providerKey}`,
+      });
+      return this.courier.buildTrackCallbackResponse(false);
+    }
+
+    if (normalized === 'logistics') {
+      await logCourierCall(this.prisma, {
+        ...baseLog,
+        status: 'SUCCESS',
+        errorMessage: '跨城物流回调暂未接入，已记录',
+      });
+      return this.courier.buildTrackCallbackResponse(true);
+    }
+
+    const payload = this.xiaofeixiaProvider.parseTrackCallback(body);
+    if (!payload) {
+      const response = this.courier.buildTrackCallbackResponse(false);
+      await logCourierCall(this.prisma, {
+        ...baseLog,
+        responseBody: response,
+        status: 'FAILED',
+        errorMessage: '回调体解析失败',
+      });
+      return response;
+    }
+
+    const order = payload.outNumber
+      ? await this.prisma.order.findUnique({ where: { orderNo: payload.outNumber } })
+      : payload.trackingNumber
+        ? await this.prisma.order.findFirst({
+            where: { delivery: { trackingNo: payload.trackingNumber } },
+          })
+        : null;
+
+    if (!order) {
+      const response = this.courier.buildTrackCallbackResponse(false);
+      await logCourierCall(this.prisma, {
+        ...baseLog,
+        responseBody: response,
+        status: 'FAILED',
+        errorMessage: '订单不存在',
+        externalNo: payload.outNumber || payload.trackingNumber,
+      });
+      return response;
+    }
+
+    const targetStatus = this.xiaofeixiaProvider.mapTrackStatus(
+      payload.status,
+      payload.statusName,
+    );
+    let applied = false;
+    if (targetStatus && targetStatus !== order.status) {
+      await this.tradeService.applyStatusTransition(
+        order.id,
+        order.status,
+        targetStatus,
+        'COURIER_TRACK_CALLBACK',
+        payload.trackInfo || payload.statusName,
+      );
+      applied = true;
+    }
+
+    const response = this.courier.buildTrackCallbackResponse(true);
+    await logCourierCall(this.prisma, {
+      ...baseLog,
+      responseBody: response,
+      status: 'SUCCESS',
+      externalNo: order.orderNo,
+      ref: { refType: 'ORDER', refId: order.id },
+      errorMessage: applied ? undefined : '状态未变更',
+    });
+
+    return response;
+  }
+}

server/dukang-api/src/callbacks/delivery-track.controller.ts

@@ -1,71 +1,35 @@
-import { Body, Controller, Post } from '@nestjs/common';
+import { Body, Controller, Param, Post, Res } from '@nestjs/common';
-import { TradeService } from '../modules/trade/trade.service';
+import type { Response } from 'express';
-import { CourierService } from '../integrations/courier/courier.service';
+import { DeliveryCallbackService } from './delivery-callback.service';
-import { PrismaService } from '../common/prisma/prisma.module';
-import { logCourierCall } from '../integrations/courier/courier-log.util';
 
-@Controller('callbacks/delivery')
+@Controller('callbacks')
 export class DeliveryCallbackController {
-  constructor(
+  constructor(private readonly deliveryCallbackService: DeliveryCallbackService) {}
-    private readonly tradeService: TradeService,
-    private readonly courier: CourierService,
-    private readonly prisma: PrismaService,
-  ) {}
 
-  @Post('track')
+  /** 小飞侠/物流路由变化回调（适配器入口） */
-  async track(@Body() body: { orderNo?: string; orderId?: string; status?: string }) {
+  @Post('courier/:provider/track')
-    const baseLog = {
+  async trackByProvider(
-      scene: 'TRACK_CALLBACK',
+    @Param('provider') provider: string,
-      requestUrl: '/api/v1/callbacks/delivery/track',
+    @Body() body: unknown,
-      requestBody: body as Record<string, unknown>,
+    @Res() res: Response,
-    };
+  ) {
+    const result = await this.deliveryCallbackService.handleTrackCallback(
+      provider,
+      body,
+      `/api/v1/callbacks/courier/${provider}/track`,
+    );
+    // 直出承运商约定结构，避免被全局 { code:0, data } 包装
+    return res.status(200).json(result);
+  }
 
-    if (!body.orderId && !body.orderNo) {
+  /** 兼容旧路径，默认按小飞侠解析 */
-      await logCourierCall(this.prisma, {
+  @Post('delivery/track')
-        ...baseLog,
+  async trackLegacy(@Body() body: unknown, @Res() res: Response) {
-        status: 'FAILED',
+    const result = await this.deliveryCallbackService.handleTrackCallback(
-        errorMessage: '缺少 orderId / orderNo',
+      'xfx',
-      });
+      body,
-      return this.courier.buildTrackCallbackResponse(false);
+      '/api/v1/callbacks/delivery/track',
-    }
+    );
-
+    return res.status(200).json(result);
-    const order = body.orderId
-      ? await this.prisma.order.findUnique({ where: { id: BigInt(body.orderId) } })
-      : await this.prisma.order.findUnique({ where: { orderNo: body.orderNo! } });
-
-    if (!order) {
-      await logCourierCall(this.prisma, {
-        ...baseLog,
-        status: 'FAILED',
-        errorMessage: '订单不存在',
-        externalNo: body.orderNo,
-      });
-      return this.courier.buildTrackCallbackResponse(false);
-    }
-
-    const statusMap: Record<string, string> = {
-      SHIPPED: 'SHIPPING',
-      OUT_WAREHOUSE: 'OUT_WAREHOUSE',
-      DELIVERED: 'COMPLETED',
-      COMPLETED: 'COMPLETED',
-    };
-    const target = statusMap[body.status ?? ''] ?? body.status;
-    let applied = false;
-    if (target && target !== order.status) {
-      await this.tradeService.applyStatusTransition(order.id, order.status, target, 'DELIVERY_CALLBACK');
-      applied = true;
-    }
-
-    const response = this.courier.buildTrackCallbackResponse(true);
-    await logCourierCall(this.prisma, {
-      ...baseLog,
-      responseBody: response,
-      status: 'SUCCESS',
-      externalNo: order.orderNo,
-      ref: { refType: 'ORDER', refId: order.id },
-      errorMessage: applied ? undefined : '状态未变更',
-    });
-
-    return response;
   }
 }

server/dukang-api/src/common/hq-operation/hq-operation.constants.ts

@@ -96,6 +96,7 @@ export const HqOperationAction = {
   KNOWLEDGE_BASE_UPDATE: 'KNOWLEDGE_BASE_UPDATE',
   KNOWLEDGE_BASE_DELETE: 'KNOWLEDGE_BASE_DELETE',
   KNOWLEDGE_DOC_CREATE: 'KNOWLEDGE_DOC_CREATE',
+  KNOWLEDGE_DOC_UPDATE: 'KNOWLEDGE_DOC_UPDATE',
   KNOWLEDGE_DOC_DELETE: 'KNOWLEDGE_DOC_DELETE',
   REDEEM_PENDING_COMPLETE: 'REDEEM_PENDING_COMPLETE',
   REDEEM_PENDING_REJECT: 'REDEEM_PENDING_REJECT',
@@ -218,6 +219,7 @@ export const HQ_OPERATION_ACTION_LABELS: Record<string, string> = {
   [HqOperationAction.KNOWLEDGE_BASE_UPDATE]: '更新知识库',
   [HqOperationAction.KNOWLEDGE_BASE_DELETE]: '删除知识库',
   [HqOperationAction.KNOWLEDGE_DOC_CREATE]: '上传知识库文档',
+  [HqOperationAction.KNOWLEDGE_DOC_UPDATE]: '编辑知识库文档',
   [HqOperationAction.KNOWLEDGE_DOC_DELETE]: '删除知识库文档',
   [HqOperationAction.REDEEM_PENDING_COMPLETE]: '弱网待处理单-补核销',
   [HqOperationAction.REDEEM_PENDING_REJECT]: '弱网待处理单-驳回',

server/dukang-api/src/common/system-config/system-config.registry.ts

@@ -1,4 +1,22 @@
 import type { SystemConfigFieldMeta, SystemConfigGroupMeta } from '@dukang/shared-types';
+import {
+  BRAND_LOGO_MARK_URL,
+  BRAND_LOGO_OSS_BASE,
+  BRAND_LOGO_URL,
+  BRAND_LOGO_WIDE_URL,
+  CUSTOMER_SERVICE_PHONE,
+  DEFAULT_SHARE_BENEFIT_TITLE,
+  DEFAULT_SHARE_DESC,
+  DEFAULT_SHARE_HINT,
+  DEFAULT_SHARE_MINE_TITLE,
+  DEFAULT_SHARE_ORDER_TITLE,
+  DEFAULT_SHARE_STORES_TITLE,
+  DEFAULT_SHARE_TITLE,
+  DEFAULT_USER_H5_URL,
+  MINI_USER_STATIC_OSS_BASE,
+  MOCK_SMS_FIXED_CODE,
+  QUALIFICATION_DISCLOSURE_URL,
+} from '@dukang/shared-types';
 
 /** 运行环境、安全与鉴权仅保留在 .env，不在 HQ 系统设置中维护 */
 export const SYSTEM_CONFIG_GROUPS: SystemConfigGroupMeta[] = [
@@ -6,6 +24,7 @@ export const SYSTEM_CONFIG_GROUPS: SystemConfigGroupMeta[] = [
   { key: 'sms', label: '短信' },
   { key: 'wechat', label: '微信' },
   { key: 'wechat_mini', label: '微信小程序配置' },
+  { key: 'wechat_mini_share', label: '小程序分享配置' },
   { key: 'oss', label: '对象存储 OSS' },
   { key: 'app', label: '应用链接' },
   { key: 'deploy', label: '发布部署' },
@@ -18,6 +37,7 @@ const G = {
   sms: 'sms',
   wechat: 'wechat',
   wechat_mini: 'wechat_mini',
+  wechat_mini_share: 'wechat_mini_share',
   oss: 'oss',
   app: 'app',
   deploy: 'deploy',
@@ -116,6 +136,288 @@ export const SYSTEM_CONFIG_FIELDS: SystemConfigFieldMeta[] = [
     requiresRestart: false,
     description: '小程序商品首页底部 footer，建议比例 15:4；上传后需点击右上角「保存」',
   },
+  {
+    key: 'MINI_USER_MIN_VERSION',
+    label: '小程序最低版本',
+    group: G.wechat_mini,
+    type: 'string',
+    requiresRestart: false,
+    placeholder: '3.4.14',
+    description: 'semver 格式；客户端低于此版本时提示更新',
+  },
+  {
+    key: 'USER_H5_URL',
+    label: 'C 端 H5 落地页',
+    group: G.wechat_mini,
+    type: 'string',
+    requiresRestart: false,
+    placeholder: 'https://user.example.com/user',
+    description: '推广码二维码 / 未配置时的默认落地页前缀（无末尾斜杠）',
+  },
+  {
+    key: 'BRAND_LOGO_OSS_BASE',
+    label: '品牌 Logo OSS 根路径',
+    group: G.wechat_mini,
+    type: 'string',
+    requiresRestart: false,
+    placeholder: 'https://xxx.oss-cn-beijing.aliyuncs.com/logo/',
+    description: '仅作说明/备份；下方三张 Logo 请直接配置完整 URL',
+  },
+  {
+    key: 'BRAND_LOGO_URL',
+    label: '方形 Logo',
+    group: G.wechat_mini,
+    type: 'image',
+    requiresRestart: false,
+    description: '品牌方形 Logo；分享默认图未单独配置时回退此图',
+  },
+  {
+    key: 'BRAND_LOGO_WIDE_URL',
+    label: '长方形 Logo',
+    group: G.wechat_mini,
+    type: 'image',
+    requiresRestart: false,
+    description: '含文字，登录页等场景',
+  },
+  {
+    key: 'BRAND_LOGO_MARK_URL',
+    label: '图标 Logo',
+    group: G.wechat_mini,
+    type: 'image',
+    requiresRestart: false,
+    description: '默认头像（未微信授权时）',
+  },
+  {
+    key: 'MINI_USER_STATIC_OSS_BASE',
+    label: '小程序静态资源 OSS 根路径',
+    group: G.wechat_mini,
+    type: 'string',
+    requiresRestart: false,
+    placeholder: 'https://xxx.oss-cn-beijing.aliyuncs.com/static/mini-user/',
+    description: '资质公示等静态资源根路径；完整 URL 优先用下方「资质公示图」',
+  },
+  {
+    key: 'QUALIFICATION_DISCLOSURE_URL',
+    label: '资质公示长图',
+    group: G.wechat_mini,
+    type: 'image',
+    requiresRestart: false,
+    description: '「我的」页资质公示大图',
+  },
+  {
+    key: 'CUSTOMER_SERVICE_PHONE',
+    label: '总部客服电话',
+    group: G.wechat_mini,
+    type: 'string',
+    requiresRestart: false,
+    placeholder: '13203801799',
+    description: 'C 端联系客服拨号号码',
+  },
+  {
+    key: 'MOCK_SMS_FIXED_CODE',
+    label: 'Mock 短信固定验证码',
+    group: G.wechat_mini,
+    type: 'string',
+    requiresRestart: false,
+    placeholder: '999888',
+    description: '仅 MOCK_SMS 开启时生效；留空则用默认 999888',
+  },
+
+  // —— 小程序分享配置 ——
+  {
+    key: 'SHARE_HINT',
+    label: '分享引导文案',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+    placeholder: DEFAULT_SHARE_HINT,
+    description: '点击分享按钮后的 Toast 提示（小程序内）',
+  },
+  {
+    key: 'SHARE_DEFAULT_TITLE',
+    label: '默认分享标题',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+    placeholder: DEFAULT_SHARE_TITLE,
+    description: '各场景未单独配置标题时使用',
+  },
+  {
+    key: 'SHARE_DEFAULT_DESC',
+    label: '默认分享描述',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+    placeholder: DEFAULT_SHARE_DESC,
+    description: 'H5 分享卡片描述；小程序朋友圈/好友卡片副文案回退',
+  },
+  {
+    key: 'SHARE_DEFAULT_IMAGE_URL',
+    label: '默认分享图',
+    group: G.wechat_mini_share,
+    type: 'image',
+    requiresRestart: false,
+    description: '各场景未配置图且无业务图时使用；建议接近 5:4',
+  },
+  {
+    key: 'SHARE_HOME_TITLE',
+    label: '首页 · 标题',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+  },
+  {
+    key: 'SHARE_HOME_DESC',
+    label: '首页 · 描述',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+  },
+  {
+    key: 'SHARE_HOME_IMAGE_URL',
+    label: '首页 · 分享图',
+    group: G.wechat_mini_share,
+    type: 'image',
+    requiresRestart: false,
+    description: '留空则优先用首页首张轮播图，再回退默认分享图',
+  },
+  {
+    key: 'SHARE_STORES_TITLE',
+    label: '门店列表 · 标题',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+    placeholder: DEFAULT_SHARE_STORES_TITLE,
+  },
+  {
+    key: 'SHARE_STORES_DESC',
+    label: '门店列表 · 描述',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+  },
+  {
+    key: 'SHARE_STORES_IMAGE_URL',
+    label: '门店列表 · 分享图',
+    group: G.wechat_mini_share,
+    type: 'image',
+    requiresRestart: false,
+  },
+  {
+    key: 'SHARE_STORE_DETAIL_TITLE',
+    label: '门店详情 · 标题',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+    description: '留空则用门店名称',
+  },
+  {
+    key: 'SHARE_STORE_DETAIL_DESC',
+    label: '门店详情 · 描述',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+    description: '留空则用门店简介/地址',
+  },
+  {
+    key: 'SHARE_STORE_DETAIL_IMAGE_URL',
+    label: '门店详情 · 分享图',
+    group: G.wechat_mini_share,
+    type: 'image',
+    requiresRestart: false,
+    description: '留空则用门头图/环境图',
+  },
+  {
+    key: 'SHARE_BENEFIT_TITLE',
+    label: '权益页 · 标题',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+    placeholder: DEFAULT_SHARE_BENEFIT_TITLE,
+  },
+  {
+    key: 'SHARE_BENEFIT_DESC',
+    label: '权益页 · 描述',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+  },
+  {
+    key: 'SHARE_BENEFIT_IMAGE_URL',
+    label: '权益页 · 分享图',
+    group: G.wechat_mini_share,
+    type: 'image',
+    requiresRestart: false,
+  },
+  {
+    key: 'SHARE_MINE_TITLE',
+    label: '我的 · 标题',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+    placeholder: DEFAULT_SHARE_MINE_TITLE,
+  },
+  {
+    key: 'SHARE_MINE_DESC',
+    label: '我的 · 描述',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+  },
+  {
+    key: 'SHARE_MINE_IMAGE_URL',
+    label: '我的 · 分享图',
+    group: G.wechat_mini_share,
+    type: 'image',
+    requiresRestart: false,
+  },
+  {
+    key: 'SHARE_PRODUCT_DETAIL_TITLE',
+    label: '商品详情 · 标题',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+    description: '留空则用商品名称',
+  },
+  {
+    key: 'SHARE_PRODUCT_DETAIL_DESC',
+    label: '商品详情 · 描述',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+    description: '留空则用商品副标题',
+  },
+  {
+    key: 'SHARE_PRODUCT_DETAIL_IMAGE_URL',
+    label: '商品详情 · 分享图',
+    group: G.wechat_mini_share,
+    type: 'image',
+    requiresRestart: false,
+    description: '留空则用商品主图',
+  },
+  {
+    key: 'SHARE_ORDER_DETAIL_TITLE',
+    label: '订单详情 · 标题',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+    placeholder: DEFAULT_SHARE_ORDER_TITLE,
+    description: '支持 {productName} 占位符',
+  },
+  {
+    key: 'SHARE_ORDER_DETAIL_DESC',
+    label: '订单详情 · 描述',
+    group: G.wechat_mini_share,
+    type: 'string',
+    requiresRestart: false,
+  },
+  {
+    key: 'SHARE_ORDER_DETAIL_IMAGE_URL',
+    label: '订单详情 · 分享图',
+    group: G.wechat_mini_share,
+    type: 'image',
+    requiresRestart: false,
+  },
 
   { key: 'OSS_ACCESS_KEY_ID', label: 'OSS AccessKey ID', group: G.oss, type: 'password', secret: true, requiresRestart: true },
   { key: 'OSS_ACCESS_KEY_SECRET', label: 'OSS AccessKey Secret', group: G.oss, type: 'password', secret: true, requiresRestart: true },
@@ -128,7 +430,6 @@ export const SYSTEM_CONFIG_FIELDS: SystemConfigFieldMeta[] = [
   { key: 'OSS_UPLOAD_EXPIRE_SECONDS', label: '直传凭证有效期(秒)', group: G.oss, type: 'number', requiresRestart: false },
   { key: 'OSS_MAX_UPLOAD_BYTES', label: '单文件上限(字节)', group: G.oss, type: 'number', requiresRestart: false },
 
-  { key: 'USER_H5_URL', label: 'C 端 H5 落地页', group: G.app, type: 'string', requiresRestart: false },
   {
     key: 'TENCENT_LBS_KEY',
     label: '腾讯位置服务 Key',
@@ -238,6 +539,37 @@ export const SYSTEM_CONFIG_RETIRED_KEYS = [
 
 export const SYSTEM_CONFIG_KEY_SET = new Set(SYSTEM_CONFIG_FIELDS.map((f) => f.key));
 
+/** 表单空值时展示 / 启动补种的默认值（与 shared-types 常量对齐） */
+export const SYSTEM_CONFIG_DEFAULTS: Record<string, string> = {
+  USER_H5_URL: DEFAULT_USER_H5_URL.replace(/\/$/, ''),
+  BRAND_LOGO_OSS_BASE: BRAND_LOGO_OSS_BASE,
+  BRAND_LOGO_URL: BRAND_LOGO_URL,
+  BRAND_LOGO_WIDE_URL: BRAND_LOGO_WIDE_URL,
+  BRAND_LOGO_MARK_URL: BRAND_LOGO_MARK_URL,
+  MINI_USER_STATIC_OSS_BASE: MINI_USER_STATIC_OSS_BASE,
+  QUALIFICATION_DISCLOSURE_URL: QUALIFICATION_DISCLOSURE_URL,
+  CUSTOMER_SERVICE_PHONE: CUSTOMER_SERVICE_PHONE,
+  MOCK_SMS_FIXED_CODE: MOCK_SMS_FIXED_CODE,
+  SHARE_HINT: DEFAULT_SHARE_HINT,
+  SHARE_DEFAULT_TITLE: DEFAULT_SHARE_TITLE,
+  SHARE_DEFAULT_DESC: DEFAULT_SHARE_DESC,
+  SHARE_DEFAULT_IMAGE_URL: BRAND_LOGO_URL,
+  SHARE_HOME_TITLE: DEFAULT_SHARE_TITLE,
+  SHARE_HOME_DESC: DEFAULT_SHARE_DESC,
+  SHARE_STORES_TITLE: DEFAULT_SHARE_STORES_TITLE,
+  SHARE_STORES_DESC: DEFAULT_SHARE_DESC,
+  SHARE_BENEFIT_TITLE: DEFAULT_SHARE_BENEFIT_TITLE,
+  SHARE_BENEFIT_DESC: DEFAULT_SHARE_DESC,
+  SHARE_MINE_TITLE: DEFAULT_SHARE_MINE_TITLE,
+  SHARE_MINE_DESC: DEFAULT_SHARE_DESC,
+  SHARE_ORDER_DETAIL_TITLE: DEFAULT_SHARE_ORDER_TITLE,
+  SHARE_ORDER_DETAIL_DESC: DEFAULT_SHARE_DESC,
+};
+
 export function getSystemConfigField(key: string): SystemConfigFieldMeta | undefined {
   return SYSTEM_CONFIG_FIELDS.find((f) => f.key === key);
 }
+
+export function getSystemConfigDefault(key: string): string {
+  return SYSTEM_CONFIG_DEFAULTS[key] ?? '';
+}

server/dukang-api/src/common/system-config/system-config.service.ts

@@ -8,6 +8,7 @@ import type {
 import { loadAppConfig, parseMiniHomeBanners, serializeMiniHomeBanners } from '@dukang/shared-types';
 import { PrismaService } from '../prisma/prisma.module';
 import {
+  SYSTEM_CONFIG_DEFAULTS,
   SYSTEM_CONFIG_FIELDS,
   SYSTEM_CONFIG_GROUPS,
   SYSTEM_CONFIG_KEY_SET,
@@ -42,6 +43,7 @@ export class SystemConfigService implements OnModuleInit {
     try {
       await this.purgeRetiredKeys();
       await this.seedMissingFromProcessEnv();
+      await this.seedMissingDefaults();
       const rows = await this.prisma.systemConfig.findMany();
       applyEnvOverlay(Object.fromEntries(rows.map((r) => [r.configKey, r.value])));
       this.lastUpdatedAt = rows.reduce<Date | null>(
@@ -82,7 +84,7 @@ export class SystemConfigService implements OnModuleInit {
     for (const field of fields) {
       const fromDb = dbMap.get(field.key);
       const fromEnv = process.env[field.key];
-      const raw = fromDb ?? fromEnv ?? '';
+      const raw = (fromDb ?? fromEnv ?? SYSTEM_CONFIG_DEFAULTS[field.key] ?? '').trim();
       if (field.secret) {
         if (raw) configuredSecrets.push(field.key);
         values[field.key] = '';
@@ -227,6 +229,26 @@ export class SystemConfigService implements OnModuleInit {
     }
   }
 
+  /** 将代码默认值写入空缺配置，便于 HQ 表单可见、可改 */
+  private async seedMissingDefaults() {
+    const overlay: Record<string, string> = {};
+    for (const field of SYSTEM_CONFIG_FIELDS) {
+      const defaultVal = SYSTEM_CONFIG_DEFAULTS[field.key];
+      if (!defaultVal?.trim()) continue;
+      const existing = await this.prisma.systemConfig.findUnique({ where: { configKey: field.key } });
+      if (existing?.value?.trim()) continue;
+      if (process.env[field.key]?.trim()) continue;
+      const value = this.normalizeByMeta(field, defaultVal);
+      await this.prisma.systemConfig.upsert({
+        where: { configKey: field.key },
+        create: { configKey: field.key, value },
+        update: { value },
+      });
+      overlay[field.key] = value;
+    }
+    if (Object.keys(overlay).length) applyEnvOverlay(overlay);
+  }
+
   private normalizeByMeta(meta: { key?: string; type: string }, raw: string): string {
     if (meta.type === 'boolean') {
       return raw === 'true' || raw === '1' ? 'true' : 'false';

server/dukang-api/src/integrations/courier/courier-log.util.ts

@@ -9,6 +9,7 @@ const CMD_SCENE: Record<string, string> = {
   [XIAOFEIXIA_CMD.ESTIMATE_FREIGHT]: 'ESTIMATE_FREIGHT',
   [XIAOFEIXIA_CMD.BATCH_GET_ORDER]: 'BATCH_GET_SHIPMENT',
   [XIAOFEIXIA_CMD.DELIVERY_COVERAGE]: 'CHECK_COVERAGE',
+  [XIAOFEIXIA_CMD.SIGN_PHOTOS]: 'GET_SIGN_PHOTOS',
 };
 
 export type CourierLogRef = {