refactor(front, repository): ErrorCode 수정, useLoadingProgress 수정

Author: Hyeseung-OH

front/src/hooks/analysis/useLoadingProgress.ts

@@ -2,43 +2,77 @@
 
 import { useEffect, useRef, useState, useMemo } from "react"
 import { useRouter } from "next/navigation"
+import { ERROR_CODES, ERROR_MESSAGES, ErrorCode } from "@/types/api"
 
 type AnalysisErrorKind = "repo" | "auth" | "rate" | "duplicate" | "server" | "network";
+
 const defaultAnalysisError = {
   type: "server" as AnalysisErrorKind,
   message: "분석 처리 중 오류가 발생했어요. 잠시 후 다시 시도해 주세요.",
 };
 
-const stashAnalysisError = (payload: { type: AnalysisErrorKind; message: string }) => {
-  try {
-    sessionStorage.setItem("analysisError", JSON.stringify(payload));
-  } catch {
-    /* ignore */
+const ANALYSIS_ERROR_KIND: Partial<Record<ErrorCode, AnalysisErrorKind>> = {
+  [ERROR_CODES.GITHUB_REPO_NOT_FOUND]: "repo",
+  [ERROR_CODES.GITHUB_API_FAILED]: "repo",
+  [ERROR_CODES.GITHUB_REPO_TOO_LARGE]: "repo",
+  [ERROR_CODES.GITHUB_INVALID_TOKEN]: "auth",
+  [ERROR_CODES.FORBIDDEN]: "auth",
+  [ERROR_CODES.GITHUB_RATE_LIMIT_EXCEEDED]: "rate",
+  [ERROR_CODES.GITHUB_API_SERVER_ERROR]: "server",
+  [ERROR_CODES.NETWORK_ERROR]: "network",
+  [ERROR_CODES.ANALYSIS_IN_PROGRESS]: "duplicate",
+}
+
+const ANALYSIS_ERROR_MESSAGE: Partial<Record<ErrorCode, string>> = {
+  [ERROR_CODES.GITHUB_REPO_NOT_FOUND]: "리포지토리 URL을 다시 한번 확인해 주세요.",
+  [ERROR_CODES.GITHUB_API_FAILED]: "요청을 처리할 수 없었어요. 입력값을 다시 확인해 주세요.",
+  [ERROR_CODES.GITHUB_REPO_TOO_LARGE]: "저장소가 너무 커서 분석할 수 없어요.",
+  [ERROR_CODES.GITHUB_INVALID_TOKEN]: "GitHub 인증에 실패했어요. 다시 로그인 후 시도해 주세요.",
+  [ERROR_CODES.FORBIDDEN]: "해당 리포지토리에 접근 권한이 없어요.",
+  [ERROR_CODES.GITHUB_RATE_LIMIT_EXCEEDED]: "요청이 많아요. 잠시 기다렸다 다시 시도해 주세요.",
+  [ERROR_CODES.GITHUB_API_SERVER_ERROR]: "GitHub 서버에서 오류가 발생했어요. 잠시 후 다시 시도해 주세요.",
+  [ERROR_CODES.NETWORK_ERROR]: "네트워크 연결을 확인해 주세요.",
+  [ERROR_CODES.ANALYSIS_IN_PROGRESS]: "이미 분석을 진행 중이에요. 잠시 후 다시 확인해 주세요.",
+}
+
+const errorCodeValues = new Set<ErrorCode>(Object.values(ERROR_CODES))
+
+const resolveErrorCode = (raw?: string): ErrorCode | undefined => {
+  if (!raw) return undefined
+  if (errorCodeValues.has(raw as ErrorCode)) {
+    return raw as ErrorCode
   }
-};
+  if (raw in ERROR_CODES) {
+    return ERROR_CODES[raw as keyof typeof ERROR_CODES]
+  }
+  return undefined
+}
 
 const mapErrorCodeToAlert = (
   code?: string,
   fallback?: string
 ): { type: AnalysisErrorKind; message: string } => {
-  switch (code) {
-    case "GITHUB_REPO_NOT_FOUND":
-      return { type: "repo", message: "리포지토리 URL을 다시 한번 확인해 주세요." };
-    case "GITHUB_INVALID_TOKEN":
-      return { type: "auth", message: "GitHub 인증에 실패했어요. 다시 로그인 후 시도해 주세요." };
-    case "GITHUB_RATE_LIMIT_EXCEEDED":
-      return { type: "rate", message: "요청이 많아요. 잠시 기다렸다 다시 시도해 주세요." };
-    case "FORBIDDEN":
-      return { type: "auth", message: "해당 리포지토리에 접근 권한이 없어요." };
-    case "GITHUB_API_FAILED":
-      return { type: "repo", message: "요청을 처리할 수 없었어요. 입력값을 다시 확인해 주세요." };
-    case "GITHUB_API_SERVER_ERROR":
-      return { type: "server", message: "GitHub 서버에서 오류가 발생했어요. 잠시 후 다시 시도해 주세요." };
-    default:
-      return {
-        type: defaultAnalysisError.type,
-        message: fallback || defaultAnalysisError.message,
-      };
+  const resolvedCode = resolveErrorCode(code);
+
+  if (resolvedCode) {
+    const type = ANALYSIS_ERROR_KIND[resolvedCode] ?? defaultAnalysisError.type;
+    const message =
+      ANALYSIS_ERROR_MESSAGE[resolvedCode] ||
+      ERROR_MESSAGES[resolvedCode] ||
+      fallback ||
+      defaultAnalysisError.message;
+
+    return { type, message };
+  }
+
+  return defaultAnalysisError;
+};
+
+const stashAnalysisError = (payload: { type: AnalysisErrorKind; message: string }) => {
+  try {
+    sessionStorage.setItem("analysisError", JSON.stringify(payload));
+  } catch {
+    /* ignore */
   }
 };
 
@@ -185,8 +219,13 @@ export function useAnalysisProgress(repoUrl?: string | null) {
 
     eventSource.onerror = (err) => {
       console.error("[SSE][error]", err)
-      setError("❌ SSE 연결이 끊어졌습니다.")
+      setError("❌ 서버에 문제가 발생했어요.")
       eventSource.close()
+
+      setTimeout(() => {
+        router.push("/analysis");
+      }, 3000);
+      return;
     }
 
     return () => {

front/src/types/api.ts

@@ -52,11 +52,24 @@ export interface ApiResponse<T> {
     INVALID_INPUT_VALUE: 'CMN003',
     INVALID_TYPE_VALUE: 'CMN004',
     MISSING_REQUEST_PARAMETER: 'CMN005',
+    UNAUTHORIZED: 'CMN006',
 
+    // user 도메인
+    LOGIN_FAILED: 'U001',
+    EMAIL_VERIFY_FAILED: 'U002',
+    NAME_NOT_FOUND: 'U003',
+    PASSWORD_NOT_FOUND: 'U004',
+    PASSWORD_NOT_EQUAL: 'U005',
+    EMAIL_NOT_FOUND: 'U006',
+    ALREADY_REGISTERED_EMAIL: 'U007',
+
     // Analysis 도메인
     INVALID_GITHUB_URL: 'A001',
     INVALID_REPOSITORY_PATH: 'A002',
     ANALYSIS_NOT_FOUND: 'A003',
+    USER_NOT_FOUND: 'A004',
+    FORBIDDEN: 'A005',
+    ANALYSIS_IN_PROGRESS: 'A006',
 
     // Repository 도메인
     GITHUB_REPO_NOT_FOUND: 'G001',
@@ -65,32 +78,63 @@ export interface ApiResponse<T> {
     GITHUB_INVALID_TOKEN: 'G004',
     GITHUB_RESPONSE_PARSE_ERROR: 'G005',
     GITHUB_API_FAILED: 'G006',
-    
+    GITHUB_REPO_TOO_LARGE: 'G007',
+
+    // comment 도메인
+    COMMENT_NOT_FOUND: 'R001',
+
     // 프론트엔드 전용 에러
     NETWORK_ERROR: 'FE001',
     TIMEOUT_ERROR: 'FE002',
-    INVALID_RESPONSE: 'FE003',
-    UNAUTHORIZED: 'FE004',
-    FORBIDDEN: 'FE005',
+    INVALID_RESPONSE: 'FE003'
   } as const;
 
   export type ErrorCode = typeof ERROR_CODES[keyof typeof ERROR_CODES];
 
   // ========== 에러 메시지 매핑 ==========
   export const ERROR_MESSAGES: Record<string, string> = {
+    // 공통
     [ERROR_CODES.VALIDATION_FAILED]: '입력값 검증에 실패했습니다.',
     [ERROR_CODES.INTERNAL_ERROR]: '서버 내부 오류가 발생했습니다.',
     [ERROR_CODES.INVALID_INPUT_VALUE]: '잘못된 입력값입니다.',
+    [ERROR_CODES.INVALID_TYPE_VALUE]: '잘못된 타입의 값입니다.',
+    [ERROR_CODES.MISSING_REQUEST_PARAMETER]: '필수 요청 파라미터가 누락되었습니다.',
+    [ERROR_CODES.UNAUTHORIZED]: '인증이 필요합니다.',
+    
+    // user 도메인
+    [ERROR_CODES.LOGIN_FAILED]: '로그인에 실패했습니다.',
+    [ERROR_CODES.EMAIL_VERIFY_FAILED]: '이메일 인증코드가 일치하지 않습니다.',
+    [ERROR_CODES.NAME_NOT_FOUND]: '이름이 입력되지 않았습니다.',
+    [ERROR_CODES.PASSWORD_NOT_FOUND]: '비밀번호가 입력되지 않았습니다.',
+    [ERROR_CODES.PASSWORD_NOT_EQUAL]: '비밀번호 확인이 일치하지 않습니다.',
+    [ERROR_CODES.EMAIL_NOT_FOUND]: '해당 이메일은 없는 계정입니다.',
+    [ERROR_CODES.ALREADY_REGISTERED_EMAIL]: '이미 회원가입된 이메일입니다.',
+
     [ERROR_CODES.INVALID_GITHUB_URL]: '올바른 GitHub 저장소 URL이 아닙니다.',
-    [ERROR_CODES.INVALID_REPOSITORY_PATH]: '저장소 URL 형식이 잘못되었습니다.',
+    [ERROR_CODES.INVALID_REPOSITORY_PATH]:
+      '저장소 URL 형식이 잘못되었습니다. (예: https://github.com/{owner}/{repo})',
     [ERROR_CODES.ANALYSIS_NOT_FOUND]: '분석 결과를 찾을 수 없습니다.',
+    [ERROR_CODES.USER_NOT_FOUND]: '사용자 정보를 찾을 수 없습니다.',
+    [ERROR_CODES.FORBIDDEN]: '접근 권한이 없습니다.',
+    [ERROR_CODES.ANALYSIS_IN_PROGRESS]: '이미 분석이 진행 중입니다. 잠시 후 다시 시도해주세요.',
+
+    // repository 도메인
     [ERROR_CODES.GITHUB_REPO_NOT_FOUND]: 'GitHub 저장소를 찾을 수 없습니다.',
     [ERROR_CODES.GITHUB_API_SERVER_ERROR]: 'GitHub API 서버에서 오류가 발생했습니다.',
     [ERROR_CODES.GITHUB_RATE_LIMIT_EXCEEDED]: 'GitHub API 호출 제한을 초과했습니다.',
+    [ERROR_CODES.GITHUB_INVALID_TOKEN]: 'GitHub 인증 토큰이 유효하지 않습니다.',
+    [ERROR_CODES.GITHUB_RESPONSE_PARSE_ERROR]:
+      'GitHub 응답 데이터를 처리하는 중 오류가 발생했습니다.',
+    [ERROR_CODES.GITHUB_API_FAILED]: 'GitHub API 응답에 실패했습니다.',
+    [ERROR_CODES.GITHUB_REPO_TOO_LARGE]: '저장소가 너무 커서 분석할 수 없습니다.',
+
+    // comment 도메인
+    [ERROR_CODES.COMMENT_NOT_FOUND]: '댓글을 찾을 수 없습니다.',
+
+    // 프론트엔드 전용
     [ERROR_CODES.NETWORK_ERROR]: '네트워크 연결을 확인해주세요.',
     [ERROR_CODES.TIMEOUT_ERROR]: '요청 시간이 초과되었습니다.',
-    [ERROR_CODES.UNAUTHORIZED]: '인증이 필요합니다.',
-    [ERROR_CODES.FORBIDDEN]: '접근 권한이 없습니다.',
+    [ERROR_CODES.INVALID_RESPONSE]: '서버 응답 형식이 올바르지 않습니다.'
   };
 
   // ========== API 요청 옵션 ==========