fix;提交、

packages/shared-types/src/config.ts

@@ -45,6 +45,13 @@ export const BRAND_LOGO_MARK_URL = `${BRAND_LOGO_OSS_BASE}logo2.png`;
 /** 总部客服电话（C 端联系客服） */
 export const CUSTOMER_SERVICE_PHONE = '400-888-1234';
 
+/**
+ * 企业微信「微信客服」链接（C 端「在线客服」；微信内网页点击后进入原生客服会话）
+ * 可在 h5-user 用 VITE_CS_WECOM_URL 覆盖
+ */
+export const CUSTOMER_SERVICE_WECOM_URL =
+  'https://work.weixin.qq.com/kfid/kfc8b88659a1dffa8cd';
+
 function readEnv(env?: Record<string, string | undefined>) {
   return (
     env ??

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

@@ -9,6 +9,7 @@ export const HQ_PERMISSION_CATALOG = [
   { key: 'benefit', label: '好客权益' },
   { key: 'deliveries', label: '配送单' },
   { key: 'tickets', label: '工单中心' },
+  { key: 'invoices', label: '发票管理' },
   { key: 'resources', label: 'OSS 资源库' },
   { key: 'logs', label: '日志' },
   { key: 'hq_permissions', label: '权限分配' },
@@ -38,9 +39,10 @@ export const HQ_ROLE_DEFAULT_PERMISSIONS: Record<string, HqPermissionKey[]> = {
     'benefit',
     'deliveries',
     'tickets',
+    'invoices',
     'resources',
     'logs',
   ],
-  FINANCE: ['dashboard', 'orders', 'stores', 'partners', 'benefit', 'logs'],
-  CUSTOMER_SERVICE: ['dashboard', 'users', 'orders', 'tickets', 'logs'],
+  FINANCE: ['dashboard', 'orders', 'stores', 'partners', 'benefit', 'invoices', 'logs'],
+  CUSTOMER_SERVICE: ['dashboard', 'users', 'orders', 'tickets', 'invoices', 'logs'],
 };

packages/shared-types/src/index.ts

@@ -9,7 +9,9 @@ export * from './redeem';
 export * from './settlement';
 export * from './ops';
 export * from './ticket';
+export * from './invoice';
 export * from './user-log';
+
 export * from './store-log';
 export * from './partner-log';
 export * from './promo';

packages/shared-types/src/invoice.ts

@@ -0,0 +1,54 @@
+export type InvoiceTitleType = 'PERSONAL' | 'ENTERPRISE';
+export type InvoiceKind = 'NORMAL' | 'SPECIAL';
+export type InvoiceStatus = 'PENDING' | 'ISSUED' | 'REJECTED';
+
+export const INVOICE_TITLE_TYPE_LABELS: Record<InvoiceTitleType, string> = {
+  PERSONAL: '个人',
+  ENTERPRISE: '企业',
+};
+
+export const INVOICE_KIND_LABELS: Record<InvoiceKind, string> = {
+  NORMAL: '增值税普通发票',
+  SPECIAL: '增值税专用发票',
+};
+
+export const INVOICE_STATUS_LABELS: Record<InvoiceStatus, string> = {
+  PENDING: '待开票',
+  ISSUED: '已开票',
+  REJECTED: '已驳回',
+};
+
+export interface CreateInvoiceRequest {
+  titleType: InvoiceTitleType;
+  invoiceKind: InvoiceKind;
+  titleName: string;
+  taxNo?: string;
+  addressPhone?: string;
+  bankAccount?: string;
+  email: string;
+  phone: string;
+  remark?: string;
+}
+
+export interface InvoiceDto {
+  id: string;
+  invoiceNo: string;
+  orderId: string;
+  userId: string;
+  titleType: InvoiceTitleType;
+  invoiceKind: InvoiceKind;
+  titleName: string;
+  taxNo?: string | null;
+  addressPhone?: string | null;
+  bankAccount?: string | null;
+  email: string;
+  phone: string;
+  status: InvoiceStatus;
+  fileUrl?: string | null;
+  remark?: string | null;
+  issuedAt?: string | null;
+  createdAt: string;
+  orderNo?: string;
+  /** 待开票超过 2 个工作日（总部列表标红用） */
+  overdue?: boolean;
+}

packages/shared-types/src/ticket.ts

@@ -1,4 +1,28 @@
-export type TicketTypeDto = 'REFUND' | 'RESHIPMENT' | 'ALERT';
+/** 售后工单类型（PRD 四类型 + 系统 ALERT） */
+export type TicketTypeDto =
+  | 'REFUND'
+  | 'RESHIPMENT'
+  | 'ALERT'
+  | 'DAMAGE_RETURN'
+  | 'RETURN_REFUND';
+
+/** 用户可发起的售后类型 */
+export const AFTER_SALE_TICKET_TYPES = [
+  'REFUND',
+  'RESHIPMENT',
+  'DAMAGE_RETURN',
+  'RETURN_REFUND',
+] as const;
+
+export type AfterSaleTicketType = (typeof AFTER_SALE_TICKET_TYPES)[number];
+
+export const TICKET_TYPE_LABELS: Record<TicketTypeDto, string> = {
+  REFUND: '仅退款',
+  RESHIPMENT: '破损补发',
+  ALERT: '异常',
+  DAMAGE_RETURN: '破损退货',
+  RETURN_REFUND: '退货退款',
+};
 
 export interface TicketDto {
   id: string;
@@ -8,9 +32,16 @@ export interface TicketDto {
   refType: string;
   refId: string;
   remark?: string | null;
+  extraJson?: Record<string, unknown> | null;
   createdAt: string;
 }
 
 export interface TicketActionRequest {
   remark?: string;
 }
+
+export interface CreateAfterSaleTicketRequest {
+  ticketType: AfterSaleTicketType;
+  remark?: string;
+  evidenceUrls?: string[];
+}