Merge pull request 'Dev' (#65) from dev into main

Reviewed-on: https://git.yqidian.com/jacy/dukang/pulls/65

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/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';
@@ -50,6 +51,7 @@ const STATUS_COLOR: Record<DevPlanTaskStatusDto, string> = {
   IN_PROGRESS: 'orange',
   DEVELOPED: 'blue',
   RELEASED: 'green',
+  STOPPED: 'red',
 };
 
 const DEFAULT_DISPATCH_SUPPLEMENT = '请按以下任务进入开发流程';
@@ -61,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);
@@ -171,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) {
@@ -223,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: '任务号',
@@ -284,6 +285,7 @@ export default function DevPlanTasksPage() {
     },
     {
       title: '附件',
+      key: 'attachmentUrls',
       width: 100,
       render: (_, row) =>
         row.attachmentUrls?.length ? (
@@ -313,6 +315,7 @@ export default function DevPlanTasksPage() {
     },
     {
       title: '关联版本',
+      key: 'versions',
       dataIndex: 'versions',
       width: 140,
       render: (_, row) =>
@@ -346,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>
@@ -540,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

@@ -36,6 +36,7 @@ const STATUS_COLOR: Record<DevPlanVersionStatusDto, string> = {
   IN_PROGRESS: 'processing',
   TESTING: 'purple',
   RELEASED: 'green',
+  STOPPED: 'red',
 };
 
 function formatDuration(minutes?: number | null) {
@@ -56,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]);
 
@@ -189,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: '订单数', key: '订单数', dataIndex: 'orderCount', width: 80 },
-    { title: '瓶数', dataIndex: 'bottleCount', 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,7 +716,7 @@ export default function OrdersPage() {
     },
     {
       title: '商品',
-      key: 'productName',
+      key: '商品',
       width: 180,
       render: (_, row) => (
         <Space size={4} wrap>
@@ -726,12 +730,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 +745,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 +761,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 +836,7 @@ export default function OrdersPage() {
     },
   ];
 
-  const { columns, settingsButton, settingsModal } = useAdminListColumns('orders', baseColumns, {
+  const { columns, settingsButton, settingsModal, exportColumnKeys } = useAdminListColumns('orders', baseColumns, {
     page,
     pageSize,
   });

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;
@@ -103,7 +107,13 @@ function partnerDashLabel(p?: {
   return company || person || (p.phone || '').trim() || '—';
 }
 
+function weekMonday(d: Dayjs) {
+  const wd = d.day();
+  return d.subtract(wd === 0 ? 6 : wd - 1, 'day').startOf('day');
+}
+
 export default function PartnerBillsPage() {
+  const navigate = useNavigate();
   const [form] = Form.useForm();
   const [filters, setFilters] = useState<Record<string, string>>({});
   const [partners, setPartners] = useState<PartnerOption[]>([]);
@@ -113,8 +123,7 @@ export default function PartnerBillsPage() {
       const qs = new URLSearchParams();
       if (filters.status) qs.set('status', filters.status);
       if (filters.partnerId) qs.set('partnerId', filters.partnerId);
-      if (filters.year) qs.set('year', filters.year);
+      if (filters.weekStartYmd) qs.set('weekStartYmd', filters.weekStartYmd);
-      if (filters.month) qs.set('month', filters.month);
       return qs;
     },
     [filters],
@@ -136,19 +145,18 @@ export default function PartnerBillsPage() {
       .catch(() => {});
   }, []);
 
-  async function generateBill(values: { partnerId?: string; month: Dayjs }) {
+  async function generateBill(values: { partnerId?: string; week: Dayjs }) {
-    const year = values.month.year();
+    const weekStartYmd = weekMonday(values.week).format('YYYY-MM-DD');
-    const month = values.month.month() + 1;
     if (!values.partnerId) {
       const result = await request<{ success: number; failed: number; total: number }>(
         '/admin/partner-bills/generate-all',
-        { method: 'POST', body: JSON.stringify({ year, month }) },
+        { method: 'POST', body: JSON.stringify({ weekStartYmd }) },
       );
       message.success(`已生成 ${result.success}/${result.total} 份账单${result.failed ? `，失败 ${result.failed}` : ''}`);
     } else {
       await request('/admin/partner-bills/generate', {
         method: 'POST',
-        body: JSON.stringify({ partnerId: values.partnerId, year, month }),
+        body: JSON.stringify({ partnerId: values.partnerId, weekStartYmd }),
       });
       message.success('账单已生成（待审核）');
     }
@@ -259,10 +267,10 @@ export default function PartnerBillsPage() {
       const qs = new URLSearchParams();
       if (filters.status) qs.set('status', filters.status);
       if (filters.partnerId) qs.set('partnerId', filters.partnerId);
-      if (filters.year) qs.set('year', filters.year);
+      if (filters.weekStartYmd) qs.set('weekStartYmd', filters.weekStartYmd);
-      if (filters.month) qs.set('month', filters.month);
+      appendExportColumns(qs, exportColumnKeys);
       const result = await request<{ csv: string; count: number }>(`/admin/partner-bills/export?${qs}`);
-      const suffix = filters.year && filters.month ? `${filters.year}-${filters.month}` : 'all';
+      const suffix = filters.weekStartYmd || 'all';
       downloadExcelCsv(result.csv, `合伙人账单_${suffix}.csv`);
       message.success(`已导出 ${result.count} 条`);
     } finally {
@@ -274,13 +282,16 @@ export default function PartnerBillsPage() {
   const partnerName = (r: Row) => partnerDashLabel(r.partnerAccount ?? r.partner);
   const partnerBank = (r: Row) => r.partnerAccount ?? r.partner;
   const selectedRows = (data?.items ?? []).filter((r) => selectedKeys.includes(r.id));
-  const canSend = selectedRows.filter((r) => r.status === 'PENDING_REVIEW' || r.status === 'REJECTED');
+  const canSend = selectedRows.filter(
+    (r) => (r.status === 'PENDING_REVIEW' || r.status === 'REJECTED') && Number(r.totalAmount) > 0,
+  );
   const canPay = selectedRows.filter((r) => r.status === 'UNPAID');
   const payAmount = canPay.reduce((s, r) => s + Number(r.totalAmount), 0);
 
   const baseColumns: ColumnsType<Row> = [
     {
       title: '账单号',
+      key: '账单号',
       dataIndex: 'billNo',
       width: 180,
       render: (v, row) => (
@@ -289,45 +300,65 @@ 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: 110,
+      width: 130,
-      render: (v) => `¥${Number(v).toFixed(2)}`,
+      render: (v) =>
+        Number(v) <= 0 ? '¥0.00（不同步）' : `¥${Number(v).toFixed(2)}`,
     },
     {
       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) => (
@@ -350,7 +381,7 @@ export default function PartnerBillsPage() {
           <Button type="link" size="small" onClick={() => void openDetail(row.id)}>
             明细
           </Button>
-          {(row.status === 'PENDING_REVIEW' || row.status === 'REJECTED') && (
+          {(row.status === 'PENDING_REVIEW' || row.status === 'REJECTED') && Number(row.totalAmount) > 0 && (
             <Button type="link" size="small" onClick={() => sendBills([row.id])}>
               发送
             </Button>
@@ -375,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>
@@ -383,7 +414,7 @@ export default function PartnerBillsPage() {
       <AdminListHeader
         title="合伙人账单"
         settings={settingsButton}
-        description="每月 1 日 8:00 自动生成上月账单（待审核）→ 发送合伙人确认 → 未打款 → 已打款"
+        description="每周一 8:00 自动生成上周账单（待审核）→ 发送合伙人确认 → 未打款 → 已打款。零元账单不同步给合伙人。"
       />
 
       {summary && (
@@ -401,12 +432,11 @@ export default function PartnerBillsPage() {
         form={form}
         layout="inline"
         style={{ marginBottom: 16 }}
-        onFinish={(v: { partnerId?: string; status?: string; month?: Dayjs }) => {
+        onFinish={(v: { partnerId?: string; status?: string; week?: Dayjs }) => {
           setFilters({
             partnerId: v.partnerId || '',
             status: v.status || '',
-            year: v.month ? String(v.month.year()) : '',
+            weekStartYmd: v.week ? weekMonday(v.week).format('YYYY-MM-DD') : '',
-            month: v.month ? String(v.month.month() + 1) : '',
           });
           setPage(1);
         }}
@@ -424,8 +454,8 @@ export default function PartnerBillsPage() {
             }))}
           />
         </Form.Item>
-        <Form.Item name="month" label="账期月">
+        <Form.Item name="week" label="账期周">
-          <DatePicker picker="month" />
+          <DatePicker picker="week" />
         </Form.Item>
         <Form.Item name="status" label="状态">
           <Select
@@ -503,11 +533,11 @@ export default function PartnerBillsPage() {
         <Form
           form={genForm}
           layout="vertical"
-          initialValues={{ month: dayjs().subtract(1, 'month') }}
+          initialValues={{ week: weekMonday(dayjs().subtract(1, 'week')) }}
           onFinish={generateBill}
         >
-          <Form.Item name="month" label="账单月份" rules={[{ required: true }]}>
+          <Form.Item name="week" label="账单周（选任意一天，按周一起算）" rules={[{ required: true }]}>
-            <DatePicker picker="month" style={{ width: '100%' }} />
+            <DatePicker picker="week" style={{ width: '100%' }} />
           </Form.Item>
           <Form.Item name="partnerId" label="指定合伙人（留空则全部主合伙人）">
             <Select
@@ -568,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>
@@ -606,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: (
-    { title: '城市', dataIndex: ['store', 'cityName'], width: 90 },
+        <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 categoryLeafOptions = useMemo(() => {
-  const editCategoryParentId = Form.useWatch('categoryParentId', editForm);
+    const options: { value: string; label: string }[] = [];
-
+    for (const parent of categoryTree) {
-  const categoryParentOptions = useMemo(
+      if (parent.status === 'INACTIVE') continue;
-    () =>
+      for (const child of parent.children ?? []) {
-      categoryTree
+        if (child.status === 'INACTIVE') continue;
-        .filter((n) => n.status !== 'INACTIVE')
+        options.push({ value: child.id, label: `${parent.name} / ${child.name}` });
-        .map((n) => ({ value: n.id, label: n.name })),
+      }
-    [categoryTree],
+    }
-  );
+    return options;
-  const categoryChildOptions = useMemo(() => {
+  }, [categoryTree]);
-    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]);
 
   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;
+    const categories = Array.isArray(d.categories)
-    let parentId = category?.parentId != null ? String(category.parentId) : undefined;
+      ? (d.categories as { id?: string }[])
-    if (!parentId && categoryId) {
+      : [];
-      for (const parent of cats) {
+    const categoryIds = categories.length
-        if (parent.id === categoryId) {
+      ? categories.map((c) => String(c.id)).filter(Boolean)
-          parentId = parent.id;
+      : category?.id != null
-          break;
+        ? [String(category.id)]
-        }
+        : [];
-        if ((parent.children ?? []).some((c) => c.id === categoryId)) {
-          parentId = parent.id;
-          break;
-        }
-      }
-    }
     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,
+      categoryIds,
-      categoryId,
       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',
+          'categoryIds',
-          'categoryId',
           '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,
+      width: 140,
-      render: (_, row) => row.category?.name || '—',
+      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"
+                        name="categoryIds"
-                        label="门店分类（大类）"
+                        label="门店分类（细类，可多选）"
-                        rules={[{ required: true, message: '请选择门店大类' }]}
+                        rules={[{ required: true, message: '请至少选择一个门店细类' }]}
                       >
                         <Select
+                          mode="multiple"
                           showSearch
                           loading={optionsLoading}
                           optionFilterProp="label"
-                          options={categoryParentOptions}
+                          placeholder="选择细类，可多选"
-                          onChange={() => editForm.setFieldValue('categoryId', undefined)}
+                          options={categoryLeafOptions}
-                        />
-                      </Form.Item>
-                      <Form.Item
-                        name="categoryId"
-                        label="门店分类（细类）"
-                        rules={[{ required: true, message: '请选择门店细类' }]}
-                      >
-                        <Select
-                          showSearch
-                          optionFilterProp="label"
-                          placeholder={editCategoryParentId ? '选择细类' : '请先选大类'}
-                          disabled={!editCategoryParentId}
-                          options={editCategoryChildOptions}
                         />
                       </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"
+                name="categoryIds"
-                label="门店分类（大类）"
+                label="门店分类（细类，可多选）"
-                rules={[{ required: true, message: '请选择门店大类' }]}
+                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: '请选择门店细类' }]}
                 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 ? '选择细类' : '请先选大类'}
+                  placeholder={optionsLoading ? '加载中…' : '选择细类，可多选'}
-                  disabled={!selectedCategoryParentId}
+                  options={categoryLeafOptions}
-                  options={categoryChildOptions}
                 />
               </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/h5-partner/src/PartnerAppRoutes.tsx

@@ -26,6 +26,7 @@ import UsersManagePage from './pages/UsersManagePage';
 import AssocOrdersPage from './pages/AssocOrdersPage';
 import CommissionOrdersPage from './pages/CommissionOrdersPage';
 import ActivityPostersPage from './pages/ActivityPostersPage';
+import BankAccountPage from './pages/BankAccountPage';
 
 function PrimaryRoutes() {
   return (
@@ -42,6 +43,7 @@ function PrimaryRoutes() {
       <Route path="/center/settlement" element={<SettlementPage />} />
       <Route path="/center/staff" element={<StaffListPage />} />
       <Route path="/center/staff/new" element={<StaffCreatePage />} />
+      <Route path="/center/bank" element={<BankAccountPage />} />
       <Route path="/center/activity-posters" element={<ActivityPostersPage />} />
       <Route path="/center/assoc" element={<Navigate to="/users" replace />} />
       <Route path="/center/assoc/users" element={<Navigate to="/users" replace />} />
@@ -71,6 +73,7 @@ function SubAccountRoutes() {
     <Routes>
       <Route element={<SubAccountLayout navKind={navKind} />}>
         <Route path="/" element={<HomePage />} />
+        <Route path="/users" element={<UsersManagePage />} />
         {isWarehouse ? (
           <Route path="/orders" element={<OrderListPage tabRoot />} />
         ) : (
@@ -86,6 +89,7 @@ function SubAccountRoutes() {
         </>
       )}
       <Route path="/leaderboard" element={<LeaderboardPage />} />
+      <Route path="/users/:userId/orders" element={<AssocOrdersPage />} />
       {isWarehouse && <Route path="/orders/:id" element={<OrderDetailPage />} />}
       <Route path="*" element={<Navigate to="/" replace />} />
     </Routes>

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

@@ -11,6 +11,7 @@ import {
   saveActivityPosterSelection,
 } from '../lib/activity-posters';
 import { toastError, toastSuccess } from '../lib/toast';
+import { blobToDataUrl, isHttpImageUrl, previewSaveableImage } from '../lib/wechat-save-image';
 import { isWechatEnv } from '../lib/weixin';
 
 const NONE_ID = 'none';
@@ -98,11 +99,13 @@ export default function ActivityPosterPicker({ initialId }: Props) {
     setDownloading(true);
     try {
       if (selectedId === NONE_ID) {
+        if (isWechatEnv() && isHttpImageUrl(qrcodeUrl)) {
+          await previewSaveableImage(qrcodeUrl);
+          return;
+        }
         const blob = await fetchAssocQrcodeImage();
         if (isWechatEnv()) {
-          const url = URL.createObjectURL(blob);
+          setQrcodeUrl(await blobToDataUrl(blob));
-          urlsRef.current.push(url);
-          setQrcodeUrl(url);
           toastSuccess('请长按上方图片保存到相册');
           return;
         }
@@ -118,9 +121,8 @@ export default function ActivityPosterPicker({ initialId }: Props) {
       }
       if (isWechatEnv()) {
         let url = previewUrls[selected.id];
-        if (!url) {
+        if (!url || url.startsWith('blob:')) {
-          url = URL.createObjectURL(blob);
+          url = await blobToDataUrl(blob);
-          urlsRef.current.push(url);
           setPreviewUrls((prev) => ({ ...prev, [selected.id]: url }));
         }
         toastSuccess('请长按上方图片保存到相册');
@@ -172,7 +174,7 @@ export default function ActivityPosterPicker({ initialId }: Props) {
           <div className="partner-activity-panel">
             {qrcodeUrl ? (
               <div className="partner-activity-preview partner-activity-preview--qr">
-                <img src={qrcodeUrl} alt="关联码" />
+                <img className="partner-longpress-img" src={qrcodeUrl} alt="关联码" />
               </div>
             ) : (
               <p className="body-md text-muted" style={{ marginBottom: 12 }}>关联码尚未生成</p>
@@ -200,7 +202,7 @@ export default function ActivityPosterPicker({ initialId }: Props) {
           {selectedId === item.id && (
             <div className="partner-activity-panel">
               <div className="partner-activity-preview">
-                <img src={previewUrl || item.imageUrl} alt={item.title} />
+                <img className="partner-longpress-img" src={previewUrl || item.imageUrl} alt={item.title} />
                 {previewLoading && !previewUrl && (
                   <div className="partner-activity-preview-mask">正在贴入二维码…</div>
                 )}

apps/h5-partner/src/layouts/SubAccountLayout.tsx

@@ -3,12 +3,14 @@ import type { PartnerNavKind } from '../lib/partnerAccess';
 
 const STORE_STAFF_TABS = [
   { to: '/', end: true, icon: 'dashboard', label: '首页' },
+  { to: '/users', icon: 'group', label: '用户管理' },
   { to: '/stores', icon: 'store', label: '门店管理' },
   { to: '/me', icon: 'person', label: '个人中心' },
 ] as const;
 
 const WAREHOUSE_STAFF_TABS = [
   { to: '/', end: true, icon: 'dashboard', label: '首页' },
+  { to: '/users', icon: 'group', label: '用户管理' },
   { to: '/orders', icon: 'receipt_long', label: '订单管理' },
   { to: '/me', icon: 'person', label: '个人中心' },
 ] as const;

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

@@ -94,8 +94,8 @@ export function partnerHomePath(account: PartnerMe | null | undefined): string {
   return '/';
 }
 
-const STORE_STAFF_PREFIXES = ['/', '/stores', '/me', '/leaderboard', '/login'];
+const STORE_STAFF_PREFIXES = ['/', '/stores', '/users', '/me', '/leaderboard', '/login'];
-const WAREHOUSE_STAFF_PREFIXES = ['/', '/orders', '/me', '/leaderboard', '/login'];
+const WAREHOUSE_STAFF_PREFIXES = ['/', '/orders', '/users', '/me', '/leaderboard', '/login'];
 
 export function isSubAccountPath(pathname: string, navKind: PartnerNavKind = 'store_staff'): boolean {
   if (pathname === '/login') return true;

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

@@ -0,0 +1,16 @@
+import type { PartnerSettlementPreviewDto } from '@dukang/shared-types';
+
+export function formatBillPeriod(start?: string | null, end?: string | null) {
+  const s = String(start || '').slice(0, 10);
+  const e = String(end || '').slice(0, 10);
+  if (!s) return '—';
+  if (!e || e === s) return s;
+  return `${s} ~ ${e}`;
+}
+
+export function formatIssueLabel(preview: Pick<PartnerSettlementPreviewDto, 'nextIssueAt' | 'cycleLabel'> | null) {
+  if (!preview?.nextIssueAt) return preview?.cycleLabel || '每周一 08:00 出账';
+  const ymd = new Date(preview.nextIssueAt).toLocaleDateString('sv-SE', { timeZone: 'Asia/Shanghai' });
+  if (!ymd || ymd === 'Invalid Date') return preview.cycleLabel || '每周一 08:00 出账';
+  return `${ymd} 08:00 出账`;
+}

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/lib/wechat-save-image.ts

@@ -0,0 +1,31 @@
+import { isHttpImageUrl } from '@dukang/weixin-sdk';
+import { toastSuccess } from './toast';
+import { isWechatEnv, weixinSdk } from './weixin';
+
+export { isHttpImageUrl };
+
+export function blobToDataUrl(blob: Blob): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = () => resolve(String(reader.result || ''));
+    reader.onerror = () => reject(new Error('读取图片失败'));
+    reader.readAsDataURL(blob);
+  });
+}
+
+/**
+ * 微信内用 previewImage 打开可公网访问的图片，用户长按即可保存。
+ * blob / data URL 不能走该接口。
+ */
+export async function previewSaveableImage(url: string): Promise<boolean> {
+  const href = url.trim();
+  if (!isWechatEnv() || !isHttpImageUrl(href)) return false;
+  try {
+    await weixinSdk.previewImage(href);
+    toastSuccess('请长按图片保存到相册');
+    return true;
+  } catch {
+    toastSuccess('请长按上方图片保存到相册');
+    return false;
+  }
+}

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

@@ -4,6 +4,7 @@ import PageHeader from '@dukang/shared-ui/PageHeader';
 import type { PartnerAssocSummary } from '@dukang/shared-types';
 import { request } from '../lib/api';
 import { toastError, toastSuccess } from '../lib/toast';
+import { isHttpImageUrl, previewSaveableImage } from '../lib/wechat-save-image';
 import { isWechatEnv } from '../lib/weixin';
 import { usePartnerPageView } from '../lib/usePageView';
 
@@ -11,7 +12,6 @@ export default function AssocQrcodePage() {
   usePartnerPageView('partner_assoc_qrcode_view');
   const navigate = useNavigate();
   const [summary, setSummary] = useState<PartnerAssocSummary | null>(null);
-  const [previewUrl, setPreviewUrl] = useState<string | null>(null);
   const [loading, setLoading] = useState(true);
 
   useEffect(() => {
@@ -21,11 +21,12 @@ export default function AssocQrcodePage() {
       .finally(() => setLoading(false));
   }, []);
 
-  useEffect(() => () => {
-    if (previewUrl) URL.revokeObjectURL(previewUrl);
-  }, [previewUrl]);
-
   async function downloadQr() {
+    const publicUrl = summary?.qrcodeUrl;
+    if (isWechatEnv() && isHttpImageUrl(publicUrl)) {
+      await previewSaveableImage(publicUrl);
+      return;
+    }
     const token = localStorage.getItem('accessToken');
     try {
       const res = await fetch('/api/v1/partner/assoc/qrcode', {
@@ -37,11 +38,6 @@ export default function AssocQrcodePage() {
       if (!res.ok) throw new Error('下载失败');
       const blob = await res.blob();
       const url = URL.createObjectURL(blob);
-      if (isWechatEnv()) {
-        setPreviewUrl(url);
-        toastSuccess('请长按图片保存到相册');
-        return;
-      }
       const a = document.createElement('a');
       a.href = url;
       a.download = `partner-assoc-${summary?.partnerId || 'qr'}.png`;
@@ -49,9 +45,8 @@ export default function AssocQrcodePage() {
       URL.revokeObjectURL(url);
       toastSuccess('已开始下载');
     } catch (e) {
-      if (summary?.qrcodeUrl) {
+      if (isWechatEnv() && isHttpImageUrl(publicUrl)) {
-        setPreviewUrl(summary.qrcodeUrl);
+        await previewSaveableImage(publicUrl);
-        toastSuccess('请长按图片保存到相册');
         return;
       }
       toastError(e instanceof Error ? e.message : '下载失败');
@@ -70,7 +65,8 @@ export default function AssocQrcodePage() {
             </p>
             {summary?.qrcodeUrl ? (
               <img
-                src={previewUrl || summary.qrcodeUrl}
+                className="partner-longpress-img"
+                src={summary.qrcodeUrl}
                 alt="关联码"
                 style={{ width: 220, height: 220, background: '#fff' }}
               />
@@ -83,11 +79,11 @@ export default function AssocQrcodePage() {
             <button type="button" className="partner-btn-primary" style={{ marginTop: 20 }} onClick={() => void downloadQr()}>
               下载二维码
             </button>
-            {previewUrl && isWechatEnv() && (
+            {isWechatEnv() && summary?.qrcodeUrl ? (
               <p className="label-md text-muted" style={{ marginTop: 12 }}>
-                微信内请长按上方图片保存
+                微信内请点「下载二维码」后长按保存
               </p>
-            )}
+            ) : null}
           </div>
         </section>
       )}

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

@@ -0,0 +1,141 @@
+import { useEffect, useState } from 'react';
+import { useNavigate } from 'react-router-dom';
+import PageHeader from '@dukang/shared-ui/PageHeader';
+import type { PartnerMe, UpdatePartnerBankRequest } from '@dukang/shared-types';
+import { request } from '../lib/api';
+import { usePartnerSession } from '../contexts/PartnerSessionContext';
+import { toastError, toastSuccess } from '../lib/toast';
+
+type FieldErrors = {
+  bankAccountName?: string;
+  bankAccountNo?: string;
+  bankBranch?: string;
+};
+
+export default function BankAccountPage() {
+  const navigate = useNavigate();
+  const { account, refresh } = usePartnerSession();
+  const [bankAccountName, setBankAccountName] = useState(account?.bankAccount?.bankAccountName ?? '');
+  const [bankAccountNo, setBankAccountNo] = useState(account?.bankAccount?.bankAccountNo ?? '');
+  const [bankBranch, setBankBranch] = useState(account?.bankAccount?.bankBranch ?? '');
+  const [submitting, setSubmitting] = useState(false);
+  const [fieldErrors, setFieldErrors] = useState<FieldErrors>({});
+
+  useEffect(() => {
+    document.title = '收款账户';
+  }, []);
+
+  useEffect(() => {
+    setBankAccountName(account?.bankAccount?.bankAccountName ?? '');
+    setBankAccountNo(account?.bankAccount?.bankAccountNo ?? '');
+    setBankBranch(account?.bankAccount?.bankBranch ?? '');
+  }, [account?.bankAccount]);
+
+  async function submit() {
+    const name = bankAccountName.trim();
+    const no = bankAccountNo.replace(/\s+/g, '');
+    const branch = bankBranch.trim();
+    const next: FieldErrors = {};
+    if (!name) next.bankAccountName = '请填写收款人';
+    if (!/^\d{8,32}$/.test(no)) next.bankAccountNo = '请填写 8～32 位数字账号';
+    if (!branch) next.bankBranch = '请填写开户行名称';
+    setFieldErrors(next);
+    if (Object.keys(next).length) return;
+
+    setSubmitting(true);
+    try {
+      const body: UpdatePartnerBankRequest = {
+        bankAccountName: name,
+        bankAccountNo: no,
+        bankBranch: branch,
+      };
+      await request<PartnerMe>('PARTNER_H5', '/partner/me/bank', {
+        method: 'PUT',
+        body: JSON.stringify(body),
+      });
+      await refresh();
+      toastSuccess('收款账户已保存');
+      navigate('/center');
+    } catch (e) {
+      toastError(e instanceof Error ? e.message : '保存失败');
+    } finally {
+      setSubmitting(false);
+    }
+  }
+
+  return (
+    <div className="partner-page-sticky">
+      <PageHeader title="收款账户" onBack={() => navigate('/center')} />
+
+      <section className="partner-form-card">
+        <div className="partner-section-title">
+          <div className="partner-section-bar" />
+          <h2 className="headline-md">银行账号</h2>
+        </div>
+        <p className="label-md text-muted" style={{ marginBottom: 16, lineHeight: 1.5 }}>
+          用于总部打款。请填写与合同一致的对公或对私账户。
+        </p>
+
+        <div className="partner-field">
+          <label>收款人 <span className="text-primary">*</span></label>
+          <div className="partner-field-input">
+            <span className="material-symbols-outlined">person</span>
+            <input
+              placeholder="户名 / 收款人姓名"
+              value={bankAccountName}
+              maxLength={64}
+              onChange={(e) => setBankAccountName(e.target.value)}
+            />
+          </div>
+          {fieldErrors.bankAccountName && (
+            <p className="partner-field-error" role="alert">{fieldErrors.bankAccountName}</p>
+          )}
+        </div>
+
+        <div className="partner-field">
+          <label>银行账号 <span className="text-primary">*</span></label>
+          <div className="partner-field-input">
+            <span className="material-symbols-outlined">credit_card</span>
+            <input
+              inputMode="numeric"
+              placeholder="请输入银行账号"
+              value={bankAccountNo}
+              maxLength={32}
+              onChange={(e) => setBankAccountNo(e.target.value.replace(/[^\d]/g, ''))}
+            />
+          </div>
+          {fieldErrors.bankAccountNo && (
+            <p className="partner-field-error" role="alert">{fieldErrors.bankAccountNo}</p>
+          )}
+        </div>
+
+        <div className="partner-field">
+          <label>开户行名称 <span className="text-primary">*</span></label>
+          <div className="partner-field-input">
+            <span className="material-symbols-outlined">account_balance</span>
+            <input
+              placeholder="如 中国工商银行洛阳分行"
+              value={bankBranch}
+              maxLength={128}
+              onChange={(e) => setBankBranch(e.target.value)}
+            />
+          </div>
+          {fieldErrors.bankBranch && (
+            <p className="partner-field-error" role="alert">{fieldErrors.bankBranch}</p>
+          )}
+        </div>
+      </section>
+
+      <footer className="partner-sticky-footer">
+        <button
+          type="button"
+          className="partner-btn-primary"
+          disabled={submitting}
+          onClick={() => void submit()}
+        >
+          {submitting ? '保存中…' : '保存'}
+        </button>
+      </footer>
+    </div>
+  );
+}

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

@@ -4,6 +4,7 @@ import PageHeader from '@dukang/shared-ui/PageHeader';
 import PullToRefresh from '@dukang/shared-ui/PullToRefresh';
 import type { PartnerBillDetailDto, PartnerBillDto, PartnerBillItemDto } from '@dukang/shared-types';
 import { isLoggedIn, request } from '../lib/api';
+import { formatBillPeriod } from '../lib/settlement';
 import { toastError, toastSuccess } from '../lib/toast';
 import { usePartnerPageView } from '../lib/usePageView';
 
@@ -188,7 +189,8 @@ export default function BillsPage() {
             <div style={{ display: 'flex', justifyContent: 'space-between', alignItems: 'flex-start', marginBottom: 24 }}>
               <div>
                 <p className="label-md text-muted" style={{ textTransform: 'uppercase', letterSpacing: '0.1em', marginBottom: 4 }}>SETTLEMENT PERIOD</p>
-                <h2 className="headline-lg" style={{ fontSize: 20 }}>{String(bill.billNo || '月度结算账单')}</h2>
+                <h2 className="headline-lg" style={{ fontSize: 20 }}>{String(bill.billNo || '周结算账单')}</h2>
+                <p className="label-md text-muted" style={{ marginTop: 4 }}>{formatBillPeriod(bill.periodStart, bill.periodEnd)}</p>
               </div>
               <span className={`partner-status-pill${isRejected ? ' partner-status-pill--closed' : isUnpaid ? ' partner-status-pill--paused' : isPaid ? ' partner-status-pill--open' : ' partner-status-pill--paused'}`}>
                 {billStatusLabel(status)}
@@ -271,7 +273,7 @@ export default function BillsPage() {
                   <div className="partner-store-card-header" style={{ marginBottom: 0 }}>
                     <div>
                       <p className="body-md">{b.billNo}</p>
-                      <p className="label-md text-muted">{billStatusLabel(b.status)}</p>
+                      <p className="label-md text-muted">{formatBillPeriod(b.periodStart, b.periodEnd)} · {billStatusLabel(b.status)}</p>
                       {b.status === 'REJECTED' && b.rejectReason ? (
                         <p className="label-md text-primary" style={{ marginTop: 4 }}>驳回：{b.rejectReason}</p>
                       ) : null}

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

@@ -1,6 +1,6 @@
 import { useCallback, useEffect, useMemo, useState } from 'react';
 import { Link } from 'react-router-dom';
-import type { PartnerBillDto } from '@dukang/shared-types';
+import type { PartnerBillDto, PartnerSettlementPreviewDto } from '@dukang/shared-types';
 import { isWxAuthorizeEnabled } from '@dukang/shared-types';
 import PullToRefresh from '@dukang/shared-ui/PullToRefresh';
 import { request } from '../lib/api';
@@ -8,6 +8,7 @@ import { usePartnerSession } from '../contexts/PartnerSessionContext';
 import { contactSupport } from '../lib/contact';
 import { isPrimaryAccount } from '../lib/partnerAccess';
 import { listPartnerStaff } from '../lib/staff';
+import { formatBillPeriod, formatIssueLabel } from '../lib/settlement';
 import { toastError, toastSuccess } from '../lib/toast';
 import {
   authorizePartnerWechat,
@@ -31,6 +32,7 @@ export default function CenterPage({ variant = 'primary', roleLabel }: CenterPag
   const isPrimary = variant === 'primary' && isPrimaryAccount(account);
   const [authorizing, setAuthorizing] = useState(false);
   const [bills, setBills] = useState<PartnerBillDto[]>([]);
+  const [preview, setPreview] = useState<PartnerSettlementPreviewDto | null>(null);
   const [staffCount, setStaffCount] = useState(0);
 
   useEffect(() => {
@@ -44,6 +46,9 @@ export default function CenterPage({ variant = 'primary', roleLabel }: CenterPag
         request<PartnerBillDto[]>('PARTNER_H5', '/partner/settlement/bills')
           .then(setBills)
           .catch(() => setBills([])),
+        request<PartnerSettlementPreviewDto>('PARTNER_H5', '/partner/settlement/preview')
+          .then(setPreview)
+          .catch(() => setPreview(null)),
         listPartnerStaff()
           .then((list) => setStaffCount(list.length))
           .catch(() => setStaffCount(0)),
@@ -188,6 +193,15 @@ export default function CenterPage({ variant = 'primary', roleLabel }: CenterPag
                 <p className="partner-finance-hero-label">账户余额 (元)</p>
                 <p className="partner-finance-hero-amount">{fmtMoney(finance.balance)}</p>
               </div>
+              <div className="partner-finance-card">
+                <p className="label-md text-muted">预付款</p>
+                <p className="partner-finance-value text-primary">¥ {fmtMoney(preview?.prepaymentAmount ?? 0)}</p>
+                <p className="label-md text-muted" style={{ marginTop: 6, lineHeight: 1.4 }}>
+                  {formatBillPeriod(preview?.periodStart, preview?.periodEnd)}
+                  <br />
+                  {formatIssueLabel(preview)}
+                </p>
+              </div>
               <Link to="/center/settlement" className="partner-finance-card">
                 <p className="label-md text-muted">待结算</p>
                 <p className="partner-finance-value text-primary">¥ {fmtMoney(finance.pendingTotal)}</p>
@@ -219,6 +233,22 @@ export default function CenterPage({ variant = 'primary', roleLabel }: CenterPag
                   <span className="material-symbols-outlined text-muted">chevron_right</span>
                 </div>
               </Link>
+              <Link to="/center/bank" className="partner-menu-item">
+                <div className="partner-menu-item-left">
+                  <div className="partner-menu-icon">
+                    <span className="material-symbols-outlined">account_balance</span>
+                  </div>
+                  <span className="body-md" style={{ fontSize: 16 }}>收款账户</span>
+                </div>
+                <div className="partner-menu-item-right">
+                  {account?.bankAccount?.bankAccountNo ? (
+                    <span className="label-md text-muted">{account.bankAccount.bankAccountNo.slice(-4)}</span>
+                  ) : (
+                    <span className="partner-menu-status">未填写</span>
+                  )}
+                  <span className="material-symbols-outlined text-muted">chevron_right</span>
+                </div>
+              </Link>
               <Link to="/center/activity-posters" className="partner-menu-item">
                 <div className="partner-menu-item-left">
                   <div className="partner-menu-icon">

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

@@ -1,10 +1,11 @@
 import { useCallback, useEffect, useMemo, useState } from 'react';
 import { Link, useNavigate } from 'react-router-dom';
-import type { PartnerAssocStats, PartnerLeaderboardEntry } from '@dukang/shared-types';
+import type { PartnerAssocStats, PartnerLeaderboardEntry, PartnerSettlementPreviewDto } from '@dukang/shared-types';
 import PullToRefresh from '@dukang/shared-ui/PullToRefresh';
 import { usePartnerPageView } from '../lib/usePageView';
 import { isLoggedIn, request } from '../lib/api';
 import { fetchPartnerLeaderboard } from '../lib/leaderboard';
+import { formatBillPeriod, formatIssueLabel } from '../lib/settlement';
 import {
   canAccessPartnerDashboard,
   canAccessPartnerOrders,
@@ -154,6 +155,7 @@ export default function HomePage() {
   const [orders, setOrders] = useState<Array<Record<string, unknown>>>([]);
   const [leaderboardEntries, setLeaderboardEntries] = useState<PartnerLeaderboardEntry[]>([]);
   const [assocStats, setAssocStats] = useState<PartnerAssocStats | null>(null);
+  const [preview, setPreview] = useState<PartnerSettlementPreviewDto | null>(null);
 
   useEffect(() => {
     document.title = '工作台';
@@ -203,9 +205,13 @@ export default function HomePage() {
         request<PartnerAssocStats>('PARTNER_H5', '/partner/assoc/stats', { silent: true })
           .then(setAssocStats)
           .catch(() => setAssocStats(null)),
+        request<PartnerSettlementPreviewDto>('PARTNER_H5', '/partner/settlement/preview', { silent: true })
+          .then(setPreview)
+          .catch(() => setPreview(null)),
       );
     } else {
       setAssocStats(null);
+      setPreview(null);
     }
 
     tasks.push(
@@ -245,27 +251,20 @@ export default function HomePage() {
     ? Math.round(((monthNew - lastMonthNew) / lastMonthNew) * 100)
     : (monthNew > 0 ? 100 : 0);
 
-  const orderCount = Number(dash?.orderCount || orderStats.todayCount || 0);
-  const revenue = orderCount * 128.45;
-  const profit = revenue * 0.25;
-
   return (
     <PullToRefresh onRefresh={loadHome} className="page partner-home partner-home--flush-top">
       <main className="partner-home-body">
         {isPrimary && (
           <>
             <section className="partner-revenue-card">
-              <p className="partner-revenue-label">
+              <p className="partner-revenue-label">预付款金额 (CNY)</p>
-                实时营业额 (CNY)
+              <div className="partner-revenue-amount">{fmtMoney(preview?.prepaymentAmount ?? 0)}</div>
-                <span className="material-symbols-outlined" style={{ fontSize: 14 }}>info</span>
+              <p className="partner-revenue-label" style={{ marginTop: 8, opacity: 0.85, lineHeight: 1.5 }}>
+                账期 {formatBillPeriod(preview?.periodStart, preview?.periodEnd)} · {formatIssueLabel(preview)}
+              </p>
+              <p className="partner-revenue-label" style={{ marginTop: 6, opacity: 0.75 }}>
+                本周酒单与核销预估佣金，实际以账单为准
               </p>
-              <div className="partner-revenue-amount">{fmtMoney(revenue)}</div>
-              <div className="partner-revenue-grid">
-                <div>
-                  <p className="partner-revenue-label">预计利润</p>
-                  <p className="headline-md" style={{ color: '#fff', marginTop: 4 }}>¥ {fmtMoney(profit)}</p>
-                </div>
-              </div>
             </section>
             <section className="partner-bento-card" style={{ marginBottom: 16 }}>
               <div className="partner-quick-actions">

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

@@ -2,8 +2,9 @@ import { useCallback, useEffect, useMemo, useState } from 'react';
 import { useNavigate } from 'react-router-dom';
 import PageHeader from '@dukang/shared-ui/PageHeader';
 import PullToRefresh from '@dukang/shared-ui/PullToRefresh';
-import type { PartnerBillDto } from '@dukang/shared-types';
+import type { PartnerBillDto, PartnerSettlementPreviewDto } from '@dukang/shared-types';
 import { isLoggedIn, request } from '../lib/api';
+import { formatBillPeriod, formatIssueLabel } from '../lib/settlement';
 
 type StatusFilter = 'all' | 'pending' | 'settled' | 'reviewing' | 'rejected';
 
@@ -31,25 +32,23 @@ function billStatusClass(status: string) {
   }
 }
 
-function billPeriodLabel(periodStart: string) {
+function billPeriodLabel(bill: PartnerBillDto) {
-  const d = new Date(periodStart);
+  return formatBillPeriod(bill.periodStart, bill.periodEnd);
-  if (Number.isNaN(d.getTime())) return '—';
-  return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}`;
-}
-
-function billMonthLabel(year: number, month: number) {
-  return `${year}年${month}月`;
 }
 
 export default function SettlementPage() {
   const navigate = useNavigate();
   const [bills, setBills] = useState<PartnerBillDto[]>([]);
-  const now = new Date();
+  const [preview, setPreview] = useState<PartnerSettlementPreviewDto | null>(null);
-  const [month, setMonth] = useState({ year: now.getFullYear(), month: now.getMonth() + 1 });
   const [statusFilter, setStatusFilter] = useState<StatusFilter>('all');
 
   const loadBills = useCallback(() => {
-    return request<PartnerBillDto[]>('PARTNER_H5', '/partner/settlement/bills').then(setBills);
+    return Promise.all([
+      request<PartnerBillDto[]>('PARTNER_H5', '/partner/settlement/bills').then(setBills),
+      request<PartnerSettlementPreviewDto>('PARTNER_H5', '/partner/settlement/preview')
+        .then(setPreview)
+        .catch(() => setPreview(null)),
+    ]).then(() => undefined);
   }, []);
 
   useEffect(() => {
@@ -60,22 +59,14 @@ export default function SettlementPage() {
   const summary = useMemo(() => {
     const pending = bills.filter((b) => b.status === 'AWAITING_CONFIRM');
     const settled = bills.filter((b) => b.status === 'PAID');
-    const currentMonth = bills.filter((b) => {
-      const d = new Date(b.periodStart);
-      return d.getFullYear() === now.getFullYear() && d.getMonth() === now.getMonth();
-    });
     return {
       pendingTotal: pending.reduce((s, b) => s + Number(b.totalAmount || 0), 0),
       settledTotal: settled.reduce((s, b) => s + Number(b.totalAmount || 0), 0),
-      monthEstimate: currentMonth.reduce((s, b) => s + Number(b.totalAmount || 0), 0),
     };
-  }, [bills, now]);
+  }, [bills]);
 
   const filteredBills = useMemo(() => {
     return bills.filter((b) => {
-      const d = new Date(b.periodStart);
-      const matchMonth = d.getFullYear() === month.year && d.getMonth() + 1 === month.month;
-      if (!matchMonth) return false;
       if (statusFilter === 'all') return true;
       if (statusFilter === 'pending') return b.status === 'AWAITING_CONFIRM';
       if (statusFilter === 'settled') return b.status === 'PAID';
@@ -83,16 +74,7 @@ export default function SettlementPage() {
       if (statusFilter === 'rejected') return b.status === 'REJECTED';
       return true;
     });
-  }, [bills, month, statusFilter]);
+  }, [bills, statusFilter]);
-
-  const monthOptions = useMemo(() => {
-    const opts: Array<{ year: number; month: number }> = [];
-    for (let i = 0; i < 6; i++) {
-      const d = new Date(now.getFullYear(), now.getMonth() - i, 1);
-      opts.push({ year: d.getFullYear(), month: d.getMonth() + 1 });
-    }
-    return opts;
-  }, [now]);
 
   function openBill(bill: PartnerBillDto) {
     navigate(bill.id ? `/center/bills?id=${bill.id}` : '/center/bills');
@@ -127,33 +109,18 @@ export default function SettlementPage() {
             </div>
             <div className="partner-settlement-summary-divider" />
             <div>
-              <p className="partner-settlement-summary-sub">本月预估收益</p>
+              <p className="partner-settlement-summary-sub">本周预付款</p>
               <p className="partner-settlement-summary-value partner-settlement-summary-value--accent">
-                ¥{fmtMoney(summary.monthEstimate)}
+                ¥{fmtMoney(preview?.prepaymentAmount ?? 0)}
               </p>
             </div>
           </div>
         </section>
 
         <section className="partner-settlement-filters">
-          <select
+          <p className="label-md text-muted" style={{ margin: 0, lineHeight: 1.5 }}>
-            className="partner-settlement-month"
+            账期 {formatBillPeriod(preview?.periodStart, preview?.periodEnd)} · {formatIssueLabel(preview)}
-            value={`${month.year}-${month.month}`}
+          </p>
-            onChange={(e) => {
-              const [y, m] = e.target.value.split('-').map(Number);
-              setMonth({ year: y, month: m });
-            }}
-          >
-            {monthOptions.map((opt) => (
-              <option key={`${opt.year}-${opt.month}`} value={`${opt.year}-${opt.month}`}>
-                {billMonthLabel(opt.year, opt.month)}
-              </option>
-            ))}
-          </select>
-          <button type="button" className="partner-settlement-status-btn">
-            <span className="material-symbols-outlined">filter_list</span>
-            状态
-          </button>
         </section>
 
         <div className="partner-settlement-chips">
@@ -193,7 +160,7 @@ export default function SettlementPage() {
                   </div>
                   <p className="partner-settlement-item-meta">
                     <span className="material-symbols-outlined">event</span>
-                    {billPeriodLabel(bill.periodStart)}
+                    {billPeriodLabel(bill)}
                     <span className="partner-settlement-dot" />
                     订单分佣 ¥{fmtMoney(Number(bill.orderCommission || 0))}
                   </p>

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

@@ -205,7 +205,7 @@ export default function StaffCreatePage() {
           <span className="material-symbols-outlined">info</span>
         </div>
         <p className="label-md text-variant" style={{ marginTop: 0, lineHeight: 1.5 }}>
-          子账号创建后默认禁用，需在子账号列表中手动启用后方可登录。
+          子账号创建后默认可登录，可在子账号列表中禁用。
         </p>
       </div>
 

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>
+              <label>店铺类型 <span className="text-primary">*</span> <span className="label-md text-muted">（可多选）</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>
 
+              <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/h5-partner/src/pages/UsersManagePage.tsx

@@ -13,8 +13,11 @@ import {
   fetchAssocQrcodeImage,
 } from '../lib/activity-posters';
 import { toastError, toastSuccess } from '../lib/toast';
+import { blobToDataUrl, isHttpImageUrl, previewSaveableImage } from '../lib/wechat-save-image';
 import { isWechatEnv } from '../lib/weixin';
 import { usePartnerPageView } from '../lib/usePageView';
+import { usePartnerSession } from '../contexts/PartnerSessionContext';
+import { isSubAccount } from '../lib/partnerAccess';
 
 type ListRes = { items: PartnerAssocUserItem[]; total: number };
 
@@ -37,6 +40,8 @@ function fmtTime(iso?: string | null) {
 
 export default function UsersManagePage() {
   usePartnerPageView('partner_users_manage_view');
+  const { account } = usePartnerSession();
+  const hidePoster = isSubAccount(account);
   const navigate = useNavigate();
   const [searchParams] = useSearchParams();
   const [summary, setSummary] = useState<PartnerAssocSummary | null>(null);
@@ -58,11 +63,11 @@ export default function UsersManagePage() {
   }, []);
 
   useEffect(() => () => {
-    if (previewUrl) URL.revokeObjectURL(previewUrl);
+    if (previewUrl?.startsWith('blob:')) URL.revokeObjectURL(previewUrl);
   }, [previewUrl]);
 
   useEffect(() => {
-    const posterId = summary?.activityPosterId;
+    const posterId = hidePoster ? null : summary?.activityPosterId;
     if (!posterId) {
       setHeroUrl(null);
       setHeroLoading(false);
@@ -87,7 +92,7 @@ export default function UsersManagePage() {
       cancelled = true;
       if (acc.url) URL.revokeObjectURL(acc.url);
     };
-  }, [summary?.activityPosterId]);
+  }, [hidePoster, summary?.activityPosterId]);
 
   const loadSummary = useCallback(async () => {
     const data = await request<PartnerAssocSummary>('PARTNER_H5', '/partner/assoc');
@@ -129,14 +134,19 @@ export default function UsersManagePage() {
   }, [searchParams, navigate]);
 
   async function downloadMainImage() {
-    const posterId = summary?.activityPosterId;
+    const posterId = hidePoster ? null : summary?.activityPosterId;
     try {
+      if (isWechatEnv() && !posterId && isHttpImageUrl(summary?.qrcodeUrl)) {
+        await previewSaveableImage(summary.qrcodeUrl);
+        return;
+      }
       const blob = posterId
         ? await fetchActivityPosterImage(posterId)
         : await fetchAssocQrcodeImage();
       if (isWechatEnv()) {
-        setPreviewUrl(URL.createObjectURL(blob));
+        if (previewUrl?.startsWith('blob:')) URL.revokeObjectURL(previewUrl);
-        toastSuccess('请长按图片保存到相册');
+        setPreviewUrl(await blobToDataUrl(blob));
+        toastSuccess('请长按上方图片保存到相册');
         return;
       }
       downloadBlob(blob, posterId
@@ -144,7 +154,11 @@ export default function UsersManagePage() {
         : `partner-assoc-${summary?.partnerId || 'qr'}.png`);
       toastSuccess('已开始下载');
     } catch (e) {
-      if (!posterId && summary?.qrcodeUrl) {
+      if (!posterId && isHttpImageUrl(summary?.qrcodeUrl)) {
+        if (isWechatEnv()) {
+          await previewSaveableImage(summary.qrcodeUrl);
+          return;
+        }
         setPreviewUrl(summary.qrcodeUrl);
         toastSuccess('请长按图片保存到相册');
         return;
@@ -180,16 +194,18 @@ export default function UsersManagePage() {
           <p className="body-md text-muted" style={{ marginBottom: 12 }}>
             用户扫码后首次锁定，后续购酒计入关联订单
           </p>
-          {summary?.activityPosterId && (previewUrl || heroUrl) ? (
+          {summary?.activityPosterId && !hidePoster && (previewUrl || heroUrl) ? (
             <img
+              className="partner-longpress-img"
               src={previewUrl || heroUrl || ''}
               alt="活动图"
               style={{ width: '100%', maxWidth: 360, background: '#f5f5f5' }}
             />
-          ) : summary?.activityPosterId && heroLoading ? (
+          ) : summary?.activityPosterId && !hidePoster && heroLoading ? (
             <p className="body-md text-muted">正在生成活动图…</p>
           ) : previewUrl || summary?.qrcodeUrl ? (
             <img
+              className="partner-longpress-img"
               src={previewUrl || summary?.qrcodeUrl || ''}
               alt="关联码"
               style={{ width: 200, height: 200, background: '#fff' }}
@@ -197,17 +213,27 @@ export default function UsersManagePage() {
           ) : (
             <p className="body-md text-muted">{loading ? '加载中…' : '关联码尚未生成'}</p>
           )}
-          <p className="label-md text-muted" style={{ marginTop: 8 }}>
+          {(() => {
-            已关联 {summary?.userCount ?? total} 人
+            const scanCount = summary?.scanCount ?? 0;
-          </p>
+            const userCount = summary?.userCount ?? total;
+            if (scanCount <= 0 && userCount <= 0) return null;
+            return (
+              <p className="label-md text-muted" style={{ marginTop: 8 }}>
+                已扫码 {scanCount} 人 · 已关联 {userCount} 人
+              </p>
+            );
+          })()}
           <button type="button" className="partner-btn-primary" style={{ marginTop: 16 }} onClick={() => void downloadMainImage()}>
-            {summary?.activityPosterId ? '下载活动图' : '下载二维码'}
+            {summary?.activityPosterId && !hidePoster ? '下载活动图' : '下载二维码'}
           </button>
-          {previewUrl && isWechatEnv() && (
+          {isWechatEnv() && (previewUrl || summary?.qrcodeUrl) ? (
-            <p className="label-md text-muted" style={{ marginTop: 8 }}>微信内请长按上方图片保存</p>
+            <p className="label-md text-muted" style={{ marginTop: 8 }}>
-          )}
+              微信内请点「{summary?.activityPosterId && !hidePoster ? '下载活动图' : '下载二维码'}」后长按保存
+            </p>
+          ) : null}
         </section>
 
+        {!hidePoster && (
         <Link to="/center/activity-posters" className="partner-menu-card" style={{ display: 'block', marginBottom: 20, textDecoration: 'none', color: 'inherit' }}>
           <div className="partner-menu-item">
             <div className="partner-menu-item-left">
@@ -219,6 +245,7 @@ export default function UsersManagePage() {
             <span className="material-symbols-outlined text-muted">chevron_right</span>
           </div>
         </Link>
+        )}
 
         <h2 className="headline-md" style={{ marginBottom: 12 }}>已关联用户</h2>
         <div className="partner-search">
@@ -250,32 +277,40 @@ export default function UsersManagePage() {
         {!loading && items.length === 0 && <div className="empty">暂无关联用户</div>}
         {items.map((u) => (
           <div key={u.id} className="partner-store-card" style={{ marginBottom: 12 }}>
-            <div className="partner-store-card-header" style={{ marginBottom: 8 }}>
+            <div className="partner-store-card-header" style={{ marginBottom: 4 }}>
-              <div>
+              <p className="body-md">{formatUserLabel(u)}</p>
-                <p className="body-md">{formatUserLabel(u)}</p>
-                <p className="label-md text-muted">{u.phone || '未绑定手机'}</p>
-                <p className="label-md text-muted">注册 {fmtTime(u.createdAt)}</p>
-              </div>
               <button
                 type="button"
                 className="label-md text-primary"
-                style={{ background: 'none', border: 0, padding: 0 }}
+                style={{ background: 'none', border: 0, padding: 0, flexShrink: 0 }}
                 onClick={() => navigate(`/users/${u.id}/orders`)}
               >
                 {u.orderCount} 单
               </button>
             </div>
-            <button
+            <p className="label-md text-muted">{u.phone || '未绑定手机'}</p>
-              type="button"
+            <div
-              className="label-md text-primary"
+              style={{
-              style={{ background: 'none', border: 0, padding: 0 }}
+                display: 'flex',
-              onClick={() => {
+                justifyContent: 'space-between',
-                setEditing(u);
+                alignItems: 'center',
-                setRemarkDraft(u.partnerRemark ?? '');
+                gap: 12,
+                marginTop: 4,
               }}
             >
-              {u.partnerRemark ? '改备注' : '添加备注'}
+              <p className="label-md text-muted">注册 {fmtTime(u.createdAt)}</p>
-            </button>
+              <button
+                type="button"
+                className="label-md text-primary"
+                style={{ background: 'none', border: 0, padding: 0, flexShrink: 0 }}
+                onClick={() => {
+                  setEditing(u);
+                  setRemarkDraft(u.partnerRemark ?? '');
+                }}
+              >
+                {u.partnerRemark ? '改备注' : '添加备注'}
+              </button>
+            </div>
           </div>
         ))}
       </div>

apps/h5-partner/src/styles.css

@@ -4087,3 +4087,11 @@ header:has(> .app-page-title:only-child),
   width: 200px;
   height: 200px;
 }
+
+/* 微信内长按保存：不要禁用系统菜单 */
+img.partner-longpress-img {
+  -webkit-touch-callout: default;
+  -webkit-user-select: none;
+  user-select: none;
+  pointer-events: auto;
+}

apps/mini-user/config/index.ts

@@ -14,6 +14,9 @@ const API_ORIGIN =
   (isDevMode ? 'http://192.168.1.10:3010' : 'https://api.dukanghaoke.com');
 
 const requireFromApp = createRequire(path.resolve(__dirname, '../package.json'));
+const { version: APP_PKG_VERSION } = requireFromApp(path.resolve(__dirname, '../package.json')) as {
+  version: string;
+};
 
 /** 解析包目录/文件，避免 pnpm/Vite 把同一 runtime 打成两份 → useDidShow 读到空 reactMeta */
 function resolvePkgFile(id: string): string {
@@ -54,6 +57,7 @@ export default defineConfig(async () => ({
   },
   defineConstants: {
     TARO_APP_API_ORIGIN: JSON.stringify(API_ORIGIN),
+    TARO_APP_VERSION: JSON.stringify(APP_PKG_VERSION),
   },
   copy: {
     patterns: [

apps/mini-user/package.json

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

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

@@ -4,6 +4,7 @@ export default defineAppConfig({
     'pages/stores/index',
     'pages/benefit/index',
     'pages/mine/index',
+    'pages/open/index',
   ],
   subPackages: [
     { root: 'pages/product-detail', pages: ['index'] },

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

@@ -3,7 +3,7 @@ import { Button, Text } from '@tarojs/components';
 import type { ReactNode } from 'react';
 import { toast } from '../lib/api';
 import { getBrandAssetsSync, loadBrandAssets } from '../lib/brand-assets';
-import { formatOpenCsError, openWecomCustomerServiceChat } from '../lib/wecom-cs';
+import { buildCsSharePath, buildCsShareTitle, formatOpenCsError, openWecomCustomerServiceChat } from '../lib/wecom-cs';
 
 export type ContactCsSessionContext = {
   orderId?: string;
@@ -91,6 +91,9 @@ export default function ContactCsButton({
       className={className}
       openType="contact"
       sessionFrom={buildCsSessionFrom(session)}
+      showMessageCard
+      sendMessageTitle={buildCsShareTitle(session?.orderNo)}
+      sendMessagePath={buildCsSharePath(session?.orderId)}
       hoverClass="none"
     >
       {typeof children === 'string' ? <Text>{children}</Text> : children}

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

@@ -130,10 +130,12 @@ export function toast(title: string, icon: 'success' | 'error' | 'none' = 'none'
   const text = title.trim();
   if (!text) return;
   if (icon !== 'success' && showFloatingToast(text)) {
-    void Taro.hideToast();
+    void Promise.resolve(Taro.hideToast() as void | Promise<unknown>).catch(() => {});
     return;
   }
-  Taro.showToast({ title: text, icon, duration: 1800 });
+  void Promise.resolve(
+    Taro.showToast({ title: text, icon, duration: 1800 }) as void | Promise<unknown>,
+  ).catch(() => {});
 }
 
 export type SessionPayload = {

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

@@ -21,6 +21,14 @@ export type ClientErrorPayload = {
   extra?: Record<string, unknown>;
 };
 
+/** 微信预期失败，不应按 P1 未捕获上报 */
+const IGNORED_REJECTION =
+  /getLocation:fail|hideToast:fail:toast can't be found|showToast:fail|authorize:fail auth deny/i;
+
+function shouldIgnoreRejection(message: string): boolean {
+  return IGNORED_REJECTION.test(message);
+}
+
 function currentPagePath(): string | undefined {
   try {
     const pages = Taro.getCurrentPages();
@@ -97,6 +105,7 @@ export function installClientErrorReporting(): void {
           : typeof reason === 'string'
             ? reason
             : JSON.stringify(reason);
+      if (shouldIgnoreRejection(message || '')) return;
       const stack = reason instanceof Error ? reason.stack : undefined;
       reportClientError({
         level: 'error',
@@ -121,15 +130,17 @@ export function installClientErrorReporting(): void {
     });
     window.addEventListener('unhandledrejection', (ev) => {
       const reason = ev.reason;
+      const message =
+        reason instanceof Error
+          ? reason.message
+          : typeof reason === 'string'
+            ? reason
+            : 'unhandledrejection';
+      if (shouldIgnoreRejection(message)) return;
       reportClientError({
         level: 'error',
         category: 'unhandled_rejection',
-        message:
+        message,
-          reason instanceof Error
-            ? reason.message
-            : typeof reason === 'string'
-              ? reason
-              : 'unhandledrejection',
         stack: reason instanceof Error ? reason.stack : undefined,
       });
     });

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

@@ -14,13 +14,7 @@ export async function tryGetClientGpsLocation(): Promise<ClientGpsLocation | nul
   if (process.env.TARO_ENV === 'weapp') {
     try {
       const Taro = (await import('@tarojs/taro')).default;
-      const loc = await new Promise<{ latitude: number; longitude: number }>((resolve, reject) => {
+      const loc = await Taro.getLocation({ type: 'gcj02' });
-        Taro.getLocation({
-          type: 'gcj02',
-          success: resolve,
-          fail: reject,
-        });
-      });
       return { latitude: loc.latitude, longitude: loc.longitude };
     } catch {
       return null;

apps/mini-user/src/lib/client-location.weapp.ts

@@ -11,13 +11,7 @@ export type ClientGpsLocation = {
 
 export async function tryGetClientGpsLocation(): Promise<ClientGpsLocation | null> {
   try {
-    const loc = await new Promise<{ latitude: number; longitude: number }>((resolve, reject) => {
+    const loc = await Taro.getLocation({ type: 'gcj02' });
-      Taro.getLocation({
-        type: 'gcj02',
-        success: resolve,
-        fail: reject,
-      });
-    });
     return { latitude: loc.latitude, longitude: loc.longitude };
   } catch {
     return null;

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

@@ -1,13 +1,18 @@
 import Taro from '@tarojs/taro';
 import { fetchClientConfig } from './pay-wechat';
 
-/** 与 package.json version 同步，供服务端 minClientVersion 比对 */
+/** 与 package.json version 同步（Taro defineConstants 注入），供 minClientVersion 比对 */
-export const APP_VERSION = '3.5.16';
+export const APP_VERSION =
+  (typeof TARO_APP_VERSION !== 'undefined' && String(TARO_APP_VERSION).trim()) || '4.0.4';
 
-export const APP_VERSION_LABEL = `v${APP_VERSION}`;
+export const APP_VERSION_LABEL = `v${APP_VERSION.replace(/^v/i, '')}`;
+
+function normalizeVersion(v: string): string {
+  return String(v || '').trim().replace(/^v/i, '');
+}
 
 function parseSemver(v: string): number[] {
-  return v.split('.').map((n) => parseInt(n, 10) || 0);
+  return normalizeVersion(v).split('.').map((n) => parseInt(n, 10) || 0);
 }
 
 export function compareSemver(a: string, b: string): number {
@@ -89,7 +94,7 @@ async function enforceMinClientVersion(min: string) {
 export async function checkClientVersionGate() {
   try {
     const config = await fetchClientConfig();
-    const min = config.minClientVersion?.trim();
+    const min = normalizeVersion(config.minClientVersion ?? '');
     if (min && compareSemver(APP_VERSION, min) < 0) {
       await enforceMinClientVersion(min);
     }

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

@@ -162,6 +162,11 @@ export async function capturePromoSceneAndTouchScan(): Promise<void> {
   const assocScene = extractAssocSceneFromEnterOptions(opts);
   if (assocScene) {
     setStoredAssocScene(assocScene);
+    const touchKey = `assoc|${assocScene}|${opts?.path || ''}|${JSON.stringify(opts?.query || {})}|${String(opts?.scene ?? '')}`;
+    if (touchKey !== lastScanTouchKey) {
+      lastScanTouchKey = touchKey;
+      await touchAssoc({ scene: assocScene, countScan: true });
+    }
     await bindStoredAssocIfLoggedIn();
     return;
   }
@@ -179,6 +184,20 @@ export async function capturePromoSceneAndTouchScan(): Promise<void> {
   // 无新 scene 时不重复扫码计数
 }
 
+async function touchAssoc(input: { scene: string; countScan: boolean }): Promise<void> {
+  try {
+    await request('/user/partner-assoc/touch', {
+      method: 'POST',
+      data: {
+        scene: input.scene,
+        countScan: input.countScan,
+      },
+    });
+  } catch {
+    /* 静默失败，不阻断浏览 */
+  }
+}
+
 /** 登录成功后：用已缓存的活动 ID 做归因（不重复加扫码次数） */
 export async function touchStoredPromoAfterLogin(): Promise<void> {
   await bindStoredAssocIfLoggedIn();

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 multi = Array.isArray(store.categories) ? store.categories : [];
-  const childName = String(store.category?.name || '').trim();
+  if (multi.length) {
-  const parentName = String(store.category?.parent?.name || '').trim();
+    return groupCategoryTags(multi, tree);
-  if (parentName) names.push(parentName);
+  }
-  if (childName && childName !== parentName) names.push(childName);
 
-  const storeCatId = String(store.categoryId || store.category?.id || '');
+  if (store.category || store.categoryId) {
-  const storeParentId = String(store.category?.parentId || '');
+    const grouped = groupCategoryTags(
-  for (const root of tree) {
+      store.category ? [store.category] : [],
-    if (root.id === storeParentId || root.id === storeCatId) {
+      tree,
-      if (root.name && !names.includes(root.name)) names.unshift(root.name);
+      store.categoryId,
-    }
+    );
-    for (const child of root.children ?? []) {
+    if (grouped.length) return grouped;
-      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);
+  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/lib/user-location.ts

@@ -59,6 +59,23 @@ function clearLocationDenied() {
   }
 }
 
+function wxErrorMessage(err: unknown): string {
+  if (!err) return '';
+  if (typeof err === 'string') return err;
+  if (err instanceof Error) return err.message;
+  if (typeof err === 'object') {
+    const o = err as { errMsg?: unknown; message?: unknown };
+    if (typeof o.errMsg === 'string' && o.errMsg) return o.errMsg;
+    if (typeof o.message === 'string' && o.message) return o.message;
+    try {
+      return JSON.stringify(err);
+    } catch {
+      return '';
+    }
+  }
+  return String(err);
+}
+
 function isDenyMessage(errMsg?: string): boolean {
   return /auth deny|authorize|permission|denied|拒绝|用户拒绝|getLocation:fail/i.test(
     errMsg || '',
@@ -179,14 +196,13 @@ async function promptLocationAuthOnce() {
   }).catch(() => {});
 }
 
-function getMiniLocation(): Promise<Taro.getLocation.SuccessCallbackResult> {
+async function getMiniLocation(): Promise<Taro.getLocation.SuccessCallbackResult> {
-  return new Promise((resolve, reject) => {
+  const setting = await Taro.getSetting().catch(() => null);
-    Taro.getLocation({
+  if (setting?.authSetting?.['scope.userLocation'] === false) {
-      type: 'gcj02',
+    throw new Error('getLocation:fail auth deny');
-      success: resolve,
+  }
-      fail: reject,
+  // 只用返回的 Promise，避免 callback + Promise 双重 reject 变成未捕获
-    });
+  return Taro.getLocation({ type: 'gcj02' });
-  });
 }
 
 async function resolveViaH5Jssdk(): Promise<ResolvedUserCity | null> {
@@ -263,7 +279,7 @@ export async function resolveUserCity(force = false): Promise<ResolvedUserCity>
       return resolved;
     }
   } catch (err) {
-    const errMsg = err instanceof Error ? err.message : String(err);
+    const errMsg = wxErrorMessage(err);
     const denied = isDenyMessage(errMsg);
     if (denied && !isLocationDenied()) {
       await promptLocationAuthOnce();

apps/mini-user/src/lib/user-location.weapp.ts

@@ -57,6 +57,23 @@ function clearLocationDenied() {
   }
 }
 
+function wxErrorMessage(err: unknown): string {
+  if (!err) return '';
+  if (typeof err === 'string') return err;
+  if (err instanceof Error) return err.message;
+  if (typeof err === 'object') {
+    const o = err as { errMsg?: unknown; message?: unknown };
+    if (typeof o.errMsg === 'string' && o.errMsg) return o.errMsg;
+    if (typeof o.message === 'string' && o.message) return o.message;
+    try {
+      return JSON.stringify(err);
+    } catch {
+      return '';
+    }
+  }
+  return String(err);
+}
+
 function isDenyMessage(errMsg?: string): boolean {
   return /auth deny|authorize|permission|denied|拒绝|用户拒绝|getLocation:fail/i.test(
     errMsg || '',
@@ -175,14 +192,13 @@ async function promptLocationAuthOnce() {
   }).catch(() => {});
 }
 
-function getMiniLocation(): Promise<Taro.getLocation.SuccessCallbackResult> {
+async function getMiniLocation(): Promise<Taro.getLocation.SuccessCallbackResult> {
-  return new Promise((resolve, reject) => {
+  const setting = await Taro.getSetting().catch(() => null);
-    Taro.getLocation({
+  if (setting?.authSetting?.['scope.userLocation'] === false) {
-      type: 'gcj02',
+    throw new Error('getLocation:fail auth deny');
-      success: resolve,
+  }
-      fail: reject,
+  // 只用返回的 Promise，避免 callback + Promise 双重 reject 变成未捕获
-    });
+  return Taro.getLocation({ type: 'gcj02' });
-  });
 }
 
 export async function resolveUserCity(force = false): Promise<ResolvedUserCity> {
@@ -211,7 +227,7 @@ export async function resolveUserCity(force = false): Promise<ResolvedUserCity>
       return resolved;
     }
   } catch (err) {
-    const errMsg = err instanceof Error ? err.message : String(err);
+    const errMsg = wxErrorMessage(err);
     const denied = isDenyMessage(errMsg);
     if (denied && !isLocationDenied()) {
       await promptLocationAuthOnce();

apps/mini-user/src/lib/wecom-cs.ts

@@ -4,6 +4,17 @@ export type WecomCsSessionContext = {
   from?: string;
 };
 
+/** 客服消息卡片必须落主包页；分包（订单详情）作启动页会白屏 */
+export function buildCsSharePath(orderId?: string): string {
+  const id = (orderId || '').trim();
+  return id ? `pages/open/index?id=${encodeURIComponent(id)}` : 'pages/home/index';
+}
+
+export function buildCsShareTitle(orderNo?: string): string {
+  const no = (orderNo || '').trim();
+  return no ? `订单 ${no}` : '杜康好客';
+}
+
 type OpenCsChatOption = {
   extInfo: { url: string };
   corpId: string;
@@ -97,16 +108,10 @@ export async function openWecomCustomerServiceChat(params: {
   const option: OpenCsChatOption = {
     extInfo: { url },
     corpId,
+    showMessageCard: true,
+    sendMessageTitle: buildCsShareTitle(params.session?.orderNo),
+    sendMessagePath: buildCsSharePath(params.session?.orderId),
   };
-  if (params.session?.orderNo || params.session?.orderId) {
-    option.showMessageCard = true;
-    option.sendMessageTitle = params.session.orderNo
-      ? `订单 ${params.session.orderNo}`
-      : '订单咨询';
-    if (params.session.orderId) {
-      option.sendMessagePath = `pages/order-detail/index?id=${params.session.orderId}`;
-    }
-  }
 
   await new Promise<void>((resolve, reject) => {
     wxApi({

apps/mini-user/src/pages/open/index.config.ts

@@ -0,0 +1,3 @@
+export default definePageConfig({
+  navigationBarTitleText: '杜康好客',
+});

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

@@ -0,0 +1,42 @@
+import { View, Text } from '@tarojs/components';
+import Taro, { useLoad } from '@tarojs/taro';
+import PageShell from '../../components/PageShell';
+import { goLogin } from '../../lib/auth-nav';
+import { isLoggedIn } from '../../lib/api';
+
+function goHome() {
+  Taro.switchTab({ url: '/pages/home/index' }).catch(() => {
+    Taro.reLaunch({ url: '/pages/home/index' });
+  });
+}
+
+function openOrder(orderId: string) {
+  const detail = `/pages/order-detail/index?id=${encodeURIComponent(orderId)}`;
+  if (!isLoggedIn()) {
+    goLogin(detail);
+    return;
+  }
+  Taro.redirectTo({ url: detail }).catch(() => {
+    Taro.reLaunch({ url: detail });
+  });
+}
+
+/** 主包落地：客服卡片 / 外链打开分包页（订单详情）前先落到这里，避免白屏 */
+export default function OpenPage() {
+  useLoad((query?: Record<string, string | undefined>) => {
+    const orderId = String(query?.id || query?.orderId || '').trim();
+    if (!orderId) {
+      goHome();
+      return;
+    }
+    openOrder(orderId);
+  });
+
+  return (
+    <PageShell variant="plain">
+      <View className="u-empty">
+        <Text>正在打开…</Text>
+      </View>
+    </PageShell>
+  );
+}

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

@@ -116,6 +116,7 @@ export default function OrderDetailPage() {
   const orderId = router.params.id ?? '';
   usePageView('order_detail_view', orderId ? { orderId } : undefined);
   const [order, setOrder] = useState<OrderDetail | null>(null);
+  const [loadError, setLoadError] = useState('');
   const [confirming, setConfirming] = useState(false);
   const [latestTrack, setLatestTrack] = useState<OrderTrackNode | null>(null);
   const [estimatedArrival, setEstimatedArrival] = useState<OrderTrackEstimatedArrival | null>(null);
@@ -147,14 +148,18 @@ export default function OrderDetailPage() {
   }
 
   useEffect(() => {
-    if (!orderId) return;
+    if (!orderId) {
+      setLoadError('订单信息缺失');
+      return;
+    }
     request<OrderDetail>(`/trade/orders/${orderId}`)
       .then((data) => {
         setOrder(data);
+        setLoadError('');
         void loadOrderTrack(data.delivery, data.status);
         applyLocalDeliveryHint(data, setLocalHintHtml);
       })
-      .catch((e) => toast(e instanceof Error ? e.message : '加载失败'));
+      .catch((e) => setLoadError(e instanceof Error ? e.message : '加载失败'));
   }, [orderId]);
 
   useDidShow(() => {
@@ -293,7 +298,9 @@ export default function OrderDetailPage() {
       />
       <View className="sub-page-body">
         {!order ? (
-          <View className="u-empty">加载中…</View>
+          <View className="u-empty" onClick={loadError ? () => Taro.switchTab({ url: '/pages/home/index' }) : undefined}>
+            <Text>{loadError || '加载中…'}</Text>
+          </View>
         ) : (
           <>
             <View className="order-card">

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 leafIds = storeLeafCategoryIds(store);
-    const storeParentId = String(store.category?.parentId || '');
+    const parentIds = new Set<string>();
-    if (category.childId) {
+    if (Array.isArray(store.categories)) {
-      return storeCatId === category.childId;
+      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);
+                  const categoryLabels = storeCategoryTags(s, categoryTree);
-                  return tags.length ? (
+                  return categoryLabels.length ? (
-                    <View className="store-card-tags">
+                    <View className="store-card-category-wrap">
-                      {tags.map((tag) => (
+                      <Text className="store-card-category-text">{categoryLabels.join('、')}</Text>
-                        <Text key={tag} className="store-card-tag">
-                          {tag}
-                        </Text>
-                      ))}
                     </View>
                   ) : null;
                 })()}

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 {

apps/mini-user/types/global.d.ts

@@ -13,6 +13,7 @@ declare const defineAppConfig: (config: Record<string, unknown>) => Record<strin
 declare const definePageConfig: (config: Record<string, unknown>) => Record<string, unknown>;
 
 declare const TARO_APP_API_ORIGIN: string;
+declare const TARO_APP_VERSION: string;
 
 /** 微信小程序全局（Taro 未封装的 API 如 openBusinessView 需直接调用） */
 declare const wx: {

deploy/sync-prod-db-to-local.sh

@@ -6,6 +6,15 @@
 #      本地开发机一般不在白名单，因此借道生产服务器 dukang-server 建立隧道。
 #   2. 在本地 dukang-v1-mysql 容器内用 mysqldump 连接隧道端口，导出线上库。
 #   3. 通过管道直接导入本地库（默认 dukang_haoke，即应用本地库名）。
+#   4. 下列表不同步，保留本地数据（环境配置 / 密钥 / 大表日志等）：
+#        · 系统设置：system_config, common_wx_app_config
+#        · 企微机器人：wecom_bot, wecom_message_push, wecom_push_template,
+#          llm_api_config, knowledge_base, knowledge_document
+#        · OSS 资源库：common_resource
+#        · 日志：log_third_party, log_promo_event, log_user_analytics,
+#          log_store_analytics, log_partner_analytics, log_wecom_bot
+#        · 白名单：common_test_whitelist_phone, common_product_visibility_phone,
+#          store_visibility_phone
 #
 # 前置条件：
 #   - deploy.env 中 DEPLOY_HOST / DEPLOY_USER / DEPLOY_PORT 已配置且可无密码 SSH
@@ -35,13 +44,35 @@ DO_BACKUP=1
 ASSUME_YES=0
 DRY_RUN=0
 
+# 同步时保留本地数据的表（见文件头说明）
+SYNC_EXCLUDE_TABLES=(
+  system_config
+  common_wx_app_config
+  wecom_bot
+  wecom_message_push
+  wecom_push_template
+  llm_api_config
+  knowledge_base
+  knowledge_document
+  common_resource
+  log_third_party
+  log_promo_event
+  log_user_analytics
+  log_store_analytics
+  log_partner_analytics
+  log_wecom_bot
+  common_test_whitelist_phone
+  common_product_visibility_phone
+  store_visibility_phone
+)
+
 # ---------------- 解析参数 ----------------
 for arg in "$@"; do
   case "$arg" in
     --yes|-y) ASSUME_YES=1 ;;
     --no-backup) DO_BACKUP=0 ;;
     --dry-run) DRY_RUN=1 ;;
-    --help|-h) sed -n '3,30p' "$0"; exit 0 ;;
+    --help|-h) sed -n '3,39p' "$0"; exit 0 ;;
     --tunnel-port=*) TUNNEL_PORT="${arg#*=}" ;;
     --local-db=*) LOCAL_DB="${arg#*=}" ;;
     --container=*) LOCAL_CONTAINER="${arg#*=}" ;;
@@ -103,6 +134,8 @@ echo "  源(线上): $REMOTE_USER@$REMOTE_HOST:$REMOTE_PORT/$REMOTE_DB"
 echo "  目标(本地): root@$LOCAL_CONTAINER:$LOCAL_DB (对外端口 6016)"
 echo "  隧道:      $TARGET -L $TUNNEL_PORT:$REMOTE_HOST:$REMOTE_PORT"
 echo "  本地备份:  $([[ $DO_BACKUP -eq 1 ]] && echo 是 || echo 否)"
+echo "  保留本地（不同步）: ${#SYNC_EXCLUDE_TABLES[@]} 张表"
+printf '    - %s\n' "${SYNC_EXCLUDE_TABLES[@]}"
 if [[ $DRY_RUN -eq 1 ]]; then
   echo "(dry-run) 已结束，未做任何修改。"
   exit 0
@@ -148,13 +181,20 @@ if [[ $ready -ne 1 ]]; then
 fi
 
 # ---------------- 同步（线上 -> 本地，管道直导） ----------------
+IGNORE_TABLE_ARGS=()
+for tbl in "${SYNC_EXCLUDE_TABLES[@]}"; do
+  IGNORE_TABLE_ARGS+=(--ignore-table="${REMOTE_DB}.${tbl}")
+done
+
 echo "==> 开始同步（管道直导，不落临时文件）"
 echo "    提示：同步前建议本地 Prisma 已追平线上 schema（pnpm db:push 或迁移），否则可能因表结构差异报错。"
+echo "    提示：${#SYNC_EXCLUDE_TABLES[@]} 张环境/配置表保留本地数据，不会被线上覆盖。"
 set +e
 docker exec -i -e "MYSQL_PWD=$REMOTE_PASS" "$LOCAL_CONTAINER" \
   mysqldump -h "$HOST_ALIAS" -P "$TUNNEL_PORT" -u "$REMOTE_USER" \
   --lock-tables=0 --add-drop-table --skip-triggers --no-create-db \
   --skip-routines --skip-events --column-statistics=0 --no-tablespaces --set-gtid-purged=OFF \
+  "${IGNORE_TABLE_ARGS[@]}" \
   "$REMOTE_DB" \
   | docker exec -i "$LOCAL_CONTAINER" mysql -uroot -p"$LOCAL_ROOT_PASSWORD" "$LOCAL_DB"
 RC=${PIPESTATUS[0]}
@@ -168,4 +208,4 @@ if [[ $RC -ne 0 ]]; then
   [[ $DO_BACKUP -eq 1 ]] && echo "请用备份恢复: $BK" >&2
   exit 1
 fi
-echo "==> 同步完成 ✅ 本地 $LOCAL_DB 现已是线上 $REMOTE_DB 的副本。"
+echo "==> 同步完成 ✅ 本地 $LOCAL_DB 已同步线上业务数据（${#SYNC_EXCLUDE_TABLES[@]} 张配置/日志表保留本地）。"

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

@@ -1,7 +1,7 @@
 # 杜康好客 · V3 编码手册（交付业务版）
 
 > **事实源**：[`杜康好客-v3-PRD.md`](./杜康好客-v3-PRD.md) · **审计**：[`杜康好客-v3-现状对照.md`](./杜康好客-v3-现状对照.md)  
-> **佣金归属 / 关联码 / 合伙人账单明细（v4.0.1）· 活动图（v4.0.2）**：[`杜康好客-v4-PRD.md`](./杜康好客-v4-PRD.md)，冲突时 **V4 > V3**。  
+> **佣金归属 / 关联码 / 合伙人账单明细（v4.0.1）· 活动图（v4.0.2）· 周结算与预付款（v4.0.9）**：[`杜康好客-v4-PRD.md`](./杜康好客-v4-PRD.md)，冲突时 **V4 > V3**。  
 > V2/preV1 **非需求依据**。总部交付 = **`apps/admin-web`**（非 H5）。
 
 ## 1. 交付目标（六条）
@@ -56,16 +56,18 @@ C 端购酒核销 · 门店扫码核销+打款 · 合伙人拓店履约 · WebAd
 
 **HQ 门店账单打款凭证**：确认打款 / 提现通过可填 `paymentRef`，并可上传照片（`paymentProofUrls`，OSS `PAYMENT_PROOF`，最多 9 张）。详情与 T+1 导出展示。
 
-**活动图（v4.0.2 / v4.0.7）**：规则见 v4-PRD §6。表 `activity_poster`；HQ `GET/POST/PUT/DELETE /admin/activity-posters`（权限 `activity_posters`）；合伙人 `GET /partner/activity-posters` · `GET/PUT /partner/activity-posters/selection`（写入 `partner_account.activity_poster_id`）· `GET /partner/activity-posters/:id/image`（合成本人关联码）。`GET /partner/assoc` 返回 `activityPosterId`。码栏百分比相对图宽。子账号无入口。v4.0.7：HQ `GET /admin/activity-posters/:id/image?partnerId=` 单张合成 PNG；`POST /admin/activity-posters/:id/partner-pack` `{ partnerIds }` 流式 zip（仅勾选，测试号/无码 skip）。城市合伙人快链 `/activity-posters?partnerId=`。不预生成缓存图、不批量调微信补码。
+**活动图（v4.0.2 / v4.0.7）**：规则见 v4-PRD §6。表 `activity_poster`；HQ `GET/POST/PUT/DELETE /admin/activity-posters`（权限 `activity_posters`）；合伙人 `GET /partner/activity-posters` · `GET/PUT /partner/activity-posters/selection`（写入 `partner_account.activity_poster_id`）· `GET /partner/activity-posters/:id/image`（合成本人关联码）。`GET /partner/assoc` 返回 `activityPosterId`（**子账号强制为空**）。码栏百分比相对图宽。子账号可进用户管理、下载纯关联码，无活动图入口。v4.0.7：HQ `GET /admin/activity-posters/:id/image?partnerId=` 单张合成 PNG；`POST /admin/activity-posters/:id/partner-pack` `{ partnerIds }` 流式 zip（仅勾选，测试号/无码 skip）。城市合伙人快链 `/activity-posters?partnerId=`。不预生成缓存图、不批量调微信补码。
 
-**合伙人关联与订单佣金（v4.0.1）**：规则见 v4-PRD。`user_user.assoc_partner_account_id` 首次扫码锁定；`user_order.partner_account_id_at_pay` 仅关联或代下单显式选择写入（禁止区县解析）。`partner_bill_item` 分酒单 / 核销两段。合伙人备注独立表 `partner_user_note`（勿写 `hq_remark`）。`POST /user/partner-assoc/bind` · `GET /partner/assoc` · `GET /partner/assoc/stats`（关联用户 / 当前关联用户已付购酒单，本日/本月）· `GET /partner/assoc/users?keyword&sort`（合伙人侧返回 `partnerRemark`，不返回 `hqRemark`）· `GET /partner/assoc/users/:userId/orders` · `GET /partner/assoc/orders` · `PUT /partner/assoc/users/:userId/remark` · HQ `GET /admin/users` 支持 `keyword`、`assocPartnerAccountId`（`none` / `any` / 主账号 ID）· `GET /admin/orders` 支持 `assocPartnerAccountId`（筛本单快照，`none`=无快照）· `PUT /admin/users/:id/assoc`（权限 `users_partner_assoc`）改绑/解绑 · 开城合伙人关联用户快链 `/users?assocPartnerAccountId=` · `PUT /admin/partners/:id` 改费率用 `Decimal(toFixed(4))`。
+**合伙人关联与订单佣金（v4.0.1 / v4.0.9）**：规则见 v4-PRD。`user_user.assoc_partner_account_id` 首次扫码锁定；`user_order.partner_account_id_at_pay` 仅关联或代下单显式选择写入（禁止区县解析）。`partner_bill_item` 分酒单 / 核销两段。合伙人备注独立表 `partner_user_note`（勿写 `hq_remark`）。`POST /user/partner-assoc/bind` · `POST /user/partner-assoc/touch`（未登录可计已扫码）· `GET /partner/assoc`（`scanCount` + `userCount`；子账号无 `activityPosterId`）· `GET /partner/assoc/stats`（关联用户 / 当前关联用户已付购酒单，本日/本月）· `GET /partner/assoc/users?keyword&sort`（合伙人侧返回 `partnerRemark`，不返回 `hqRemark`；主账号与子账号均可）· `GET /partner/assoc/users/:userId/orders` · `GET /partner/assoc/orders` · `PUT /partner/assoc/users/:userId/remark` · HQ `GET /admin/users` 支持 `keyword`、`assocPartnerAccountId`（`none` / `any` / 主账号 ID）· `GET /admin/orders` 支持 `assocPartnerAccountId`（筛本单快照，`none`=无快照）· `PUT /admin/users/:id/assoc`（权限 `users_partner_assoc`）改绑/解绑 · 开城合伙人关联用户快链 `/users?assocPartnerAccountId=` · `PUT /admin/partners/:id` 改费率用 `Decimal(toFixed(4))`。子账号创建默认 `ACTIVE`。主账号 `PUT /partner/me/bank` 填收款账户。
+
+**合伙人周结算（v4.0.9）**：每周一 08:00 生成上一自然周账单。`GET /partner/settlement/cycle` 账期与出账日；`GET /partner/settlement/preview` 本周一至今预付款预估。零元账单 HQ 可见待审核、不可发送、合伙人端不可见。历史月账不回刷。
 
 ## 5. 验收用例（必过）
 
 **主链路 15 项**：登录、4 SKU、起购、支付+权益、双通道核销、payout、关店不可见、拓店审核、配送完成、退款、T+1/T+30…  
 **后台 8 项**：商品/门店/订单/权益/核销/工单/日志/财务。  
-**开发计划任务**：状态 `TODO` 待开发 / `IN_PROGRESS` 开发中 / `DEVELOPED` 已开发 / `RELEASED` 已上线；任务列表「来源工单」链到 `/tickets/support?id=`。  
+**开发计划任务**：状态 `TODO` 待开发 / `IN_PROGRESS` 开发中 / `DEVELOPED` 已开发 / `RELEASED` 已上线 / `STOPPED` 已停止；版本状态含 `STOPPED` 已停止，关联任务随版本同步（仅当全部关联版本已停止时任务才为已停止）。任务列表「来源工单」链到 `/tickets/support?id=`。  
-**财务账单日**：出账当天北京日历日（门店/酒厂 `billDate`；合伙人/物流账期按北京自然月）。禁止 `toISOString().slice(0,10)` 或服务器本地 `Date` 午夜当账单日。酒厂应付为 0 仍出账（展示无需打款）。
+**财务账单日**：出账当天北京日历日（门店/酒厂 `billDate`；物流账期按北京自然月；合伙人周账按北京自然周，周一 08:00 出上周）。禁止 `toISOString().slice(0,10)` 或服务器本地 `Date` 午夜当账单日。酒厂应付为 0 仍出账（展示无需打款）。合伙人零元账单不同步给合伙人端。
 
 ## 6. 技术债（摘要）
 

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

@@ -1,8 +1,8 @@
 # 杜康好客 · V4 PRD
 
-> **v4.0**（2026-08-29）· 关联码与分佣事实源；**v4.0.6** 酒厂对账；**v4.0.7** HQ 活动图快链与勾选导出  
+> **v4.0**（2026-08-29）· 关联码与分佣事实源；**v4.0.6** 酒厂对账；**v4.0.7** HQ 活动图快链与勾选导出；**v4.0.9** 合伙人 H5 周结算与用户管理  
-> 未改规则仍见 [`杜康好客-v3-PRD.md`](./杜康好客-v3-PRD.md)。**冲突时 V4 > V3**（本主题：订单佣金归属、关联码、合伙人账单明细、活动图、酒厂对账）。  
+> 未改规则仍见 [`杜康好客-v3-PRD.md`](./杜康好客-v3-PRD.md)。**冲突时 V4 > V3**（本主题：订单佣金归属、关联码、合伙人账单明细、活动图、酒厂对账、合伙人周结算）。  
-> 实现：[`v4.0.1 开发文档`](./杜康好客-v4.0.1-开发文档.md) · [`v4.0.2 开发文档`](./杜康好客-v4.0.2-开发文档.md) · [`v4.0.6 开发文档`](./杜康好客-v4.0.6-开发文档.md) · [`v4.0.7 开发文档`](./杜康好客-v4.0.7-开发文档.md) · 审计：[`v4-现状对照`](./杜康好客-v4-现状对照.md)
+> 实现：[`v4.0.1 开发文档`](./杜康好客-v4.0.1-开发文档.md) · [`v4.0.2 开发文档`](./杜康好客-v4.0.2-开发文档.md) · [`v4.0.6 开发文档`](./杜康好客-v4.0.6-开发文档.md) · [`v4.0.7 开发文档`](./杜康好客-v4.0.7-开发文档.md) · [`v4.0.9 开发文档`](./杜康好客-v4.0.9-开发文档.md) · 审计：[`v4-现状对照`](./杜康好客-v4-现状对照.md)
 
 ## 0. 版本
 
@@ -12,6 +12,7 @@
 | 4.0.2 | 08-30 | HQ 活动图模板（底图 + 方形码栏 + 文案）；合伙人下载合成关联码；所选图写入库并作为用户管理主图 | [`v4.0.2`](./杜康好客-v4.0.2-开发文档.md) |
 | 4.0.6 | 08-31 | 酒厂 T+3=每 3 天出一期；全部已完成已付订单（含现场提货）；应付为 0 仍出账；核对补生成 | [`v4.0.6`](./杜康好客-v4.0.6-开发文档.md) |
 | 4.0.7 | 09-01 | HQ 城市合伙人活动图快链；指定一张活动图为单个或勾选主合伙人合成下载（PNG / zip） | [`v4.0.7`](./杜康好客-v4.0.7-开发文档.md) |
+| 4.0.9 | 09-02 | 子账号默认启用；关联码已扫码计数；零元账单不同步；主账号自填银行账号；周账周一 08:00 出账；预付款预估；子账号用户管理（无活动图） | [`v4.0.9`](./杜康好客-v4.0.9-开发文档.md) |
 
 ## 1. 锚点（沿用 V3，佣金归属改写）
 
@@ -30,7 +31,11 @@
 - 合伙人 H5 可展示并**下载** PNG；微信内下载失败则预览 + 长按保存。
 - 主合伙人备注写独立表 `partner_user_note`（`partner_account_id` + `user_id` 唯一），与 HQ `user_user.hq_remark` 隔离；换绑后不跟随、不泄漏给下一个合伙人。合伙人 H5 **不返回** `hqRemark`。
 - 主账号首页两张卡：「关联用户」（按 `assocBoundAt` 拆本日/本月）、「关联用户订单」（已付购酒单且用户**当前**关联本合伙人，按 `paidAt` 拆本日/本月）。文案不用「佣金订单」——与账单快照 `partner_account_id_at_pay` 可能不完全重合。子账号不展示。
-- 主账号底部 Tab：首页 / **用户管理** / 门店管理 / 合伙人中心。用户管理页 = 关联码 + 已关联用户列表（搜索昵称/手机/编号/本合伙人备注；排序关联时间/注册时间/订单数）。点订单数看该用户已付购酒单。子账号无此 Tab。
+- 主账号底部 Tab：首页 / **用户管理** / 门店管理 / 合伙人中心。用户管理页 = 关联码 + 已关联用户列表（搜索昵称/手机/编号/本合伙人备注；排序关联时间/注册时间/订单数）。点订单数看该用户已付购酒单。
+- **子账号**也可进入用户管理：可看关联码、下载二维码、看已关联用户；**不能**看活动图入口与合成主图（只出纯关联码）。
+- 用户管理页二维码下方展示「已扫码」与「已关联」人数；为 0 的段不显示。已扫码 = C 端带 `pa_` scene 进入时累加（未登录也计），与已关联人数独立。
+- 主账号新建子账号默认 **ACTIVE**（可立即登录），列表中可再禁用。
+- 主账号可在合伙人中心填写收款账户：收款人、银行账号、开户行名称（写入主账号 `bank_account_*`）。
 - HQ：用户列表综合搜索 + 关联合伙人筛选（`none` 未关联 / `any` 已关联全部 / 指定主合伙人），筛选默认展开；订单列表按本单佣金快照筛关联合伙人；开城城市合伙人提供「关联用户」快链与「全部关联用户」快链，进入用户列表并带上筛选。
 
 ## 3. 订单佣金
@@ -55,7 +60,7 @@
 
 ## 5. 合伙人账单
 
-月账（T+30）表头：`orderCommission` + `redeemCommission` = `totalAmount`。
+**周账**：每周一北京时间 **08:00** 出具上一完整自然周（周一 00:00 ～ 周日 23:59:59.999）账单。表头：`orderCommission` + `redeemCommission` = `totalAmount`。
 
 明细两段：
 
@@ -66,12 +71,17 @@
 
 HQ 财务详情与合伙人确认页均展示两段列表。不再「无快照则全城已付单 × 当前费率」。
 
+- **零元账单**：佣金合计为 0 时 HQ 仍可生成并留在待审核，**不得发送**给合伙人；合伙人端列表/详情不可见。
+- 合伙人 H5 展示当前账期（本周一～本周日）与下次出账时间（下周一 08:00，若尚未过本周一 08:00 则为当日 08:00）。
+- **预付款**：当前未出账周期（本周一 00:00 至今）酒单 + 核销按佣金比例算出的预估合计。展示在首页与合伙人中心。与实际打款无关，实际以账单为准。
+- 上线前已生成的月账保留，不回刷。
+
 ## 6. 活动图
 
 - 一套活动图 = 底图 + 方形码栏（相对坐标）+ 标题 + 推广文案 + 排序 + 上架状态。文案由 HQ 手填，不自动生成。
 - 码栏用相对百分比存储，与底图像素无关：`qrXPct` / `qrYPct` 为左上角，`qrSizePct` 为边长（相对**图宽**，保证正方形）。HQ 上传后在预览图上拖拽定位、拉角改尺寸。
 - 合入的码固定为 **主合伙人关联码**（v4.0.1，`getwxacodeunlimit`，scene=`pa_{partnerId}`）。不复用推广码。
-- 合伙人 H5（仅主账号）可浏览已上架活动图、一键复制文案、下载合成图。下载时服务端把本人关联码 PNG 贴进码栏后返回整图。
+- 合伙人 H5（**仅主账号**）可浏览已上架活动图、一键复制文案、下载合成图。下载时服务端把本人关联码 PNG 贴进码栏后返回整图。子账号用户管理页只用纯关联码，不可进活动图。
 - 列表第一项「无」= 只用关联码。单选立即写入 `partner_account.activity_poster_id`（空=无）；用户管理主图按该选择展示，下次登录仍有效。下架/删除后回退为关联码。
 - 微信内下载失败则预览 + 长按保存（与关联码下载一致）。
 - 合伙人只看 `ACTIVE`；下架后列表不再出现。无关联码则不可下载并明确报错。

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

@@ -3,14 +3,14 @@
 > 基准：[`杜康好客-v4-PRD.md`](./杜康好客-v4-PRD.md)  
 > V3 进度仍见 [`杜康好客-v3-现状对照.md`](./杜康好客-v3-现状对照.md)，不混表。
 
-## 0. 总览（2026-09-01）
+## 0. 总览（2026-09-02）
 
 | 维度 | 结论 |
 |------|------|
-| 版本线 | **v4.0.7** HQ 活动图快链与勾选导出 |
+| 版本线 | **v4.0.9** 合伙人 H5 周结算、预付款、子账号用户管理 |
 | 订单佣金 | 区县归属已删除；只认关联 / 代下单选择 |
-| 账单 | 酒订单 / 核销订单分列；酒厂含现场提货，零应付仍出账（无需打款） |
+| 账单 | 酒订单 / 核销订单分列；合伙人改为周账（周一 08:00）；零元不同步合伙人；酒厂含现场提货，零应付仍出账（无需打款） |
-| 活动图 | HQ 上传底图/码栏/文案；合伙人选择写入库；HQ 可指定一张图为勾选主合伙人合成下载 |
+| 活动图 | HQ 上传底图/码栏/文案；合伙人选择写入库；HQ 可指定一张图为勾选主合伙人合成下载；子账号不可看活动图 |
 
 ## 1. 版本交付
 
@@ -20,6 +20,7 @@
 | 4.0.2 | [`活动图模板与关联码合成`](./杜康好客-v4.0.2-开发文档.md) | ✅ 已实现 |
 | 4.0.6 | [`酒厂对账核对`](./杜康好客-v4.0.6-开发文档.md) | ✅ 已实现 |
 | 4.0.7 | [`活动图快链与勾选导出`](./杜康好客-v4.0.7-开发文档.md) | ✅ 已实现 |
+| 4.0.9 | [`合伙人 H5 周结算与用户管理`](./杜康好客-v4.0.9-开发文档.md) | ✅ 已实现 |
 
 | 日期 | 说明 |
 |------|------|
@@ -29,3 +30,4 @@
 | 2026-08-30 | v4.0.2：HQ 活动图（底图 + 拖拽码栏 + 文案）；合伙人复制文案、下载合成关联码；选择写入库，用户管理主图下次登录仍显示 |
 | 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；预付款预估；子账号用户管理无活动图 |

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

@@ -0,0 +1,70 @@
+# 杜康好客 · v4.0.9 开发文档
+
+> **2026-09-02** · iam / store / settlement / h5-partner / mini-user / admin-web  
+> **主题**：合伙人 H5 子账号默认启用、关联码已扫码、零元账单过滤、银行账号自填、周结算、预付款预估、子账号用户管理（无活动图）
+
+需求事实源：[`杜康好客-v4-PRD.md`](./杜康好客-v4-PRD.md) §2 / §5 / §6
+
+---
+
+## 1. 版本目标
+
+| # | 任务 | 类型 | 交付 |
+|---|------|------|------|
+| 1 | 子账号默认开启 | 需求 | 创建后 `ACTIVE`，可立即登录 |
+| 2 | 已扫码数量 | 需求 | 关联码下展示已扫码 / 已关联；0 不显示 |
+| 3 | 零元账单 | 需求 | HQ 可生成待审核；不可发送；合伙人端不可见 |
+| 4 | 银行账号 | 需求 | 主账号合伙人中心填写收款人 / 账号 / 开户行 |
+| 5 | 周结算 | 需求 | 周一 08:00 出上周账；H5 展示账期与出账日 |
+| 6 | 预付款 | 需求 | 本周一至今酒单+核销×费率；首页与中心展示 |
+| 7 | 子账号用户管理 | 需求 | 可看用户管理、下载二维码；不可看活动图 |
+
+**不做**：子账号自己的码；回刷历史月账；预付款计入待结算；零元账单删除。
+
+---
+
+## 2. 规则
+
+- 已扫码：C 端带 `pa_{partnerId}` 进入即 +1（未登录也计）；同一进入会话只计一次。已关联仍为 first-lock 用户数。
+- 周账窗口：北京自然周 `[周一 00:00, 下周一 00:00)`。出账 cron：`0 8 * * 1` Asia/Shanghai，生成**上一完整周**。
+- 预付款窗口：本周一 00:00 ～ now。酒单用支付快照费率；核销用主账号当前核销费率。文案标明预估、以账单为准。
+- 零元：`totalAmount <= 0` 保持 `PENDING_REVIEW`，`send` 拒绝；合伙人 `list/get` 过滤。
+- 子账号 `GET /partner/assoc` 强制 `activityPosterId = null`。活动图 API 仍仅主账号。
+
+---
+
+## 3. 变更面
+
+- Prisma：`partner_account.assoc_scan_count`
+- C 端：`POST /user/partner-assoc/touch`；mini-user 捕获 `pa_` 时调用
+- 结算：周生成 / cycle / preview；零元 send 拦截
+- 主账号：`PUT /partner/me/bank`；`GET /partner/me` 返回银行字段
+- 合伙人 H5：用户管理统计、首页/中心预付款与账期、收款账户页、子账号 Tab
+- HQ：合伙人账单生成/筛选改为周
+
+---
+
+## 4. API
+
+| Method | Path | 说明 |
+|--------|------|------|
+| POST | `/user/partner-assoc/touch` | `{ scene, countScan? }` 未登录可调 |
+| GET | `/partner/assoc` | + `scanCount`；子账号无 `activityPosterId` |
+| GET | `/partner/settlement/cycle` | 本周账期 + 下次出账时间 |
+| GET | `/partner/settlement/preview` | 预付款预估 + 账期 |
+| GET | `/partner/settlement/bills` | 过滤 `totalAmount <= 0` |
+| PUT | `/partner/me/bank` | 主账号银行三字段 |
+| POST | `/admin/partner-bills/generate` | `{ partnerId, weekStartYmd }` |
+| POST | `/admin/partner-bills/generate-all` | `{ weekStartYmd }` |
+
+---
+
+## 5. 验收
+
+- [ ] 新建子账号创建后状态为 ACTIVE，可直接登录
+- [ ] C 端扫码进入（未登录）已扫码 +1；登录绑定后已关联 +1；用户管理页正确展示，0 不显示
+- [ ] 零元账单 HQ 可见 PENDING_REVIEW；发送被拒；合伙人 bills 列表/详情不可见
+- [ ] 主账号可填写/编辑银行三字段；HQ 同步可见
+- [ ] 首页/中心展示本周账期、下周一 08:00 出账、预付款预估（与手工核算抽样一致）
+- [ ] 每周一 08:00 自动生成上周账单（非月账）
+- [ ] 子账号 Tab 有用户管理；可下载二维码；无活动图入口/主图；主账号功能不变

packages/domain/src/dev-plan.test.ts

@@ -10,6 +10,7 @@ describe('taskStatusFromVersionStatus', () => {
     expect(taskStatusFromVersionStatus('IN_PROGRESS')).toBe('IN_PROGRESS');
     expect(taskStatusFromVersionStatus('TESTING')).toBe('DEVELOPED');
     expect(taskStatusFromVersionStatus('RELEASED')).toBe('RELEASED');
+    expect(taskStatusFromVersionStatus('STOPPED')).toBe('STOPPED');
   });
 });
 
@@ -22,4 +23,11 @@ describe('resolveTaskStatusFromVersions', () => {
     expect(resolveTaskStatusFromVersions(['PENDING', 'TESTING'])).toBe('DEVELOPED');
     expect(resolveTaskStatusFromVersions(['IN_PROGRESS', 'RELEASED'])).toBe('RELEASED');
   });
+
+  it('syncs STOPPED only when every linked version is stopped', () => {
+    expect(resolveTaskStatusFromVersions(['STOPPED'])).toBe('STOPPED');
+    expect(resolveTaskStatusFromVersions(['STOPPED', 'STOPPED'])).toBe('STOPPED');
+    expect(resolveTaskStatusFromVersions(['STOPPED', 'IN_PROGRESS'])).toBe('IN_PROGRESS');
+    expect(resolveTaskStatusFromVersions(['STOPPED', 'RELEASED'])).toBe('RELEASED');
+  });
 });

packages/domain/src/dev-plan.ts

@@ -1,5 +1,5 @@
-export type DevPlanTaskStatus = 'TODO' | 'IN_PROGRESS' | 'DEVELOPED' | 'RELEASED';
+export type DevPlanTaskStatus = 'TODO' | 'IN_PROGRESS' | 'DEVELOPED' | 'RELEASED' | 'STOPPED';
-export type DevPlanVersionStatus = 'PENDING' | 'IN_PROGRESS' | 'TESTING' | 'RELEASED';
+export type DevPlanVersionStatus = 'PENDING' | 'IN_PROGRESS' | 'TESTING' | 'RELEASED' | 'STOPPED';
 
 export function computeDurationMinutes(
   devStartedAt: Date | null | undefined,
@@ -63,13 +63,14 @@ export function taskCompletedAtOnStatus(
 }
 
 const TASK_STATUS_RANK: Record<DevPlanTaskStatus, number> = {
+  STOPPED: -1,
   TODO: 0,
   IN_PROGRESS: 1,
   DEVELOPED: 2,
   RELEASED: 3,
 };
 
-/** 版本状态 → 任务状态：待开始/开发中/测试中/已发布 ↔ 待处理/进行中/已开发/已发布 */
+/** 版本状态 → 任务状态：待开始/开发中/测试中/已发布/已停止 ↔ 待处理/进行中/已开发/已发布/已停止 */
 export function taskStatusFromVersionStatus(status: DevPlanVersionStatus): DevPlanTaskStatus {
   switch (status) {
     case 'PENDING':
@@ -80,15 +81,19 @@ export function taskStatusFromVersionStatus(status: DevPlanVersionStatus): DevPl
       return 'DEVELOPED';
     case 'RELEASED':
       return 'RELEASED';
+    case 'STOPPED':
+      return 'STOPPED';
   }
 }
 
-/** 任务挂多个版本时取进度最高的对应状态 */
+/** 任务挂多个版本时取进度最高的对应状态；仅当全部版本已停止时任务才为已停止 */
 export function resolveTaskStatusFromVersions(
   versionStatuses: DevPlanVersionStatus[],
 ): DevPlanTaskStatus | null {
   if (!versionStatuses.length) return null;
-  return versionStatuses
+  const active = versionStatuses.filter((s) => s !== 'STOPPED');
+  if (!active.length) return 'STOPPED';
+  return active
     .map(taskStatusFromVersionStatus)
     .reduce((highest, current) =>
       TASK_STATUS_RANK[current] > TASK_STATUS_RANK[highest] ? current : highest,

packages/domain/src/shanghai-date.test.ts

@@ -3,12 +3,16 @@ import {
   addShanghaiDays,
   isWineryIssueDay,
   listWineryIssueDays,
+  nextPartnerBillIssueAt,
   previousShanghaiMonth,
+  previousShanghaiWeek,
+  shanghaiBillPeriodYmds,
   shanghaiLaggedIssueWindow,
   shanghaiMonthLastInstant,
   shanghaiMonthRange,
   shanghaiPeriodYmds,
   shanghaiT1DayWindow,
+  shanghaiWeekRange,
   shanghaiWineryPeriodWindow,
   shanghaiYmd,
   startOfShanghaiDay,
@@ -145,3 +149,54 @@ describe('previousShanghaiMonth', () => {
     });
   });
 });
+
+describe('shanghaiWeekRange', () => {
+  it('周三落入当周周一至下周一', () => {
+    const { start, endExclusive } = shanghaiWeekRange(new Date('2026-09-02T04:00:00+08:00'));
+    expect(shanghaiYmd(start)).toBe('2026-08-31');
+    expect(shanghaiYmd(endExclusive)).toBe('2026-09-07');
+  });
+
+  it('周日仍属当周（周一为起点）', () => {
+    const { start } = shanghaiWeekRange(new Date('2026-09-06T23:00:00+08:00'));
+    expect(shanghaiYmd(start)).toBe('2026-08-31');
+  });
+});
+
+describe('previousShanghaiWeek', () => {
+  it('周一 08:00 取上一完整周', () => {
+    const prev = previousShanghaiWeek(new Date('2026-09-07T08:00:00+08:00'));
+    expect(shanghaiYmd(prev.start)).toBe('2026-08-31');
+    expect(shanghaiYmd(prev.endExclusive)).toBe('2026-09-07');
+  });
+});
+
+describe('nextPartnerBillIssueAt', () => {
+  it('周一 07:59 出账日为当日 08:00', () => {
+    const at = nextPartnerBillIssueAt(new Date('2026-09-07T07:59:00+08:00'));
+    expect(at.toISOString()).toBe(new Date('2026-09-07T08:00:00+08:00').toISOString());
+  });
+
+  it('周一 08:00 起指向下周一', () => {
+    const at = nextPartnerBillIssueAt(new Date('2026-09-07T08:00:00+08:00'));
+    expect(at.toISOString()).toBe(new Date('2026-09-14T08:00:00+08:00').toISOString());
+  });
+});
+
+describe('shanghaiBillPeriodYmds', () => {
+  it('周账展示周一至周日', () => {
+    const start = new Date('2026-08-31T00:00:00+08:00');
+    const end = new Date('2026-09-06T23:59:59.999+08:00');
+    expect(shanghaiBillPeriodYmds(start, end)).toEqual({
+      periodStart: '2026-08-31',
+      periodEnd: '2026-09-06',
+    });
+  });
+
+  it('无止日或跨度大时回退自然月', () => {
+    expect(shanghaiBillPeriodYmds(new Date('2026-08-01T00:00:00+08:00'))).toEqual({
+      periodStart: '2026-08-01',
+      periodEnd: '2026-08-31',
+    });
+  });
+});

packages/domain/src/shanghai-date.ts

@@ -127,3 +127,58 @@ export function shanghaiPeriodYmds(periodStart: Date): { periodStart: string; pe
     periodEnd: shanghaiYmd(new Date(endExclusive.getTime() - 1)),
   };
 }
+
+/** 0=周日 … 6=周六，按北京日历日 */
+export function shanghaiWeekday(d: Date): number {
+  return new Date(`${shanghaiYmd(d)}T12:00:00+08:00`).getUTCDay();
+}
+
+/** 北京自然周：周一 00:00 ～ 下周一 00:00（不含） */
+export function shanghaiWeekRange(anchor = new Date()): { start: Date; endExclusive: Date } {
+  const dayStart = startOfShanghaiDay(anchor);
+  const wd = shanghaiWeekday(dayStart);
+  const daysFromMonday = wd === 0 ? 6 : wd - 1;
+  const start = addShanghaiDays(dayStart, -daysFromMonday);
+  return { start, endExclusive: addShanghaiDays(start, 7) };
+}
+
+export function shanghaiWeekLastInstant(anchor = new Date()): Date {
+  return new Date(shanghaiWeekRange(anchor).endExclusive.getTime() - 1);
+}
+
+export function previousShanghaiWeek(anchor = new Date()): { start: Date; endExclusive: Date } {
+  return shanghaiWeekRange(addShanghaiDays(shanghaiWeekRange(anchor).start, -1));
+}
+
+/** 下一个合伙人出账时刻：周一 08:00（若尚未到本周一 08:00 则为当日） */
+export function nextPartnerBillIssueAt(anchor = new Date()): Date {
+  const { start } = shanghaiWeekRange(anchor);
+  const thisMonday8 = new Date(start.getTime() + 8 * 60 * 60 * 1000);
+  if (anchor.getTime() < thisMonday8.getTime()) return thisMonday8;
+  return new Date(addShanghaiDays(start, 7).getTime() + 8 * 60 * 60 * 1000);
+}
+
+export function shanghaiPeriodYmdsForWeek(periodStart: Date): { periodStart: string; periodEnd: string } {
+  const { start } = shanghaiWeekRange(periodStart);
+  return {
+    periodStart: shanghaiYmd(start),
+    periodEnd: shanghaiYmd(addShanghaiDays(start, 6)),
+  };
+}
+
+/** 周账用真实起止日；跨度超过 8 天则按月展示（兼容历史月账） */
+export function shanghaiBillPeriodYmds(
+  periodStart: Date,
+  periodEnd?: Date,
+): { periodStart: string; periodEnd: string } {
+  if (periodEnd) {
+    const days = shanghaiCalendarDaysBetween(periodStart, periodEnd);
+    if (days >= 0 && days <= 8) {
+      return {
+        periodStart: shanghaiYmd(periodStart),
+        periodEnd: shanghaiYmd(periodEnd),
+      };
+    }
+  }
+  return shanghaiPeriodYmds(periodStart);
+}

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

@@ -22,11 +22,11 @@ export const DEV_PLAN_TASK_TYPE_LABELS: Record<DevPlanTaskTypeDto, string> = {
 
 /** 开发计划任务状态 */
 
-export type DevPlanTaskStatusDto = 'TODO' | 'IN_PROGRESS' | 'DEVELOPED' | 'RELEASED';
+export type DevPlanTaskStatusDto = 'TODO' | 'IN_PROGRESS' | 'DEVELOPED' | 'RELEASED' | 'STOPPED';
 
 
 
-export const DEV_PLAN_TASK_STATUSES = ['TODO', 'IN_PROGRESS', 'DEVELOPED', 'RELEASED'] as const;
+export const DEV_PLAN_TASK_STATUSES = ['TODO', 'IN_PROGRESS', 'DEVELOPED', 'RELEASED', 'STOPPED'] as const;
 
 
 
@@ -40,17 +40,19 @@ export const DEV_PLAN_TASK_STATUS_LABELS: Record<DevPlanTaskStatusDto, string> =
 
   RELEASED: '已上线',
 
+  STOPPED: '已停止',
+
 };
 
 
 
 /** 开发计划版本状态 */
 
-export type DevPlanVersionStatusDto = 'PENDING' | 'IN_PROGRESS' | 'TESTING' | 'RELEASED';
+export type DevPlanVersionStatusDto = 'PENDING' | 'IN_PROGRESS' | 'TESTING' | 'RELEASED' | 'STOPPED';
 
 
 
-export const DEV_PLAN_VERSION_STATUSES = ['PENDING', 'IN_PROGRESS', 'TESTING', 'RELEASED'] as const;
+export const DEV_PLAN_VERSION_STATUSES = ['PENDING', 'IN_PROGRESS', 'TESTING', 'RELEASED', 'STOPPED'] as const;
 
 
 
@@ -64,6 +66,8 @@ export const DEV_PLAN_VERSION_STATUS_LABELS: Record<DevPlanVersionStatusDto, str
 
   RELEASED: '已上线',
 
+  STOPPED: '已停止',
+
 };
 
 

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/partner-assoc.ts

@@ -3,6 +3,18 @@ export type PartnerAssocBindRequest = {
   partnerId?: string;
 };
 
+export type PartnerAssocTouchRequest = {
+  scene?: string;
+  partnerId?: string;
+  countScan?: boolean;
+};
+
+export type PartnerAssocTouchResult = {
+  partnerId: string;
+  scanCounted: boolean;
+  scanCount: number;
+};
+
 export type PartnerAssocBindResult = {
   bound: boolean;
   alreadyBound: boolean;
@@ -14,9 +26,11 @@ export type PartnerAssocSummary = {
   partnerId: string;
   qrcodeUrl: string | null;
   userCount: number;
+  /** 关联码扫码进入次数（未登录也计） */
+  scanCount?: number;
   companyName?: string | null;
   name: string;
-  /** 所选活动图；空表示用户管理主图只用关联码 */
+  /** 所选活动图；空表示用户管理主图只用关联码；子账号恒为空 */
   activityPosterId?: string | null;
 };
 

packages/shared-types/src/partner.ts

@@ -21,12 +21,24 @@ export interface PartnerMe {
   managedWarehouseId?: string | null;
   /** 是否已配置仓库管理（无则不展示/不推送酒订单） */
   hasWarehouseAccess?: boolean;
+  /** 仅主账号：收款账户 */
+  bankAccount?: {
+    bankAccountName?: string | null;
+    bankAccountNo?: string | null;
+    bankBranch?: string | null;
+  };
 }
 
 export interface UpdatePartnerMeRequest {
   name?: string;
 }
 
+export interface UpdatePartnerBankRequest {
+  bankAccountName: string;
+  bankAccountNo: string;
+  bankBranch: string;
+}
+
 export interface PartnerStaffItem {
   id: string;
   name: string;

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;
@@ -147,6 +149,19 @@ export interface PartnerBillDto {
   rejectReason?: string | null;
 }
 
+export interface PartnerSettlementCycleDto {
+  periodStart: string;
+  periodEnd: string;
+  nextIssueAt: string;
+  cycleLabel: string;
+}
+
+export interface PartnerSettlementPreviewDto extends PartnerSettlementCycleDto {
+  prepaymentAmount: number;
+  orderCommissionEstimate: number;
+  redeemCommissionEstimate: number;
+}
+
 export type PartnerBillItemKind = 'ORDER' | 'REDEEM';
 
 export interface PartnerBillItemDto {
@@ -174,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;
@@ -189,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/weixin-sdk/src/index.ts

@@ -25,6 +25,7 @@ export { scanQrCode } from './scan';
 export { invokeWechatPay } from './pay';
 export { chooseWechatImages, canUseWechatChooseImage, formatChooseImageFailMessage } from './chooseImage';
 export type { ChooseWechatImageOptions } from './chooseImage';
+export { previewWechatImage, isHttpImageUrl } from './previewImage';
 export {
   setWechatShareData,
   canUseWechatShare,
@@ -53,6 +54,7 @@ import { getWechatLocation, getWechatLocationDetailed } from './location';
 import { scanQrCode } from './scan';
 import { invokeWechatPay } from './pay';
 import { chooseWechatImages } from './chooseImage';
+import { previewWechatImage } from './previewImage';
 import { setWechatShareData, shareViaWechatSdk } from './share';
 import {
   wechatLogin,
@@ -76,6 +78,7 @@ export function createWeixinSdk(config: WeixinSdkConfig) {
     scanQrCode: (options?: Parameters<typeof scanQrCode>[1]) => scanQrCode(config, options),
     chooseImages: (options?: Parameters<typeof chooseWechatImages>[1]) =>
       chooseWechatImages(config, options),
+    previewImage: (url: string) => previewWechatImage(config, url),
     pay: (prepay: Parameters<typeof invokeWechatPay>[0]) =>
       invokeWechatPay(prepay, {
         apiBase: config.apiBase ?? '/api/v1',

packages/weixin-sdk/src/previewImage.ts

@@ -0,0 +1,33 @@
+import { ensureJssdkReady } from './jssdk';
+import type { WeixinSdkConfig } from './types';
+
+export function isHttpImageUrl(url?: string | null): url is string {
+  return !!url && /^https?:\/\//i.test(url.trim());
+}
+
+/** 微信内预览图片，便于长按保存到相册（须是可公网访问的 http(s) 地址） */
+export async function previewWechatImage(config: WeixinSdkConfig, url: string): Promise<void> {
+  const href = url.trim();
+  if (!isHttpImageUrl(href)) {
+    throw new Error('图片地址无效');
+  }
+
+  await ensureJssdkReady({
+    apiBase: config.apiBase ?? '/api/v1',
+    clientApp: config.clientApp,
+    getAccessToken: config.getAccessToken,
+  });
+
+  if (!window.wx?.previewImage) {
+    throw new Error('微信预览图片不可用');
+  }
+
+  await new Promise<void>((resolve, reject) => {
+    window.wx!.previewImage!({
+      current: href,
+      urls: [href],
+      success: () => resolve(),
+      fail: (res) => reject(new Error(res?.errMsg || '预览失败')),
+    });
+  });
+}

packages/weixin-sdk/src/types.ts

@@ -58,6 +58,12 @@ export type WxApi = {
     success?: (res: { localData: string }) => void;
     fail?: (res: { errMsg: string }) => void;
   }) => void;
+  previewImage: (options: {
+    current: string;
+    urls: string[];
+    success?: () => void;
+    fail?: (res: { errMsg: string }) => void;
+  }) => void;
   updateAppMessageShareData: (options: {
     title: string;
     desc: string;
@@ -121,6 +127,7 @@ export const DEFAULT_JS_API_LIST = [
   'chooseWXPay',
   'chooseImage',
   'getLocalImgData',
+  'previewImage',
   'updateAppMessageShareData',
   'updateTimelineShareData',
   'onMenuShareAppMessage',

scripts/smoke-v3.mjs

@@ -269,10 +269,17 @@ async function main() {
   const partnerId = partners.items?.[0]?.id;
   if (partnerId) {
     const now = new Date();
+    const utc = new Date(now.toLocaleString('en-US', { timeZone: 'Asia/Shanghai' }));
+    const wd = utc.getDay();
+    const daysFromMonday = wd === 0 ? 6 : wd - 1;
+    utc.setDate(utc.getDate() - daysFromMonday - 7);
+    const y = utc.getFullYear();
+    const m = String(utc.getMonth() + 1).padStart(2, '0');
+    const d = String(utc.getDate()).padStart(2, '0');
     await req('HQ_WEB', '/admin/partner-bills/generate', {
       method: 'POST',
       token: admin.accessToken,
-      body: JSON.stringify({ partnerId, year: now.getFullYear(), month: now.getMonth() + 1 }),
+      body: JSON.stringify({ partnerId, weekStartYmd: `${y}-${m}-${d}` }),
     });
   }
 

server/dukang-api/prisma/migrate-dev-plan-stopped.sql

@@ -0,0 +1,6 @@
+-- 开发计划版本/任务增加「已停止」状态
+ALTER TABLE `dev_plan_version`
+  MODIFY COLUMN `status` ENUM('PENDING', 'IN_PROGRESS', 'TESTING', 'RELEASED', 'STOPPED') NOT NULL DEFAULT 'PENDING';
+
+ALTER TABLE `dev_plan_task`
+  MODIFY COLUMN `status` ENUM('TODO', 'IN_PROGRESS', 'DEVELOPED', 'RELEASED', 'STOPPED') NOT NULL DEFAULT 'TODO';

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-partner-assoc-scan-v409.sql

@@ -0,0 +1,4 @@
+-- v4.0.9：关联码已扫码计数
+
+ALTER TABLE `partner_account`
+  ADD COLUMN `assoc_scan_count` INT NOT NULL DEFAULT 0 AFTER `assoc_qrcode_resource_id`;

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

@@ -129,6 +129,7 @@ enum DevPlanTaskStatus {
   IN_PROGRESS
   DEVELOPED
   RELEASED
+  STOPPED
 }
 
 enum DevPlanVersionStatus {
@@ -136,6 +137,7 @@ enum DevPlanVersionStatus {
   IN_PROGRESS
   TESTING
   RELEASED
+  STOPPED
 }
 
 enum InvoiceTitleType {
@@ -266,6 +268,7 @@ enum HqAdminRole {
   FINANCE
   CUSTOMER_SERVICE
   CITY_STORE_SERVICE
+  DEVELOPER
 }
 
 enum HqPermissionEffect {
@@ -998,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)
@@ -1206,6 +1226,7 @@ model PartnerAccount {
   managedWarehouseId   BigInt?              @unique @map("managed_warehouse_id") @db.UnsignedBigInt
   assocQrcodeId        String?              @unique @map("assoc_qrcode_id") @db.VarChar(64)
   assocQrcodeResourceId BigInt?             @map("assoc_qrcode_resource_id") @db.UnsignedBigInt
+  assocScanCount       Int                  @default(0) @map("assoc_scan_count")
   activityPosterId     BigInt?              @map("activity_poster_id") @db.UnsignedBigInt
   /// 测试合伙人账号
   isTest               Boolean              @default(false) @map("is_test")
@@ -1539,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/common/system-config/system-config.registry.ts

@@ -144,8 +144,8 @@ export const SYSTEM_CONFIG_FIELDS: SystemConfigFieldMeta[] = [
     group: G.wechat_mini,
     type: 'string',
     requiresRestart: false,
-    placeholder: '3.4.15',
+    placeholder: '4.0.4',
-    description: 'semver 格式；客户端低于此版本时提示更新',
+    description: 'semver 格式（可带或不带 v）；客户端低于此版本时提示更新',
   },
   {
     key: 'USER_H5_URL',

server/dukang-api/src/integrations/wecom/wecom-bot-ai.service.ts

@@ -28,9 +28,9 @@ const TOOL_INSTRUCTION = [
   '- finance_payout · finance_withdrawal',
   '- dev_plan_tasks [状态] · dev_plan_versions [版本号]',
   '- dev_plan_task_create <BUG|REQUIREMENT|OPTIMIZATION> <描述>',
-  '- dev_plan_task_update_status <任务编号> <TODO|IN_PROGRESS|DEVELOPED|RELEASED>',
+  '- dev_plan_task_update_status <任务编号> <TODO|IN_PROGRESS|DEVELOPED|RELEASED|STOPPED>',
   '- dev_plan_version_create <版本号>',
-  '- dev_plan_version_update_status <版本号> <PENDING|IN_PROGRESS|TESTING|RELEASED>',
+  '- dev_plan_version_update_status <版本号> <PENDING|IN_PROGRESS|TESTING|RELEASED|STOPPED>',
   '- dev_plan_version_link_tasks <版本号> <任务编号1,任务编号2>',
   '- server_logs [关键词] · handbook_read [关键词]',
   '禁止输出 JSON、api 字段、「请稍等正在检索」等占位话术。',

server/dukang-api/src/integrations/wecom/wecom-bot-capability.service.ts

@@ -117,7 +117,7 @@ export class WecomBotCapabilityService {
     ) {
       const cmds: string[] = [];
       if (wecomBotHasPermission(bot, 'dev_plan.task.create')) cmds.push('`新建任务 BUG|需求|优化 <描述>`');
-      if (wecomBotHasPermission(bot, 'dev_plan.task.update_status')) cmds.push('`修改任务 <编号> TODO|IN_PROGRESS|DEVELOPED|RELEASED`');
+      if (wecomBotHasPermission(bot, 'dev_plan.task.update_status')) cmds.push('`修改任务 <编号> TODO|IN_PROGRESS|DEVELOPED|RELEASED|STOPPED`');
       lines.push('**开发任务管理**', cmds.join(' · '), '');
     }
     if (
@@ -1234,10 +1234,10 @@ export class WecomBotCapabilityService {
   private async updateDevPlanTaskStatus(bot: WecomBotRuntimeConfig, wecomUserId: string, input: string) {
     this.requirePerm(bot, 'dev_plan.task.update_status');
     const trimmed = input.trim();
-    if (!trimmed) return '请提供任务编号和状态，格式：`修改任务 STxxx TODO|IN_PROGRESS|DEVELOPED|RELEASED`';
+    if (!trimmed) return '请提供任务编号和状态，格式：`修改任务 STxxx TODO|IN_PROGRESS|DEVELOPED|RELEASED|STOPPED`';
 
     const parts = trimmed.split(/\s+/).filter(Boolean);
-    if (parts.length < 2) return '格式：`修改任务 <任务编号> <状态>`\n状态：TODO（待开发）· IN_PROGRESS（开发中）· DEVELOPED（已开发）· RELEASED（已上线）';
+    if (parts.length < 2) return '格式：`修改任务 <任务编号> <状态>`\n状态：TODO（待开发）· IN_PROGRESS（开发中）· DEVELOPED（已开发）· RELEASED（已上线）· STOPPED（已停止）';
 
     const [taskNo, rawStatus] = parts;
     const STATUS_ALIAS: Record<string, string> = {
@@ -1245,9 +1245,10 @@ export class WecomBotCapabilityService {
       IN_PROGRESS: 'IN_PROGRESS', in_progress: 'IN_PROGRESS', 开发中: 'IN_PROGRESS',
       DEVELOPED: 'DEVELOPED', developed: 'DEVELOPED', 已开发: 'DEVELOPED',
       RELEASED: 'RELEASED', released: 'RELEASED', 已发布: 'RELEASED', 已上线: 'RELEASED',
+      STOPPED: 'STOPPED', stopped: 'STOPPED', STOPED: 'STOPPED', stoped: 'STOPPED', 已停止: 'STOPPED',
     };
     const status = STATUS_ALIAS[rawStatus];
-    if (!status) return `未知状态「${rawStatus}」。可用：TODO（待开发）/ IN_PROGRESS（开发中）/ DEVELOPED（已开发）/ RELEASED（已上线）`;
+    if (!status) return `未知状态「${rawStatus}」。可用：TODO（待开发）/ IN_PROGRESS（开发中）/ DEVELOPED（已开发）/ RELEASED（已上线）/ STOPPED（已停止）`;
 
     const row = await this.prisma.devPlanTask.findFirst({ where: { taskNo } });
     if (!row) return `未找到任务「${taskNo}」`;
@@ -1271,7 +1272,7 @@ export class WecomBotCapabilityService {
     if (!trimmed) return '请提供版本号和状态，格式：`修改版本 v3.6.0 <状态>`';
 
     const parts = trimmed.split(/\s+/).filter(Boolean);
-    if (parts.length < 2) return '格式：`修改版本 <版本号> <状态>`\n状态：PENDING · IN_PROGRESS · TESTING · RELEASED';
+    if (parts.length < 2) return '格式：`修改版本 <版本号> <状态>`\n状态：PENDING · IN_PROGRESS · TESTING · RELEASED · STOPPED';
 
     const [versionNo, rawStatus] = parts;
     const STATUS_ALIAS: Record<string, string> = {
@@ -1279,9 +1280,10 @@ export class WecomBotCapabilityService {
       IN_PROGRESS: 'IN_PROGRESS', in_progress: 'IN_PROGRESS', 开发中: 'IN_PROGRESS',
       TESTING: 'TESTING', testing: 'TESTING', 测试中: 'TESTING',
       RELEASED: 'RELEASED', released: 'RELEASED', 已发布: 'RELEASED',
+      STOPPED: 'STOPPED', stopped: 'STOPPED', STOPED: 'STOPPED', stoped: 'STOPPED', 已停止: 'STOPPED',
     };
     const status = STATUS_ALIAS[rawStatus];
-    if (!status) return `未知状态「${rawStatus}」。可用：PENDING / IN_PROGRESS / TESTING / RELEASED`;
+    if (!status) return `未知状态「${rawStatus}」。可用：PENDING / IN_PROGRESS / TESTING / RELEASED / STOPPED`;
 
     const row = await this.prisma.devPlanVersion.findUnique({ where: { versionNo } });
     if (!row) return `未找到版本「${versionNo}」`;

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

@@ -7,7 +7,8 @@ import { AlertService } from '../common/alert/alert.service';
 /**
  * 财务对账单定时任务（Asia/Shanghai）
  * - 每日 08:00：酒厂 T+3 期账单（每 3 天出一期，纳入上期 3 天已完成已付订单）+ 近 45 日出账周期核对补漏 + 门店日账单
- * - 每月 1 日 08:00：合伙人上一自然月账单 + 物流承运商上一自然月对账
+ * - 每周一 08:00：合伙人上一自然周账单
+ * - 每月 1 日 08:00：物流承运商上一自然月对账
  * - 工作日 18:05：门店提现 T+0 审完预警（FIN-003）
  */
 @Injectable()
@@ -75,11 +76,11 @@ export class SettlementScheduler {
     }
   }
 
-  @Cron('0 8 1 * *', { timeZone: 'Asia/Shanghai' })
+  @Cron('0 8 * * 1', { timeZone: 'Asia/Shanghai' })
-  async handleMonthlyPartnerBills() {
+  async handleWeeklyPartnerBills() {
-    this.logger.log('Monthly partner bills job start');
+    this.logger.log('Weekly partner bills job start');
     try {
-      const result = await this.settlementService.generatePreviousMonthPartnerBills();
+      const result = await this.settlementService.generatePreviousWeekPartnerBills();
       this.logger.log(
         `Partner bills: total=${result.total} success=${result.success} failed=${result.failed}`,
       );
@@ -87,9 +88,9 @@ export class SettlementScheduler {
         this.alert.notify({
           level: 'P0',
           category: 'settlement',
-          title: '合伙人月账单部分失败',
+          title: '合伙人周账单部分失败',
           detail: `total=${result.total} success=${result.success} failed=${result.failed}`,
-          dedupeKey: `job_partner_bill|${new Date().toISOString().slice(0, 7)}`,
+          dedupeKey: `job_partner_bill|${new Date().toISOString().slice(0, 10)}`,
         });
       }
     } catch (e) {
@@ -97,11 +98,16 @@ export class SettlementScheduler {
       this.alert.notify({
         level: 'P0',
         category: 'settlement',
-        title: '合伙人月账单任务失败',
+        title: '合伙人周账单任务失败',
         detail: e instanceof Error ? e.message : String(e),
-        dedupeKey: `job_partner_bill|${new Date().toISOString().slice(0, 7)}`,
+        dedupeKey: `job_partner_bill|${new Date().toISOString().slice(0, 10)}`,
       });
     }
+  }
+
+  @Cron('0 8 1 * *', { timeZone: 'Asia/Shanghai' })
+  async handleMonthlyPartnerBills() {
+    this.logger.log('Monthly logistics bills job start');
     try {
       const logistics = await this.settlementService.generatePreviousMonthLogisticsBills();
       this.logger.log(

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,
+    { key: 'taskNo', header: '任务编号', value: (r) => r.taskNo },
-    row.type,
+    { key: 'type', header: '类型', value: (r) => r.type },
-    row.status,
+    { key: 'status', header: '状态', value: (r) => r.status },
-    row.content,
+    { key: 'content', header: '内容', value: (r) => r.content },
-    row.supportTicketNo,
+    { key: 'supportTicketNo', header: '关联工单', value: (r) => r.supportTicketNo },
-    row.creatorName,
+    { key: 'versions', header: '关联版本', value: (r) => r.versionNos },
-    row.createdAt,
+    { key: 'creatorName', header: '创建人', value: (r) => r.creatorName },
-    row.completedAt,
+    { key: 'createdAt', header: '创建时间', value: (r) => r.createdAt },
-    row.attachmentUrls.join(' '),
+    { 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([
 
@@ -826,9 +832,9 @@ export class DevPlanService {
 
         versionStatusTimestamps(
 
-          existing.status as 'PENDING' | 'IN_PROGRESS' | 'TESTING' | 'RELEASED',
+          existing.status,
 
-          dto.status as 'PENDING' | 'IN_PROGRESS' | 'TESTING' | 'RELEASED',
+          dto.status as DevPlanVersionStatus,
 
           {
 
@@ -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) =>
+    const exportRows = rows.map((r) => {
-      mapTaskToExportRow({
+      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/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/partner-staff.service.ts

@@ -115,7 +115,7 @@ export class PartnerStaffService {
         permissions,
         isPrimary: 0,
         parentAccountId: parent.id,
-        status: 'DISABLED',
+        status: 'ACTIVE',
       },
     });
 

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 = [
+const DELIVERY_TYPE_LABELS: Record<string, string> = {
-  '订单号',
+  LOCAL: '同城',
-  '下单时间',
+  CROSS_CITY: '跨城',
-  '状态',
+  ON_SITE_PICKUP: '现场提货',
-  '商品',
+};
-  '规格',
-  '数量',
-  '实付',
-  '好客权益',
-  '收货人',
-  '手机',
-  '收货地址',
-] as const;
 
 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,
+    { key: '订单号', header: '订单号', value: (r) => r.orderNo },
-    row.createdAt,
+    { key: '下单时间', header: '下单时间', value: (r) => r.createdAt },
-    row.status,
+    { key: '状态', header: '状态', value: (r) => r.status },
-    row.productName,
+    { key: '商品', header: '商品', value: (r) => r.productName },
-    row.productSpec,
+    { key: '规格', header: '规格', value: (r) => r.productSpec },
-    String(row.quantity),
+    { key: '数量', header: '数量', value: (r) => r.quantity },
-    row.payAmount.toFixed(2),
+    { key: '配送方式', header: '配送方式', value: (r) => r.deliveryType },
-    row.benefitBrief,
+    { key: '实付', header: '实付', value: (r) => r.payAmount.toFixed(2) },
-    row.receiverName,
+    { key: '运费', header: '运费', value: (r) => r.logisticsFee },
-    row.receiverPhone,
+    { key: '好客权益', header: '好客权益', value: (r) => r.benefitBrief },
-    row.address,
+    { 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({
+    const doc = new PDFDocument({ size: 'A4', layout: 'landscape', margin: 24, bufferPages: true });
-      size: 'A4',
+    doc.on('data', (c) => chunks.push(c as Buffer));
-      layout: 'landscape',
-      margin: 24,
-      bufferPages: true,
-    });
-    doc.on('data', (chunk) => chunks.push(chunk as Buffer));
     doc.on('end', () => resolve(Buffer.concat(chunks)));
     doc.on('error', reject);
-
+    doc.font(fontPath);
-    doc.registerFont('zh', fontPath);
+    doc.fontSize(10).text(cols.map((c) => c.header).join(' | '));
-    doc.font('zh');
+    doc.moveDown(0.5);
-
-    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);
     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);
+  const stamp = new Date().toISOString().slice(0, 10);
-  return `订单导出_${stamp}_${count}条.${format}`;
+  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);
+    const categoryIds = parseUniqueCategoryIds(dto.categoryIds);
-    await this.storeCategoryService.assertLeafCategoryId(categoryId);
+    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/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

@@ -1,5 +1,5 @@
-import { BadRequestException, Body, Controller, Get, Param, Post, Put, Query, UseGuards } from '@nestjs/common';
+import { BadRequestException, Body, Controller, ForbiddenException, Get, Param, Post, Put, Query, UseGuards } from '@nestjs/common';
-import { IsOptional, IsString } from 'class-validator';
+import { IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
 import { parseShanghaiYmd } from '@dukang/domain';
 import { DEFAULT_PARTNER_STORE_STAFF_PERMISSIONS } from '@dukang/shared-types';
 import { SettlementService } from './settlement.service';
@@ -20,11 +20,38 @@ class UpdatePartnerMeDto {
   name?: string;
 }
 
+class UpdatePartnerBankDto {
+  @IsString()
+  @IsNotEmpty({ message: '请填写收款人' })
+  @MaxLength(64)
+  bankAccountName!: string;
+
+  @IsString()
+  @IsNotEmpty({ message: '请填写银行账号' })
+  @MaxLength(32)
+  bankAccountNo!: string;
+
+  @IsString()
+  @IsNotEmpty({ message: '请填写开户行名称' })
+  @MaxLength(128)
+  bankBranch!: string;
+}
+
 @Controller('partner/settlement')
 @UseGuards(JwtAuthGuard, PartnerPrimaryGuard)
 export class SettlementController {
   constructor(private readonly settlementService: SettlementService) {}
 
+  @Get('cycle')
+  cycle() {
+    return this.settlementService.getPartnerSettlementCycle();
+  }
+
+  @Get('preview')
+  preview(@CurrentUser() user: AuthUser) {
+    return this.settlementService.getPartnerSettlementPreview(user.actorId);
+  }
+
   @Get('bills')
   bills(@CurrentUser() user: AuthUser) {
     return this.settlementService.listPartnerBills(user.actorId);
@@ -273,6 +300,7 @@ export class AdminStoreBillController {
       storeId: query.storeId,
       dateFrom: query.dateFrom,
       dateTo: query.dateTo,
+      columns: query.columns,
     });
   }
 
@@ -325,7 +353,9 @@ export class AdminPartnerBillController {
     refIdField: 'id',
     includeBody: true,
   })
-  generate(@Body() body: { partnerId: string; year: number; month: number }) {
+  generate(@Body() body: { partnerId: string; weekStartYmd: string }) {
+    if (!body?.weekStartYmd) throw new BadRequestException('请提供 weekStartYmd');
+    if (!body?.partnerId) throw new BadRequestException('请提供 partnerId');
     return this.settlementService.generatePartnerBill(body);
   }
 
@@ -336,7 +366,8 @@ export class AdminPartnerBillController {
     batch: true,
     includeBody: true,
   })
-  generateAll(@Body() body: { year: number; month: number }) {
+  generateAll(@Body() body: { weekStartYmd: string }) {
+    if (!body?.weekStartYmd) throw new BadRequestException('请提供 weekStartYmd');
     return this.settlementService.generateAllPartnerBills(body);
   }
 
@@ -349,6 +380,7 @@ export class AdminPartnerBillController {
       partnerId: query.partnerId,
       year: query.year ? Number(query.year) : undefined,
       month: query.month ? Number(query.month) : undefined,
+      weekStartYmd: query.weekStartYmd,
     });
   }
 
@@ -359,6 +391,8 @@ export class AdminPartnerBillController {
       status: query.status,
       year: query.year ? Number(query.year) : undefined,
       month: query.month ? Number(query.month) : undefined,
+      weekStartYmd: query.weekStartYmd,
+      columns: query.columns,
     });
   }
 
@@ -461,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,
     });
   }
 
@@ -543,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,
     });
   }
 
@@ -618,6 +654,29 @@ export class PartnerMeController {
     return this.buildPartnerMe(user.actorId);
   }
 
+  @Put('bank')
+  async updateBank(@CurrentUser() user: AuthUser, @Body() dto: UpdatePartnerBankDto) {
+    const account = await this.prisma.partnerAccount.findUniqueOrThrow({
+      where: { id: user.actorId },
+    });
+    if (account.isPrimary !== 1) {
+      throw new ForbiddenException('仅主账号可修改收款账户');
+    }
+    const bankAccountName = dto.bankAccountName.trim();
+    const bankAccountNo = dto.bankAccountNo.replace(/\s+/g, '');
+    const bankBranch = dto.bankBranch.trim();
+    if (!bankAccountName) throw new BadRequestException('请填写收款人');
+    if (!/^\d{8,32}$/.test(bankAccountNo)) {
+      throw new BadRequestException('请填写正确的银行账号');
+    }
+    if (!bankBranch) throw new BadRequestException('请填写开户行名称');
+    await this.prisma.partnerAccount.update({
+      where: { id: account.id },
+      data: { bankAccountName, bankAccountNo, bankBranch },
+    });
+    return this.buildPartnerMe(user.actorId);
+  }
+
   private async buildPartnerMe(actorId: bigint) {
     let account = await this.prisma.partnerAccount.findUniqueOrThrow({
       where: { id: actorId },
@@ -661,6 +720,14 @@ export class PartnerMeController {
       wxAvatarUrl: account.wxAvatarUrl ?? undefined,
       managedWarehouseId: primary.managedWarehouseId?.toString() ?? null,
       hasWarehouseAccess,
+      bankAccount:
+        account.isPrimary === 1
+          ? {
+              bankAccountName: account.bankAccountName,
+              bankAccountNo: account.bankAccountNo,
+              bankBranch: account.bankBranch,
+            }
+          : undefined,
     };
   }
 }

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

@@ -18,15 +18,21 @@ import {
   parseShanghaiYmd,
   pickPayoutsForWithdrawAmount,
   previousShanghaiMonth,
+  previousShanghaiWeek,
   resolveSettlementRate,
+  shanghaiBillPeriodYmds,
+  shanghaiCalendarDaysBetween,
   shanghaiMonthLastInstant,
   shanghaiMonthRange,
   shanghaiPeriodYmds,
+  shanghaiPeriodYmdsForWeek,
   shanghaiT1DayWindow,
+  shanghaiWeekRange,
   shanghaiWineryPeriodWindow,
   shanghaiYearMonth,
   shanghaiYmd,
   startOfShanghaiDay,
+  nextPartnerBillIssueAt,
   sumUnbilledPayoutAmount,
   validateStoreWithdraw,
   wineryIssueDateFromCompletedAt,
@@ -35,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';
@@ -80,7 +87,67 @@ function paymentProofUrlsInput(urls?: string[]): Prisma.InputJsonValue | typeof
 }
 
 function withShanghaiPeriod<T extends { periodStart: Date; periodEnd: Date }>(row: T) {
-  return { ...row, ...shanghaiPeriodYmds(row.periodStart) };
+  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;
+  endExclusive: Date;
+} {
+  const ymd = String(weekStartYmd || '').trim();
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(ymd)) {
+    throw new BadRequestException('请提供周起始日 weekStartYmd（YYYY-MM-DD）');
+  }
+  const start = parseShanghaiYmd(ymd);
+  const week = shanghaiWeekRange(start);
+  if (shanghaiYmd(week.start) !== ymd) {
+    throw new BadRequestException('账期起始日须为周一');
+  }
+  return {
+    periodStart: week.start,
+    periodEnd: new Date(week.endExclusive.getTime() - 1),
+    endExclusive: week.endExclusive,
+  };
+}
+
+function partnerSettlementCycleDto(anchor = new Date()) {
+  const { start } = shanghaiWeekRange(anchor);
+  const ymds = shanghaiPeriodYmdsForWeek(start);
+  return {
+    periodStart: ymds.periodStart,
+    periodEnd: ymds.periodEnd,
+    nextIssueAt: nextPartnerBillIssueAt(anchor).toISOString(),
+    cycleLabel: '每周一 08:00 出账',
+  };
 }
 
 function toPartnerBillItemDto(row: {
@@ -1392,14 +1459,20 @@ export class SettlementService implements OnModuleInit {
     const payoutAmount = rows.reduce((s, r) => s + r.amount, 0);
 
     return serializeBigInt({
-      items: slice.map((r) => ({
+      items: slice.map((r) => {
-        ...r,
+        const storeDates =
-        date: r.kind === 'T1_BILL' ? shanghaiYmd(r.date) : r.date,
+          r.kind === 'T1_BILL' ? mapStoreBillDates(r.date) : null;
-        bankAccount:
+        return {
-          r.kind === 'T1_BILL'
+          ...r,
-            ? bankMap.get(String(r.storeId)) ?? null
+          date: r.kind === 'T1_BILL' ? storeDates!.billDate : r.date,
-            : null,
+          periodStart: storeDates?.periodStart ?? null,
-      })),
+          periodEnd: storeDates?.periodEnd ?? null,
+          bankAccount:
+            r.kind === 'T1_BILL'
+              ? bankMap.get(String(r.storeId)) ?? null
+              : null,
+        };
+      }),
       total,
       page,
       pageSize,
@@ -1450,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,
@@ -1473,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),
     });
@@ -1531,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({
@@ -1542,44 +1616,70 @@ export class SettlementService implements OnModuleInit {
       this.prisma,
       bills.map((b) => b.storeId),
     );
-    const header = [
+    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}`;
-      '收款账号',
+        },
-      '开户行',
+      },
-    ].join(',');
+      { key: '门店', header: '门店', value: (r) => r.store.name },
-    const rows = bills.map((b) => {
+      { key: '登录手机', header: '登录手机', value: (r) => r.store.phone ?? '' },
-      const bank = bankMap.get(String(b.storeId));
+      { key: '城市', header: '城市', value: (r) => r.store.cityName ?? '' },
-      return [
+      { key: '收款户名', header: '收款户名', value: (r) => r.bank?.bankAccountName ?? '' },
-        csvEscape(b.billNo),
+      { key: '收款账号', header: '收款账号', value: (r) => r.bank?.bankAccountNo ?? '' },
-        shanghaiYmd(b.billDate),
+      { key: '笔数', header: '笔数', value: (r) => r.redeemCount },
-        csvEscape(b.store.name),
+      { key: '应付金额', header: '应付金额', value: (r) => Number(r.payoutAmount) },
-        csvEscape(b.store.cityName ?? ''),
+      { key: '核销金额', header: '核销金额', value: (r) => Number(r.redeemAmount) },
-        b.redeemCount,
+      { key: '结算比例', header: '结算比例', value: (r) => Number(r.settlementRate) },
-        Number(b.redeemAmount),
+      { key: '状态', header: '状态', value: (r) => r.status },
-        Number(b.settlementRate),
+      {
-        Number(b.payoutAmount),
+        key: '打款时间',
-        b.status,
+        header: '打款时间',
-        b.paidAt ? b.paidAt.toISOString().slice(0, 19).replace('T', ' ') : '',
+        value: (r) => (r.paidAt ? r.paidAt.toISOString().slice(0, 19).replace('T', ' ') : ''),
-        csvEscape(b.paymentRef ?? ''),
+      },
-        csvEscape(parsePaymentProofUrls(b.paymentProofUrls).join(' ')),
+      { key: '打款凭证', header: '打款凭证', value: (r) => r.paymentRef ?? '' },
-        csvEscape(bank?.bankAccountName ?? ''),
+      {
-        csvEscape(bank?.bankAccountNo ?? ''),
+        key: '打款凭证照片',
-        csvEscape(bank?.bankBranch ?? ''),
+        header: '打款凭证照片',
-      ].join(',');
+        value: (r) => parsePaymentProofUrls(r.paymentProofUrls).join(' '),
-    });
+      },
-    return { csv: `\uFEFF${[header, ...rows].join('\n')}`, count: bills.length };
+      { 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: {
@@ -1619,6 +1719,7 @@ export class SettlementService implements OnModuleInit {
       where: {
         partnerAccountId: primary.id,
         status: { in: ['AWAITING_CONFIRM', 'UNPAID', 'PAID', 'REJECTED'] },
+        totalAmount: { gt: 0 },
       },
       orderBy: { createdAt: 'desc' },
     });
@@ -1627,7 +1728,59 @@ 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()) {
+    return partnerSettlementCycleDto(anchor);
+  }
+
+  async getPartnerSettlementPreview(partnerAccountId: bigint) {
+    const primary = await this.partnerCityService.resolvePrimaryAccount(partnerAccountId);
+    const { start } = shanghaiWeekRange();
+    const now = new Date();
+    const periodEnd = now.getTime() < start.getTime() ? start : now;
+    const redeemCommissionRate = Number(primary.redeemCommissionRate ?? 0.03);
+
+    const orders = await this.prisma.order.findMany({
+      where: {
+        partnerAccountIdAtPay: primary.id,
+        payStatus: 'PAID',
+        paidAt: { gte: start, lte: periodEnd },
+      },
+      select: { payAmount: true, orderCommissionRateAtPay: true },
+    });
+    const orderCommission = round2(
+      orders.reduce((sum, o) => {
+        const rate = o.orderCommissionRateAtPay != null ? Number(o.orderCommissionRateAtPay) : 0;
+        return sum + Number(o.payAmount) * rate;
+      }, 0),
+    );
+
+    const stores = await this.prisma.store.findMany({
+      where: { partnerAccountId: primary.id },
+      select: { id: true },
+    });
+    const storeIds = stores.map((s) => s.id);
+    const redeems = !storeIds.length
+      ? []
+      : await this.prisma.redeemRecord.findMany({
+          where: {
+            storeId: { in: storeIds },
+            createdAt: { gte: start, lte: periodEnd },
+          },
+          select: { amount: true },
+        });
+    const redeemCommission = round2(
+      redeems.reduce((sum, r) => sum + Number(r.amount) * redeemCommissionRate, 0),
+    );
+
+    return {
+      ...partnerSettlementCycleDto(),
+      prepaymentAmount: round2(orderCommission + redeemCommission),
+      orderCommissionEstimate: orderCommission,
+      redeemCommissionEstimate: redeemCommission,
+    };
   }
 
   async getPartnerBill(partnerAccountId: bigint, billId: bigint) {
@@ -1637,6 +1790,7 @@ export class SettlementService implements OnModuleInit {
       include: { items: { orderBy: { occurredAt: 'asc' } } },
     });
     if (!bill) throw new NotFoundException('账单不存在');
+    if (Number(bill.totalAmount) <= 0) throw new NotFoundException('账单不存在');
     this.analyticsService.trackPartnerOneSafe(partnerAccountId, 'PARTNER_H5', {
       partnerAccountId: primary.id,
       eventName: 'partner_bill_detail_view',
@@ -1646,7 +1800,7 @@ export class SettlementService implements OnModuleInit {
     });
     const { items, ...header } = bill;
     return serializeBigInt({
-      ...withShanghaiPeriod(header),
+      ...withPartnerBillDates(header),
       partnerId: header.partnerAccountId.toString(),
       ...splitPartnerBillItems(items),
     });
@@ -1659,6 +1813,7 @@ export class SettlementService implements OnModuleInit {
     partnerId?: string;
     year?: number;
     month?: number;
+    weekStartYmd?: string;
   }) {
     const page = query.page ?? 1;
     const pageSize = query.pageSize ?? 20;
@@ -1693,7 +1848,7 @@ export class SettlementService implements OnModuleInit {
     ]);
 
     const items = rawItems.map((b) => ({
-      ...withShanghaiPeriod(b),
+      ...withPartnerBillDates(b),
       partner: b.partnerAccount,
     }));
 
@@ -1712,18 +1867,22 @@ export class SettlementService implements OnModuleInit {
     partnerId?: string;
     year?: number;
     month?: number;
+    weekStartYmd?: string;
   }): Prisma.PartnerBillWhereInput {
     const where: Prisma.PartnerBillWhereInput = {};
     if (query.status) where.status = query.status as Prisma.EnumPartnerBillStatusFilter['equals'];
     if (query.partnerId) where.partnerAccountId = BigInt(query.partnerId);
-    if (query.year && query.month) {
+    if (query.weekStartYmd) {
+      const { periodStart, endExclusive } = resolvePartnerWeekPeriod(query.weekStartYmd);
+      where.periodStart = { gte: periodStart, lt: endExclusive };
+    } else if (query.year && query.month) {
       const { start, endExclusive } = shanghaiMonthRange(query.year, query.month);
       where.periodStart = { gte: start, lt: endExclusive };
     }
     return where;
   }
 
-  async generateAllPartnerBills(body: { year: number; month: number }) {
+  async generateAllPartnerBills(body: { weekStartYmd: string }) {
     const partners = await this.prisma.partnerAccount.findMany({
       where: { isPrimary: 1, status: 'ACTIVE' },
       select: {
@@ -1752,8 +1911,7 @@ export class SettlementService implements OnModuleInit {
         const bill = await this.generatePartnerBill(
           {
             partnerId: p.id.toString(),
-            year: body.year,
+            weekStartYmd: body.weekStartYmd,
-            month: body.month,
           },
           { notify: false },
         );
@@ -1781,10 +1939,7 @@ export class SettlementService implements OnModuleInit {
         });
       }
     }
-    this.notifyPartnerBillDigest(
+    this.notifyPartnerBillDigest(body.weekStartYmd, created);
-      `${body.year}-${String(body.month).padStart(2, '0')}`,
-      created,
-    );
     return {
       total: partners.length,
       success: results.filter((r) => r.ok).length,
@@ -1793,10 +1948,15 @@ export class SettlementService implements OnModuleInit {
     };
   }
 
-  /** 每月 1 日任务：生成上一自然月账单 */
+  /** 每周一任务：生成上一自然周账单 */
+  async generatePreviousWeekPartnerBills(anchor = new Date()) {
+    const prev = previousShanghaiWeek(anchor);
+    return this.generateAllPartnerBills({ weekStartYmd: shanghaiYmd(prev.start) });
+  }
+
+  /** @deprecated 月账任务已改为周账 */
   async generatePreviousMonthPartnerBills(anchor = new Date()) {
-    const prev = previousShanghaiMonth(anchor);
+    return this.generatePreviousWeekPartnerBills(anchor);
-    return this.generateAllPartnerBills({ year: prev.year, month: prev.month });
   }
 
   async getAdminPartnerBill(id: bigint) {
@@ -1807,20 +1967,19 @@ 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),
     });
   }
 
   async generatePartnerBill(
-    body: { partnerId: string; year: number; month: number },
+    body: { partnerId: string; weekStartYmd: string },
     opts?: { notify?: boolean },
   ) {
     const partnerAccountId = BigInt(body.partnerId);
     const primary = await this.partnerCityService.resolvePrimaryAccount(partnerAccountId);
-    const { start: periodStart, endExclusive } = shanghaiMonthRange(body.year, body.month);
+    const { periodStart, periodEnd, endExclusive } = resolvePartnerWeekPeriod(body.weekStartYmd);
-    const periodEnd = shanghaiMonthLastInstant(body.year, body.month);
 
     const existing = await this.prisma.partnerBill.findFirst({
       where: {
@@ -1829,7 +1988,7 @@ export class SettlementService implements OnModuleInit {
       },
     });
     if (existing && existing.status !== 'PENDING_REVIEW') {
-      throw new BadRequestException('该月账单已进入审核流程，不可重复生成');
+      throw new BadRequestException('该账期账单已进入审核流程，不可重复生成');
     }
 
     if (!primary.cityId) {
@@ -1952,7 +2111,7 @@ export class SettlementService implements OnModuleInit {
         });
         cityName = city?.name?.trim() || '—';
       }
-      this.notifyPartnerBillDigest(`${body.year}-${String(body.month).padStart(2, '0')}`, [
+      this.notifyPartnerBillDigest(body.weekStartYmd, [
         {
           cityName,
           partnerLabel: formatPartnerDashLabel(primary.companyName, primary.name),
@@ -1981,6 +2140,9 @@ export class SettlementService implements OnModuleInit {
   async sendPartnerBill(id: bigint) {
     const bill = await this.prisma.partnerBill.findUnique({ where: { id } });
     if (!bill) throw new NotFoundException('账单不存在');
+    if (Number(bill.totalAmount) <= 0) {
+      throw new BadRequestException('零元账单不同步给合伙人');
+    }
     if (bill.status !== 'PENDING_REVIEW' && bill.status !== 'REJECTED') {
       throw new BadRequestException('仅待审核或已驳回账单可发送');
     }
@@ -2129,6 +2291,8 @@ export class SettlementService implements OnModuleInit {
     status?: string;
     year?: number;
     month?: number;
+    weekStartYmd?: string;
+    columns?: string;
   }) {
     const where = this.buildPartnerBillWhere(query);
     const bills = await this.prisma.partnerBill.findMany({
@@ -2137,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 = [
+    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),
-      '驳回理由',
+      },
-    ].join(',');
+      {
-    const rows = bills.map((b) =>
+        key: '账期',
-      [
+        header: '账期',
-        csvEscape(b.billNo),
+        value: (r) => {
-        csvEscape(b.partnerAccount.companyName ?? ''),
+          const p = shanghaiBillPeriodYmds(r.periodStart, r.periodEnd);
-        csvEscape(b.partnerAccount.phone ?? ''),
+          return `${p.periodStart} ~ ${p.periodEnd}`;
-        shanghaiPeriodYmds(b.periodStart).periodStart,
+        },
-        shanghaiPeriodYmds(b.periodStart).periodEnd,
+      },
-        Number(b.orderCommission),
+      { key: '酒单佣金', header: '酒单佣金', value: (r) => Number(r.orderCommission) },
-        Number(b.redeemCommission),
+      { key: '核销佣金', header: '核销佣金', value: (r) => Number(r.redeemCommission) },
-        Number(b.totalAmount),
+      { key: '合计应付', header: '合计应付', value: (r) => Number(r.totalAmount) },
-        b.status,
+      { key: '收款户名', header: '收款户名', value: (r) => r.partnerAccount.bankAccountName ?? '' },
-        b.sentAt ? shanghaiYmd(b.sentAt) : '',
+      { key: '收款账号', header: '收款账号', value: (r) => r.partnerAccount.bankAccountNo ?? '' },
-        b.confirmedAt ? shanghaiYmd(b.confirmedAt) : '',
+      { key: '状态', header: '状态', value: (r) => r.status },
-        b.paidAt ? shanghaiYmd(b.paidAt) : '',
+      { key: '登录手机', header: '登录手机', value: (r) => r.partnerAccount.phone ?? '' },
-        csvEscape(b.paymentRef ?? ''),
+      { key: '开户行', header: '开户行', value: (r) => r.partnerAccount.bankBranch ?? '' },
-        csvEscape(b.partnerAccount.bankAccountName ?? ''),
+      {
-        csvEscape(b.partnerAccount.bankAccountNo ?? ''),
+        key: '发送时间',
-        csvEscape(b.partnerAccount.bankBranch ?? ''),
+        header: '发送时间',
-        csvEscape(b.rejectReason ?? ''),
+        value: (r) => (r.sentAt ? shanghaiYmd(r.sentAt) : ''),
-      ].join(','),
+      },
-    );
+      {
+        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 aliases: Record<string, string> = {
-    const itemRows = bills.flatMap((b) =>
+      billNo: '账单号',
-      b.items.map((it) =>
+      billDate: '出账日',
-        [
+      period: '账期',
-          csvEscape(b.billNo),
+      orderCommission: '酒单佣金',
-          it.kind === 'ORDER' ? '酒订单' : '核销',
+      redeemCommission: '核销佣金',
-          csvEscape(it.refNo),
+      totalAmount: '合计应付',
-          csvEscape(it.title ?? ''),
+      status: '状态',
-          csvEscape(it.extra ?? ''),
+    };
-          Number(it.baseAmount),
+    const normalized = columnKeys?.map((k) => aliases[k] ?? k);
-          Number(it.rate),
+    return buildCsvFromColumns(defs, bills, normalized);
-          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 };
   }
 
   // ─── Winery bills ────────────────────────────────────
@@ -2573,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,
@@ -2581,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 },
@@ -2588,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 } = {}) {
@@ -2628,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 ?? ''),
+    type ExportRow = {
-      csvEscape(wineryBank.bankAccountName ?? ''),
+      billNo: string;
-      csvEscape(wineryBank.bankName ?? ''),
+      billDate: string;
-      csvEscape(wineryBank.bankBranch ?? ''),
+      periodStart: string;
-      csvEscape(wineryBank.bankAccountNo ?? ''),
+      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) {
+    const aliases: Record<string, string> = {
-        rows.push(
+      billNo: '账单号',
-          [
+      billDate: '出账日',
-            csvEscape(b.billNo),
+      period: '账期',
-            shanghaiYmd(b.billDate),
+      orderCount: '订单数',
-            '',
+      orderAmount: '订单总额',
-            '',
+      wineryRate: '酒厂比例',
-            Number(b.orderAmount),
+      wineryAmount: '应付',
-            Number(b.wineryRate),
+      status: '状态',
-            Number(b.wineryAmount),
+      paidAt: '打款时间',
-            '',
+      paymentRef: '打款凭证',
-            statusLabel(b),
+      bankAccountName: '收款户名',
-            ...bankCols(b),
+      bankName: '开户银行',
-          ].join(','),
+      bankBranch: '开户支行',
-        );
+      bankAccountNo: '收款账号',
-        continue;
+    };
-      }
+    const normalized = columnKeys?.map((k) => aliases[k] ?? k);
-      for (const item of b.items) {
+
-        rows.push(
+    return buildCsvFromColumns(defs, rows, normalized);
-          [
-            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 };
   }
 
   private buildWineryBillWhere(query: {
@@ -3262,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({
@@ -3277,78 +3475,73 @@ export class SettlementService implements OnModuleInit {
             bankAccountNo: true,
           },
         },
-        items: true,
       },
       orderBy: { periodStart: 'desc' },
     });
+    const columnKeys = parseExportColumnKeys(query.columns);
 
-    const header = [
+    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}`;
-      '开户银行',
+        },
-      '开户支行',
+      },
-      '收款账号',
+      {
-    ].join(',');
+        key: '结算方式',
-    const rows: string[] = [];
+        header: '结算方式',
-    for (const b of bills) {
+        value: (r) =>
-      const p = b.fulfillmentProvider;
+          LOGISTICS_SETTLEMENT_METHOD_LABELS[
-      const bankCols = [
+            r.settlementMethod as keyof typeof LOGISTICS_SETTLEMENT_METHOD_LABELS
-        csvEscape(b.paymentRef ?? ''),
+          ] || r.settlementMethod,
-        csvEscape(p.bankAccountName ?? ''),
+      },
-        csvEscape(p.bankName ?? ''),
+      { key: '订单数', header: '订单数', value: (r) => r.orderCount },
-        csvEscape(p.bankBranch ?? ''),
+      { key: '瓶数', header: '瓶数', value: (r) => r.bottleCount },
-        csvEscape(p.bankAccountNo ?? ''),
+      { key: '物流费', header: '物流费', value: (r) => Number(r.logisticsAmount) },
-      ];
+      {
-      if (b.items.length === 0) {
+        key: '收款户名',
-        rows.push(
+        header: '收款户名',
-          [
+        value: (r) => r.fulfillmentProvider.bankAccountName ?? '',
-            csvEscape(b.billNo),
+      },
-            csvEscape(p.code),
+      {
-            csvEscape(p.name),
+        key: '收款账号',
-            shanghaiPeriodYmds(b.periodStart).periodStart,
+        header: '收款账号',
-            shanghaiPeriodYmds(b.periodStart).periodEnd,
+        value: (r) => r.fulfillmentProvider.bankAccountNo ?? '',
-            b.settlementMethod,
+      },
-            '',
+      { key: '状态', header: '状态', value: (r) => r.status },
-            b.bottleCount,
+      {
-            Number(b.logisticsAmount),
+        key: '开户银行',
-            '',
+        header: '开户银行',
-            b.status,
+        value: (r) => r.fulfillmentProvider.bankName ?? '',
-            ...bankCols,
+      },
-          ].join(','),
+      {
-        );
+        key: '开户支行',
-        continue;
+        header: '开户支行',
-      }
+        value: (r) => r.fulfillmentProvider.bankBranch ?? '',
-      for (const item of b.items) {
+      },
-        rows.push(
+      { key: '打款凭证', header: '打款凭证', value: (r) => r.paymentRef ?? '' },
-          [
+    ];
-            csvEscape(b.billNo),
+
-            csvEscape(p.code),
+    const aliases: Record<string, string> = {
-            csvEscape(p.name),
+      billNo: '账单号',
-            shanghaiPeriodYmds(b.periodStart).periodStart,
+      period: '账期',
-            shanghaiPeriodYmds(b.periodStart).periodEnd,
+      settlementMethod: '结算方式',
-            b.settlementMethod,
+      orderCount: '订单数',
-            csvEscape(item.orderNo),
+      bottleCount: '瓶数',
-            item.quantity,
+      logisticsAmount: '物流费',
-            Number(item.logisticsAmount),
+      status: '状态',
-            item.shippedAt.toISOString().slice(0, 19).replace('T', ' '),
+    };
-            b.status,
+    const normalized = columnKeys?.map((k) => aliases[k] ?? k);
-            ...bankCols,
+    return buildCsvFromColumns(defs, bills, normalized);
-          ].join(','),
-        );
-      }
-    }
-    return { csv: `\uFEFF${[header, ...rows].join('\n')}`, count: rows.length };
   }
 
   private buildLogisticsBillWhere(query: {

server/dukang-api/src/modules/store/dto/assign-category.dto.ts

@@ -0,0 +1,12 @@
+import { IsString, IsNotEmpty, IsOptional, IsInt, Min } from 'class-validator';
+
+export class AssignCategoryDto {
+  @IsString()
+  @IsNotEmpty()
+  categoryId!: string;
+
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  priority?: number;
+}

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

@@ -1,8 +1,11 @@
 import { Body, Controller, Get, Param, Post, Put, Query, Res, UseGuards } from '@nestjs/common';
 import type { Response } from 'express';
-import { IsOptional, IsString, MaxLength } from 'class-validator';
+import { Transform } from 'class-transformer';
+import { IsBoolean, IsOptional, IsString, MaxLength } from 'class-validator';
 import { JwtAuthGuard, AuthUser } from '../../common/guards/jwt-auth.guard';
+import { OptionalJwtAuthGuard } from '../../common/guards/optional-jwt-auth.guard';
 import { PartnerPrimaryGuard } from '../../common/guards/partner-primary.guard';
+import { PartnerPermissionGuard } from '../../common/guards/partner-permission.guard';
 import { CurrentUser } from '../../common/decorators/current-user.decorator';
 import { PartnerAssocService } from './partner-assoc.service';
 
@@ -16,6 +19,17 @@ class BindPartnerAssocDto {
   partnerId?: string;
 }
 
+class TouchPartnerAssocDto extends BindPartnerAssocDto {
+  @IsOptional()
+  @Transform(({ value }) => {
+    if (value === false || value === 'false' || value === 0 || value === '0') return false;
+    if (value === true || value === 'true' || value === 1 || value === '1') return true;
+    return undefined;
+  })
+  @IsBoolean()
+  countScan?: boolean;
+}
+
 class PartnerAssocRemarkDto {
   @IsOptional()
   @IsString()
@@ -23,6 +37,21 @@ class PartnerAssocRemarkDto {
   remark?: string | null;
 }
 
+@Controller('user/partner-assoc')
+export class UserPartnerAssocPublicController {
+  constructor(private readonly assoc: PartnerAssocService) {}
+
+  @Post('touch')
+  @UseGuards(OptionalJwtAuthGuard)
+  touch(@Body() dto: TouchPartnerAssocDto) {
+    return this.assoc.touchScan({
+      scene: dto.scene,
+      partnerId: dto.partnerId,
+      countScan: dto.countScan,
+    });
+  }
+}
+
 @Controller('user/partner-assoc')
 @UseGuards(JwtAuthGuard)
 export class UserPartnerAssocController {
@@ -35,7 +64,7 @@ export class UserPartnerAssocController {
 }
 
 @Controller('partner/assoc')
-@UseGuards(JwtAuthGuard, PartnerPrimaryGuard)
+@UseGuards(JwtAuthGuard, PartnerPermissionGuard)
 export class PartnerAssocController {
   constructor(private readonly assoc: PartnerAssocService) {}