v4.0.18版本提交

packages/domain/src/index.ts

@@ -415,3 +415,4 @@ export * from './dashboard-series';
 export * from './wecom-report';
 export * from './wecom-plugin';
 export * from './shipping-address';
+export * from './store-address';

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

@@ -0,0 +1,31 @@
+import { describe, expect, it } from 'vitest';
+import { formatStoreDisplayAddress } from './store-address';
+
+describe('formatStoreDisplayAddress', () => {
+  it('concatenates dropdown region with street-only detail', () => {
+    expect(
+      formatStoreDisplayAddress({
+        province: '河南省',
+        cityName: '郑州市',
+        district: '金水区',
+        address: '金水东路333号',
+      }),
+    ).toBe('河南省郑州市金水区金水东路333号');
+  });
+
+  it('does not strip region prefix already present in detail', () => {
+    expect(
+      formatStoreDisplayAddress({
+        province: '河南省',
+        cityName: '郑州市',
+        district: '金水区',
+        address: '河南省郑州市金水区金水东路333号',
+      }),
+    ).toBe('河南省郑州市金水区河南省郑州市金水区金水东路333号');
+  });
+
+  it('returns fallback when all parts are empty', () => {
+    expect(formatStoreDisplayAddress({})).toBe('地址待完善');
+    expect(formatStoreDisplayAddress({}, '')).toBe('');
+  });
+});

packages/domain/src/store-address.ts

@@ -0,0 +1,29 @@
+export const STORE_ADDRESS_FALLBACK = '地址待完善';
+
+export type StoreAddressParts = {
+  province?: string | null;
+  cityName?: string | null;
+  city?: string | null;
+  district?: string | null;
+  address?: string | null;
+};
+
+function textPart(value: unknown): string {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+/**
+ * 门店展示地址：省 + 市 + 区 + 详细地址，按字段原样拼接。
+ * 省/市/区来自下拉选择，详细地址来自自由输入；即使详细地址已含省市区也不得去重。
+ */
+export function formatStoreDisplayAddress(
+  store: StoreAddressParts,
+  fallback = STORE_ADDRESS_FALLBACK,
+): string {
+  const province = textPart(store.province);
+  const city = textPart(store.cityName) || textPart(store.city);
+  const district = textPart(store.district);
+  const detail = textPart(store.address);
+  const text = `${province}${city}${district}${detail}`;
+  return text || fallback;
+}

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

@@ -1,6 +1,8 @@
 import { describe, expect, it } from 'vitest';
 import {
   formatWecomReportMarkdown,
+  WECOM_REPORT_EXCLUDED_ORDER_STATUSES,
+  wecomReportCountedOrderWhere,
   wecomReportCutoff,
   wecomReportDueAt,
   wecomReportPeriod,
@@ -24,6 +26,19 @@ const emptyStats = {
   redeemAmountIncrement: 40,
 };
 
+describe('wecomReportCountedOrderWhere', () => {
+  it('excludes pending pay, cancelled and refunding', () => {
+    expect([...WECOM_REPORT_EXCLUDED_ORDER_STATUSES]).toEqual([
+      'PENDING_PAY',
+      'CANCELLED',
+      'REFUNDING',
+    ]);
+    expect(wecomReportCountedOrderWhere()).toEqual({
+      status: { notIn: ['PENDING_PAY', 'CANCELLED', 'REFUNDING'] },
+    });
+  });
+});
+
 describe('wecomReportPeriod', () => {
   it('daily is the previous Shanghai calendar day (closed at send-day 00:00)', () => {
     const p = wecomReportPeriod('daily', new Date('2026-09-02T20:00:00+08:00'));

packages/domain/src/wecom-report.ts

@@ -17,6 +17,20 @@ export function isWecomReportKind(v: string): v is WecomReportKind {
   return (WECOM_REPORT_KINDS as readonly string[]).includes(v);
 }
 
+/** 经营报告/插件指标：订单笔数与金额均不计入待支付、已取消、退款中 */
+export const WECOM_REPORT_EXCLUDED_ORDER_STATUSES = [
+  'PENDING_PAY',
+  'CANCELLED',
+  'REFUNDING',
+] as const;
+
+export type WecomReportExcludedOrderStatus =
+  (typeof WECOM_REPORT_EXCLUDED_ORDER_STATUSES)[number];
+
+export function wecomReportCountedOrderWhere() {
+  return { status: { notIn: [...WECOM_REPORT_EXCLUDED_ORDER_STATUSES] } };
+}
+
 export type WecomReportStats = {
   usersTotal: number;
   usersIncrement: number;