From 5781431c94b109604c61f67513548c1575fe749b Mon Sep 17 00:00:00 2001
From: youjin-hub <leeyoujin0704@naver.com>
Date: Mon, 24 Nov 2025 06:25:00 +0900
Subject: [PATCH 1/6] =?UTF-8?q?fix:=20=EB=8C=93=EA=B8=80=20=ED=97=A4?=
 =?UTF-8?q?=EB=8D=94=20=EC=B9=B4=EC=9A=B4=ED=8A=B8=EB=A5=BC=20=EC=84=9C?=
 =?UTF-8?q?=EB=B2=84=20total=20=EA=B8=B0=EC=A4=80=EC=9C=BC=EB=A1=9C=20?=
 =?UTF-8?q?=ED=86=B5=EC=9D=BC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../freeboard/[freeboardId]/components/CommentList.tsx      | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/apps/web/src/app/main/community/freeboard/[freeboardId]/components/CommentList.tsx b/apps/web/src/app/main/community/freeboard/[freeboardId]/components/CommentList.tsx
index 1698db26..e8ec2ee4 100644
--- a/apps/web/src/app/main/community/freeboard/[freeboardId]/components/CommentList.tsx
+++ b/apps/web/src/app/main/community/freeboard/[freeboardId]/components/CommentList.tsx
@@ -58,12 +58,12 @@ export default function CommentList({
     );
   }, [data]);
 
-  const latestTotal =
+  const firstPageTotal =
     data?.pages && data.pages.length > 0
-      ? data.pages[data.pages.length - 1]?.total
+      ? data.pages[0]?.total
       : undefined;
 
