init

src/modules/coupons/dto/create-coupon.dto.ts

@@ -0,0 +1,115 @@
+import {
+  IsNotEmpty,
+  IsString,
+  IsEnum,
+  IsNumber,
+  IsOptional,
+  IsBoolean,
+  IsDateString,
+  Min,
+  IsArray,
+} from 'class-validator';
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import { CouponType } from '../interface/coupon';
+
+export class CreateCouponDto {
+  @IsNotEmpty()
+  @IsString()
+  @ApiProperty({ example: 'DISCOUNT10', description: 'Unique coupon code' })
+  code!: string;
+
+  @IsNotEmpty()
+  @IsString()
+  @ApiProperty({ example: '10% Off', description: 'Coupon name' })
+  name!: string;
+
+  @IsOptional()
+  @IsString()
+  @ApiPropertyOptional({ example: 'Get 10% off on your order', description: 'Coupon description' })
+  description?: string;
+
+  @IsNotEmpty()
+  @IsEnum(CouponType)
+  @ApiProperty({ enum: CouponType, example: CouponType.PERCENTAGE, description: 'Coupon type' })
+  type!: CouponType;
+
+  @IsNotEmpty()
+  @IsNumber()
+  @Min(0)
+  @Type(() => Number)
+  @ApiProperty({ example: 10, description: 'Discount value (amount or percentage)' })
+  value!: number;
+
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  @Type(() => Number)
+  @ApiPropertyOptional({ example: 50000, description: 'Maximum discount amount (for percentage coupons)' })
+  maxDiscount?: number;
+
+  @IsOptional()
+  @IsNumber()
+  @Min(0)
+  @Type(() => Number)
+  @ApiPropertyOptional({ example: 100000, description: 'Minimum order amount to use coupon' })
+  minOrderAmount?: number;
+
+  @IsOptional()
+  @IsNumber()
+  @Min(1)
+  @Type(() => Number)
+  @ApiPropertyOptional({ example: 100, description: 'Maximum number of times coupon can be used' })
+  maxUses?: number;
+
+  @IsOptional()
+  @IsNumber()
+  @Min(1)
+  @Type(() => Number)
+  @ApiPropertyOptional({ example: 1, description: 'Maximum uses per user' })
+  maxUsesPerUser?: number;
+
+  @IsOptional()
+  @IsDateString()
+  @ApiPropertyOptional({ example: '2024-01-01T00:00:00Z', description: 'Coupon validity start date' })
+  startDate?: string;
+
+  @IsOptional()
+  @IsDateString()
+  @ApiPropertyOptional({ example: '2024-12-31T23:59:59Z', description: 'Coupon validity end date' })
+  endDate?: string;
+
+  @IsOptional()
+  @IsBoolean()
+  @Type(() => Boolean)
+  @ApiPropertyOptional({ example: true, description: 'Whether coupon is active' })
+  isActive?: boolean;
+
+  @IsOptional()
+  @IsArray()
+  @IsString({ each: true })
+  @ApiPropertyOptional({
+    example: ['category-id-1', 'category-id-2'],
+    description: 'Array of food category IDs. If empty, coupon applies to all categories.',
+    type: [String],
+  })
+  foodCategories?: string[];
+
+  @IsOptional()
+  @IsArray()
+  @IsString({ each: true })
+  @ApiPropertyOptional({
+    example: ['food-id-1', 'food-id-2'],
+    description: 'Array of food IDs. If empty, coupon applies to all foods.',
+    type: [String],
+  })
+  foods?: string[];
+
+  @IsOptional()
+  @IsString()
+  @ApiPropertyOptional({
+    example: '09123456789',
+    description: 'Phone number of the user who can use this coupon. If empty, coupon can be used by any user.',
+  })
+  userPhone?: string;
+}

src/modules/coupons/dto/find-coupons.dto.ts

@@ -0,0 +1,44 @@
+import { IsOptional, IsString, IsBoolean, IsNumber, IsEnum } from 'class-validator';
+import { ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import { CouponType } from '../interface/coupon';
+
+export class FindCouponsDto {
+  @IsOptional()
+  @IsNumber()
+  @Type(() => Number)
+  @ApiPropertyOptional({ example: 1, description: 'Page number' })
+  page?: number;
+
+  @IsOptional()
+  @IsNumber()
+  @Type(() => Number)
+  @ApiPropertyOptional({ example: 10, description: 'Items per page' })
+  limit?: number;
+
+  @IsOptional()
+  @IsString()
+  @ApiPropertyOptional({ example: 'DISCOUNT', description: 'Search term for code or name' })
+  search?: string;
+
+  @IsOptional()
+  @IsEnum(CouponType)
+  @ApiPropertyOptional({ enum: CouponType, description: 'Filter by coupon type' })
+  type?: CouponType;
+
+  @IsOptional()
+  @IsBoolean()
+  @Type(() => Boolean)
+  @ApiPropertyOptional({ example: true, description: 'Filter by active status' })
+  isActive?: boolean;
+
+  @IsOptional()
+  @IsString()
+  @ApiPropertyOptional({ example: 'createdAt', description: 'Field to order by' })
+  orderBy?: string;
+
+  @IsOptional()
+  @IsEnum(['asc', 'desc'])
+  @ApiPropertyOptional({ enum: ['asc', 'desc'], example: 'desc', description: 'Sort order' })
+  order?: 'asc' | 'desc';
+}

src/modules/coupons/dto/update-coupon.dto.ts

@@ -0,0 +1,4 @@
+import { PartialType } from '@nestjs/swagger';
+import { CreateCouponDto } from './create-coupon.dto';
+
+export class UpdateCouponDto extends PartialType(CreateCouponDto) {}

src/modules/coupons/dto/validate-coupon.dto.ts

@@ -0,0 +1,21 @@
+import { IsNotEmpty, IsString, IsNumber, IsOptional } from 'class-validator';
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+
+export class ValidateCouponDto {
+  @IsNotEmpty()
+  @IsString()
+  @ApiProperty({ example: 'DISCOUNT10', description: 'Coupon code to validate' })
+  code!: string;
+
+  @IsOptional()
+  @IsNumber()
+  @Type(() => Number)
+  @ApiPropertyOptional({ example: 150000, description: 'Order total amount for validation' })
+  orderAmount?: number;
+
+  @IsOptional()
+  @IsString()
+  @ApiPropertyOptional({ example: 'user-id', description: 'User ID for per-user usage limits' })
+  userId?: string;
+}