Merge pull request #179 from GDSC-DGU/refactor/#178

[Refactor] 부스 관련 API 및 좋아요 기능 구조 개선

Author: leejs0823

src/api/booth/admin/adminBooth.ts

@@ -0,0 +1,26 @@
+import { adminInstance } from "@/api/instance";
+import { sendRequest } from "@/api/request";
+import type {
+  AdminPubStatus,
+  ReserveListResponse,
+} from "../shared/sharedBoothTypes";
+
+// 1. 예약 목록 조회 (/pub)
+export const fetchReserveListAPI = () =>
+  sendRequest<ReserveListResponse>(adminInstance, "GET", "/pub");
+
+// 2. 부스 호출 (/pub/call)
+export const callBoothAPI = (reserveId: string) =>
+  sendRequest(adminInstance, "POST", "/pub/call", { reserveId });
+
+// 3. 방문 처리 (/pub/reserve)
+export const completeVisitAPI = (reserveId: string) =>
+  sendRequest(adminInstance, "PATCH", "/pub/reserve", { reserveId });
+
+// 4. 부스 상태 변경 (/pub?pubsStatus=)
+export const updateBoothStatusAPI = (
+  status: AdminPubStatus["status"] // "AVAILABLE" | "FULL" | "END"
+) => {
+  const url = `/pub?pubsStatus=${status}`;
+  return sendRequest<boolean>(adminInstance, "PATCH", url);
+};

src/api/booth/admin/hooks/useAdminBooth.ts

@@ -0,0 +1,58 @@
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import {
+  callBoothAPI,
+  completeVisitAPI,
+  updateBoothStatusAPI,
+} from "@/api/booth/admin/adminBooth";
+import { withDelayedGlobalLoading } from "@/utils/delayedGlobalLoading";
+import type { BoothStatus } from "@/types/booth";
+
+/**
+ * 특정 예약 팀에게 호출(Call) 처리하는 mutation 훅
+ * - 사용처: 어드민 화면에서 사용자가 대기 중일 때 "호출" 버튼 클릭 시
+ * - API: POST /pub/call
+ * - 성공 시: ["admin", "reserveList"] 캐시 무효화
+ */
+
+export const useCallBooth = () => {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (reserveId: string) =>
+      withDelayedGlobalLoading(callBoothAPI(reserveId)),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["admin", "reserveList"] });
+    },
+  });
+};
+
+/**
+ *  특정 예약 팀의 방문 완료 처리 mutation 훅
+ * - 사용처: 어드민 화면에서 사용자가 입장 완료 시 "입장 확인" 클릭
+ * - API: PATCH /pub/reserve
+ * - 성공 시: ["admin", "reserveList"] 캐시 무효화
+ */
+
+export const useCompleteVisit = () => {
+  const queryClient = useQueryClient();
+  return useMutation({
+    mutationFn: (reserveId: string) =>
+      withDelayedGlobalLoading(completeVisitAPI(reserveId)),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["admin", "reserveList"] });
+    },
+  });
+};
+
+/**
+ * 부스 전체 상태(AVAILABLE | FULL | END) 변경 mutation 훅
+ * - 사용처: 어드민이 부스 운영 상태를 변경할 때 사용
+ * - API: PATCH /pub?pubsStatus=...
+ * - 성공 후 캐시 무효화 없음 (필요시 수동 refetch 필요)
+ */
+
+export const useUpdateBoothStatus = () => {
+  return useMutation({
+    mutationFn: (status: BoothStatus) =>
+      withDelayedGlobalLoading(updateBoothStatusAPI(status)),
+  });
+};

src/api/booth/admin/hooks/useAdminBoothQuery.ts

@@ -0,0 +1,19 @@
+/**
+ * 어드민 대시보드에서 예약 목록(ReserveList)을 주기적으로 조회하는 React Query 훅
+ * - 사용처: 어드민 화면의 부스 대기 팀 리스트
+ * - API: GET /pub
+ * - 반환값: { reserveList[], waitingTotalCount, lateTotalCount, pubStatus }
+ */
+
+import { useQuery } from "@tanstack/react-query";
+import { fetchReserveListAPI } from "@/api/booth/admin/adminBooth";
+import { withDelayedGlobalLoading } from "@/utils/delayedGlobalLoading";
+
+export const useReserveList = () =>
+  useQuery({
+    queryKey: ["admin", "reserveList"],
+    queryFn: () => withDelayedGlobalLoading(fetchReserveListAPI()),
+    refetchInterval: 10000,
+    refetchOnWindowFocus: true,
+    staleTime: 0,
+  });

src/api/booth/adminBooth.ts

@@ -0,0 +1,40 @@
+// 예약 상태 (공통)
+export type ReserveStatus = "WAITING" | "CALLED" | "LATE" | "VISITED" | "CANCELLED";
+
+// 사용자 예약 정보
+export interface ReservationInfo {
+  waitTeam: number;
+  reserveStatus: "WAITING" | "DONE" | "CANCELLED";
+}
+
+// 사용자 부스 상태
+export interface PubStatus {
+  pubsId: number;
+  waitTeam: number;
+  status: "AVAILABLE" | "FULL" | "PREPARING" | "END";
+}
+
+// 관리자 부스 상태 (name 포함됨)
+export interface AdminPubStatus {
+  pubsId: number;
+  name: string;
+  status: "AVAILABLE" | "FULL" | "PREPARING" | "END";
+}
+
+// 관리자 예약 리스트 항목
+export interface Reserve {
+  reserveId: string;
+  reserveName: string;
+  phoneNumber: string;
+  reserveMembers: number;
+  status: ReserveStatus;
+  elapsedTime: number | string | null;
+}
+
+// 예약 리스트 전체 응답 타입
+export interface ReserveListResponse {
+  reserveList: Reserve[];
+  waitingTotalCount: number;
+  lateTotalCount: number;
+  pubStatus?: AdminPubStatus;
+}