goodgo-platform/docs/audits/INQUIRIES_COMPLETE_FILE_INDEX.md

Inquiries Module - Chỉ Mục File Đầy Đủ

Tạo lúc: Ngày 11 tháng 4 năm 2026
Module: apps/api/src/modules/inquiries/
Tổng số file: 25

---

📋 DANH SÁCH FILE ĐẦY ĐỦ THEO ĐƯỜNG DẪN

1. TẦNG ỨNG DỤNG (APPLICATION LAYER)

Commands (4 files)

📄 apps/api/src/modules/inquiries/application/commands/create-inquiry/create-inquiry.command.ts
   Type: Command (CQRS)
   Purpose: Input DTO cho use case tạo yêu cầu tư vấn
   Exports: CreateInquiryCommand class
   Properties: userId, listingId, message, phone
   Lines: ~8

📄 apps/api/src/modules/inquiries/application/commands/create-inquiry/create-inquiry.handler.ts
   Type: Command Handler (CQRS)
   Purpose: Điều phối quá trình tạo yêu cầu tư vấn
   Implements: ICommandHandler<CreateInquiryCommand>
   Returns: CreateInquiryResult { id, listingId, createdAt }
   Key Logic:
     • Xác thực tin đăng tồn tại (Prisma.listing.findUnique)
     • Tạo InquiryEntity qua phương thức factory
     • Lưu vào repository
     • Phát sự kiện InquiryCreatedEvent qua EventBus
   Lines: ~60
   Dependencies: 
     • INQUIRY_REPOSITORY (injected)
     • EventBus (injected)
     • PrismaService (injected)
     • LoggerService (injected)

📄 apps/api/src/modules/inquiries/application/commands/mark-inquiry-read/mark-inquiry-read.command.ts
   Type: Command (CQRS)
   Purpose: Input DTO để đánh dấu yêu cầu tư vấn đã đọc
   Exports: MarkInquiryReadCommand class
   Properties: inquiryId, agentUserId
   Lines: ~6

📄 apps/api/src/modules/inquiries/application/commands/mark-inquiry-read/mark-inquiry-read.handler.ts
   Type: Command Handler (CQRS)
   Purpose: Điều phối thao tác đánh dấu đã đọc
   Implements: ICommandHandler<MarkInquiryReadCommand>
   Returns: void (không có giá trị trả về)
   Key Logic:
     • Tải entity yêu cầu tư vấn từ repository
     • Tải tin đăng và xác minh quyền sở hữu của môi giới
     • Gọi inquiry.markAsRead() để cập nhật trạng thái
     • Lưu qua repository.markAsRead()
     • Phát sự kiện InquiryReadEvent qua EventBus
   Authorization Checks:
     • Yêu cầu tư vấn tồn tại
     • Tin đăng tồn tại
     • Người dùng đã đăng ký làm môi giới
     • ID môi giới khớp với listing.agentId
   Lines: ~50
   Dependencies:
     • INQUIRY_REPOSITORY (injected)
     • EventBus (injected)
     • PrismaService (injected)
     • LoggerService (injected)

Queries (4 files)

📄 apps/api/src/modules/inquiries/application/queries/get-inquiries-by-agent/get-inquiries-by-agent.query.ts
   Type: Query (CQRS)
   Purpose: Input DTO để lấy danh sách yêu cầu tư vấn của môi giới
   Exports: GetInquiriesByAgentQuery class
   Properties: agentUserId, page, limit
   Lines: ~6

📄 apps/api/src/modules/inquiries/application/queries/get-inquiries-by-agent/get-inquiries-by-agent.handler.ts
   Type: Query Handler (CQRS)
   Purpose: Phân giải danh sách yêu cầu tư vấn phân trang cho một môi giới
   Implements: IQueryHandler<GetInquiriesByAgentQuery>
   Returns: PaginatedResult<InquiryReadDto>
   Key Logic:
     • Phân giải ID môi giới từ userId qua Prisma
     • Ném NotFoundException nếu người dùng không phải môi giới
     • Ủy quyền cho repository.findByAgent()
   Lines: ~30
   Dependencies:
     • INQUIRY_REPOSITORY (injected)
     • PrismaService (injected)

