feat(alba_recommend): 알바 추천 기능 구현

Author: Jinacker

src/DTO/alba_recommend_dto.ts

@@ -0,0 +1,10 @@
+export interface RecommendedAlbaDto {
+  albaId: string;
+  storeName: string | null;
+  storeAddress: string | null;
+  hourlyRate: number | null;
+  totalWage: number | null;
+  mainTask: string | null;
+  regionCity: string | null;
+  regionDistrict: string | null;
+}

src/controller/alba_recommend_controller.ts

@@ -0,0 +1,28 @@
+import { Controller, Route, Get, Security, Request, SuccessResponse, Response, Tags } from 'tsoa';
+import { Request as ExpressRequest } from 'express';
+import AlbaRecommendService from '../service/alba_recommend_service';
+import { TsoaSuccessResponse } from '../config/response_interface';
+import { RecommendedAlbaDto } from '../DTO/alba_recommend_dto';
+import { uuidToBuffer } from '../util/uuid_util';
+
+@Route('api/alba/recommend')
+@Tags('Alba Recommend')
+export class AlbaRecommendController extends Controller {
+  /**
+   * 홈 화면 추천 알바공고 조회 API
+   * 유저의 선호 지역과 일치하는 알바공고를 최대 3개 추천
+   */
+  @Get('')
+  @Security('jwt')
+  @SuccessResponse('200', '조회 성공')
+  @Response(401, 'Unauthorized')
+  public async getRecommendedAlba(
+    @Request() req: ExpressRequest,
+  ): Promise<TsoaSuccessResponse<RecommendedAlbaDto[]>> {
+    const userId = (req.user as unknown as { id: string }).id;
+    const userIdBuffer = uuidToBuffer(userId);
+
+    const result = await AlbaRecommendService.getRecommendedPostings(userIdBuffer);
+    return new TsoaSuccessResponse(result);
+  }
+}

src/repository/alba_recommend_repository.ts

@@ -0,0 +1,46 @@
+import prisma from '../config/prisma';
+
+class AlbaRecommendRepository {
+  /**
+   * 유저의 선호 지역에 해당하는 알바 공고 최대 3개 조회
+   */
+  async findRecommendedPostings(userId: Uint8Array) {
+    // 1. 유저의 선호 region_id 목록 조회
+    const preferredRegions = await prisma.user_preferred_region.findMany({
+      where: { user_id: userId as Uint8Array<ArrayBuffer> },
+      select: { region_id: true },
+    });
+
+    if (preferredRegions.length === 0) {
+      return [];
+    }
+
+    const regionIds = preferredRegions.map((r) => r.region_id);
+
+    // 2. 해당 region_id에 매칭되는 alba_posting 3개 조회
+    const postings = await prisma.alba_posting.findMany({
+      where: {
+        region_id: { in: regionIds },
+      },
+      include: {
+        store: {
+          select: {
+            store_name: true,
+            store_address: true,
+          },
+        },
+        region: {
+          select: {
+            city: true,
+            district: true,
+          },
+        },
+      },
+      take: 3,
+    });
+
+    return postings;
+  }
+}
+
+export default new AlbaRecommendRepository();

src/service/alba_recommend_service.ts

@@ -0,0 +1,22 @@
+import AlbaRecommendRepository from '../repository/alba_recommend_repository';
+import { RecommendedAlbaDto } from '../DTO/alba_recommend_dto';
+import { bufferToUuid } from '../util/uuid_util';
+
+class AlbaRecommendService {
+  async getRecommendedPostings(userId: Uint8Array): Promise<RecommendedAlbaDto[]> {
+    const postings = await AlbaRecommendRepository.findRecommendedPostings(userId);
+
+    return postings.map((posting) => ({
+      albaId: bufferToUuid(posting.alba_id),
+      storeName: posting.store.store_name,
+      storeAddress: posting.store.store_address,
+      hourlyRate: posting.hourly_rate,
+      totalWage: posting.total_wage,
+      mainTask: posting.main_task,
+      regionCity: posting.region?.city ?? null,
+      regionDistrict: posting.region?.district ?? null,
+    }));
+  }
+}
+
+export default new AlbaRecommendService();