-  const headerCount = latestTotal ?? initialCount ?? comments.length;
+  const headerCount = firstPageTotal ?? initialCount ?? 0;
 
   return (
     <section aria-label="댓글 섹션" className="flex-1">

From 11c4bfd8ab23a5c11accb1124d138fd15ebce20f Mon Sep 17 00:00:00 2001
From: youjin-hub <leeyoujin0704@naver.com>
Date: Mon, 24 Nov 2025 06:49:41 +0900
Subject: [PATCH 2/6] =?UTF-8?q?refactor:=20=EC=A2=8B=EC=95=84=EC=9A=94=20?=
 =?UTF-8?q?=EC=B9=B4=EC=9A=B4=ED=8A=B8=20=EB=B3=B4=EC=A0=95=20=EB=A1=9C?=
 =?UTF-8?q?=EC=A7=81=EC=9D=84=20=EA=B3=B5=ED=86=B5=20=EC=9C=A0=ED=8B=B8?=
 =?UTF-8?q?=EB=A1=9C=20=EB=B6=84=EB=A6=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../[freeboardId]/components/LikeButtonComment.tsx        | 6 ++----
 .../freeboard/[freeboardId]/components/LikeButtonPost.tsx | 8 +++-----
 apps/web/src/utils/clampCount.ts                          | 6 ++++++
 3 files changed, 11 insertions(+), 9 deletions(-)
 create mode 100644 apps/web/src/utils/clampCount.ts

diff --git a/apps/web/src/app/main/community/freeboard/[freeboardId]/components/LikeButtonComment.tsx b/apps/web/src/app/main/community/freeboard/[freeboardId]/components/LikeButtonComment.tsx
index 1e348383..dc50be7c 100644
--- a/apps/web/src/app/main/community/freeboard/[freeboardId]/components/LikeButtonComment.tsx
+++ b/apps/web/src/app/main/community/freeboard/[freeboardId]/components/LikeButtonComment.tsx
@@ -8,6 +8,7 @@ import { useToast } from '@/hooks/ui/useToast';
 import { formatCappedCount } from '@/utils/formatCount';
 import { getGetFreeboardCommentsByCursorQueryKey } from '@/generated/api/endpoints/freeboard-comment/freeboard-comment';
 import { useToggleFreeboardCommentLike } from '@/generated/api/endpoints/freeboard-comment-like/freeboard-comment-like';
+import { clampCount } from '@/utils/clampCount';
 
 interface LikeButtonCommentProps {
   postId: number;
@@ -16,9 +17,6 @@ interface LikeButtonCommentProps {
   initialLikeCount: number;
 }
 
-// 음수 방지(보정) 헬퍼
-const clampMin0 = (n: number) => (n < 0 ? 0 : n);
-
 /**
  * 댓글 좋아요 버튼
  *
@@ -66,7 +64,7 @@ export default function LikeButtonComment({
         setLiked((prev) => {
           const next = !prev;
           const delta = next ? 1 : -1;
-          setLikeCount((count) => clampMin0(count + delta));
+          setLikeCount((count) => clampCount(count + delta));
           return next;
         });
 
diff --git a/apps/web/src/app/main/community/freeboard/[freeboardId]/components/LikeButtonPost.tsx b/apps/web/src/app/main/community/freeboard/[freeboardId]/components/LikeButtonPost.tsx
index b4b8541c..46cbdc59 100644
--- a/apps/web/src/app/main/community/freeboard/[freeboardId]/components/LikeButtonPost.tsx
+++ b/apps/web/src/app/main/community/freeboard/[freeboardId]/components/LikeButtonPost.tsx
@@ -9,6 +9,7 @@ import { useToast } from '@/hooks/ui/useToast';
 import { FreeboardDetailResponse } from '@/generated/api/models';
 import { getGetFreeboardPostQueryKey } from '@/generated/api/endpoints/freeboard/freeboard';
 import { useToggleFreeboardLike } from '@/generated/api/endpoints/freeboard-like/freeboard-like';
+import { clampCount } from '@/utils/clampCount';
 
 interface LikeButtonPostProps {
   postId: number;
@@ -16,9 +17,6 @@ interface LikeButtonPostProps {
   initialLikeCount: number;
 }
 
-// 음수 방지(보정) 헬퍼
-const clampMin0 = (n: number) => (n < 0 ? 0 : n);
-
 /**
  * 게시글 좋아요 버튼
  *
@@ -69,7 +67,7 @@ export default function LikeButtonPost({
         setLiked((prev) => {
           const next = !prev;
           const delta = next ? 1 : -1;
-          setLikeCount((count) => clampMin0(count + delta));
+          setLikeCount((count) => clampCount(count + delta));
           return next;
         });
 
@@ -79,7 +77,7 @@ export default function LikeButtonPost({
           (old) => {
             if (!old) return old;
             const nextLiked = !(old.isLiked ?? false);
-            const nextCount = clampMin0(
+            const nextCount = clampCount(
               old.likeCount + (nextLiked ? 1 : -1),
             );
             return {
diff --git a/apps/web/src/utils/clampCount.ts b/apps/web/src/utils/clampCount.ts
new file mode 100644
index 00000000..76aedb74
--- /dev/null
+++ b/apps/web/src/utils/clampCount.ts
@@ -0,0 +1,6 @@
+/**
+ * 카운트 값이 min(기본 0) 아래로 내려가지 않도록 보정합니다.
+ */
+export const clampCount = (n: number, min = 0) => {
+  return Math.max(n, min);
+};

From 13bad330e554c101966cce24393619a937c4efb2 Mon Sep 17 00:00:00 2001
From: youjin-hub <leeyoujin0704@naver.com>
Date: Mon, 24 Nov 2025 12:00:10 +0900
Subject: [PATCH 3/6] =?UTF-8?q?fix(likeButton):=20=EC=9D=B8=EC=A6=9D=20?=
 =?UTF-8?q?=EB=B3=B5=EC=9B=90=20UI=20=EC=82=AD=EC=A0=9C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../components/LikeButtonComment.tsx          | 21 +------------------
 .../components/LikeButtonPost.tsx             | 19 +----------------
 2 files changed, 2 insertions(+), 38 deletions(-)

diff --git a/apps/web/src/app/main/community/freeboard/[freeboardId]/components/LikeButtonComment.tsx b/apps/web/src/app/main/community/freeboard/[freeboardId]/components/LikeButtonComment.tsx
index dc50be7c..42dd6b8d 100644
--- a/apps/web/src/app/main/community/freeboard/[freeboardId]/components/LikeButtonComment.tsx
+++ b/apps/web/src/app/main/community/freeboard/[freeboardId]/components/LikeButtonComment.tsx
@@ -3,7 +3,7 @@
 import { useEffect, useState } from 'react';
 import { ThumbsUp } from 'lucide-react';
 import { useQueryClient } from '@tanstack/react-query';
-import { useAuthGuard, useAuthRestore } from '@/hooks/useAuth';
+import { useAuthGuard } from '@/hooks/useAuth';
 import { useToast } from '@/hooks/ui/useToast';
 import { formatCappedCount } from '@/utils/formatCount';
 import { getGetFreeboardCommentsByCursorQueryKey } from '@/generated/api/endpoints/freeboard-comment/freeboard-comment';
@@ -30,7 +30,6 @@ export default function LikeButtonComment({
   initialLiked,
   initialLikeCount,
 }: LikeButtonCommentProps) {
-  const { isRestoring, isAuthenticated } = useAuthRestore();
   const queryClient = useQueryClient();
   const toast = useToast();
   const { guard } = useAuthGuard();
@@ -102,23 +101,6 @@ export default function LikeButtonComment({
       toggleLike.mutate({ freeboardId: postId, commentId });
     });
 
-  // 인증 복원 중임을 명시(시각적 피드백)
-  if (isRestoring) {
-    return (
-      <button
-        className="flex items-center gap-1.5 opacity-60 cursor-wait"
-        disabled
-        aria-label="좋아요 로딩 중"
-        type="button"
-      >
-        <ThumbsUp className="inline w-4 h-4 text-neutral-200" />
-        <span className="text-neutral-500 text-input2">
-          {likeCount}
-        </span>
-      </button>
-    );
-  }
-
   return (
     <button
       type="button"
@@ -127,7 +109,6 @@ export default function LikeButtonComment({
       className="flex items-center gap-1.5"
       disabled={toggleLike.isPending}
       aria-label={liked ? '좋아요 취소' : '좋아요'}
-      title={!isAuthenticated ? '로그인이 필요합니다' : undefined}
     >
       <ThumbsUp
         className={`inline w-4 h-4 text-neutral-200 transition-colors ${
diff --git a/apps/web/src/app/main/community/freeboard/[freeboardId]/components/LikeButtonPost.tsx b/apps/web/src/app/main/community/freeboard/[freeboardId]/components/LikeButtonPost.tsx
index 46cbdc59..d3c66d5a 100644
--- a/apps/web/src/app/main/community/freeboard/[freeboardId]/components/LikeButtonPost.tsx
+++ b/apps/web/src/app/main/community/freeboard/[freeboardId]/components/LikeButtonPost.tsx
@@ -3,7 +3,7 @@
 import { useEffect, useState } from 'react';
 import { Heart } from 'lucide-react';
 import { useQueryClient } from '@tanstack/react-query';
-import { useAuthGuard, useAuthRestore } from '@/hooks/useAuth';
+import { useAuthGuard } from '@/hooks/useAuth';
 import { formatCappedCount } from '@/utils/formatCount';
 import { useToast } from '@/hooks/ui/useToast';
 import { FreeboardDetailResponse } from '@/generated/api/models';
@@ -29,7 +29,6 @@ export default function LikeButtonPost({
   initialLiked,
   initialLikeCount,
 }: LikeButtonPostProps) {
-  const { isRestoring } = useAuthRestore();
   const queryClient = useQueryClient();
   const toast = useToast();
   const { guard } = useAuthGuard();
@@ -123,22 +122,6 @@ export default function LikeButtonPost({
       toggleLike.mutate({ freeboardId: postId });
     });
 
-  // 인증 복원 중임을 명시(시각적 피드백)
-  if (isRestoring) {
-    return (
-      <button
-        className="flex items-center gap-1.5 opacity-60 cursor-wait"
-        disabled
-        aria-label="좋아요 로딩 중"
-      >
-        <Heart className="inline w-4 h-4 text-neutral-200" />
-        <span className="text-neutral-500 text-input2">
-          {formatCappedCount(likeCount)}
-        </span>
-      </button>
-    );
-  }
-
   return (
     <button
       type="button"

From 6a586b945a03cfb0a90284b2f364187d8a12ac90 Mon Sep 17 00:00:00 2001
From: youjin-hub <leeyoujin0704@naver.com>
Date: Mon, 24 Nov 2025 12:01:41 +0900
Subject: [PATCH 4/6] =?UTF-8?q?chore(virtualList):=20=EB=B6=88=ED=95=84?=
 =?UTF-8?q?=EC=9A=94=ED=95=9C=20=EC=A3=BC=EC=84=9D=20=EC=82=AD=EC=A0=9C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 apps/web/src/components/infiniteScrolls/VirtualList.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/apps/web/src/components/infiniteScrolls/VirtualList.tsx b/apps/web/src/components/infiniteScrolls/VirtualList.tsx
index 72cf5c96..d59f823d 100644
--- a/apps/web/src/components/infiniteScrolls/VirtualList.tsx
+++ b/apps/web/src/components/infiniteScrolls/VirtualList.tsx
@@ -151,7 +151,7 @@ export function VirtualList<T>({
         <div
           key={row.key}
           ref={virtualizer.measureElement}
-          data-index={row.index} // ✅ 경고 해결: 측정 요소에 data-index 추가
+          data-index={row.index}
           style={{
             position: 'absolute',
             top: 0,

From efd401dd0a2e01760fd9e0eafdd64ceccb3d104e Mon Sep 17 00:00:00 2001
From: youjin-hub <leeyoujin0704@naver.com>
Date: Wed, 26 Nov 2025 16:31:26 +0900
Subject: [PATCH 5/6] =?UTF-8?q?fix:=20=EC=83=81=EC=84=B8=ED=8E=98=EC=9D=B4?=
 =?UTF-8?q?=EC=A7=80=20=EC=97=90=EB=9F=AC=20=EC=B2=98=EB=A6=AC=20=EA=B0=9C?=
 =?UTF-8?q?=EC=84=A0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../freeboard/[freeboardId]/ClientPage.tsx    | 46 +++++++++++++++++--
 .../freeboard/[freeboardId]/page.tsx          | 14 ++++--
 apps/web/src/components/ErrorFallback.tsx     |  2 +-
 3 files changed, 54 insertions(+), 8 deletions(-)

diff --git a/apps/web/src/app/main/community/freeboard/[freeboardId]/ClientPage.tsx b/apps/web/src/app/main/community/freeboard/[freeboardId]/ClientPage.tsx
index 0012455d..8028293e 100644
--- a/apps/web/src/app/main/community/freeboard/[freeboardId]/ClientPage.tsx
+++ b/apps/web/src/app/main/community/freeboard/[freeboardId]/ClientPage.tsx
@@ -7,6 +7,8 @@ import CommentInput from './components/CommentInput';
 import FreeboardDetailSkeleton from './components/FreeboardDetailSkeleton';
 import { useGetFreeboardPost } from '@/generated/api/endpoints/freeboard/freeboard';
 import { useAuthRestore } from '@/hooks/useAuth';
+import ErrorFallback from '@/components/ErrorFallback';
+import { ErrorBoundary } from 'react-error-boundary';
 
 /**
  * 자유 게시판 게시글 상세 클라이언트 화면
@@ -18,6 +20,7 @@ export default function ClientPage({ postId }: { postId: number }) {
     data: post,
     isPending,
     error,
+    refetch,
   } = useGetFreeboardPost(postId, {
     query: {
       staleTime: 0, // 언제나 신선하지 않은 것으로 간주
@@ -28,11 +31,37 @@ export default function ClientPage({ postId }: { postId: number }) {
     },
   });
 
-  // TODO: 로딩/에러 처리 구체화 필요
-  // postId가 유효하지 않은 경우 처리 필요
   if (!postId) return <FreeboardDetailSkeleton />;
   if (isPending) return <FreeboardDetailSkeleton />;
-  if (error || !post) return <div>에러가 발생했습니다.</div>;
+  if (error || !post) {
+    return (
+      <main className="space-y-6 pt-12">
+        <Header className="fixed top-0 left-0 right-0 z-50 bg-white">
+          <Header.Left>
+            <Header.BackButton /> {/* router.back() 내부 처리 */}
+          </Header.Left>
+          <Header.Center>자유게시판</Header.Center>
+          <Header.Right>
+            {/* TODO: onClick 핸들러 추가 */}
+            <Header.MenuButton
+              onClick={() => {
+                /* 바텀시트 열기 */
+              }}
+            />
+          </Header.Right>
+        </Header>
+
+        <div className="px-5 pt-16">
+          <ErrorFallback
+            message="게시글을 불러오는 중 오류가 발생했습니다."
+            onRetry={() => {
+              refetch();
+            }}
+          />
+        </div>
+      </main>
+    );
+  }
 
   return (
     <main className="space-y-6 pt-12">
@@ -51,7 +80,16 @@ export default function ClientPage({ postId }: { postId: number }) {
         </Header.Right>
       </Header>
 
-      <FreeboardDetail post={post} />
+      <ErrorBoundary
+        FallbackComponent={({ error, resetErrorBoundary }) => (
+          <ErrorFallback
+            message={error?.message}
+            onRetry={resetErrorBoundary}
+          />
+        )}
+      >
+        <FreeboardDetail post={post} />
+      </ErrorBoundary>
 
       <section className="px-5 pb-6">
         <CommentList
diff --git a/apps/web/src/app/main/community/freeboard/[freeboardId]/page.tsx b/apps/web/src/app/main/community/freeboard/[freeboardId]/page.tsx
index fa342bdd..dcbfd4e5 100644
--- a/apps/web/src/app/main/community/freeboard/[freeboardId]/page.tsx
+++ b/apps/web/src/app/main/community/freeboard/[freeboardId]/page.tsx
@@ -31,9 +31,17 @@ export default async function Page({
     const queryOptions = getGetFreeboardPostQueryOptions(postId);
     await queryClient.fetchQuery(queryOptions);
   } catch (error: unknown) {
-    if (isAxiosError(error) && error.response?.status === 404)
-      notFound();
-    return <FreeboardDetailSkeleton />;
+    if (isAxiosError(error)) {
+      const status = error.response?.status;
+
+      if (status === 404) {
+        notFound();
+      }
+
+      //TODO: 401 에러 처리 협의 필요 (공통 OR 개별)
+    }
+
+    throw error;
   }
 
   const dehydratedState = dehydrate(queryClient);
diff --git a/apps/web/src/components/ErrorFallback.tsx b/apps/web/src/components/ErrorFallback.tsx
index bdbcc9b5..17f527c7 100644
--- a/apps/web/src/components/ErrorFallback.tsx
+++ b/apps/web/src/components/ErrorFallback.tsx
@@ -13,7 +13,7 @@ export default function ErrorFallback({
   onRetry,
 }: ErrorFallbackProps) {
   return (
-    <div className="p-6 text-center space-y-4">
+    <div className="p-12 text-center space-y-4">
       <p className="text-red-500 font-medium">
         {message ?? '문제가 발생했습니다.'}
       </p>

From bc97d04daebc07703393e233099ee31e88b44ac1 Mon Sep 17 00:00:00 2001
From: youjin-hub <leeyoujin0704@naver.com>
Date: Sat, 29 Nov 2025 22:45:04 +0900
Subject: [PATCH 6/6] =?UTF-8?q?chore(freeboardId):=20=20=EB=B6=88=ED=95=84?=
 =?UTF-8?q?=EC=9A=94=20=EC=A3=BC=EC=84=9D=20=EC=A0=9C=EA=B1=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../web/src/app/main/community/freeboard/[freeboardId]/page.tsx | 2 --
 1 file changed, 2 deletions(-)

diff --git a/apps/web/src/app/main/community/freeboard/[freeboardId]/page.tsx b/apps/web/src/app/main/community/freeboard/[freeboardId]/page.tsx
index dcbfd4e5..d571ad84 100644
--- a/apps/web/src/app/main/community/freeboard/[freeboardId]/page.tsx
+++ b/apps/web/src/app/main/community/freeboard/[freeboardId]/page.tsx
@@ -37,8 +37,6 @@ export default async function Page({
       if (status === 404) {
         notFound();
       }
-
-      //TODO: 401 에러 처리 협의 필요 (공통 OR 개별)
     }
 
     throw error;