Implement reviews module

apps/backend/prisma/migrations/20250430120040_add_reviews/migration.sql

@@ -0,0 +1,22 @@
+-- CreateTable
+CREATE TABLE "reviews" (
+    "id" TEXT NOT NULL,
+    "seller_address" TEXT NOT NULL,
+    "reviewer_address" TEXT NOT NULL,
+    "order_id" TEXT NOT NULL,
+    "rating" INTEGER NOT NULL,
+    "comment" TEXT,
+    "created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updated_at" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "reviews_pkey" PRIMARY KEY ("id")
+);
+
+-- AddForeignKey
+ALTER TABLE "reviews" ADD CONSTRAINT "reviews_seller_address_fkey" FOREIGN KEY ("seller_address") REFERENCES "users"("wallet_address") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "reviews" ADD CONSTRAINT "reviews_reviewer_address_fkey" FOREIGN KEY ("reviewer_address") REFERENCES "users"("wallet_address") ON DELETE RESTRICT ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "reviews" ADD CONSTRAINT "reviews_order_id_fkey" FOREIGN KEY ("order_id") REFERENCES "orders"("id") ON DELETE RESTRICT ON UPDATE CASCADE;

apps/backend/prisma/schema.prisma

@@ -66,6 +66,8 @@ model User {
   createdAt        DateTime  @default(now()) @map("created_at")
   updatedAt        DateTime  @updatedAt @map("updated_at")
   Product          Product[]
+  receivedReviews Review[] @relation("SellerReviews")
+  givenReviews    Review[] @relation("ReviewerReviews")
 
   @@map("users")
 }
@@ -101,8 +103,28 @@ model Order {
   createdAt     DateTime    @default(now()) @map("created_at")
   updatedAt     DateTime    @updatedAt @map("updated_at")
   messages      Message[]
+  reviews       Review[]
 
   product        Product     @relation(fields: [productId], references: [id])
 
   @@map("orders")
+}
+
+// Updated Review model in schema.prisma
+
+model Review {
+  id              String   @id @default(uuid())
+  sellerAddress   String   @map("seller_address")
+  reviewerAddress String   @map("reviewer_address")
+  orderId         String   @map("order_id")
+  rating          Int
+  comment         String?
+  createdAt       DateTime @default(now()) @map("created_at")
+  updatedAt       DateTime @updatedAt @map("updated_at")
+
+  seller          User     @relation("SellerReviews", fields: [sellerAddress], references: [walletAddress])
+  reviewer        User     @relation("ReviewerReviews", fields: [reviewerAddress], references: [walletAddress])
+  order           Order    @relation(fields: [orderId], references: [id])
+
+  @@map("reviews")
 }

apps/backend/src/core/core.module.ts

@@ -7,6 +7,7 @@ import { AuthModule } from "src/auth/auth.module";
 import { CategoryModule } from "src/modules/categories/category.module";
 import { ProductImageModule } from "src/modules/product-image/product-image.module";
 import { ProductModule } from "src/modules/product/product.module";
+import { ReviewModule } from "src/modules/review/review.module";
 import { UsersModule } from "src/modules/users/users.module";
 import { IS_DEV_ENV } from "src/shared/utils/is-dev.util";
 import { MessageModule } from "../modules/message/message.module";
@@ -34,6 +35,7 @@ import { OrderModule } from "src/modules/order/order.module";
 		UsersModule,
 		OrderModule,
 		MessageModule,
+		ReviewModule,
 	],
 	controllers: [],
 	providers: [],

apps/backend/src/core/graphql/schema.gql

