feat(courier): 小飞侠签收照联调与 OSS 失败回退

补齐 admin 100108 联调入口；track 优先用缓存签收照，上传失败回退 dataURI，日志截断大图。

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

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

@@ -0,0 +1,88 @@
+import { useEffect, useState } from 'react';
+import { Form, Input, Modal, message } from 'antd';
+import type { UpdateMyHqCredentialsRequest } from '@dukang/shared-types';
+import { request, type HqProfile } from '../lib/api';
+
+type Props = {
+  open: boolean;
+  profile: HqProfile | null;
+  onClose: () => void;
+  onUpdated: (profile: HqProfile) => void;
+};
+
+export function HqAccountSettingsModal({ open, profile, onClose, onUpdated }: Props) {
+  const [form] = Form.useForm<UpdateMyHqCredentialsRequest & { confirmPassword?: string }>();
+  const [saving, setSaving] = useState(false);
+
+  useEffect(() => {
+    if (!open) return;
+    form.setFieldsValue({
+      loginName: profile?.loginName ?? '',
+      oldPassword: '',
+      newPassword: '',
+      confirmPassword: '',
+    });
+  }, [open, profile, form]);
+
+  async function submit() {
+    const values = await form.validateFields();
+    if (values.newPassword && values.newPassword !== values.confirmPassword) {
+      message.error('两次输入的新密码不一致');
+      return;
+    }
+    const body: UpdateMyHqCredentialsRequest = {};
+    const nextLogin = values.loginName?.trim();
+    if (nextLogin && nextLogin !== (profile?.loginName ?? '')) {
+      body.loginName = nextLogin;
+    }
+    if (values.newPassword?.trim()) {
+      body.newPassword = values.newPassword.trim();
+      if (values.oldPassword?.trim()) body.oldPassword = values.oldPassword.trim();
+    }
+    if (!body.loginName && !body.newPassword) {
+      message.warning('请填写要修改的内容');
+      return;
+    }
+    setSaving(true);
+    try {
+      await request('/admin/me/credentials', {
+        method: 'PUT',
+        body: JSON.stringify(body),
+      });
+      const updated = await request<HqProfile>('/admin/auth/me');
+      message.success('账号信息已更新');
+      onUpdated(updated);
+      onClose();
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '保存失败');
+    } finally {
+      setSaving(false);
+    }
+  }
+
+  return (
+    <Modal
+      title="账号设置"
+      open={open}
+      onCancel={onClose}
+      onOk={() => void submit()}
+      confirmLoading={saving}
+      destroyOnClose
+    >
+      <Form form={form} layout="vertical">
+        <Form.Item name="loginName" label="登录用户名" rules={[{ required: true, message: '请输入用户名' }]}>
+          <Input autoComplete="username" placeholder="用于密码登录" />
+        </Form.Item>
+        <Form.Item name="oldPassword" label="当前密码" extra="已设置过密码时，修改密码必填">
+          <Input.Password autoComplete="current-password" placeholder="不修改密码请留空" />
+        </Form.Item>
+        <Form.Item name="newPassword" label="新密码" rules={[{ min: 6, message: '至少 6 位' }]}>
+          <Input.Password autoComplete="new-password" placeholder="不修改请留空" />
+        </Form.Item>
+        <Form.Item name="confirmPassword" label="确认新密码">
+          <Input.Password autoComplete="new-password" placeholder="不修改请留空" />
+        </Form.Item>
+      </Form>
+    </Modal>
+  );
+}

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

