Merge pull request #124 from DevKor-github/feature/club-detail

feat:: 동아리 상세 정보 조회 api 추가

Author: JeongYeonSeung

src/decorators/docs/club.decorator.ts

@@ -19,6 +19,7 @@ import { GetRecommendClubResponseDto } from 'src/home/club/dto/get-recommend-clu
 import { UpdateClubRequestDto } from 'src/home/club/dto/update-club-request-dto';
 import { UpdateClubResponseDto } from 'src/home/club/dto/update-club-response-dto';
 import { ApiKukeyExceptionResponse } from '../api-kukey-exception-response';
+import { GetClubDetailResponseDto } from 'src/home/club/dto/get-club-detail-response.dto';
 
 type ClubEndPoints = MethodNames<ClubController>;
 
@@ -61,6 +62,27 @@ const ClubDocsMap: Record<ClubEndPoints, MethodDecorator[]> = {
     }),
     ApiKukeyExceptionResponse(['LOGIN_REQUIRED']),
   ],
+  getClubDetail: [
+    ApiOperation({
+      summary: '동아리 상세 조회',
+      description: '동아리 상세 정보를 조회합니다.',
+    }),
+    ApiQuery({
+      name: 'clubId',
+      description: 'club id',
+      required: true,
+    }),
+    ApiQuery({
+      name: 'isLogin',
+      description: '로그인 여부',
+      required: true,
+    }),
+    ApiOkResponse({
+      description: '동아리 상세 정보 반환',
+      type: GetClubDetailResponseDto,
+    }),
+    ApiKukeyExceptionResponse(['LOGIN_REQUIRED', 'CLUB_NOT_FOUND']),
+  ],
   toggleLikeClub: [
     ApiOperation({
       summary: '동아리 좋아요 등록/해제',

src/home/club/club.controller.ts

@@ -34,6 +34,8 @@ import { CreateClubResponseDto } from './dto/create-club-response-dto';
 import { UpdateClubRequestDto } from './dto/update-club-request-dto';
 import { DeleteClubResponseDto } from './dto/delete-club-response-dto';
 import { ClubDocs } from 'src/decorators/docs/club.decorator';
+import { GetClubDetailResponseDto } from './dto/get-club-detail-response.dto';
+import { GetClubDetailRequestDto } from './dto/get-club-detail-request.dto';
 
 @Controller('club')
 @ApiTags('club')
@@ -51,6 +53,15 @@ export class ClubController {
     return await this.clubService.getClubList(user, getClubRequestDto);
   }
 
+  @UseGuards(OptionalJwtAuthGuard)
+  @Get('/:clubId')
+  async getClubDetail(
+    @User() user: AuthorizedUserDto | null,
+    @Query() getClubDetailRequestDto: GetClubDetailRequestDto,
+  ): Promise<GetClubDetailResponseDto> {
+    return await this.clubService.getClubDetail(user, getClubDetailRequestDto);
+  }
+
   @UseGuards(JwtAuthGuard)
   @UseInterceptors(TransactionInterceptor)
   @Post('/like/:clubId')

src/home/club/club.service.ts

@@ -17,6 +17,8 @@ import { UpdateClubRequestDto } from './dto/update-club-request-dto';
 import { UpdateClubResponseDto } from './dto/update-club-response-dto';
 import { DeleteClubResponseDto } from './dto/delete-club-response-dto';
 import { throwKukeyException } from 'src/utils/exception.util';
+import { GetClubDetailResponseDto } from './dto/get-club-detail-response.dto';
+import { GetClubDetailRequestDto } from './dto/get-club-detail-request.dto';
 
 @Injectable()
 export class ClubService {
@@ -64,6 +66,35 @@ export class ClubService {
     return clubList;
   }
 
+  async getClubDetail(
+    user: AuthorizedUserDto | null,
+    requetDto: GetClubDetailRequestDto,
+  ): Promise<GetClubDetailResponseDto> {
+    const { clubId, isLogin } = requetDto;
+
+    // isLogin이 true이나 user가 없을 경우 refresh를 위해 401 던짐
+    if (!user && isLogin) {
+      throwKukeyException('LOGIN_REQUIRED');
+    }
+
+    const club = await this.clubRepository.findOne({
+      where: { id: clubId },
+      relations: ['clubLikes', 'clubLikes.user'],
+    });
+
+    if (!club) {
+      throwKukeyException('CLUB_NOT_FOUND');
+    }
+
+    const isLiked = club.clubLikes.some((clubLike) =>
+      user && isLogin && clubLike.user ? clubLike.user.id === user.id : false,
+    );
+
+    const linkCount = (club.instagramLink ? 1 : 0) + (club.youtubeLink ? 1 : 0);
+
+    return new GetClubDetailResponseDto(club, isLiked, linkCount);
+  }
+
   async toggleLikeClub(
     transactionManager: EntityManager,
     userId: number,

src/home/club/dto/get-club-detail-request.dto.ts

@@ -0,0 +1,16 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsBoolean, IsNotEmpty, IsNumber } from 'class-validator';
+import { ToBoolean } from 'src/decorators/to-boolean.decorator';
+
+export class GetClubDetailRequestDto {
+  @IsNotEmpty()
+  @IsNumber()
+  @ApiProperty({ description: 'club id' })
+  clubId: number;
+
+  @IsNotEmpty()
+  @ToBoolean()
+  @IsBoolean()
+  @ApiPropertyOptional({ description: '로그인 여부' })
+  isLogin: boolean;
+}

src/home/club/dto/get-club-detail-response.dto.ts

@@ -0,0 +1,61 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { ClubCategory } from 'src/common/types/club-category-type';
+import { ClubEntity } from 'src/entities/club.entity';
+
+export class GetClubDetailResponseDto {
+  @ApiProperty({ description: 'club table의 PK' })
+  clubId: number;
+
+  @ApiProperty({ description: '동아리명' })
+  name: string;
+
+  @ApiProperty({ description: '동아리 카테고리' })
+  category: ClubCategory;
+
+  @ApiProperty({ description: '동아리 요약' })
+  summary: string;
+
+  @ApiProperty({ description: '정기 모임' })
+  regularMeeting: string;
+
+  @ApiProperty({ description: '모집 기간' })
+  recruitmentPeriod: string;
+
+  @ApiProperty({ description: '동아리 설명' })
+  description: string;
+
+  @ApiProperty({ description: '동아리 사진 URL 목록' })
+  imageUrl: string[];
+
+  @ApiProperty({ description: '좋아요 개수' })
+  likeCount: number;
+
+  @ApiPropertyOptional({ description: '인스타그램 링크' })
+  instagramLink: string;
+
+  @ApiPropertyOptional({ description: '유튜브 링크' })
+  youtubeLink: string;
+
+  @ApiProperty({ description: '좋아요 여부' })
+  isLiked: boolean;
+
+  @ApiProperty({ description: '링크 개수' })
+  linkCount: number;
+
+  constructor(club: ClubEntity, isLiked: boolean, linkCount: number) {
+    this.clubId = club.id;
+    this.name = club.name;
+    this.category = club.category;
+    this.summary = club.summary;
+    this.regularMeeting = club.regularMeeting;
+    this.recruitmentPeriod = club.recruitmentPeriod;
+    this.description = club.description;
+    this.imageUrl = [];
+    this.imageUrl[0] = club.imageUrl;
+    this.likeCount = club.allLikes;
+    this.instagramLink = club.instagramLink;
+    this.youtubeLink = club.youtubeLink;
+    this.isLiked = isLiked;
+    this.linkCount = linkCount;
+  }
+}