📄 apps/api/src/modules/inquiries/application/queries/get-inquiries-by-listing/get-inquiries-by-listing.query.ts
   Type: Query (CQRS)
   Purpose: Input DTO để lấy danh sách yêu cầu tư vấn của tin đăng
   Exports: GetInquiriesByListingQuery class
   Properties: listingId, page, limit
   Lines: ~6

📄 apps/api/src/modules/inquiries/application/queries/get-inquiries-by-listing/get-inquiries-by-listing.handler.ts
   Type: Query Handler (CQRS)
   Purpose: Phân giải danh sách yêu cầu tư vấn phân trang cho một tin đăng
   Implements: IQueryHandler<GetInquiriesByListingQuery>
   Returns: PaginatedResult<InquiryReadDto>
   Key Logic:
     • Ủy quyền trực tiếp cho repository.findByListing()
   Lines: ~20
   Dependencies:
     • INQUIRY_REPOSITORY (injected)

Application Tests (4 files)

📄 apps/api/src/modules/inquiries/application/__tests__/create-inquiry.handler.spec.ts
   Type: Unit Tests (Jest/Vitest)
   Test Framework: Vitest với hàm Mock (vi.fn)
   Test Count: 4
   Tests:
     ✓ tạo yêu cầu tư vấn thành công
     ✓ ném NotFoundException khi không tìm thấy tin đăng
     ✓ phát sự kiện domain sau khi lưu
   Mocks:
     • mockInquiryRepo (IInquiryRepository implementation)
     • mockEventBus
     • mockPrisma.listing.findUnique
   Lines: ~98

📄 apps/api/src/modules/inquiries/application/__tests__/mark-inquiry-read.handler.spec.ts
   Type: Unit Tests (Jest/Vitest)
   Test Count: 5
   Tests:
     ✓ đánh dấu yêu cầu tư vấn là đã đọc thành công
     ✓ ném NotFoundException khi không tìm thấy yêu cầu tư vấn
     ✓ ném NotFoundException khi không tìm thấy tin đăng
     ✓ ném ForbiddenException khi người dùng không phải môi giới của tin đăng
     ✓ ném ForbiddenException khi không tìm thấy môi giới cho người dùng
   Mocks:
     • mockInquiryRepo
     • mockEventBus
     • mockPrisma.listing.findUnique
     • mockPrisma.agent.findUnique
   Lines: ~130

📄 apps/api/src/modules/inquiries/application/__tests__/get-inquiries-by-listing.handler.spec.ts
   Type: Unit Tests (Jest/Vitest)
   Test Count: 2
   Tests:
     ✓ trả về kết quả phân trang
     ✓ trả về dữ liệu rỗng khi không tìm thấy yêu cầu tư vấn nào
   Mocks:
     • mockInquiryRepo.findByListing
   Lines: ~69

📄 apps/api/src/modules/inquiries/application/__tests__/get-inquiries-by-agent.handler.spec.ts
   Type: Unit Tests (Jest/Vitest)
   Test Count: 2
   Tests:
     ✓ trả về kết quả phân trang
     ✓ ném NotFoundException khi không tìm thấy môi giới cho người dùng
   Mocks:
     • mockInquiryRepo.findByAgent
     • mockPrisma.agent.findUnique
   Lines: ~77

---

2. TẦNG DOMAIN (DOMAIN LAYER)

Entities (1 file)

