feat;提交管理端和城市合伙人端

server/dukang-api/src/modules/analytics/analytics.controller.ts

@@ -1,15 +1,30 @@
 import { Body, Controller, Post, UseGuards } from '@nestjs/common';
 import { AnalyticsService } from './analytics.service';
 import { JwtAuthGuard, AuthUser } from '../../common/guards/jwt-auth.guard';
+import { OptionalJwtAuthGuard } from '../../common/guards/optional-jwt-auth.guard';
 import { CurrentUser } from '../../common/decorators/current-user.decorator';
+import { PromoTouchDto } from './dto/promo.dto';
+import { ActorType } from '@dukang/shared-types';
 
 @Controller('analytics')
-@UseGuards(JwtAuthGuard)
 export class AnalyticsController {
   constructor(private readonly analyticsService: AnalyticsService) {}
 
   @Post('events')
+  @UseGuards(JwtAuthGuard)
   track(@CurrentUser() user: AuthUser, @Body() body: { events: Array<{ eventName: string; params?: Record<string, unknown> }> }) {
     return this.analyticsService.trackBatch(user.actorId, user.clientApp, body.events);
   }
 }
+
+@Controller('promo')
+export class PromoController {
+  constructor(private readonly analyticsService: AnalyticsService) {}
+
+  @Post('touch')
+  @UseGuards(OptionalJwtAuthGuard)
+  touch(@CurrentUser() user: AuthUser | undefined, @Body() dto: PromoTouchDto) {
+    const userId = user?.actorType === ActorType.USER ? user.actorId : undefined;
+    return this.analyticsService.touchPromo(dto.promoCode, userId);
+  }
+}

server/dukang-api/src/modules/analytics/analytics.module.ts

@@ -1,11 +1,12 @@
 import { Module } from '@nestjs/common';
 import { IamModule } from '../iam/iam.module';
-import { AnalyticsController } from './analytics.controller';
+import { AnalyticsController, PromoController } from './analytics.controller';
 import { AnalyticsService } from './analytics.service';
 
 @Module({
   imports: [IamModule],
-  controllers: [AnalyticsController],
+  controllers: [AnalyticsController, PromoController],
   providers: [AnalyticsService],
+  exports: [AnalyticsService],
 })
 export class AnalyticsModule {}

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

@@ -1,6 +1,7 @@
-import { Injectable } from '@nestjs/common';
+import { Injectable, NotFoundException } from '@nestjs/common';
 import type { ClientApp } from '@prisma/client';
 import { PrismaService } from '../../common/prisma/prisma.module';
+import { serializeBigInt } from '../../common/decorators/current-user.decorator';
 
 @Injectable()
 export class AnalyticsService {
@@ -22,4 +23,43 @@ export class AnalyticsService {
     });
     return { count: events.length };
   }
+
+  /** 扫码归因：始终累加 scan_count；已登录用户首次写入 user_promo_attribution */
+  async touchPromo(promoCode: string, userId?: bigint) {
+    const code = promoCode.trim().toUpperCase();
+    const promo = await this.prisma.commonPromoCode.findUnique({ where: { code } });
+    if (!promo || promo.status !== 'ACTIVE') {
+      throw new NotFoundException('推广码无效或已停用');
+    }
+
+    await this.prisma.commonPromoCode.update({
+      where: { id: promo.id },
+      data: { scanCount: { increment: 1 } },
+    });
+
+    let attributed = false;
+    if (userId) {
+      const existing = await this.prisma.userPromoAttribution.findUnique({
+        where: { userId },
+      });
+      if (!existing) {
+        await this.prisma.userPromoAttribution.create({
+          data: {
+            userId,
+            promoCodeId: promo.id,
+            channelName: promo.name,
+            firstTouchAt: new Date(),
+          },
+        });
+        attributed = true;
+      }
+    }
+
+    return serializeBigInt({
+      promoCode: promo.code,
+      channelName: promo.name,
+      attributed,
+    });
+  }
 }
+

server/dukang-api/src/modules/analytics/dto/promo.dto.ts

@@ -0,0 +1,7 @@
+import { IsNotEmpty, IsString } from 'class-validator';
+
+export class PromoTouchDto {
+  @IsString()
+  @IsNotEmpty()
+  promoCode: string;
+}

