feat:월별 유저 알바 조회

Author: s0-yeon

src/DTO/user_alba_schedule_dto.ts

@@ -12,6 +12,17 @@ export interface CreateManualScheduleBody {
   memo?: string;
 }
 
+export interface UserAlbaScheduleItemDTO {
+  workplace?: string;
+  work_date?: string;
+  work_time?: string;
+  day_of_week?: user_alba_schedule_day_of_week; // 실제 enum 타입으로 바꿔도 됨
+  repeat_type?: user_alba_schedule_repeat_type; // 실제 enum 타입으로 바꿔도 됨
+  repeat_days?: string | null;
+  hourly_wage?: number;
+  memo?: string;
+}
+
 export interface UpdateManualScheduleBody {
   workplace?: string;
   work_date?: string;

src/controller/user_alba_schedule_controller.ts

@@ -10,7 +10,9 @@ import {
   Request,
   Response,
   Security,
+  Query,
   Path,
+  Get
 } from 'tsoa';
 import { Request as ExpressRequest } from 'express';
 import { TsoaSuccessResponse, TsoaFailResponse } from '../config/response_interface';
@@ -38,6 +40,79 @@ export interface CreateScheduleSuccess {
 @Route('user/alba/schedule')
 @Tags('User Alba Schedule')
 export class UserAlbaScheduleController extends Controller {
+
+   /**
+   * 내 유저 알바 스케줄 목록 조회 (커서/사이즈 없음)
+   * 예) /user/alba/schedule?month=2026-02
+   */
+  @Security('jwt')
+  @Get('')
+  @SuccessResponse(200, '유저 알바 스케줄 목록 조회 성공')
+  @Response<TsoaFailResponse<any>>(401, 'Unauthorized', {
+    resultType: 'FAIL' as any,
+    error: { errorCode: 'EC401', errorMessage: '인증이 필요합니다.', data: null },
+    success: null,
+  })
+  @Response<TsoaFailResponse<any>>(400, 'Bad Request', {
+    resultType: 'FAIL' as any,
+    error: { errorCode: 'EC400', errorMessage: '조회 요청이 부적절합니다.', data: null },
+    success: null,
+  })
+  @Response<TsoaFailResponse<any>>(500, 'Internal Server Error', {
+    resultType: 'FAIL' as any,
+    error: { errorCode: 'EC500', errorMessage: '서버 오류가 발생했습니다.', data: null },
+    success: null,
+  })
+  public async listMySchedules(
+    @Request() req: ExpressRequest,
+    @Query() month?: string, // "YYYY-MM"
+  ): Promise<TsoaSuccessResponse<any>> {
+    const userUuid = (req as any).user?.id as string;
+
+    console.log("token userId =", userUuid);
+    console.log("month =", month);
+
+    const data = await userAlbaScheduleService.listMySchedules(userUuid, { month });
+
+    this.setStatus(200);
+    return new TsoaSuccessResponse(data);
+  }
+
+  /**
+   * 내 유저 알바 스케줄 단건 조회(상세)
+   */
+  @Security('jwt')
+  @Get('{userAlbaScheduleId}')
+  @SuccessResponse(200, '유저 알바 스케줄 단건 조회 성공')
+  @Response<TsoaFailResponse<any>>(401, 'Unauthorized', {
+    resultType: 'FAIL' as any,
+    error: { errorCode: 'EC401', errorMessage: '인증이 필요합니다.', data: null },
+    success: null,
+  })
+  @Response<TsoaFailResponse<any>>(404, 'Not Found', {
+    resultType: 'FAIL' as any,
+    error: { errorCode: 'EC404', errorMessage: '스케줄을 찾을 수 없습니다.', data: null },
+    success: null,
+  })
+  @Response<TsoaFailResponse<any>>(500, 'Internal Server Error', {
+    resultType: 'FAIL' as any,
+    error: { errorCode: 'EC500', errorMessage: '서버 오류가 발생했습니다.', data: null },
+    success: null,
+  })
+  public async getMySchedule(
+    @Request() req: ExpressRequest,
+    @Path() userAlbaScheduleId: string,
+  ): Promise<TsoaSuccessResponse<any>> {
+    const userUuid = (req as any).user?.id as string;
+
+    const schedule = await userAlbaScheduleService.getMyScheduleById(userUuid, userAlbaScheduleId);
+
+    this.setStatus(200);
+    return new TsoaSuccessResponse(schedule);
+  }
+
+
+
   /*
    * 유저 알바 스케줄 등록 API
    * @param request - Express 요청 객체

src/repository/user_alba_schedule_repository.ts

@@ -19,6 +19,49 @@ export interface CreateUserAlbaScheduleRepoInput {
 }
 
 export class UserAlbaScheduleRepository {
+
+    async listByUserId(userId: string, opts: { month?: string }) {
+    const userIdBin = uuidToBin(userId);
+
+    return prisma.user_alba_schedule.findMany({
+      where: {
+        user_id: userIdBin,
+        ...(opts.month
+          ? {
+              // work_date가 "YYYY-MM-DD" 문자열로 저장된 전제
+              work_date: { startsWith: opts.month },
+            }
+          : {}),
+      },
+      orderBy: [
+        { work_date: 'asc' }, // null이면 뒤로 가거나 앞에 올 수 있음(필요하면 null 필터)
+        { work_time: 'asc' },
+      ],
+    });
+  }
+
+    async findDetailByIdAndUserId(userId: string, scheduleId: string) {
+    const userIdBin = uuidToBin(userId);
+    const scheduleIdBin = uuidToBin(scheduleId);
+
+    return prisma.user_alba_schedule.findFirst({
+      where: {
+        user_id: userIdBin,
+        user_alba_schedule_id: scheduleIdBin,
+      },
+      select: {
+        user_alba_schedule_id: true,
+        workplace: true,
+        work_date: true,
+        work_time: true,
+        day_of_week: true,
+        repeat_type: true,
+        repeat_days: true,
+        hourly_wage: true,
+        memo: true,
+      },
+    });
+  }
   public async create(userId: string, input: CreateUserAlbaScheduleRepoInput): Promise<Uint8Array> {
     const created = await prisma.user_alba_schedule.create({
       data: {

src/service/user_alba_schedule_service.ts

@@ -14,6 +14,9 @@ const workLogRepo = new UserWorkLogRepository();
 
 type RepeatBody = Pick<CreateManualScheduleBody, 'repeat_type' | 'repeat_days'>;
 
+const YM = /^\d{4}-(0[1-9]|1[0-2])$/;
+
+
 function toDateString(d: Date): string {
   // DB Date -> "YYYY-MM-DD"
   const y = d.getFullYear();
@@ -34,6 +37,13 @@ function toTimeRangeString(start?: Date | null, end?: Date | null): string | und
 
 const MASK7 = /^[01]{7}$/;
 
+function validateMonth(month?: string) {
+  if (!month) return;
+  if (!YM.test(month)) {
+    throw new CustomError('EC400', 400, 'month는 YYYY-MM 형식이어야 합니다.', null);
+  }
+}
+
 function validateManual(body: RepeatBody) {
   const rt = body.repeat_type;
   const rd = body.repeat_days;
@@ -132,6 +142,45 @@ function parseScheduleToWorkLogData(workDate?: string, workTime?: string) {
   return { workDate: date, startTime, endTime, workMinutes };
 }
 
+// 유저 알바 스케줄 서비스 목록 조회
+export async function listMySchedules(userId: string, q: { month?: string }) {
+  validateMonth(q.month);
+
+  const rows = await scheduleRepo.listByUserId(userId, { month: q.month });
+
+  const schedules = rows.map((s: any) => ({
+    user_alba_schedule_id: binToUuid(s.user_alba_schedule_id),
+    workplace: s.workplace ?? null,
+    work_date: s.work_date ?? null,
+    work_time: s.work_time ?? null,
+    day_of_week: s.day_of_week ?? null,
+    repeat_type: s.repeat_type ?? null,
+    repeat_days: s.repeat_days ?? null,
+    hourly_wage: s.hourly_wage ?? null,
+    memo: s.memo ?? null,
+  }));
+
+  return { schedules };
+}
+
+/** 단건 조회 */
+export async function getMyScheduleById(userId: string, scheduleId: string) {
+  const s = await scheduleRepo.findDetailByIdAndUserId(userId, scheduleId);
+  if (!s) throw new CustomError('EC404', 404, '스케줄을 찾을 수 없습니다.', null);
+
+  return {
+    user_alba_schedule_id: binToUuid(s.user_alba_schedule_id as unknown as Uint8Array),
+    workplace: s.workplace ?? null,
+    work_date: s.work_date ?? null,
+    work_time: s.work_time ?? null,
+    day_of_week: s.day_of_week ?? null,
+    repeat_type: s.repeat_type ?? null,
+    repeat_days: s.repeat_days ?? null,
+    hourly_wage: s.hourly_wage ?? null,
+    memo: s.memo ?? null,
+  };
+}
+
 // 유저 수동 입력 스케줄 생성
 export async function createManual(
   userId: string,