📄 apps/api/src/modules/inquiries/domain/entities/inquiry.entity.ts
   Type: Aggregate Root (DDD)
   Extends: AggregateRoot<string>
   Purpose: Logic nghiệp vụ cốt lõi cho yêu cầu tư vấn
   
   Properties (Private):
     • _listingId: string
     • _userId: string
     • _message: string
     • _phone: string | null
     • _isRead: boolean
   
   Getters (Read-only):
     • listingId: string
     • userId: string
     • message: string
     • phone: string | null
     • isRead: boolean
   
   Factory Method:
     • static createNew(id, listingId, userId, message, phone): InquiryEntity
       - Tạo yêu cầu tư vấn mới với isRead=false
       - Phát InquiryCreatedEvent
       - Trả về instance của entity
   
   Domain Methods:
     • markAsRead(): void
       - Đặt _isRead thành true
       - Phát InquiryReadEvent
   
   Lines: ~63
   Dependencies:
     • AggregateRoot from @modules/shared
     • InquiryCreatedEvent
     • InquiryReadEvent

Events (2 files)

📄 apps/api/src/modules/inquiries/domain/events/inquiry-created.event.ts
   Type: Domain Event (DDD)
   Implements: DomainEvent interface
   Purpose: Báo hiệu rằng một yêu cầu tư vấn đã được tạo
   
   Properties:
     • eventName: string = 'inquiry.created'
     • occurredAt: Date = new Date()
     • aggregateId: string
     • listingId: string
     • userId: string
   
   Lines: ~13

📄 apps/api/src/modules/inquiries/domain/events/inquiry-read.event.ts
   Type: Domain Event (DDD)
   Implements: DomainEvent interface
   Purpose: Báo hiệu rằng một yêu cầu tư vấn đã được đánh dấu là đã đọc
   
   Properties:
     • eventName: string = 'inquiry.read'
     • occurredAt: Date = new Date()
     • aggregateId: string
     • listingId: string
     • userId: string
   
   Lines: ~13

Repositories (2 files)

📄 apps/api/src/modules/inquiries/domain/repositories/inquiry.repository.ts
   Type: Repository Interface + Symbol (DDD)
   Purpose: Định nghĩa hợp đồng persistence
   
   Exports:
     • INQUIRY_REPOSITORY: Symbol (DI token)
     • IInquiryRepository: Interface
     • PaginatedResult<T>: Interface
   
   IInquiryRepository Methods:
     • findById(id: string): Promise<InquiryEntity | null>
     • save(inquiry: InquiryEntity): Promise<void>
     • markAsRead(id: string): Promise<void>
     • findByListing(listingId, page, limit): Promise<PaginatedResult<InquiryReadDto>>
     • findByAgent(agentId, page, limit): Promise<PaginatedResult<InquiryReadDto>>
     • countUnreadByAgent(agentId): Promise<number>
   
   PaginatedResult<T> Interface:
     • data: T[]
     • total: number
     • page: number
     • limit: number
     • totalPages: number
   
   Lines: ~22

📄 apps/api/src/modules/inquiries/domain/repositories/inquiry-read.dto.ts
   Type: Data Transfer Object (Read Model)
   Purpose: DTO cho kết quả truy vấn
   Exports: InquiryReadDto interface
   
   InquiryReadDto Properties:
     • id: string
     • listingId: string
     • listingTitle: string
     • userId: string
     • userName: string
     • userPhone: string
     • message: string
     • phone: string | null
     • isRead: boolean
     • createdAt: string
   
   Lines: ~13

Domain Tests (1 file)

📄 apps/api/src/modules/inquiries/domain/__tests__/inquiry-domain.spec.ts
   Type: Unit Tests (Jest/Vitest)
   Test Count: 5
   Tests:
     ✓ createNew() tạo yêu cầu tư vấn với các thuộc tính đúng
     ✓ createNew() tạo yêu cầu tư vấn với phone là null
     ✓ createNew() phát InquiryCreatedEvent
     ✓ markAsRead() đặt isRead thành true
     ✓ markAsRead() phát InquiryReadEvent
   Focus: Hành vi entity và việc phát sự kiện domain
   Lines: ~96

---

3. TẦNG HẠ TẦNG (INFRASTRUCTURE LAYER)

Repository Implementation (1 file)

