Feat: 티켓 상품 목록 조회 API 구현 (#81)

[IISweetHeartII]

Summary

티켓 상품 목록 조회 API를 추가해 활성화된 티켓 상품 리스트를 조회할 수 있도록 구현했습니다.

Changes

• GET /ticket-products 엔드포인트 추가
• 티켓 상품 응답 DTO 신규 추가
• Service에서 엔티티-DTO 매핑 로직 보강
• Repository 목록 조회 메서드 개선 및 컨트롤러 응답 스펙 반영

Type of Change

해당하는 항목에 체크해주세요:

• Bug fix (기존 기능을 수정하는 변경)
• New feature (새로운 기능 추가)
• Breaking change (기존 기능에 영향을 주는 변경)
• Refactoring (기능 변경 없이 코드 개선)
• Documentation (문서 변경)
• Chore (빌드, 설정 등)

Target Environment

배포 대상 브랜치를 선택해주세요:

• Dev (dev)
• Prod (main)

Related Issues

관련 이슈를 연결해주세요:

• Closes [Feat] 이용권 상품 목록 조회 API 구현 #81

Testing

테스트 방법을 작성해주세요:

• Postman/Swagger로 API 호출 확인
• 단위 테스트 통과
• E2E 테스트 통과
• pnpm run lint 통과
• pnpm run build 통과
• pnpm exec jest --passWithNoTests 통과

Checklist

PR 생성 전 확인사항:

• 코드 컨벤션을 준수했습니다 (docs/development/CODE_STYLE.md)
• Git 컨벤션을 준수했습니다 (docs/development/GIT_CONVENTIONS.md)
• 네이밍 컨벤션을 준수했습니다 (docs/development/NAMING_CONVENTIONS.md)
• 로컬에서 빌드가 성공합니다 (pnpm run build)
• 로컬에서 린트가 통과합니다 (pnpm run lint)
• (API 변경 시) Swagger 문서가 업데이트되었습니다
• (필요 시) 테스트 코드를 작성했습니다

Screenshots (Optional)

N/A

Additional Notes

비활성 상품 제외 및 응답 포맷 일관성을 유지했습니다.

[gemini-code-assist]

Summary of Changes

Hello @IISweetHeartII, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

이 PR은 활성화된 티켓 상품 목록을 조회할 수 있는 새로운 API 엔드포인트를 도입합니다. 이를 통해 사용자들은 시스템에 등록된 이용권 상품들을 효율적으로 탐색하고, 할인율 정보와 함께 정렬된 형태로 받아볼 수 있게 됩니다. 백엔드 서비스는 DTO를 활용하여 응답 데이터의 일관성과 명확성을 보장하며, 레포지토리 계층의 개선을 통해 데이터 접근 로직을 최적화했습니다.

Highlights

• 티켓 상품 목록 조회 API 추가: 활성화된 티켓 상품 목록을 조회하는 GET /ticket-products 엔드포인트를 구현했습니다.
• 티켓 상품 응답 DTO 정의: 티켓 상품 정보를 클라이언트에 일관된 형식으로 제공하기 위한 TicketProductResDTO를 새로 추가했습니다.
• 서비스 계층 로직 개선: TicketProductService에 활성화된 상품을 조회하고 DTO로 변환하는 로직을 추가했습니다.
• 레포지토리 조회 기능 확장: TicketProductRepository에 isActive 상태와 displayOrder를 기준으로 상품을 조회하는 메서드를 추가했습니다.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog

• src/modules/ticket/application/dtos/ticket-product.dto.ts
  • TicketProductResDTO 클래스가 추가되었습니다.
  • 엔티티를 DTO로 변환하는 from 정적 메서드가 포함되었습니다.
  • 할인율을 계산하는 calculateDiscountRate 프라이빗 정적 메서드가 추가되었습니다.
• src/modules/ticket/application/services/ticket-product.service.ts
  • TicketProductResDTO를 임포트했습니다.
  • 활성화된 티켓 상품 목록을 조회하고 DTO로 매핑하는 findActiveProducts 메서드가 추가되었습니다.
• src/modules/ticket/infrastructure/repositories/ticket-product.repository.ts
  • 활성화된 티켓 상품을 displayOrder 기준으로 오름차순 정렬하여 조회하는 findActiveOrderByDisplayOrder 메서드가 추가되었습니다.
• src/modules/ticket/presentation/ticket.controller.ts
  • 컨트롤러 경로가 /tickets에서 /ticket-products로 변경되었습니다.
  • TicketService 의존성이 제거되었습니다.
  • GET /ticket-products 엔드포인트가 추가되어 활성화된 티켓 상품 목록을 반환합니다.
  • Swagger 문서화를 위한 @ApiOperation, @ApiCommonResponseArray, @Public 데코레이터가 적용되었습니다.

Activity

• 현재까지 이 PR에 대한 코멘트, 리뷰 또는 진행 상황 업데이트와 같은 활동은 없습니다.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

티켓 상품 목록 조회 API 구현에 대한 리뷰입니다. 전반적으로 기능 구현은 잘 되었으나, 코드의 명확성과 아키텍처 일관성을 높이기 위해 몇 가지 개선점을 제안합니다. DTO에서 비즈니스 로직 분리, 컨트롤러 네이밍 컨벤션 준수, 그리고 Swagger API 문서 보강에 대한 코멘트를 확인해주세요.