feat(store): benefit coupon usage rules and show env photos on store detail

Add benefitUsageRule on store create/edit (HQ + partner) and C-end detail between intro and env gallery.

Co-authored-by: Cursor <cursoragent@cursor.com>

server/dukang-api/prisma/schema.prisma

@@ -1025,6 +1025,8 @@ model Store {
   latitude        Decimal?    @db.Decimal(10, 7)
   longitude       Decimal?    @db.Decimal(10, 7)
   intro           String?     @db.Text
+  /** 好客权益券使用规则（C 端门店详情展示） */
+  benefitUsageRule String?    @map("benefit_usage_rule") @db.Text
   coverResourceId BigInt?     @map("cover_resource_id") @db.UnsignedBigInt
   avgPrice        Decimal?    @map("avg_price") @db.Decimal(10, 2)
   rating          Decimal?    @db.Decimal(3, 2)

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

@@ -214,6 +214,9 @@ export class AdminStoresService {
         ...(dto.name !== undefined ? { name: dto.name } : {}),
         ...(dto.phone !== undefined ? { phone: dto.phone } : {}),
         ...(dto.intro !== undefined ? { intro: dto.intro } : {}),
+        ...(dto.benefitUsageRule !== undefined
+          ? { benefitUsageRule: String(dto.benefitUsageRule).trim() || null }
+          : {}),
         ...(dto.address !== undefined ? { address: dto.address } : {}),
         ...(dto.district !== undefined ? { district: dto.district } : {}),
         ...(dto.settlementRate !== undefined ? { settlementRate: dto.settlementRate } : {}),
@@ -305,6 +308,15 @@ export class AdminStoresService {
     ]);
     if (!hoursCheck.ok) throw new BadRequestException(hoursCheck.message);
 
+    const intro = dto.intro?.trim() || null;
+    if (intro && (intro.length < 2 || intro.length > 500)) {
+      throw new BadRequestException('门店简介须为 2~500 字');
+    }
+    const benefitUsageRule = dto.benefitUsageRule?.trim() || null;
+    if (benefitUsageRule && benefitUsageRule.length > 1000) {
+      throw new BadRequestException('好客权益券使用规则最多 1000 字');
+    }
+
     const store = await this.prisma.store.create({
       data: {
         cityId: city.id,
@@ -317,7 +329,8 @@ export class AdminStoresService {
         cityName: dto.city ?? city.name,
         district: dto.district ?? '',
         address: dto.address,
-        intro: dto.intro ?? null,
+        intro,
+        benefitUsageRule,
         avgPrice: dto.avgPrice ?? null,
         openTime,
         closeTime,

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

@@ -69,6 +69,10 @@ export class CreateStoreDto {
   @IsString()
   intro?: string;
 
+  @IsOptional()
+  @IsString()
+  benefitUsageRule?: string;
+
   @IsOptional()
   @IsString()
   coverUrl?: string;
@@ -138,6 +142,10 @@ export class UpdateStoreDto {
   @IsString()
   intro?: string;
 
+  @IsOptional()
+  @IsString()
+  benefitUsageRule?: string;
+
   @IsOptional()
   @IsString()
   coverUrl?: string;

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

@@ -304,6 +304,11 @@ export class StoreService {
     if (introRaw && (introRaw.length < 2 || introRaw.length > 500)) {
       throw new BadRequestException('门店简介须为 2~500 字');
     }
+    const benefitUsageRuleRaw =
+      body.benefitUsageRule != null ? String(body.benefitUsageRule).trim() : '';
+    if (benefitUsageRuleRaw.length > 1000) {
+      throw new BadRequestException('好客权益券使用规则最多 1000 字');
+    }
 
     const latitude = parseOptionalCoord(body.latitude, 'lat');
     const longitude = parseOptionalCoord(body.longitude, 'lng');
@@ -323,6 +328,7 @@ export class StoreService {
         district: String(body.district ?? ''),
         address: String(body.address),
         intro: introRaw || null,
+        benefitUsageRule: benefitUsageRuleRaw || null,
         avgPrice: avgPriceRaw,
         openTime,
         closeTime,
@@ -518,6 +524,8 @@ export class StoreService {
     const phone = body.phone !== undefined ? String(body.phone).trim() : undefined;
     const address = body.address !== undefined ? String(body.address).trim() : undefined;
     const introRaw = body.intro !== undefined ? String(body.intro).trim() : undefined;
+    const benefitUsageRuleRaw =
+      body.benefitUsageRule !== undefined ? String(body.benefitUsageRule).trim() : undefined;
     const latitude =
       body.latitude !== undefined ? parseOptionalCoord(body.latitude, 'lat') : undefined;
     const longitude =
@@ -531,6 +539,9 @@ export class StoreService {
     if (introRaw && (introRaw.length < 2 || introRaw.length > 500)) {
       throw new BadRequestException('门店简介须为 2~500 字');
     }
+    if (benefitUsageRuleRaw !== undefined && benefitUsageRuleRaw.length > 1000) {
+      throw new BadRequestException('好客权益券使用规则最多 1000 字');
+    }
     if (
       (latitude !== undefined || longitude !== undefined) &&
       (latitude == null || longitude == null)
@@ -552,6 +563,9 @@ export class StoreService {
           : {}),
         ...(hasCoordsUpdate ? { latitude, longitude } : {}),
         ...(introRaw !== undefined ? { intro: introRaw || null } : {}),
+        ...(benefitUsageRuleRaw !== undefined
+          ? { benefitUsageRule: benefitUsageRuleRaw || null }
+          : {}),
         ...(resubmitAudit
           ? {
               auditStatus: 'PENDING' as const,