📄 apps/api/src/modules/inquiries/infrastructure/repositories/prisma-inquiry.repository.ts
   Type: Repository Implementation (Service)
   Implements: IInquiryRepository
   Decorator: @Injectable()
   Purpose: Persistence dựa trên Prisma
   
   Methods:
     1. findById(id: string): Promise<InquiryEntity | null>
        - Query: prisma.inquiry.findUnique({ where: { id } })
        - Returns: InquiryEntity | null
     
     2. save(entity: InquiryEntity): Promise<void>
        - Query: prisma.inquiry.create({ data: {...} })
        - Ánh xạ thuộc tính entity sang Prisma model
     
     3. markAsRead(id: string): Promise<void>
        - Query: prisma.inquiry.update({ where: { id }, data: { isRead: true } })
     
     4. findByListing(listingId, page, limit): Promise<PaginatedResult<InquiryReadDto>>
        - Query: prisma.inquiry.findMany() với joins
        - Includes: listing.property.title, user.fullName, user.phone
        - Pagination: mô hình skip/take
        - Sorting: orderBy: { createdAt: 'desc' }
        - Returns: Mảng InquiryReadDto đã ánh xạ kèm thông tin phân trang
     
     5. findByAgent(agentId, page, limit): Promise<PaginatedResult<InquiryReadDto>>
        - Query: prisma.inquiry.findMany() lọc theo listing.agentId
        - Cùng includes và phân trang như findByListing
        - Filter: { listing: { agentId } }
     
     6. countUnreadByAgent(agentId): Promise<number>
        - Query: prisma.inquiry.count()
        - Filter: { isRead: false, listing: { agentId } }
     
     Helper Method:
     • toDomain(raw: PrismaInquiry): InquiryEntity
       - Ánh xạ bản ghi cơ sở dữ liệu sang domain entity
   
   Lines: ~146
   Dependencies:
     • PrismaService (injected)
     • InquiryEntity
     • IInquiryRepository (implements)

---

4. TẦNG TRÌNH BÀY (PRESENTATION LAYER)

Controller (1 file)

📄 apps/api/src/modules/inquiries/presentation/controllers/inquiries.controller.ts
   Type: NestJS Controller
   Decorator: @Controller('inquiries')
   Decorator: @ApiTags('inquiries')
   Purpose: Các endpoint HTTP API
   
   Endpoints:
   
   1. POST /inquiries
      Decorator: @Post()
      Auth: @UseGuards(JwtAuthGuard)
      Method: createInquiry(dto: CreateInquiryDto, user: JwtPayload)
      Body: CreateInquiryDto { listingId, message, phone? }
      Returns: CreateInquiryResult { id, listingId, createdAt }
      Status Codes: 201 Created, 400 Bad Request, 401 Unauthorized, 404 Not Found
      Logic: 
        • Điều phối CreateInquiryCommand qua CommandBus
        • Truyền user.sub làm userId
   
   2. GET /inquiries/listing/:listingId
      Decorator: @Get('listing/:listingId')
      Auth: @UseGuards(JwtAuthGuard)
      Method: getByListing(listingId: string, dto: ListInquiriesDto)
      Query: page?, limit?
      Returns: PaginatedResult<InquiryReadDto>
      Status Codes: 200 OK, 401 Unauthorized
      Logic:
        • Điều phối GetInquiriesByListingQuery qua QueryBus
        • Mặc định page=1, limit=20
   
   3. GET /inquiries/agent/me
      Decorator: @Get('agent/me')
      Auth: @UseGuards(JwtAuthGuard, RolesGuard)
      Decorator: @Roles('AGENT')
      Method: getMyInquiries(user: JwtPayload, dto: ListInquiriesDto)
      Query: page?, limit?
      Returns: PaginatedResult<InquiryReadDto>
      Status Codes: 200 OK, 401 Unauthorized, 403 Forbidden
      Logic:
        • Điều phối GetInquiriesByAgentQuery qua QueryBus
        • Truyền user.sub làm agentUserId
        • Mặc định page=1, limit=20
   
   4. PATCH /inquiries/:id/read
      Decorator: @Patch(':id/read')
      Auth: @UseGuards(JwtAuthGuard, RolesGuard)
      Decorator: @Roles('AGENT')
      Method: markAsRead(id: string, user: JwtPayload)
      Returns: { success: boolean }
      Status Codes: 200 OK, 401 Unauthorized, 403 Forbidden, 404 Not Found
      Logic:
        • Điều phối MarkInquiryReadCommand qua CommandBus
        • Truyền user.sub làm agentUserId
        • Trả về { success: true }
   
   Lines: ~121
   Dependencies:
     • CommandBus (injected)
     • QueryBus (injected)
     • @nestjs/swagger decorators
     • @modules/auth guards and decorators

