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

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

apps/admin-web/package.json

@@ -18,6 +18,7 @@
     "echarts": "^6.1.0",
     "echarts-for-react": "^3.0.6",
     "element-china-area-data": "^6.1.0",
+    "jspdf": "^4.2.1",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-router-dom": "^6.26.0"

apps/admin-web/src/App.tsx

@@ -51,6 +51,7 @@ import SystemSettingsPage from './pages/SystemSettingsPage';
 import TestWhitelistPage from './pages/TestWhitelistPage';
 import WecomBotsPage from './pages/WecomBotsPage';
 import WecomMessagePushesPage from './pages/WecomMessagePushesPage';
+import WecomReportsPage from './pages/WecomReportsPage';
 import WecomBotLogsPage from './pages/WecomBotLogsPage';
 import LlmConfigsPage from './pages/LlmConfigsPage';
 import KnowledgeBasesPage from './pages/KnowledgeBasesPage';
@@ -95,6 +96,7 @@ export default function App() {
         <Route path="/wecom-bots" element={<Navigate to="/wecom/bots" replace />} />
         <Route path="/wecom/bots" element={<WecomBotsPage />} />
         <Route path="/wecom/pushes" element={<WecomMessagePushesPage />} />
+        <Route path="/wecom/reports" element={<WecomReportsPage />} />
         <Route path="/logs/wecom-bots" element={<WecomBotLogsPage />} />
         <Route path="/llm-configs" element={<LlmConfigsPage />} />
         <Route path="/knowledge-bases" element={<KnowledgeBasesPage />} />

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

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

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

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

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

@@ -30,6 +30,7 @@ import { clearAuth, request, type HqProfile } from '../lib/api';
 import { bindAdminEllipsisTitle } from '../lib/ellipsis-title';
 import { AUDIT_NOTICE_CHANGED_EVENT, PACKAGE_AUDIT_CHANGED_EVENT } from '../lib/admin-events';
 import { ListColumnPrefsProvider } from '../lib/ListColumnPrefsContext';
+import { HqAccountSettingsModal } from '../components/HqAccountSettingsModal';
 
 const { Header, Sider, Content } = Layout;
 
@@ -128,6 +129,7 @@ const MENU_ITEMS: MenuProps['items'] = [
     children: [
       { key: '/wecom/bots', label: '智能机器人' },
       { key: '/wecom/pushes', label: '消息推送' },
+      { key: '/wecom/reports', label: '报告' },
     ],
   },
   { key: '/llm-configs', icon: <RobotOutlined />, label: '语言模型' },
@@ -185,6 +187,7 @@ function menuAllowed(key: string, permissionKeys: string[]): boolean {
     '/activity-posters': 'activity_posters',
     '/wecom/bots': 'wecom_bots',
     '/wecom/pushes': 'wecom_bots',
+    '/wecom/reports': 'wecom_bots',
     'wecom-group': 'wecom_bots',
     '/llm-configs': 'llm_configs',
     '/knowledge-bases': 'knowledge_bases',
@@ -292,6 +295,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 +423,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;
@@ -146,50 +147,12 @@ export type DashboardStats = {
   ordersByStatus: Array<{ status: string; count: number }>;
 };
 
-export type DashboardAnalytics = {
+export type {
-  summary: {
+  DashboardAnalytics,
-    users: number;
+  DashboardGranularity,
-    orders: number;
+  DashboardLineChart,
-    payingUsers: number;
+  DashboardLineHref,
-    partners: number;
+} from '@dukang/shared-types';
-    stores: number;
-    redeems: number;
-    redeemAmount: number;
-  };
-  byDate: Array<{
-    date: string;
-    users: number;
-    orders: number;
-    partners: number;
-    stores: number;
-    redeems: number;
-    redeemAmount: number;
-  }>;
-  byCity: Array<{
-    cityId: string;
-    cityName: string;
-    users: number;
-    orders: number;
-    partners: number;
-    stores: number;
-    redeems: number;
-    redeemAmount: number;
-  }>;
-  byPromo: Array<{
-    promoCodeId: string | null;
-    code: string;
-    name: string;
-    users: number;
-    orders: number;
-  }>;
-  byPartner: Array<{
-    partnerAccountId: string;
-    companyName: string;
-    stores: number;
-    redeems: number;
-    redeemAmount: number;
-  }>;
-};
 
 export type SystemVersion = {
   id: string;

apps/admin-web/src/lib/dashboard-charts-pdf.ts

@@ -0,0 +1,94 @@
+import type { ECharts } from 'echarts';
+
+const TITLE_FONT = 'bold 32px "Microsoft YaHei","PingFang SC","Noto Sans SC",sans-serif';
+const SUB_FONT = '22px "Microsoft YaHei","PingFang SC","Noto Sans SC",sans-serif';
+
+type ChartShot = {
+  title: string;
+  instance: ECharts | undefined;
+};
+
+function loadImage(src: string): Promise<HTMLImageElement> {
+  return new Promise((resolve, reject) => {
+    const img = new Image();
+    img.onload = () => resolve(img);
+    img.onerror = () => reject(new Error('图表截图失败'));
+    img.src = src;
+  });
+}
+
+async function composePage(params: {
+  chartPng: string;
+  title: string;
+  subtitle: string;
+}): Promise<{ dataUrl: string; width: number; height: number }> {
+  const img = await loadImage(params.chartPng);
+  const header = 96;
+  const canvas = document.createElement('canvas');
+  canvas.width = img.width;
+  canvas.height = img.height + header;
+  const ctx = canvas.getContext('2d');
+  if (!ctx) throw new Error('无法生成 PDF 画布');
+  ctx.fillStyle = '#ffffff';
+  ctx.fillRect(0, 0, canvas.width, canvas.height);
+  ctx.textBaseline = 'top';
+  ctx.fillStyle = '#1f1f1f';
+  ctx.font = TITLE_FONT;
+  ctx.fillText(params.title, 24, 16, canvas.width - 48);
+  ctx.fillStyle = '#8c8c8c';
+  ctx.font = SUB_FONT;
+  ctx.fillText(params.subtitle, 24, 56, canvas.width - 48);
+  ctx.drawImage(img, 0, header);
+  return {
+    dataUrl: canvas.toDataURL('image/jpeg', 0.92),
+    width: canvas.width,
+    height: canvas.height,
+  };
+}
+
+/** 把当前已渲染折线图打成横向 A4 PDF（不含 KPI / 待办）。 */
+export async function downloadDashboardChartsPdf(params: {
+  filename: string;
+  subtitle: string;
+  charts: ChartShot[];
+}): Promise<void> {
+  const ready = params.charts.filter((c): c is { title: string; instance: ECharts } => !!c.instance);
+  if (ready.length === 0) {
+    throw new Error('暂无可下载的图');
+  }
+  if (ready.length !== params.charts.length) {
+    throw new Error('图表尚未渲染完成，请稍后再试');
+  }
+
+  const { jsPDF } = await import('jspdf');
+  const pdf = new jsPDF({ orientation: 'landscape', unit: 'mm', format: 'a4' });
+  const pageW = pdf.internal.pageSize.getWidth();
+  const pageH = pdf.internal.pageSize.getHeight();
+  const margin = 10;
+
+  for (let i = 0; i < ready.length; i += 1) {
+    const chart = ready[i];
+    const png = chart.instance.getDataURL({
+      type: 'png',
+      pixelRatio: 2,
+      backgroundColor: '#ffffff',
+    });
+    const page = await composePage({
+      chartPng: png,
+      title: chart.title,
+      subtitle: params.subtitle,
+    });
+    const maxW = pageW - margin * 2;
+    const maxH = pageH - margin * 2;
+    const ratio = Math.min(maxW / page.width, maxH / page.height);
+    const w = page.width * ratio;
+    const h = page.height * ratio;
+    const x = (pageW - w) / 2;
+    const y = margin + (maxH - h) / 2;
+    if (i > 0) pdf.addPage();
+    pdf.addImage(page.dataUrl, 'JPEG', x, y, w, h);
+  }
+
+  const filename = params.filename.endsWith('.pdf') ? params.filename : `${params.filename}.pdf`;
+  pdf.save(filename);
+}

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/CityPartnersPage.tsx

@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useState } from 'react';
-import { Link, useNavigate } from 'react-router-dom';
+import { Link, useNavigate, useSearchParams } from 'react-router-dom';
 import {
   Alert,
   Button,
@@ -129,12 +129,18 @@ function formatApiError(err: unknown): string | null {
 
 export default function CityPartnersPage() {
   const navigate = useNavigate();
+  const [searchParams] = useSearchParams();
+  const initialCityId = searchParams.get('cityId')?.trim() || '';
   const [filterForm] = Form.useForm();
   const [editForm] = Form.useForm();
   const [createForm] = Form.useForm();
   const [subForm] = Form.useForm();
   const [subEditForm] = Form.useForm();
-  const [filters, setFilters] = useState<Record<string, string | boolean>>({});
+  const [filters, setFilters] = useState<Record<string, string | boolean>>(() => {
+    const init: Record<string, string | boolean> = {};
+    if (initialCityId) init.cityId = initialCityId;
+    return init;
+  });
   const { data, loading, page, pageSize, setPage, setPageSize, reload } = useAdminList<Row>(
     '/admin/partners',
     () => {
@@ -484,6 +490,7 @@ export default function CityPartnersPage() {
         form={filterForm}
         layout="inline"
         style={{ marginBottom: 16 }}
+        initialValues={initialCityId ? { cityId: initialCityId } : undefined}
         onFinish={(v) => {
           setFilters(v);
           setPage(1);

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

@@ -1,12 +1,23 @@
-import { useCallback, useEffect, useMemo, useState } from 'react';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { Link } from 'react-router-dom';
 import {
-  Button, Card, Col, DatePicker, Descriptions, Form, Modal, Row, Select, Space, Statistic, Table, Typography, message,
+  Button, Card, Col, DatePicker, Descriptions, Form, Modal, Row, Segmented, Select, Space, Statistic, Table, Typography, message,
 } from 'antd';
-import { CloudUploadOutlined, ReloadOutlined } from '@ant-design/icons';
+import { CloudUploadOutlined, DownloadOutlined, ReloadOutlined } from '@ant-design/icons';
 import dayjs, { type Dayjs } from 'dayjs';
 import ReactECharts from 'echarts-for-react';
-import type { EChartsOption } from 'echarts';
+import { getInstanceByDom, type EChartsOption } from 'echarts';
+import {
+  addShanghaiDays,
+  defaultShanghaiRangeYmds,
+  shanghaiMonthRange,
+  shanghaiQuarterIndex,
+  shanghaiQuarterRange,
+  shanghaiWeekRange,
+  shanghaiYearMonth,
+  shanghaiYmd,
+} from '@dukang/domain';
+import type { DashboardGranularity, DashboardLineChart, DashboardLineHref } from '@dukang/shared-types';
 import {
   request,
   type DashboardAnalytics,
@@ -17,6 +28,7 @@ import {
   type SystemVersion,
 } from '../lib/api';
 import { ADMIN_OPTIONS_PAGE_SIZE, fmtTime } from '../lib/constants';
+import { downloadDashboardChartsPdf } from '../lib/dashboard-charts-pdf';
 
 const STATUS_LABELS: Record<string, string> = {
   PENDING_PAY: '待付款',
@@ -36,26 +48,121 @@ const DEPLOYED_BY_LABELS: Record<string, string> = {
   admin: 'Admin 发布',
 };
 
+const GRAIN_OPTIONS: Array<{ label: string; value: DashboardGranularity }> = [
+  { label: '日', value: 'day' },
+  { label: '周', value: 'week' },
+  { label: '月', value: 'month' },
+  { label: '季', value: 'quarter' },
+  { label: '年', value: 'year' },
+];
+
+type ChartMetric = 'total' | 'increment';
+
+const METRIC_OPTIONS: Array<{ label: string; value: ChartMetric }> = [
+  { label: '总量', value: 'total' },
+  { label: '增量', value: 'increment' },
+];
+
+function toDayjsRange(from: Date, toInclusive: Date): [Dayjs, Dayjs] {
+  return [dayjs(shanghaiYmd(from)), dayjs(shanghaiYmd(toInclusive))];
+}
+
+/** 完整上一自然周 / 上月 / 上季（北京日历） */
+function datePresetRange(kind: 'lastWeek' | 'lastMonth' | 'lastQuarter'): [Dayjs, Dayjs] {
+  const today = new Date();
+  if (kind === 'lastWeek') {
+    const thisMonday = shanghaiWeekRange(today).start;
+    return toDayjsRange(addShanghaiDays(thisMonday, -7), addShanghaiDays(thisMonday, -1));
+  }
+  if (kind === 'lastMonth') {
+    const { year, month } = shanghaiYearMonth(today);
+    const prev = month === 1 ? { year: year - 1, month: 12 } : { year, month: month - 1 };
+    const r = shanghaiMonthRange(prev.year, prev.month);
+    return toDayjsRange(r.start, addShanghaiDays(r.endExclusive, -1));
+  }
+  const { year, quarter } = shanghaiQuarterIndex(today);
+  const prev = quarter === 1 ? { year: year - 1, quarter: 4 } : { year, quarter: quarter - 1 };
+  const r = shanghaiQuarterRange(prev.year, prev.quarter);
+  return toDayjsRange(r.start, addShanghaiDays(r.endExclusive, -1));
+}
+
+const DATE_PRESETS: Array<{ key: 'lastWeek' | 'lastMonth' | 'lastQuarter'; label: string }> = [
+  { key: 'lastWeek', label: '上周' },
+  { key: 'lastMonth', label: '上月' },
+  { key: 'lastQuarter', label: '上季度' },
+];
+
+function chartIsMetric(key: string, metric: ChartMetric): boolean {
+  const isInc = key.includes('.increment');
+  return metric === 'increment' ? isInc : !isInc;
+}
+
+const HREF_PATH: Record<DashboardLineHref, string> = {
+  users: '/users',
+  partners: '/city-partners',
+  stores: '/stores',
+  orders: '/orders',
+  redeems: '/redeem-records',
+};
+
 type CityOption = { id: string; name: string; code: string };
-type PromoOption = { id: string; code: string; name: string };
 
 type AnalyticsFilters = {
+  granularity: DashboardGranularity;
   range: [Dayjs, Dayjs];
   cityId?: string;
-  promoCodeId?: string;
-  partnerAccountId?: string;
 };
 
+function defaultRange(grain: DashboardGranularity): [Dayjs, Dayjs] {
+  const y = defaultShanghaiRangeYmds(grain);
+  return [dayjs(y.from), dayjs(y.to)];
+}
+
 function buildAnalyticsQs(f: AnalyticsFilters) {
   const qs = new URLSearchParams();
+  qs.set('granularity', f.granularity);
   qs.set('dateFrom', f.range[0].format('YYYY-MM-DD'));
   qs.set('dateTo', f.range[1].format('YYYY-MM-DD'));
   if (f.cityId) qs.set('cityId', f.cityId);
-  if (f.promoCodeId) qs.set('promoCodeId', f.promoCodeId);
-  if (f.partnerAccountId) qs.set('partnerAccountId', f.partnerAccountId);
   return qs.toString();
 }
 
+function listHref(kind: DashboardLineHref, f: AnalyticsFilters): string {
+  const qs = new URLSearchParams();
+  qs.set('createdFrom', f.range[0].format('YYYY-MM-DD'));
+  qs.set('createdTo', f.range[1].format('YYYY-MM-DD'));
+  if (f.cityId && f.cityId !== 'none') qs.set('cityId', f.cityId);
+  const s = qs.toString();
+  return s ? `${HREF_PATH[kind]}?${s}` : HREF_PATH[kind];
+}
+
+function lineOption(
+  periods: Array<{ key: string; label: string }>,
+  chart: DashboardLineChart,
+): EChartsOption {
+  return {
+    tooltip: { trigger: 'axis' },
+    legend: { type: 'scroll', top: 0 },
+    grid: { left: 56, right: 28, top: 48, bottom: periods.length > 14 ? 64 : 36 },
+    xAxis: {
+      type: 'category',
+      data: periods.map((p) => p.label),
+      axisLabel: { rotate: periods.length > 14 ? 45 : 0 },
+    },
+    yAxis: {
+      type: 'value',
+      minInterval: chart.unit === 'count' ? 1 : undefined,
+    },
+    series: chart.series.map((s) => ({
+      name: s.name,
+      type: 'line' as const,
+      smooth: true,
+      showSymbol: periods.length <= 24,
+      data: s.values,
+    })),
+  };
+}
+
 export default function DashboardPage() {
   const [stats, setStats] = useState<DashboardStats | null>(null);
   const [version, setVersion] = useState<SystemVersion | null>(null);
@@ -72,27 +179,27 @@ export default function DashboardPage() {
   const canStores = has('stores');
   const canStoreAudits = has('store_audits');
   const canPartners = has('partners');
-  const canPromo = has('promo_codes');
   const canFinance = has('finance');
   const canBenefit = has('benefit');
   const canDeliveries = has('deliveries');
   const canTickets = has('tickets');
   const permsReady = profile !== null;
+  const hasAnalytics = canUsers || canOrders || canPartners || canStores || canBenefit;
 
   const [filterForm] = Form.useForm<{
     range: [Dayjs, Dayjs];
     cityId?: string;
-    promoCodeId?: string;
-    partnerAccountId?: string;
   }>();
   const [filters, setFilters] = useState<AnalyticsFilters>({
-    range: [dayjs().subtract(29, 'day'), dayjs()],
+    granularity: 'day',
+    range: defaultRange('day'),
   });
   const [analytics, setAnalytics] = useState<DashboardAnalytics | null>(null);
   const [analyticsLoading, setAnalyticsLoading] = useState(true);
   const [cities, setCities] = useState<CityOption[]>([]);
-  const [promos, setPromos] = useState<PromoOption[]>([]);
+  const [metric, setMetric] = useState<ChartMetric>('total');
-  const [partners, setPartners] = useState<Array<{ id: string; companyName?: string | null; name: string }>>([]);
+  const [pdfLoading, setPdfLoading] = useState(false);
+  const chartsWrapRef = useRef<HTMLDivElement>(null);
 
   const loadVersion = useCallback(() => {
     setVersionLoading(true);
@@ -136,18 +243,6 @@ export default function DashboardPage() {
     void request<Paginated<CityOption>>(`/admin/cities?pageSize=${ADMIN_OPTIONS_PAGE_SIZE}`)
       .then((res) => setCities(res.items ?? []))
       .catch(() => setCities([]));
-    if ((profile.permissionKeys ?? []).includes('promo_codes')) {
-      void request<Paginated<PromoOption>>(`/admin/promo-codes?pageSize=${ADMIN_OPTIONS_PAGE_SIZE}`)
-        .then((res) => setPromos(res.items ?? []))
-        .catch(() => setPromos([]));
-    }
-    if ((profile.permissionKeys ?? []).includes('partners')) {
-      void request<Paginated<{ id: string; companyName?: string | null; name: string }>>(
-        `/admin/partners?pageSize=${ADMIN_OPTIONS_PAGE_SIZE}`,
-      )
-        .then((res) => setPartners(res.items ?? []))
-        .catch(() => setPartners([]));
-    }
   }, [profile]);
 
   useEffect(() => {
@@ -157,42 +252,22 @@ export default function DashboardPage() {
   function applyFilters(values: {
     range?: [Dayjs, Dayjs];
     cityId?: string;
-    promoCodeId?: string;
-    partnerAccountId?: string;
   }) {
-    const next: AnalyticsFilters = {
+    setFilters((prev) => ({
-      range: values.range ?? filters.range,
+      ...prev,
+      range: values.range ?? prev.range,
       cityId: values.cityId || undefined,
-      promoCodeId: values.promoCodeId || undefined,
+    }));
-      partnerAccountId: values.partnerAccountId || undefined,
-    };
-    setFilters(next);
   }
 
-  function setCityFilter(cityId: string) {
+  function setGranularity(granularity: DashboardGranularity) {
-    const next = { ...filters, cityId: cityId === filters.cityId ? undefined : cityId };
+    setFilters((prev) => ({ ...prev, granularity }));
-    filterForm.setFieldsValue({ cityId: next.cityId });
-    setFilters(next);
   }
 
-  function setPromoFilter(promoCodeId: string) {
+  function applyDatePreset(kind: 'lastWeek' | 'lastMonth' | 'lastQuarter') {
-    const key = promoCodeId === 'null' || promoCodeId === '' ? 'none' : promoCodeId;
+    const range = datePresetRange(kind);
-    const next = {
+    filterForm.setFieldsValue({ range });
-      ...filters,
+    setFilters((prev) => ({ ...prev, range }));
-      promoCodeId: key === filters.promoCodeId ? undefined : key,
-    };
-    filterForm.setFieldsValue({ promoCodeId: next.promoCodeId });
-    setFilters(next);
-  }
-
-  function setPartnerFilter(partnerAccountId: string) {
-    const next = {
-      ...filters,
-      partnerAccountId:
-        partnerAccountId === filters.partnerAccountId ? undefined : partnerAccountId,
-    };
-    filterForm.setFieldsValue({ partnerAccountId: next.partnerAccountId });
-    setFilters(next);
   }
 
   function handleDeploy() {
@@ -217,224 +292,51 @@ export default function DashboardPage() {
   }
 
   const shortSha = version?.commitId ? version.commitId.slice(0, 7) : '—';
+  const periods = analytics?.periods ?? [];
+  const chartOptions = useMemo(
+    () =>
+      (analytics?.charts ?? [])
+        .filter((chart) => chartIsMetric(chart.key, metric))
+        .map((chart) => ({
+          chart,
+          option: lineOption(periods, chart),
+        })),
+    [analytics, periods, metric],
+  );
 
-  const ordersDrillQs = useMemo(() => {
+  async function handleDownloadPdf() {
-    const qs = new URLSearchParams();
+    if (analyticsLoading || chartOptions.length === 0) {
-    qs.set('createdFrom', filters.range[0].format('YYYY-MM-DD'));
+      message.warning('暂无可下载的图');
-    qs.set('createdTo', filters.range[1].format('YYYY-MM-DD'));
+      return;
-    if (filters.cityId && filters.cityId !== 'none') qs.set('cityId', filters.cityId);
-    return qs.toString();
-  }, [filters]);
-
-  const byDateOption = useMemo<EChartsOption>(() => {
-    const rows = analytics?.byDate ?? [];
-    const legend: string[] = [];
-    const series: EChartsOption['series'] = [];
-    if (canUsers) {
-      legend.push('新增用户');
-      series.push({ name: '新增用户', type: 'line', smooth: true, data: rows.map((r) => r.users) });
     }
-    if (canOrders) {
+    const grainLabel = GRAIN_OPTIONS.find((o) => o.value === filters.granularity)?.label ?? filters.granularity;
-      legend.push('订单数');
+    const metricLabel = metric === 'increment' ? '增量' : '总量';
-      series.push({ name: '订单数', type: 'line', smooth: true, data: rows.map((r) => r.orders) });
+    const cityLabel = !filters.cityId
-    }
+      ? (cityScoped ? '全部负责城市' : '全部开城')
-    return {
+      : filters.cityId === 'none'
-      tooltip: { trigger: 'axis' },
+        ? '未选城'
-      legend: { data: legend },
+        : (cities.find((c) => c.id === filters.cityId)?.name ?? '城市');
-      grid: { left: 40, right: 20, top: 40, bottom: 40 },
+    const from = filters.range[0].format('YYYY-MM-DD');
-      xAxis: {
+    const to = filters.range[1].format('YYYY-MM-DD');
-        type: 'category',
+    setPdfLoading(true);
-        data: rows.map((r) => r.date.slice(5)),
+    try {
-        axisLabel: { rotate: rows.length > 14 ? 45 : 0 },
+      const doms = [
-      },
+        ...(chartsWrapRef.current?.querySelectorAll<HTMLElement>('[_echarts_instance_]') ?? []),
-      yAxis: { type: 'value', minInterval: 1 },
+      ];
-      series,
+      await downloadDashboardChartsPdf({
-    };
+        filename: `数据概览-${metricLabel}-${grainLabel}-${from}_${to}.pdf`,
-  }, [analytics, canUsers, canOrders]);
+        subtitle: `${metricLabel} · ${grainLabel} · ${from} ~ ${to} · ${cityLabel}`,
-
+        charts: chartOptions.map(({ chart }, index) => ({
-  const byCityOption = useMemo<EChartsOption>(() => {
+          title: chart.title,
-    const rows = analytics?.byCity ?? [];
+          instance: doms[index] ? getInstanceByDom(doms[index]) : undefined,
-    const legend: string[] = [];
+        })),
-    const series: EChartsOption['series'] = [];
-    if (canUsers) {
-      legend.push('用户');
-      series.push({ name: '用户', type: 'bar', data: rows.map((r) => r.users), barMaxWidth: 36 });
-    }
-    if (canOrders) {
-      legend.push('订单');
-      series.push({ name: '订单', type: 'bar', data: rows.map((r) => r.orders), barMaxWidth: 36 });
-    }
-    return {
-      tooltip: { trigger: 'axis' },
-      legend: { data: legend },
-      grid: { left: 48, right: 20, top: 40, bottom: 48 },
-      xAxis: {
-        type: 'category',
-        data: rows.map((r) => r.cityName),
-        axisLabel: { interval: 0, rotate: rows.length > 4 ? 30 : 0 },
-      },
-      yAxis: { type: 'value', minInterval: 1 },
-      series,
-    };
-  }, [analytics, canUsers, canOrders]);
-
-  const byPromoOption = useMemo<EChartsOption>(() => {
-    const rows = analytics?.byPromo ?? [];
-    const legend: string[] = [];
-    const series: EChartsOption['series'] = [];
-    if (canUsers) {
-      legend.push('用户');
-      series.push({ name: '用户', type: 'bar', data: rows.map((r) => r.users), barMaxWidth: 36 });
-    }
-    if (canOrders) {
-      legend.push('订单');
-      series.push({ name: '订单', type: 'bar', data: rows.map((r) => r.orders), barMaxWidth: 36 });
-    }
-    return {
-      tooltip: { trigger: 'axis' },
-      legend: { data: legend },
-      grid: { left: 48, right: 20, top: 40, bottom: 64 },
-      xAxis: {
-        type: 'category',
-        data: rows.map((r) => r.name || r.code),
-        axisLabel: { interval: 0, rotate: rows.length > 3 ? 30 : 0 },
-      },
-      yAxis: { type: 'value', minInterval: 1 },
-      series,
-    };
-  }, [analytics, canUsers, canOrders]);
-
-  const opsByDateOption = useMemo<EChartsOption>(() => {
-    const rows = analytics?.byDate ?? [];
-    const legend: string[] = [];
-    const series: NonNullable<EChartsOption['series']> = [];
-    if (canPartners) {
-      legend.push('新增合伙人');
-      series.push({ name: '新增合伙人', type: 'line', smooth: true, data: rows.map((r) => r.partners) });
-    }
-    if (canStores) {
-      legend.push('新签门店');
-      series.push({ name: '新签门店', type: 'line', smooth: true, data: rows.map((r) => r.stores) });
-    }
-    if (canBenefit) {
-      legend.push('核销笔数', '核销金额');
-      series.push({ name: '核销笔数', type: 'line', smooth: true, data: rows.map((r) => r.redeems) });
-      series.push({
-        name: '核销金额',
-        type: 'line',
-        smooth: true,
-        yAxisIndex: 1,
-        data: rows.map((r) => r.redeemAmount),
       });
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '下载 PDF 失败');
+    } finally {
+      setPdfLoading(false);
     }
-    return {
+  }
-      tooltip: { trigger: 'axis' },
-      legend: { data: legend },
-      grid: { left: 48, right: 48, top: 48, bottom: 40 },
-      xAxis: {
-        type: 'category',
-        data: rows.map((r) => r.date.slice(5)),
-        axisLabel: { rotate: rows.length > 14 ? 45 : 0 },
-      },
-      yAxis: [
-        { type: 'value', name: '数量', minInterval: 1 },
-        { type: 'value', name: '金额', minInterval: 1 },
-      ],
-      series,
-    };
-  }, [analytics, canPartners, canStores, canBenefit]);
-
-  const opsByCityOption = useMemo<EChartsOption>(() => {
-    const rows = analytics?.byCity ?? [];
-    const legend: string[] = [];
-    const series: EChartsOption['series'] = [];
-    if (canPartners) {
-      legend.push('合伙人');
-      series.push({ name: '合伙人', type: 'bar', data: rows.map((r) => r.partners), barMaxWidth: 28 });
-    }
-    if (canStores) {
-      legend.push('门店');
-      series.push({ name: '门店', type: 'bar', data: rows.map((r) => r.stores), barMaxWidth: 28 });
-    }
-    if (canBenefit) {
-      legend.push('核销笔数');
-      series.push({ name: '核销笔数', type: 'bar', data: rows.map((r) => r.redeems), barMaxWidth: 28 });
-    }
-    return {
-      tooltip: { trigger: 'axis' },
-      legend: { data: legend },
-      grid: { left: 48, right: 20, top: 40, bottom: 48 },
-      xAxis: {
-        type: 'category',
-        data: rows.map((r) => r.cityName),
-        axisLabel: { interval: 0, rotate: rows.length > 4 ? 30 : 0 },
-      },
-      yAxis: { type: 'value', minInterval: 1 },
-      series,
-    };
-  }, [analytics, canPartners, canStores, canBenefit]);
-
-  const opsByPartnerOption = useMemo<EChartsOption>(() => {
-    const rows = analytics?.byPartner ?? [];
-    const legend: string[] = [];
-    const series: NonNullable<EChartsOption['series']> = [];
-    if (canStores) {
-      legend.push('门店');
-      series.push({ name: '门店', type: 'bar', data: rows.map((r) => r.stores), barMaxWidth: 28 });
-    }
-    if (canBenefit) {
-      legend.push('核销笔数', '核销金额');
-      series.push({ name: '核销笔数', type: 'bar', data: rows.map((r) => r.redeems), barMaxWidth: 28 });
-      series.push({
-        name: '核销金额',
-        type: 'line',
-        yAxisIndex: 1,
-        data: rows.map((r) => r.redeemAmount),
-      });
-    }
-    return {
-      tooltip: { trigger: 'axis' },
-      legend: { data: legend },
-      grid: { left: 48, right: 48, top: 40, bottom: 64 },
-      xAxis: {
-        type: 'category',
-        data: rows.map((r) => r.companyName),
-        axisLabel: { interval: 0, rotate: rows.length > 3 ? 30 : 0 },
-      },
-      yAxis: [
-        { type: 'value', name: '数量', minInterval: 1 },
-        { type: 'value', name: '金额' },
-      ],
-      series,
-    };
-  }, [analytics, canStores, canBenefit]);
-
-  const redeemByCityOption = useMemo<EChartsOption>(() => {
-    const rows = analytics?.byCity ?? [];
-    return {
-      tooltip: { trigger: 'axis' },
-      legend: { data: ['核销笔数', '核销金额'] },
-      grid: { left: 48, right: 48, top: 40, bottom: 48 },
-      xAxis: {
-        type: 'category',
-        data: rows.map((r) => r.cityName),
-        axisLabel: { interval: 0, rotate: rows.length > 4 ? 30 : 0 },
-      },
-      yAxis: [
-        { type: 'value', name: '笔数', minInterval: 1 },
-        { type: 'value', name: '金额' },
-      ],
-      series: [
-        { name: '核销笔数', type: 'bar', data: rows.map((r) => r.redeems), barMaxWidth: 36 },
-        {
-          name: '核销金额',
-          type: 'line',
-          yAxisIndex: 1,
-          data: rows.map((r) => r.redeemAmount),
-        },
-      ],
-    };
-  }, [analytics]);
 
   return (
     <div>
@@ -574,7 +476,7 @@ export default function DashboardPage() {
       </Row>
 
       <Card
-        title="数据统计筛选"
+        title="全局筛选"
         style={{ marginBottom: 24 }}
         extra={
           <Button
@@ -592,8 +494,24 @@ export default function DashboardPage() {
           initialValues={{ range: filters.range }}
           onFinish={applyFilters}
         >
-          <Form.Item name="range" label="日期" rules={[{ required: true, message: '请选择日期' }]}>
+          <Form.Item label="粒度">
-            <DatePicker.RangePicker allowClear={false} />
+            <Segmented
+              options={GRAIN_OPTIONS}
+              value={filters.granularity}
+              onChange={(v) => setGranularity(v as DashboardGranularity)}
+            />
+          </Form.Item>
+          <Form.Item label="日期" required>
+            <Space size={8} wrap>
+              <Form.Item name="range" noStyle rules={[{ required: true, message: '请选择日期' }]}>
+                <DatePicker.RangePicker allowClear={false} />
+              </Form.Item>
+              {DATE_PRESETS.map((preset) => (
+                <Button key={preset.key} autoInsertSpace={false} onClick={() => applyDatePreset(preset.key)}>
+                  {preset.label}
+                </Button>
+              ))}
+            </Space>
           </Form.Item>
           <Form.Item name="cityId" label="城市">
             <Select
@@ -606,230 +524,49 @@ export default function DashboardPage() {
               ]}
             />
           </Form.Item>
-          {canPromo ? (
+          <Form.Item label="指标">
-            <Form.Item name="promoCodeId" label="推广码">
+            <Segmented
-              <Select
+              options={METRIC_OPTIONS}
-                allowClear
+              value={metric}
-                placeholder="全部来源"
+              onChange={(v) => setMetric(v as ChartMetric)}
-                style={{ width: 200 }}
+            />
-                options={[
+          </Form.Item>
-                  { value: 'none', label: '自然量 / 无推广码' },
-                  ...promos.map((p) => ({ value: p.id, label: `${p.name}（${p.code}）` })),
-                ]}
-              />
-            </Form.Item>
-          ) : null}
-          {canPartners ? (
-            <Form.Item name="partnerAccountId" label="合伙人">
-              <Select
-                allowClear
-                placeholder="全部合伙人"
-                style={{ width: 200 }}
-                options={partners.map((p) => ({
-                  value: p.id,
-                  label: p.companyName || p.name,
-                }))}
-              />
-            </Form.Item>
-          ) : null}
           <Form.Item>
             <Button type="primary" htmlType="submit">查询</Button>
           </Form.Item>
+          <Form.Item>
+            <Button
+              icon={<DownloadOutlined />}
+              loading={pdfLoading}
+              disabled={!hasAnalytics || analyticsLoading || chartOptions.length === 0}
+              onClick={() => void handleDownloadPdf()}
+            >
+              下载PDF
+            </Button>
+          </Form.Item>
         </Form>
       </Card>
 
-      {canUsers || canOrders ? (
+      {permsReady && !hasAnalytics ? (
-      <Card
+        <Card style={{ marginBottom: 24 }}>
-        title={canUsers && canOrders ? '用户 / 订单统计' : canUsers ? '用户统计' : '订单统计'}
+          <Typography.Text type="secondary">当前账号无可视指标</Typography.Text>
-        style={{ marginBottom: 24 }}
+        </Card>
-        extra={
-          <Space>
-            {canOrders ? <Link to={`/orders?${ordersDrillQs}`}>查看订单</Link> : null}
-            {canUsers ? <Link to="/users">查看用户</Link> : null}
-          </Space>
-        }
-      >
-        <Row gutter={[16, 16]} style={{ marginBottom: 16 }}>
-          {canUsers ? (
-            <Col xs={24} sm={8}>
-              <Statistic title="区间新增用户" value={analytics?.summary.users ?? 0} />
-            </Col>
-          ) : null}
-          {canOrders ? (
-            <Col xs={24} sm={8}>
-              <Statistic title="区间订单数" value={analytics?.summary.orders ?? 0} />
-            </Col>
-          ) : null}
-          {canOrders ? (
-            <Col xs={24} sm={8}>
-              <Statistic title="区间付费用户" value={analytics?.summary.payingUsers ?? 0} />
-            </Col>
-          ) : null}
-        </Row>
-
-        <Row gutter={[16, 16]}>
-          <Col xs={24}>
-            <Card type="inner" title="按日趋势" loading={analyticsLoading} size="small">
-              <ReactECharts option={byDateOption} style={{ height: 320 }} notMerge />
-            </Card>
-          </Col>
-          <Col xs={24} lg={canPromo ? 12 : 24}>
-            <Card
-              type="inner"
-              title="按城市（点击柱联动筛选）"
-              loading={analyticsLoading}
-              size="small"
-            >
-              <ReactECharts
-                option={byCityOption}
-                style={{ height: 300 }}
-                notMerge
-                onEvents={{
-                  click: (params: { name?: string }) => {
-                    const row = (analytics?.byCity ?? []).find((r) => r.cityName === params.name);
-                    if (row) setCityFilter(row.cityId);
-                  },
-                }}
-              />
-            </Card>
-          </Col>
-          {canPromo ? (
-          <Col xs={24} lg={12}>
-            <Card
-              type="inner"
-              title="按推广码（点击柱联动筛选）"
-              loading={analyticsLoading}
-              size="small"
-            >
-              <ReactECharts
-                option={byPromoOption}
-                style={{ height: 300 }}
-                notMerge
-                onEvents={{
-                  click: (params: { name?: string }) => {
-                    const row = (analytics?.byPromo ?? []).find(
-                      (r) => (r.name || r.code) === params.name,
-                    );
-                    if (row) setPromoFilter(row.promoCodeId ?? 'none');
-                  },
-                }}
-              />
-            </Card>
-          </Col>
-          ) : null}
-        </Row>
-      </Card>
       ) : null}
 
-      {canPartners || canStores || canBenefit ? (
+      {hasAnalytics ? (
-      <Card
+        <div ref={chartsWrapRef} style={{ marginBottom: 24 }}>
-        title={[canPartners && '合伙人', canStores && '门店', canBenefit && '核销'].filter(Boolean).join(' / ') + '统计'}
+          {chartOptions.map(({ chart, option }) => (
-        style={{ marginBottom: 24 }}
-        extra={
-          <Space>
-            {canPartners ? <Link to="/city-partners">查看合伙人</Link> : null}
-            {canStores ? <Link to="/stores">查看门店</Link> : null}
-            {canBenefit ? <Link to="/redeem-records">查看核销</Link> : null}
-          </Space>
-        }
-      >
-        <Row gutter={[16, 16]} style={{ marginBottom: 16 }}>
-          {canPartners ? (
-            <Col xs={24} sm={6}>
-              <Statistic title="区间新增合伙人" value={analytics?.summary.partners ?? 0} />
-            </Col>
-          ) : null}
-          {canStores ? (
-            <Col xs={24} sm={6}>
-              <Statistic title="区间新签门店" value={analytics?.summary.stores ?? 0} />
-            </Col>
-          ) : null}
-          {canBenefit ? (
-            <Col xs={24} sm={6}>
-              <Statistic title="区间核销笔数" value={analytics?.summary.redeems ?? 0} />
-            </Col>
-          ) : null}
-          {canBenefit ? (
-            <Col xs={24} sm={6}>
-              <Statistic title="区间核销金额" value={analytics?.summary.redeemAmount ?? 0} precision={2} />
-            </Col>
-          ) : null}
-        </Row>
-
-        <Row gutter={[16, 16]}>
-          <Col xs={24}>
-            <Card type="inner" title="按日趋势" loading={analyticsLoading} size="small">
-              <ReactECharts option={opsByDateOption} style={{ height: 320 }} notMerge />
-            </Card>
-          </Col>
-          <Col xs={24} lg={canBenefit ? 12 : 24}>
             <Card
-              type="inner"
+              key={chart.key}
-              title="按城市（点击柱联动筛选）"
+              title={chart.title}
+              extra={<Link to={listHref(chart.href, filters)}>查看</Link>}
               loading={analyticsLoading}
-              size="small"
+              style={{ marginBottom: 16 }}
             >
-              <ReactECharts
+              <ReactECharts option={option} style={{ height: 320, width: '100%' }} notMerge />
-                option={opsByCityOption}
-                style={{ height: 300 }}
-                notMerge
-                onEvents={{
-                  click: (params: { name?: string }) => {
-                    const row = (analytics?.byCity ?? []).find((r) => r.cityName === params.name);
-                    if (row) setCityFilter(row.cityId);
-                  },
-                }}
-              />
             </Card>
-          </Col>
+          ))}
-          {canBenefit ? (
+        </div>
-          <Col xs={24} lg={12}>
-            <Card
-              type="inner"
-              title="按城市核销金额"
-              loading={analyticsLoading}
-              size="small"
-            >
-              <ReactECharts
-                option={redeemByCityOption}
-                style={{ height: 300 }}
-                notMerge
-                onEvents={{
-                  click: (params: { name?: string }) => {
-                    const row = (analytics?.byCity ?? []).find((r) => r.cityName === params.name);
-                    if (row) setCityFilter(row.cityId);
-                  },
-                }}
-              />
-            </Card>
-          </Col>
-          ) : null}
-          {canPartners && (canStores || canBenefit) ? (
-          <Col xs={24}>
-            <Card
-              type="inner"
-              title="按合伙人（门店 / 核销，点击联动筛选）"
-              loading={analyticsLoading}
-              size="small"
-            >
-              <ReactECharts
-                option={opsByPartnerOption}
-                style={{ height: 320 }}
-                notMerge
-                onEvents={{
-                  click: (params: { name?: string }) => {
-                    const row = (analytics?.byPartner ?? []).find(
-                      (r) => r.companyName === params.name,
-                    );
-                    if (row) setPartnerFilter(row.partnerAccountId);
-                  },
-                }}
-              />
-            </Card>
-          </Col>
-          ) : null}
-        </Row>
-      </Card>
       ) : null}
 
       {canFinance || canTickets ? (

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;
@@ -325,6 +327,9 @@ export default function OrdersPage() {
   const [searchParams] = useSearchParams();
   const initialOrderNo = searchParams.get('orderNo')?.trim() || '';
   const initialPromoCodeId = searchParams.get('promoCodeId')?.trim() || '';
+  const initialCityId = searchParams.get('cityId')?.trim() || '';
+  const initialCreatedFrom = searchParams.get('createdFrom')?.trim() || '';
+  const initialCreatedTo = searchParams.get('createdTo')?.trim() || '';
   const initialStatusParam = searchParams.getAll('status').join(',');
   const initialStatuses = useMemo(
     () => initialStatusParam.split(',').map((s) => s.trim()).filter(Boolean),
@@ -387,6 +392,18 @@ export default function OrdersPage() {
     }
   }, [form, initialOrderNo]);
 
+  useEffect(() => {
+    const patch: { cityId?: string; dateRange?: [Dayjs, Dayjs] } = {};
+    if (initialCityId) patch.cityId = initialCityId;
+    if (
+      /^\d{4}-\d{2}-\d{2}$/.test(initialCreatedFrom) &&
+      /^\d{4}-\d{2}-\d{2}$/.test(initialCreatedTo)
+    ) {
+      patch.dateRange = [dayjs(initialCreatedFrom), dayjs(initialCreatedTo)];
+    }
+    if (Object.keys(patch).length) form.setFieldsValue(patch);
+  }, [form, initialCityId, initialCreatedFrom, initialCreatedTo]);
+
   useEffect(() => {
     if (initialStatuses.length) {
       form.setFieldsValue({ status: initialStatuses });
@@ -435,7 +452,7 @@ export default function OrdersPage() {
       const statusList = statuses.length ? statuses : initialStatuses;
       for (const status of statusList) qs.append('status', status);
       if (values.orderType) qs.set('orderType', values.orderType);
-      if (values.cityId) qs.set('cityId', values.cityId);
+      if (values.cityId || initialCityId) qs.set('cityId', values.cityId || initialCityId);
       if (values.receiverPhone) qs.set('receiverPhone', values.receiverPhone);
       if (values.userKeyword) qs.set('userKeyword', values.userKeyword);
       if (values.productKeyword) qs.set('productKeyword', values.productKeyword);
@@ -443,14 +460,16 @@ export default function OrdersPage() {
       if (values.deliveryType) qs.set('deliveryType', values.deliveryType);
       if (values.assocPartnerAccountId) qs.set('assocPartnerAccountId', values.assocPartnerAccountId);
       if (initialPromoCodeId) qs.set('promoCodeId', initialPromoCodeId);
-      if (values.dateRange?.[0]) qs.set('createdFrom', values.dateRange[0].format('YYYY-MM-DD'));
+      const createdFrom = values.dateRange?.[0]?.format('YYYY-MM-DD') || initialCreatedFrom;
-      if (values.dateRange?.[1]) qs.set('createdTo', values.dateRange[1].format('YYYY-MM-DD'));
+      const createdTo = values.dateRange?.[1]?.format('YYYY-MM-DD') || initialCreatedTo;
+      if (createdFrom) qs.set('createdFrom', createdFrom);
+      if (createdTo) qs.set('createdTo', createdTo);
       const res = await request<Paginated<AdminOrderRow>>(`/admin/orders?${qs}`);
       setData(res);
     } finally {
       setLoading(false);
     }
-  }, [form, page, pageSize, initialOrderNo, initialPromoCodeId, initialStatuses]);
+  }, [form, page, pageSize, initialOrderNo, initialPromoCodeId, initialStatuses, initialCityId, initialCreatedFrom, initialCreatedTo]);
 
   useEffect(() => {
     void load();
@@ -671,6 +690,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 +708,7 @@ export default function OrdersPage() {
   const baseColumns: ColumnsType<AdminOrderRow> = [
     {
       title: '订单号',
+      key: '订单号',
       dataIndex: 'orderNo',
       width: 180,
       render: (v, row) => (
@@ -699,7 +720,7 @@ export default function OrdersPage() {
     },
     {
       title: '用户',
-      key: 'user',
+      key: '用户',
       width: 200,
       render: (_, row) =>
         row.user?.id ? (
@@ -712,12 +733,20 @@ export default function OrdersPage() {
     },
     {
       title: '商品',
-      key: 'productName',
+      key: '商品',
       width: 180,
       render: (_, row) => (
         <Space size={4} wrap>
           <span>{row.productName || '—'}</span>
-          {row.fulfillmentHold ? <Tag color="orange">大单</Tag> : null}
+          {row.fulfillmentHold ? (
+            <Tag color="orange">
+              {row.fulfillmentHoldReason === 'LARGE_ORDER_GE_10_BOXES'
+                ? '大单'
+                : row.fulfillmentHoldReason === 'COURIER_OUT_OF_SERVICE'
+                  ? '超区'
+                  : '推单失败'}
+            </Tag>
+          ) : null}
           {row.orderType === 'PROXY' || row.isProxyOrder ? (
             <Tag color="purple">代下单</Tag>
           ) : null}
@@ -726,12 +755,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 +770,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 +786,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 +861,7 @@ export default function OrdersPage() {
     },
   ];
 
-  const { columns, settingsButton, settingsModal } = useAdminListColumns('orders', baseColumns, {
+  const { columns, settingsButton, settingsModal, exportColumnKeys } = useAdminListColumns('orders', baseColumns, {
     page,
     pageSize,
   });
@@ -1010,7 +1048,7 @@ export default function OrdersPage() {
               ) : <span />}
               <Space size={12} wrap>
                 <Form.Item name="fulfillmentHold" valuePropName="checked" noStyle>
-                  <Checkbox>大单拦截</Checkbox>
+                  <Checkbox>履约拦截</Checkbox>
                 </Form.Item>
                 <Button
                   onClick={() => {
@@ -1120,7 +1158,7 @@ export default function OrdersPage() {
                   {detail.fulfillmentHold ? (
                     <Tag color="orange">
                       {FULFILLMENT_HOLD_REASON_LABELS[detail.fulfillmentHoldReason || ''] ||
-                        '大单待确认'}
+                        '履约待确认'}
                     </Tag>
                   ) : null}
                   {detail.orderType === 'PROXY' || detail.isProxyOrder ? (
@@ -1517,10 +1555,16 @@ export default function OrdersPage() {
                 type="warning"
                 showIcon
                 style={{ marginBottom: 12 }}
-                message="大单已拦截自动推小飞侠"
+                message={
+                  shipTarget.fulfillmentHoldReason === 'LARGE_ORDER_GE_10_BOXES'
+                    ? '大单已拦截自动推小飞侠'
+                    : shipTarget.fulfillmentHoldReason === 'COURIER_OUT_OF_SERVICE'
+                      ? '小飞侠超出服务区'
+                      : '自动推配送失败'
+                }
                 description={
                   FULFILLMENT_HOLD_REASON_LABELS[shipTarget.fulfillmentHoldReason || ''] ||
-                  '≥10箱订单需总部确认：可选仓推小飞侠，或改用快递自配送。'
+                  '请确认后：可选仓重推小飞侠，或改用快递自配送。'
                 }
               />
             ) : null}

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

@@ -1,4 +1,5 @@
 import { useEffect, useState } from 'react';
+import { useNavigate } from 'react-router-dom';
 import {
   Button,
   Card,
@@ -14,6 +15,7 @@ import {
   Table,
   Tabs,
   Tag,
+  Tooltip,
   Typography,
   message,
 } from 'antd';
@@ -22,6 +24,7 @@ import dayjs, { type Dayjs } from 'dayjs';
 import { request, type Paginated } from '../lib/api';
 import { ADMIN_OPTIONS_PAGE_SIZE, fmtTime } from '../lib/constants';
 import { downloadExcelCsv } from '../lib/exportExcel';
+import { appendExportColumns } from '../lib/export-columns';
 import { useAdminList } from '../lib/useAdminList';
 import { useAdminListColumns } from '../lib/useAdminListColumns';
 import { AdminListHeader } from '../components/AdminListHeader';
@@ -48,6 +51,7 @@ type Row = {
   redeemCommission: number;
   totalAmount: number;
   status: string;
+  billDate: string;
   periodStart: string;
   periodEnd: string;
   rejectReason?: string | null;
@@ -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/WecomReportsPage.tsx

@@ -0,0 +1,239 @@
+import { useCallback, useEffect, useState } from 'react';
+import {
+  Button,
+  Card,
+  Form,
+  Input,
+  InputNumber,
+  Modal,
+  Select,
+  Space,
+  Switch,
+  Tabs,
+  TimePicker,
+  Typography,
+  message,
+} from 'antd';
+import dayjs, { type Dayjs } from 'dayjs';
+import {
+  WECOM_REPORT_KIND_LABELS,
+  WECOM_REPORT_KINDS,
+  WECOM_REPORT_WEEKDAY_OPTIONS,
+  type WecomReportKind,
+  type WecomReportPreviewDto,
+  type WecomReportPushDto,
+} from '@dukang/shared-types';
+import { request } from '../lib/api';
+import { fmtTime } from '../lib/constants';
+
+type FormValues = {
+  name: string;
+  webhookUrl: string;
+  enabled: boolean;
+  mentionWecomUserId?: string;
+  sendTime: Dayjs;
+  sendWeekday: number;
+  sendMonthDay: number;
+};
+
+function ReportKindPane({
+  kind,
+  row,
+  onSaved,
+}: {
+  kind: WecomReportKind;
+  row: WecomReportPushDto | undefined;
+  onSaved: () => void;
+}) {
+  const [form] = Form.useForm<FormValues>();
+  const [saving, setSaving] = useState(false);
+  const [previewing, setPreviewing] = useState(false);
+  const [sending, setSending] = useState(false);
+  const [preview, setPreview] = useState<WecomReportPreviewDto | null>(null);
+
+  useEffect(() => {
+    if (!row) return;
+    form.setFieldsValue({
+      name: row.name,
+      webhookUrl: row.webhookUrl,
+      enabled: row.enabled,
+      mentionWecomUserId: row.mentionWecomUserId ?? undefined,
+      sendTime: dayjs().hour(row.sendHour).minute(row.sendMinute).second(0),
+      sendWeekday: row.sendWeekday,
+      sendMonthDay: row.sendMonthDay,
+    });
+  }, [form, row]);
+
+  async function save() {
+    const values = await form.validateFields();
+    setSaving(true);
+    try {
+      await request(`/admin/wecom-reports/${kind}`, {
+        method: 'PUT',
+        body: JSON.stringify({
+          name: values.name,
+          webhookUrl: values.webhookUrl,
+          enabled: values.enabled,
+          mentionWecomUserId: values.mentionWecomUserId?.trim() || null,
+          sendHour: values.sendTime.hour(),
+          sendMinute: values.sendTime.minute(),
+          sendWeekday: values.sendWeekday,
+          sendMonthDay: values.sendMonthDay,
+        }),
+      });
+      message.success('已保存');
+      onSaved();
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '保存失败');
+    } finally {
+      setSaving(false);
+    }
+  }
+
+  async function openPreview() {
+    setPreviewing(true);
+    try {
+      const data = await request<WecomReportPreviewDto>(`/admin/wecom-reports/${kind}/preview`, {
+        method: 'POST',
+        body: '{}',
+      });
+      setPreview(data);
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '预览失败');
+    } finally {
+      setPreviewing(false);
+    }
+  }
+
+  async function sendNow() {
+    setSending(true);
+    try {
+      const res = await request<{ message: string }>(`/admin/wecom-reports/${kind}/send`, {
+        method: 'POST',
+        body: '{}',
+      });
+      message.success(res.message || '已发送');
+      onSaved();
+    } catch (e) {
+      message.error(e instanceof Error ? e.message : '发送失败');
+    } finally {
+      setSending(false);
+    }
+  }
+
+  const label = WECOM_REPORT_KIND_LABELS[kind];
+
+  return (
+    <>
+      <Form form={form} layout="vertical" style={{ maxWidth: 640 }}>
+        <Form.Item name="enabled" label="启用定时推送" valuePropName="checked">
+          <Switch />
+        </Form.Item>
+        <Form.Item name="name" label="名称" rules={[{ required: true, message: '请填写名称' }]}>
+          <Input maxLength={64} />
+        </Form.Item>
+        <Form.Item
+          name="webhookUrl"
+          label="群机器人 Webhook"
+          extra="企业微信群「群机器人」Webhook，与「消息推送」分开配置。"
+          rules={[{ required: true, message: '请填写 Webhook' }]}
+        >
+          <Input.TextArea rows={2} />
+        </Form.Item>
+        <Form.Item name="mentionWecomUserId" label="@成员 userid">
+          <Input placeholder="可选，企业微信成员账号" />
+        </Form.Item>
+        <Form.Item
+          name="sendTime"
+          label="发送时刻"
+          extra={
+            kind === 'daily'
+              ? '按北京时间当天该时刻发送当日数据。'
+              : kind === 'weekly'
+                ? '按北京时间该星期该时刻发送上一自然周。'
+                : '按北京时间每月该日该时刻发送上一自然月。'
+          }
+          rules={[{ required: true, message: '请选择时刻' }]}
+        >
+          <TimePicker format="HH:mm" minuteStep={1} allowClear={false} />
+        </Form.Item>
+        {kind === 'weekly' ? (
+          <Form.Item name="sendWeekday" label="发送星期" rules={[{ required: true }]}>
+            <Select options={WECOM_REPORT_WEEKDAY_OPTIONS} />
+          </Form.Item>
+        ) : null}
+        {kind === 'monthly' ? (
+          <Form.Item name="sendMonthDay" label="每月几号" rules={[{ required: true }]}>
+            <InputNumber min={1} max={31} />
+          </Form.Item>
+        ) : null}
+        <Typography.Paragraph type="secondary">
+          {row?.lastSentAt
+            ? `上次发送：${fmtTime(row.lastSentAt)}（${row.lastSentPeriod ?? '—'}）`
+            : '尚未发送'}
+        </Typography.Paragraph>
+        <Space wrap>
+          <Button type="primary" loading={saving} onClick={() => void save()}>
+            保存
+          </Button>
+          <Button loading={previewing} onClick={() => void openPreview()}>
+            预览
+          </Button>
+          <Button loading={sending} onClick={() => void sendNow()}>
+            立即发送
+          </Button>
+        </Space>
+      </Form>
+      <Modal
+        title={`预览${label}`}
+        open={!!preview}
+        onCancel={() => setPreview(null)}
+        footer={<Button onClick={() => setPreview(null)}>关闭</Button>}
+        width={560}
+      >
+        <Typography.Paragraph type="secondary">
+          区间 {preview?.rangeLabel}
+        </Typography.Paragraph>
+        <pre style={{ whiteSpace: 'pre-wrap', margin: 0 }}>{preview?.markdown}</pre>
+      </Modal>
+    </>
+  );
+}
+
+export default function WecomReportsPage() {
+  const [rows, setRows] = useState<WecomReportPushDto[]>([]);
+  const [loading, setLoading] = useState(true);
+
+  const load = useCallback(() => {
+    setLoading(true);
+    return request<WecomReportPushDto[]>('/admin/wecom-reports')
+      .then(setRows)
+      .catch((e) => message.error(e instanceof Error ? e.message : '加载失败'))
+      .finally(() => setLoading(false));
+  }, []);
+
+  useEffect(() => {
+    void load();
+  }, [load]);
+
+  const byKind = new Map(rows.map((r) => [r.kind, r]));
+
+  return (
+    <div>
+      <Typography.Title level={4}>企微机器人 · 报告</Typography.Title>
+      <Typography.Paragraph type="secondary">
+        日报 / 周报 / 月报走企微群机器人 Webhook，配置与「消息推送」相互独立。口径与概览一致：数量为期末存量，新增为区间内发生额；订单金额按已付
+        payAmount，核销按核销单。
+      </Typography.Paragraph>
+      <Card loading={loading}>
+        <Tabs
+          items={WECOM_REPORT_KINDS.map((kind) => ({
+            key: kind,
+            label: WECOM_REPORT_KIND_LABELS[kind],
+            children: <ReportKindPane kind={kind} row={byKind.get(kind)} onSaved={() => void load()} />,
+          }))}
+        />
+      </Card>
+    </div>
+  );
+}

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

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

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

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

apps/h5-partner/src/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/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/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/ProxyOrderPage.tsx

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

apps/h5-partner/src/pages/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

@@ -16,6 +16,8 @@ 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 };
 
@@ -38,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);
@@ -63,7 +67,7 @@ export default function UsersManagePage() {
   }, [previewUrl]);
 
   useEffect(() => {
-    const posterId = summary?.activityPosterId;
+    const posterId = hidePoster ? null : summary?.activityPosterId;
     if (!posterId) {
       setHeroUrl(null);
       setHeroLoading(false);
@@ -88,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');
@@ -130,7 +134,7 @@ 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);
@@ -190,14 +194,14 @@ 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
@@ -209,19 +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>
           {isWechatEnv() && (previewUrl || summary?.qrcodeUrl) ? (
             <p className="label-md text-muted" style={{ marginTop: 8 }}>
-              微信内请点「{summary?.activityPosterId ? '下载活动图' : '下载二维码'}」后长按保存
+              微信内请点「{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">
@@ -233,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">
@@ -264,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/mini-user/package.json

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

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

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

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

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

apps/mini-user/src/lib/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/region-data.ts

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

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

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

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

@@ -22,6 +22,7 @@ export function storeCategoryTags(
     tags?: unknown;
     categoryId?: string | null;
     category?: StoreCategoryLike | null;
+    categories?: StoreCategoryLike[] | null;
   },
   tree: StoreCategoryTreeNode[] = [],
 ): string[] {
@@ -30,24 +31,125 @@ export function storeCategoryTags(
     : [];
   if (fromJson.length) return fromJson;
 
-  const names: string[] = [];
+  const 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/pages/address-edit/index.tsx

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

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

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

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

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

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

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

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

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

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

@@ -42,7 +42,7 @@ import {
   toWeappShareTimeline,
 } from '../../lib/wechat-share';
 import BenefitSloganBar from '../../components/BenefitSloganBar';
-import { storeCategoryTags, storeStarCount } from '../../lib/store-display';
+import { storeCategoryTags, storeLeafCategoryIds, storeStarCount } from '../../lib/store-display';
 import openBadgeImg from '../../assets/icons/store-open-badge.png';
 
 type Store = {
@@ -66,6 +66,12 @@ type Store = {
     parentId?: string | null;
     parent?: { name?: string } | null;
   } | null;
+  categories?: {
+    id?: string;
+    name?: string;
+    parentId?: string | null;
+    parent?: { name?: string } | null;
+  }[] | null;
   tags?: unknown;
   rating?: number | string | null;
   latitude?: number | string | null;
@@ -288,14 +294,21 @@ export default function StoresPage() {
 
   function matchesCategory(store: Store): boolean {
     if (!category.parentId) return true;
-    const storeCatId = String(store.categoryId || store.category?.id || '');
+    const 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/address.css

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

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

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

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

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

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

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

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-PRD.md

@@ -34,6 +34,7 @@
 | 3.5.11 | 08-26 | 城市三种履约起购；企微通知补提交人/规格物流/核销用户（明文手机+备注）；结算任务失败通知 + 提现通过/四账单（城市合伙人、笔数、累计金额） | [`v3.5.11`](./杜康好客-v3.5.11-开发文档.md) |
 | 3.5.12 | 08-26 | 发布会订单大屏循环 BGM；HQ 日志/订单状态流转/用户行为时间线展示中文；修复删除门店分类被默认树回种；HQ 侧栏顺序（业务前 11 项，系统设置置底） | [`v3.5.12`](./杜康好客-v3.5.12-开发文档.md) |
 | 3.5.14 | 08-26 | 修复 C 端提交订单/支付成功日志误标 H5；线上 `order_submit`/`pay_success` 回填为小程序 | [`v3.5.14`](./杜康好客-v3.5.14-开发文档.md) |
+| 3.5.15 | 09-02 | 企微机器人「报告」：日报/周报/月报；Webhook 与消息推送分开 | [`v3.5.15`](./杜康好客-v3.5.15-开发文档.md) |
 
 **4.0 起**不再写入本表，见 [`v4-PRD`](./杜康好客-v4-PRD.md)。
 

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

@@ -32,7 +32,7 @@
 | **mini-user** | 购酒/权益/核销/门店/物流/版本门控 | 规则弹窗、发票、四类型工单、问卷 |
 | **h5-shop** | 扫码核销、记录、营业、iOS 扫码 OAuth | 手机号核销、提现、子账号、弱网兜底 |
 | **h5-partner** | 子账号、拓店、订单/账单、套餐 | 试核销100、负责人复核、代下单 |
-| **admin-web** | 商品/开城/门店/订单（含 Excel/PDF 导出）/权益/核销/结算/推广码 metrics/开发计划/技术支持 | 完整 SOP 审核 UI、发票、热力图 |
+| **admin-web** | 商品/开城/门店/订单（含 Excel/PDF 导出）/权益/核销/结算/推广码 metrics/开发计划/技术支持/企微报告 | 完整 SOP 审核 UI、发票、热力图 |
 | **后端** | 主模块、支付、权益、核销、payout、Courier 适配 | 30min 取消 job、部分 Wave3 |
 
 ## 3. 场景 SC-01~09

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

@@ -0,0 +1,74 @@
+# 杜康好客 · v3.5.15 开发文档
+
+> **2026-09-02** · ops / admin-web / domain / shared-types  
+> **主题**：企微机器人增加经营报告（日报 / 周报 / 月报）
+
+---
+
+## 1. 版本目标
+
+| # | 任务 | 类型 | 交付 |
+|---|------|------|------|
+| 1 | 报告模块 | 需求 | HQ「企微机器人 → 报告」，与「消息推送」分开 |
+| 2 | 三种报 | 需求 | 日报、周报、月报：存量 + 本期新增 |
+| 3 | 推送 | 需求 | 企微群机器人 Webhook markdown；可预览 / 立即发送 / 定时 |
+
+**不做**：并入消息推送条件、新权限键、城市范围裁剪、同比。
+
+---
+
+## 2. 规则
+
+配置在报告页，每种报一份 Webhook / 启用 / 发送时刻（周报另选星期，月报另选每月几号）。不占用「消息推送」的事件条件。
+
+口径（北京日历，与概览折线一致）：
+
+| 指标 | 存量 | 新增 |
+|------|------|------|
+| 用户数量 | `status=1` 且未合并，`createdAt` < 期末 | 区间内创建 |
+| 合伙人数量 | 主账号 `is_primary=1` | 区间内创建 |
+| 门店数量 | 全部门店 | 区间内创建 |
+| 订单数量 | 按下单 `createdAt` | 区间内下单 |
+| 订单金额 | 已付 `payAmount`（`paidAt`） | 区间内支付 |
+| 核销单数量 / 金额 | `RedeemRecord` | 区间内核销 |
+
+- **日报**：当天；默认 20:00 发送；新增文案「当日新增」。
+- **周报**：上一自然周（周一～周日）；默认周一 09:00。
+- **月报**：上一自然月；默认每月 1 日 09:00。
+
+错过发送时刻会在之后补发一次（按 `last_sent_period` 去重）。
+
+---
+
+## 3. API
+
+`GET /admin/wecom-reports`  
+`GET/PUT /admin/wecom-reports/:kind`（`daily` \| `weekly` \| `monthly`）  
+`POST /admin/wecom-reports/:kind/preview`  
+`POST /admin/wecom-reports/:kind/send`
+
+权限：`wecom_bots`。
+
+表 `wecom_report_push`（`kind` 唯一）。
+
+---
+
+## 4. 变更面
+
+| 层 | 路径 |
+|----|------|
+| domain | `wecom-report.ts` |
+| shared-types | `wecom-report.ts` |
+| Prisma | `WecomReportPush`；`prisma/migrate-wecom-report.ts` |
+| API | `admin-wecom-reports.*` |
+| HQ | `WecomReportsPage.tsx`；侧栏「报告」 |
+
+---
+
+## 5. 验收
+
+- [ ] 侧栏企微机器人下有「报告」，与消息推送分开
+- [ ] 日报/周报/月报可分别填 Webhook、启停、时刻并保存
+- [ ] 预览文案含用户/合伙人/门店/订单数量与金额/核销数量与金额的存量+新增
+- [ ] 立即发送走该报自己的 Webhook，不触发消息推送事件
+- [ ] 启用后到达时刻只发一次该周期

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）· HQ 概览（v4.0.14 / v4.0.15）**：[`杜康好客-v4-PRD.md`](./杜康好客-v4-PRD.md)，冲突时 **V4 > V3**。  
 > V2/preV1 **非需求依据**。总部交付 = **`apps/admin-web`**（非 H5）。
 
 ## 1. 交付目标（六条）
@@ -44,6 +44,10 @@ C 端购酒核销 · 门店扫码核销+打款 · 合伙人拓店履约 · WebAd
 
 **HQ 权限（v3.5.8）**：生效 =（角色 ∪ 追加）− 撤销。城市范围绑在账号上（空=全国；「城市门店服务」必须勾城）。门店 API 按 `cityIds` 强制过滤。城市门店服务可新增分类、不可删除；概览按权限与城市范围裁剪。
 
+**HQ 概览（v4.0.14 / v4.0.15）**：`GET /admin/dashboard/analytics` 支持日/周/月/季/年分桶；默认窗口为上一档起点～今天。全局筛城市+时间；日期快捷上周/上月/上季度；总量/增量单选分开展示。改粒度不改日期。查询右侧可下载当前折线图 PDF（不含 KPI/待办）。v4.0.15 起为多张全宽折线图：总量=桶末日存量，增量=桶内新增；用户线=推广码/关联合伙人/活动，门店线=关联合伙人，订单线=用户/关联合伙人/商品，核销线=门店/关联合伙人，合伙人单线。订单与核销同时出笔数和金额。关联合伙人=`assoc_partner_account_id`；活动=关联合伙人当前活动图。「查看」只带全局城市与日期。无权限模块后端不算不返回。时间按北京日历。
+
+**HQ 企微报告（v3.5.15）**：企微机器人下「报告」与「消息推送」分开。日报/周报/月报各配 Webhook 与发送时刻；走群机器人 markdown。日报=当天存量+当日新增；周报/月报=上一自然周/月期末存量+本期新增。用户=有效未合并；合伙人=主账号；订单金额=已付 `payAmount`（`paidAt`）；核销=`RedeemRecord`。
+
 **HQ 列表（v3.5.9）**：主表不省略号、可横滑；最左序号；列设置（显隐/顺序）与列宽（拖表头）存 `hq_account.list_column_prefs`。主展示列下划线，点击进编辑或详情。门店列表「累计核销好客权益」= 该店 `RedeemRecord.amount` 合计。用户列表昵称只读（点击进详情）；双击「备注」离开即保存（`hq_remark`）；列表手机号不脱敏。
 
 **C 端（v3.5.10）**：门店详情无顶栏分享按钮。同城送提示取开城仓库绑定承运商的 `delivery_hint_html`（`GET /catalog/local-deliveries`，按收货市是否开城）；空则回退「同城配送，预计24小时内送到」。在线客服优先 `wx.openCustomerServiceChat`（`CUSTOMER_SERVICE_WECOM_URL` + `WECOM_CORP_ID`）；未配 CorpID 回退小程序原生客服。
@@ -56,16 +60,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 周结算与用户管理；**v4.0.14** HQ 概览粒度；**v4.0.15** HQ 概览折线图  
-> 未改规则仍见 [`杜康好客-v3-PRD.md`](./杜康好客-v3-PRD.md)。**冲突时 V4 > V3**（本主题：订单佣金归属、关联码、合伙人账单明细、活动图、酒厂对账）。  
+> 未改规则仍见 [`杜康好客-v3-PRD.md`](./杜康好客-v3-PRD.md)。**冲突时 V4 > V3**（本主题：订单佣金归属、关联码、合伙人账单明细、活动图、酒厂对账、合伙人周结算、HQ 概览）。  
-> 实现：[`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.0.14 开发文档`](./杜康好客-v4.0.14-开发文档.md) · [`v4.0.15 开发文档`](./杜康好客-v4.0.15-开发文档.md) · 审计：[`v4-现状对照`](./杜康好客-v4-现状对照.md)
 
 ## 0. 版本
 
@@ -12,6 +12,9 @@
 | 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) |
+| 4.0.14 | 09-02 | HQ 概览：日/周/月/季/年、环比、全局城市/时间 + 五板块筛；订单/核销笔数与金额 | [`v4.0.14`](./杜康好客-v4.0.14-开发文档.md) |
+| 4.0.15 | 09-02 | HQ 概览改为全宽折线图：粒度分桶、总量/增量、维度线条；查看快链只带全局筛选 | [`v4.0.15`](./杜康好客-v4.0.15-开发文档.md) |
 
 ## 1. 锚点（沿用 V3，佣金归属改写）
 
@@ -30,7 +33,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 +62,7 @@
 
 ## 5. 合伙人账单
 
-月账（T+30）表头：`orderCommission` + `redeemCommission` = `totalAmount`。
+**周账**：每周一北京时间 **08:00** 出具上一完整自然周（周一 00:00 ～ 周日 23:59:59.999）账单。表头：`orderCommission` + `redeemCommission` = `totalAmount`。
 
 明细两段：
 
@@ -66,12 +73,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.15** HQ 概览折线图（粒度分桶、总量/增量、维度线条） |
 | 订单佣金 | 区县归属已删除；只认关联 / 代下单选择 |
-| 账单 | 酒订单 / 核销订单分列；酒厂含现场提货，零应付仍出账（无需打款） |
+| 账单 | 酒订单 / 核销订单分列；合伙人改为周账（周一 08:00）；零元不同步合伙人；酒厂含现场提货，零应付仍出账（无需打款） |
-| 活动图 | HQ 上传底图/码栏/文案；合伙人选择写入库；HQ 可指定一张图为勾选主合伙人合成下载 |
+| 活动图 | HQ 上传底图/码栏/文案；合伙人选择写入库；HQ 可指定一张图为勾选主合伙人合成下载；子账号不可看活动图 |
 
 ## 1. 版本交付
 
@@ -20,6 +20,10 @@
 | 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) | ✅ 已实现 |
+| 4.0.13 | [`收货地址把关与拒单可感知`](./杜康好客-v4.0.13-开发文档.md) | ✅ 已实现 |
+| 4.0.14 | [`HQ 概览粒度与环比`](./杜康好客-v4.0.14-开发文档.md) | ✅ 已实现 |
+| 4.0.15 | [`HQ 概览折线图`](./杜康好客-v4.0.15-开发文档.md) | ✅ 已实现 |
 
 | 日期 | 说明 |
 |------|------|
@@ -29,3 +33,7 @@
 | 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；预付款预估；子账号用户管理无活动图 |
+| 2026-09-02 | v4.0.13：收货禁「全市」；脏地址下单拦截；小飞侠超区/推单失败挂 `fulfillmentHold`（不做仓/收件坐标） |
+| 2026-09-02 | v4.0.14：HQ 概览日/周/月/季/年、环比；全局城市/时间 + 五板块筛；订单/核销笔数与金额 |
+| 2026-09-02 | v4.0.15：HQ 概览改为全宽折线图；去掉板块筛；查看快链只带全局城市与日期 |

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

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

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

@@ -0,0 +1,95 @@
+# 杜康好客 · v4.0.14 开发文档
+
+> **2026-09-02** · ops / admin-web / domain / shared-types  
+> **主题**：HQ 概览日/周/月/季/年分桶、环比、板块筛、订单/核销金额
+
+---
+
+## 1. 版本目标
+
+| # | 任务 | 类型 | 交付 |
+|---|------|------|------|
+| 1 | 时间粒度 | 体验 | `day/week/month/quarter/year` + 自选日期 |
+| 2 | 环比 | 需求 | 整段按粒度回退一档；上期 0 且本期 0 为 `—`，本期 > 0 为 `+100%` |
+| 3 | 筛选分层 | 体验 | 全局只筛城市 + 时间；五板块各自筛选 |
+| 4 | 金额 | 需求 | 订单/核销同时出笔数与金额 |
+| 5 | 权限 | 安全 | 无权限模块后端不算不返回；城市范围只看负责城 |
+
+**不做**：同比、测试单开关、新权限键、Prisma 迁移。
+
+---
+
+## 2. 规则
+
+### 2.1 筛选分层
+
+**全局**：粒度 + 日期 + 城市。环比窗口仍按全局日期、按粒度回退一档。
+
+**板块筛**（只影响本板块 KPI / 趋势该系列 / 城市该系列）：
+
+| 板块 | 筛选 | 口径 |
+|------|------|------|
+| 用户 | 推广码、关联合伙人、活动 | 推广码=`user_promo_attribution`；关联合伙人=`assoc_partner_account_id`；活动=关联合伙人当前所选活动图（`partner_account.activity_poster_id`） |
+| 合伙人 | 无 | 仅全局 |
+| 门店 | 合伙人 | 门店归属主合伙人 `store.partner_account_id` |
+| 订单 | 推广码、关联合伙人、活动、商品 | 推广码=`order.promo_code_id`；关联合伙人/活动同用户（下单用户）；商品=`order.product_id`。笔数=`createdAt`；金额=已付 `payAmount`（`paidAt`） |
+| 核销单 | 门店、关联合伙人 | 门店=`redeem.store_id`；关联合伙人=核销用户 `assoc_partner_account_id`。笔数与 `RedeemRecord.amount` |
+
+下拉：合伙人「企业-个人」；活动=活动图标题（需 `activity_posters`）。缺对应权限则忽略该筛。
+
+### 2.2 模块口径
+
+| 模块 | 权限键 | 数量 | 新增 | 金额 |
+|------|--------|------|------|------|
+| 用户 | `users` | 区间末日存量 | `createdAt` 落入区间 | 有 `orders` 时交叉付费用户 / 客单价（跟用户筛，不跟订单筛） |
+| 合伙人 | `partners` | 主账号期末存量 | 区间新签 | 交叉：支付时归属 GMV / 名下门店核销额（仅全局） |
+| 门店 | `stores` | 期末存量 | 区间新签 | 交叉：本板块门店筛下的核销额（需 `benefit`） |
+| 订单 | `orders` | 区间下单笔数 | 同左 | 已付 `payAmount` |
+| 核销单 | `benefit` | 区间核销笔数 | 同左 | `RedeemRecord.amount` |
+
+时间一律北京日历。周=周一～周日；季=自然季；年=自然年。
+
+默认窗口：日=昨天~今天；周=上周一~今天；月=上月 1 日~今天；季=上季首日~今天；年=去年 1 月 1 日~今天。
+
+### 2.3 权限与城市
+
+- 进页仍需 `dashboard`。
+- 无权限模块：后端不算、响应省略。
+- 城市范围：只统计负责城市；筛选项无「未选城」。
+
+---
+
+## 3. API
+
+`GET /admin/dashboard/analytics`
+
+全局：`granularity`、`dateFrom`、`dateTo`、`cityId`（`none`=用户未选城）。
+
+板块：`usersPromoCodeId`（`none`=无归因）、`usersPartnerAccountId`、`usersActivityPosterId`；`storesPartnerAccountId`；`ordersPromoCodeId`（`none`=无推广码）、`ordersPartnerAccountId`、`ordersActivityPosterId`、`ordersProductId`；`redeemsStoreId`、`redeemsPartnerAccountId`。
+
+响应：`granularity`、`range`、`prevRange`、`modules`、`byPeriod`、`byCity`、`byProduct`、`byPartner`。
+
+`GET /admin/dashboard/stats`、`/version` 不变。
+
+---
+
+## 4. 变更面
+
+| 层 | 路径 |
+|----|------|
+| domain | `dashboard-period.ts`（分桶 / 上期 / 环比） |
+| shared-types | `ops.ts` 概览 DTO |
+| API | `admin-dashboard.service.ts`、`admin-dashboard-analytics.ts`、`admin-query.dto.ts` |
+| HQ | `DashboardPage.tsx` |
+
+---
+
+## 5. 验收
+
+- [ ] 全局只有城市与时间；五板块筛互不影响
+- [ ] 日默认昨天~今天，环比为前天~昨天；周月季年按粒度回退一档
+- [ ] 订单/核销同时展示笔数与金额
+- [ ] 用户筛关联合伙人后只计 `assoc_partner_account_id`
+- [ ] 客服（仅 users/orders）：无合伙人/门店/核销卡
+- [ ] 待办卡与超管发版区行为不变
+- [ ] domain 周期/环比单测通过

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

@@ -0,0 +1,79 @@
+# 杜康好客 · v4.0.15 开发文档
+
+> **2026-09-02** · ops / admin-web / domain / shared-types  
+> **主题**：HQ 概览改为分指标折线图；全局筛选不变
+
+---
+
+## 1. 版本目标
+
+| # | 任务 | 类型 | 交付 |
+|---|------|------|------|
+| 1 | 横轴 | 体验 | 粒度 = 时间分桶（日/周/月/季/年） |
+| 2 | 纵轴 | 需求 | 总量 / 增量；订单与核销再拆笔数与金额 |
+| 3 | 线条 | 需求 | 用户：推广码 / 关联合伙人 / 活动；门店：关联合伙人；订单：用户 / 关联合伙人 / 商品；核销：门店 / 关联合伙人；合伙人无维度单线 |
+| 4 | 布局 | 体验 | 一图一行、宽度拉满；改全局筛选全部重绘 |
+| 5 | 快链 | 体验 | 「查看」只带全局城市 + 日期，不带线条维度 |
+
+**不做**：同比、板块筛、环比卡、Prisma 迁移、新权限键。
+
+---
+
+## 2. 规则
+
+**全局筛选**：粒度 + 日期 + 城市；日期旁快捷「上周 / 上月 / 上季度」；查询左侧总量 / 增量单选（互斥，只渲染对应折线图）；查询右侧「下载PDF」只导出当前指标下的折线图（不含 KPI / 待办 / 版本）。改粒度**不**改日期区间。
+
+**总量** = 该桶结束时的累计存量（含区间前基线）。**增量** = 落入该桶的新增/发生额。订单笔数按 `createdAt`，订单金额按已付 `payAmount`（`paidAt`）；核销按 `RedeemRecord`。
+
+**线条口径**（与 v4.0.14 归因一致）：
+
+| 板块 | 维度 | 字段 |
+|------|------|------|
+| 用户 | 推广码 | `user_promo_attribution`；空=自然量 |
+| 用户 | 关联合伙人 | `assoc_partner_account_id`；空=未关联 |
+| 用户 | 活动 | 关联合伙人当前 `activity_poster_id`；空=无活动 |
+| 门店 | 关联合伙人 | `store.partner_account_id` |
+| 订单 | 用户 | `order.user_id` |
+| 订单 | 关联合伙人 | 下单用户 `assoc_partner_account_id` |
+| 订单 | 商品 | `order.product_id` |
+| 核销 | 门店 | `redeem.store_id` |
+| 核销 | 关联合伙人 | 核销用户 `assoc_partner_account_id` |
+
+高基数维度：按期末存量 Top 10，长尾并入「其他」；`none` 有数据则始终保留。
+
+无对应权限则不返回该图；无任何维度权限时用户/门店/核销退回单线。城市范围只统计负责城。时间北京日历。
+
+---
+
+## 3. API
+
+`GET /admin/dashboard/analytics?granularity&dateFrom&dateTo&cityId`
+
+响应：`granularity`、`range`、`periods[]`、`charts[]`（`key/title/unit/href/series`）。不再返回 `modules` / `byPeriod` / `byCity` / `byProduct` / `byPartner` / 板块筛参数。
+
+`GET /admin/dashboard/stats`、`/version` 不变。
+
+---
+
+## 4. 变更面
+
+| 层 | 路径 |
+|----|------|
+| domain | `dashboard-series.ts`（累计 / TopN） |
+| shared-types | `ops.ts` 折线 DTO |
+| API | `admin-dashboard-lines.ts`、`admin-dashboard.service.ts`、`admin-query.dto.ts` |
+| HQ | `DashboardPage.tsx`；订单/合伙人列表消费快链城市与日期 |
+
+---
+
+## 5. 验收
+
+- [ ] 全局：粒度、日期、城市；日期快捷上周/上月/上季度；查询左侧总量/增量单选只出对应图
+- [ ] 查询右侧下载 PDF：仅当前总量或增量折线图；不含 KPI / 待办 / 版本
+- [ ] 改粒度不改日期区间；改全局筛选（除指标单选）全部折线重绘
+- [ ] 每个指标×维度一张全宽折线图；合伙人仅单线
+- [ ] 日粒度横轴为日期区间按日划分
+- [ ] 「查看」只带 `cityId` + `createdFrom/createdTo`，不带推广码/合伙人/商品等
+- [ ] 客服无合伙人/门店/核销图
+- [ ] 待办卡与超管发版区不变
+- [ ] domain 折线单测通过

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/dashboard-period.test.ts

@@ -0,0 +1,127 @@
+import { describe, expect, it } from 'vitest';
+import {
+  defaultShanghaiRange,
+  eachShanghaiBuckets,
+  periodMomRatio,
+  previousShanghaiRangeByGrain,
+  shanghaiBucketKey,
+  shanghaiQuarterIndex,
+  shanghaiQuarterRange,
+} from './dashboard-period';
+import { shanghaiYmd } from './shanghai-date';
+
+describe('shanghaiBucketKey', () => {
+  it('周跨年落到周一 2025-12-29', () => {
+    expect(shanghaiBucketKey(new Date('2026-01-02T04:00:00+08:00'), 'week')).toBe('2025-12-29');
+  });
+
+  it('Q4 → Q1 分属两年', () => {
+    expect(shanghaiBucketKey(new Date('2025-12-15T00:00:00+08:00'), 'quarter')).toBe('2025-Q4');
+    expect(shanghaiBucketKey(new Date('2026-01-02T00:00:00+08:00'), 'quarter')).toBe('2026-Q1');
+  });
+});
+
+describe('eachShanghaiBuckets', () => {
+  it('周跨年包含 2025-12-29 与 2026-01-05', () => {
+    const keys = eachShanghaiBuckets(
+      new Date('2025-12-31T00:00:00+08:00'),
+      new Date('2026-01-06T00:00:00+08:00'),
+      'week',
+    ).map((b) => b.key);
+    expect(keys).toEqual(['2025-12-29', '2026-01-05']);
+  });
+
+  it('季从 Q4 跨到 Q1', () => {
+    const keys = eachShanghaiBuckets(
+      new Date('2025-11-01T00:00:00+08:00'),
+      new Date('2026-02-01T00:00:00+08:00'),
+      'quarter',
+    ).map((b) => b.key);
+    expect(keys).toEqual(['2025-Q4', '2026-Q1']);
+  });
+});
+
+describe('previousShanghaiRangeByGrain', () => {
+  it('日：昨天~今天 的环比是 前天~昨天', () => {
+    const prev = previousShanghaiRangeByGrain(
+      new Date('2026-09-01T00:00:00+08:00'),
+      new Date('2026-09-02T00:00:00+08:00'),
+      'day',
+    );
+    expect(shanghaiYmd(prev.from)).toBe('2026-08-31');
+    expect(shanghaiYmd(prev.to)).toBe('2026-09-01');
+  });
+
+  it('周：整段回退 7 天', () => {
+    const prev = previousShanghaiRangeByGrain(
+      new Date('2026-08-24T00:00:00+08:00'),
+      new Date('2026-09-02T00:00:00+08:00'),
+      'week',
+    );
+    expect(shanghaiYmd(prev.from)).toBe('2026-08-17');
+    expect(shanghaiYmd(prev.to)).toBe('2026-08-26');
+  });
+
+  it('月：整段回退 1 个月', () => {
+    const prev = previousShanghaiRangeByGrain(
+      new Date('2026-08-01T00:00:00+08:00'),
+      new Date('2026-09-02T00:00:00+08:00'),
+      'month',
+    );
+    expect(shanghaiYmd(prev.from)).toBe('2026-07-01');
+    expect(shanghaiYmd(prev.to)).toBe('2026-08-02');
+  });
+});
+
+describe('periodMomRatio', () => {
+  it('上期为 0：本期 0 为 null，本期 > 0 为 1', () => {
+    expect(periodMomRatio(0, 0)).toBeNull();
+    expect(periodMomRatio(8, 0)).toBe(1);
+  });
+
+  it('常规环比', () => {
+    expect(periodMomRatio(12, 10)).toBeCloseTo(0.2);
+    expect(periodMomRatio(8, 10)).toBeCloseTo(-0.2);
+  });
+});
+
+describe('shanghaiQuarterRange', () => {
+  it('Q1 为 1/1～4/1（不含）', () => {
+    const { start, endExclusive } = shanghaiQuarterRange(2026, 1);
+    expect(shanghaiYmd(start)).toBe('2026-01-01');
+    expect(shanghaiYmd(endExclusive)).toBe('2026-04-01');
+    expect(shanghaiQuarterIndex(start)).toEqual({ year: 2026, quarter: 1 });
+  });
+});
+
+describe('defaultShanghaiRange', () => {
+  it('日：昨天～今天', () => {
+    const r = defaultShanghaiRange('day', new Date('2026-09-02T12:00:00+08:00'));
+    expect(shanghaiYmd(r.from)).toBe('2026-09-01');
+    expect(shanghaiYmd(r.to)).toBe('2026-09-02');
+  });
+
+  it('周：上周一～今天', () => {
+    const r = defaultShanghaiRange('week', new Date('2026-09-02T12:00:00+08:00'));
+    expect(shanghaiYmd(r.from)).toBe('2026-08-24');
+    expect(shanghaiYmd(r.to)).toBe('2026-09-02');
+  });
+
+  it('月：上月1日～今天', () => {
+    const r = defaultShanghaiRange('month', new Date('2026-09-02T12:00:00+08:00'));
+    expect(shanghaiYmd(r.from)).toBe('2026-08-01');
+    expect(shanghaiYmd(r.to)).toBe('2026-09-02');
+  });
+
+  it('季：上季首日～今天', () => {
+    const r = defaultShanghaiRange('quarter', new Date('2026-09-02T12:00:00+08:00'));
+    expect(shanghaiYmd(r.from)).toBe('2026-04-01');
+    expect(shanghaiYmd(r.to)).toBe('2026-09-02');
+  });
+
+  it('年：去年1月1日～今天', () => {
+    const r = defaultShanghaiRange('year', new Date('2026-09-02T12:00:00+08:00'));
+    expect(shanghaiYmd(r.from)).toBe('2025-01-01');
+    expect(shanghaiYmd(r.to)).toBe('2026-09-02');
+  });
+});

packages/domain/src/dashboard-period.ts

@@ -0,0 +1,237 @@
+import {
+  addShanghaiDays,
+  parseShanghaiYmd,
+  shanghaiMonthRange,
+  shanghaiWeekRange,
+  shanghaiYearMonth,
+  shanghaiYmd,
+  startOfShanghaiDay,
+} from './shanghai-date';
+
+export const DASHBOARD_GRANULARITIES = ['day', 'week', 'month', 'quarter', 'year'] as const;
+export type DashboardGranularity = (typeof DASHBOARD_GRANULARITIES)[number];
+
+function pad2(n: number): string {
+  return String(n).padStart(2, '0');
+}
+
+export function shanghaiQuarterIndex(d: Date): { year: number; quarter: number } {
+  const [y, m] = shanghaiYmd(d).split('-').map(Number);
+  return { year: y, quarter: Math.ceil(m / 3) };
+}
+
+export function shanghaiQuarterRange(
+  year: number,
+  quarter: number,
+): { start: Date; endExclusive: Date } {
+  const startMonth = (quarter - 1) * 3 + 1;
+  const endMonth = startMonth + 3;
+  const endYear = endMonth > 12 ? year + 1 : year;
+  const em = endMonth > 12 ? endMonth - 12 : endMonth;
+  return {
+    start: new Date(`${year}-${pad2(startMonth)}-01T00:00:00+08:00`),
+    endExclusive: new Date(`${endYear}-${pad2(em)}-01T00:00:00+08:00`),
+  };
+}
+
+export function shanghaiBucketKey(d: Date, grain: DashboardGranularity): string {
+  const ymd = shanghaiYmd(d);
+  const [y, m] = ymd.split('-').map(Number);
+  switch (grain) {
+    case 'day':
+      return ymd;
+    case 'week':
+      return shanghaiYmd(shanghaiWeekRange(d).start);
+    case 'month':
+      return `${y}-${pad2(m)}`;
+    case 'quarter':
+      return `${y}-Q${Math.ceil(m / 3)}`;
+    case 'year':
+      return String(y);
+  }
+}
+
+export function shanghaiBucketLabel(key: string, grain: DashboardGranularity): string {
+  switch (grain) {
+    case 'day':
+      return key.slice(5);
+    case 'week':
+      return `${key.slice(5)}周`;
+    default:
+      return key;
+  }
+}
+
+export type ShanghaiBucket = {
+  key: string;
+  label: string;
+  start: Date;
+  endExclusive: Date;
+};
+
+export function eachShanghaiBuckets(
+  from: Date,
+  to: Date,
+  grain: DashboardGranularity,
+): ShanghaiBucket[] {
+  const startDay = startOfShanghaiDay(from);
+  const endDay = startOfShanghaiDay(to);
+  const out: ShanghaiBucket[] = [];
+
+  if (grain === 'day') {
+    for (let d = startDay; d.getTime() <= endDay.getTime(); d = addShanghaiDays(d, 1)) {
+      const key = shanghaiYmd(d);
+      out.push({
+        key,
+        label: shanghaiBucketLabel(key, grain),
+        start: d,
+        endExclusive: addShanghaiDays(d, 1),
+      });
+    }
+    return out;
+  }
+
+  if (grain === 'week') {
+    let { start } = shanghaiWeekRange(startDay);
+    const lastStart = shanghaiWeekRange(endDay).start;
+    while (start.getTime() <= lastStart.getTime()) {
+      const key = shanghaiYmd(start);
+      const endExclusive = addShanghaiDays(start, 7);
+      out.push({ key, label: shanghaiBucketLabel(key, grain), start, endExclusive });
+      start = endExclusive;
+    }
+    return out;
+  }
+
+  if (grain === 'month') {
+    let { year, month } = shanghaiYearMonth(startDay);
+    const end = shanghaiYearMonth(endDay);
+    while (year < end.year || (year === end.year && month <= end.month)) {
+      const range = shanghaiMonthRange(year, month);
+      const key = `${year}-${pad2(month)}`;
+      out.push({ key, label: key, start: range.start, endExclusive: range.endExclusive });
+      month += 1;
+      if (month > 12) {
+        month = 1;
+        year += 1;
+      }
+    }
+    return out;
+  }
+
+  if (grain === 'quarter') {
+    let { year, quarter } = shanghaiQuarterIndex(startDay);
+    const end = shanghaiQuarterIndex(endDay);
+    while (year < end.year || (year === end.year && quarter <= end.quarter)) {
+      const range = shanghaiQuarterRange(year, quarter);
+      const key = `${year}-Q${quarter}`;
+      out.push({ key, label: key, start: range.start, endExclusive: range.endExclusive });
+      quarter += 1;
+      if (quarter > 4) {
+        quarter = 1;
+        year += 1;
+      }
+    }
+    return out;
+  }
+
+  let year = Number(shanghaiYmd(startDay).slice(0, 4));
+  const endYear = Number(shanghaiYmd(endDay).slice(0, 4));
+  while (year <= endYear) {
+    out.push({
+      key: String(year),
+      label: String(year),
+      start: new Date(`${year}-01-01T00:00:00+08:00`),
+      endExclusive: new Date(`${year + 1}-01-01T00:00:00+08:00`),
+    });
+    year += 1;
+  }
+  return out;
+}
+
+/** 按粒度把日期往前挪一档（日/周/月/季/年），用于环比窗口 */
+export function addShanghaiGrain(d: Date, grain: DashboardGranularity, delta: number): Date {
+  const start = startOfShanghaiDay(d);
+  switch (grain) {
+    case 'day':
+      return addShanghaiDays(start, delta);
+    case 'week':
+      return addShanghaiDays(start, delta * 7);
+    case 'month':
+      return addShanghaiMonths(start, delta);
+    case 'quarter':
+      return addShanghaiMonths(start, delta * 3);
+    case 'year':
+      return addShanghaiMonths(start, delta * 12);
+  }
+}
+
+function addShanghaiMonths(d: Date, delta: number): Date {
+  const [y, m, day] = shanghaiYmd(d).split('-').map(Number);
+  const utc = new Date(Date.UTC(y, m - 1 + delta, 1));
+  const ty = utc.getUTCFullYear();
+  const tm = utc.getUTCMonth() + 1;
+  const last = new Date(Date.UTC(ty, tm, 0)).getUTCDate();
+  return parseShanghaiYmd(`${ty}-${pad2(tm)}-${pad2(Math.min(day, last))}`);
+}
+
+/** 整段起止按粒度回退一档：日窗口昨天~今天 → 前天~昨天 */
+export function previousShanghaiRangeByGrain(
+  from: Date,
+  to: Date,
+  grain: DashboardGranularity,
+): { from: Date; to: Date } {
+  return {
+    from: addShanghaiGrain(from, grain, -1),
+    to: addShanghaiGrain(to, grain, -1),
+  };
+}
+
+/** 环比：(本期 − 上期) / 上期；上期 0 且本期 0 → null；上期 0 且本期 > 0 → 1 */
+export function periodMomRatio(curr: number, prev: number): number | null {
+  if (prev === 0) return curr === 0 ? null : 1;
+  return (curr - prev) / prev;
+}
+
+/** 默认窗口 = 上一档起点 ～ 今天（日=昨天~今天，周=上周一~今天，以此类推） */
+export function defaultShanghaiRange(
+  grain: DashboardGranularity,
+  anchor = new Date(),
+): { from: Date; to: Date } {
+  const to = startOfShanghaiDay(anchor);
+  switch (grain) {
+    case 'day':
+      return { from: addShanghaiDays(to, -1), to };
+    case 'week': {
+      const thisMonday = shanghaiWeekRange(to).start;
+      return { from: addShanghaiDays(thisMonday, -7), to };
+    }
+    case 'month': {
+      const { year, month } = shanghaiYearMonth(to);
+      const prev = month === 1 ? { year: year - 1, month: 12 } : { year, month: month - 1 };
+      return { from: shanghaiMonthRange(prev.year, prev.month).start, to };
+    }
+    case 'quarter': {
+      const { year, quarter } = shanghaiQuarterIndex(to);
+      let y = year;
+      let q = quarter - 1;
+      if (q <= 0) {
+        q = 4;
+        y -= 1;
+      }
+      return { from: shanghaiQuarterRange(y, q).start, to };
+    }
+    case 'year': {
+      const y = Number(shanghaiYmd(to).slice(0, 4));
+      return { from: new Date(`${y - 1}-01-01T00:00:00+08:00`), to };
+    }
+  }
+}
+
+export function defaultShanghaiRangeYmds(
+  grain: DashboardGranularity,
+  anchor = new Date(),
+): { from: string; to: string } {
+  const r = defaultShanghaiRange(grain, anchor);
+  return { from: shanghaiYmd(r.from), to: shanghaiYmd(r.to) };
+}

packages/domain/src/dashboard-series.test.ts

@@ -0,0 +1,88 @@
+import { describe, expect, it } from 'vitest';
+import {
+  DASHBOARD_SERIES_ALL,
+  DASHBOARD_SERIES_NONE,
+  DASHBOARD_SERIES_OTHER,
+  buildDimensionLines,
+  buildSingleLine,
+  cumulativeValues,
+  normalizeSeriesId,
+  pickTopSeriesIds,
+} from './dashboard-series';
+
+describe('normalizeSeriesId', () => {
+  it('空值归 none', () => {
+    expect(normalizeSeriesId(null)).toBe(DASHBOARD_SERIES_NONE);
+    expect(normalizeSeriesId('')).toBe(DASHBOARD_SERIES_NONE);
+  });
+});
+
+describe('cumulativeValues', () => {
+  it('带期初存量按桶累加', () => {
+    expect(cumulativeValues([1, 2, 3], 10)).toEqual([11, 13, 16]);
+  });
+});
+
+describe('pickTopSeriesIds', () => {
+  it('保留 none，其余按权重取 TopN', () => {
+    const { keep, rest } = pickTopSeriesIds(
+      [
+        { id: 'none', weight: 1 },
+        { id: 'a', weight: 9 },
+        { id: 'b', weight: 8 },
+        { id: 'c', weight: 1 },
+      ],
+      2,
+    );
+    expect(keep).toEqual(['none', 'a', 'b']);
+    expect(rest).toEqual(['c']);
+  });
+});
+
+describe('buildDimensionLines', () => {
+  it('总量为期初+增量累计，长尾并入其他', () => {
+    const { total, increment } = buildDimensionLines({
+      periodKeys: ['d1', 'd2'],
+      points: [
+        { seriesId: 'a', period: 'd1', value: 2 },
+        { seriesId: 'a', period: 'd2', value: 1 },
+        { seriesId: 'b', period: 'd1', value: 4 },
+        { seriesId: 'c', period: 'd2', value: 1 },
+        { seriesId: 'none', period: 'd1', value: 3 },
+      ],
+      baselines: [
+        { seriesId: 'a', value: 10 },
+        { seriesId: 'b', value: 1 },
+      ],
+      names: new Map([
+        ['a', '码A'],
+        ['b', '码B'],
+        ['c', '码C'],
+      ]),
+      noneLabel: '自然量',
+      topN: 1,
+    });
+    expect(increment.map((s) => s.id)).toEqual(['none', 'a', DASHBOARD_SERIES_OTHER]);
+    expect(increment.find((s) => s.id === 'a')?.values).toEqual([2, 1]);
+    expect(total.find((s) => s.id === 'a')?.values).toEqual([12, 13]);
+    expect(increment.find((s) => s.id === DASHBOARD_SERIES_OTHER)?.values).toEqual([4, 1]);
+    expect(total.find((s) => s.id === DASHBOARD_SERIES_OTHER)?.values).toEqual([5, 6]);
+    expect(increment.find((s) => s.id === 'none')?.name).toBe('自然量');
+  });
+});
+
+describe('buildSingleLine', () => {
+  it('无维度时只有一条 all', () => {
+    const { increment, total } = buildSingleLine({
+      periodKeys: ['d1', 'd2'],
+      points: [
+        { seriesId: 'x', period: 'd1', value: 2 },
+        { seriesId: 'y', period: 'd2', value: 3 },
+      ],
+      baseline: 5,
+      name: '合伙人',
+    });
+    expect(increment).toEqual({ id: DASHBOARD_SERIES_ALL, name: '合伙人', values: [2, 3] });
+    expect(total.values).toEqual([7, 10]);
+  });
+});

packages/domain/src/dashboard-series.ts

@@ -0,0 +1,184 @@
+export const DASHBOARD_LINE_TOP_N = 10;
+export const DASHBOARD_SERIES_NONE = 'none';
+export const DASHBOARD_SERIES_OTHER = 'other';
+export const DASHBOARD_SERIES_ALL = 'all';
+
+export type DashboardSeriesPoint = {
+  seriesId: string;
+  period: string;
+  value: number;
+};
+
+export type DashboardNamedSeries = {
+  id: string;
+  name: string;
+  values: number[];
+};
+
+export function normalizeSeriesId(raw: string | number | bigint | null | undefined): string {
+  if (raw == null) return DASHBOARD_SERIES_NONE;
+  const s = String(raw).trim();
+  return s ? s : DASHBOARD_SERIES_NONE;
+}
+
+export function periodValueMap(
+  periodKeys: string[],
+  points: DashboardSeriesPoint[],
+): Map<string, number[]> {
+  const index = new Map(periodKeys.map((k, i) => [k, i]));
+  const map = new Map<string, number[]>();
+  const ensure = (id: string) => {
+    let arr = map.get(id);
+    if (!arr) {
+      arr = periodKeys.map(() => 0);
+      map.set(id, arr);
+    }
+    return arr;
+  };
+  for (const p of points) {
+    const i = index.get(p.period);
+    if (i === undefined) continue;
+    ensure(p.seriesId)[i] += p.value;
+  }
+  return map;
+}
+
+export function cumulativeValues(increments: number[], baseline = 0): number[] {
+  let acc = baseline;
+  return increments.map((n) => {
+    acc += n;
+    return acc;
+  });
+}
+
+export function seriesEndWeight(increments: number[], baseline = 0): number {
+  return baseline + increments.reduce((sum, n) => sum + n, 0);
+}
+
+export function pickTopSeriesIds(
+  weights: Array<{ id: string; weight: number }>,
+  topN = DASHBOARD_LINE_TOP_N,
+  reserved: string[] = [DASHBOARD_SERIES_NONE],
+): { keep: string[]; rest: string[] } {
+  const reservedSet = new Set(reserved);
+  const reservedIds = weights
+    .filter((w) => reservedSet.has(w.id) && w.weight !== 0)
+    .map((w) => w.id);
+  const ranked = weights
+    .filter((w) => !reservedSet.has(w.id))
+    .sort((a, b) => b.weight - a.weight || a.id.localeCompare(b.id));
+  return {
+    keep: [...reservedIds, ...ranked.slice(0, topN).map((w) => w.id)],
+    rest: ranked.slice(topN).map((w) => w.id),
+  };
+}
+
+function sumSeries(
+  incrementMap: Map<string, number[]>,
+  baselineMap: Map<string, number>,
+  ids: string[],
+  periodLen: number,
+): { increments: number[]; baseline: number } {
+  const increments = Array.from({ length: periodLen }, () => 0);
+  let baseline = 0;
+  for (const id of ids) {
+    const arr = incrementMap.get(id);
+    if (arr) {
+      for (let i = 0; i < periodLen; i += 1) increments[i] += arr[i] ?? 0;
+    }
+    baseline += baselineMap.get(id) ?? 0;
+  }
+  return { increments, baseline };
+}
+
+function applyRound(values: number[], round?: (n: number) => number): number[] {
+  return round ? values.map(round) : values;
+}
+
+export function buildDimensionLines(opts: {
+  periodKeys: string[];
+  points: DashboardSeriesPoint[];
+  baselines?: Array<{ seriesId: string; value: number }>;
+  names?: Map<string, string>;
+  noneLabel: string;
+  otherLabel?: string;
+  topN?: number;
+  round?: (n: number) => number;
+}): { total: DashboardNamedSeries[]; increment: DashboardNamedSeries[] } {
+  const periodLen = opts.periodKeys.length;
+  const incrementMap = periodValueMap(opts.periodKeys, opts.points);
+  const baselineMap = new Map<string, number>();
+  for (const row of opts.baselines ?? []) {
+    const id = normalizeSeriesId(row.seriesId);
+    baselineMap.set(id, (baselineMap.get(id) ?? 0) + row.value);
+    if (!incrementMap.has(id)) incrementMap.set(id, opts.periodKeys.map(() => 0));
+  }
+  for (const id of incrementMap.keys()) {
+    if (!baselineMap.has(id)) baselineMap.set(id, 0);
+  }
+
+  const weights = [...incrementMap.keys()].map((id) => ({
+    id,
+    weight: seriesEndWeight(incrementMap.get(id) ?? [], baselineMap.get(id) ?? 0),
+  }));
+  const { keep, rest } = pickTopSeriesIds(weights, opts.topN ?? DASHBOARD_LINE_TOP_N);
+  const nameOf = (id: string) => {
+    if (id === DASHBOARD_SERIES_NONE) return opts.noneLabel;
+    if (id === DASHBOARD_SERIES_OTHER) return opts.otherLabel ?? '其他';
+    return opts.names?.get(id) || `#${id}`;
+  };
+
+  const orderedIds = [...keep];
+  if (rest.length) orderedIds.push(DASHBOARD_SERIES_OTHER);
+
+  const total: DashboardNamedSeries[] = [];
+  const increment: DashboardNamedSeries[] = [];
+  for (const id of orderedIds) {
+    const packed =
+      id === DASHBOARD_SERIES_OTHER
+        ? sumSeries(incrementMap, baselineMap, rest, periodLen)
+        : {
+            increments: incrementMap.get(id) ?? opts.periodKeys.map(() => 0),
+            baseline: baselineMap.get(id) ?? 0,
+          };
+    increment.push({
+      id,
+      name: nameOf(id),
+      values: applyRound(packed.increments, opts.round),
+    });
+    total.push({
+      id,
+      name: nameOf(id),
+      values: applyRound(cumulativeValues(packed.increments, packed.baseline), opts.round),
+    });
+  }
+  return { total, increment };
+}
+
+export function buildSingleLine(opts: {
+  periodKeys: string[];
+  points: DashboardSeriesPoint[];
+  baseline?: number;
+  name: string;
+  round?: (n: number) => number;
+}): { total: DashboardNamedSeries; increment: DashboardNamedSeries } {
+  const merged: DashboardSeriesPoint[] = opts.points.map((p) => ({
+    ...p,
+    seriesId: DASHBOARD_SERIES_ALL,
+  }));
+  const incrementMap = periodValueMap(opts.periodKeys, merged);
+  const increments = incrementMap.get(DASHBOARD_SERIES_ALL) ?? opts.periodKeys.map(() => 0);
+  const baseline = opts.baseline ?? 0;
+  return {
+    increment: {
+      id: DASHBOARD_SERIES_ALL,
+      name: opts.name,
+      values: applyRound(increments, opts.round),
+    },
+    total: {
+      id: DASHBOARD_SERIES_ALL,
+      name: opts.name,
+      values: applyRound(cumulativeValues(increments, baseline), opts.round),
+    },
+  };
+}

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/index.ts

@@ -410,3 +410,7 @@ export * from './dev-plan';
 export * from './support-ticket';
 export * from './phone';
 export * from './shanghai-date';
+export * from './dashboard-period';
+export * from './dashboard-series';
+export * from './wecom-report';
+export * from './shipping-address';

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/domain/src/shipping-address.test.ts

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

packages/domain/src/shipping-address.ts

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

packages/domain/src/wecom-report.test.ts

@@ -0,0 +1,133 @@
+import { describe, expect, it } from 'vitest';
+import {
+  formatWecomReportMarkdown,
+  wecomReportCutoff,
+  wecomReportDueAt,
+  wecomReportPeriod,
+  wecomReportShouldFire,
+} from './wecom-report';
+
+const emptyStats = {
+  usersTotal: 10,
+  usersIncrement: 2,
+  partnersTotal: 3,
+  partnersIncrement: 1,
+  storesTotal: 4,
+  storesIncrement: 0,
+  ordersTotal: 20,
+  ordersIncrement: 5,
+  orderAmountTotal: 1000,
+  orderAmountIncrement: 80.5,
+  redeemsTotal: 8,
+  redeemsIncrement: 3,
+  redeemAmountTotal: 200,
+  redeemAmountIncrement: 40,
+};
+
+describe('wecomReportPeriod', () => {
+  it('daily is the Shanghai calendar day', () => {
+    const p = wecomReportPeriod('daily', new Date('2026-09-02T20:00:00+08:00'));
+    expect(p.periodKey).toBe('2026-09-02');
+    expect(p.incrementLabel).toBe('当日新增');
+    expect(p.start.toISOString()).toBe(new Date('2026-09-02T00:00:00+08:00').toISOString());
+  });
+
+  it('weekly is the previous natural week', () => {
+    const p = wecomReportPeriod('weekly', new Date('2026-09-02T09:00:00+08:00'));
+    expect(p.periodKey).toBe('2026-08-24');
+    expect(p.rangeLabel).toBe('2026-08-24 ~ 2026-08-30');
+    expect(p.incrementLabel).toBe('本期新增');
+  });
+
+  it('monthly is the previous natural month', () => {
+    const p = wecomReportPeriod('monthly', new Date('2026-09-01T09:00:00+08:00'));
+    expect(p.periodKey).toBe('2026-08');
+    expect(p.title).toBe('月报（2026年8月）');
+  });
+});
+
+describe('wecomReportCutoff', () => {
+  it('caps an in-progress daily period at now', () => {
+    const now = new Date('2026-09-02T20:00:00+08:00');
+    const p = wecomReportPeriod('daily', now);
+    expect(wecomReportCutoff(p, now).getTime()).toBe(now.getTime());
+  });
+
+  it('uses period end for a completed week', () => {
+    const now = new Date('2026-09-02T09:00:00+08:00');
+    const p = wecomReportPeriod('weekly', now);
+    expect(wecomReportCutoff(p, now).getTime()).toBe(p.endExclusive.getTime());
+  });
+});
+
+describe('wecomReportShouldFire', () => {
+  const base = {
+    enabled: true,
+    sendHour: 20,
+    sendMinute: 0,
+    sendWeekday: 1,
+    sendMonthDay: 1,
+    lastSentPeriod: null as string | null,
+  };
+
+  it('does not fire before due time', () => {
+    expect(
+      wecomReportShouldFire('daily', base, new Date('2026-09-02T19:59:00+08:00')),
+    ).toBe(false);
+  });
+
+  it('fires after due time if this period not sent', () => {
+    expect(
+      wecomReportShouldFire('daily', base, new Date('2026-09-02T20:00:00+08:00')),
+    ).toBe(true);
+  });
+
+  it('does not fire twice for the same period', () => {
+    expect(
+      wecomReportShouldFire(
+        'daily',
+        { ...base, lastSentPeriod: '2026-09-02' },
+        new Date('2026-09-02T21:00:00+08:00'),
+      ),
+    ).toBe(false);
+  });
+
+  it('weekly fires Monday 09:00 for last week', () => {
+    expect(
+      wecomReportShouldFire(
+        'weekly',
+        { ...base, sendHour: 9, sendMinute: 0, sendWeekday: 1 },
+        new Date('2026-09-07T09:00:00+08:00'),
+      ),
+    ).toBe(true);
+  });
+});
+
+describe('wecomReportDueAt', () => {
+  it('monthly clamps to last day of month', () => {
+    const due = wecomReportDueAt(
+      'monthly',
+      {
+        enabled: true,
+        sendHour: 9,
+        sendMinute: 0,
+        sendWeekday: 1,
+        sendMonthDay: 31,
+        lastSentPeriod: null,
+      },
+      new Date('2026-09-10T00:00:00+08:00'),
+    );
+    expect(due.toISOString()).toBe(new Date('2026-09-30T09:00:00+08:00').toISOString());
+  });
+});
+
+describe('formatWecomReportMarkdown', () => {
+  it('renders stock plus increment lines', () => {
+    const p = wecomReportPeriod('daily', new Date('2026-09-02T20:00:00+08:00'));
+    const md = formatWecomReportMarkdown(p, emptyStats);
+    expect(md).toContain('**杜康好客 · 日报（2026-09-02）**');
+    expect(md).toContain('用户数量：10（当日新增 2）');
+    expect(md).toContain('订单金额：1000.00（当日新增 80.50）');
+    expect(md).toContain('核销单数量：8（当日新增 3）');
+  });
+});

packages/domain/src/wecom-report.ts

@@ -0,0 +1,179 @@
+import {
+  addShanghaiDays,
+  previousShanghaiMonth,
+  previousShanghaiWeek,
+  shanghaiMonthRange,
+  shanghaiWeekRange,
+  shanghaiWeekday,
+  shanghaiYearMonth,
+  shanghaiYmd,
+  startOfShanghaiDay,
+} from './shanghai-date';
+
+export const WECOM_REPORT_KINDS = ['daily', 'weekly', 'monthly'] as const;
+export type WecomReportKind = (typeof WECOM_REPORT_KINDS)[number];
+
+export function isWecomReportKind(v: string): v is WecomReportKind {
+  return (WECOM_REPORT_KINDS as readonly string[]).includes(v);
+}
+
+export type WecomReportStats = {
+  usersTotal: number;
+  usersIncrement: number;
+  partnersTotal: number;
+  partnersIncrement: number;
+  storesTotal: number;
+  storesIncrement: number;
+  ordersTotal: number;
+  ordersIncrement: number;
+  orderAmountTotal: number;
+  orderAmountIncrement: number;
+  redeemsTotal: number;
+  redeemsIncrement: number;
+  redeemAmountTotal: number;
+  redeemAmountIncrement: number;
+};
+
+export type WecomReportPeriod = {
+  kind: WecomReportKind;
+  start: Date;
+  endExclusive: Date;
+  periodKey: string;
+  title: string;
+  rangeLabel: string;
+  incrementLabel: string;
+};
+
+export type WecomReportSchedule = {
+  enabled: boolean;
+  sendHour: number;
+  sendMinute: number;
+  /** 1=周一 … 7=周日，仅周报 */
+  sendWeekday: number;
+  /** 1–31，仅月报 */
+  sendMonthDay: number;
+  lastSentPeriod: string | null;
+};
+
+function pad2(n: number): string {
+  return String(n).padStart(2, '0');
+}
+
+function shanghaiDateTime(ymd: string, hour: number, minute: number): Date {
+  return new Date(`${ymd}T${pad2(hour)}:${pad2(minute)}:00+08:00`);
+}
+
+function lastDayOfShanghaiMonth(year: number, month: number): number {
+  return Number(shanghaiYmd(new Date(shanghaiMonthRange(year, month).endExclusive.getTime() - 1)).slice(8, 10));
+}
+
+/** 日报=当天；周报=上一自然周；月报=上一自然月（北京日历） */
+export function wecomReportPeriod(kind: WecomReportKind, now = new Date()): WecomReportPeriod {
+  if (kind === 'daily') {
+    const start = startOfShanghaiDay(now);
+    const ymd = shanghaiYmd(start);
+    return {
+      kind,
+      start,
+      endExclusive: addShanghaiDays(start, 1),
+      periodKey: ymd,
+      title: `日报（${ymd}）`,
+      rangeLabel: ymd,
+      incrementLabel: '当日新增',
+    };
+  }
+  if (kind === 'weekly') {
+    const { start, endExclusive } = previousShanghaiWeek(now);
+    const from = shanghaiYmd(start);
+    const to = shanghaiYmd(new Date(endExclusive.getTime() - 1));
+    return {
+      kind,
+      start,
+      endExclusive,
+      periodKey: from,
+      title: `周报（${from} ~ ${to}）`,
+      rangeLabel: `${from} ~ ${to}`,
+      incrementLabel: '本期新增',
+    };
+  }
+  const { year, month } = previousShanghaiMonth(now);
+  const { start, endExclusive } = shanghaiMonthRange(year, month);
+  return {
+    kind,
+    start,
+    endExclusive,
+    periodKey: `${year}-${pad2(month)}`,
+    title: `月报（${year}年${month}月）`,
+    rangeLabel: `${shanghaiYmd(start)} ~ ${shanghaiYmd(new Date(endExclusive.getTime() - 1))}`,
+    incrementLabel: '本期新增',
+  };
+}
+
+/** 进行中的周期截到 now，已结束的周期用期末 */
+export function wecomReportCutoff(period: WecomReportPeriod, now = new Date()): Date {
+  return now.getTime() < period.endExclusive.getTime() ? now : period.endExclusive;
+}
+
+export function wecomReportDueAt(kind: WecomReportKind, schedule: WecomReportSchedule, now = new Date()): Date {
+  const hour = Math.min(23, Math.max(0, Math.floor(schedule.sendHour)));
+  const minute = Math.min(59, Math.max(0, Math.floor(schedule.sendMinute)));
+  if (kind === 'daily') {
+    return shanghaiDateTime(shanghaiYmd(now), hour, minute);
+  }
+  if (kind === 'weekly') {
+    const { start } = shanghaiWeekRange(now);
+    const iso = Math.min(7, Math.max(1, Math.floor(schedule.sendWeekday) || 1));
+    const day = addShanghaiDays(start, iso - 1);
+    return shanghaiDateTime(shanghaiYmd(day), hour, minute);
+  }
+  const { year, month } = shanghaiYearMonth(now);
+  const last = lastDayOfShanghaiMonth(year, month);
+  const day = Math.min(last, Math.max(1, Math.floor(schedule.sendMonthDay) || 1));
+  return shanghaiDateTime(`${year}-${pad2(month)}-${pad2(day)}`, hour, minute);
+}
+
+export function wecomReportShouldFire(
+  kind: WecomReportKind,
+  schedule: WecomReportSchedule,
+  now = new Date(),
+): boolean {
+  if (!schedule.enabled) return false;
+  const period = wecomReportPeriod(kind, now);
+  if (schedule.lastSentPeriod === period.periodKey) return false;
+  return now.getTime() >= wecomReportDueAt(kind, schedule, now).getTime();
+}
+
+function fmtCount(n: number): string {
+  return Math.round(n).toLocaleString('zh-CN');
+}
+
+function fmtMoney(n: number): string {
+  return Number(n || 0).toFixed(2);
+}
+
+function line(label: string, total: number, inc: number, incLabel: string, money = false): string {
+  const fmt = money ? fmtMoney : fmtCount;
+  return `${label}：${fmt(total)}（${incLabel} ${fmt(inc)}）`;
+}
+
+export function formatWecomReportMarkdown(period: WecomReportPeriod, stats: WecomReportStats): string {
+  const inc = period.incrementLabel;
+  return [
+    `**杜康好客 · ${period.title}**`,
+    `统计区间：${period.rangeLabel}（北京时间）`,
+    '',
+    line('用户数量', stats.usersTotal, stats.usersIncrement, inc),
+    line('合伙人数量', stats.partnersTotal, stats.partnersIncrement, inc),
+    line('门店数量', stats.storesTotal, stats.storesIncrement, inc),
+    line('订单数量', stats.ordersTotal, stats.ordersIncrement, inc),
+    line('订单金额', stats.orderAmountTotal, stats.orderAmountIncrement, inc, true),
+    line('核销单数量', stats.redeemsTotal, stats.redeemsIncrement, inc),
+    line('核销单金额', stats.redeemAmountTotal, stats.redeemAmountIncrement, inc, true),
+  ].join('\n');
+}
+
+/** 仅用于单测：避免把 shanghaiWeekday 的周日=0 与 ISO 周一=1 搞混 */
+export function wecomReportIsoWeekday(d: Date): number {
+  const wd = shanghaiWeekday(d);
+  return wd === 0 ? 7 : wd;
+}

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/fulfillment-provider.ts

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

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

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

packages/shared-types/src/index.ts

@@ -30,6 +30,7 @@ export * from './fulfillment-provider';
 export * from './system-config';
 export * from './wecom-bot';
 export * from './wecom-message-push';
+export * from './wecom-report';
 export * from './llm-config';
 export * from './knowledge-base';
 export * from './legal';

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;
@@ -60,3 +68,38 @@ export interface DeployTriggerResult {
   started?: boolean;
   message: string;
 }
+
+export const DASHBOARD_GRANULARITIES = ['day', 'week', 'month', 'quarter', 'year'] as const;
+export type DashboardGranularity = (typeof DASHBOARD_GRANULARITIES)[number];
+
+export type DashboardDateRange = { from: string; to: string };
+
+export type DashboardLineHref =
+  | 'users'
+  | 'partners'
+  | 'stores'
+  | 'orders'
+  | 'redeems';
+
+export type DashboardLineUnit = 'count' | 'amount';
+
+export type DashboardLineSeries = {
+  id: string;
+  name: string;
+  values: number[];
+};
+
+export type DashboardLineChart = {
+  key: string;
+  title: string;
+  unit: DashboardLineUnit;
+  href: DashboardLineHref;
+  series: DashboardLineSeries[];
+};
+
+export type DashboardAnalytics = {
+  granularity: DashboardGranularity;
+  range: DashboardDateRange;
+  periods: Array<{ key: string; label: string }>;
+  charts: DashboardLineChart[];
+};

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/shared-types/src/trade.ts

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

packages/shared-types/src/wecom-report.ts

@@ -0,0 +1,79 @@
+export const WECOM_REPORT_KINDS = ['daily', 'weekly', 'monthly'] as const;
+export type WecomReportKind = (typeof WECOM_REPORT_KINDS)[number];
+
+export const WECOM_REPORT_KIND_LABELS: Record<WecomReportKind, string> = {
+  daily: '日报',
+  weekly: '周报',
+  monthly: '月报',
+};
+
+export const WECOM_REPORT_WEEKDAY_OPTIONS: Array<{ value: number; label: string }> = [
+  { value: 1, label: '周一' },
+  { value: 2, label: '周二' },
+  { value: 3, label: '周三' },
+  { value: 4, label: '周四' },
+  { value: 5, label: '周五' },
+  { value: 6, label: '周六' },
+  { value: 7, label: '周日' },
+];
+
+export type WecomReportStatsDto = {
+  usersTotal: number;
+  usersIncrement: number;
+  partnersTotal: number;
+  partnersIncrement: number;
+  storesTotal: number;
+  storesIncrement: number;
+  ordersTotal: number;
+  ordersIncrement: number;
+  orderAmountTotal: number;
+  orderAmountIncrement: number;
+  redeemsTotal: number;
+  redeemsIncrement: number;
+  redeemAmountTotal: number;
+  redeemAmountIncrement: number;
+};
+
+export type WecomReportPushDto = {
+  id: string;
+  kind: WecomReportKind;
+  name: string;
+  webhookUrl: string;
+  webhookUrlMasked: string;
+  enabled: boolean;
+  mentionWecomUserId: string | null;
+  sendHour: number;
+  sendMinute: number;
+  sendWeekday: number;
+  sendMonthDay: number;
+  lastSentPeriod: string | null;
+  lastSentAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+};
+
+export type UpdateWecomReportPushRequest = {
+  name?: string;
+  webhookUrl?: string;
+  enabled?: boolean;
+  mentionWecomUserId?: string | null;
+  sendHour?: number;
+  sendMinute?: number;
+  sendWeekday?: number;
+  sendMonthDay?: number;
+};
+
+export type WecomReportPreviewDto = {
+  kind: WecomReportKind;
+  periodKey: string;
+  title: string;
+  rangeLabel: string;
+  markdown: string;
+  stats: WecomReportStatsDto;
+};
+
+export type WecomReportSendResultDto = {
+  ok: boolean;
+  message: string;
+  periodKey: string;
+};

pnpm-lock.yaml

@@ -50,6 +50,9 @@ importers:
       element-china-area-data:
         specifier: ^6.1.0
         version: 6.1.0
+      jspdf:
+        specifier: ^4.2.1
+        version: 4.2.1
       react:
         specifier: ^18.3.1
         version: 18.3.1
@@ -2811,6 +2814,9 @@ packages:
   '@types/node@25.9.5':
     resolution: {integrity: sha512-OScDchr2fwuUmWdf4kZ9h7PcJiYDVInhJizG/biAq3cAvqwYktuy/TYGGdZNMtNTFUP7rnb0NU4TUdm82kt4Rg==}
 
+  '@types/pako@2.0.4':
+    resolution: {integrity: sha512-VWDCbrLeVXJM9fihYodcLiIv0ku+AlOa/TQ1SvYOaBuyrSKgEcro95LJyIsJ4vSo6BXIxOKxiJAat04CmST9Fw==}
+
   '@types/pdfkit@0.17.6':
     resolution: {integrity: sha512-tIwzxk2uWKp0Cq9JIluQXJid77lYhF52EsIOwhsMF4iWLA6YneoBR1xVKYYdAysHuepUB0OX4tdwMiUDdGKmig==}
 
@@ -2826,6 +2832,9 @@ packages:
   '@types/qs@6.15.1':
     resolution: {integrity: sha512-GZHUBZR9hckSUhrxmp1nG6NwdpM9fCunJwyThLW1X3AyHgd9IlHb6VANpQQqDr2o/qQp6McZ3y/IA2rVzKzSbw==}
 
+  '@types/raf@3.4.3':
+    resolution: {integrity: sha512-c4YAvMedbPZ5tEyxzQdMoOhhJ4RD3rngZIdwC2/qDN3d7JpEhB6fiBRKVY1lg5B7Wk+uPBjn5f39j1/2MY1oOw==}
+
   '@types/range-parser@1.2.7':
     resolution: {integrity: sha512-hKormJbkJqzQGhziax5PItDUTMAM9uE2XXQmM37dyd4hVM+5aVl7oVxMVUiVQn2oCQFN/LKCZdvSM0pFRqbSmQ==}
 
@@ -2856,6 +2865,9 @@ packages:
   '@types/serve-static@1.15.10':
     resolution: {integrity: sha512-tRs1dB+g8Itk72rlSI2ZrW6vZg0YrLI81iQSTkMmOqnqCaNr/8Ek4VwWcN5vZgCYWbg/JJSGBlUaYGAOP73qBw==}
 
+  '@types/trusted-types@2.0.7':
+    resolution: {integrity: sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw==}
+
   '@types/validator@13.15.10':
     resolution: {integrity: sha512-T8L6i7wCuyoK8A/ZeLYt1+q0ty3Zb9+qbSSvrIVitzT3YjZqkTZ40IbRsPanlB4h1QB3JVL1SYCdR6ngtFYcuA==}
 
@@ -3313,6 +3325,10 @@ packages:
   bare-url@2.5.2:
     resolution: {integrity: sha512-L13PCJzKG8RGvx8V1/DdMi12ERhC3tprr7/8a94BxpmnRsFqxh5XZNdhtMxu5HPkRshYOOWRGY8lDP7ZhpG9Cg==}
 
+  base64-arraybuffer@1.0.2:
+    resolution: {integrity: sha512-I3yl4r9QB5ZRY3XuJVEPfc2XhZO6YweFPI+UovAzn+8/hb3oJ6lnysaFcjVpkCPfVWFUDvoZ8kmVDP7WyRtYtQ==}
+    engines: {node: '>= 0.6.0'}
+
   base64-js@0.0.8:
     resolution: {integrity: sha512-3XSA2cR/h/73EzlXXdU6YNycmYI7+kicTxks4eJg2g39biHR84slg2+des+p7iHYhbRg/udIS4TD53WabcOUkw==}
     engines: {node: '>= 0.4'}
@@ -3476,6 +3492,10 @@ packages:
   caniuse-lite@1.0.30001799:
     resolution: {integrity: sha512-hG1bReV+OUU+MOqK4t/ZWI0tZOyz3rqS9XuhOUz1cIcbwBKjOyJEJuw9ER5JuNyqxNk8u/JUVbGibBOL1yrjFw==}
 
+  canvg@3.0.11:
+    resolution: {integrity: sha512-5ON+q7jCTgMp9cjpu4Jo6XbvfYwSB2Ow3kzHKfIyJfaCAOHLbdKPQqGKgfED/R5B+3TFFfe8pegYA+b423SRyA==}
+    engines: {node: '>=10.0.0'}
+
   capital-case@1.0.4:
     resolution: {integrity: sha512-ds37W8CytHgwnhGGTi88pcPyR15qoNkOpYwmMMfnWqqWgESapLqvDx6huFjQ5vqWSn2Z06173XNA7LtMOeUh1A==}
 
@@ -3749,6 +3769,9 @@ packages:
     resolution: {integrity: sha512-8HFEBPKhOpJPEPu70wJJetjKta86Gw9+CCyCnB3sui2qQfOvRyqBy4IKLKKAwdMpWb2lHXWk9Wb4Z6AmaUT1Pg==}
     engines: {node: '>=12'}
 
+  css-line-break@2.1.0:
+    resolution: {integrity: sha512-FHcKFCZcAha3LwfVBhCQbW2nCNbkZXn7KVUJcsT5/P8YmfsVja0FMPJr0B903j/E69HUphKiV9iQArX8SDYA4w==}
+
   css-tree@3.2.1:
     resolution: {integrity: sha512-X7sjQzceUhu1u7Y/ylrRZFU2FS6LRiFVp6rKLPg23y3x3c3DOKAwuXGDp+PAGjh6CSnCjYeAul8pcT8bAl+lSA==}
     engines: {node: ^10 || ^12.20.0 || ^14.13.0 || >=15.0.0}
@@ -3906,6 +3929,9 @@ packages:
     resolution: {integrity: sha512-ilXFf9Moz47ABjFpDiA5s1w9lpb4EFSp7+5iiJSbfyYDM+bpZdAgLlSr7fW4aXhVe/E+F6QCv0EvRVFEd5CsWg==}
     engines: {node: '>=10'}
 
+  dompurify@3.4.14:
+    resolution: {integrity: sha512-dVoH9z+MY+C9IilgGCk3YfFqjLi3fChm2OiKJMzh6axrJ5qwxqWaZamgmHrpv22CN/KdbZJuGEGgfQoL00LTdg==}
+
   dot-case@3.0.4:
     resolution: {integrity: sha512-Kv5nKlh6yRrdrGvxeJ2e5y2eRUpkUosIW4A2AS38zwSz27zu7ufDwQPi5Jhs3XAlGNetl3bmnGhQsMtkKJnj3w==}
 
@@ -4190,6 +4216,9 @@ packages:
   fast-levenshtein@2.0.6:
     resolution: {integrity: sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==}
 
+  fast-png@6.4.0:
+    resolution: {integrity: sha512-kAqZq1TlgBjZcLr5mcN6NP5Rv4V2f22z00c3g8vRrwkcqjerx7BEhPbOnWCPqaHUl2XWQBJQvOT/FQhdMT7X/Q==}
+
   fast-safe-stringify@2.1.1:
     resolution: {integrity: sha512-W+KJc2dmILlPplD/H4K9l9LcAHAfPtP6BY84uVLXQ6Evcz9Lcg33Y2z1IVblT6xdY54PXYVHEv+0Wpq8Io6zkA==}
 
@@ -4591,6 +4620,10 @@ packages:
     resolution: {integrity: sha512-ztqyC3kLto0e9WbNp0aeP+M3kTt+nbaIveGmUxAtZa+8iFgKLUOD4YKM5j+f3QD89bra7UeumolZHKuOXnTmeQ==}
     engines: {node: '>=8'}
 
+  html2canvas@1.4.1:
+    resolution: {integrity: sha512-fPU6BHNpsyIhr8yyMpTLLxAbkaK8ArIBcmZIRiBLiDhjeqvXolaEmDGmELFuX9I4xDcaKKcJl+TKZLqruBbmWA==}
+    engines: {node: '>=8.0.0'}
+
   http-cache-semantics@3.8.1:
     resolution: {integrity: sha512-5ai2iksyV8ZXmnZhHH4rWPoxxistEexSi5936zIQ1bnNTW5VnA85B6P/VpXiRM017IgRvb2kKo1a//y+0wSp3w==}
 
@@ -4687,6 +4720,9 @@ packages:
     resolution: {integrity: sha512-TcdjPibTksa1NQximqep2r17ISRiNE9fwlfbg3F8ANdvP5/yrFTew86VcO//jk4QTaMlbjypPBq76HN2zaKfZQ==}
     engines: {node: '>=4'}
 
+  iobuffer@5.4.0:
+    resolution: {integrity: sha512-DRebOWuqDvxunfkNJAlc3IzWIPD5xVxwUNbHr7xKB8E6aLJxIPfNX3CoMJghcFjpv6RWQsrcJbghtEwSPoJqMA==}
+
   ioredis@5.10.1:
     resolution: {integrity: sha512-HuEDBTI70aYdx1v6U97SbNx9F1+svQKBDo30o0b9fw055LMepzpOOd0Ccg9Q6tbqmBSJaMuY0fB7yw9/vjBYCA==}
     engines: {node: '>=12.22.0'}
@@ -4906,6 +4942,9 @@ packages:
     resolution: {integrity: sha512-PRp66vJ865SSqOlgqS8hujT5U4AOgMfhrwYIuIhfKaoSCZcirrmASQr8CX7cUg+RMih+hgznrjp99o+W4pJLHQ==}
     engines: {node: '>=12', npm: '>=6'}
 
+  jspdf@4.2.1:
+    resolution: {integrity: sha512-YyAXyvnmjTbR4bHQRLzex3CuINCDlQnBqoSYyjJwTP2x9jDLuKDzy7aKUl0hgx3uhcl7xzg32agn5vlie6HIlQ==}
+
   jstoxml@2.2.9:
     resolution: {integrity: sha512-OYWlK0j+roh+eyaMROlNbS5cd5R25Y+IUpdl7cNdB8HNrkgwQzIS7L9MegxOiWNBj9dQhA/yAxiMwCC5mwNoBw==}
 
@@ -5476,6 +5515,9 @@ packages:
   pako@1.0.11:
     resolution: {integrity: sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw==}
 
+  pako@2.2.0:
+    resolution: {integrity: sha512-zJq6RP/5q+TO2OpFV3FHzlPnFjmkb7Nc99a5SNjJE+uu/PkpChs+NIZSSzbBoD+6kjiISXjfYdwj1ZRQ81dz/w==}
+
   param-case@2.1.1:
     resolution: {integrity: sha512-eQE845L6ot89sk2N8liD8HAuH4ca6Vvr7VWAWwt7+kvvG5aBcPmmphQ68JsEG2qa9n1TykS2DLeMt363AAH8/w==}
 
@@ -5563,6 +5605,9 @@ packages:
   pend@1.2.0:
     resolution: {integrity: sha512-F3asv42UuXchdzt+xXqfW1OGlVBe+mxa2mqI0pg5yAHZPvFmY3Y6drSf/GQ1A86WgWEN9Kzh/WrgKa6iGcHXLg==}
 
+  performance-now@2.1.0:
+    resolution: {integrity: sha512-7EAHlyLHI56VEIdK57uwHdHKIaAGbnXPiw0yWbarQZOKaKpvUIgW0jWRVLiatnM+XXlSwsanIBH/hzGMJulMow==}
+
   picocolors@1.1.1:
     resolution: {integrity: sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==}
 
@@ -5788,6 +5833,9 @@ packages:
   queue-microtask@1.2.3:
     resolution: {integrity: sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==}
 
+  raf@3.4.1:
+    resolution: {integrity: sha512-Sq4CW4QhwOHE8ucn6J34MqtZCeWFP2aQSmrlroYgqAV1PjStIhJXxYuTgUIfkEk7zTLjmIjLmU5q+fbD1NnOJA==}
+
   randombytes@2.1.0:
     resolution: {integrity: sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==}
 
@@ -6190,6 +6238,10 @@ packages:
     resolution: {integrity: sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==}
     engines: {iojs: '>=1.0.0', node: '>=0.10.0'}
 
+  rgbcolor@1.0.1:
+    resolution: {integrity: sha512-9aZLIrhRaD97sgVhtJOW6ckOEh6/GnvQtdVNfdZ6s67+3/XwLS9lBcQYzEEhYVeUowN7pRzMLsyGhK2i/xvWbw==}
+    engines: {node: '>= 0.8.15'}
+
   rimraf@2.7.1:
     resolution: {integrity: sha512-uWjbaKIK3T1OSVptzX7Nl6PvQ3qAGtKEtVRjRuazjfL3Bx5eI409VZSqgND+4UNnmzLVdPj9FqFJNPqBZFve4w==}
     deprecated: Rimraf versions prior to v4 are no longer supported
@@ -6433,6 +6485,10 @@ packages:
   stackback@0.0.2:
     resolution: {integrity: sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==}
 
+  stackblur-canvas@2.7.0:
+    resolution: {integrity: sha512-yf7OENo23AGJhBriGx0QivY5JP6Y1HbrrDI6WLt6C5auYZXlQrheoY8hD4ibekFKz1HOfE48Ww8kMWMnJD/zcQ==}
+    engines: {node: '>=0.1.14'}
+
   standard-as-callback@2.1.0:
     resolution: {integrity: sha512-qoRRSyROncaz1z0mvYqIE4lCd9p2R90i6GxW3uZv5ucSu8tU7B5HXUP1gG8pVZsYNVaXjk8ClXHPttLyxAL48A==}
 
@@ -6547,6 +6603,10 @@ packages:
     resolution: {integrity: sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==}
     engines: {node: '>= 0.4'}
 
+  svg-pathdata@6.0.3:
+    resolution: {integrity: sha512-qsjeeq5YjBZ5eMdFuUa4ZosMLxgr5RZ+F+Y1OrDhuOCEInRMA3x74XdBtggJcj9kOeInz0WE+LgCPDkZFlBYJw==}
+    engines: {node: '>=12.0.0'}
+
   svg-tags@1.0.0:
     resolution: {integrity: sha512-ovssysQTa+luh7A5Weu3Rta6FJlFBBbInjOh722LIt6klpU2/HtdUbszju/G4devcvk8PGt7FCLv5wftu3THUA==}
 
@@ -6634,6 +6694,9 @@ packages:
   text-decoder@1.2.7:
     resolution: {integrity: sha512-vlLytXkeP4xvEq2otHeJfSQIRyWxo/oZGEbXrtEEF9Hnmrdly59sUbzZ/QgyWuLYHctCHxFF4tRQZNQ9k60ExQ==}
 
+  text-segmentation@1.0.3:
+    resolution: {integrity: sha512-iOiPUo/BGnZ6+54OsWxZidGCsdU8YbE4PSpdPinp7DeMtUJNJBoJ/ouUSTJjHkh1KntHaltHl/gDs2FC4i5+Nw==}
+
   text-table@0.2.0:
     resolution: {integrity: sha512-N+8UisAXDGk8PFXP4HAzVR9nbfmVJ3zYLAWiTIoqC5v5isinhr+r5uaO8+7r3BMfuNIufIsA7RdpVgacC2cSpw==}
 
@@ -6930,6 +6993,9 @@ packages:
     resolution: {integrity: sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==}
     engines: {node: '>= 0.4.0'}
 
+  utrie@1.0.2:
+    resolution: {integrity: sha512-1MLa5ouZiOmQzUbjbu9VmjLzn1QLXBhwpUa7kdLUQK+KQ5KA9I1vk5U4YHe/X2Ch7PYnJfWuWT+VbuxbGwljhw==}
+
   uuid@8.3.2:
     resolution: {integrity: sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==}
     deprecated: uuid@10 and below is no longer supported.  For ESM codebases, update to uuid@latest.  For CommonJS codebases, use uuid@11 (but be aware this version will likely be deprecated in 2028).
@@ -9830,6 +9896,8 @@ snapshots:
     dependencies:
       undici-types: 7.24.6
 
+  '@types/pako@2.0.4': {}
+
   '@types/pdfkit@0.17.6':
     dependencies:
       '@types/node': 20.19.43
@@ -9847,6 +9915,9 @@ snapshots:
 
   '@types/qs@6.15.1': {}
 
+  '@types/raf@3.4.3':
+    optional: true
+
   '@types/range-parser@1.2.7': {}
 
   '@types/react-dom@18.3.7(@types/react@18.3.31)':
@@ -9885,6 +9956,9 @@ snapshots:
       '@types/node': 20.19.43
       '@types/send': 0.17.6
 
+  '@types/trusted-types@2.0.7':
+    optional: true
+
   '@types/validator@13.15.10': {}
 
   '@types/xml2js@0.4.14':
@@ -10552,6 +10626,9 @@ snapshots:
     dependencies:
       bare-path: 3.1.1
 
+  base64-arraybuffer@1.0.2:
+    optional: true
+
   base64-js@0.0.8: {}
 
   base64-js@1.5.1: {}
@@ -10745,6 +10822,18 @@ snapshots:
 
   caniuse-lite@1.0.30001799: {}
 
+  canvg@3.0.11:
+    dependencies:
+      '@babel/runtime': 7.29.7
+      '@types/raf': 3.4.3
+      core-js: 3.49.0
+      raf: 3.4.1
+      regenerator-runtime: 0.13.11
+      rgbcolor: 1.0.1
+      stackblur-canvas: 2.7.0
+      svg-pathdata: 6.0.3
+    optional: true
+
   capital-case@1.0.4:
     dependencies:
       no-case: 3.0.4
@@ -11049,6 +11138,11 @@ snapshots:
 
   css-functions-list@3.3.3: {}
 
+  css-line-break@2.1.0:
+    dependencies:
+      utrie: 1.0.2
+    optional: true
+
   css-tree@3.2.1:
     dependencies:
       mdn-data: 2.27.1
@@ -11191,6 +11285,11 @@ snapshots:
       xml: 1.0.1
       xml-js: 1.6.11
 
+  dompurify@3.4.14:
+    optionalDependencies:
+      '@types/trusted-types': 2.0.7
+    optional: true
+
   dot-case@3.0.4:
     dependencies:
       no-case: 3.0.4
@@ -11597,6 +11696,12 @@ snapshots:
 
   fast-levenshtein@2.0.6: {}
 
+  fast-png@6.4.0:
+    dependencies:
+      '@types/pako': 2.0.4
+      iobuffer: 5.4.0
+      pako: 2.2.0
+
   fast-safe-stringify@2.1.1: {}
 
   fast-uri@3.1.2: {}
@@ -12051,6 +12156,12 @@ snapshots:
 
   html-tags@3.3.1: {}
 
+  html2canvas@1.4.1:
+    dependencies:
+      css-line-break: 2.1.0
+      text-segmentation: 1.0.3
+    optional: true
+
   http-cache-semantics@3.8.1: {}
 
   http-cache-semantics@4.2.0: {}
@@ -12178,6 +12289,8 @@ snapshots:
       from2: 2.3.0
       p-is-promise: 1.1.0
 
+  iobuffer@5.4.0: {}
+
   ioredis@5.10.1:
     dependencies:
       '@ioredis/commands': 1.5.1
@@ -12382,6 +12495,17 @@ snapshots:
       ms: 2.1.3
       semver: 7.8.5
 
+  jspdf@4.2.1:
+    dependencies:
+      '@babel/runtime': 7.29.7
+      fast-png: 6.4.0
+      fflate: 0.8.3
+    optionalDependencies:
+      canvg: 3.0.11
+      core-js: 3.49.0
+      dompurify: 3.4.14
+      html2canvas: 1.4.1
+
   jstoxml@2.2.9: {}
 
   jszip@3.10.1:
@@ -12884,6 +13008,8 @@ snapshots:
 
   pako@1.0.11: {}
 
+  pako@2.2.0: {}
+
   param-case@2.1.1:
     dependencies:
       no-case: 2.3.2
@@ -12968,6 +13094,9 @@ snapshots:
 
   pend@1.2.0: {}
 
+  performance-now@2.1.0:
+    optional: true
+
   picocolors@1.1.1: {}
 
   picomatch@2.3.2: {}
@@ -13161,6 +13290,11 @@ snapshots:
 
   queue-microtask@1.2.3: {}
 
+  raf@3.4.1:
+    dependencies:
+      performance-now: 2.1.0
+    optional: true
+
   randombytes@2.1.0:
     dependencies:
       safe-buffer: 5.2.1
@@ -13658,6 +13792,9 @@ snapshots:
 
   reusify@1.1.0: {}
 
+  rgbcolor@1.0.1:
+    optional: true
+
   rimraf@2.7.1:
     dependencies:
       glob: 7.2.3
@@ -13984,6 +14121,9 @@ snapshots:
 
   stackback@0.0.2: {}
 
+  stackblur-canvas@2.7.0:
+    optional: true
+
   standard-as-callback@2.1.0: {}
 
   statuses@1.5.0: {}
@@ -14133,6 +14273,9 @@ snapshots:
 
   supports-preserve-symlinks-flag@1.0.0: {}
 
+  svg-pathdata@6.0.3:
+    optional: true
+
   svg-tags@1.0.0: {}
 
   swiper@11.1.15: {}
@@ -14222,6 +14365,11 @@ snapshots:
     transitivePeerDependencies:
       - react-native-b4a
 
+  text-segmentation@1.0.3:
+    dependencies:
+      utrie: 1.0.2
+    optional: true
+
   text-table@0.2.0: {}
 
   thenify-all@1.6.0:
@@ -14502,6 +14650,11 @@ snapshots:
 
   utils-merge@1.0.1: {}
 
+  utrie@1.0.2:
+    dependencies:
+      base64-arraybuffer: 1.0.2
+    optional: true
+
   uuid@8.3.2: {}
 
   v8-compile-cache-lib@3.0.1: {}

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/package.json

@@ -20,6 +20,7 @@
     "prisma:seed-legacy": "ts-node --transpile-only prisma/seed-prev1.ts",
     "prisma:seed-wecom-push": "ts-node --transpile-only prisma/seed-wecom-message-push.ts",
     "prisma:migrate-wecom-push": "ts-node --transpile-only prisma/migrate-wecom-message-push.ts",
+    "prisma:migrate-wecom-report": "ts-node --transpile-only prisma/migrate-wecom-report.ts",
     "prisma:upsert-super-admin": "ts-node --transpile-only scripts/upsert-super-admin.ts",
     "prisma:sync-benefit": "ts-node --transpile-only prisma/sync-benefit-to-price.ts",
     "prisma:merge-spu-dk000007-008": "ts-node --transpile-only prisma/merge-spu-dk000007-008.ts",

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/migrate-wecom-report.ts

@@ -0,0 +1,54 @@
+/**
+ * 创建 wecom_report_push（若不存在）并写入日/周/月默认行。
+ * 不依赖 Prisma Client 新 model，可在 generate 之前执行。
+ */
+import { PrismaClient } from '@prisma/client';
+
+const prisma = new PrismaClient();
+const PLACEHOLDER = 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=PENDING';
+
+async function main() {
+  await prisma.$executeRawUnsafe(`
+    CREATE TABLE IF NOT EXISTS wecom_report_push (
+      id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY,
+      kind VARCHAR(16) NOT NULL,
+      name VARCHAR(64) NOT NULL,
+      webhook_url VARCHAR(512) NOT NULL,
+      enabled TINYINT(1) NOT NULL DEFAULT 0,
+      mention_wecom_user_id VARCHAR(64) NULL,
+      send_hour INT NOT NULL DEFAULT 20,
+      send_minute INT NOT NULL DEFAULT 0,
+      send_weekday INT NOT NULL DEFAULT 1,
+      send_month_day INT NOT NULL DEFAULT 1,
+      last_sent_period VARCHAR(16) NULL,
+      last_sent_at DATETIME(3) NULL,
+      created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
+      updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3),
+      UNIQUE KEY wecom_report_push_kind_key (kind)
+    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
+  `);
+
+  const seeds: Array<[string, string, number]> = [
+    ['daily', '经营日报', 20],
+    ['weekly', '经营周报', 9],
+    ['monthly', '经营月报', 9],
+  ];
+  for (const [kind, name, hour] of seeds) {
+    await prisma.$executeRaw`
+      INSERT IGNORE INTO wecom_report_push
+        (kind, name, webhook_url, enabled, send_hour, send_minute, send_weekday, send_month_day)
+      VALUES
+        (${kind}, ${name}, ${PLACEHOLDER}, 0, ${hour}, 0, 1, 1)
+    `;
+  }
+  console.log('migrate-wecom-report done');
+}
+
+main()
+  .catch((e) => {
+    console.error(e);
+    process.exit(1);
+  })
+  .finally(async () => {
+    await prisma.$disconnect();
+  });

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 {
@@ -543,6 +546,26 @@ model WecomPushTemplate {
   @@map("wecom_push_template")
 }
 
+/// 企微群机器人经营报告推送（日报 / 周报 / 月报，与事件消息推送分开）
+model WecomReportPush {
+  id                 BigInt    @id @default(autoincrement()) @db.UnsignedBigInt
+  kind               String    @unique @db.VarChar(16)
+  name               String    @db.VarChar(64)
+  webhookUrl         String    @map("webhook_url") @db.VarChar(512)
+  enabled            Boolean   @default(false)
+  mentionWecomUserId String?   @map("mention_wecom_user_id") @db.VarChar(64)
+  sendHour           Int       @default(20) @map("send_hour")
+  sendMinute         Int       @default(0) @map("send_minute")
+  sendWeekday        Int       @default(1) @map("send_weekday")
+  sendMonthDay       Int       @default(1) @map("send_month_day")
+  lastSentPeriod     String?   @map("last_sent_period") @db.VarChar(16)
+  lastSentAt         DateTime? @map("last_sent_at") @db.DateTime(3)
+  createdAt          DateTime  @default(now()) @map("created_at") @db.DateTime(3)
+  updatedAt          DateTime  @updatedAt @map("updated_at") @db.DateTime(3)
+
+  @@map("wecom_report_push")
+}
+
 /// HQ 语言模型 API 配置（非超管仅可见/可开关自己创建的）
 model LlmApiConfig {
   id                   BigInt   @id @default(autoincrement()) @db.UnsignedBigInt
@@ -998,12 +1021,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 +1246,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 +1580,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 };
+}