[FEAT] 프로필 미완료 시 Guard 설정 변경

src/app/(customer)/(protected)/layout.tsx

@@ -3,22 +3,26 @@
 import type { ReactNode } from "react";
 import { usePathname } from "next/navigation";
 
+import ProfileCompletionGuard from "@/components/auth/ProfileCompletionGuard";
 import RoleGuard from "@/components/auth/RoleGuard";
 import { getCustomerProtectedLoadingFallback } from "@/lib/loading/getCustomerProtectedLoadingFallback";
 
 interface CustomerProtectedLayoutProps {
   children: ReactNode;
 }
 
+/**
+ * 고객 `(protected)` Route Group 공통 가드.
+ * 프로필 완료 검사는 이 layout의 ProfileCompletionGuard에서만 처리한다.
+ * 하위 페이지에 CustomerAuthGate(+ Guard)를 추가로 감싸지 말 것.
+ */
 const CustomerProtectedLayout = ({ children }: CustomerProtectedLayoutProps) => {
   const pathname = usePathname();
+  const loadingFallback = getCustomerProtectedLoadingFallback(pathname);
 
   return (
-    <RoleGuard
-      allowedRole="CUSTOMER"
-      loadingFallback={getCustomerProtectedLoadingFallback(pathname)}
-    >
-      {children}
+    <RoleGuard allowedRole="CUSTOMER" loadingFallback={loadingFallback}>
+      <ProfileCompletionGuard loadingFallback={loadingFallback}>{children}</ProfileCompletionGuard>
     </RoleGuard>
   );
 };

src/app/(mover)/(protected)/layout.tsx

@@ -3,19 +3,26 @@
 import type { ReactNode } from "react";
 import { usePathname } from "next/navigation";
 
+import ProfileCompletionGuard from "@/components/auth/ProfileCompletionGuard";
 import RoleGuard from "@/components/auth/RoleGuard";
 import { getMoverProtectedLoadingFallback } from "@/lib/loading/getMoverProtectedLoadingFallback";
 
 interface MoverProtectedLayoutProps {
   children: ReactNode;
 }
 
+/**
+ * 기사 `(protected)` Route Group 공통 가드.
+ * 프로필 완료 검사는 이 layout의 ProfileCompletionGuard에서만 처리한다.
+ * 하위 페이지에 MoverAuthGate(+ Guard)를 추가로 감싸지 말 것.
+ */
 const MoverProtectedLayout = ({ children }: MoverProtectedLayoutProps) => {
   const pathname = usePathname();
+  const loadingFallback = getMoverProtectedLoadingFallback(pathname);
 
   return (
-    <RoleGuard allowedRole="MOVER" loadingFallback={getMoverProtectedLoadingFallback(pathname)}>
-      {children}
+    <RoleGuard allowedRole="MOVER" loadingFallback={loadingFallback}>
+      <ProfileCompletionGuard loadingFallback={loadingFallback}>{children}</ProfileCompletionGuard>
     </RoleGuard>
   );
 };

src/app/estimate-request/page.tsx

@@ -1,9 +1,12 @@
+import CustomerAuthGate from "@/components/auth/CustomerAuthGate";
 import EstimateRequestForm from "@/components/estimate/request/EstimateRequestForm";
 
 export default function EstimateRequestPage() {
   return (
-    <main className="bg-background-subtle min-h-screen md:px-40 md:py-64">
-      <EstimateRequestForm />
-    </main>
+    <CustomerAuthGate loadingMessage="견적 요청을 준비하는 중입니다.">
+      <main className="bg-background-subtle min-h-screen md:px-40 md:py-64">
+        <EstimateRequestForm />
+      </main>
+    </CustomerAuthGate>
   );
 }

src/app/estimate/received-requests/page.tsx

@@ -1,9 +1,12 @@
+import MoverAuthGate from "@/components/auth/MoverAuthGate";
 import ReceivedRequestsPage from "@/components/estimate/ReceivedRequestsPage";
 
 export default function Page() {
   return (
-    <div className="bg-background-default text-text-primary min-h-screen">
-      <ReceivedRequestsPage />
-    </div>
+    <MoverAuthGate loadingMessage="받은 요청을 불러오는 중입니다.">
+      <div className="bg-background-default text-text-primary min-h-screen">
+        <ReceivedRequestsPage />
+      </div>
+    </MoverAuthGate>
   );
 }