@@ -1,5 +1,6 @@
 import { useCallback, useEffect, useMemo, useState } from 'react';
 import {
+  Alert,
   Button,
   Descriptions,
   Drawer,
@@ -140,6 +141,14 @@ export default function OrderTrackDrawer({
               </Space>
             </Image.PreviewGroup>
           </div>
+        ) : nodes.some((n) => n.statusName?.includes('签收') || n.trackInfo?.includes('签收')) ? (
+          <Alert
+            type="info"
+            showIcon
+            style={{ marginBottom: 16 }}
+            message="暂无签收照片"
+            description="小飞侠 100108 未返回图片（可能是本人签收未拍照，或照片已过期）。可在「小飞侠联调」用运单号复测。"
+          />
         ) : null}
 
         <Typography.Title level={5} style={{ marginTop: 0 }}>

apps/admin-web/src/layouts/AdminLayout.tsx

@@ -30,6 +30,7 @@ import { clearAuth, request, type HqProfile } from '../lib/api';
 import { bindAdminEllipsisTitle } from '../lib/ellipsis-title';
 import { AUDIT_NOTICE_CHANGED_EVENT, PACKAGE_AUDIT_CHANGED_EVENT } from '../lib/admin-events';
 import { ListColumnPrefsProvider } from '../lib/ListColumnPrefsContext';
+import { HqAccountSettingsModal } from '../components/HqAccountSettingsModal';
 
 const { Header, Sider, Content } = Layout;
 
@@ -292,6 +293,7 @@ export default function AdminLayout() {
   const contentRef = useRef<HTMLDivElement>(null);
   const [profile, setProfile] = useState<HqProfile | null>(null);
   const [auditPendingCount, setAuditPendingCount] = useState(0);
+  const [accountSettingsOpen, setAccountSettingsOpen] = useState(false);
 
   function refreshAuditPendingCount() {
     Promise.all([
@@ -419,11 +421,20 @@ export default function AdminLayout() {
             <span style={{ color: '#999' }}>
               {HQ_ROLE_LABELS[profile?.adminRole ?? ''] || profile?.adminRole || ''}
             </span>
+            <Button type="text" icon={<UserOutlined />} onClick={() => setAccountSettingsOpen(true)}>
+              账号设置
+            </Button>
             <Button type="text" icon={<LogoutOutlined />} onClick={logout}>
               退出
             </Button>
           </Space>
         </Header>
+        <HqAccountSettingsModal
+          open={accountSettingsOpen}
+          profile={profile}
+          onClose={() => setAccountSettingsOpen(false)}
+          onUpdated={setProfile}
+        />
         <div
           ref={contentRef}
           className="admin-layout"

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

@@ -6,6 +6,7 @@ export const CLIENT_APP = 'HQ_WEB';
 export type HqProfile = {
   id: string;
   phone: string;
+  loginName?: string | null;
   name: string;
   adminRole: string;
   status: string;

apps/admin-web/src/lib/export-columns.ts

@@ -0,0 +1,8 @@
+/** 将列表可见列 key 追加到导出 query */
+export function appendExportColumns(qs: URLSearchParams, keys: string[]) {
+  if (keys.length) qs.set('columns', keys.join(','));
+}
+
+export function exportColumnsBody(keys: string[]): { columns?: string[] } {
+  return keys.length ? { columns: keys } : {};
+}

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

@@ -8,8 +8,11 @@ export type StoreCreateForm = {
   city?: string;
   district: string;
   districtCode?: string;
+  /** @deprecated 使用 categoryIds */
   categoryParentId?: string;
-  categoryId: string;
+  /** @deprecated 使用 categoryIds */
+  categoryId?: string;
+  categoryIds: string[];
   name: string;
   phone: string;
   address: string;
@@ -52,7 +55,7 @@ export function validateStoreCreateStep1(
     | 'partnerAccountId'
     | 'cityId'
     | 'regionCodes'
-    | 'categoryId'
+    | 'categoryIds'
     | 'name'
     | 'phone'
     | 'address'
@@ -69,7 +72,7 @@ export function validateStoreCreateStep1(
   if (!form.partnerAccountId) return '请选择开城合伙人';
   if (!form.regionCodes || form.regionCodes.length < 3) return '请选择省 / 市 / 区县';
   if (!form.cityId) return '所选地区未匹配到开城城市，请先在「开城 → 城市」配置对应区划';
-  if (!form.categoryId?.trim()) return '请选择门店分类（细类）';
+  if (!form.categoryIds?.length) return '请至少选择一个门店分类（细类）';
   if (!form.name?.trim()) return '请填写门店名称';
   if (!form.phone?.trim()) return '请填写门店手机号';
   if (!PHONE_RE.test(form.phone.trim())) return '门店手机号须为11位手机号';

apps/admin-web/src/lib/useAdminListColumns.tsx

@@ -11,6 +11,7 @@ import {
   applyColumnPrefs,
   columnKey,
   settingItems,
+  visibleColumnKeys,
   type ListColumnSettingItem,
 } from './list-column-prefs';
 import { beginColumnResize, withResizeTitle } from './column-resize';
@@ -48,6 +49,16 @@ export function useAdminListColumns<T>(
   );
   itemsRef.current = items;
 
+  const exportColumnKeys = useMemo(() => {
+    const keyed = (allColumns as ColumnType<T>[]).map((col, i) => ({
+      col,
+      key: columnKey(col, i),
+      actions: col.title === '操作' || col.key === ACTIONS_COLUMN_KEY || col.key === 'actions',
+    }));
+    const defaultKeys = keyed.filter((c) => !c.actions).map((c) => c.key);
+    return visibleColumnKeys(defaultKeys, pref);
+  }, [allColumns, pref]);
+
   const serialCol: ColumnType<T> = useMemo(
     () => ({
       key: SERIAL_COLUMN_KEY,
@@ -171,5 +182,5 @@ export function useAdminListColumns<T>(
     />
   );
 
-  return { columns, settingsButton, settingsModal };
+  return { columns, settingsButton, settingsModal, exportColumnKeys };
 }

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

@@ -29,6 +29,7 @@ import {
 import { request } from '../lib/api';
 import { fmtTime } from '../lib/constants';
 import { downloadBase64File } from '../lib/exportExcel';
+import { exportColumnsBody } from '../lib/export-columns';
 import { useAdminList } from '../lib/useAdminList';
 import OssUpload from '../components/OssUpload';
 import { useAdminListColumns } from '../lib/useAdminListColumns';
@@ -62,6 +63,8 @@ export default function DevPlanTasksPage() {
   const [dispatchOpen, setDispatchOpen] = useState(false);
   const [batchEditOpen, setBatchEditOpen] = useState(false);
   const [batchSaving, setBatchSaving] = useState(false);
+  const [creatingVersion, setCreatingVersion] = useState(false);
+  const [newVersionNo, setNewVersionNo] = useState('');
   const [versions, setVersions] = useState<DevPlanVersionDto[]>([]);
   const [supportTickets, setSupportTickets] = useState<SupportTicketDto[]>([]);
   const [editing, setEditing] = useState<DevPlanTaskDto | null>(null);
@@ -172,9 +175,34 @@ export default function DevPlanTasksPage() {
 
   function openBatchEdit() {
     batchForm.setFieldsValue({ status: undefined, versionId: undefined });
+    setNewVersionNo('');
     setBatchEditOpen(true);
   }
 
+  async function createVersionInBatch() {
+    const versionNo = newVersionNo.trim();
+    if (!versionNo) {
+      message.warning('请输入版本号');
+      return;
+    }
+    setCreatingVersion(true);
+    try {
+      const created = await request<DevPlanVersionDto>('/admin/dev-plan/versions', {
+        method: 'POST',
+        body: JSON.stringify({ versionNo }),
+      });
+      const res = await request<{ items: DevPlanVersionDto[] }>('/admin/dev-plan/versions?pageSize=100');
+      setVersions(res.items ?? []);
+      batchForm.setFieldsValue({ versionId: created.id });
+      setNewVersionNo('');
+      message.success(`已创建版本 ${versionNo}`);
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '创建失败');
+    } finally {
+      setCreatingVersion(false);
+    }
+  }
+
   async function submitBatchEdit() {
     const values = await batchForm.validateFields();
     if (!values.status && !values.versionId) {
@@ -224,34 +252,6 @@ export default function DevPlanTasksPage() {
     }
   }
 
-  async function exportTasks(scope: 'filter' | 'selected') {
-    setExporting(true);
-    try {
-      const result = await request<{
-        filename: string;
-        mimeType: string;
-        contentBase64: string;
-        count: number;
-      }>('/admin/dev-plan/tasks/export', {
-        method: 'POST',
-        body: JSON.stringify({
-          scope,
-          format: exportFormat,
-          ids: scope === 'selected' ? selectedRowKeys : undefined,
-          status: filters.status || undefined,
-          type: filters.type || undefined,
-          keyword: filters.keyword || undefined,
-        }),
-      });
-      downloadBase64File(result.contentBase64, result.filename, result.mimeType);
-      message.success(`已导出 ${result.count} 条任务`);
-    } catch (e) {
-      message.error(e instanceof Error ? e.message : '导出失败');
-    } finally {
-      setExporting(false);
-    }
-  }
-
   const baseColumns: ColumnsType<DevPlanTaskDto> = [
     {
       title: '任务号',
@@ -285,6 +285,7 @@ export default function DevPlanTasksPage() {
     },
     {
       title: '附件',
+      key: 'attachmentUrls',
       width: 100,
       render: (_, row) =>
         row.attachmentUrls?.length ? (
@@ -314,6 +315,7 @@ export default function DevPlanTasksPage() {
     },
     {
       title: '关联版本',
+      key: 'versions',
       dataIndex: 'versions',
       width: 140,
       render: (_, row) =>
@@ -347,7 +349,36 @@ export default function DevPlanTasksPage() {
     },
   ];
 
-  const { columns, settingsButton, settingsModal } = useAdminListColumns('dev-plan-tasks', baseColumns, { page, pageSize });
+  const { columns, settingsButton, settingsModal, exportColumnKeys } = useAdminListColumns('dev-plan-tasks', baseColumns, { page, pageSize });
+
+  async function exportTasks(scope: 'filter' | 'selected') {
+    setExporting(true);
+    try {
+      const result = await request<{
+        filename: string;
+        mimeType: string;
+        contentBase64: string;
+        count: number;
+      }>('/admin/dev-plan/tasks/export', {
+        method: 'POST',
+        body: JSON.stringify({
+          scope,
+          format: exportFormat,
+          ids: scope === 'selected' ? selectedRowKeys : undefined,
+          status: filters.status || undefined,
+          type: filters.type || undefined,
+          keyword: filters.keyword || undefined,
+          ...exportColumnsBody(exportColumnKeys),
+        }),
+      });
+      downloadBase64File(result.contentBase64, result.filename, result.mimeType);
+      message.success(`已导出 ${result.count} 条任务`);
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '导出失败');
+    } finally {
+      setExporting(false);
+    }
+  }
 
   return (
     <div>
@@ -541,6 +572,19 @@ export default function DevPlanTasksPage() {
               options={versions.map((v) => ({ value: v.id, label: v.versionNo }))}
             />
           </Form.Item>
+          <Form.Item label="创建新版本">
+            <Space.Compact style={{ width: '100%' }}>
+              <Input
+                placeholder="版本号，如 v4.0.11"
+                value={newVersionNo}
+                onChange={(e) => setNewVersionNo(e.target.value)}
+                onPressEnter={() => void createVersionInBatch()}
+              />
+              <Button loading={creatingVersion} onClick={() => void createVersionInBatch()}>
+                创建
+              </Button>
+            </Space.Compact>
+          </Form.Item>
         </Form>
       </Modal>
     </div>

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

@@ -57,6 +57,7 @@ export default function DevPlanVersionsPage() {
     useAdminList<DevPlanVersionDto>('/admin/dev-plan/versions', () => {
       const qs = new URLSearchParams();
       if (filters.status) qs.set('status', filters.status);
+      if (filters.keyword) qs.set('keyword', filters.keyword);
       return qs;
     }, [filters]);
 
@@ -190,6 +191,9 @@ export default function DevPlanVersionsPage() {
         <Form.Item name="status" label="状态">
           <Select allowClear style={{ width: 120 }} options={STATUS_OPTIONS} />
         </Form.Item>
+        <Form.Item name="keyword" label="查找">
+          <Input allowClear placeholder="版本号或内容" style={{ width: 220 }} />
+        </Form.Item>
         <Button type="primary" htmlType="submit">
           筛选
         </Button>

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

@@ -1,4 +1,5 @@
 import { useEffect, useState } from 'react';
+import { useNavigate } from 'react-router-dom';
 import {
   Button,
   Card,
@@ -27,6 +28,7 @@ import {
 } from '@dukang/shared-types';
 import { fmtTime } from '../lib/constants';
 import { downloadExcelCsv } from '../lib/exportExcel';
+import { appendExportColumns } from '../lib/export-columns';
 import { request } from '../lib/api';
 import { useAdminList } from '../lib/useAdminList';
 import { useAdminListColumns } from '../lib/useAdminListColumns';
@@ -98,6 +100,7 @@ const STATUS_COLORS: Record<string, string> = {
 };
 
 export default function LogisticsBillsPage() {
+  const navigate = useNavigate();
   const [form] = Form.useForm();
   const [summaryForm] = Form.useForm();
   const [filters, setFilters] = useState<Record<string, string>>({});
@@ -202,6 +205,7 @@ export default function LogisticsBillsPage() {
       if (filters.providerId) qs.set('providerId', filters.providerId);
       if (filters.year) qs.set('year', filters.year);
       if (filters.month) qs.set('month', filters.month);
+      appendExportColumns(qs, exportColumnKeys);
       const result = await request<{ csv: string; count: number }>(
         `/admin/logistics-bills/export?${qs}`,
       );
@@ -250,6 +254,7 @@ export default function LogisticsBillsPage() {
   const billColumns: ColumnsType<BillRow> = [
     {
       title: '账单号',
+      key: '账单号',
       dataIndex: 'billNo',
       width: 170,
       render: (v, row) => (
@@ -258,42 +263,49 @@ export default function LogisticsBillsPage() {
     },
     {
       title: '承运商',
+      key: '承运商',
       width: 140,
       render: (_, r) => `${r.providerName || ''} (${r.providerCode || ''})`,
     },
     {
       title: '账期',
+      key: '账期',
       width: 200,
       render: (_, r) =>
         `${String(r.periodStart || '').slice(0, 10)} ~ ${String(r.periodEnd || '').slice(0, 10)}`,
     },
     {
       title: '结算方式',
+      key: '结算方式',
       dataIndex: 'settlementMethod',
       width: 100,
       render: (v) =>
         LOGISTICS_SETTLEMENT_METHOD_LABELS[v as LogisticsSettlementMethod] || v,
     },
-    { title: '订单数', dataIndex: 'orderCount', width: 80 },
-    { title: '瓶数', dataIndex: 'bottleCount', width: 80 },
+    { title: '订单数', key: '订单数', dataIndex: 'orderCount', width: 80 },
+    { title: '瓶数', key: '瓶数', dataIndex: 'bottleCount', width: 80 },
     {
       title: '物流费',
+      key: '物流费',
       dataIndex: 'logisticsAmount',
       width: 110,
       render: (v) => `¥${Number(v).toFixed(2)}`,
     },
     {
       title: '收款户名',
+      key: '收款户名',
       width: 100,
       render: (_, r) => providerBank(r)?.bankAccountName || '—',
     },
     {
       title: '收款账号',
+      key: '收款账号',
       width: 140,
       render: (_, r) => providerBank(r)?.bankAccountNo || '—',
     },
     {
       title: '状态',
+      key: '状态',
       dataIndex: 'status',
       width: 90,
       render: (s) => <Tag color={STATUS_COLORS[s] || 'default'}>{STATUS_LABELS[s] || s}</Tag>,
@@ -398,7 +410,7 @@ export default function LogisticsBillsPage() {
     },
   ];
 
-  const { columns, settingsButton, settingsModal } = useAdminListColumns('finance-logistics-bills', billColumns, {
+  const { columns, settingsButton, settingsModal, exportColumnKeys } = useAdminListColumns('finance-logistics-bills', billColumns, {
     page,
     pageSize,
   });
@@ -627,7 +639,20 @@ export default function LogisticsBillsPage() {
               pagination={false}
               dataSource={detail.items ?? []}
               columns={[
-                { title: '订单号', dataIndex: 'orderNo' },
+                {
+                  title: '订单号',
+                  dataIndex: 'orderNo',
+                  render: (v: string) =>
+                    v ? (
+                      <AdminPrimaryLink
+                        onClick={() => navigate(`/orders?orderNo=${encodeURIComponent(v)}`)}
+                      >
+                        {v}
+                      </AdminPrimaryLink>
+                    ) : (
+                      '—'
+                    ),
+                },
                 { title: '瓶数', dataIndex: 'quantity', width: 70 },
                 {
                   title: '物流费',

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

@@ -29,6 +29,7 @@ import { useAdminListColumns } from '../lib/useAdminListColumns';
 import { AdminListHeader } from '../components/AdminListHeader';
 import { AdminPrimaryLink } from '../components/AdminPrimaryLink';
 import { downloadBase64File } from '../lib/exportExcel';
+import { exportColumnsBody } from '../lib/export-columns';
 import {
   ADMIN_OPTIONS_PAGE_SIZE,
   DELIVERY_PROVIDER_LABELS,
@@ -265,8 +266,9 @@ function buildExportPayload(
   format: OrderExportFormat,
   filters: OrderExportFilters,
   selectedIds: string[],
+  columns?: string[],
 ) {
-  const payload: Record<string, unknown> = { scope, format };
+  const payload: Record<string, unknown> = { scope, format, ...exportColumnsBody(columns ?? []) };
   if (scope === 'selected') {
     payload.ids = selectedIds;
     return payload;
@@ -671,6 +673,7 @@ export default function OrdersPage() {
           status: selectedStatuses(values.status).length ? values.status : initialStatuses,
         },
         selectedRowKeys,
+        exportColumnKeys,
       );
       const result = await request<OrderExportResult>('/admin/orders/export', {
         method: 'POST',
@@ -688,6 +691,7 @@ export default function OrdersPage() {
   const baseColumns: ColumnsType<AdminOrderRow> = [
     {
       title: '订单号',
+      key: '订单号',
       dataIndex: 'orderNo',
       width: 180,
       render: (v, row) => (
@@ -699,7 +703,7 @@ export default function OrdersPage() {
     },
     {
       title: '用户',
-      key: 'user',
+      key: '用户',
       width: 200,
       render: (_, row) =>
         row.user?.id ? (
@@ -712,12 +716,20 @@ export default function OrdersPage() {
     },
     {
       title: '商品',
-      key: 'productName',
+      key: '商品',
       width: 180,
       render: (_, row) => (
         <Space size={4} wrap>
           <span>{row.productName || '—'}</span>
-          {row.fulfillmentHold ? <Tag color="orange">大单</Tag> : null}
+          {row.fulfillmentHold ? (
+            <Tag color="orange">
+              {row.fulfillmentHoldReason === 'LARGE_ORDER_GE_10_BOXES'
+                ? '大单'
+                : row.fulfillmentHoldReason === 'COURIER_OUT_OF_SERVICE'
+                  ? '超区'
+                  : '推单失败'}
+            </Tag>
+          ) : null}
           {row.orderType === 'PROXY' || row.isProxyOrder ? (
             <Tag color="purple">代下单</Tag>
           ) : null}
@@ -726,12 +738,14 @@ export default function OrdersPage() {
     },
     {
       title: '规格',
+      key: '规格',
       dataIndex: 'productSpec',
       width: 140,
       render: (v: string | undefined) => v || '—',
     },
     {
       title: '数量',
+      key: '数量',
       dataIndex: 'quantity',
       width: 80,
       render: (v: number | undefined, row) =>
@@ -739,12 +753,14 @@ export default function OrdersPage() {
     },
     {
       title: '配送方式',
+      key: '配送方式',
       dataIndex: 'deliveryType',
       width: 100,
       render: (v: string | undefined) => DELIVERY_TYPE_LABELS[v ?? ''] || v || '—',
     },
     {
       title: '状态',
+      key: '状态',
       dataIndex: 'status',
       width: 100,
       render: (s: string) => (
@@ -753,42 +769,47 @@ export default function OrdersPage() {
     },
     {
       title: '实付',
+      key: '实付',
       dataIndex: 'payAmount',
       width: 90,
       render: (v: number) => `¥${v}`,
     },
     {
       title: '运费',
-      key: 'logisticsFee',
+      key: '运费',
       width: 90,
       render: (_, row) =>
         row.delivery?.logisticsFee == null ? '—' : `¥${Number(row.delivery.logisticsFee).toFixed(2)}`,
     },
     {
       title: '好客权益',
+      key: '好客权益',
       width: 200,
       render: (_, row) => formatBenefitBrief(row),
     },
     {
       title: '收货人',
+      key: '收货人',
       dataIndex: 'receiverName',
       width: 90,
       render: (v: string | undefined) => v || '—',
     },
     {
       title: '电话',
+      key: '电话',
       dataIndex: 'receiverPhone',
       width: 120,
       render: (v: string | undefined) => v || '—',
     },
     {
       title: '地址',
-      key: 'receiverAddress',
+      key: '地址',
       width: 260,
       render: (_, row) => formatReceiverAddress(row) || '—',
     },
     {
       title: '下单时间',
+      key: '下单时间',
       dataIndex: 'createdAt',
       width: 170,
       render: fmtTime,
@@ -823,7 +844,7 @@ export default function OrdersPage() {
     },
   ];
 
-  const { columns, settingsButton, settingsModal } = useAdminListColumns('orders', baseColumns, {
+  const { columns, settingsButton, settingsModal, exportColumnKeys } = useAdminListColumns('orders', baseColumns, {
     page,
     pageSize,
   });
@@ -1010,7 +1031,7 @@ export default function OrdersPage() {
               ) : <span />}
               <Space size={12} wrap>
                 <Form.Item name="fulfillmentHold" valuePropName="checked" noStyle>
-                  <Checkbox>大单拦截</Checkbox>
+                  <Checkbox>履约拦截</Checkbox>
                 </Form.Item>
                 <Button
                   onClick={() => {
@@ -1120,7 +1141,7 @@ export default function OrdersPage() {
                   {detail.fulfillmentHold ? (
                     <Tag color="orange">
                       {FULFILLMENT_HOLD_REASON_LABELS[detail.fulfillmentHoldReason || ''] ||
-                        '大单待确认'}
+                        '履约待确认'}
                     </Tag>
                   ) : null}
                   {detail.orderType === 'PROXY' || detail.isProxyOrder ? (
@@ -1517,10 +1538,16 @@ export default function OrdersPage() {
                 type="warning"
                 showIcon
                 style={{ marginBottom: 12 }}
-                message="大单已拦截自动推小飞侠"
+                message={
+                  shipTarget.fulfillmentHoldReason === 'LARGE_ORDER_GE_10_BOXES'
+                    ? '大单已拦截自动推小飞侠'
+                    : shipTarget.fulfillmentHoldReason === 'COURIER_OUT_OF_SERVICE'
+                      ? '小飞侠超出服务区'
+                      : '自动推配送失败'
+                }
                 description={
                   FULFILLMENT_HOLD_REASON_LABELS[shipTarget.fulfillmentHoldReason || ''] ||
-                  '≥10箱订单需总部确认：可选仓推小飞侠，或改用快递自配送。'
+                  '请确认后：可选仓重推小飞侠，或改用快递自配送。'
                 }
               />
             ) : null}

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

@@ -1,4 +1,5 @@
 import { useEffect, useState } from 'react';
+import { useNavigate } from 'react-router-dom';
 import {
   Button,
   Card,
@@ -14,6 +15,7 @@ import {
   Table,
   Tabs,
   Tag,
+  Tooltip,
   Typography,
   message,
 } from 'antd';
@@ -22,6 +24,7 @@ import dayjs, { type Dayjs } from 'dayjs';
 import { request, type Paginated } from '../lib/api';
 import { ADMIN_OPTIONS_PAGE_SIZE, fmtTime } from '../lib/constants';
 import { downloadExcelCsv } from '../lib/exportExcel';
+import { appendExportColumns } from '../lib/export-columns';
 import { useAdminList } from '../lib/useAdminList';
 import { useAdminListColumns } from '../lib/useAdminListColumns';
 import { AdminListHeader } from '../components/AdminListHeader';
@@ -48,6 +51,7 @@ type Row = {
   redeemCommission: number;
   totalAmount: number;
   status: string;
+  billDate: string;
   periodStart: string;
   periodEnd: string;
   rejectReason?: string | null;
@@ -109,6 +113,7 @@ function weekMonday(d: Dayjs) {
 }
 
 export default function PartnerBillsPage() {
+  const navigate = useNavigate();
   const [form] = Form.useForm();
   const [filters, setFilters] = useState<Record<string, string>>({});
   const [partners, setPartners] = useState<PartnerOption[]>([]);
@@ -263,6 +268,7 @@ export default function PartnerBillsPage() {
       if (filters.status) qs.set('status', filters.status);
       if (filters.partnerId) qs.set('partnerId', filters.partnerId);
       if (filters.weekStartYmd) qs.set('weekStartYmd', filters.weekStartYmd);
+      appendExportColumns(qs, exportColumnKeys);
       const result = await request<{ csv: string; count: number }>(`/admin/partner-bills/export?${qs}`);
       const suffix = filters.weekStartYmd || 'all';
       downloadExcelCsv(result.csv, `合伙人账单_${suffix}.csv`);
@@ -285,6 +291,7 @@ export default function PartnerBillsPage() {
   const baseColumns: ColumnsType<Row> = [
     {
       title: '账单号',
+      key: '账单号',
       dataIndex: 'billNo',
       width: 180,
       render: (v, row) => (
@@ -293,29 +300,45 @@ export default function PartnerBillsPage() {
     },
     {
       title: '合伙人',
+      key: '合伙人',
       width: 200,
       render: (_, r) => partnerName(r),
     },
+    {
+      title: (
+        <Tooltip title="周账出账日为账期结束后的下周一；历史月账为次月 1 日">
+          出账日
+        </Tooltip>
+      ),
+      key: '出账日',
+      dataIndex: 'billDate',
+      width: 110,
+      render: (v) => String(v || '').slice(0, 10),
+    },
     {
       title: '账期',
+      key: '账期',
       width: 200,
       render: (_, r) =>
         `${String(r.periodStart || '').slice(0, 10)} ~ ${String(r.periodEnd || '').slice(0, 10)}`,
     },
     {
       title: '酒单佣金',
+      key: '酒单佣金',
       dataIndex: 'orderCommission',
       width: 110,
       render: (v) => `¥${Number(v).toFixed(2)}`,
     },
     {
       title: '核销佣金',
+      key: '核销佣金',
       dataIndex: 'redeemCommission',
       width: 110,
       render: (v) => `¥${Number(v).toFixed(2)}`,
     },
     {
       title: '合计应付',
+      key: '合计应付',
       dataIndex: 'totalAmount',
       width: 130,
       render: (v) =>
@@ -323,16 +346,19 @@ export default function PartnerBillsPage() {
     },
     {
       title: '收款户名',
+      key: '收款户名',
       width: 100,
       render: (_, r) => partnerBank(r)?.bankAccountName || '—',
     },
     {
       title: '收款账号',
+      key: '收款账号',
       width: 140,
       render: (_, r) => partnerBank(r)?.bankAccountNo || '—',
     },
     {
       title: '状态',
+      key: '状态',
       dataIndex: 'status',
       width: 130,
       render: (s, row) => (
@@ -380,7 +406,7 @@ export default function PartnerBillsPage() {
     },
   ];
 
-  const { columns, settingsButton, settingsModal } = useAdminListColumns('finance-partner-bills', baseColumns, { page, pageSize });
+  const { columns, settingsButton, settingsModal, exportColumnKeys } = useAdminListColumns('finance-partner-bills', baseColumns, { page, pageSize });
 
   return (
     <div>
@@ -572,6 +598,7 @@ export default function PartnerBillsPage() {
             <Descriptions column={1} size="small" bordered>
               <Descriptions.Item label="账单号">{detail.billNo}</Descriptions.Item>
               <Descriptions.Item label="合伙人">{partnerName(detail)}</Descriptions.Item>
+              <Descriptions.Item label="出账日">{String(detail.billDate || '').slice(0, 10)}</Descriptions.Item>
               <Descriptions.Item label="账期">
                 {String(detail.periodStart).slice(0, 10)} ~ {String(detail.periodEnd).slice(0, 10)}
               </Descriptions.Item>
@@ -610,7 +637,21 @@ export default function PartnerBillsPage() {
                         pagination={false}
                         dataSource={detail.orderItems ?? []}
                         columns={[
-                          { title: '订单号', dataIndex: 'refNo', width: 160 },
+                          {
+                            title: '订单号',
+                            dataIndex: 'refNo',
+                            width: 160,
+                            render: (v: string) =>
+                              v ? (
+                                <AdminPrimaryLink
+                                  onClick={() => navigate(`/orders?orderNo=${encodeURIComponent(v)}`)}
+                                >
+                                  {v}
+                                </AdminPrimaryLink>
+                              ) : (
+                                '—'
+                              ),
+                          },
                           { title: '商品', dataIndex: 'title' },
                           { title: '数量', dataIndex: 'extra', width: 70 },
                           {

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

@@ -31,6 +31,7 @@ import {
 import { request, type Paginated } from '../lib/api';
 import { ADMIN_OPTIONS_PAGE_SIZE, fmtTime } from '../lib/constants';
 import { downloadExcelCsv } from '../lib/exportExcel';
+import { appendExportColumns } from '../lib/export-columns';
 import { useAdminList } from '../lib/useAdminList';
 import { useAdminListColumns } from '../lib/useAdminListColumns';
 import { AdminListHeader } from '../components/AdminListHeader';
@@ -44,6 +45,8 @@ type Row = {
   amount: number;
   status: StoreSettlementStatus;
   date: string;
+  periodStart?: string | null;
+  periodEnd?: string | null;
   overdue?: boolean;
   redeemCount?: number | null;
   redeemAmount?: number | null;
@@ -198,6 +201,7 @@ export default function StoreBillsPage() {
       if (filters.storeId) qs.set('storeId', filters.storeId);
       if (filters.dateFrom) qs.set('dateFrom', filters.dateFrom);
       if (filters.dateTo) qs.set('dateTo', filters.dateTo);
+      appendExportColumns(qs, exportColumnKeys);
       const result = await request<{ csv: string; count: number }>(`/admin/store-bills/export?${qs}`);
       downloadExcelCsv(result.csv, `门店对账单_${filters.dateFrom || 'all'}_${filters.dateTo || 'all'}.csv`);
       message.success(`已导出 ${result.count} 条 T+1 账单`);
@@ -218,6 +222,7 @@ export default function StoreBillsPage() {
   const baseColumns: ColumnsType<Row> = [
     {
       title: '类型',
+      key: '类型',
       dataIndex: 'kind',
       width: 100,
       render: (k: StoreSettlementKind) => (
@@ -228,6 +233,7 @@ export default function StoreBillsPage() {
     },
     {
       title: '单号',
+      key: '账单号',
       dataIndex: 'billNo',
       width: 180,
       render: (v, row) => (
@@ -243,39 +249,58 @@ export default function StoreBillsPage() {
           出账日
         </Tooltip>
       ),
+      key: '出账日',
       dataIndex: 'date',
       width: 160,
       render: (v, row) => (row.kind === 'T1_BILL' ? String(v || '').slice(0, 10) : fmtTime(v)),
     },
-    { title: '门店', dataIndex: ['store', 'name'], width: 140 },
-    { title: '登录手机', dataIndex: ['store', 'phone'], width: 120, render: (v) => v || '—' },
-    { title: '城市', dataIndex: ['store', 'cityName'], width: 90 },
+    {
+      title: (
+        <Tooltip title="T+1 账期为出账日前一日的核销窗口；手动提现无账期">
+          账期
+        </Tooltip>
+      ),
+      key: '账期',
+      width: 200,
+      render: (_, row) =>
+        row.kind === 'T1_BILL' && row.periodStart
+          ? `${row.periodStart} ~ ${row.periodEnd}`
+          : '—',
+    },
+    { title: '门店', key: '门店', dataIndex: ['store', 'name'], width: 140 },
+    { title: '登录手机', key: '登录手机', dataIndex: ['store', 'phone'], width: 120, render: (v) => v || '—' },
+    { title: '城市', key: '城市', dataIndex: ['store', 'cityName'], width: 90 },
     {
       title: '收款户名',
+      key: '收款户名',
       width: 100,
       render: (_, row) =>
         row.kind === 'T1_BILL' ? row.bankAccount?.bankAccountName || '—' : '—',
     },
     {
       title: '收款账号',
+      key: '收款账号',
       width: 140,
       render: (_, row) =>
         row.kind === 'T1_BILL' ? row.bankAccount?.bankAccountNo || '—' : '—',
     },
     {
       title: '笔数',
+      key: '笔数',
       width: 80,
       render: (_, row) =>
         row.kind === 'T1_BILL' ? (row.redeemCount ?? '—') : (row.payoutCount ?? '—'),
     },
     {
       title: '应付金额',
+      key: '应付金额',
       dataIndex: 'amount',
       width: 110,
       render: (v) => `¥${Number(v).toFixed(2)}`,
     },
     {
       title: '状态',
+      key: '状态',
       dataIndex: 'status',
       width: 100,
       render: (s: string, row) => (
@@ -325,7 +350,7 @@ export default function StoreBillsPage() {
       }
     | undefined;
 
-  const { columns, settingsButton, settingsModal } = useAdminListColumns('finance-store-bills', baseColumns, { page, pageSize });
+  const { columns, settingsButton, settingsModal, exportColumnKeys } = useAdminListColumns('finance-store-bills', baseColumns, { page, pageSize });
 
   return (
     <div>
@@ -495,6 +520,11 @@ export default function StoreBillsPage() {
               <Descriptions.Item label="出账日">
                 {String(detail.billDate || '').slice(0, 10)}
               </Descriptions.Item>
+              <Descriptions.Item label="账期">
+                {detail.periodStart
+                  ? `${String(detail.periodStart).slice(0, 10)} ~ ${String(detail.periodEnd || '').slice(0, 10)}`
+                  : '—'}
+              </Descriptions.Item>
               <Descriptions.Item label="应付">
                 ¥{Number(detail.payoutAmount ?? 0).toFixed(2)}
               </Descriptions.Item>

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

@@ -224,6 +224,7 @@ type StoreRow = {
   settlementRate?: number;
   sortOrder?: number;
   category?: { id: string; name: string; parentId?: string | null } | null;
+  categories?: { id: string; name: string; parentId?: string | null }[] | null;
 };
 
 type PartnerOption = { id: string; companyName?: string | null; name?: string | null; phone?: string | null };
@@ -350,29 +351,17 @@ export default function StoresPage() {
   const selectedPartnerId = Form.useWatch('partnerAccountId', createForm);
   const selectedRegionCodes = Form.useWatch('regionCodes', createForm);
   const selectedCityId = Form.useWatch('cityId', createForm);
-  const selectedCategoryParentId = Form.useWatch('categoryParentId', createForm);
-  const editCategoryParentId = Form.useWatch('categoryParentId', editForm);
-
-  const categoryParentOptions = useMemo(
-    () =>
-      categoryTree
-        .filter((n) => n.status !== 'INACTIVE')
-        .map((n) => ({ value: n.id, label: n.name })),
-    [categoryTree],
-  );
-  const categoryChildOptions = useMemo(() => {
-    const parent = categoryTree.find((n) => n.id === selectedCategoryParentId);
-    return (parent?.children ?? [])
-      .filter((n) => n.status !== 'INACTIVE')
-      .map((n) => ({ value: n.id, label: n.name }));
-  }, [categoryTree, selectedCategoryParentId]);
-
-  const editCategoryChildOptions = useMemo(() => {
-    const parent = categoryTree.find((n) => n.id === editCategoryParentId);
-    return (parent?.children ?? [])
-      .filter((n) => n.status !== 'INACTIVE')
-      .map((n) => ({ value: n.id, label: n.name }));
-  }, [categoryTree, editCategoryParentId]);
+  const categoryLeafOptions = useMemo(() => {
+    const options: { value: string; label: string }[] = [];
+    for (const parent of categoryTree) {
+      if (parent.status === 'INACTIVE') continue;
+      for (const child of parent.children ?? []) {
+        if (child.status === 'INACTIVE') continue;
+        options.push({ value: child.id, label: `${parent.name} / ${child.name}` });
+      }
+    }
+    return options;
+  }, [categoryTree]);
 
   async function deleteStore(id: string) {
     setDeleting(true);
@@ -414,20 +403,14 @@ export default function StoresPage() {
           bankBranch?: string | null;
         })
       : null;
-    const categoryId = category?.id != null ? String(category.id) : undefined;
-    let parentId = category?.parentId != null ? String(category.parentId) : undefined;
-    if (!parentId && categoryId) {
-      for (const parent of cats) {
-        if (parent.id === categoryId) {
-          parentId = parent.id;
-          break;
-        }
-        if ((parent.children ?? []).some((c) => c.id === categoryId)) {
-          parentId = parent.id;
-          break;
-        }
-      }
-    }
+    const categories = Array.isArray(d.categories)
+      ? (d.categories as { id?: string }[])
+      : [];
+    const categoryIds = categories.length
+      ? categories.map((c) => String(c.id)).filter(Boolean)
+      : category?.id != null
+        ? [String(category.id)]
+        : [];
     const loginPhone =
       (typeof d.loginPhone === 'string' && d.loginPhone) ||
       account?.phone ||
@@ -466,8 +449,7 @@ export default function StoresPage() {
       city: d.cityName,
       district: d.district,
       address: d.address,
-      categoryParentId: parentId,
-      categoryId,
+      categoryIds,
       latitude: d.latitude != null ? Number(d.latitude) : undefined,
       longitude: d.longitude != null ? Number(d.longitude) : undefined,
       settlementRate: d.settlementRate != null ? Number(d.settlementRate) * 100 : 60,
@@ -530,7 +512,7 @@ export default function StoresPage() {
           !/^null$/i.test(v.benefitUsageRule.trim())
             ? v.benefitUsageRule.trim()
             : null,
-        categoryId: v.categoryId,
+        categoryIds: v.categoryIds,
         province: v.province,
         city: v.city,
         district: v.district,
@@ -661,8 +643,7 @@ export default function StoresPage() {
           'partnerAccountId',
           'regionCodes',
           'cityId',
-          'categoryParentId',
-          'categoryId',
+          'categoryIds',
           'name',
           'phone',
           'address',
@@ -691,7 +672,7 @@ export default function StoresPage() {
         body: JSON.stringify({
           partnerAccountId: values.partnerAccountId,
           cityId: values.cityId,
-          categoryId: values.categoryId,
+          categoryIds: values.categoryIds,
           province: values.province,
           city: values.city,
           name: values.name.trim(),
@@ -769,8 +750,14 @@ export default function StoresPage() {
     {
       key: 'category',
       title: '分类',
-      width: 100,
-      render: (_, row) => row.category?.name || '—',
+      width: 140,
+      render: (_, row) => {
+        const cats = Array.isArray(row.categories)
+          ? row.categories.map((c: { name?: string }) => c.name).filter(Boolean)
+          : [];
+        if (cats.length) return cats.join('、');
+        return row.category?.name || '—';
+      },
     },
     { key: 'cityName', title: '城市', dataIndex: 'cityName', width: 80 },
     { key: 'phone', title: '登录号', dataIndex: 'phone', width: 120 },
@@ -1156,29 +1143,17 @@ export default function StoresPage() {
                         <Input placeholder="手机号或座机，如 0379-8888888" />
                       </Form.Item>
                       <Form.Item
-                        name="categoryParentId"
-                        label="门店分类（大类）"
-                        rules={[{ required: true, message: '请选择门店大类' }]}
+                        name="categoryIds"
+                        label="门店分类（细类，可多选）"
+                        rules={[{ required: true, message: '请至少选择一个门店细类' }]}
                       >
                         <Select
+                          mode="multiple"
                           showSearch
                           loading={optionsLoading}
                           optionFilterProp="label"
-                          options={categoryParentOptions}
-                          onChange={() => editForm.setFieldValue('categoryId', undefined)}
-                        />
-                      </Form.Item>
-                      <Form.Item
-                        name="categoryId"
-                        label="门店分类（细类）"
-                        rules={[{ required: true, message: '请选择门店细类' }]}
-                      >
-                        <Select
-                          showSearch
-                          optionFilterProp="label"
-                          placeholder={editCategoryParentId ? '选择细类' : '请先选大类'}
-                          disabled={!editCategoryParentId}
-                          options={editCategoryChildOptions}
+                          placeholder="选择细类，可多选"
+                          options={categoryLeafOptions}
                         />
                       </Form.Item>
                       <Form.Item name="coverUrl" label="封面图 / 门头照">
@@ -1457,23 +1432,9 @@ export default function StoresPage() {
               <Form.Item name="district" hidden><Input /></Form.Item>
               <Form.Item name="districtCode" hidden><Input /></Form.Item>
               <Form.Item
-                name="categoryParentId"
-                label="门店分类（大类）"
-                rules={[{ required: true, message: '请选择门店大类' }]}
-              >
-                <Select
-                  showSearch
-                  loading={optionsLoading}
-                  optionFilterProp="label"
-                  placeholder={optionsLoading ? '加载中…' : '选择大类'}
-                  options={categoryParentOptions}
-                  onChange={() => createForm.setFieldValue('categoryId', undefined)}
-                />
-              </Form.Item>
-              <Form.Item
-                name="categoryId"
-                label="门店分类（细类）"
-                rules={[{ required: true, message: '请选择门店细类' }]}
+                name="categoryIds"
+                label="门店分类（细类，可多选）"
+                rules={[{ required: true, message: '请至少选择一个门店细类' }]}
                 extra={
                   <Typography.Link onClick={() => navigate('/store-categories')}>
                     去配置门店分类
@@ -1481,11 +1442,12 @@ export default function StoresPage() {
                 }
               >
                 <Select
+                  mode="multiple"
                   showSearch
+                  loading={optionsLoading}
                   optionFilterProp="label"
-                  placeholder={selectedCategoryParentId ? '选择细类' : '请先选大类'}
-                  disabled={!selectedCategoryParentId}
-                  options={categoryChildOptions}
+                  placeholder={optionsLoading ? '加载中…' : '选择细类，可多选'}
+                  options={categoryLeafOptions}
                 />
               </Form.Item>
               <Form.Item name="name" label="门店名称" rules={[{ required: true, message: '请填写门店名称' }]}>

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

@@ -1,4 +1,5 @@
 import { useEffect, useState } from 'react';
+import { useNavigate } from 'react-router-dom';
 import {
   Button,
   Card,
@@ -26,6 +27,7 @@ import {
 } from '@dukang/shared-types';
 import { fmtTime } from '../lib/constants';
 import { downloadExcelCsv } from '../lib/exportExcel';
+import { appendExportColumns } from '../lib/export-columns';
 import { request, type HqProfile } from '../lib/api';
 import { useAdminList } from '../lib/useAdminList';
 import { useAdminListColumns } from '../lib/useAdminListColumns';
@@ -37,6 +39,8 @@ type Row = {
   id: string;
   billNo: string;
   billDate: string;
+  periodStart: string;
+  periodEnd: string;
   orderCount: number;
   orderAmount: number;
   wineryRate: number;
@@ -107,6 +111,7 @@ const WINERY_BANK_KEYS = [
 ] as const;
 
 export default function WineryBillsPage() {
+  const navigate = useNavigate();
   const [form] = Form.useForm();
   const [bankForm] = Form.useForm<Record<string, string>>();
   const [reconcileForm] = Form.useForm<{ range?: [Dayjs, Dayjs] }>();
@@ -196,6 +201,7 @@ export default function WineryBillsPage() {
       if (filters.month) qs.set('month', filters.month);
       if (filters.dateFrom) qs.set('dateFrom', filters.dateFrom);
       if (filters.dateTo) qs.set('dateTo', filters.dateTo);
+      appendExportColumns(qs, exportColumnKeys);
       const result = await request<{ csv: string; count: number }>(`/admin/winery-bills/export?${qs}`);
       const suffix = filters.year && filters.month ? `${filters.year}-${filters.month}` : 'all';
       downloadExcelCsv(result.csv, `酒厂对账单_${suffix}.csv`);
@@ -275,6 +281,7 @@ export default function WineryBillsPage() {
   const baseColumns: ColumnsType<Row> = [
     {
       title: '账单号',
+      key: '账单号',
       dataIndex: 'billNo',
       width: 170,
       render: (v, row) => (
@@ -284,34 +291,49 @@ export default function WineryBillsPage() {
     {
       title: (
         <Tooltip title="出账当天的北京日历日；T+3 只决定纳入哪天完成的订单">
-          账单日
+          出账日
         </Tooltip>
       ),
+      key: '出账日',
       dataIndex: 'billDate',
       width: 110,
       render: (v) => String(v || '').slice(0, 10),
     },
-    { title: '订单数', dataIndex: 'orderCount', width: 80 },
     {
-      title: '酒单实付合计',
+      title: (
+        <Tooltip title="纳入本账单的订单完成日区间（含起止日）">
+          账期
+        </Tooltip>
+      ),
+      key: '账期',
+      width: 200,
+      render: (_, row) => `${row.periodStart} ~ ${row.periodEnd}`,
+    },
+    { title: '订单数', key: '订单数', dataIndex: 'orderCount', width: 80 },
+    {
+      title: '订单总额',
+      key: '订单总额',
       dataIndex: 'orderAmount',
       width: 120,
       render: (v) => `¥${Number(v).toFixed(2)}`,
     },
     {
       title: '酒厂比例',
+      key: '酒厂比例',
       dataIndex: 'wineryRate',
       width: 90,
       render: (v) => `${Math.round(Number(v) * 100)}%`,
     },
     {
       title: '应付',
+      key: '应付',
       dataIndex: 'wineryAmount',
       width: 110,
       render: (v) => `¥${Number(v).toFixed(2)}`,
     },
     {
       title: '状态',
+      key: '状态',
       dataIndex: 'status',
       width: 100,
       render: (s, row) => {
@@ -338,7 +360,7 @@ export default function WineryBillsPage() {
     },
   ];
 
-  const { columns, settingsButton, settingsModal } = useAdminListColumns('finance-winery-bills', baseColumns, { page, pageSize });
+  const { columns, settingsButton, settingsModal, exportColumnKeys } = useAdminListColumns('finance-winery-bills', baseColumns, { page, pageSize });
 
   return (
     <div>
@@ -365,7 +387,7 @@ export default function WineryBillsPage() {
         <Card size="small" style={{ marginBottom: 16 }}>
           <Space size="large" wrap>
             <Statistic title="账单数" value={summary.count} />
-            <Statistic title="酒单实付合计" value={summary.orderAmount ?? 0} prefix="¥" precision={2} />
+            <Statistic title="订单总额" value={summary.orderAmount ?? 0} prefix="¥" precision={2} />
             <Statistic title="应付合计" value={summary.wineryAmount ?? 0} prefix="¥" precision={2} />
           </Space>
         </Card>
@@ -460,7 +482,10 @@ export default function WineryBillsPage() {
           <>
             <Descriptions column={1} size="small" bordered>
               <Descriptions.Item label="账单号">{detail.billNo}</Descriptions.Item>
-              <Descriptions.Item label="账单日">{String(detail.billDate).slice(0, 10)}</Descriptions.Item>
+              <Descriptions.Item label="出账日">{String(detail.billDate).slice(0, 10)}</Descriptions.Item>
+              <Descriptions.Item label="账期">
+                {detail.periodStart} ~ {detail.periodEnd}
+              </Descriptions.Item>
               <Descriptions.Item label="应付">¥{Number(detail.wineryAmount).toFixed(2)}</Descriptions.Item>
               <Descriptions.Item label="状态">
                 {displayWineryStatus(detail.status, detail.wineryAmount).label}
@@ -500,7 +525,20 @@ export default function WineryBillsPage() {
               pagination={false}
               dataSource={detail.items ?? []}
               columns={[
-                { title: '订单号', dataIndex: 'orderNo' },
+                {
+                  title: '订单号',
+                  dataIndex: 'orderNo',
+                  render: (v: string) =>
+                    v ? (
+                      <AdminPrimaryLink
+                        onClick={() => navigate(`/orders?orderNo=${encodeURIComponent(v)}`)}
+                      >
+                        {v}
+                      </AdminPrimaryLink>
+                    ) : (
+                      '—'
+                    ),
+                },
                 {
                   title: '配送',
                   dataIndex: 'deliveryType',

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

@@ -1,7 +1,7 @@
 import { useEffect, useState } from 'react';
 import { Link } from 'react-router-dom';
 import {
-  Alert, Button, Card, Col, Descriptions, Form, Input, InputNumber, Row, Select, Space,
+  Alert, Button, Card, Col, Descriptions, Form, Image, Input, InputNumber, Row, Select, Space,
   Tabs, Tag, Typography, message,
 } from 'antd';
 import { request } from '../lib/api';
@@ -53,6 +53,22 @@ const CREATE_DEFAULTS = {
 
 function ResultPanel({ result }: { result: ApiResult | null }) {
   if (!result) return <Typography.Text type="secondary">点击「调用接口」后在此显示响应</Typography.Text>;
+  const display = (() => {
+    if (!result.data || typeof result.data !== 'object') return result;
+    const data = result.data as { count?: number; data?: string[] };
+    if (!Array.isArray(data.data)) return result;
+    return {
+      ...result,
+      data: {
+        ...data,
+        data: data.data.map((item) =>
+          typeof item === 'string' && item.length > 120
+            ? `${item.slice(0, 80)}…(len=${item.length})`
+            : item,
+        ),
+      },
+    };
+  })();
   return (
     <div>
       <Space style={{ marginBottom: 8 }}>
@@ -64,7 +80,7 @@ function ResultPanel({ result }: { result: ApiResult | null }) {
         margin: 0, padding: 12, background: '#f5f5f5', borderRadius: 4,
         maxHeight: 360, overflow: 'auto', fontSize: 12,
       }}>
-        {JSON.stringify(result, null, 2)}
+        {JSON.stringify(display, null, 2)}
       </pre>
     </div>
   );
@@ -81,7 +97,9 @@ export default function XiaofeixiaTestPage() {
   const [queryForm] = Form.useForm();
   const [batchForm] = Form.useForm();
   const [trackForm] = Form.useForm();
+  const [signPhotoForm] = Form.useForm();
   const [cancelForm] = Form.useForm();
+  const [signPhotoPreview, setSignPhotoPreview] = useState<string[]>([]);
 
   useEffect(() => {
     void request<XfxConfig>('/admin/courier/xiaofeixia/config').then(setConfig);
@@ -99,12 +117,19 @@ export default function XiaofeixiaTestPage() {
         body: JSON.stringify(body),
       });
       setResult(res);
+      if (path.endsWith('/get-sign-photos')) {
+        const data = (res.data as { data?: string[] } | undefined)?.data;
+        setSignPhotoPreview(Array.isArray(data) ? data.filter((u) => typeof u === 'string') : []);
+      } else {
+        setSignPhotoPreview([]);
+      }
       if (res.ok) message.success('调用成功');
       else message.warning(res.error || '调用失败');
     } catch (e) {
       const err = e instanceof Error ? e.message : String(e);
       message.error(err);
       setResult({ ok: false, elapsedMs: 0, error: err });
+      setSignPhotoPreview([]);
     } finally {
       setLoading(false);
     }
@@ -118,7 +143,7 @@ export default function XiaofeixiaTestPage() {
     <div>
       <Typography.Title level={4}>小飞侠接口联调</Typography.Title>
       <Typography.Paragraph type="secondary">
-        通过 HQ 后台直接调用后端封装的小飞侠 API（cmd 100101~100301）。凭证请在
+        通过 HQ 后台直接调用后端封装的小飞侠 API（cmd 100101~100301，含签收图片 100108）。凭证请在
         <Link to="/fulfillment-providers">仓配管理</Link>
         中配置；联调会优先使用仓配管理里启用的小飞侠承运商。
       </Typography.Paragraph>
@@ -273,6 +298,25 @@ export default function XiaofeixiaTestPage() {
                   </Form>
                 ),
               },
+              {
+                key: 'signPhotos',
+                label: '签收图片 (100108)',
+                children: (
+                  <Form
+                    form={signPhotoForm}
+                    layout="vertical"
+                    onFinish={(v) => void invoke('/admin/courier/xiaofeixia/get-sign-photos', v)}
+                  >
+                    <Form.Item name="trackingNumber" label="运单号 number">
+                      <Input placeholder="小飞侠运单号，与商家单号二选一" />
+                    </Form.Item>
+                    <Form.Item name="outNumber" label="商家单号 outNumber">
+                      <Input placeholder="外部单号，与运单号二选一" />
+                    </Form.Item>
+                    <Button type="primary" htmlType="submit" loading={loading}>调用接口</Button>
+                  </Form>
+                ),
+              },
               {
                 key: 'cancel',
                 label: '取消订单 (100103)',
@@ -290,6 +334,24 @@ export default function XiaofeixiaTestPage() {
         <Col xs={24} lg={10}>
           <Card title="响应结果" size="small">
             <ResultPanel result={result} />
+            {signPhotoPreview.length > 0 ? (
+              <div style={{ marginTop: 16 }}>
+                <Typography.Text strong>签收照片预览（{signPhotoPreview.length}）</Typography.Text>
+                <Image.PreviewGroup>
+                  <Space wrap style={{ marginTop: 8 }}>
+                    {signPhotoPreview.map((url, index) => (
+                      <Image
+                        key={`${index}-${url.slice(0, 32)}`}
+                        src={url}
+                        width={96}
+                        height={96}
+                        style={{ objectFit: 'cover', borderRadius: 6 }}
+                      />
+                    ))}
+                  </Space>
+                </Image.PreviewGroup>
+              </div>
+            ) : null}
           </Card>
         </Col>
       </Row>

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

@@ -25,7 +25,10 @@ export type StoreDraftForm = {
   /** 人均费用（选填） */
   avgPrice: string;
   categoryParentId: string;
+  /** @deprecated 使用 categoryIds */
   categoryId: string;
+  /** 二级分类多选 */
+  categoryIds: string[];
   intro: string;
   /** 好客权益券使用规则 */
   benefitUsageRule: string;
@@ -68,6 +71,7 @@ export const defaultStoreForm = (): StoreDraftForm => ({
   avgPrice: '',
   categoryParentId: '',
   categoryId: '',
+  categoryIds: [],
   intro: '',
   benefitUsageRule: '',
   coverUrl: '',
@@ -122,6 +126,20 @@ export function normalizeStoreDraftForm(raw: Partial<StoreDraftForm> | null | un
     openTime2: String(raw.openTime2 ?? base.openTime2),
     closeTime2: String(raw.closeTime2 ?? base.closeTime2),
     avgPrice: String(raw.avgPrice ?? base.avgPrice),
+    categoryIds: (() => {
+      if (Array.isArray(raw.categoryIds) && raw.categoryIds.length) {
+        return raw.categoryIds.map(String).filter(Boolean);
+      }
+      const legacy = String(raw.categoryId ?? '').trim();
+      return legacy ? [legacy] : base.categoryIds;
+    })(),
+    categoryId: (() => {
+      const ids = Array.isArray(raw.categoryIds) && raw.categoryIds.length
+        ? raw.categoryIds.map(String).filter(Boolean)
+        : [];
+      if (ids.length) return ids[0];
+      return String(raw.categoryId ?? base.categoryId);
+    })(),
     envPhotoUrls: normalizeStringArray(raw.envPhotoUrls, MIN_ENV_PHOTO_COUNT),
     // 兼容旧草稿：单个 contractUrl 迁移为数组
     contractUrls: (() => {
@@ -201,7 +219,7 @@ export function validateStoreStep1(
     | 'openTime2'
     | 'closeTime2'
     | 'avgPrice'
-    | 'categoryId'
+    | 'categoryIds'
     | 'intro'
     | 'benefitUsageRule'
   >,
@@ -233,7 +251,7 @@ export function validateStoreStep1(
     const n = Number(form.avgPrice);
     if (Number.isNaN(n) || n < 0) return '人均费用须为非负数字';
   }
-  if (!form.categoryId.trim()) return '请选择店铺类型';
+  if (!form.categoryIds?.length) return '请至少选择一个店铺类型';
   if (form.intro.trim()) {
     const len = form.intro.trim().length;
     if (len < 2 || len > 500) return '门店简介须为 2~500 字';

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

@@ -3,6 +3,7 @@ import { useNavigate, useSearchParams } from 'react-router-dom';
 import QRCode from 'qrcode';
 import PageHeader from '@dukang/shared-ui/PageHeader';
 import { invokeWechatPay } from '@dukang/weixin-sdk';
+import { validateShippingAddress } from '@dukang/domain';
 import ChinaRegionPicker from '../components/ChinaRegionPicker';
 import { getToken, request } from '../lib/api';
 import { formatRegionLabel, parseRegionCodes } from '../lib/china-region';
@@ -243,6 +244,13 @@ export default function ProxyOrderPage() {
       if (!allowOnline) return '该商品不支持线上购买';
       if (!region?.province || !region?.city || !region?.district) return '请选择省市区';
       if (!addressDetail.trim()) return '请填写详细地址';
+      const shipping = validateShippingAddress({
+        province: region.province,
+        city: region.city,
+        district: region.district,
+        detail: addressDetail,
+      });
+      if (!shipping.ok) return shipping.message || '请完善收货地址';
       if (!autoReceive) return '配送到址须勾选同意自动收货';
     } else if (!allowOnSite) {
       return '该商品不支持现场提货';

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

@@ -206,9 +206,9 @@ export default function StoreCreatePage() {
       .then((list) => {
         const tree = Array.isArray(list) ? list : [];
         setCategoryTree(tree);
-        if (form.categoryId && !form.categoryParentId) {
+        if (form.categoryIds.length && !form.categoryParentId) {
           const parent = tree.find((root) =>
-            (root.children ?? []).some((child) => child.id === form.categoryId),
+            (root.children ?? []).some((child) => form.categoryIds.includes(child.id)),
           );
           if (parent) patchForm({ categoryParentId: parent.id });
         }
@@ -216,12 +216,6 @@ export default function StoreCreatePage() {
       .catch(() => setCategoryTree([]));
   }, []);
 
-  const categoryChildren = useMemo(() => {
-    const parent = categoryTree.find((item) => item.id === form.categoryParentId);
-    return Array.isArray(parent?.children) ? parent!.children! : [];
-  }, [categoryTree, form.categoryParentId]);
-
-
 
   useEffect(() => {
 
@@ -523,7 +517,8 @@ export default function StoreCreatePage() {
 
           ...(form.avgPrice.trim() ? { avgPrice: Number(form.avgPrice) } : {}),
 
-          categoryId: form.categoryId.trim(),
+          categoryIds: form.categoryIds,
+          categoryId: form.categoryIds[0] || form.categoryId.trim(),
 
           intro: form.intro.trim() || undefined,
           benefitUsageRule: form.benefitUsageRule.trim() || undefined,
@@ -690,56 +685,40 @@ export default function StoreCreatePage() {
 
             <div className="partner-field">
 
-              <label>店铺类型 <span className="text-primary">*</span></label>
-
-              <div className="partner-input-row" style={{ gap: 8 }}>
-
-                <select
-
-                  className="partner-field-input partner-field-input--block"
-
-                  value={form.categoryParentId}
-
-                  onChange={(e) => patchForm({ categoryParentId: e.target.value, categoryId: '' })}
-
-                  aria-label="一级店铺类型"
-
-                >
-
-                  <option value="">选择大类</option>
-
-                  {categoryTree.map((item) => (
-
-                    <option key={item.id} value={item.id}>{item.name}</option>
-
-                  ))}
-
-                </select>
-
-                <select
-
-                  className="partner-field-input partner-field-input--block"
-
-                  value={form.categoryId}
-
-                  onChange={(e) => patchForm({ categoryId: e.target.value })}
-
-                  disabled={!form.categoryParentId}
-
-                  aria-label="二级店铺类型"
-
-                >
-
-                  <option value="">{form.categoryParentId ? '选择细类' : '请先选大类'}</option>
-
-                  {categoryChildren.map((item) => (
-
-                    <option key={item.id} value={item.id}>{item.name}</option>
-
-                  ))}
-
-                </select>
+              <label>店铺类型 <span className="text-primary">*</span> <span className="label-md text-muted">（可多选）</span></label>
 
+              <div className="partner-category-multi">
+                {categoryTree.map((parent) => (
+                  <div key={parent.id} className="partner-category-group">
+                    <div className="partner-category-group-title">{parent.name}</div>
+                    <div className="partner-category-options">
+                      {(parent.children ?? []).map((child) => {
+                        const checked = form.categoryIds.includes(child.id);
+                        return (
+                          <label key={child.id} className="partner-category-option">
+                            <input
+                              type="checkbox"
+                              checked={checked}
+                              onChange={() => {
+                                const next = checked
+                                  ? form.categoryIds.filter((id) => id !== child.id)
+                                  : [...form.categoryIds, child.id];
+                                patchForm({
+                                  categoryIds: next,
+                                  categoryId: next[0] ?? '',
+                                  categoryParentId: next.length
+                                    ? parent.id
+                                    : form.categoryParentId,
+                                });
+                              }}
+                            />
+                            <span>{child.name}</span>
+                          </label>
+                        );
+                      })}
+                    </div>
+                  </div>
+                ))}
               </div>
 
             </div>

apps/mini-user/package.json

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

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

@@ -53,10 +53,10 @@ export default function OrderQtyControls({ value, unitLabel, onChange }: OrderQt
           onBlur={commit}
           onConfirm={commit}
         />
-        <Text className="order-qty-unit">{unitLabel}</Text>
         <View className="order-qty-btn" onClick={() => onChange(Math.min(MAX_QTY, current() + 1))}>
           <Text>＋</Text>
         </View>
+        <Text className="order-qty-unit">{unitLabel}</Text>
       </View>
     </View>
   );

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

@@ -6,8 +6,10 @@ import {
   getCitiesForPicker,
   getDistricts,
   getDistrictsForPicker,
+  getDistrictsForShippingPicker,
   getProvincesForPicker,
   normalizeRegionSelection,
+  normalizeShippingRegionSelection,
   toCityLevelRegion,
   type RegionSelection,
 } from '../lib/region-data';
@@ -18,6 +20,8 @@ type RegionPickerProps = {
   onClose: () => void;
   onConfirm: (region: RegionSelection) => void;
   levels?: 2 | 3;
+  /** filter：门店筛选可「全市」；shipping：收货地址禁止伪区县 */
+  mode?: 'filter' | 'shipping';
 };
 
 type PickerLevel = 'province' | 'city' | 'district';
@@ -28,8 +32,13 @@ const ALL_TABS: Array<{ key: PickerLevel; label: string }> = [
   { key: 'district', label: '区县' },
 ];
 
-function initialTab(value: RegionSelection, levels: 2 | 3): PickerLevel {
-  const normalized = levels === 2 ? toCityLevelRegion(value) : normalizeRegionSelection(value);
+function initialTab(value: RegionSelection, levels: 2 | 3, mode: 'filter' | 'shipping'): PickerLevel {
+  const normalized =
+    levels === 2
+      ? toCityLevelRegion(value)
+      : mode === 'shipping'
+        ? normalizeShippingRegionSelection(value)
+        : normalizeRegionSelection(value);
   if (levels === 2) {
     return normalized.province && normalized.province !== REGION_ALL ? 'city' : 'province';
   }
@@ -54,24 +63,35 @@ export default function RegionPicker({
   onClose,
   onConfirm,
   levels = 3,
+  mode = 'filter',
 }: RegionPickerProps) {
   const [draft, setDraft] = useState<RegionSelection>(value);
   const [activeTab, setActiveTab] = useState<PickerLevel>('province');
 
   const tabs = levels === 2 ? ALL_TABS.slice(0, 2) : ALL_TABS;
+  const shipping = mode === 'shipping';
 
   useEffect(() => {
     if (!open) return;
-    const normalized = levels === 2 ? toCityLevelRegion(value) : normalizeRegionSelection(value);
+    const normalized =
+      levels === 2
+        ? toCityLevelRegion(value)
+        : shipping
+          ? normalizeShippingRegionSelection(value)
+          : normalizeRegionSelection(value);
     setDraft(normalized);
-    setActiveTab(initialTab(value, levels));
-  }, [open, value, levels]);
+    setActiveTab(initialTab(value, levels, mode));
+  }, [open, value, levels, mode, shipping]);
 
   const listItems = useMemo(() => {
     if (activeTab === 'province') return getProvincesForPicker();
-    if (activeTab === 'city') return getCitiesForPicker(draft.province);
+    if (activeTab === 'city') {
+      if (shipping) return getCities(draft.province);
+      return getCitiesForPicker(draft.province);
+    }
+    if (shipping) return getDistrictsForShippingPicker(draft.province, draft.city);
     return getDistrictsForPicker(draft.province, draft.city);
-  }, [activeTab, draft.province, draft.city]);
+  }, [activeTab, draft.province, draft.city, shipping]);
 
   const selectedValue =
     activeTab === 'province' ? draft.province : activeTab === 'city' ? draft.city : draft.district;
@@ -79,12 +99,19 @@ export default function RegionPicker({
   const canConfirm =
     levels === 2
       ? Boolean(draft.province && draft.city)
-      : Boolean(draft.province && draft.city && draft.district);
+      : shipping
+        ? Boolean(
+            draft.province &&
+              draft.city &&
+              draft.district &&
+              draft.district !== REGION_ALL,
+          )
+        : Boolean(draft.province && draft.city && draft.district);
 
   if (!open) return null;
 
   function selectProvince(province: string) {
-    if (province === REGION_ALL) {
+    if (!shipping && province === REGION_ALL) {
       setDraft({ province: REGION_ALL, city: REGION_ALL, district: REGION_ALL });
       setActiveTab('city');
       return;
@@ -97,12 +124,16 @@ export default function RegionPicker({
       return;
     }
     const nextDistricts = getDistricts(province, city);
-    setDraft({ province, city, district: nextDistricts[0] ?? '' });
+    setDraft({
+      province,
+      city,
+      district: shipping ? '' : (nextDistricts[0] ?? ''),
+    });
     setActiveTab('city');
   }
 
   function selectCity(city: string) {
-    if (city === REGION_ALL) {
+    if (!shipping && city === REGION_ALL) {
       setDraft({ ...draft, city: REGION_ALL, district: REGION_ALL });
       if (levels === 3) setActiveTab('district');
       return;
@@ -112,11 +143,16 @@ export default function RegionPicker({
       return;
     }
     const nextDistricts = getDistricts(draft.province, city);
-    setDraft({ ...draft, city, district: nextDistricts[0] ?? '' });
+    setDraft({
+      ...draft,
+      city,
+      district: shipping ? '' : (nextDistricts[0] ?? ''),
+    });
     setActiveTab('district');
   }
 
   function selectDistrict(district: string) {
+    if (shipping && district === REGION_ALL) return;
     setDraft({ ...draft, district });
   }
 
@@ -134,7 +170,13 @@ export default function RegionPicker({
 
   function handleConfirm() {
     if (!canConfirm) return;
-    const next = levels === 2 ? toCityLevelRegion(draft) : normalizeRegionSelection(draft);
+    const next =
+      levels === 2
+        ? toCityLevelRegion(draft)
+        : shipping
+          ? normalizeShippingRegionSelection(draft)
+          : normalizeRegionSelection(draft);
+    if (shipping && (!next.district || next.district === REGION_ALL)) return;
     onConfirm(next);
     onClose();
   }

apps/mini-user/src/lib/region-data.ts

@@ -30,6 +30,12 @@ export function getDistrictsForPicker(province: string, city: string): string[]
   return [REGION_ALL, ...getDistricts(province, city)];
 }
 
+/** 收货地址：不含「全市」 */
+export function getDistrictsForShippingPicker(province: string, city: string): string[] {
+  if (province === REGION_ALL || city === REGION_ALL) return [];
+  return [...getDistricts(province, city)];
+}
+
 export function formatRegion(province: string, city: string, district: string): string {
   if (!province) return '';
   if (province === REGION_ALL) return REGION_ALL;
@@ -96,6 +102,35 @@ export const DEFAULT_REGION: RegionSelection = {
   district: REGION_ALL,
 };
 
+/** 收货地址默认：不预填伪区县，迫使用户选真实区县 */
+export const DEFAULT_SHIPPING_REGION: RegionSelection = {
+  province: '河南省',
+  city: '郑州市',
+  district: '',
+};
+
+/** 收货场景：区县必须在省市区树内且非全市 */
+export function normalizeShippingRegionSelection(selection: RegionSelection): RegionSelection {
+  const province = PROVINCES.includes(selection.province)
+    ? selection.province
+    : DEFAULT_SHIPPING_REGION.province;
+  const cities = getCities(province);
+  const city = cities.includes(selection.city) ? selection.city : (cities[0] ?? DEFAULT_SHIPPING_REGION.city);
+  const districts = getDistricts(province, city);
+  const district =
+    selection.district &&
+    selection.district !== REGION_ALL &&
+    districts.includes(selection.district)
+      ? selection.district
+      : '';
+  return { province, city, district };
+}
+
+export function isShippingRegionComplete(selection: RegionSelection): boolean {
+  const n = normalizeShippingRegionSelection(selection);
+  return Boolean(n.province && n.city && n.district && n.district !== REGION_ALL);
+}
+
 export function regionFromGeo(province: string, city: string, district?: string): RegionSelection {
   const cityName = city.endsWith('市') ? city : `${city}市`;
   const provinceInTree = PROVINCES.includes(province) ? province : DEFAULT_REGION.province;

apps/mini-user/src/lib/shipping-address.ts

@@ -0,0 +1,61 @@
+import {
+  REGION_ALL,
+  isShippingRegionComplete,
+  normalizeShippingRegionSelection,
+  type RegionSelection,
+} from './region-data';
+
+export const SHIPPING_DETAIL_MIN_LEN = 8;
+export const SHIPPING_REGION_REQUIRED_MSG = '请选择具体区县';
+export const SHIPPING_DETAIL_REQUIRED_MSG = '请填写详细地址';
+export const SHIPPING_DETAIL_TOO_SHORT_MSG = '请填写更详细的收货地址（含街道门牌）';
+
+export type ShippingAddressLike = {
+  province?: string | null;
+  city?: string | null;
+  district?: string | null;
+  detail?: string | null;
+};
+
+export function isDirtyShippingAddress(addr: ShippingAddressLike): boolean {
+  return !validateClientShippingAddress(addr).ok;
+}
+
+export function validateClientShippingAddress(addr: ShippingAddressLike): {
+  ok: boolean;
+  message?: string;
+} {
+  const province = String(addr.province ?? '').trim();
+  const city = String(addr.city ?? '').trim();
+  const district = String(addr.district ?? '').trim();
+  const detail = String(addr.detail ?? '').trim();
+
+  if (!province || !city) return { ok: false, message: '请选择所在地区' };
+  if (!district || district === REGION_ALL || district === '全部') {
+    return { ok: false, message: SHIPPING_REGION_REQUIRED_MSG };
+  }
+  const regionOk = isShippingRegionComplete({ province, city, district });
+  if (!regionOk) {
+    return { ok: false, message: SHIPPING_REGION_REQUIRED_MSG };
+  }
+  if (!detail) return { ok: false, message: SHIPPING_DETAIL_REQUIRED_MSG };
+  if (detail.length < SHIPPING_DETAIL_MIN_LEN) {
+    return { ok: false, message: SHIPPING_DETAIL_TOO_SHORT_MSG };
+  }
+  return { ok: true };
+}
+
+export function shippingDetailCityWideHint(detail: string | null | undefined): string | null {
+  const d = String(detail ?? '').trim();
+  if (!d.includes('全市')) return null;
+  if (/路|街|巷|号|大厦|广场|小区|村|镇|乡/.test(d)) return null;
+  return '详细地址含「全市」，建议改为具体街道门牌，以免配送拒单';
+}
+
+export function toShippingRegion(addr: ShippingAddressLike): RegionSelection {
+  return normalizeShippingRegionSelection({
+    province: String(addr.province ?? ''),
+    city: String(addr.city ?? ''),
+    district: String(addr.district ?? ''),
+  });
+}

apps/mini-user/src/lib/store-display.ts

@@ -22,6 +22,7 @@ export function storeCategoryTags(
     tags?: unknown;
     categoryId?: string | null;
     category?: StoreCategoryLike | null;
+    categories?: StoreCategoryLike[] | null;
   },
   tree: StoreCategoryTreeNode[] = [],
 ): string[] {
@@ -30,24 +31,125 @@ export function storeCategoryTags(
     : [];
   if (fromJson.length) return fromJson;
 
-  const names: string[] = [];
-  const childName = String(store.category?.name || '').trim();
-  const parentName = String(store.category?.parent?.name || '').trim();
-  if (parentName) names.push(parentName);
-  if (childName && childName !== parentName) names.push(childName);
+  const multi = Array.isArray(store.categories) ? store.categories : [];
+  if (multi.length) {
+    return groupCategoryTags(multi, tree);
+  }
 
-  const storeCatId = String(store.categoryId || store.category?.id || '');
-  const storeParentId = String(store.category?.parentId || '');
-  for (const root of tree) {
-    if (root.id === storeParentId || root.id === storeCatId) {
-      if (root.name && !names.includes(root.name)) names.unshift(root.name);
-    }
-    for (const child of root.children ?? []) {
-      if (child.id === storeCatId) {
-        if (root.name && !names.includes(root.name)) names.unshift(root.name);
-        if (child.name && !names.includes(child.name)) names.push(child.name);
+  if (store.category || store.categoryId) {
+    const grouped = groupCategoryTags(
+      store.category ? [store.category] : [],
+      tree,
+      store.categoryId,
+    );
+    if (grouped.length) return grouped;
+  }
+
+  const storeCatId = String(store.categoryId || '');
+  if (storeCatId) {
+    for (const root of tree) {
+      for (const child of root.children ?? []) {
+        if (child.id === storeCatId) {
+          return [`${root.name}|${child.name}`];
+        }
       }
     }
   }
-  return names;
+  return [];
+}
+
+/** 按大类分组：餐饮|火锅·江浙菜、娱乐|KTV */
+function groupCategoryTags(
+  categories: StoreCategoryLike[],
+  tree: StoreCategoryTreeNode[] = [],
+  fallbackCategoryId?: string | null,
+): string[] {
+  if (!categories.length && fallbackCategoryId) {
+    return groupCategoryTags([{ id: String(fallbackCategoryId) }], tree);
+  }
+
+  const groups = new Map<string, { parentName: string; children: string[] }>();
+  const order: string[] = [];
+
+  for (const cat of categories) {
+    const resolved = resolveCategoryParts(cat, tree);
+    if (!resolved) continue;
+    const { parentKey, parentName, childName } = resolved;
+    if (!groups.has(parentKey)) {
+      groups.set(parentKey, { parentName, children: [] });
+      order.push(parentKey);
+    }
+    const group = groups.get(parentKey)!;
+    if (childName && childName !== parentName && !group.children.includes(childName)) {
+      group.children.push(childName);
+    }
+  }
+
+  return order
+    .map((key) => {
+      const group = groups.get(key)!;
+      if (group.parentName && group.children.length) {
+        return `${group.parentName}|${group.children.join('·')}`;
+      }
+      if (group.children.length) return group.children.join('·');
+      return group.parentName;
+    })
+    .filter(Boolean);
+}
+
+function resolveCategoryParts(
+  cat: StoreCategoryLike,
+  tree: StoreCategoryTreeNode[] = [],
+): { parentKey: string; parentName: string; childName: string } | null {
+  const childName = String(cat.name || '').trim();
+  let parentName = String(cat.parent?.name || '').trim();
+  const catId = String(cat.id || '');
+  const parentId = String(cat.parentId || '');
+
+  if (!parentName && (parentId || catId)) {
+    for (const root of tree) {
+      if (parentId && root.id === parentId) {
+        parentName = root.name;
+        break;
+      }
+      for (const child of root.children ?? []) {
+        if (catId && child.id === catId) {
+          parentName = root.name;
+          if (!childName) return { parentKey: root.id, parentName, childName: child.name };
+          break;
+        }
+      }
+    }
+  }
+
+  if (!childName && !parentName) return null;
+
+  const parentKey = parentId || parentName || catId;
+  if (!parentName && catId) {
+    for (const root of tree) {
+      for (const child of root.children ?? []) {
+        if (child.id === catId) {
+          return { parentKey: root.id, parentName: root.name, childName: child.name };
+        }
+      }
+    }
+  }
+
+  return {
+    parentKey,
+    parentName: parentName || childName,
+    childName: childName || parentName,
+  };
+}
+
+export function storeLeafCategoryIds(store: {
+  categoryId?: string | null;
+  category?: StoreCategoryLike | null;
+  categories?: StoreCategoryLike[] | null;
+}): string[] {
+  if (Array.isArray(store.categories) && store.categories.length) {
+    return store.categories.map((c) => String(c.id || '')).filter(Boolean);
+  }
+  const id = String(store.categoryId || store.category?.id || '');
+  return id ? [id] : [];
 }

apps/mini-user/src/lib/stores-session.ts

@@ -40,7 +40,7 @@ type StoresSession = {
   cache: StoresListCache | null;
 };
 
-const STORAGE_KEY = 'dukang_stores_session_v2';
+const STORAGE_KEY = 'dukang_stores_session_v3';
 
 let memory: StoresSession | null = null;
 

apps/mini-user/src/pages/address-edit/index.tsx

@@ -7,12 +7,16 @@ import SubPageHeader from '../../components/SubPageHeader';
 import RegionPicker from '../../components/RegionPicker';
 import { buildAddressListUrl, readCheckoutContext } from '../../lib/checkout-nav';
 import {
-  DEFAULT_REGION,
+  DEFAULT_SHIPPING_REGION,
   REGION_ALL,
   formatRegion,
   type RegionSelection,
 } from '../../lib/region-data';
 import { normalizePhoneInput, validateMobilePhone } from '../../lib/phone';
+import {
+  shippingDetailCityWideHint,
+  validateClientShippingAddress,
+} from '../../lib/shipping-address';
 import { getStoredUserPhone, resolveDefaultUserPhone } from '../../lib/user-phone';
 import { resolveUserCity } from '../../lib/user-location';
 import { request, toast, type UserProfile } from '../../lib/api';
@@ -36,12 +40,13 @@ export default function AddressEditPage() {
   const [saving, setSaving] = useState(false);
   const [locating, setLocating] = useState(false);
   const [error, setError] = useState('');
+  const [hint, setHint] = useState('');
   const [form, setForm] = useState<AddressForm>(() => ({
     receiverName: '',
     phone: id ? '' : getStoredUserPhone(),
-    province: DEFAULT_REGION.province,
-    city: DEFAULT_REGION.city,
-    district: DEFAULT_REGION.district,
+    province: DEFAULT_SHIPPING_REGION.province,
+    city: DEFAULT_SHIPPING_REGION.city,
+    district: DEFAULT_SHIPPING_REGION.district,
     detail: '',
     isDefault: true,
   }));
@@ -69,7 +74,7 @@ export default function AddressEditPage() {
             ? resolved.region.district
             : resolved.district && resolved.district !== REGION_ALL
               ? resolved.district
-              : DEFAULT_REGION.district;
+              : '';
         setForm((prev) => ({
           ...prev,
           province: resolved.region.province || prev.province,
@@ -91,12 +96,13 @@ export default function AddressEditPage() {
     request<Array<Record<string, unknown>>>('/user/addresses').then((list) => {
       const found = list.find((a) => String(a.id) === id);
       if (found) {
+        const district = String(found.district ?? '');
         setForm({
           receiverName: String(found.receiverName ?? ''),
           phone: String(found.phone ?? ''),
-          province: String(found.province ?? DEFAULT_REGION.province),
-          city: String(found.city ?? DEFAULT_REGION.city),
-          district: String(found.district ?? DEFAULT_REGION.district),
+          province: String(found.province ?? DEFAULT_SHIPPING_REGION.province),
+          city: String(found.city ?? DEFAULT_SHIPPING_REGION.city),
+          district: district === REGION_ALL ? '' : district,
           detail: String(found.detail ?? ''),
           isDefault: found.isDefault === 1 || found.isDefault === true,
         });
@@ -104,14 +110,21 @@ export default function AddressEditPage() {
     }).catch(() => {});
   }, [id]);
 
-  const regionText = formatRegion(form.province, form.city, form.district);
+  useEffect(() => {
+    setHint(shippingDetailCityWideHint(form.detail) ?? '');
+  }, [form.detail]);
+
+  const regionText =
+    form.province && form.city && form.district
+      ? formatRegion(form.province, form.city, form.district)
+      : '';
 
   function validateForm(): string | null {
     if (!form.receiverName.trim()) return '请输入收货人姓名';
     const phoneCheck = validateMobilePhone(form.phone);
     if (!phoneCheck.ok) return phoneCheck.message ?? '请输入正确的手机号码';
-    if (!form.province || !form.city || !form.district) return '请选择所在地区';
-    if (!form.detail.trim()) return '请输入详细地址';
+    const shipping = validateClientShippingAddress(form);
+    if (!shipping.ok) return shipping.message ?? '请完善收货地址';
     return null;
   }
 
@@ -201,7 +214,7 @@ export default function AddressEditPage() {
             <Text>
               {locating && !isEdit
                 ? '定位中…'
-                : regionText || '请选择省市区'}
+                : regionText || '请选择省 / 市 / 区县'}
             </Text>
           </View>
         </View>
@@ -228,6 +241,7 @@ export default function AddressEditPage() {
             />
           )}
         </View>
+        {hint ? <Text className="address-form-hint">{hint}</Text> : null}
         <View className="address-form-row">
           <Text>设为默认地址</Text>
           <Switch
@@ -248,6 +262,7 @@ export default function AddressEditPage() {
         onClose={() => setPickerOpen(false)}
         onConfirm={onRegionConfirm}
         levels={3}
+        mode="shipping"
       />
     </PageShell>
   );

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

@@ -9,6 +9,7 @@ import {
   buildOrderConfirmUrl,
   readCheckoutContext,
 } from '../../lib/checkout-nav';
+import { isDirtyShippingAddress } from '../../lib/shipping-address';
 import { request, toast } from '../../lib/api';
 
 type Address = {
@@ -51,6 +52,11 @@ export default function AddressesPage() {
 
   function selectAddress(addr: Address) {
     if (!selectMode) return;
+    if (isDirtyShippingAddress(addr)) {
+      toast('该地址缺少具体区县，请先完善');
+      Taro.navigateTo({ url: buildAddressEditUrl(addr.id, checkoutCtx) }).catch(() => {});
+      return;
+    }
     Taro.redirectTo({
       url: buildOrderConfirmUrl({
         productId: checkoutCtx.productId,
@@ -76,6 +82,12 @@ export default function AddressesPage() {
     }
   }
 
+  const sorted = [...list].sort((a, b) => {
+    const da = isDirtyShippingAddress(a) ? 0 : 1;
+    const db = isDirtyShippingAddress(b) ? 0 : 1;
+    return da - db;
+  });
+
   return (
     <PageShell variant="sub" className="address-page" hasFixedFooter>
       <SubPageHeader title={selectMode ? '选择收货地址' : '地址管理'} />
@@ -84,46 +96,55 @@ export default function AddressesPage() {
         {!loading && list.length === 0 ? (
           <View className="u-empty">暂无收货地址</View>
         ) : null}
-        {list.map((a) => (
-          <View
-            key={a.id}
-            className="address-item"
-            onClick={() => selectAddress(a)}
-          >
-            <View className="address-item-head">
-              <Text className="address-item-name">{a.receiverName}</Text>
-              <Text className="address-item-phone">{a.phone}</Text>
-              {a.isDefault === 1 || a.isDefault === true ? (
-                <Text className="address-default-tag">默认</Text>
+        {sorted.map((a) => {
+          const dirty = isDirtyShippingAddress(a);
+          return (
+            <View
+              key={a.id}
+              className={`address-item${dirty ? ' address-item--dirty' : ''}`}
+              onClick={() => selectAddress(a)}
+            >
+              <View className="address-item-head">
+                <Text className="address-item-name">{a.receiverName}</Text>
+                <Text className="address-item-phone">{a.phone}</Text>
+                {dirty ? <Text className="address-need-fix-tag">需完善</Text> : null}
+                {a.isDefault === 1 || a.isDefault === true ? (
+                  <Text className="address-default-tag">默认</Text>
+                ) : null}
+              </View>
+              <Text className="address-item-detail">{formatAddress(a)}</Text>
+              {dirty ? (
+                <Text className="address-item-warn">缺少具体区县，同城配送可能失败，请编辑完善</Text>
+              ) : null}
+              {!selectMode || dirty ? (
+                <View className="address-item-actions">
+                  <Text
+                    className="address-action"
+                    onClick={(e) => {
+                      e.stopPropagation();
+                      Taro.navigateTo({ url: buildAddressEditUrl(a.id, checkoutCtx) }).catch((err) => {
+                        toast(err instanceof Error ? err.message : '无法打开编辑页');
+                      });
+                    }}
+                  >
+                    {dirty ? '去完善' : '编辑'}
+                  </Text>
+                  {!selectMode ? (
+                    <Text
+                      className="address-action"
+                      onClick={(e) => {
+                        e.stopPropagation();
+                        void removeAddress(a.id);
+                      }}
+                    >
+                      删除
+                    </Text>
+                  ) : null}
+                </View>
               ) : null}
             </View>
-            <Text className="address-item-detail">{formatAddress(a)}</Text>
-            {!selectMode ? (
-              <View className="address-item-actions">
-                <Text
-                  className="address-action"
-                  onClick={(e) => {
-                    e.stopPropagation();
-                    Taro.navigateTo({ url: buildAddressEditUrl(a.id, checkoutCtx) }).catch((err) => {
-                      toast(err instanceof Error ? err.message : '无法打开编辑页');
-                    });
-                  }}
-                >
-                  编辑
-                </Text>
-                <Text
-                  className="address-action"
-                  onClick={(e) => {
-                    e.stopPropagation();
-                    void removeAddress(a.id);
-                  }}
-                >
-                  删除
-                </Text>
-              </View>
-            ) : null}
-          </View>
-        ))}
+          );
+        })}
       </View>
       <View
         className="address-fab"

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

@@ -196,6 +196,17 @@ export default function HomePage() {
     Taro.navigateTo({ url: `/pages/product-detail/index?id=${id}` });
   }
 
+  async function goBuyOnline(productId: string) {
+    const returnPath = `/pages/order-confirm/index?productId=${productId}&qty=2`;
+    if (!isLoggedIn()) {
+      goLogin(returnPath);
+      return;
+    }
+    const ready = await ensurePayReady(returnPath);
+    if (!ready) return;
+    Taro.navigateTo({ url: returnPath });
+  }
+
   async function goOnSitePickup(productId: string) {
     const returnPath = `/pages/order-confirm-pickup/index?productId=${productId}&qty=2`;
     if (!isLoggedIn()) {
@@ -348,7 +359,7 @@ export default function HomePage() {
                   className="home-buy-btn"
                   onClick={(e) => {
                     e.stopPropagation?.();
-                    openProductDetail(p.id);
+                    void goBuyOnline(p.id);
                   }}
                 >
                   立即购买

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

@@ -15,6 +15,7 @@ import DeliveryHintHtml from '../../components/DeliveryHintHtml';
 import { canCrossCity, isCrossCityAddress } from '../../lib/product-fulfillment';
 import { loadLocalDeliveries, matchLocalDelivery, resolveLocalDeliveryHintHtml } from '../../lib/local-delivery';
 import { getProductMainImage } from '../../lib/product-images';
+import { isDirtyShippingAddress } from '../../lib/shipping-address';
 import BenefitFigure from '../../components/BenefitFigure';
 import OrderQtyControls from '../../components/OrderQtyControls';
 
@@ -177,7 +178,12 @@ export default function OrderConfirmPage() {
   const isCross =
     forceCross || preview?.deliveryType === 'CROSS_CITY' || localCross;
   const crossBlocked = isCross && !allowCross;
-  const addressOk = preview ? preview.addressOk !== false && !crossBlocked : !crossBlocked;
+  const dirtyAddress = !!selectedAddress && isDirtyShippingAddress(selectedAddress);
+  const addressOk = dirtyAddress
+    ? false
+    : preview
+      ? preview.addressOk !== false && !crossBlocked
+      : !crossBlocked;
   const unitLabel = preview?.saleUnit === 'BOX' ? '箱' : '瓶';
   const minQty =
     preview?.minQty ??
@@ -186,9 +192,11 @@ export default function OrderConfirmPage() {
   const canSubmit =
     !!addressId && !!preview && quantityOk && addressOk && !loading && !previewLoading;
 
-  const addressHint = !addressOk
-    ? preview?.addressMessage || CROSS_CITY_BLOCK_MSG
-    : '';
+  const addressHint = dirtyAddress
+    ? '请完善收货地址（需选择具体区县）'
+    : !addressOk
+      ? preview?.addressMessage || CROSS_CITY_BLOCK_MSG
+      : '';
 
   function updateQuantity(next: number) {
     if (next < minQty) {

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

@@ -79,6 +79,12 @@ type Store = {
     parentId?: string | null;
     parent?: { name?: string } | null;
   } | null;
+  categories?: {
+    id?: string;
+    name?: string;
+    parentId?: string | null;
+    parent?: { name?: string } | null;
+  }[] | null;
 };
 
 type RecentRedeem = {
@@ -406,12 +412,15 @@ export default function StoreDetailPage() {
 
         <View className="store-detail-title-row">
           <Text className="store-detail-name">{store.name}</Text>
-          {storeCategoryTags(store, categoryTree).map((tag) => (
-            <Text key={tag} className="store-detail-tag">
-              {tag}
-            </Text>
-          ))}
         </View>
+        {(() => {
+          const categoryLabels = storeCategoryTags(store, categoryTree);
+          return categoryLabels.length ? (
+            <View className="store-detail-tags-row">
+              <Text className="store-detail-category-line">{categoryLabels.join('、')}</Text>
+            </View>
+          ) : null;
+        })()}
         <View className="store-detail-rating-row">
           <View className="store-detail-stars">
             {[1, 2, 3, 4, 5].map((n) => (

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

@@ -42,7 +42,7 @@ import {
   toWeappShareTimeline,
 } from '../../lib/wechat-share';
 import BenefitSloganBar from '../../components/BenefitSloganBar';
-import { storeCategoryTags, storeStarCount } from '../../lib/store-display';
+import { storeCategoryTags, storeLeafCategoryIds, storeStarCount } from '../../lib/store-display';
 import openBadgeImg from '../../assets/icons/store-open-badge.png';
 
 type Store = {
@@ -66,6 +66,12 @@ type Store = {
     parentId?: string | null;
     parent?: { name?: string } | null;
   } | null;
+  categories?: {
+    id?: string;
+    name?: string;
+    parentId?: string | null;
+    parent?: { name?: string } | null;
+  }[] | null;
   tags?: unknown;
   rating?: number | string | null;
   latitude?: number | string | null;
@@ -288,14 +294,21 @@ export default function StoresPage() {
 
   function matchesCategory(store: Store): boolean {
     if (!category.parentId) return true;
-    const storeCatId = String(store.categoryId || store.category?.id || '');
-    const storeParentId = String(store.category?.parentId || '');
-    if (category.childId) {
-      return storeCatId === category.childId;
+    const leafIds = storeLeafCategoryIds(store);
+    const parentIds = new Set<string>();
+    if (Array.isArray(store.categories)) {
+      for (const cat of store.categories) {
+        if (cat.parentId) parentIds.add(String(cat.parentId));
+      }
     }
-    if (storeParentId && storeParentId === category.parentId) return true;
+    const legacyParent = String(store.category?.parentId || '');
+    if (legacyParent) parentIds.add(legacyParent);
+    if (category.childId) {
+      return leafIds.includes(category.childId);
+    }
+    if ([...parentIds].some((id) => id === category.parentId)) return true;
     const siblings = childIdsByParent.get(category.parentId) ?? [];
-    return siblings.includes(storeCatId);
+    return leafIds.some((id) => siblings.includes(id));
   }
 
   const filtered = useMemo(() => {
@@ -461,14 +474,10 @@ export default function StoresPage() {
                   <Text className="store-card-name">{s.name}</Text>
                 </View>
                 {(() => {
-                  const tags = storeCategoryTags(s, categoryTree);
-                  return tags.length ? (
-                    <View className="store-card-tags">
-                      {tags.map((tag) => (
-                        <Text key={tag} className="store-card-tag">
-                          {tag}
-                        </Text>
-                      ))}
+                  const categoryLabels = storeCategoryTags(s, categoryTree);
+                  return categoryLabels.length ? (
+                    <View className="store-card-category-wrap">
+                      <Text className="store-card-category-text">{categoryLabels.join('、')}</Text>
                     </View>
                   ) : null;
                 })()}

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

@@ -38,6 +38,34 @@
   font-size: 11px;
 }
 
+.address-need-fix-tag {
+  margin-left: 8px;
+  padding: 2px 8px;
+  border-radius: 999px;
+  background: rgba(200, 120, 20, 0.12);
+  color: #b36b00;
+  font-size: 11px;
+}
+
+.address-item--dirty {
+  border: 1px solid rgba(200, 120, 20, 0.35);
+}
+
+.address-item-warn {
+  display: block;
+  margin-top: 6px;
+  font-size: 12px;
+  color: #b36b00;
+}
+
+.address-form-hint {
+  display: block;
+  margin: 0 var(--space-page) 8px;
+  font-size: 12px;
+  color: #b36b00;
+  line-height: 1.4;
+}
+
 .address-item-detail {
   display: block;
   font-size: 13px;

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

@@ -191,7 +191,7 @@
 }
 
 .order-qty-unit {
-  margin-right: 8px;
+  margin-left: 8px;
   font-size: 13px;
   font-weight: 600;
   color: var(--color-on-surface);

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

@@ -100,6 +100,12 @@
 }
 
 .store-detail-title-row {
+  display: flex;
+  align-items: center;
+  margin-bottom: 6px;
+}
+
+.store-detail-tags-row {
   display: flex;
   flex-wrap: wrap;
   align-items: center;
@@ -107,6 +113,20 @@
   margin-bottom: 8px;
 }
 
+.store-detail-category-line {
+  display: inline-block;
+  max-width: 100%;
+  padding: 2px 8px;
+  border-radius: 6px;
+  background: rgba(166, 29, 36, 0.1);
+  box-sizing: border-box;
+  font-size: 11px;
+  font-weight: 500;
+  line-height: 16px;
+  color: var(--color-heritage-red);
+  word-break: break-all;
+}
+
 .store-detail-name {
   font-family: var(--font-headline);
   font-size: 20px;

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

@@ -215,13 +215,32 @@
   white-space: nowrap;
 }
 
+.store-card-category-wrap {
+  align-self: flex-start;
+  max-width: 100%;
+  padding: 0 6px;
+  border-radius: 4px;
+  background: rgba(166, 29, 36, 0.1);
+  box-sizing: border-box;
+  line-height: 1;
+}
+
+.store-card-category-text {
+  font-size: 10px;
+  font-weight: 500;
+  line-height: 14px;
+  color: var(--color-heritage-red);
+  word-break: break-all;
+}
+
 .store-card-tags {
   display: flex;
-  flex-wrap: nowrap;
+  flex-wrap: wrap;
   align-items: center;
   gap: 4px;
   min-width: 0;
-  overflow: hidden;
+  margin-top: 2px;
+  margin-bottom: 2px;
 }
 
 .store-card-tag {

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

@@ -7,7 +7,7 @@
 
 | 维度 | 结论 |
 |------|------|
-| 版本线 | **v4.0.9** 合伙人 H5 周结算、预付款、子账号用户管理 |
+| 版本线 | **v4.0.13** 收货地址禁「全市」+ 小飞侠拒单履约可感知 |
 | 订单佣金 | 区县归属已删除；只认关联 / 代下单选择 |
 | 账单 | 酒订单 / 核销订单分列；合伙人改为周账（周一 08:00）；零元不同步合伙人；酒厂含现场提货，零应付仍出账（无需打款） |
 | 活动图 | HQ 上传底图/码栏/文案；合伙人选择写入库；HQ 可指定一张图为勾选主合伙人合成下载；子账号不可看活动图 |
@@ -21,6 +21,7 @@
 | 4.0.6 | [`酒厂对账核对`](./杜康好客-v4.0.6-开发文档.md) | ✅ 已实现 |
 | 4.0.7 | [`活动图快链与勾选导出`](./杜康好客-v4.0.7-开发文档.md) | ✅ 已实现 |
 | 4.0.9 | [`合伙人 H5 周结算与用户管理`](./杜康好客-v4.0.9-开发文档.md) | ✅ 已实现 |
+| 4.0.13 | [`收货地址把关与拒单可感知`](./杜康好客-v4.0.13-开发文档.md) | ✅ 已实现 |
 
 | 日期 | 说明 |
 |------|------|
@@ -31,3 +32,4 @@
 | 2026-08-31 | v4.0.6：酒厂 T+3=每 3 天出一期（非每日）；含现场提货；零应付仍出账；核对补生成 |
 | 2026-09-01 | v4.0.7：HQ 城市合伙人活动图快链；单张/勾选导出合成图（PNG / zip） |
 | 2026-09-02 | v4.0.9：子账号默认启用；关联码已扫码；零元账单不同步；银行账号自填；周账周一 08:00；预付款预估；子账号用户管理无活动图 |
+| 2026-09-02 | v4.0.13：收货禁「全市」；脏地址下单拦截；小飞侠超区/推单失败挂 `fulfillmentHold`（不做仓/收件坐标） |

docs/杜康好客-v4.0.13-开发文档.md

@@ -0,0 +1,93 @@
+# 杜康好客 · v4.0.13 开发文档
+
+> **2026-09-02** · mini-user / iam / trade / fulfillment / admin-web / h5-partner / domain  
+> **主题**：收货地址严格把关（禁「全市」）+ 小飞侠拒单履约可感知
+
+需求背景：订单 `DK2026090220803` 自动推小飞侠失败，原因 `超出服务区`；收货区县为门店筛选用伪值「全市」。
+
+**不做（本版明确排除）**：仓坐标补全、收件 `chooseLocation` / `toCoordinate` 坐标链路。
+
+---
+
+## 1. 版本目标
+
+| # | 任务 | 类型 | 交付 |
+|---|------|------|------|
+| 1 | 收货选区与门店筛选语义拆分 | 缺陷/体验 | `RegionPicker mode=shipping` 无「全市」 |
+| 2 | 地址保存硬闸 | 缺陷 | 前后端拒伪区县；详细地址最短 8 字 |
+| 3 | 下单/预览拦截脏地址 | 缺陷 | preview `addressOk=false`；确认页不可提交 |
+| 4 | 地址簿存量提示 | 体验 | 「需完善」置顶；结账选址强制去编辑 |
+| 5 | 推单失败可感知 | 缺陷 | `fulfillmentHold` + 原因码；HQ 标签/发货弹窗 |
+
+---
+
+## 2. 规则
+
+### 2.1 收货地址
+
+- 伪区县：`全市`、`全部`、空 —— **禁止**写入 `user_address` / 下单快照 / 合伙人代下单。
+- 详细地址：必填且长度 ≥ 8；含「全市」且无街道路牌关键词时前端软提示（不单独硬失败）。
+- 门店列表筛选仍可使用「全市」（`mode=filter`）。
+- 现场取货地址快照（`现场/现场/取货`）不走本校验。
+
+### 2.2 履约拦截（推单失败）
+
+| `fulfillment_hold_reason` | 含义 | HQ 展示 |
+|---------------------------|------|---------|
+| `LARGE_ORDER_GE_10_BOXES` | 大单≥10箱 | 大单 |
+| `COURIER_OUT_OF_SERVICE` | 小飞侠返回超出服务区 | 超区 |
+| `COURIER_DISPATCH_FAILED` | 其它自动推单失败 | 推单失败 |
+
+- 失败后仍写 `MANUAL` 配送记录（待发货），**同时**挂 `fulfillmentHold`，避免静默像「没推过」。
+- HQ 手动推小飞侠或填快递成功后仍清 hold（既有逻辑）。
+
+---
+
+## 3. 变更面
+
+| 层 | 路径 |
+|----|------|
+| domain | `packages/domain/src/shipping-address.ts` |
+| shared-types | `FULFILLMENT_HOLD_REASON_LABELS` + 常量 |
+| API | `UserAddressService`；`TradeService` preview/create/代下单；`FulfillmentService.markCourierDispatchHold` |
+| C 端 | `RegionPicker`、`address-edit`、`addresses`、`order-confirm`、`shipping-address.ts` |
+| 合伙人 | `ProxyOrderPage` 校验 |
+| HQ | `OrdersPage` 拦截筛选文案与标签 |
+
+---
+
+## 4. API 行为变化
+
+| 接口 | 变化 |
+|------|------|
+| `POST/PUT /user/addresses` | 伪区县 / 详情过短 → `400` |
+| `POST /trade/orders/preview` | 脏地址 → `addressOk=false` + message |
+| `POST /trade/orders` | 脏地址 → `400` |
+| 合伙人代下单 | 同上校验 |
+| 支付后自动推单 | 失败写 hold reason（库字段，无新 path） |
+
+---
+
+## 5. 验收
+
+- [ ] 新增/编辑地址：区县列表无「全市」；选真实区县 + 足够详细地址可保存
+- [ ] 保存「全市」或过短详情被拒（前端 toast + 后端 400）
+- [ ] 历史脏地址在地址簿标「需完善」；结账选择时跳转编辑
+- [ ] 确认订单页脏地址不可提交；preview 提示完善区县
+- [ ] 合伙人代下单伪区县/过短详情被拒
+- [ ] 模拟小飞侠「超出服务区」后：订单 `fulfillment_hold=1`、`reason=COURIER_OUT_OF_SERVICE`；HQ 列表「超区」、发货弹窗有说明
+- [ ] 门店列表筛选「全市」行为不变
+
+---
+
+## 6. 存量建议（运维，非代码）
+
+```sql
+-- 生产排查脏地址（只读）
+SELECT id, user_id, province, city, district, detail, updated_at
+FROM user_address
+WHERE district IN ('全市','全部','') OR district IS NULL
+ORDER BY id DESC LIMIT 100;
+```
+
+可选：运营通知用户进「地址管理」完善；本版不自动改写历史行。

packages/domain/src/index.ts

@@ -410,3 +410,4 @@ export * from './dev-plan';
 export * from './support-ticket';
 export * from './phone';
 export * from './shanghai-date';
+export * from './shipping-address';

packages/domain/src/shipping-address.test.ts

@@ -0,0 +1,50 @@
+import { describe, expect, it } from 'vitest';
+import {
+  isConcreteShippingDistrict,
+  isPseudoShippingDistrict,
+  shippingDetailCityWideHint,
+  validateShippingAddress,
+} from './shipping-address';
+
+describe('shipping address', () => {
+  it('rejects pseudo districts', () => {
+    expect(isPseudoShippingDistrict('全市')).toBe(true);
+    expect(isPseudoShippingDistrict('全部')).toBe(true);
+    expect(isPseudoShippingDistrict('')).toBe(true);
+    expect(isConcreteShippingDistrict('金水区')).toBe(true);
+  });
+
+  it('requires concrete district and detail length', () => {
+    expect(
+      validateShippingAddress({
+        province: '河南省',
+        city: '郑州市',
+        district: '全市',
+        detail: '上馆子信阳菜尚购生活广场店',
+      }).ok,
+    ).toBe(false);
+
+    expect(
+      validateShippingAddress({
+        province: '河南省',
+        city: '郑州市',
+        district: '金水区',
+        detail: '短',
+      }).message,
+    ).toMatch(/详细/);
+
+    expect(
+      validateShippingAddress({
+        province: '河南省',
+        city: '郑州市',
+        district: '金水区',
+        detail: '沙口路8号院尚购生活广场',
+      }).ok,
+    ).toBe(true);
+  });
+
+  it('soft-hints bare 全市 in detail', () => {
+    expect(shippingDetailCityWideHint('河南省郑州市全市上馆子')).toBeTruthy();
+    expect(shippingDetailCityWideHint('金水区沙口路8号')).toBeNull();
+  });
+});

packages/domain/src/shipping-address.ts

@@ -0,0 +1,75 @@
+/** 门店筛选用伪区县，禁止写入收货地址 */
+export const PSEUDO_SHIPPING_DISTRICTS = ['全市', '全部'] as const;
+
+export const SHIPPING_DETAIL_MIN_LEN = 8;
+
+export const SHIPPING_REGION_REQUIRED_MSG = '请选择具体区县';
+export const SHIPPING_DETAIL_REQUIRED_MSG = '请填写详细地址';
+export const SHIPPING_DETAIL_TOO_SHORT_MSG = '请填写更详细的收货地址（含街道门牌）';
+
+export type ShippingAddressFields = {
+  province?: string | null;
+  city?: string | null;
+  district?: string | null;
+  detail?: string | null;
+};
+
+export type ShippingAddressValidation = {
+  ok: boolean;
+  message?: string;
+};
+
+function trim(v: string | null | undefined): string {
+  return String(v ?? '').trim();
+}
+
+export function isPseudoShippingDistrict(district: string | null | undefined): boolean {
+  const d = trim(district);
+  if (!d) return true;
+  return (PSEUDO_SHIPPING_DISTRICTS as readonly string[]).includes(d);
+}
+
+/** 区县是否可作为收货地址（非空且非全市/全部） */
+export function isConcreteShippingDistrict(district: string | null | undefined): boolean {
+  return !isPseudoShippingDistrict(district);
+}
+
+/**
+ * 校验收货省市区 + 详细地址。
+ * - 现场取货等特殊值请勿调用本函数
+ * - 不依赖完整省市区树；前端另做树内白名单
+ */
+export function validateShippingAddress(
+  input: ShippingAddressFields,
+  options?: { requireDetail?: boolean },
+): ShippingAddressValidation {
+  const province = trim(input.province);
+  const city = trim(input.city);
+  const district = trim(input.district);
+  const detail = trim(input.detail);
+  const requireDetail = options?.requireDetail !== false;
+
+  if (!province || !city) {
+    return { ok: false, message: '请选择所在地区' };
+  }
+  if (!isConcreteShippingDistrict(district)) {
+    return { ok: false, message: SHIPPING_REGION_REQUIRED_MSG };
+  }
+  if (requireDetail) {
+    if (!detail) {
+      return { ok: false, message: SHIPPING_DETAIL_REQUIRED_MSG };
+    }
+    if (detail.length < SHIPPING_DETAIL_MIN_LEN) {
+      return { ok: false, message: SHIPPING_DETAIL_TOO_SHORT_MSG };
+    }
+  }
+  return { ok: true };
+}
+
+/** 详细地址含「全市」时的软提示（不单独作为硬失败条件） */
+export function shippingDetailCityWideHint(detail: string | null | undefined): string | null {
+  const d = trim(detail);
+  if (!d.includes('全市')) return null;
+  if (/路|街|巷|号|大厦|广场|小区|村|镇|乡/.test(d)) return null;
+  return '详细地址含「全市」，建议改为具体街道门牌，以免配送拒单';
+}

packages/shared-types/src/fulfillment-provider.ts

@@ -41,6 +41,7 @@ export interface FulfillmentProviderDto {
   capabilities?: {
     createShipment?: boolean;
     getTrack?: boolean;
+    getSignPhotos?: boolean;
     callback?: boolean;
     cancel?: boolean;
   } | null;

packages/shared-types/src/hq-permissions.ts

@@ -149,6 +149,7 @@ export const HQ_ADMIN_ROLE_VALUES = [
   'FINANCE',
   'CUSTOMER_SERVICE',
   'CITY_STORE_SERVICE',
+  'DEVELOPER',
 ] as const;
 
 export type HqAdminRoleValue = (typeof HQ_ADMIN_ROLE_VALUES)[number];
@@ -159,6 +160,7 @@ export const HQ_ADMIN_ROLES: { value: HqAdminRoleValue; label: string }[] = [
   { value: 'FINANCE', label: '财务' },
   { value: 'CUSTOMER_SERVICE', label: '客服' },
   { value: 'CITY_STORE_SERVICE', label: '城市门店服务' },
+  { value: 'DEVELOPER', label: '开发者' },
 ];
 
 const OPS_STORE_KEYS: HqPermissionKey[] = [
@@ -170,6 +172,13 @@ const OPS_STORE_KEYS: HqPermissionKey[] = [
   'store_media',
 ];
 
+/** 开发者默认：除权限分配、HQ 账户外全部权限 */
+function developerDefaultPermissions(): HqPermissionKey[] {
+  return HQ_PERMISSION_CATALOG.map((p) => p.key).filter(
+    (k) => k !== 'hq_permissions' && k !== 'hq_accounts',
+  );
+}
+
 export const HQ_ROLE_DEFAULT_PERMISSIONS: Record<HqAdminRoleValue, HqPermissionKey[]> = {
   SUPER_ADMIN: [...hqBasePermissionKeys(), ...HQ_DEBUG_PERMISSION_KEYS],
   OPS: [
@@ -228,4 +237,5 @@ export const HQ_ROLE_DEFAULT_PERMISSIONS: Record<HqAdminRoleValue, HqPermissionK
     'store_ratings',
     'store_categories',
   ],
+  DEVELOPER: developerDefaultPermissions(),
 };

packages/shared-types/src/ops.ts

@@ -34,6 +34,14 @@ export interface UpdateAdminUserRequest {
   hqRemark: string;
 }
 
+/** HQ 当前账号修改登录名 / 密码（自助） */
+export interface UpdateMyHqCredentialsRequest {
+  loginName?: string;
+  /** 修改密码时必填（账号尚未设置密码时可省略） */
+  oldPassword?: string;
+  newPassword?: string;
+}
+
 export interface AdminPageResult<T> {
   items: T[];
   total: number;

packages/shared-types/src/settlement.ts

@@ -139,6 +139,8 @@ export interface PartnerBillDto {
   redeemCommission: number;
   totalAmount: number;
   status: PartnerBillStatus;
+  /** 出账日 YYYY-MM-DD（周账=账期结束后下周一；历史月账=次月 1 日） */
+  billDate: string;
   periodStart: string;
   periodEnd: string;
   confirmedAt?: string | null;
@@ -187,6 +189,10 @@ export interface StoreBillDto {
   storeId: string;
   /** 出账日 YYYY-MM-DD（T+1 窗口「昨日 00:00–今日 00:00」中的今天） */
   billDate: string;
+  /** 账期起 YYYY-MM-DD（含；T+1 = 出账日前一日） */
+  periodStart: string;
+  /** 账期止 YYYY-MM-DD（含；T+1 = 出账日前一日） */
+  periodEnd: string;
   redeemCount: number;
   redeemAmount: number;
   settlementRate: number;
@@ -202,6 +208,10 @@ export interface WineryBillDto {
   billNo: string;
   /** 出账日 YYYY-MM-DD（北京时间；T+3 = 每 3 天一期，纳入上期 3 天完成订单） */
   billDate: string;
+  /** 账期起 YYYY-MM-DD（含） */
+  periodStart: string;
+  /** 账期止 YYYY-MM-DD（含） */
+  periodEnd: string;
   orderCount: number;
   orderAmount: number;
   wineryRate: number;

packages/shared-types/src/trade.ts

@@ -99,11 +99,16 @@ export interface OrderTrackDto {
   queryError?: string | null;
 }
 
-/** 大单拦截原因：≥10 箱不自动推小飞侠 */
+/** 履约拦截原因（大单 / 承运商拒单等） */
 export const FULFILLMENT_HOLD_REASON_LABELS: Record<string, string> = {
   LARGE_ORDER_GE_10_BOXES: '大单≥10箱，待总部确认推单/自配送',
+  COURIER_OUT_OF_SERVICE: '小飞侠超出服务区，待改址后重推或自配送',
+  COURIER_DISPATCH_FAILED: '自动推配送失败，待总部确认重推或自配送',
 };
 
+export const FULFILLMENT_HOLD_COURIER_OUT_OF_SERVICE = 'COURIER_OUT_OF_SERVICE';
+export const FULFILLMENT_HOLD_COURIER_DISPATCH_FAILED = 'COURIER_DISPATCH_FAILED';
+
 export type PartnerProxyDeliveryMode = 'ADDRESS' | 'ON_SITE_PICKUP';
 
 export type PartnerProxyOrderProductOption = {

server/dukang-api/prisma/migrate-hq-role-developer-v4011.sql

@@ -0,0 +1,23 @@
+-- v4.0.11: HQ 角色新增「开发者」(DEVELOPER)
+-- 默认权限见 packages/shared-types HQ_ROLE_DEFAULT_PERMISSIONS.DEVELOPER
+-- （除 hq_permissions / hq_accounts 外全部；未写入 hq_role_permission 时走代码默认）
+
+ALTER TABLE `hq_account`
+  MODIFY COLUMN `admin_role` ENUM(
+    'SUPER_ADMIN',
+    'OPS',
+    'FINANCE',
+    'CUSTOMER_SERVICE',
+    'CITY_STORE_SERVICE',
+    'DEVELOPER'
+  ) NOT NULL DEFAULT 'OPS';
+
+ALTER TABLE `hq_role_permission`
+  MODIFY COLUMN `admin_role` ENUM(
+    'SUPER_ADMIN',
+    'OPS',
+    'FINANCE',
+    'CUSTOMER_SERVICE',
+    'CITY_STORE_SERVICE',
+    'DEVELOPER'
+  ) NOT NULL;

server/dukang-api/prisma/migrate-store-category-link.sql

@@ -0,0 +1,21 @@
+-- 门店多分类关联表（v4.0.9+）
+-- 执行：mysql ... < migrate-store-category-link.sql
+
+CREATE TABLE IF NOT EXISTS store_category_link (
+  id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
+  store_id BIGINT UNSIGNED NOT NULL,
+  category_id BIGINT UNSIGNED NOT NULL,
+  priority INT NOT NULL DEFAULT 0,
+  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
+  PRIMARY KEY (id),
+  UNIQUE KEY uk_store_category_link (store_id, category_id),
+  KEY idx_store_category_link_category (category_id),
+  CONSTRAINT fk_store_category_link_store FOREIGN KEY (store_id) REFERENCES store_store(id) ON DELETE CASCADE,
+  CONSTRAINT fk_store_category_link_category FOREIGN KEY (category_id) REFERENCES common_store_category(id) ON DELETE CASCADE
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
+
+-- 从现有主分类回填
+INSERT IGNORE INTO store_category_link (store_id, category_id, priority)
+SELECT id, category_id, 0
+FROM store_store
+WHERE category_id IS NOT NULL;

server/dukang-api/prisma/schema.prisma

@@ -268,6 +268,7 @@ enum HqAdminRole {
   FINANCE
   CUSTOMER_SERVICE
   CITY_STORE_SERVICE
+  DEVELOPER
 }
 
 enum HqPermissionEffect {
@@ -1000,12 +1001,29 @@ model CommonStoreCategory {
   parent   CommonStoreCategory?  @relation("StoreCategoryTree", fields: [parentId], references: [id], onDelete: Restrict)
   children CommonStoreCategory[] @relation("StoreCategoryTree")
   stores   Store[]
+  storeLinks StoreCategoryLink[]
 
   @@index([parentId, sort])
   @@index([status])
   @@map("common_store_category")
 }
 
+/// 门店 ↔ 二级分类多对多；store.category_id 保留主分类（排序第一）
+model StoreCategoryLink {
+  id         BigInt   @id @default(autoincrement()) @db.UnsignedBigInt
+  storeId    BigInt   @map("store_id") @db.UnsignedBigInt
+  categoryId BigInt   @map("category_id") @db.UnsignedBigInt
+  priority   Int      @default(0)
+  createdAt  DateTime @default(now()) @map("created_at") @db.DateTime(3)
+
+  store    Store               @relation(fields: [storeId], references: [id], onDelete: Cascade)
+  category CommonStoreCategory @relation(fields: [categoryId], references: [id], onDelete: Cascade)
+
+  @@unique([storeId, categoryId])
+  @@index([categoryId])
+  @@map("store_category_link")
+}
+
 model CommonPromoCode {
   id               BigInt          @id @default(autoincrement()) @db.UnsignedBigInt
   code             String          @unique @db.VarChar(32)
@@ -1542,6 +1560,7 @@ model Store {
   packages             StorePackage[]
   packageChangeRequests StorePackageChangeRequest[]
   infoChangeRequests    StoreInfoChangeRequest[]
+  categoryLinks        StoreCategoryLink[]
 
   @@index([cityId, status])
   @@index([partnerAccountId])

server/dukang-api/src/common/export/column-export.util.ts

@@ -0,0 +1,48 @@
+export type ExportColumnDef<T> = {
+  key: string;
+  header: string;
+  value: (row: T) => string | number;
+};
+
+/** 按请求的列 key 过滤导出列；未传则导出全部 */
+export function pickExportColumns<T>(
+  defs: ExportColumnDef<T>[],
+  requestedKeys?: string[],
+): ExportColumnDef<T>[] {
+  if (!requestedKeys?.length) return defs;
+  const byKey = new Map(defs.map((d) => [d.key, d]));
+  return requestedKeys.map((k) => byKey.get(k)).filter((d): d is ExportColumnDef<T> => !!d);
+}
+
+export function parseExportColumnKeys(raw?: string): string[] | undefined {
+  if (!raw?.trim()) return undefined;
+  const keys = raw
+    .split(',')
+    .map((k) => k.trim())
+    .filter(Boolean);
+  return keys.length ? keys : undefined;
+}
+
+export function buildCsvFromColumns<T>(
+  defs: ExportColumnDef<T>[],
+  rows: T[],
+  requestedKeys?: string[],
+): { csv: string; count: number } {
+  const active = pickExportColumns(defs, requestedKeys);
+  if (!active.length) {
+    return { csv: '\uFEFF', count: 0 };
+  }
+  const header = active.map((d) => d.header).join(',');
+  const body = rows.map((row) =>
+    active
+      .map((d) => {
+        const v = d.value(row);
+        const s = v == null ? '' : String(v);
+        return s.includes(',') || s.includes('"') || s.includes('\n')
+          ? `"${s.replace(/"/g, '""')}"`
+          : s;
+      })
+      .join(','),
+  );
+  return { csv: `\uFEFF${[header, ...body].join('\n')}`, count: rows.length };
+}

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

@@ -47,13 +47,27 @@ export function sceneForXfxCmd(cmd: string) {
   return CMD_SCENE[cmd] ?? `XFX_CMD_${cmd}`;
 }
 
+/** 签收照等大字段入库前截断，避免撑爆 JSON / 影响后续业务返回 */
+function sanitizeCourierResponseBody(scene: string, body: unknown): Record<string, unknown> | undefined {
+  if (body === undefined) return undefined;
+  if (typeof body !== 'object' || body === null) {
+    return { value: body };
+  }
+  const root = { ...(body as Record<string, unknown>) };
+  if (scene === 'GET_SIGN_PHOTOS' && Array.isArray(root.data)) {
+    const photos = root.data as unknown[];
+    root.data = photos.map((item) => {
+      if (typeof item !== 'string') return item;
+      if (item.length <= 120) return item;
+      return `${item.slice(0, 80)}…(len=${item.length})`;
+    });
+    root.dataCount = photos.length;
+  }
+  return root;
+}
+
 export async function logCourierCall(prisma: PrismaService, input: LogCourierCallInput) {
-  const responseBody =
-    input.responseBody === undefined
-      ? undefined
-      : typeof input.responseBody === 'object' && input.responseBody !== null
-        ? (input.responseBody as Record<string, unknown>)
-        : { value: input.responseBody };
+  const responseBody = sanitizeCourierResponseBody(input.scene, input.responseBody);
 
   const row = await prisma.logThirdParty.create({
     data: {

server/dukang-api/src/modules/dev-plan/admin-dev-plan-export.util.ts

@@ -1,3 +1,7 @@
+import {
+  pickExportColumns,
+  type ExportColumnDef,
+} from '../../common/export/column-export.util';
 import {
   DEV_PLAN_TASK_STATUS_LABELS,
   DEV_PLAN_TASK_TYPE_LABELS,
@@ -27,6 +31,7 @@ const EXPORT_HEADERS = [
   '状态',
   '内容',
   '关联工单',
+  '关联版本',
   '创建人',
   '创建时间',
   '完成时间',
@@ -39,6 +44,7 @@ export type DevPlanTaskExportRow = {
   status: string;
   content: string;
   supportTicketNo: string;
+  versionNos: string;
   creatorName: string;
   createdAt: string;
   completedAt: string;
@@ -53,6 +59,7 @@ export function mapTaskToExportRow(task: {
   status: DevPlanTaskStatusDto;
   content: string;
   supportTicketNo?: string | null;
+  versionNos?: string | null;
   creatorName?: string | null;
   createdAt: string;
   completedAt?: string | null;
@@ -64,6 +71,7 @@ export function mapTaskToExportRow(task: {
     status: DEV_PLAN_TASK_STATUS_LABELS[task.status] ?? task.status,
     content: task.content,
     supportTicketNo: task.supportTicketNo ?? '',
+    versionNos: task.versionNos ?? '',
     creatorName: task.creatorName ?? '',
     createdAt: task.createdAt.slice(0, 19).replace('T', ' '),
     completedAt: task.completedAt ? task.completedAt.slice(0, 19).replace('T', ' ') : '',
@@ -71,20 +79,30 @@ export function mapTaskToExportRow(task: {
   };
 }
 
-function rowToCells(row: DevPlanTaskExportRow): string[] {
+function devPlanExportColumnDefs(): ExportColumnDef<DevPlanTaskExportRow>[] {
   return [
-    row.taskNo,
-    row.type,
-    row.status,
-    row.content,
-    row.supportTicketNo,
-    row.creatorName,
-    row.createdAt,
-    row.completedAt,
-    row.attachmentUrls.join(' '),
+    { key: 'taskNo', header: '任务编号', value: (r) => r.taskNo },
+    { key: 'type', header: '类型', value: (r) => r.type },
+    { key: 'status', header: '状态', value: (r) => r.status },
+    { key: 'content', header: '内容', value: (r) => r.content },
+    { key: 'supportTicketNo', header: '关联工单', value: (r) => r.supportTicketNo },
+    { key: 'versions', header: '关联版本', value: (r) => r.versionNos },
+    { key: 'creatorName', header: '创建人', value: (r) => r.creatorName },
+    { key: 'createdAt', header: '创建时间', value: (r) => r.createdAt },
+    { key: 'completedAt', header: '完成时间', value: (r) => r.completedAt },
+    {
+      key: 'attachmentUrls',
+      header: '附件',
+      value: (r) => r.attachmentUrls.join(' '),
+    },
   ];
 }
 
+function rowToCells(row: DevPlanTaskExportRow, columnKeys?: string[]): string[] {
+  const cols = pickExportColumns(devPlanExportColumnDefs(), columnKeys);
+  return cols.map((c) => String(c.value(row)));
+}
+
 function resolvePdfFontPath(): string {
   const candidates = [
     process.env.EXPORT_PDF_FONT_PATH,
@@ -187,15 +205,17 @@ export async function buildDevPlanDocx(rows: DevPlanTaskExportRow[]): Promise<Bu
   return Packer.toBuffer(doc);
 }
 
-export async function buildDevPlanXlsx(rows: DevPlanTaskExportRow[]): Promise<Buffer> {
+export async function buildDevPlanXlsx(rows: DevPlanTaskExportRow[], columnKeys?: string[]): Promise<Buffer> {
+  const cols = pickExportColumns(devPlanExportColumnDefs(), columnKeys);
   const workbook = new ExcelJS.Workbook();
   const sheet = workbook.addWorksheet('开发任务');
-  sheet.addRow([...EXPORT_HEADERS]);
+  sheet.addRow(cols.map((c) => c.header));
   for (const row of rows) {
-    sheet.addRow(rowToCells(row));
+    sheet.addRow(cols.map((c) => c.value(row)));
   }
   sheet.columns.forEach((col, i) => {
-    col.width = i === 3 || i === 8 ? 40 : 16;
+    const header = cols[i]?.header ?? '';
+    col.width = header === '内容' || header === '附件' ? 40 : 16;
   });
   const buffer = await workbook.xlsx.writeBuffer();
   return Buffer.from(buffer);

server/dukang-api/src/modules/dev-plan/admin-dev-plan.controller.ts

@@ -107,11 +107,13 @@ export class AdminDevPlanController {
   @Get('versions')
   listVersions(
     @Query('status') status?: string,
+    @Query('keyword') keyword?: string,
     @Query('page') page?: string,
     @Query('pageSize') pageSize?: string,
   ) {
     return this.service.listVersions({
       status,
+      keyword,
       page: page ? Number(page) : undefined,
       pageSize: pageSize ? Number(pageSize) : undefined,
     });

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

@@ -590,7 +590,7 @@ export class DevPlanService {
 
 
 
-  async listVersions(query: { status?: string; page?: number; pageSize?: number }) {
+  async listVersions(query: { status?: string; keyword?: string; page?: number; pageSize?: number }) {
 
     const page = query.page ?? 1;
 
@@ -600,7 +600,13 @@ export class DevPlanService {
 
     if (query.status) where.status = query.status as DevPlanVersionStatus;
 
-
+    if (query.keyword?.trim()) {
+      const kw = query.keyword.trim();
+      where.OR = [
+        { versionNo: { contains: kw } },
+        { content: { contains: kw } },
+      ];
+    }
 
     const [rows, total] = await Promise.all([
 
@@ -1329,6 +1335,7 @@ export class DevPlanService {
     status?: string;
     type?: string;
     keyword?: string;
+    columns?: string[];
   }) {
     let rows: Array<{
       id: bigint;
@@ -1372,20 +1379,24 @@ export class DevPlanService {
         : Promise.resolve([]),
     ]);
     const ticketMap = new Map(tickets.map((t) => [String(t.id), t.ticketNo] as [string, string]));
+    const taskIds = rows.map((r) => r.id);
+    const versionMap = await this.loadTaskVersionMap(taskIds);
 
-    const exportRows = rows.map((r) =>
-      mapTaskToExportRow({
+    const exportRows = rows.map((r) => {
+      const versions = versionMap.get(String(r.id)) ?? [];
+      return mapTaskToExportRow({
         taskNo: r.taskNo,
         type: r.type,
         status: r.status,
         content: r.content,
         supportTicketNo: r.supportTicketId != null ? ticketMap.get(String(r.supportTicketId)) ?? null : null,
+        versionNos: versions.map((v) => v.versionNo).join('、') || null,
         creatorName: names.get(String(r.creatorHqAccountId)) ?? null,
         createdAt: r.createdAt.toISOString(),
         completedAt: r.completedAt?.toISOString() ?? null,
         attachmentUrls: parseAttachmentUrls(r.attachmentUrls),
-      }),
-    );
+      });
+    });
 
     let buffer: Buffer;
     switch (dto.format) {
@@ -1396,7 +1407,7 @@ export class DevPlanService {
         buffer = await buildDevPlanDocx(exportRows);
         break;
       case 'xlsx':
-        buffer = await buildDevPlanXlsx(exportRows);
+        buffer = await buildDevPlanXlsx(exportRows, dto.columns);
         break;
       case 'pdf':
         buffer = await buildDevPlanPdf(exportRows);

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

@@ -221,6 +221,11 @@ export class DevPlanTaskExportDto {
   @IsOptional()
   @IsString()
   keyword?: string;
+
+  @IsOptional()
+  @IsArray()
+  @IsString({ each: true })
+  columns?: string[];
 }
 
 export class BatchReviewPreviewDto {

server/dukang-api/src/modules/fulfillment/fulfillment-provider.service.ts

@@ -140,6 +140,7 @@ export class FulfillmentProviderService {
             ? JSON.stringify({
                 createShipment: true,
                 getTrack: true,
+                getSignPhotos: true,
                 callback: true,
                 cancel: true,
               })

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

@@ -1,6 +1,10 @@
 import { BadRequestException, Injectable, Logger, NotFoundException, Inject, forwardRef } from '@nestjs/common';
 import type { CityWarehouse, FulfillmentProvider, Order } from '@prisma/client';
-import { isXfxProviderCode } from '@dukang/shared-types';
+import {
+  FULFILLMENT_HOLD_COURIER_DISPATCH_FAILED,
+  FULFILLMENT_HOLD_COURIER_OUT_OF_SERVICE,
+  isXfxProviderCode,
+} from '@dukang/shared-types';
 import {
   BOTTLES_PER_BOX,
   XFX_AUTO_DISPATCH_MAX_BOXES,
@@ -29,6 +33,7 @@ export type ManualShipInput = {
 export type HqLogisticsShipInput = ManualShipInput;
 
 export const FULFILLMENT_HOLD_LARGE_ORDER = 'LARGE_ORDER_GE_10_BOXES';
+export { FULFILLMENT_HOLD_COURIER_OUT_OF_SERVICE, FULFILLMENT_HOLD_COURIER_DISPATCH_FAILED };
 
 @Injectable()
 export class FulfillmentService {
@@ -138,6 +143,7 @@ export class FulfillmentService {
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       await this.logDispatchFailure(order, provider, message);
+      await this.markCourierDispatchHold(order.id, message);
       await this.ensureDeliveryRecord(order.id, 'MANUAL', provider.id);
       return;
     }
@@ -213,6 +219,7 @@ export class FulfillmentService {
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       await this.logDispatchFailure(order, provider, message);
+      await this.markCourierDispatchHold(order.id, message);
       await this.ensureDeliveryRecord(order.id, 'MANUAL', provider.id);
     }
   }
@@ -306,8 +313,9 @@ export class FulfillmentService {
           trackingNumber: order.delivery.trackingNo ?? undefined,
           outNumber: order.orderNo,
         };
+        const cachedSignPhotoUrl = order.delivery.signPhotoResource?.url ?? null;
 
-        const [trackResult, signPhotoDataUris] = await Promise.all([
+        const [trackResult, signPhotoResult] = await Promise.all([
           this.courier
             .getTrack(shipmentQuery, options)
             .then((nodes) => ({ nodes: Array.isArray(nodes) ? nodes : [], error: null as string | null }))
@@ -315,12 +323,30 @@ export class FulfillmentService {
               nodes: [] as TrackNode[],
               error: err instanceof Error ? err.message : '查询路由失败',
             })),
-          this.courier.getSignPhotos(shipmentQuery, options).catch(() => [] as string[]),
+          cachedSignPhotoUrl
+            ? Promise.resolve({ dataUris: [] as string[], error: null as string | null })
+            : this.courier
+                .getSignPhotos(shipmentQuery, options)
+                .then((dataUris) => ({
+                  dataUris: Array.isArray(dataUris) ? dataUris : [],
+                  error: null as string | null,
+                }))
+                .catch((err: unknown) => ({
+                  dataUris: [] as string[],
+                  error: err instanceof Error ? err.message : '查询签收照片失败',
+                })),
         ]);
 
         base.nodes = this.sortTrackNodesOldestFirst(trackResult.nodes);
         base.queryError = trackResult.error;
-        base.signPhotoUrls = await this.resolveSignPhotoUrls(order, signPhotoDataUris);
+        if (cachedSignPhotoUrl) {
+          base.signPhotoUrls = [cachedSignPhotoUrl];
+        } else {
+          base.signPhotoUrls = await this.resolveSignPhotoUrls(order, signPhotoResult.dataUris);
+          if (base.signPhotoUrls.length === 0 && signPhotoResult.error && !base.queryError) {
+            base.queryError = signPhotoResult.error;
+          }
+        }
 
         if (this.shouldFetchEstimatedArrival(order.status, base.nodes)) {
           const toAddress = this.buildReceiverAddress(order);
@@ -424,43 +450,62 @@ export class FulfillmentService {
     },
     dataUris: string[],
   ): Promise<string[]> {
-    if (!order.delivery || dataUris.length === 0) {
-      return order.delivery?.signPhotoResource?.url ? [order.delivery.signPhotoResource.url] : [];
+    if (!order.delivery) return [];
+    if (order.delivery.signPhotoResource?.url) {
+      return [order.delivery.signPhotoResource.url];
     }
+    if (dataUris.length === 0) return [];
 
     const urls: string[] = [];
     let firstResourceId: bigint | null = order.delivery.signPhotoResourceId;
 
     for (let i = 0; i < dataUris.length; i += 1) {
-      const parsed = this.parseDataUri(dataUris[i]);
+      const raw = dataUris[i];
+      const parsed = this.parseDataUri(raw);
       if (!parsed) continue;
 
-      const result = await this.oss.putObject({
-        bizType: 'SIGN_PHOTO',
-        mediaType: 'IMAGE',
-        fileName: `sign-${order.id}-${i + 1}.${parsed.ext}`,
-        buffer: parsed.buffer,
-        mimeType: parsed.mimeType,
-      });
-      urls.push(result.url);
-
-      if (!firstResourceId) {
-        const resource = await this.prisma.commonResource.create({
-          data: {
-            ownerType: 'ORDER',
-            ownerId: order.id,
-            bizType: 'SIGN_PHOTO',
-            mediaType: 'IMAGE',
-            ossBucket: result.bucket,
-            ossKey: result.ossKey,
-            url: result.url,
-            fileName: `sign-${order.id}-${i + 1}.${parsed.ext}`,
-            fileSize: BigInt(parsed.buffer.length),
-            mimeType: parsed.mimeType,
-            status: 'ACTIVE',
-          },
+      try {
+        if (!this.oss.isEnabled()) {
+          throw new Error('OSS 未配置');
+        }
+        const result = await this.oss.putObject({
+          bizType: 'SIGN_PHOTO',
+          mediaType: 'IMAGE',
+          fileName: `sign-${order.id}-${i + 1}.${parsed.ext}`,
+          buffer: parsed.buffer,
+          mimeType: parsed.mimeType,
         });
-        firstResourceId = resource.id;
+        urls.push(result.url);
+
+        if (!firstResourceId) {
+          const resource = await this.prisma.commonResource.create({
+            data: {
+              ownerType: 'ORDER',
+              ownerId: order.id,
+              bizType: 'SIGN_PHOTO',
+              mediaType: 'IMAGE',
+              ossBucket: result.bucket,
+              ossKey: result.ossKey,
+              url: result.url,
+              fileName: `sign-${order.id}-${i + 1}.${parsed.ext}`,
+              fileSize: BigInt(parsed.buffer.length),
+              mimeType: parsed.mimeType,
+              status: 'ACTIVE',
+            },
+          });
+          firstResourceId = resource.id;
+        }
+      } catch (err) {
+        // OSS 失败不丢图：回退 data URI，保证 C 端 / HQ 仍可预览
+        this.logger.warn(
+          `签收照上传 OSS 失败，回退 dataURI：orderId=${order.id} err=${
+            err instanceof Error ? err.message : String(err)
+          }`,
+        );
+        const dataUri = raw.startsWith('data:')
+          ? raw
+          : `data:${parsed.mimeType};base64,${parsed.buffer.toString('base64')}`;
+        urls.push(dataUri);
       }
     }
 
@@ -559,6 +604,22 @@ export class FulfillmentService {
     });
   }
 
+  /** 自动推单失败：挂履约拦截，HQ 可见，避免静默 MANUAL 像「没推单」 */
+  private async markCourierDispatchHold(orderId: bigint, error: string) {
+    const outOfService = /超出服务区/.test(error);
+    const reason = outOfService
+      ? FULFILLMENT_HOLD_COURIER_OUT_OF_SERVICE
+      : FULFILLMENT_HOLD_COURIER_DISPATCH_FAILED;
+    this.logger.warn(`承运商推单失败挂起：orderId=${orderId} reason=${reason} err=${error}`);
+    await this.prisma.order.update({
+      where: { id: orderId },
+      data: {
+        fulfillmentHold: true,
+        fulfillmentHoldReason: reason,
+      },
+    });
+  }
+
   private async buildQueryUrlFromTemplate(warehouseId: bigint | null, trackingNo: string) {
     if (!warehouseId) return undefined;
     const wh = await this.prisma.cityWarehouse.findUnique({ where: { id: warehouseId } });

server/dukang-api/src/modules/iam/admin-me.controller.ts

@@ -1,6 +1,6 @@
 import { Body, Controller, Param, Put, UseGuards } from '@nestjs/common';
 import { AuthService } from './auth.service';
-import { SaveHqListColumnPrefsDto } from './dto/auth.dto';
+import { SaveHqListColumnPrefsDto, UpdateMyHqCredentialsDto } from './dto/auth.dto';
 import { JwtAuthGuard } from '../../common/guards/jwt-auth.guard';
 import { CurrentUser } from '../../common/decorators/current-user.decorator';
 import { AuthUser } from '../../common/guards/jwt-auth.guard';
@@ -18,4 +18,9 @@ export class AdminMeController {
   ) {
     return this.authService.updateMyListColumnPrefs(user.actorType, user.actorId, listKey, dto);
   }
+
+  @Put('credentials')
+  updateCredentials(@CurrentUser() user: AuthUser, @Body() dto: UpdateMyHqCredentialsDto) {
+    return this.authService.updateMyHqCredentials(user.actorType, user.actorId, dto);
+  }
 }

server/dukang-api/src/modules/iam/auth.service.ts

@@ -20,7 +20,7 @@ import type { SmsActorRef } from '../../integrations/sms/sms.interface';
 import { SmsCodeStore } from '../../integrations/sms/sms-code.store';
 import type { IWechatProvider } from '../../integrations/wechat/wechat.interface';
 import { serializeBigInt } from '../../common/decorators/current-user.decorator';
-import { verifyPassword } from '../../common/crypto/password.util';
+import { verifyPassword, hashPassword } from '../../common/crypto/password.util';
 import { AnalyticsService } from '../analytics/analytics.service';
 import { UserAddressService } from './user-address.service';
 import { ResourceService } from '../common/resource.service';
@@ -1287,6 +1287,50 @@ export class AuthService {
     return { listColumnPrefs: parseListColumnPrefs(updated.listColumnPrefs) };
   }
 
+  async updateMyHqCredentials(
+    actorType: string,
+    actorId: bigint,
+    dto: { loginName?: string; oldPassword?: string; newPassword?: string },
+  ) {
+    if (actorType !== 'HQ') throw new ForbiddenException('仅总部账号可修改');
+    const account = await this.prisma.hqAccount.findUnique({ where: { id: actorId } });
+    if (!account) throw new NotFoundException('账号不存在');
+
+    const data: { loginName?: string; passwordHash?: string } = {};
+    const nextLogin = dto.loginName?.trim();
+    if (nextLogin !== undefined) {
+      if (!nextLogin) throw new BadRequestException('用户名不能为空');
+      if (nextLogin !== account.loginName) {
+        const dup = await this.prisma.hqAccount.findUnique({ where: { loginName: nextLogin } });
+        if (dup && dup.id !== account.id) throw new BadRequestException('用户名已被占用');
+        data.loginName = nextLogin;
+      }
+    }
+
+    if (dto.newPassword !== undefined) {
+      const pwd = dto.newPassword.trim();
+      if (pwd.length < 6) throw new BadRequestException('新密码至少 6 位');
+      if (account.passwordHash) {
+        if (!dto.oldPassword?.trim()) throw new BadRequestException('请输入当前密码');
+        if (!verifyPassword(dto.oldPassword.trim(), account.passwordHash)) {
+          throw new BadRequestException('当前密码不正确');
+        }
+      }
+      data.passwordHash = hashPassword(pwd);
+    }
+
+    if (!Object.keys(data).length) {
+      throw new BadRequestException('请填写要修改的内容');
+    }
+
+    const updated = await this.prisma.hqAccount.update({
+      where: { id: actorId },
+      data,
+    });
+    const { passwordHash: _ph, ...safe } = updated;
+    return serializeBigInt(safe);
+  }
+
   wechatDisabled() {
     throw new NotImplementedException('FEATURE_DISABLED');
   }

server/dukang-api/src/modules/iam/dto/auth.dto.ts

@@ -130,6 +130,22 @@ export class CheckPartnerPhoneDto {
   phone: string;
 }
 
+export class UpdateMyHqCredentialsDto {
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  loginName?: string;
+
+  @IsOptional()
+  @IsString()
+  oldPassword?: string;
+
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  newPassword?: string;
+}
+
 export class SaveHqListColumnPrefsDto {
   @IsOptional()
   @IsBoolean()

server/dukang-api/src/modules/iam/user-address.service.ts

@@ -1,4 +1,5 @@
-import { Injectable, NotFoundException } from '@nestjs/common';
+import { BadRequestException, Injectable, NotFoundException } from '@nestjs/common';
+import { validateShippingAddress } from '@dukang/domain';
 import { PrismaService } from '../../common/prisma/prisma.module';
 import { serializeBigInt } from '../../common/decorators/current-user.decorator';
 
@@ -27,7 +28,25 @@ export class UserAddressService {
     });
   }
 
+  private assertShippingFields(body: Record<string, unknown>, existing?: {
+    province: string;
+    city: string;
+    district: string;
+    detail: string;
+  }) {
+    const check = validateShippingAddress({
+      province: body.province != null ? String(body.province) : existing?.province,
+      city: body.city != null ? String(body.city) : existing?.city,
+      district: body.district != null ? String(body.district) : existing?.district,
+      detail: body.detail != null ? String(body.detail) : existing?.detail,
+    });
+    if (!check.ok) {
+      throw new BadRequestException(check.message || '收货地址不完整');
+    }
+  }
+
   async create(userId: bigint, body: Record<string, unknown>) {
+    this.assertShippingFields(body);
     const isDefault = body.isDefault ? 1 : 0;
     const address = await this.prisma.$transaction(async (tx) => {
       if (isDefault) {
@@ -52,6 +71,7 @@ export class UserAddressService {
   async update(userId: bigint, id: bigint, body: Record<string, unknown>) {
     const existing = await this.prisma.userAddress.findFirst({ where: { id, userId } });
     if (!existing) throw new NotFoundException('地址不存在');
+    this.assertShippingFields(body, existing);
     const address = await this.prisma.$transaction(async (tx) => {
       if (body.isDefault) {
         await tx.userAddress.updateMany({ where: { userId }, data: { isDefault: 0 } });

server/dukang-api/src/modules/ops/admin-order-export.util.ts

@@ -3,20 +3,16 @@ import ExcelJS from 'exceljs';
 import * as fs from 'fs';
 import * as path from 'path';
 import PDFDocument from 'pdfkit';
+import {
+  pickExportColumns,
+  type ExportColumnDef,
+} from '../../common/export/column-export.util';
 
-const EXPORT_HEADERS = [
-  '订单号',
-  '下单时间',
-  '状态',
-  '商品',
-  '规格',
-  '数量',
-  '实付',
-  '好客权益',
-  '收货人',
-  '手机',
-  '收货地址',
-] as const;
+const DELIVERY_TYPE_LABELS: Record<string, string> = {
+  LOCAL: '同城',
+  CROSS_CITY: '跨城',
+  ON_SITE_PICKUP: '现场提货',
+};
 
 export type OrderExportRow = {
   orderNo: string;
@@ -25,7 +21,9 @@ export type OrderExportRow = {
   productName: string;
   productSpec: string;
   quantity: number;
+  deliveryType: string;
   payAmount: number;
+  logisticsFee: string;
   benefitBrief: string;
   receiverName: string;
   receiverPhone: string;
@@ -95,7 +93,9 @@ export function mapOrderToExportRow(order: {
     productName: order.productName,
     productSpec: order.productSpec,
     quantity: order.quantity,
+    deliveryType: DELIVERY_TYPE_LABELS[order.deliveryType ?? ''] || order.deliveryType || '',
     payAmount: Number(order.payAmount),
+    logisticsFee: '',
     benefitBrief: formatBenefitBrief(order),
     receiverName: order.receiverName,
     receiverPhone: order.receiverPhone,
@@ -103,22 +103,49 @@ export function mapOrderToExportRow(order: {
   };
 }
 
-export function rowToCells(row: OrderExportRow): string[] {
+function orderExportColumnDefs(): ExportColumnDef<OrderExportRow>[] {
   return [
-    row.orderNo,
-    row.createdAt,
-    row.status,
-    row.productName,
-    row.productSpec,
-    String(row.quantity),
-    row.payAmount.toFixed(2),
-    row.benefitBrief,
-    row.receiverName,
-    row.receiverPhone,
-    row.address,
+    { key: '订单号', header: '订单号', value: (r) => r.orderNo },
+    { key: '下单时间', header: '下单时间', value: (r) => r.createdAt },
+    { key: '状态', header: '状态', value: (r) => r.status },
+    { key: '商品', header: '商品', value: (r) => r.productName },
+    { key: '规格', header: '规格', value: (r) => r.productSpec },
+    { key: '数量', header: '数量', value: (r) => r.quantity },
+    { key: '配送方式', header: '配送方式', value: (r) => r.deliveryType },
+    { key: '实付', header: '实付', value: (r) => r.payAmount.toFixed(2) },
+    { key: '运费', header: '运费', value: (r) => r.logisticsFee },
+    { key: '好客权益', header: '好客权益', value: (r) => r.benefitBrief },
+    { key: '收货人', header: '收货人', value: (r) => r.receiverName },
+    { key: '电话', header: '电话', value: (r) => r.receiverPhone },
+    { key: '地址', header: '地址', value: (r) => r.address },
   ];
 }
 
+const ORDER_COLUMN_ALIASES: Record<string, string> = {
+  orderNo: '订单号',
+  createdAt: '下单时间',
+  status: '状态',
+  productName: '商品',
+  productSpec: '规格',
+  quantity: '数量',
+  deliveryType: '配送方式',
+  payAmount: '实付',
+  logisticsFee: '运费',
+  benefitBrief: '好客权益',
+  receiverName: '收货人',
+  receiverPhone: '电话',
+  phone: '电话',
+  receiverAddress: '地址',
+  address: '地址',
+  手机: '电话',
+  收货地址: '地址',
+};
+
+function normalizeOrderColumns(columnKeys?: string[]): string[] | undefined {
+  if (!columnKeys?.length) return undefined;
+  return columnKeys.map((k) => ORDER_COLUMN_ALIASES[k] ?? k);
+}
+
 function resolvePdfFontPath(): string {
   const candidates = [
     process.env.EXPORT_PDF_FONT_PATH,
@@ -138,79 +165,42 @@ function resolvePdfFontPath(): string {
   throw new Error('未找到可用于 PDF 的中文字体，请将字体文件放到 server/dukang-api/assets/fonts/');
 }
 
-export async function buildOrdersXlsx(rows: OrderExportRow[]): Promise<Buffer> {
+export async function buildOrdersXlsx(rows: OrderExportRow[], columnKeys?: string[]): Promise<Buffer> {
+  const cols = pickExportColumns(orderExportColumnDefs(), normalizeOrderColumns(columnKeys));
   const workbook = new ExcelJS.Workbook();
   const sheet = workbook.addWorksheet('订单');
-  sheet.addRow([...EXPORT_HEADERS]);
+  sheet.addRow(cols.map((c) => c.header));
   for (const row of rows) {
-    sheet.addRow(rowToCells(row));
+    sheet.addRow(cols.map((c) => c.value(row)));
   }
   sheet.columns.forEach((col) => {
     col.width = 16;
   });
-  sheet.getColumn(4).width = 22;
-  sheet.getColumn(8).width = 36;
-  sheet.getColumn(11).width = 36;
   const buffer = await workbook.xlsx.writeBuffer();
   return Buffer.from(buffer);
 }
 
-export async function buildOrdersPdf(rows: OrderExportRow[]): Promise<Buffer> {
+export async function buildOrdersPdf(rows: OrderExportRow[], columnKeys?: string[]): Promise<Buffer> {
+  const cols = pickExportColumns(orderExportColumnDefs(), normalizeOrderColumns(columnKeys));
   const fontPath = resolvePdfFontPath();
   const chunks: Buffer[] = [];
 
   return new Promise((resolve, reject) => {
-    const doc = new PDFDocument({
-      size: 'A4',
-      layout: 'landscape',
-      margin: 24,
-      bufferPages: true,
-    });
-    doc.on('data', (chunk) => chunks.push(chunk as Buffer));
+    const doc = new PDFDocument({ size: 'A4', layout: 'landscape', margin: 24, bufferPages: true });
+    doc.on('data', (c) => chunks.push(c as Buffer));
     doc.on('end', () => resolve(Buffer.concat(chunks)));
     doc.on('error', reject);
-
-    doc.registerFont('zh', fontPath);
-    doc.font('zh');
-
-    const pageWidth = doc.page.width - doc.page.margins.left - doc.page.margins.right;
-    const colWidths = [72, 78, 48, 88, 64, 32, 48, 110, 48, 72, 120];
-    const scale = pageWidth / colWidths.reduce((sum, w) => sum + w, 0);
-    const widths = colWidths.map((w) => w * scale);
-    const rowHeight = 28;
-    const fontSize = 7;
-    let y = doc.page.margins.top;
-
-    const drawRow = (cells: string[], isHeader = false) => {
-      let x = doc.page.margins.left;
-      const height = isHeader ? 24 : rowHeight;
-      if (y + height > doc.page.height - doc.page.margins.bottom) {
-        doc.addPage({ size: 'A4', layout: 'landscape', margin: 24 });
-        y = doc.page.margins.top;
-      }
-      doc.fontSize(isHeader ? 8 : fontSize);
-      cells.forEach((cell, index) => {
-        doc.rect(x, y, widths[index], height).stroke('#dddddd');
-        doc.text(cell || '', x + 2, y + 4, {
-          width: widths[index] - 4,
-          height: height - 6,
-          lineBreak: true,
-        });
-        x += widths[index];
-      });
-      y += height;
-    };
-
-    drawRow([...EXPORT_HEADERS], true);
+    doc.font(fontPath);
+    doc.fontSize(10).text(cols.map((c) => c.header).join(' | '));
+    doc.moveDown(0.5);
     for (const row of rows) {
-      drawRow(rowToCells(row));
+      doc.text(cols.map((c) => String(c.value(row))).join(' | '));
     }
-
     doc.end();
   });
 }
 
 export function buildExportFilename(format: 'xlsx' | 'pdf', count: number): string {
-  const stamp = formatShanghaiDateTime(new Date()).slice(0, 10);
-  return `订单导出_${stamp}_${count}条.${format}`;
+  const stamp = new Date().toISOString().slice(0, 10);
+  return `订单导出_${stamp}_${count}.${format}`;
 }

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

@@ -156,7 +156,9 @@ export class AdminOrdersService {
 
     const rows = orders.map((order) => mapOrderToExportRow(order));
     const buffer =
-      dto.format === 'pdf' ? await buildOrdersPdf(rows) : await buildOrdersXlsx(rows);
+      dto.format === 'pdf'
+        ? await buildOrdersPdf(rows, dto.columns)
+        : await buildOrdersXlsx(rows, dto.columns);
     const filename = buildExportFilename(dto.format, rows.length);
     const mimeType =
       dto.format === 'pdf'

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

@@ -14,6 +14,12 @@ import { contractMediaType, normalizeContractUrls } from '../../common/store-med
 import type { AdminStoreAccountsQueryDto, AdminStoreMediaQueryDto, AdminStoresQueryDto } from './dto/admin-query.dto';
 import { PartnerCityService } from '../city-scope/partner-city.service';
 import { StoreCategoryService } from '../store/store-category.service';
+import {
+  attachStoreCategories,
+  parseUniqueCategoryIds,
+  storeCategoryLinkInclude,
+  syncStoreCategoryLinks,
+} from '../store/store-category-link.util';
 import { AnalyticsService } from '../analytics/analytics.service';
 import type {
   CreateStoreAccountDto,
@@ -123,6 +129,7 @@ export class AdminStoresService {
           cityRef: { select: { id: true, name: true, code: true } },
           partnerAccount: { select: { id: true, companyName: true, name: true, phone: true } },
           category: { select: { id: true, name: true, parentId: true } },
+          ...storeCategoryLinkInclude,
           bindings: {
             where: { storeAccount: { isPrimary: 1 } },
             take: 1,
@@ -169,7 +176,7 @@ export class AdminStoresService {
     return serializeBigInt({
       items: items.map((s) => {
         const { visibilityPhones, ...rest } = s;
-        return mapStoreCompat({
+        return mapStoreCompat(attachStoreCategories({
           ...rest,
           visibilityWhitelistEnabled: s.visibilityWhitelistEnabled,
           visibilityPhones: visibilityPhones.map((p) => p.phone),
@@ -180,7 +187,7 @@ export class AdminStoresService {
           partner: s.partnerAccount,
           account: s.bindings[0]?.storeAccount ?? null,
           bindings: undefined,
-        });
+        }));
       }),
       total,
       page,
@@ -196,6 +203,7 @@ export class AdminStoresService {
         cityRef: true,
         partnerAccount: true,
         category: true,
+        ...storeCategoryLinkInclude,
         bindings: {
           where: { storeAccount: { isPrimary: 1 } },
           take: 1,
@@ -219,7 +227,7 @@ export class AdminStoresService {
       }),
     ]);
     const { visibilityPhones, ...rest } = store;
-    return serializeBigInt(mapStoreCompat({
+    return serializeBigInt(mapStoreCompat(attachStoreCategories({
       ...rest,
       visibilityWhitelistEnabled: store.visibilityWhitelistEnabled,
       visibilityPhones: visibilityPhones.map((p) => p.phone),
@@ -235,7 +243,7 @@ export class AdminStoresService {
       redeemCount: store._count.redeemRecords,
       ratingCount: store._count.ratings,
       _count: undefined,
-    }));
+    })));
   }
 
   async updateStoreStatus(id: bigint, dto: UpdateStoreStatusDto, actorId: bigint) {
@@ -430,11 +438,22 @@ export class AdminStoresService {
     }
 
     let categoryId: bigint | undefined;
-    if (dto.categoryId !== undefined) {
+    let categoryIds: bigint[] | undefined;
+    if (dto.categoryIds !== undefined) {
+      categoryIds = parseUniqueCategoryIds(dto.categoryIds);
+      if (!categoryIds.length) {
+        throw new BadRequestException('请选择门店分类');
+      }
+      for (const id of categoryIds) {
+        await this.storeCategoryService.assertLeafCategoryId(id);
+      }
+      categoryId = categoryIds[0];
+    } else if (dto.categoryId !== undefined) {
       if (!dto.categoryId?.trim()) {
         throw new BadRequestException('请选择门店分类');
       }
       categoryId = BigInt(dto.categoryId);
+      categoryIds = [categoryId];
       await this.storeCategoryService.assertLeafCategoryId(categoryId);
     }
 
@@ -661,6 +680,10 @@ export class AdminStoresService {
           });
         }
       }
+
+      if (categoryIds !== undefined) {
+        await syncStoreCategoryLinks(tx, id, categoryIds);
+      }
     });
 
     return this.detailStore(id, actorId);
@@ -693,11 +716,20 @@ export class AdminStoresService {
     if (!city) throw new BadRequestException('开城城市不存在');
     await this.partnerCityService.assertPartnerAccountBoundToCity(partnerAccountId, city.id);
 
-    if (!dto.categoryId?.trim()) {
+    if (!dto.categoryId?.trim() && (!dto.categoryIds || !dto.categoryIds.length)) {
       throw new BadRequestException('请选择门店分类');
     }
-    const categoryId = BigInt(dto.categoryId);
-    await this.storeCategoryService.assertLeafCategoryId(categoryId);
+    const categoryIds = parseUniqueCategoryIds(dto.categoryIds);
+    if (!categoryIds.length && dto.categoryId?.trim()) {
+      categoryIds.push(BigInt(dto.categoryId));
+    }
+    if (!categoryIds.length) {
+      throw new BadRequestException('请选择门店分类');
+    }
+    for (const id of categoryIds) {
+      await this.storeCategoryService.assertLeafCategoryId(id);
+    }
+    const categoryId = categoryIds[0];
 
     const latitude = dto.latitude != null ? Number(dto.latitude) : null;
     const longitude = dto.longitude != null ? Number(dto.longitude) : null;
@@ -775,6 +807,8 @@ export class AdminStoresService {
       },
     });
 
+    await syncStoreCategoryLinks(this.prisma, store.id, categoryIds);
+
     if (dto.coverUrl) {
       const cover = await this.prisma.commonResource.create({
         data: {

server/dukang-api/src/modules/ops/admin-xiaofeixia.controller.ts

@@ -59,4 +59,9 @@ export class AdminXiaofeixiaController {
   getTrack(@Body() body: XiaofeixiaShipmentQueryDto) {
     return this.service.getTrack(body);
   }
+
+  @Post('get-sign-photos')
+  getSignPhotos(@Body() body: XiaofeixiaShipmentQueryDto) {
+    return this.service.getSignPhotos(body);
+  }
 }

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

@@ -101,6 +101,19 @@ export class AdminXiaofeixiaService {
     return this.wrap(() => this.courier.getTrack(query, options));
   }
 
+  async getSignPhotos(dto: XiaofeixiaShipmentQueryDto) {
+    const query = this.mapShipmentQuery(dto);
+    const options = await this.callOptions();
+    return this.wrap(async () => {
+      const dataUris = await this.courier.getSignPhotos(query, options);
+      return {
+        count: dataUris.length,
+        // 联调预览用：完整 dataURI；日志侧已截断
+        data: dataUris,
+      };
+    });
+  }
+
   private async callOptions() {
     const fromDb = await this.fulfillmentProviderService.resolveDefaultXiaofeixiaConfig();
     return fromDb ? { xiaofeixia: fromDb } : undefined;

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

@@ -45,9 +45,15 @@ export class CreateStoreDto {
   @IsString()
   contactPhone?: string;
 
+  @IsOptional()
   @IsString()
-  @IsNotEmpty()
-  categoryId: string;
+  categoryId?: string;
+
+  /** 多选二级分类；至少选一项 */
+  @IsOptional()
+  @IsArray()
+  @IsString({ each: true })
+  categoryIds?: string[];
 
   @IsOptional()
   @IsString()
@@ -240,6 +246,12 @@ export class UpdateStoreDto {
   @IsString()
   categoryId?: string;
 
+  /** 多选二级分类；传此项时覆盖 categoryId */
+  @IsOptional()
+  @IsArray()
+  @IsString({ each: true })
+  categoryIds?: string[];
+
   @IsOptional()
   @IsNumber()
   @Min(0)
@@ -1152,7 +1164,7 @@ export class CreateHqAccountDto {
   name: string;
 
   @IsOptional()
-  @IsIn(['SUPER_ADMIN', 'OPS', 'FINANCE', 'CUSTOMER_SERVICE', 'CITY_STORE_SERVICE'])
+  @IsIn(['SUPER_ADMIN', 'OPS', 'FINANCE', 'CUSTOMER_SERVICE', 'CITY_STORE_SERVICE', 'DEVELOPER'])
   adminRole?: string;
 
   @IsOptional()
@@ -1179,7 +1191,7 @@ export class UpdateHqAccountDto {
   name?: string;
 
   @IsOptional()
-  @IsIn(['SUPER_ADMIN', 'OPS', 'FINANCE', 'CUSTOMER_SERVICE', 'CITY_STORE_SERVICE'])
+  @IsIn(['SUPER_ADMIN', 'OPS', 'FINANCE', 'CUSTOMER_SERVICE', 'CITY_STORE_SERVICE', 'DEVELOPER'])
   adminRole?: string;
 
   @IsOptional()

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

@@ -225,6 +225,12 @@ export class AdminOrdersExportDto {
   @IsOptional()
   @IsString()
   assocPartnerAccountId?: string;
+
+  /** 按列表可见列导出（中文列名或英文 key） */
+  @IsOptional()
+  @IsArray()
+  @IsString({ each: true })
+  columns?: string[];
 }
 
 /** 概览页用户/订单 ECharts 聚合筛选 */

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

@@ -300,6 +300,7 @@ export class AdminStoreBillController {
       storeId: query.storeId,
       dateFrom: query.dateFrom,
       dateTo: query.dateTo,
+      columns: query.columns,
     });
   }
 
@@ -391,6 +392,7 @@ export class AdminPartnerBillController {
       year: query.year ? Number(query.year) : undefined,
       month: query.month ? Number(query.month) : undefined,
       weekStartYmd: query.weekStartYmd,
+      columns: query.columns,
     });
   }
 
@@ -493,6 +495,7 @@ export class AdminWineryBillController {
       dateTo: query.dateTo,
       year: query.year ? Number(query.year) : undefined,
       month: query.month ? Number(query.month) : undefined,
+      columns: query.columns,
     });
   }
 
@@ -575,6 +578,7 @@ export class AdminLogisticsBillController {
       providerId: query.providerId,
       year: query.year ? Number(query.year) : undefined,
       month: query.month ? Number(query.month) : undefined,
+      columns: query.columns,
     });
   }
 

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

@@ -21,6 +21,7 @@ import {
   previousShanghaiWeek,
   resolveSettlementRate,
   shanghaiBillPeriodYmds,
+  shanghaiCalendarDaysBetween,
   shanghaiMonthLastInstant,
   shanghaiMonthRange,
   shanghaiPeriodYmds,
@@ -40,6 +41,7 @@ import {
 import { PrismaService } from '../../common/prisma/prisma.module';
 import { serializeBigInt } from '../../common/decorators/current-user.decorator';
 import { AlertService } from '../../common/alert/alert.service';
+import { buildCsvFromColumns, parseExportColumnKeys, type ExportColumnDef } from '../../common/export/column-export.util';
 import { WecomMessagePushService } from '../../integrations/wecom/wecom-message-push.service';
 import { AnalyticsService } from '../analytics/analytics.service';
 import { PartnerCityService } from '../city-scope/partner-city.service';
@@ -88,6 +90,34 @@ function withShanghaiPeriod<T extends { periodStart: Date; periodEnd: Date }>(ro
   return { ...row, ...shanghaiBillPeriodYmds(row.periodStart, row.periodEnd) };
 }
 
+/** 门店 T+1：账期 = 出账日前一日 */
+function mapStoreBillDates(billDate: Date) {
+  const billDateYmd = shanghaiYmd(billDate);
+  const periodDay = shanghaiYmd(addShanghaiDays(parseShanghaiYmd(billDateYmd), -1));
+  return { billDate: billDateYmd, periodStart: periodDay, periodEnd: periodDay };
+}
+
+/**
+ * 合伙人出账日：周账 = 账期周一 + 7 天（下周一）；
+ * 历史月账 = 账期所在月次月 1 日。
+ */
+function partnerBillIssueYmd(periodStart: Date, periodEnd: Date): string {
+  const days = shanghaiCalendarDaysBetween(periodStart, periodEnd);
+  if (days >= 0 && days <= 8) {
+    return shanghaiYmd(addShanghaiDays(startOfShanghaiDay(periodStart), 7));
+  }
+  const [y, m] = shanghaiYmd(periodStart).split('-').map(Number);
+  return shanghaiYmd(shanghaiMonthRange(y, m).endExclusive);
+}
+
+function withPartnerBillDates<T extends { periodStart: Date; periodEnd: Date }>(row: T) {
+  return {
+    ...row,
+    ...shanghaiBillPeriodYmds(row.periodStart, row.periodEnd),
+    billDate: partnerBillIssueYmd(row.periodStart, row.periodEnd),
+  };
+}
+
 function resolvePartnerWeekPeriod(weekStartYmd: string): {
   periodStart: Date;
   periodEnd: Date;
@@ -1429,14 +1459,20 @@ export class SettlementService implements OnModuleInit {
     const payoutAmount = rows.reduce((s, r) => s + r.amount, 0);
 
     return serializeBigInt({
-      items: slice.map((r) => ({
-        ...r,
-        date: r.kind === 'T1_BILL' ? shanghaiYmd(r.date) : r.date,
-        bankAccount:
-          r.kind === 'T1_BILL'
-            ? bankMap.get(String(r.storeId)) ?? null
-            : null,
-      })),
+      items: slice.map((r) => {
+        const storeDates =
+          r.kind === 'T1_BILL' ? mapStoreBillDates(r.date) : null;
+        return {
+          ...r,
+          date: r.kind === 'T1_BILL' ? storeDates!.billDate : r.date,
+          periodStart: storeDates?.periodStart ?? null,
+          periodEnd: storeDates?.periodEnd ?? null,
+          bankAccount:
+            r.kind === 'T1_BILL'
+              ? bankMap.get(String(r.storeId)) ?? null
+              : null,
+        };
+      }),
       total,
       page,
       pageSize,
@@ -1487,7 +1523,7 @@ export class SettlementService implements OnModuleInit {
     };
 
     return serializeBigInt({
-      items: items.map((b) => ({ ...b, billDate: shanghaiYmd(b.billDate) })),
+      items: items.map((b) => ({ ...b, ...mapStoreBillDates(b.billDate) })),
       total,
       page,
       pageSize,
@@ -1510,7 +1546,7 @@ export class SettlementService implements OnModuleInit {
     const storeAccount = await loadStorePrimaryBank(this.prisma, bill.storeId);
     return serializeBigInt({
       ...bill,
-      billDate: shanghaiYmd(bill.billDate),
+      ...mapStoreBillDates(bill.billDate),
       storeAccount,
       paymentProofUrls: parsePaymentProofUrls(bill.paymentProofUrls),
     });
@@ -1568,6 +1604,7 @@ export class SettlementService implements OnModuleInit {
     storeId?: string;
     dateFrom?: string;
     dateTo?: string;
+    columns?: string;
   }) {
     const where = this.buildStoreBillWhere(query);
     const bills = await this.prisma.storeBill.findMany({
@@ -1579,44 +1616,70 @@ export class SettlementService implements OnModuleInit {
       this.prisma,
       bills.map((b) => b.storeId),
     );
-    const header = [
-      '账单号',
-      '出账日',
-      '门店',
-      '城市',
-      '核销笔数',
-      '核销金额',
-      '结算比例',
-      '应付金额',
-      '状态',
-      '打款时间',
-      '打款凭证',
-      '打款凭证照片',
-      '收款户名',
-      '收款账号',
-      '开户行',
-    ].join(',');
-    const rows = bills.map((b) => {
-      const bank = bankMap.get(String(b.storeId));
-      return [
-        csvEscape(b.billNo),
-        shanghaiYmd(b.billDate),
-        csvEscape(b.store.name),
-        csvEscape(b.store.cityName ?? ''),
-        b.redeemCount,
-        Number(b.redeemAmount),
-        Number(b.settlementRate),
-        Number(b.payoutAmount),
-        b.status,
-        b.paidAt ? b.paidAt.toISOString().slice(0, 19).replace('T', ' ') : '',
-        csvEscape(b.paymentRef ?? ''),
-        csvEscape(parsePaymentProofUrls(b.paymentProofUrls).join(' ')),
-        csvEscape(bank?.bankAccountName ?? ''),
-        csvEscape(bank?.bankAccountNo ?? ''),
-        csvEscape(bank?.bankBranch ?? ''),
-      ].join(',');
-    });
-    return { csv: `\uFEFF${[header, ...rows].join('\n')}`, count: bills.length };
+    const columnKeys = parseExportColumnKeys(query.columns);
+
+    type Row = (typeof bills)[number] & { bank?: ReturnType<typeof bankMap.get> extends infer T ? T : never };
+    const rows = bills.map((b) => ({ ...b, bank: bankMap.get(String(b.storeId)) }));
+
+    const defs: ExportColumnDef<Row>[] = [
+      { key: '账单号', header: '账单号', value: (r) => r.billNo },
+      { key: '出账日', header: '出账日', value: (r) => shanghaiYmd(r.billDate) },
+      {
+        key: '账期',
+        header: '账期',
+        value: (r) => {
+          const d = mapStoreBillDates(r.billDate);
+          return `${d.periodStart} ~ ${d.periodEnd}`;
+        },
+      },
+      { key: '门店', header: '门店', value: (r) => r.store.name },
+      { key: '登录手机', header: '登录手机', value: (r) => r.store.phone ?? '' },
+      { key: '城市', header: '城市', value: (r) => r.store.cityName ?? '' },
+      { key: '收款户名', header: '收款户名', value: (r) => r.bank?.bankAccountName ?? '' },
+      { key: '收款账号', header: '收款账号', value: (r) => r.bank?.bankAccountNo ?? '' },
+      { key: '笔数', header: '笔数', value: (r) => r.redeemCount },
+      { key: '应付金额', header: '应付金额', value: (r) => Number(r.payoutAmount) },
+      { key: '核销金额', header: '核销金额', value: (r) => Number(r.redeemAmount) },
+      { key: '结算比例', header: '结算比例', value: (r) => Number(r.settlementRate) },
+      { key: '状态', header: '状态', value: (r) => r.status },
+      {
+        key: '打款时间',
+        header: '打款时间',
+        value: (r) => (r.paidAt ? r.paidAt.toISOString().slice(0, 19).replace('T', ' ') : ''),
+      },
+      { key: '打款凭证', header: '打款凭证', value: (r) => r.paymentRef ?? '' },
+      {
+        key: '打款凭证照片',
+        header: '打款凭证照片',
+        value: (r) => parsePaymentProofUrls(r.paymentProofUrls).join(' '),
+      },
+      { key: '开户行', header: '开户行', value: (r) => r.bank?.bankBranch ?? '' },
+    ];
+
+    // 兼容旧英文 key
+    const aliases: Record<string, string> = {
+      billNo: '账单号',
+      date: '出账日',
+      billDate: '出账日',
+      period: '账期',
+      'store.name': '门店',
+      'store.phone': '登录手机',
+      'store.cityName': '城市',
+      bankAccountName: '收款户名',
+      bankAccountNo: '收款账号',
+      redeemCount: '笔数',
+      amount: '应付金额',
+      redeemAmount: '核销金额',
+      settlementRate: '结算比例',
+      status: '状态',
+      paidAt: '打款时间',
+      paymentRef: '打款凭证',
+      paymentProofUrls: '打款凭证照片',
+      bankBranch: '开户行',
+    };
+    const normalized = columnKeys?.map((k) => aliases[k] ?? k);
+
+    return buildCsvFromColumns(defs, rows, normalized);
   }
 
   private buildStoreBillWhere(query: {
@@ -1665,7 +1728,7 @@ export class SettlementService implements OnModuleInit {
       eventName: 'partner_bill_view',
       extraJson: { count: bills.length },
     });
-    return serializeBigInt(bills.map(withShanghaiPeriod));
+    return serializeBigInt(bills.map(withPartnerBillDates));
   }
 
   getPartnerSettlementCycle(anchor = new Date()) {
@@ -1737,7 +1800,7 @@ export class SettlementService implements OnModuleInit {
     });
     const { items, ...header } = bill;
     return serializeBigInt({
-      ...withShanghaiPeriod(header),
+      ...withPartnerBillDates(header),
       partnerId: header.partnerAccountId.toString(),
       ...splitPartnerBillItems(items),
     });
@@ -1785,7 +1848,7 @@ export class SettlementService implements OnModuleInit {
     ]);
 
     const items = rawItems.map((b) => ({
-      ...withShanghaiPeriod(b),
+      ...withPartnerBillDates(b),
       partner: b.partnerAccount,
     }));
 
@@ -1904,7 +1967,7 @@ export class SettlementService implements OnModuleInit {
     if (!bill) throw new NotFoundException('账单不存在');
     const { items, ...header } = bill;
     return serializeBigInt({
-      ...withShanghaiPeriod(header),
+      ...withPartnerBillDates(header),
       partnerId: header.partnerAccountId.toString(),
       ...splitPartnerBillItems(items),
     });
@@ -2229,6 +2292,7 @@ export class SettlementService implements OnModuleInit {
     year?: number;
     month?: number;
     weekStartYmd?: string;
+    columns?: string;
   }) {
     const where = this.buildPartnerBillWhere(query);
     const bills = await this.prisma.partnerBill.findMany({
@@ -2237,76 +2301,82 @@ export class SettlementService implements OnModuleInit {
         partnerAccount: {
           select: {
             companyName: true,
+            name: true,
             phone: true,
             bankAccountName: true,
             bankAccountNo: true,
             bankBranch: true,
           },
         },
-        items: { orderBy: { occurredAt: 'asc' } },
       },
       orderBy: { periodStart: 'desc' },
     });
+    const columnKeys = parseExportColumnKeys(query.columns);
 
-    const header = [
-      '账单号',
-      '合伙人',
-      '登录手机',
-      '账期起',
-      '账期止',
-      '酒单佣金',
-      '核销佣金',
-      '合计应付',
-      '状态',
-      '发送时间',
-      '确认时间',
-      '打款时间',
-      '打款凭证',
-      '收款户名',
-      '收款账号',
-      '开户行',
-      '驳回理由',
-    ].join(',');
-    const rows = bills.map((b) =>
-      [
-        csvEscape(b.billNo),
-        csvEscape(b.partnerAccount.companyName ?? ''),
-        csvEscape(b.partnerAccount.phone ?? ''),
-        shanghaiBillPeriodYmds(b.periodStart, b.periodEnd).periodStart,
-        shanghaiBillPeriodYmds(b.periodStart, b.periodEnd).periodEnd,
-        Number(b.orderCommission),
-        Number(b.redeemCommission),
-        Number(b.totalAmount),
-        b.status,
-        b.sentAt ? shanghaiYmd(b.sentAt) : '',
-        b.confirmedAt ? shanghaiYmd(b.confirmedAt) : '',
-        b.paidAt ? shanghaiYmd(b.paidAt) : '',
-        csvEscape(b.paymentRef ?? ''),
-        csvEscape(b.partnerAccount.bankAccountName ?? ''),
-        csvEscape(b.partnerAccount.bankAccountNo ?? ''),
-        csvEscape(b.partnerAccount.bankBranch ?? ''),
-        csvEscape(b.rejectReason ?? ''),
-      ].join(','),
-    );
+    type Row = (typeof bills)[number];
+    const defs: ExportColumnDef<Row>[] = [
+      { key: '账单号', header: '账单号', value: (r) => r.billNo },
+      {
+        key: '合伙人',
+        header: '合伙人',
+        value: (r) => {
+          const c = (r.partnerAccount.companyName || '').trim();
+          const n = (r.partnerAccount.name || '').trim();
+          if (c && n) return `${c}-${n}`;
+          return c || n || r.partnerAccount.phone || '';
+        },
+      },
+      {
+        key: '出账日',
+        header: '出账日',
+        value: (r) => partnerBillIssueYmd(r.periodStart, r.periodEnd),
+      },
+      {
+        key: '账期',
+        header: '账期',
+        value: (r) => {
+          const p = shanghaiBillPeriodYmds(r.periodStart, r.periodEnd);
+          return `${p.periodStart} ~ ${p.periodEnd}`;
+        },
+      },
+      { key: '酒单佣金', header: '酒单佣金', value: (r) => Number(r.orderCommission) },
+      { key: '核销佣金', header: '核销佣金', value: (r) => Number(r.redeemCommission) },
+      { key: '合计应付', header: '合计应付', value: (r) => Number(r.totalAmount) },
+      { key: '收款户名', header: '收款户名', value: (r) => r.partnerAccount.bankAccountName ?? '' },
+      { key: '收款账号', header: '收款账号', value: (r) => r.partnerAccount.bankAccountNo ?? '' },
+      { key: '状态', header: '状态', value: (r) => r.status },
+      { key: '登录手机', header: '登录手机', value: (r) => r.partnerAccount.phone ?? '' },
+      { key: '开户行', header: '开户行', value: (r) => r.partnerAccount.bankBranch ?? '' },
+      {
+        key: '发送时间',
+        header: '发送时间',
+        value: (r) => (r.sentAt ? shanghaiYmd(r.sentAt) : ''),
+      },
+      {
+        key: '确认时间',
+        header: '确认时间',
+        value: (r) => (r.confirmedAt ? shanghaiYmd(r.confirmedAt) : ''),
+      },
+      {
+        key: '打款时间',
+        header: '打款时间',
+        value: (r) => (r.paidAt ? shanghaiYmd(r.paidAt) : ''),
+      },
+      { key: '打款凭证', header: '打款凭证', value: (r) => r.paymentRef ?? '' },
+      { key: '驳回理由', header: '驳回理由', value: (r) => r.rejectReason ?? '' },
+    ];
 
-    const itemHeader = ['账单号', '类型', '单号', '标题', '备注', '基数', '费率', '佣金', '发生时间'].join(',');
-    const itemRows = bills.flatMap((b) =>
-      b.items.map((it) =>
-        [
-          csvEscape(b.billNo),
-          it.kind === 'ORDER' ? '酒订单' : '核销',
-          csvEscape(it.refNo),
-          csvEscape(it.title ?? ''),
-          csvEscape(it.extra ?? ''),
-          Number(it.baseAmount),
-          Number(it.rate),
-          Number(it.commission),
-          it.occurredAt.toISOString().slice(0, 19).replace('T', ' '),
-        ].join(','),
-      ),
-    );
-    const csv = ['账单汇总', header, ...rows, '', '酒订单/核销明细', itemHeader, ...itemRows].join('\n');
-    return { csv: `\uFEFF${csv}`, count: bills.length };
+    const aliases: Record<string, string> = {
+      billNo: '账单号',
+      billDate: '出账日',
+      period: '账期',
+      orderCommission: '酒单佣金',
+      redeemCommission: '核销佣金',
+      totalAmount: '合计应付',
+      status: '状态',
+    };
+    const normalized = columnKeys?.map((k) => aliases[k] ?? k);
+    return buildCsvFromColumns(defs, bills, normalized);
   }
 
   // ─── Winery bills ────────────────────────────────────
@@ -2673,7 +2743,7 @@ export class SettlementService implements OnModuleInit {
     };
 
     return serializeBigInt({
-      items: items.map((b) => ({ ...b, billDate: shanghaiYmd(b.billDate) })),
+      items: items.map((b) => this.mapWineryBillForAdmin(b)),
       total,
       page,
       pageSize,
@@ -2681,6 +2751,33 @@ export class SettlementService implements OnModuleInit {
     });
   }
 
+  private mapWineryBillForAdmin(b: {
+    id: bigint;
+    billNo: string;
+    billDate: Date;
+    orderCount: number;
+    orderAmount: Prisma.Decimal | number;
+    wineryRate: Prisma.Decimal | number;
+    wineryAmount: Prisma.Decimal | number;
+    status: string;
+    paidAt?: Date | null;
+    paymentRef?: string | null;
+  }) {
+    const billDateYmd = shanghaiYmd(b.billDate);
+    const { start, end } = shanghaiWineryPeriodWindow(
+      parseShanghaiYmd(billDateYmd),
+      WINERY_SETTLEMENT_PERIOD_DAYS,
+    );
+    const periodStart = shanghaiYmd(start);
+    const periodEnd = shanghaiYmd(addShanghaiDays(end, -1));
+    return {
+      ...b,
+      billDate: billDateYmd,
+      periodStart,
+      periodEnd,
+    };
+  }
+
   async getAdminWineryBill(id: bigint) {
     const bill = await this.prisma.wineryBill.findUnique({
       where: { id },
@@ -2688,7 +2785,7 @@ export class SettlementService implements OnModuleInit {
     });
     if (!bill) throw new NotFoundException('酒厂对账单不存在');
     const wineryBank = await loadWineryBankConfig(this.prisma);
-    return serializeBigInt({ ...bill, billDate: shanghaiYmd(bill.billDate), wineryBank });
+    return serializeBigInt({ ...this.mapWineryBillForAdmin(bill), items: bill.items, wineryBank });
   }
 
   async confirmWineryBill(id: bigint, dto: { paymentRef?: string } = {}) {
@@ -2728,87 +2825,87 @@ export class SettlementService implements OnModuleInit {
     dateTo?: string;
     year?: number;
     month?: number;
+    columns?: string;
   }) {
     const where = this.buildWineryBillWhere(query);
     const bills = await this.prisma.wineryBill.findMany({
       where,
-      include: { items: true },
       orderBy: { billDate: 'desc' },
     });
     const wineryBank = await loadWineryBankConfig(this.prisma);
+    const columnKeys = parseExportColumnKeys(query.columns);
 
-    const header = [
-      '账单号',
-      '账单日',
-      '订单号',
-      '配送类型',
-      '实付金额',
-      '酒厂比例',
-      '应付',
-      '支付时间',
-      '账单状态',
-      '打款凭证',
-      '收款户名',
-      '开户银行',
-      '开户支行',
-      '收款账号',
-    ].join(',');
-    const rows: string[] = [];
     const statusLabel = (b: { status: string; wineryAmount: Prisma.Decimal | number }) => {
       if (Number(b.wineryAmount) === 0) return '无需打款';
       if (b.status === 'PAID') return '已打款';
       if (b.status === 'UNPAID') return '未打款';
       return b.status;
     };
-    const bankCols = (b: { paymentRef?: string | null }) => [
-      csvEscape(b.paymentRef ?? ''),
-      csvEscape(wineryBank.bankAccountName ?? ''),
-      csvEscape(wineryBank.bankName ?? ''),
-      csvEscape(wineryBank.bankBranch ?? ''),
-      csvEscape(wineryBank.bankAccountNo ?? ''),
+
+    type ExportRow = {
+      billNo: string;
+      billDate: string;
+      periodStart: string;
+      periodEnd: string;
+      orderCount: number;
+      orderAmount: Prisma.Decimal | number;
+      wineryRate: Prisma.Decimal | number;
+      wineryAmount: Prisma.Decimal | number;
+      status: string;
+      paymentRef?: string | null;
+      paidAt?: Date | null;
+    };
+
+    const rows: ExportRow[] = bills.map((b) => ({
+      ...this.mapWineryBillForAdmin(b),
+      paymentRef: b.paymentRef,
+      paidAt: b.paidAt,
+    }));
+
+    const defs: ExportColumnDef<ExportRow>[] = [
+      { key: '账单号', header: '账单号', value: (r) => r.billNo },
+      { key: '出账日', header: '出账日', value: (r) => r.billDate },
+      {
+        key: '账期',
+        header: '账期',
+        value: (r) => `${r.periodStart} ~ ${r.periodEnd}`,
+      },
+      { key: '订单数', header: '订单数', value: (r) => r.orderCount },
+      { key: '订单总额', header: '订单总额', value: (r) => Number(r.orderAmount) },
+      { key: '酒厂比例', header: '酒厂比例', value: (r) => Number(r.wineryRate) },
+      { key: '应付', header: '应付', value: (r) => Number(r.wineryAmount) },
+      { key: '状态', header: '状态', value: (r) => statusLabel(r) },
+      {
+        key: '打款时间',
+        header: '打款时间',
+        value: (r) => (r.paidAt ? r.paidAt.toISOString().slice(0, 19).replace('T', ' ') : ''),
+      },
+      { key: '打款凭证', header: '打款凭证', value: (r) => r.paymentRef ?? '' },
+      { key: '收款户名', header: '收款户名', value: () => wineryBank.bankAccountName ?? '' },
+      { key: '开户银行', header: '开户银行', value: () => wineryBank.bankName ?? '' },
+      { key: '开户支行', header: '开户支行', value: () => wineryBank.bankBranch ?? '' },
+      { key: '收款账号', header: '收款账号', value: () => wineryBank.bankAccountNo ?? '' },
     ];
-    for (const b of bills) {
-      if (b.items.length === 0) {
-        rows.push(
-          [
-            csvEscape(b.billNo),
-            shanghaiYmd(b.billDate),
-            '',
-            '',
-            Number(b.orderAmount),
-            Number(b.wineryRate),
-            Number(b.wineryAmount),
-            '',
-            statusLabel(b),
-            ...bankCols(b),
-          ].join(','),
-        );
-        continue;
-      }
-      for (const item of b.items) {
-        rows.push(
-          [
-            csvEscape(b.billNo),
-            shanghaiYmd(b.billDate),
-            csvEscape(item.orderNo),
-            item.deliveryType === 'LOCAL'
-              ? '同城'
-              : item.deliveryType === 'CROSS_CITY'
-                ? '跨城'
-                : item.deliveryType === 'ON_SITE_PICKUP'
-                  ? '现场提货'
-                  : item.deliveryType,
-            Number(item.payAmount),
-            Number(b.wineryRate),
-            Number(item.wineryAmount),
-            item.paidAt.toISOString().slice(0, 19).replace('T', ' '),
-            statusLabel(b),
-            ...bankCols(b),
-          ].join(','),
-        );
-      }
-    }
-    return { csv: `\uFEFF${[header, ...rows].join('\n')}`, count: rows.length };
+
+    const aliases: Record<string, string> = {
+      billNo: '账单号',
+      billDate: '出账日',
+      period: '账期',
+      orderCount: '订单数',
+      orderAmount: '订单总额',
+      wineryRate: '酒厂比例',
+      wineryAmount: '应付',
+      status: '状态',
+      paidAt: '打款时间',
+      paymentRef: '打款凭证',
+      bankAccountName: '收款户名',
+      bankName: '开户银行',
+      bankBranch: '开户支行',
+      bankAccountNo: '收款账号',
+    };
+    const normalized = columnKeys?.map((k) => aliases[k] ?? k);
+
+    return buildCsvFromColumns(defs, rows, normalized);
   }
 
   private buildWineryBillWhere(query: {
@@ -3362,6 +3459,7 @@ export class SettlementService implements OnModuleInit {
     providerId?: string;
     year?: number;
     month?: number;
+    columns?: string;
   }) {
     const where = this.buildLogisticsBillWhere(query);
     const bills = await this.prisma.logisticsBill.findMany({
@@ -3377,78 +3475,73 @@ export class SettlementService implements OnModuleInit {
             bankAccountNo: true,
           },
         },
-        items: true,
       },
       orderBy: { periodStart: 'desc' },
     });
+    const columnKeys = parseExportColumnKeys(query.columns);
 
-    const header = [
-      '账单号',
-      '承运商编码',
-      '承运商名称',
-      '账期起',
-      '账期止',
-      '结算方式',
-      '订单号',
-      '瓶数',
-      '物流费',
-      '发货时间',
-      '账单状态',
-      '打款凭证',
-      '收款户名',
-      '开户银行',
-      '开户支行',
-      '收款账号',
-    ].join(',');
-    const rows: string[] = [];
-    for (const b of bills) {
-      const p = b.fulfillmentProvider;
-      const bankCols = [
-        csvEscape(b.paymentRef ?? ''),
-        csvEscape(p.bankAccountName ?? ''),
-        csvEscape(p.bankName ?? ''),
-        csvEscape(p.bankBranch ?? ''),
-        csvEscape(p.bankAccountNo ?? ''),
-      ];
-      if (b.items.length === 0) {
-        rows.push(
-          [
-            csvEscape(b.billNo),
-            csvEscape(p.code),
-            csvEscape(p.name),
-            shanghaiPeriodYmds(b.periodStart).periodStart,
-            shanghaiPeriodYmds(b.periodStart).periodEnd,
-            b.settlementMethod,
-            '',
-            b.bottleCount,
-            Number(b.logisticsAmount),
-            '',
-            b.status,
-            ...bankCols,
-          ].join(','),
-        );
-        continue;
-      }
-      for (const item of b.items) {
-        rows.push(
-          [
-            csvEscape(b.billNo),
-            csvEscape(p.code),
-            csvEscape(p.name),
-            shanghaiPeriodYmds(b.periodStart).periodStart,
-            shanghaiPeriodYmds(b.periodStart).periodEnd,
-            b.settlementMethod,
-            csvEscape(item.orderNo),
-            item.quantity,
-            Number(item.logisticsAmount),
-            item.shippedAt.toISOString().slice(0, 19).replace('T', ' '),
-            b.status,
-            ...bankCols,
-          ].join(','),
-        );
-      }
-    }
-    return { csv: `\uFEFF${[header, ...rows].join('\n')}`, count: rows.length };
+    type Row = (typeof bills)[number];
+    const defs: ExportColumnDef<Row>[] = [
+      { key: '账单号', header: '账单号', value: (r) => r.billNo },
+      {
+        key: '承运商',
+        header: '承运商',
+        value: (r) => `${r.fulfillmentProvider.name} (${r.fulfillmentProvider.code})`,
+      },
+      {
+        key: '账期',
+        header: '账期',
+        value: (r) => {
+          const p = shanghaiPeriodYmds(r.periodStart);
+          return `${p.periodStart} ~ ${p.periodEnd}`;
+        },
+      },
+      {
+        key: '结算方式',
+        header: '结算方式',
+        value: (r) =>
+          LOGISTICS_SETTLEMENT_METHOD_LABELS[
+            r.settlementMethod as keyof typeof LOGISTICS_SETTLEMENT_METHOD_LABELS
+          ] || r.settlementMethod,
+      },
+      { key: '订单数', header: '订单数', value: (r) => r.orderCount },
+      { key: '瓶数', header: '瓶数', value: (r) => r.bottleCount },
+      { key: '物流费', header: '物流费', value: (r) => Number(r.logisticsAmount) },
+      {
+        key: '收款户名',
+        header: '收款户名',
+        value: (r) => r.fulfillmentProvider.bankAccountName ?? '',
+      },
+      {
+        key: '收款账号',
+        header: '收款账号',
+        value: (r) => r.fulfillmentProvider.bankAccountNo ?? '',
+      },
+      { key: '状态', header: '状态', value: (r) => r.status },
+      {
+        key: '开户银行',
+        header: '开户银行',
+        value: (r) => r.fulfillmentProvider.bankName ?? '',
+      },
+      {
+        key: '开户支行',
+        header: '开户支行',
+        value: (r) => r.fulfillmentProvider.bankBranch ?? '',
+      },
+      { key: '打款凭证', header: '打款凭证', value: (r) => r.paymentRef ?? '' },
+    ];
+
+    const aliases: Record<string, string> = {
+      billNo: '账单号',
+      period: '账期',
+      settlementMethod: '结算方式',
+      orderCount: '订单数',
+      bottleCount: '瓶数',
+      logisticsAmount: '物流费',
+      status: '状态',
+    };
+    const normalized = columnKeys?.map((k) => aliases[k] ?? k);
+    return buildCsvFromColumns(defs, bills, normalized);
   }
 
   private buildLogisticsBillWhere(query: {

server/dukang-api/src/modules/store/store-category-link.util.ts

@@ -0,0 +1,130 @@
+import type { Prisma } from '@prisma/client';
+
+export const storeCategoryLinkInclude = {
+  categoryLinks: {
+    include: {
+      category: { include: { parent: true } },
+    },
+    orderBy: [{ priority: 'asc' as const }, { id: 'asc' as const }],
+  },
+} satisfies Prisma.StoreInclude;
+
+export type StoreCategoryItem = {
+  id: string;
+  name: string;
+  parentId: string | null;
+  parent: { id: string; name: string } | null;
+  priority: number;
+};
+
+type CategoryLinkRow = {
+  priority: number;
+  category: {
+    id: bigint;
+    name: string;
+    parentId: bigint | null;
+    parent?: { id: bigint; name: string } | null;
+  };
+};
+
+export function mapStoreCategoryLinks(links: CategoryLinkRow[] | undefined): StoreCategoryItem[] {
+  return (links ?? []).map((link) => ({
+    id: String(link.category.id),
+    name: link.category.name,
+    parentId: link.category.parentId != null ? String(link.category.parentId) : null,
+    parent: link.category.parent
+      ? { id: String(link.category.parent.id), name: link.category.parent.name }
+      : null,
+    priority: link.priority,
+  }));
+}
+
+export function attachStoreCategories<
+  T extends {
+    categoryId?: bigint | null;
+    category?: {
+      id: bigint;
+      name: string;
+      parentId?: bigint | null;
+      parent?: { id: bigint; name: string } | null;
+    } | null;
+    categoryLinks?: CategoryLinkRow[];
+  },
+>(store: T) {
+  const { categoryLinks, ...rest } = store;
+  let categories = mapStoreCategoryLinks(categoryLinks);
+  if (!categories.length && store.category) {
+    categories = [
+      {
+        id: String(store.category.id),
+        name: store.category.name,
+        parentId: store.category.parentId != null ? String(store.category.parentId) : null,
+        parent: store.category.parent
+          ? { id: String(store.category.parent.id), name: store.category.parent.name }
+          : null,
+        priority: 0,
+      },
+    ];
+  }
+  const primary = categories[0] ?? null;
+  return {
+    ...rest,
+    categories,
+    categoryId: primary?.id ?? (store.categoryId != null ? String(store.categoryId) : null),
+    category: primary
+      ? {
+          id: primary.id,
+          name: primary.name,
+          parentId: primary.parentId,
+          parent: primary.parent,
+        }
+      : store.category
+        ? {
+            id: String(store.category.id),
+            name: store.category.name,
+            parentId: store.category.parentId != null ? String(store.category.parentId) : null,
+            parent: store.category.parent
+              ? { id: String(store.category.parent.id), name: store.category.parent.name }
+              : null,
+          }
+        : null,
+  };
+}
+
+export async function syncStoreCategoryLinks(
+  tx: Prisma.TransactionClient,
+  storeId: bigint,
+  categoryIds: bigint[],
+) {
+  const uniqueIds = [...new Set(categoryIds.map((id) => id.toString()))].map(BigInt);
+  await tx.storeCategoryLink.deleteMany({ where: { storeId } });
+  if (uniqueIds.length === 0) {
+    await tx.store.update({ where: { id: storeId }, data: { categoryId: null } });
+    return;
+  }
+  await tx.storeCategoryLink.createMany({
+    data: uniqueIds.map((categoryId, index) => ({
+      storeId,
+      categoryId,
+      priority: index,
+    })),
+  });
+  await tx.store.update({
+    where: { id: storeId },
+    data: { categoryId: uniqueIds[0] },
+  });
+}
+
+export function parseUniqueCategoryIds(raw: unknown): bigint[] {
+  if (!Array.isArray(raw)) return [];
+  const seen = new Set<string>();
+  const ids: bigint[] = [];
+  for (const item of raw) {
+    const id = BigInt(String(item));
+    const key = id.toString();
+    if (seen.has(key)) continue;
+    seen.add(key);
+    ids.push(id);
+  }
+  return ids;
+}

server/dukang-api/src/modules/store/store-category.service.ts

@@ -253,7 +253,11 @@ export class StoreCategoryService {
     if (childCount > 0) {
       throw new BadRequestException('请先删除或停用下级分类');
     }
-    const storeCount = await this.prisma.store.count({ where: { categoryId: id } });
+    const storeCount = await this.prisma.store.count({
+      where: {
+        OR: [{ categoryId: id }, { categoryLinks: { some: { categoryId: id } } }],
+      },
+    });
     if (storeCount > 0) {
       // 软停用，避免破坏已有门店关联
       const row = await this.prisma.commonStoreCategory.update({

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

@@ -1,4 +1,4 @@
-import { Body, Controller, Get, Param, Post, Put, Query, UseGuards } from '@nestjs/common';
+import { Body, Controller, Delete, Get, Param, Post, Put, Query, UseGuards } from '@nestjs/common';
 import { StoreService } from './store.service';
 import { StoreCategoryService } from './store-category.service';
 import { RedeemService } from '../redeem/redeem.service';
@@ -109,41 +109,51 @@ export class PartnerStoreController {
   }
 
   @Get(':id')
-    async detail(@CurrentUser() user: AuthUser, @Param('id') id: string) {
-      return this.storeService.partnerGetStore(user.actorId, BigInt(id));
-    }
+  async detail(@CurrentUser() user: AuthUser, @Param('id') id: string) {
+    return this.storeService.partnerGetStore(user.actorId, BigInt(id));
+  }
 
-    @Get(':id/categories')
-    async getCategories(@CurrentUser() user: AuthUser, @Param('id') id: string) {
-      return this.storeService.getStoreCategories(BigInt(id));
-    }
+  @Get(':id/categories')
+  async getCategories(@CurrentUser() user: AuthUser, @Param('id') id: string) {
+    return this.storeService.partnerGetStoreCategories(user.actorId, BigInt(id));
+  }
 
-    @Post(':id/categories')
-    async assignCategory(
-      @CurrentUser() user: AuthUser,
-      @Param('id') id: string,
-      @Body() body: { categoryId: string; priority?: number },
-    ) {
-      return this.storeService.assignCategoryToStore(BigInt(id), body.categoryId, body.priority);
-    }
+  @Post(':id/categories')
+  async assignCategory(
+    @CurrentUser() user: AuthUser,
+    @Param('id') id: string,
+    @Body() body: { categoryId: string; priority?: number },
+  ) {
+    return this.storeService.partnerAssignCategoryToStore(
+      user.actorId,
+      BigInt(id),
+      body.categoryId,
+      body.priority,
+    );
+  }
 
-    @Delete(':id/categories/:categoryId')
-    async removeCategory(
-      @CurrentUser() user: AuthUser,
-      @Param('id') id: string,
-      @Param('categoryId') categoryId: string,
-    ) {
-      return this.storeService.removeCategoryFromStore(BigInt(id), categoryId);
-    }
+  @Delete(':id/categories/:categoryId')
+  async removeCategory(
+    @CurrentUser() user: AuthUser,
+    @Param('id') id: string,
+    @Param('categoryId') categoryId: string,
+  ) {
+    return this.storeService.partnerRemoveCategoryFromStore(user.actorId, BigInt(id), categoryId);
+  }
 
-    @Put(':id/categories')
-    async replaceCategories(
-      @CurrentUser() user: AuthUser,
-      @Param('id') id: string,
-      @Body() body: { categoryIds: string[]; priorities?: Record<string, number> },
-    ) {
-      return this.storeService.replaceStoreCategories(BigInt(id), body.categoryIds, body.priorities);
-    }
+  @Put(':id/categories')
+  async replaceCategories(
+    @CurrentUser() user: AuthUser,
+    @Param('id') id: string,
+    @Body() body: { categoryIds: string[]; priorities?: Record<string, number> },
+  ) {
+    return this.storeService.partnerReplaceStoreCategories(
+      user.actorId,
+      BigInt(id),
+      body.categoryIds,
+      body.priorities,
+    );
+  }
 
   @Post()
   create(@CurrentUser() user: AuthUser, @Body() body: Record<string, unknown>) {

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

@@ -18,6 +18,12 @@ import { AnalyticsService } from '../analytics/analytics.service';
 import { PartnerCityService } from '../city-scope/partner-city.service';
 import { AuthService } from '../iam/auth.service';
 import { StoreCategoryService } from './store-category.service';
+import {
+  attachStoreCategories,
+  parseUniqueCategoryIds,
+  storeCategoryLinkInclude,
+  syncStoreCategoryLinks,
+} from './store-category-link.util';
 import { TencentLbsProvider } from '../../integrations/map/tencent-lbs.provider';
 import {
   TestWhitelistService,
@@ -185,6 +191,7 @@ export class StoreService {
       where: where as never,
       include: {
         category: { include: { parent: true } },
+        ...storeCategoryLinkInclude,
         coverResource: true,
       },
       orderBy: [{ sortOrder: 'asc' }, { createdAt: 'desc' }],
@@ -226,11 +233,11 @@ export class StoreService {
       const coords = await this.ensureStoreCoordinates(store);
       const { visibilityWhitelistEnabled: _wl, ...rest } = store;
       const mapped = mapStoreCompat(
-        {
+        attachStoreCategories({
           ...rest,
           latitude: coords?.latitude ?? store.latitude,
           longitude: coords?.longitude ?? store.longitude,
-        },
+        }),
         { publicDial: true },
       );
       const distanceMeters =
@@ -263,6 +270,7 @@ export class StoreService {
       where: { id, status: 'OPEN' },
       include: {
         category: { include: { parent: true } },
+        ...storeCategoryLinkInclude,
         coverResource: true,
       },
     });
@@ -287,7 +295,7 @@ export class StoreService {
     const { visibilityWhitelistEnabled: _wl, ...rest } = store;
     return serializeBigInt(
       mapStoreCompat(
-        {
+        attachStoreCategories({
           ...rest,
           latitude: coords?.latitude ?? store.latitude,
           longitude: coords?.longitude ?? store.longitude,
@@ -310,7 +318,7 @@ export class StoreService {
               sortOrder: p.sortOrder,
             };
           }),
-        },
+        }),
         { publicDial: true },
       ),
     );
@@ -332,17 +340,17 @@ export class StoreService {
     }
     const stores = await this.prisma.store.findMany({
       where,
-      include: { category: true, coverResource: true },
+      include: { category: true, ...storeCategoryLinkInclude, coverResource: true },
       orderBy: [{ sortOrder: 'asc' }, { createdAt: 'desc' }],
     });
-    return serializeBigInt(stores.map((s) => mapStoreCompat(s)));
+    return serializeBigInt(stores.map((s) => mapStoreCompat(attachStoreCategories(s))));
   }
 
   async partnerGetStore(partnerAccountId: bigint, storeId: bigint) {
     const { account, primaryId } = await this.resolvePartnerScope(partnerAccountId);
     const store = await this.prisma.store.findFirst({
       where: { id: storeId, partnerAccountId: primaryId },
-      include: { category: true, coverResource: true },
+      include: { category: true, ...storeCategoryLinkInclude, coverResource: true },
     });
     if (!store) throw new NotFoundException('门店不存在');
     if (this.isSubAccount(account)) {
@@ -350,7 +358,7 @@ export class StoreService {
     }
 
     const media = await this.loadPartnerStoreMedia(storeId);
-    return serializeBigInt(mapStoreCompat({ ...store, media }));
+    return serializeBigInt(mapStoreCompat(attachStoreCategories({ ...store, media })));
   }
 
   async partnerListCities(partnerAccountId: bigint) {
@@ -444,11 +452,20 @@ export class StoreService {
     const bankAccountNo = body.bankAccountNo ? String(body.bankAccountNo) : null;
     const bankBranch = body.bankBranch ? String(body.bankBranch) : null;
 
-    if (!body.categoryId) {
+    if (!body.categoryId && !Array.isArray(body.categoryIds)) {
       throw new BadRequestException('请选择店铺类型');
     }
-    const categoryId = parseBigIntParam(body.categoryId, '分类ID');
-    await this.storeCategoryService.assertLeafCategoryId(categoryId);
+    const categoryIds = parseUniqueCategoryIds(body.categoryIds);
+    if (!categoryIds.length && body.categoryId) {
+      categoryIds.push(parseBigIntParam(body.categoryId, '分类ID'));
+    }
+    if (!categoryIds.length) {
+      throw new BadRequestException('请选择店铺类型');
+    }
+    for (const id of categoryIds) {
+      await this.storeCategoryService.assertLeafCategoryId(id);
+    }
+    const categoryId = categoryIds[0];
 
     const openTime = body.openTime ? String(body.openTime).trim() : '10:00';
     const closeTime = body.closeTime ? String(body.closeTime).trim() : '22:00';
@@ -507,6 +524,8 @@ export class StoreService {
       },
     });
 
+    await syncStoreCategoryLinks(this.prisma, store.id, categoryIds);
+
     if (latitude == null || longitude == null) {
       await this.ensureStoreCoordinates(store);
     }
@@ -1515,4 +1534,138 @@ export class StoreService {
     });
     if (!event) throw new ForbiddenException('无权查看该门店');
   }
+
+  async getStoreCategories(storeId: bigint) {
+    const store = await this.prisma.store.findUnique({
+      where: { id: storeId },
+      include: {
+        category: { include: { parent: true } },
+        ...storeCategoryLinkInclude,
+      },
+    });
+    if (!store) throw new NotFoundException('门店不存在');
+    return serializeBigInt(attachStoreCategories(store).categories);
+  }
+
+  async partnerGetStoreCategories(partnerAccountId: bigint, storeId: bigint) {
+    await this.partnerGetStore(partnerAccountId, storeId);
+    return this.getStoreCategories(storeId);
+  }
+
+  async assignCategoryToStore(storeId: bigint, categoryIdRaw: string, priority?: number) {
+    const categoryId = parseBigIntParam(categoryIdRaw, '分类ID');
+    await this.storeCategoryService.assertLeafCategoryId(categoryId);
+    const store = await this.prisma.store.findUnique({ where: { id: storeId } });
+    if (!store) throw new NotFoundException('门店不存在');
+
+    const existing = await this.prisma.storeCategoryLink.findUnique({
+      where: { storeId_categoryId: { storeId, categoryId } },
+    });
+    if (existing) {
+      if (priority != null) {
+        await this.prisma.storeCategoryLink.update({
+          where: { id: existing.id },
+          data: { priority },
+        });
+      }
+      return this.getStoreCategories(storeId);
+    }
+
+    const nextPriority =
+      priority ??
+      ((await this.prisma.storeCategoryLink.count({ where: { storeId } })) || 0);
+    await this.prisma.$transaction(async (tx) => {
+      await tx.storeCategoryLink.create({
+        data: { storeId, categoryId, priority: nextPriority },
+      });
+      if (!store.categoryId) {
+        await tx.store.update({ where: { id: storeId }, data: { categoryId } });
+      }
+    });
+    return this.getStoreCategories(storeId);
+  }
+
+  async partnerAssignCategoryToStore(
+    partnerAccountId: bigint,
+    storeId: bigint,
+    categoryId: string,
+    priority?: number,
+  ) {
+    await this.partnerGetStore(partnerAccountId, storeId);
+    return this.assignCategoryToStore(storeId, categoryId, priority);
+  }
+
+  async removeCategoryFromStore(storeId: bigint, categoryIdRaw: string) {
+    const categoryId = parseBigIntParam(categoryIdRaw, '分类ID');
+    const store = await this.prisma.store.findUnique({ where: { id: storeId } });
+    if (!store) throw new NotFoundException('门店不存在');
+
+    const linkCount = await this.prisma.storeCategoryLink.count({ where: { storeId } });
+    const legacyOnly = linkCount === 0 && store.categoryId?.toString() === categoryId.toString();
+    if (linkCount <= 1 && !legacyOnly) {
+      throw new BadRequestException('门店至少保留一个分类');
+    }
+
+    await this.prisma.$transaction(async (tx) => {
+      await tx.storeCategoryLink.deleteMany({ where: { storeId, categoryId } });
+      const remaining = await tx.storeCategoryLink.findMany({
+        where: { storeId },
+        orderBy: [{ priority: 'asc' }, { id: 'asc' }],
+      });
+      const nextPrimary = remaining[0]?.categoryId ?? null;
+      await tx.store.update({
+        where: { id: storeId },
+        data: { categoryId: nextPrimary },
+      });
+    });
+    return this.getStoreCategories(storeId);
+  }
+
+  async partnerRemoveCategoryFromStore(
+    partnerAccountId: bigint,
+    storeId: bigint,
+    categoryId: string,
+  ) {
+    await this.partnerGetStore(partnerAccountId, storeId);
+    return this.removeCategoryFromStore(storeId, categoryId);
+  }
+
+  async replaceStoreCategories(
+    storeId: bigint,
+    categoryIdsRaw: string[],
+    priorities?: Record<string, number>,
+  ) {
+    if (!categoryIdsRaw?.length) {
+      throw new BadRequestException('请至少选择一个门店分类');
+    }
+    const parsed = parseUniqueCategoryIds(categoryIdsRaw);
+    if (!parsed.length) {
+      throw new BadRequestException('请至少选择一个门店分类');
+    }
+    for (const id of parsed) {
+      await this.storeCategoryService.assertLeafCategoryId(id);
+    }
+    const sorted = [...parsed].sort((a, b) => {
+      const pa = priorities?.[a.toString()] ?? 0;
+      const pb = priorities?.[b.toString()] ?? 0;
+      if (pa !== pb) return pa - pb;
+      return Number(a - b);
+    });
+    const store = await this.prisma.store.findUnique({ where: { id: storeId } });
+    if (!store) throw new NotFoundException('门店不存在');
+    await this.prisma.$transaction(async (tx) => {
+      await syncStoreCategoryLinks(tx, storeId, sorted);
+    });
+    return this.getStoreCategories(storeId);
+  }
+
+  async partnerReplaceStoreCategories(
+    partnerAccountId: bigint,
+    storeId: bigint,
+    categoryIds: string[],
+    priorities?: Record<string, number>,
+  ) {
+    await this.partnerGetStore(partnerAccountId, storeId);
+    return this.replaceStoreCategories(storeId, categoryIds, priorities);
+  }
 }

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

@@ -14,6 +14,7 @@ import {
   orderTabToStatuses,
   toMinSaleQuantity,
   validateMinPurchase,
+  validateShippingAddress,
 } from '@dukang/domain';
 import { loadAppConfig, ClientApp, WECHAT_AUTH_REQUIRED } from '@dukang/shared-types';
 import { PrismaService } from '../../common/prisma/prisma.module';
@@ -155,6 +156,19 @@ export class TradeService {
           addressMessage = '该规格不支持跨城配送，请更换为开城城市内的收货地址';
         }
       }
+
+      if (addressOk && body.addressId) {
+        const address = await this.prisma.userAddress.findFirst({
+          where: { id: BigInt(body.addressId), userId },
+        });
+        if (address) {
+          const shipping = validateShippingAddress(address);
+          if (!shipping.ok) {
+            addressOk = false;
+            addressMessage = shipping.message || '请完善收货地址（需具体区县）';
+          }
+        }
+      }
     }
 
     const bottlesPerUnit = sale.bottlesPerUnit > 0 ? sale.bottlesPerUnit : 1;
@@ -276,6 +290,10 @@ export class TradeService {
         where: { id: BigInt(body.addressId), userId },
       });
       if (!address) throw new BadRequestException('请选择收货地址');
+      const shipping = validateShippingAddress(address);
+      if (!shipping.ok) {
+        throw new BadRequestException(shipping.message || '请完善收货地址（需具体区县）');
+      }
       receiverName = address.receiverName;
       receiverPhone = address.phone;
       receiverAddress = `${address.province}${address.city}${address.district}${address.detail}`;
@@ -1866,6 +1884,15 @@ export class TradeService {
       if (!body.addressDetail?.trim()) {
         throw new BadRequestException('请填写详细地址');
       }
+      const shipping = validateShippingAddress({
+        province: receiverProvince,
+        city: receiverCity,
+        district: receiverDistrict,
+        detail: body.addressDetail,
+      });
+      if (!shipping.ok) {
+        throw new BadRequestException(shipping.message || '请完善收货地址（需具体区县）');
+      }
       receiverAddress = `${receiverProvince}${receiverCity}${receiverDistrict}${body.addressDetail.trim()}`;
     }
 
@@ -2281,6 +2308,15 @@ export class TradeService {
       if (!body.addressDetail?.trim()) {
         throw new BadRequestException('请填写详细地址');
       }
+      const shipping = validateShippingAddress({
+        province: receiverProvince,
+        city: receiverCity,
+        district: receiverDistrict,
+        detail: body.addressDetail,
+      });
+      if (!shipping.ok) {
+        throw new BadRequestException(shipping.message || '请完善收货地址（需具体区县）');
+      }
       receiverAddress = `${receiverProvince}${receiverCity}${receiverDistrict}${body.addressDetail.trim()}`;
     }