feat(product-center): implement full product center with NestJS backend, Vue3 admin, and Nuxt4 website page

- NestJS backend: Prisma + PostgreSQL, JWT auth, CRUD for goods/categories/countries/tags/positions, SDS sync with cron, public API, Swagger docs - Vue3 Admin: Element Plus, goods/categories/countries/tags/positions/sync management pages, batch operations, login with JWT - Nuxt4 Website: product-center page with sidebar navigation, country filter, search, product grid, pagination, skeleton loading - Nitro proxy routes for backend API - 54 backend tests passing - Updated docs and README
2026-06-15 10:09:42 +08:00
parent 72bc89ab03
commit c3472a449b
125 changed files with 22206 additions and 0 deletions
@@ -0,0 +1,60 @@
+import { ApiProperty } from '@nestjs/swagger';
+import {
+  ArrayMinSize,
+  IsArray,
+  IsInt,
+  IsOptional,
+  Min,
+  ValidateNested,
+} from 'class-validator';
+import { Type } from 'class-transformer';
+
+export class BatchCreateItemDto {
+  @ApiProperty()
+  @IsInt()
+  @Min(1)
+  originGoodId!: number;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  priority?: number;
+}
+
+export class BatchCreateGoodDto {
+  @ApiProperty({ type: [BatchCreateItemDto] })
+  @IsArray()
+  @ArrayMinSize(1)
+  @ValidateNested({ each: true })
+  @Type(() => BatchCreateItemDto)
+  items!: BatchCreateItemDto[];
+
+  @ApiProperty()
+  @IsInt()
+  @Min(1)
+  countryId!: number;
+
+  @ApiProperty()
+  @IsInt()
+  @Min(1)
+  categoryId!: number;
+
+  @ApiProperty({ required: false, nullable: true })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  tagId?: number;
+
+  @ApiProperty({ required: false, nullable: true })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  positionId?: number;
+
+  @ApiProperty({ required: false, default: 0 })
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  defaultPriority?: number;
+}
@@ -0,0 +1,30 @@
+import { ApiProperty } from '@nestjs/swagger';
+import {
+  ArrayMinSize,
+  IsArray,
+  IsInt,
+  Min,
+  ValidateNested,
+} from 'class-validator';
+import { Type } from 'class-transformer';
+
+export class PriorityItemDto {
+  @ApiProperty()
+  @IsInt()
+  @Min(1)
+  id!: number;
+
+  @ApiProperty()
+  @IsInt()
+  @Min(0)
+  priority!: number;
+}
+
+export class BatchPriorityDto {
+  @ApiProperty({ type: [PriorityItemDto] })
+  @IsArray()
+  @ArrayMinSize(1)
+  @ValidateNested({ each: true })
+  @Type(() => PriorityItemDto)
+  items!: PriorityItemDto[];
+}
@@ -0,0 +1,48 @@
+import { ApiProperty } from '@nestjs/swagger';
+import {
+  IsInt,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  Min,
+} from 'class-validator';
+
+export class CreateGoodDto {
+  @ApiProperty()
+  @IsString()
+  @IsNotEmpty()
+  goodName!: string;
+
+  @ApiProperty()
+  @IsInt()
+  @Min(1)
+  originGoodId!: number;
+
+  @ApiProperty()
+  @IsInt()
+  @Min(1)
+  countryId!: number;
+
+  @ApiProperty()
+  @IsInt()
+  @Min(1)
+  categoryId!: number;
+
+  @ApiProperty({ required: false, nullable: true })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  tagId?: number;
+
+  @ApiProperty({ required: false, nullable: true })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  positionId?: number;
+
+  @ApiProperty({ required: false, default: 0 })
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  goodPriority?: number;
+}
@@ -0,0 +1,134 @@
+import { ApiProperty } from '@nestjs/swagger';
+import type { Good as PrismaGood } from '@prisma/client';
+
+export interface GoodRelations {
+  country?: { id: bigint; countryName: string; countryIcon: string | null } | null;
+  category?: { id: bigint; categoryName: string; categoryIcon: string | null } | null;
+  tag?: { id: bigint; tagName: string; tagColor: string | null } | null;
+  position?: { id: bigint; indexVal: number } | null;
+  originGood?: {
+    id: bigint;
+    sdsGoodId: string;
+    goodName: string | null;
+    goodImage: string | null;
+    goodPrice: unknown;
+  } | null;
+}
+
+export class GoodDto {
+  @ApiProperty()
+  id!: string;
+
+  @ApiProperty()
+  goodName!: string;
+
+  @ApiProperty()
+  goodPriority!: number;
+
+  @ApiProperty()
+  countryId!: string;
+
+  @ApiProperty()
+  categoryId!: string;
+
+  @ApiProperty({ nullable: true })
+  tagId!: string | null;
+
+  @ApiProperty({ nullable: true })
+  positionId!: string | null;
+
+  @ApiProperty()
+  originGoodId!: string;
+
+  @ApiProperty()
+  createdAt!: string;
+
+  @ApiProperty()
+  updatedAt!: string;
+
+  @ApiProperty({ required: false, nullable: true })
+  country?: { id: string; countryName: string; countryIcon: string | null } | null;
+
+  @ApiProperty({ required: false, nullable: true })
+  category?: { id: string; categoryName: string; categoryIcon: string | null } | null;
+
+  @ApiProperty({ required: false, nullable: true })
+  tag?: { id: string; tagName: string; tagColor: string | null } | null;
+
+  @ApiProperty({ required: false, nullable: true })
+  position?: { id: string; indexVal: number } | null;
+
+  @ApiProperty({ required: false, nullable: true })
+  originGood?: {
+    id: string;
+    sdsGoodId: string;
+    goodName: string | null;
+    goodImage: string | null;
+    goodPrice: string | null;
+  } | null;
+
+  static from(
+    good: PrismaGood,
+    rel: GoodRelations = {},
+  ): GoodDto {
+    return {
+      id: good.id.toString(),
+      goodName: good.goodName,
+      goodPriority: good.goodPriority,
+      countryId: good.countryId.toString(),
+      categoryId: good.categoryId.toString(),
+      tagId: good.tagId === null || good.tagId === undefined ? null : good.tagId.toString(),
+      positionId: good.positionId === null || good.positionId === undefined ? null : good.positionId.toString(),
+      originGoodId: good.originGoodId.toString(),
+      createdAt: good.createdAt.toISOString(),
+      updatedAt: good.updatedAt.toISOString(),
+      country: rel.country
+        ? {
+            id: rel.country.id.toString(),
+            countryName: rel.country.countryName,
+            countryIcon: rel.country.countryIcon,
+          }
+        : null,
+      category: rel.category
+        ? {
+            id: rel.category.id.toString(),
+            categoryName: rel.category.categoryName,
+            categoryIcon: rel.category.categoryIcon,
+          }
+        : null,
+      tag: rel.tag
+        ? {
+            id: rel.tag.id.toString(),
+            tagName: rel.tag.tagName,
+            tagColor: rel.tag.tagColor,
+          }
+        : null,
+      position: rel.position
+        ? {
+            id: rel.position.id.toString(),
+            indexVal: rel.position.indexVal,
+          }
+        : null,
+      originGood: rel.originGood
+        ? {
+            id: rel.originGood.id.toString(),
+            sdsGoodId: rel.originGood.sdsGoodId,
+            goodName: rel.originGood.goodName,
+            goodImage: rel.originGood.goodImage,
+            goodPrice:
+              rel.originGood.goodPrice === null ||
+              rel.originGood.goodPrice === undefined
+                ? null
+                : (rel.originGood.goodPrice as { toString(): string }).toString(),
+          }
+        : null,
+    };
+  }
+}
+
+export interface PaginatedGoods {
+  items: GoodDto[];
+  total: number;
+  page: number;
+  pageSize: number;
+}
@@ -0,0 +1,58 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { Type } from 'class-transformer';
+import {
+  IsInt,
+  IsOptional,
+  IsString,
+  Max,
+  Min,
+} from 'class-validator';
+
+export class QueryGoodDto {
+  @ApiProperty({ required: false, default: 1 })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  page: number = 1;
+
+  @ApiProperty({ required: false, default: 20 })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  @Max(200)
+  pageSize: number = 20;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  countryId?: number;
+
+  @ApiProperty({
+    required: false,
+    description: 'Includes all descendants of this category recursively',
+  })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  categoryId?: number;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  tagId?: number;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  positionId?: number;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsString()
+  keyword?: string;
+}
@@ -0,0 +1,50 @@
+import { ApiProperty } from '@nestjs/swagger';
+import {
+  IsInt,
+  IsOptional,
+  IsString,
+  Min,
+} from 'class-validator';
+
+export class UpdateGoodDto {
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsString()
+  goodName?: string;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  originGoodId?: number;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  countryId?: number;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  categoryId?: number;
+
+  @ApiProperty({ required: false, nullable: true })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  tagId?: number | null;
+
+  @ApiProperty({ required: false, nullable: true })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  positionId?: number | null;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  goodPriority?: number;
+}