src/app/estimate/sent/[estimateId]/page.tsx

@@ -1,6 +1,7 @@
 import type { Metadata } from "next";
 import { notFound } from "next/navigation";
 
+import MoverAuthGate from "@/components/auth/MoverAuthGate";
 import SentEstimateDetailPage from "@/components/estimate/sent/SentEstimateDetailPage";
 
 export const metadata: Metadata = {
@@ -20,5 +21,9 @@ export default async function SentEstimateDetailRoute({ params }: PageProps) {
     notFound();
   }
 
-  return <SentEstimateDetailPage estimateId={estimateId} />;
+  return (
+    <MoverAuthGate loadingMessage="보낸 견적을 불러오는 중입니다.">
+      <SentEstimateDetailPage estimateId={estimateId} />
+    </MoverAuthGate>
+  );
 }

src/app/estimate/sent/page.tsx

@@ -1,5 +1,6 @@
 import type { Metadata } from "next";
 
+import MoverAuthGate from "@/components/auth/MoverAuthGate";
 import SentEstimatesPage from "@/components/estimate/sent/SentEstimatesPage";
 
 export const metadata: Metadata = {
@@ -8,5 +9,9 @@ export const metadata: Metadata = {
 };
 
 export default function SentEstimatesRoute() {
-  return <SentEstimatesPage />;
+  return (
+    <MoverAuthGate loadingMessage="보낸 견적을 불러오는 중입니다.">
+      <SentEstimatesPage />
+    </MoverAuthGate>
+  );
 }

src/components/auth/CustomerAuthGate.tsx

@@ -3,6 +3,7 @@
 import { usePathname, useRouter } from "next/navigation";
 import { useEffect, type ReactNode } from "react";
 
+import ProfileCompletionGuard from "@/components/auth/ProfileCompletionGuard";
 import EstimatesQueryStatus from "@/components/estimate/EstimatesQueryStatus";
 import { useCustomerAuthReady } from "@/hooks/useCustomerAuthReady";
 import { buildLoginPath, getRoleHomePath } from "@/lib/auth/redirect";
@@ -20,6 +21,12 @@ interface CustomerAuthGateProps {
  * - 세션 복구 중: 로딩
  * - 비로그인: 로그인 페이지로 이동 (?redirect=)
  * - CUSTOMER 아님(기사님·ADMIN·역할 미확정): getRoleHomePath로 이동
+ * - 프로필 미완료: ProfileCompletionGuard (모달)
+ *
+ * `(customer)/(protected)` layout 밖 페이지에서만 사용한다.
+ * layout 안에서는 RoleGuard + layout의 ProfileCompletionGuard만 쓰고,
+ * 이 Gate를 겹쳐 두지 않는다.
+ *
  * // 2026.07.30 정슬기 - [추가]
  * // 2026.07.30 정슬기 - [수정] 리다이렉트를 router.replace로 통일 (하드 새로고침 불필요)
  * // 2026.08.03 정슬기 - [수정] CUSTOMER 명시 판별로 canFetch·비고객 리다이렉트
@@ -53,9 +60,17 @@ export default function CustomerAuthGate({
     }
   }, [isPending, isAuthenticated, isCustomer, user?.role, pathname, router]);
 
+  const resolvedLoadingFallback = loadingFallback ?? (
+    <EstimatesQueryStatus message={loadingMessage} />
+  );
+
   if (isPending || !canFetch) {
-    return loadingFallback ?? <EstimatesQueryStatus message={loadingMessage} />;
+    return resolvedLoadingFallback;
   }
 
-  return children;
+  return (
+    <ProfileCompletionGuard loadingFallback={resolvedLoadingFallback}>
+      {children}
+    </ProfileCompletionGuard>
+  );
 }

src/components/auth/MoverAuthGate.tsx