@@ -3,21 +3,21 @@
 # ------------------------------------------------------
 
 type Category {
-	createdAt: DateTime!
-	id: ID!
-	imageUrl: String
-	name: String!
-	updatedAt: DateTime!
+  createdAt: DateTime!
+  id: ID!
+  imageUrl: String
+  name: String!
+  updatedAt: DateTime!
 }
 
 input CreateCategoryInput {
-	name: String!
+  name: String!
 }
 
 input CreateMessageInput {
-	content: String!
-	orderId: String!
-	senderAddress: String!
+  content: String!
+  orderId: String!
+  senderAddress: String!
 }
 
 input CreateOrderInput {
@@ -38,14 +38,22 @@ input CreateProductInput {
   slug: String!
 }
 
+input CreateReviewInput {
+  comment: String
+  orderId: String!
+  rating: Int!
+  reviewerAddress: String!
+  sellerAddress: String!
+}
+
 input CreateUserInput {
-	country: String!
-	email: String!
-	isSeller: Boolean! = false
-	name: String!
-	surname: String!
-	telegramUsername: String
-	walletAddress: String!
+  country: String!
+  email: String!
+  isSeller: Boolean! = false
+  name: String!
+  surname: String!
+  telegramUsername: String
+  walletAddress: String!
 }
 
 """
@@ -54,23 +62,24 @@ A date-time string at UTC, such as 2019-12-03T09:54:33Z, compliant with the date
 scalar DateTime
 
 type Message {
-	content: String!
-	createdAt: DateTime!
-	id: ID!
-	orderId: String!
-	senderAddress: String!
-	updatedAt: DateTime!
+  content: String!
+  createdAt: DateTime!
+  id: ID!
+  orderId: String!
+  senderAddress: String!
+  updatedAt: DateTime!
 }
 
 type Mutation {
-	createCategory(data: CreateCategoryInput!): Category!
+  createCategory(data: CreateCategoryInput!): Category!
   createOrder(data: CreateOrderInput!): Order!
-	createProduct(data: CreateProductInput!): ProductDTO!
-	createProductImage(createProductImage: ProductImageDTO!): ProductImage!
-	createUser(data: CreateUserInput!): User!
-	sendMessage(data: CreateMessageInput!): Message!
+  createProduct(data: CreateProductInput!): ProductDTO!
+  createProductImage(createProductImage: ProductImageDTO!): ProductImage!
+  createReview(data: CreateReviewInput!): Review!
+  createUser(data: CreateUserInput!): User!
+  sendMessage(data: CreateMessageInput!): Message!
   updateOrderStatus(data: UpdateOrderStatusInput!): Order!
-	updateUser(data: UpdateUserInput!, walletAddress: String!): User!
+  updateUser(data: UpdateUserInput!, walletAddress: String!): User!
 }
 
 type Order {
@@ -92,7 +101,6 @@ enum OrderStatus {
 }
 
 type ProductDTO {
-
   categoryId: String!
   condition: String!
   createdAt: DateTime!
@@ -106,31 +114,50 @@ type ProductDTO {
 }
 
 type ProductImage {
-	createdAt: DateTime!
-	id: ID!
-	imageUrl: String!
-	productId: String!
-	updatedAt: DateTime!
+  createdAt: DateTime!
+  id: ID!
+  imageUrl: String!
+  productId: String!
+  updatedAt: DateTime!
 }
 
 input ProductImageDTO {
-	imageUrl: String!
-	productId: String!
+  imageUrl: String!
+  productId: String!
 }
 
 type Query {
-	categories: [Category!]!
-	category(id: String!): Category
+  categories: [Category!]!
+  category(id: String!): Category
+  getAverageRatingBySeller(sellerAddress: String!): RatingDTO!
+  getMessagesByOrder(orderId: String!): [Message!]!
   getOrder(orderId: String!): Order!
   getOrdersByBuyer(buyerAddress: String!): [Order!]!
   getOrdersBySeller(sellerAddress: String!): [Order!]!
-	getMessagesByOrder(orderId: String!): [Message!]!
-	product(id: String!): ProductDTO
-	productImage(id: String!): ProductImage
-	productImages: [ProductImage!]!
-	products: [ProductDTO!]!
-	user(walletAddress: String!): User
-	users: [User!]!
+  getReviewsBySeller(sellerAddress: String!): [Review!]!
+  product(id: String!): ProductDTO
+  productImage(id: String!): ProductImage
+  productImages: [ProductImage!]!
+  products: [ProductDTO!]!
+  user(walletAddress: String!): User
+  users: [User!]!
+}
+
+type RatingDTO {
+  averageRating: Float!
+  sellerAddress: String!
+  totalReviews: Int!
+}
+
+type Review {
+  comment: String
+  createdAt: DateTime!
+  id: ID!
+  orderId: String!
+  rating: Int!
+  reviewerAddress: String!
+  sellerAddress: String!
+  updatedAt: DateTime!
 }
 
 input UpdateOrderStatusInput {
@@ -139,23 +166,23 @@ input UpdateOrderStatusInput {
 }
 
 input UpdateUserInput {
-	country: String
-	email: String
-	isSeller: Boolean = false
-	name: String
-	surname: String
-	telegramUsername: String
-	walletAddress: String
+  country: String
+  email: String
+  isSeller: Boolean = false
+  name: String
+  surname: String
+  telegramUsername: String
+  walletAddress: String
 }
 
 type User {
-	country: String!
-	createdAt: DateTime!
-	email: String!
-	isSeller: Boolean!
-	name: String!
-	surname: String!
-	telegramUsername: String
-	updatedAt: DateTime!
-	walletAddress: String!
-}
+  country: String!
+  createdAt: DateTime!
+  email: String!
+  isSeller: Boolean!
+  name: String!
+  surname: String!
+  telegramUsername: String
+  updatedAt: DateTime!
+  walletAddress: String!
+}

apps/backend/src/modules/review/dto/create-review.input.ts

@@ -0,0 +1,38 @@
+import { Field, InputType, Int } from "@nestjs/graphql";
+import {
+	IsInt,
+	IsNotEmpty,
+	IsOptional,
+	IsString,
+	Max,
+	Min,
+} from "class-validator";
+
+@InputType()
+export class CreateReviewInput {
+	@Field()
+	@IsString()
+	@IsNotEmpty()
+	sellerAddress: string;
+
+	@Field()
+	@IsString()
+	@IsNotEmpty()
+	reviewerAddress: string;
+
+	@Field()
+	@IsString()
+	@IsNotEmpty()
+	orderId: string;
+
+	@Field(() => Int)
+	@IsInt()
+	@Min(1)
+	@Max(5)
+	rating: number;
+
+	@Field({ nullable: true })
+	@IsString()
+	@IsOptional()
+	comment?: string;
+}

apps/backend/src/modules/review/dto/rating.dto.ts

@@ -0,0 +1,13 @@
+import { Field, Float, Int, ObjectType } from "@nestjs/graphql";
+
+@ObjectType()
+export class RatingDTO {
+	@Field()
+	sellerAddress: string;
+
+	@Field(() => Float)
+	averageRating: number;
+
+	@Field(() => Int)
+	totalReviews: number;
+}

apps/backend/src/modules/review/entities/review.entity.ts

@@ -0,0 +1,28 @@
+import { Field, ID, Int, ObjectType } from "@nestjs/graphql";
+
+@ObjectType()
+export class Review {
+	@Field(() => ID)
+	id: string;
+
+	@Field()
+	sellerAddress: string;
+
+	@Field()
+	reviewerAddress: string;
+
+	@Field()
+	orderId: string;
+
+	@Field(() => Int)
+	rating: number;
+
+	@Field({ nullable: true })
+	comment?: string;
+
+	@Field(() => Date)
+	createdAt: Date;
+
+	@Field(() => Date)
+	updatedAt: Date;
+}

apps/backend/src/modules/review/review.module.ts

@@ -0,0 +1,9 @@
+import { Module } from "@nestjs/common";
+import { PrismaService } from "src/core/prisma/prisma.service";
+import { ReviewResolver } from "./review.resolver";
+import { ReviewService } from "./review.service";
+
+@Module({
+	providers: [ReviewResolver, ReviewService, PrismaService],
+})
+export class ReviewModule {}