feat(ops): add HQ admin proxy order and mini-user store session fixes

Align HQ orders page with partner dual-SMS offline proxy flow; improve mini-user stores session and WeChat confirm-receive handling. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-31 09:18:19 +08:00
parent 1a0afb6d39
commit 2cd4e25682
21 changed files with 1438 additions and 143 deletions
@@ -0,0 +1,59 @@
+import { Body, Controller, Get, Post, Req, UseGuards } from '@nestjs/common';
+import type { Request } from 'express';
+import { CurrentUser } from '../../common/decorators/current-user.decorator';
+import { HqAuthGuard } from '../../common/guards/hq-auth.guard';
+import {
+  HqPermissionGuard,
+  RequireHqPermissions,
+} from '../../common/guards/hq-permission.guard';
+import type { AuthUser } from '../../common/guards/jwt-auth.guard';
+import { HqOperation } from '../../common/hq-operation/hq-operation.decorator';
+import { HqOperationAction } from '../../common/hq-operation/hq-operation.constants';
+import { TradeService } from '../trade/trade.service';
+import {
+  HqProxyOrderCreateDto,
+  HqProxyOrderPreviewDto,
+  HqProxyOrderSendCustomerSmsDto,
+} from './dto/hq-proxy-order.dto';
+
+@Controller('admin/proxy-orders')
+@UseGuards(HqAuthGuard, HqPermissionGuard)
+@RequireHqPermissions('orders')
+export class AdminProxyOrdersController {
+  constructor(private readonly tradeService: TradeService) {}
+
+  @Get('options')
+  options() {
+    return this.tradeService.getHqProxyOrderOptions();
+  }
+
+  @Post('preview')
+  preview(@Body() dto: HqProxyOrderPreviewDto) {
+    return this.tradeService.previewPartnerProxyOrder(dto);
+  }
+
+  @Post('send-customer-sms')
+  sendCustomerSms(@Body() dto: HqProxyOrderSendCustomerSmsDto) {
+    return this.tradeService.sendHqProxyCustomerSms(dto.phone);
+  }
+
+  @Post('send-operator-sms')
+  sendOperatorSms(@CurrentUser() user: AuthUser) {
+    return this.tradeService.sendHqProxyOperatorSms(user.actorId);
+  }
+
+  @Post()
+  @HqOperation({
+    action: HqOperationAction.ORDER_PROXY_CREATE,
+    refType: 'ORDER',
+    batch: true,
+    includeBody: true,
+  })
+  create(
+    @CurrentUser() user: AuthUser,
+    @Body() dto: HqProxyOrderCreateDto,
+    @Req() req: Request,
+  ) {
+    return this.tradeService.createHqProxyOrder(user.actorId, dto, req);
+  }
+}
@@ -0,0 +1,102 @@
+import { Type } from 'class-transformer';
+import {
+  IsBoolean,
+  IsIn,
+  IsInt,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  Matches,
+  MaxLength,
+  Min,
+  ValidateIf,
+} from 'class-validator';
+
+export class HqProxyOrderPreviewDto {
+  @IsString()
+  @IsNotEmpty()
+  productId: string;
+
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  quantity: number;
+
+  @IsOptional()
+  @IsIn(['ADDRESS', 'ON_SITE_PICKUP'])
+  deliveryMode?: 'ADDRESS' | 'ON_SITE_PICKUP';
+
+  @IsOptional()
+  @IsString()
+  receiverCity?: string;
+
+  @IsOptional()
+  @IsString()
+  receiverDistrict?: string;
+}
+
+export class HqProxyOrderSendCustomerSmsDto {
+  @IsString()
+  @Matches(/^1\d{10}$/, { message: '请输入有效手机号' })
+  phone: string;
+}
+
+export class HqProxyOrderCreateDto {
+  @IsString()
+  @Matches(/^1\d{10}$/, { message: '请输入有效手机号' })
+  phone: string;
+
+  @IsString()
+  @IsNotEmpty()
+  customerSmsCode: string;
+
+  /** 发至当前 HQ 登录手机号的确认验证码 */
+  @IsString()
+  @IsNotEmpty()
+  operatorSmsCode: string;
+
+  @IsIn(['ADDRESS', 'ON_SITE_PICKUP'])
+  deliveryMode: 'ADDRESS' | 'ON_SITE_PICKUP';
+
+  @ValidateIf((o: HqProxyOrderCreateDto) => o.deliveryMode === 'ADDRESS')
+  @IsBoolean()
+  autoReceive?: boolean;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(32)
+  receiverName?: string;
+
+  @ValidateIf((o: HqProxyOrderCreateDto) => o.deliveryMode === 'ADDRESS')
+  @IsString()
+  @MaxLength(32)
+  province?: string;
+
+  @ValidateIf((o: HqProxyOrderCreateDto) => o.deliveryMode === 'ADDRESS')
+  @IsString()
+  @MaxLength(32)
+  city?: string;
+
+  @ValidateIf((o: HqProxyOrderCreateDto) => o.deliveryMode === 'ADDRESS')
+  @IsString()
+  @MaxLength(32)
+  district?: string;
+
+  @ValidateIf((o: HqProxyOrderCreateDto) => o.deliveryMode === 'ADDRESS')
+  @IsString()
+  @MaxLength(256)
+  addressDetail?: string;
+
+  @IsString()
+  @IsNotEmpty()
+  productId: string;
+
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  quantity: number;
+
+  @IsOptional()
+  @IsString()
+  promoCodeId?: string;
+}
@@ -10,6 +10,7 @@ import { AdminUsersController } from './admin-users.controller';
 import { AdminUsersService } from './admin-users.service';
 import { AdminOrdersController } from './admin-orders.controller';
 import { AdminOrdersService } from './admin-orders.service';
+import { AdminProxyOrdersController } from './admin-proxy-orders.controller';
 import { AdminStoresController, AdminStoreAccountsController, AdminStoreMediaController } from './admin-stores.controller';
 import { AdminStoreCategoriesController } from './admin-store-categories.controller';
 import { AdminStoresService } from './admin-stores.service';
@@ -76,6 +77,7 @@ import { AdminFulfillmentProvidersController } from './admin-fulfillment-provide
    AdminDeployController,
    AdminUsersController,
    AdminOrdersController,
+    AdminProxyOrdersController,
    AdminStoresController,
    AdminStoreAccountsController,
    AdminStoreMediaController,