DTOs (2 files)

📄 apps/api/src/modules/inquiries/presentation/dto/create-inquiry.dto.ts
   Type: Data Transfer Object (Validation)
   Purpose: Xác thực body của request POST /inquiries
   Decorators: @ApiProperty, @ApiPropertyOptional
   
   Properties:
     • listingId: string (required)
       Validators: @IsString(), @IsNotEmpty()
       API Doc: "ID of the listing"
     
     • message: string (required)
       Validators: @IsString(), @IsNotEmpty(), @MaxLength(2000)
       API Doc: "Tin nhắn yêu cầu tư vấn" (Consultation request message)
       Max: 2000 ký tự
     
     • phone?: string (optional)
       Validators: @IsOptional(), @IsString()
       API Doc: "Số điện thoại liên hệ" (Contact phone number)
   
   Lines: ~21
   Dependencies: class-validator, @nestjs/swagger

📄 apps/api/src/modules/inquiries/presentation/dto/list-inquiries.dto.ts
   Type: Data Transfer Object (Validation)
   Purpose: Xác thực query parameter cho các endpoint danh sách
   Decorators: @ApiPropertyOptional, @Type
   
   Properties:
     • page?: number (optional)
       Validators: @IsOptional(), @IsInt(), @Min(1), @Type(() => Number)
       API Doc: "Số trang", mặc định: 1
       Example: 1
     
     • limit?: number (optional)
       Validators: @IsOptional(), @IsInt(), @Min(1), @Max(100), @Type(() => Number)
       API Doc: "Số mục mỗi trang", mặc định: 20
       Example: 20
       Max: 100
   
   Lines: ~21
   Dependencies: class-validator, @nestjs/swagger, class-transformer

Presentation Tests (1 file)

📄 apps/api/src/modules/inquiries/presentation/__tests__/inquiries.controller.spec.ts
   Type: Unit Tests (Jest/Vitest)
   Test Count: 6
   
   Tests:
     ✓ POST /inquiries điều phối CreateInquiryCommand với tham số đúng
     ✓ POST /inquiries truyền phone là null khi không được cung cấp
     ✓ GET /listing/:id điều phối GetInquiriesByListingQuery với giá trị mặc định
     ✓ GET /listing/:id truyền phân trang tùy chỉnh
     ✓ GET /agent/me điều phối GetInquiriesByAgentQuery với người dùng hiện tại
     ✓ PATCH /:id/read điều phối MarkInquiryReadCommand và trả về thành công
   
   Mocks:
     • mockCommandBus với hàm mock execute()
     • mockQueryBus với hàm mock execute()
     • mockBuyer user object (sub='buyer-1', role='BUYER')
     • mockAgent user object (sub='agent-1', role='AGENT')
   
   Lines: ~105

---

5. TẦNG MODULE (MODULE LAYER)

📄 apps/api/src/modules/inquiries/inquiries.module.ts
   Type: NestJS Module
   Decorator: @Module()
   Purpose: Cấu hình module, khai báo phụ thuộc, xuất khẩu
   
   Imports: [CqrsModule]
   Controllers: [InquiriesController]
   
   Providers:
     • { provide: INQUIRY_REPOSITORY, useClass: PrismaInquiryRepository }
       - Ánh xạ token dependency injection
     • CommandHandlers array: [CreateInquiryHandler, MarkInquiryReadHandler]
     • QueryHandlers array: [GetInquiriesByListingHandler, GetInquiriesByAgentHandler]
   
   Exports: [INQUIRY_REPOSITORY]
     - Cung cấp repository cho các module khác
   
   Lines: ~29
   Dependencies:
     • @nestjs/common
     • @nestjs/cqrs
     • All handlers, repository, controller