server/dukang-api/src/modules/common/client-config.controller.ts

@@ -9,6 +9,7 @@ export class ClientConfigController {
     return {
       mockPay: cfg.mockPay,
       wechatPayEnabled: cfg.wechatPayEnabled,
+      mockWechat: cfg.mockWechat,
     };
   }
 }

server/dukang-api/src/modules/iam/admin-auth.controller.ts

@@ -1,6 +1,6 @@
 import { Body, Controller, Get, Post, UseGuards } from '@nestjs/common';
 import { AuthService } from './auth.service';
-import { LoginSmsDto, SendSmsDto } from './dto/auth.dto';
+import { LoginSmsDto, LoginWechatDto, SendSmsDto } from './dto/auth.dto';
 import { JwtAuthGuard } from '../../common/guards/jwt-auth.guard';
 import { CurrentUser } from '../../common/decorators/current-user.decorator';
 import { AuthUser } from '../../common/guards/jwt-auth.guard';
@@ -20,6 +20,11 @@ export class AdminAuthController {
     return this.authService.loginHq(dto.phone, dto.code, ClientApp.HQ_WEB);
   }
 
+  @Post('login/wechat')
+  wechatLogin(@Body() dto: LoginWechatDto) {
+    return this.authService.loginHqWechat(dto.code, ClientApp.HQ_WEB, dto.platform ?? 'h5');
+  }
+
   @Get('me')
   @UseGuards(JwtAuthGuard)
   me(@CurrentUser() user: AuthUser) {

server/dukang-api/src/modules/iam/auth.service.ts

@@ -268,6 +268,48 @@ export class AuthService {
     });
   }
 