@@ -3,6 +3,7 @@
 import { usePathname, useRouter } from "next/navigation";
 import { useEffect, type ReactNode } from "react";
 
+import ProfileCompletionGuard from "@/components/auth/ProfileCompletionGuard";
 import EstimatesQueryStatus from "@/components/estimate/EstimatesQueryStatus";
 import { useMoverAuthReady } from "@/hooks/useMoverAuthReady";
 import { buildLoginPath, getRoleHomePath } from "@/lib/auth/redirect";
@@ -20,6 +21,11 @@ interface MoverAuthGateProps {
  * - 세션 복구 중: 로딩
  * - 비로그인: 기사 로그인 페이지로 이동 (?redirect=)
  * - MOVER 아님(고객·ADMIN·역할 미확정): getRoleHomePath로 이동
+ * - 프로필 미완료: ProfileCompletionGuard (모달)
+ *
+ * `(mover)/(protected)` layout 밖 페이지에서만 사용한다.
+ * layout 안에서는 RoleGuard + layout의 ProfileCompletionGuard만 쓰고,
+ * 이 Gate를 겹쳐 두지 않는다.
  *
  * // 2026.07.31 정슬기 - [추가] CustomerAuthGate와 대칭인 기사님 가드
  *
@@ -48,11 +54,19 @@ const MoverAuthGate = ({
     }
   }, [isPending, isAuthenticated, isMover, user?.role, pathname, router]);
 
+  const resolvedLoadingFallback = loadingFallback ?? (
+    <EstimatesQueryStatus message={loadingMessage} />
+  );
+
   if (isPending || !canFetch) {
-    return loadingFallback ?? <EstimatesQueryStatus message={loadingMessage} />;
+    return resolvedLoadingFallback;
   }
 
-  return children;
+  return (
+    <ProfileCompletionGuard loadingFallback={resolvedLoadingFallback}>
+      {children}
+    </ProfileCompletionGuard>
+  );
 };
 
 export default MoverAuthGate;

src/components/auth/ProfileCompletionGuard.tsx

@@ -0,0 +1,57 @@
+"use client";
+
+import { usePathname } from "next/navigation";
+import { type ReactNode } from "react";
+
+import ProfileRequiredModal from "@/components/profile/ProfileRequiredModal";
+import { useProfileCompletionState } from "@/hooks/profile/useProfileCompletionState";
+import { isProfileCreatePath } from "@/lib/auth/redirect";
+import { useAuthStore } from "@/stores/useAuthStore";
+
+interface ProfileCompletionGuardProps {
+  children: ReactNode;
+  loadingFallback?: ReactNode;
+}
+
+/**
+ * 프로필 미완료 시 생성 페이지 외 보호 라우트 접근을 막습니다.
+ * - allowlist: /profile, /mover/profile
+ * - status 로딩: loadingFallback
+ * - 프로필 없음(404 등): incomplete → ProfileRequiredModal (닫기 불가, CTA만)
+ * - 그 외 status 실패: fail-open
+ * - 공개 페이지에는 사용하지 않음
+ *
+ * 적용 위치 (같은 트리에 Layout + AuthGate로 중복 적용하지 말 것):
+ * - `(protected)` Route Group → layout에서 RoleGuard와 함께
+ * - Group 밖 보호 페이지 → CustomerAuthGate / MoverAuthGate에서 처리
+ */
+const ProfileCompletionGuard = ({
+  children,
+  loadingFallback = null,
+}: ProfileCompletionGuardProps) => {
+  const pathname = usePathname();
+  const role = useAuthStore((state) => state.user?.role);
+  const { shouldCheck, isStatusPending, isIncomplete, profileCreatePath, audience } =
+    useProfileCompletionState(role);
+
+  if (!shouldCheck) {
+    return children;
+  }
+
+  if (isStatusPending) {
+    return loadingFallback;
+  }
+
+  if (!isIncomplete || isProfileCreatePath(pathname, audience)) {
+    return children;
+  }
+
+  return (
+    <>
+      {loadingFallback}
+      <ProfileRequiredModal open profileCreatePath={profileCreatePath} />
+    </>
+  );
+};
+
+export default ProfileCompletionGuard;