📄 apps/api/src/modules/inquiries/index.ts
   Type: Barrel Export (Public API)
   Purpose: Định nghĩa giao diện công khai của module
   
   Exports:
     • InquiriesModule (default export for app imports)
     • INQUIRY_REPOSITORY (DI token)
     • IInquiryRepository (interface type)
     • InquiryEntity (for external access)
   
   Lines: ~4

---

📊 THỐNG KÊ FILE

Theo Tầng

Tầng	Files	Loại	Mục đích
Presentation	5	Controller + DTOs + Tests	Endpoint HTTP và xác thực đầu vào
Application	8	Commands/Queries + Handlers + Tests	Điều phối use case
Domain	6	Entities + Events + Repository Interface + Tests	Logic nghiệp vụ và hợp đồng
Infrastructure	1	Repository Implementation	Lưu trữ cơ sở dữ liệu
Module	2	Module + Exports	Cấu hình và API công khai
TỔNG	25	-	-

Theo Loại

Loại	Số lượng
File nguồn (.ts, không phải test)	19
File test (.spec.ts)	6
Tổng	25

Theo Mục Đích

Mục đích	Số lượng	Files
Controllers	1	inquiries.controller.ts
DTOs	2	create-inquiry.dto.ts, list-inquiries.dto.ts
Commands	2	create-inquiry.command.ts, mark-inquiry-read.command.ts
Queries	2	get-inquiries-by-*.query.ts (2 files)
Handlers	4	2 command handlers + 2 query handlers
Entities	1	inquiry.entity.ts
Events	2	inquiry-created.event.ts, inquiry-read.event.ts
Repositories	3	interface + 2 DTOs + 1 implementation
Tests	6	5 bộ test trải rộng các tầng
Module	2	inquiries.module.ts, index.ts

---

🔍 HƯỚNG DẪN TÌM KIẾM FILE

Tìm kiếm Logic Nghiệp Vụ?

→ domain/entities/inquiry.entity.ts - Quy tắc nghiệp vụ cốt lõi → domain/events/*.event.ts - Sự kiện nghiệp vụ

Tìm kiếm Use Case?

→ application/commands/*/ - Thao tác ghi → application/queries/*/ - Thao tác đọc → application/[type]/__tests__/ - Các test case

Tìm kiếm HTTP Endpoint?

→ presentation/controllers/inquiries.controller.ts - Toàn bộ 4 endpoint

Tìm kiếm Xác Thực Đầu Vào?

→ presentation/dto/ - Tất cả DTOs kèm validator

Tìm kiếm Logic Cơ Sở Dữ Liệu?

→ infrastructure/repositories/prisma-inquiry.repository.ts - Tất cả Prisma query

Tìm kiếm Tests?

→ domain/__tests__/ - Hành vi domain → application/__tests__/ - Test handler → presentation/__tests__/ - Test controller

---

🔗 ĐỒ THỊ PHỤ THUỘC (DEPENDENCY GRAPH)

presentation/controllers/inquiries.controller.ts
  ├── application/commands/create-inquiry/create-inquiry.handler.ts
  ├── application/commands/mark-inquiry-read/mark-inquiry-read.handler.ts
  ├── application/queries/get-inquiries-by-*/[name].handler.ts
  └── CommandBus/QueryBus (NestJS CQRS)

application/commands/*/[name].handler.ts
  ├── domain/entities/inquiry.entity.ts
  ├── domain/repositories/inquiry.repository.ts (interface)
  ├── domain/events/*.event.ts
  └── @modules/shared (AggregateRoot, exceptions)

application/queries/*/[name].handler.ts
  ├── domain/repositories/inquiry.repository.ts
  └── domain/repositories/inquiry-read.dto.ts