+  async loginHqWechat(code: string, clientApp: ClientApp, platform: 'h5' | 'mini' = 'h5') {
+    this.assertWechatEnabled();
+    const session =
+      platform === 'mini'
+        ? await this.wechatProvider.code2Session(code)
+        : await this.wechatProvider.oauth2AccessToken(code);
+
+    let account = await this.prisma.hqAccount.findFirst({
+      where: { wxOpenId: session.openId },
+    });
+
+    if (!account && this.wechatProvider.isMock()) {
+      // preV1 Mock：无绑定微信时回落到演示超管账号
+      account = await this.prisma.hqAccount.findFirst({
+        where: { status: 'ACTIVE' },
+        orderBy: [{ adminRole: 'asc' }, { id: 'asc' }],
+      });
+    }
+
+    if (!account) {
+      throw new BadRequestException('首次登录请使用手机验证码，登录后将自动关联微信');
+    }
+    if (account.status !== 'ACTIVE') throw new BadRequestException('账号已停用');
+
+    account = await this.prisma.hqAccount.update({
+      where: { id: account.id },
+      data: {
+        wxOpenId: session.openId,
+        wxUnionId: session.unionId ?? account.wxUnionId,
+        lastLoginAt: new Date(),
+      },
+    });
+
+    return this.issueToken('HQ', account.id, clientApp, false, undefined, undefined, undefined, undefined, {
+      id: account.id.toString(),
+      phone: account.phone,
+      name: account.name,
+      adminRole: account.adminRole,
+      status: account.status,
+    });
+  }
+
   async getMe(actorType: string, actorId: bigint) {
     if (actorType === 'USER') {
       const user = await this.assertActiveUser(actorId);
@@ -555,6 +597,15 @@ export class AuthService {
       include: { partner: true },
     });
 
+    if (!account && this.wechatProvider.isMock()) {
+      // preV1 Mock：无绑定微信时回落到演示主账号，方便一键授权登录
+      account = await this.prisma.partnerAccount.findFirst({
+        where: { status: 'ACTIVE' },
+        orderBy: [{ isPrimary: 'desc' }, { id: 'asc' }],
+        include: { partner: true },
+      });
+    }
+
     if (!account) {
       throw new BadRequestException('首次登录请使用手机验证码，登录后将自动关联微信');
     }

server/dukang-api/src/modules/ops/admin-promo-codes.controller.ts

@@ -0,0 +1,36 @@
+import { Body, Controller, Get, Param, Post, Put, Query, UseGuards } from '@nestjs/common';
+import { HqAuthGuard } from '../../common/guards/hq-auth.guard';
+import { AdminPromoCodesService } from './admin-promo-codes.service';
+import { AdminPromoCodesQueryDto } from './dto/admin-query.dto';
+import { CreatePromoCodeDto, UpdatePromoCodeStatusDto } from './dto/admin-mutate.dto';
+
+@Controller('admin/promo-codes')
+@UseGuards(HqAuthGuard)
+export class AdminPromoCodesController {
+  constructor(private readonly service: AdminPromoCodesService) {}
+
+  @Get()
+  list(@Query() query: AdminPromoCodesQueryDto) {
+    return this.service.list(query);
+  }
+
+  @Get(':id/stats')
+  stats(@Param('id') id: string) {
+    return this.service.stats(BigInt(id));
+  }
+
+  @Get(':id')
+  detail(@Param('id') id: string) {
+    return this.service.detail(BigInt(id));
+  }
+
+  @Post()
+  create(@Body() dto: CreatePromoCodeDto) {
+    return this.service.create(dto);
+  }
+
+  @Put(':id/status')
+  updateStatus(@Param('id') id: string, @Body() dto: UpdatePromoCodeStatusDto) {
+    return this.service.updateStatus(BigInt(id), dto.status);
+  }
+}

server/dukang-api/src/modules/ops/admin-promo-codes.service.ts

@@ -0,0 +1,133 @@
+import {
+  BadRequestException,
+  Injectable,
+  NotFoundException,
+} from '@nestjs/common';
+import { PrismaService } from '../../common/prisma/prisma.module';
+import { serializeBigInt } from '../../common/decorators/current-user.decorator';
+import { CreatePromoCodeDto } from './dto/admin-mutate.dto';
+import { AdminPromoCodesQueryDto } from './dto/admin-query.dto';
+
+function userH5Base(): string {
+  return (process.env.USER_H5_URL || 'http://localhost:5173').replace(/\/$/, '');
+}
+
+function buildLandingUrl(code: string): string {
+  return `${userH5Base()}/?promo=${encodeURIComponent(code)}`;
+}
+
+function randomCode(): string {
+  const n = Math.random().toString(36).slice(2, 8).toUpperCase();
+  return `DK${n}`;
+}
+
+@Injectable()
+export class AdminPromoCodesService {
+  constructor(private readonly prisma: PrismaService) {}
+
+  private mapRow(row: {
+    id: bigint;
+    code: string;
+    name: string;
+    status: string;
+    scanCount: number;
+    orderCount: number;
+    createdAt: Date;
+  }) {
+    return serializeBigInt({
+      id: row.id,
+      code: row.code,
+      name: row.name,
+      status: row.status,
+      scanCount: row.scanCount,
+      orderCount: row.orderCount,
+      landingUrl: buildLandingUrl(row.code),
+      createdAt: row.createdAt,
+    });
+  }
+
+  async list(query: AdminPromoCodesQueryDto) {
+    const page = query.page ?? 1;
+    const pageSize = query.pageSize ?? 20;
+    const where: {
+      status?: 'ACTIVE' | 'DISABLED';
+      name?: { contains: string };
+      code?: { contains: string };
+    } = {};
+    if (query.status) where.status = query.status as 'ACTIVE' | 'DISABLED';
+    if (query.name) where.name = { contains: query.name };
+    if (query.code) where.code = { contains: query.code };
+
+    const [items, total] = await Promise.all([
+      this.prisma.commonPromoCode.findMany({
+        where,
+        orderBy: { createdAt: 'desc' },
+        skip: (page - 1) * pageSize,
+        take: pageSize,
+      }),
+      this.prisma.commonPromoCode.count({ where }),
+    ]);
+    return serializeBigInt({
+      items: items.map((r) => this.mapRow(r)),
+      total,
+      page,
+      pageSize,
+    });
+  }
+
+  async detail(id: bigint) {
+    const row = await this.prisma.commonPromoCode.findUnique({ where: { id } });
+    if (!row) throw new NotFoundException('推广码不存在');
+    const stats = this.statsFromRow(row);
+    return serializeBigInt({ ...this.mapRow(row), stats });
+  }
+
+  async create(dto: CreatePromoCodeDto) {
+    let code = dto.code?.trim().toUpperCase();
+    if (code) {
+      const exists = await this.prisma.commonPromoCode.findUnique({ where: { code } });
+      if (exists) throw new BadRequestException('推广码已存在');
+    } else {
+      for (let i = 0; i < 5; i++) {
+        const candidate = randomCode();
+        const exists = await this.prisma.commonPromoCode.findUnique({ where: { code: candidate } });
+        if (!exists) {
+          code = candidate;
+          break;
+        }
+      }
+      if (!code) throw new BadRequestException('生成推广码失败，请重试');
+    }
+
+    const row = await this.prisma.commonPromoCode.create({
+      data: {
+        code,
+        name: dto.name.trim(),
+        status: 'ACTIVE',
+      },
+    });
+    return this.mapRow(row);
+  }
+
+  async updateStatus(id: bigint, status: 'ACTIVE' | 'DISABLED') {
+    const row = await this.prisma.commonPromoCode.update({
+      where: { id },
+      data: { status },
+    });
+    return this.mapRow(row);
+  }
+
+  async stats(id: bigint) {
+    const row = await this.prisma.commonPromoCode.findUnique({ where: { id } });
+    if (!row) throw new NotFoundException('推广码不存在');
+    return serializeBigInt(this.statsFromRow(row));
+  }
+
+  private statsFromRow(row: { scanCount: number; orderCount: number }) {
+    const scanCount = row.scanCount;
+    const orderCount = row.orderCount;
+    const conversionRate =
+      scanCount > 0 ? Math.round((orderCount / scanCount) * 1000) / 10 : 0;
+    return { scanCount, orderCount, conversionRate };
+  }
+}

server/dukang-api/src/modules/ops/dto/admin-mutate.dto.ts

@@ -426,3 +426,19 @@ export class UpdateProductDto {
   @IsString()
   coverUrl?: string;
 }
+
+export class CreatePromoCodeDto {
+  @IsString()
+  @IsNotEmpty()
+  name: string;
+
+  @IsOptional()
+  @IsString()
+  code?: string;
+}
+
+export class UpdatePromoCodeStatusDto {
+  @IsString()
+  @IsIn(['ACTIVE', 'DISABLED'])
+  status: 'ACTIVE' | 'DISABLED';
+}

server/dukang-api/src/modules/ops/dto/admin-query.dto.ts

@@ -236,3 +236,17 @@ export class AdminStoreMediaQueryDto extends PaginationQueryDto {
   @IsString()
   mediaType?: string;
 }
+
+export class AdminPromoCodesQueryDto extends PaginationQueryDto {
+  @IsOptional()
+  @IsString()
+  name?: string;
+
+  @IsOptional()
+  @IsString()
+  code?: string;
+
+  @IsOptional()
+  @IsIn(['ACTIVE', 'DISABLED'])
+  status?: string;
+}

server/dukang-api/src/modules/ops/ops.module.ts

@@ -21,6 +21,8 @@ import { AdminHqAccountsController } from './admin-hq-accounts.controller';
 import { AdminHqAccountsService } from './admin-hq-accounts.service';
 import { AdminProductsController } from './admin-products.controller';
 import { AdminProductsService } from './admin-products.service';
+import { AdminPromoCodesController } from './admin-promo-codes.controller';
+import { AdminPromoCodesService } from './admin-promo-codes.service';
 import { SuperAdminGuard } from '../../common/guards/super-admin.guard';
 
 @Module({
@@ -41,6 +43,7 @@ import { SuperAdminGuard } from '../../common/guards/super-admin.guard';
     AdminDeliveriesController,
     AdminHqAccountsController,
     AdminProductsController,
+    AdminPromoCodesController,
   ],
   providers: [
     AdminDashboardService,
@@ -54,6 +57,7 @@ import { SuperAdminGuard } from '../../common/guards/super-admin.guard';
     AdminDeliveriesService,
     AdminHqAccountsService,
     AdminProductsService,
+    AdminPromoCodesService,
     SuperAdminGuard,
   ],
 })