domain/entities/inquiry.entity.ts
  ├── @modules/shared (AggregateRoot)
  └── domain/events/*.event.ts

infrastructure/repositories/prisma-inquiry.repository.ts
  ├── domain/entities/inquiry.entity.ts
  ├── domain/repositories/inquiry.repository.ts (implements)
  ├── domain/repositories/inquiry-read.dto.ts
  └── @prisma/client (Prisma)

inquiries.module.ts
  ├── All handlers
  ├── All repositories
  ├── InquiriesController
  └── CqrsModule (NestJS)

---

📝 THAM CHIẾU CHÉO FILE

Các File Sử Dụng Symbol INQUIRY_REPOSITORY

• inquiries.module.ts - Cung cấp implementation
• application/commands/create-inquiry/create-inquiry.handler.ts - Injects
• application/commands/mark-inquiry-read/mark-inquiry-read.handler.ts - Injects
• application/queries/get-inquiries-by-agent/get-inquiries-by-agent.handler.ts - Injects
• application/queries/get-inquiries-by-listing/get-inquiries-by-listing.handler.ts - Injects

Các File Tạo/Chỉnh Sửa InquiryEntity

• domain/entities/inquiry.entity.ts - Định nghĩa
• application/commands/create-inquiry/create-inquiry.handler.ts - Tạo mới
• application/commands/mark-inquiry-read/mark-inquiry-read.handler.ts - Chỉnh sửa
• infrastructure/repositories/prisma-inquiry.repository.ts - Ánh xạ đến/từ

Các File Phát Sự Kiện

• domain/entities/inquiry.entity.ts - Phát ra (qua addDomainEvent)
• application/commands/create-inquiry/create-inquiry.handler.ts - Xuất bản
• application/commands/mark-inquiry-read/mark-inquiry-read.handler.ts - Xuất bản

Các File Có Tests

• domain/entities/inquiry.entity.ts → domain/__tests__/inquiry-domain.spec.ts
• application/commands/create-inquiry/create-inquiry.handler.ts → application/__tests__/create-inquiry.handler.spec.ts
• application/commands/mark-inquiry-read/mark-inquiry-read.handler.ts → application/__tests__/mark-inquiry-read.handler.spec.ts
• application/queries/get-inquiries-by-listing/ → application/__tests__/get-inquiries-by-listing.handler.spec.ts
• application/queries/get-inquiries-by-agent/ → application/__tests__/get-inquiries-by-agent.handler.spec.ts
• presentation/controllers/inquiries.controller.ts → presentation/__tests__/inquiries.controller.spec.ts

---

🎯 ĐIỂM VÀO CHO VIỆC CHỈNH SỬA

Thêm Endpoint Mới

1. Thêm phương thức vào presentation/controllers/inquiries.controller.ts
2. Tạo command/query trong application/[type]/[name]/
3. Tạo handler: [name].handler.ts
4. Thêm tests trong application/__tests__/
5. Tuỳ chọn: Cập nhật domain nếu cần logic nghiệp vụ mới

Thêm Command Mới

1. Tạo application/commands/[name]/[name].command.ts (DTO)
2. Tạo application/commands/[name]/[name].handler.ts (@CommandHandler)
3. Đăng ký trong mảng CommandHandlers của inquiries.module.ts
4. Thêm tests trong application/__tests__/[name].handler.spec.ts
5. Tuỳ chọn: Định nghĩa sự kiện domain mới trong domain/events/

Thêm Logic Domain

1. Chỉnh sửa domain/entities/inquiry.entity.ts
2. Thêm phương thức hoặc thuộc tính công khai mới
3. Phát sự kiện mới nếu cần: domain/events/[name].event.ts
4. Cập nhật tests trong domain/__tests__/inquiry-domain.spec.ts
5. Cập nhật các handler sử dụng entity

Thêm Thao Tác Cơ Sở Dữ Liệu

1. Thêm phương thức vào infrastructure/repositories/prisma-inquiry.repository.ts
2. Cập nhật interface trong domain/repositories/inquiry.repository.ts
3. Gọi từ các handler liên quan

---

Tổng số dòng code: 1.212
Cập nhật lần cuối: Ngày 11 tháng 4 năm 2026