🚀 Deploy 20260618 (재시도)

.gitignore

@@ -55,3 +55,7 @@ tsconfig.tsbuildinfo
 
 # 백엔드 코드
 /Malsami-BE/
+.gstack/
+
+# brainstorming visual companion
+.superpowers/

CHANGELOG.json

@@ -1,11 +1,82 @@
 {
   "metadata": {
-    "lastUpdated": "2025-10-01T13:31:52Z",
-    "currentVersion": "0.1.25",
+    "lastUpdated": "2026-06-18T05:05:51Z",
+    "currentVersion": "0.1.52",
     "projectType": "react",
-    "totalReleases": 15
+    "totalReleases": 17
   },
   "releases": [
+    {
+      "version": "0.1.52",
+      "project_type": "react",
+      "date": "2026-06-18",
+      "pr_number": 658,
+      "raw_summary": "Summary by CodeRabbit\n릴리스 노트\n\n\n새 기능\n\n자료 게시판에서 검색바로 자료를 찾을 수 있습니다\n화면 전환에 부드러운 애니메이션을 적용했습니다\nPC에서 더 넓은 화면으로 자료·질문 목록을 볼 수 있습니다\n\n\n\n버그 수정\n\n로그인 실패 시에도 로그인 중 화면이 표시됩니다\n긴 답변이 잘리지 않고 전체가 보입니다\n질문 상세 화면 상단 제목이 질문에 맞게 표시됩니다\nPC 화면에서 배경이 어긋나 보이던 문제를 해결했습니다\n일부 화면이 깨져 보이던 문제를 해결했습니다\n\n\n\n개선\n\n글꼴 굵기와 색상이 디자인대로 일관되게 표시됩니다\n화면 곳곳의 글자 크기와 간격을 더 단정하게 정리했습니다\n앱이 더 가볍고 빠르게 동작하도록 정리했습니다\n로그인·오류 안내 동작을 더 안정적으로 개선했습니다",
+      "parsed_changes": {
+        "새_기능": {
+          "title": "새 기능",
+          "items": [
+            "자료 게시판에서 검색바로 자료를 찾을 수 있습니다",
+            "화면 전환에 부드러운 애니메이션을 적용했습니다",
+            "PC에서 더 넓은 화면으로 자료·질문 목록을 볼 수 있습니다"
+          ]
+        },
+        "버그_수정": {
+          "title": "버그 수정",
+          "items": [
+            "로그인 실패 시에도 로그인 중 화면이 표시됩니다",
+            "긴 답변이 잘리지 않고 전체가 보입니다",
+            "질문 상세 화면 상단 제목이 질문에 맞게 표시됩니다",
+            "PC 화면에서 배경이 어긋나 보이던 문제를 해결했습니다",
+            "일부 화면이 깨져 보이던 문제를 해결했습니다"
+          ]
+        },
+        "개선": {
+          "title": "개선",
+          "items": [
+            "글꼴 굵기와 색상이 디자인대로 일관되게 표시됩니다",
+            "화면 곳곳의 글자 크기와 간격을 더 단정하게 정리했습니다",
+            "앱이 더 가볍고 빠르게 동작하도록 정리했습니다",
+            "로그인·오류 안내 동작을 더 안정적으로 개선했습니다"
+          ]
+        }
+      }
+    },
+    {
+      "version": "0.1.49",
+      "project_type": "react",
+      "date": "2026-06-17",
+      "pr_number": 656,
+      "raw_summary": "Summary by CodeRabbit\n릴리스 노트\n\n\n새 기능\n\n자료 게시판에서 검색바로 자료를 찾을 수 있습니다\n화면 전환에 부드러운 애니메이션을 적용했습니다\nPC에서 더 넓은 화면으로 자료·질문 목록을 볼 수 있습니다\n\n\n\n버그 수정\n\n로그인 실패 시에도 로그인 중 화면이 표시됩니다\n긴 답변이 잘리지 않고 전체가 보입니다\n질문 상세 화면 상단 제목이 질문에 맞게 표시됩니다\nPC 화면에서 배경이 어긋나 보이던 문제를 해결했습니다\n일부 화면이 깨져 보이던 문제를 해결했습니다\n\n\n\n개선\n\n글꼴 굵기와 색상이 디자인대로 일관되게 표시됩니다\n앱이 더 가볍고 빠르게 동작하도록 정리했습니다\n로그인·오류 안내 동작을 더 안정적으로 개선했습니다",
+      "parsed_changes": {
+        "새_기능": {
+          "title": "새 기능",
+          "items": [
+            "자료 게시판에서 검색바로 자료를 찾을 수 있습니다",
+            "화면 전환에 부드러운 애니메이션을 적용했습니다",
+            "PC에서 더 넓은 화면으로 자료·질문 목록을 볼 수 있습니다"
+          ]
+        },
+        "버그_수정": {
+          "title": "버그 수정",
+          "items": [
+            "로그인 실패 시에도 로그인 중 화면이 표시됩니다",
+            "긴 답변이 잘리지 않고 전체가 보입니다",
+            "질문 상세 화면 상단 제목이 질문에 맞게 표시됩니다",
+            "PC 화면에서 배경이 어긋나 보이던 문제를 해결했습니다",
+            "일부 화면이 깨져 보이던 문제를 해결했습니다"
+          ]
+        },
+        "개선": {
+          "title": "개선",
+          "items": [
+            "글꼴 굵기와 색상이 디자인대로 일관되게 표시됩니다",
+            "앱이 더 가볍고 빠르게 동작하도록 정리했습니다",
+            "로그인·오류 안내 동작을 더 안정적으로 개선했습니다"
+          ]
+        }
+      }
+    },
     {
       "version": "0.1.25",
       "project_type": "react",

CHANGELOG.md

@@ -1,7 +1,54 @@
 # Changelog
 
-**현재 버전:** 0.1.25  
-**마지막 업데이트:** 2025-10-01T13:31:52Z  
+**현재 버전:** 0.1.52  
+**마지막 업데이트:** 2026-06-18T05:05:51Z  
+
+---
+
+## [0.1.52] - 2026-06-18
+
+**PR:** #658  
+
+**새 기능**
+- 자료 게시판에서 검색바로 자료를 찾을 수 있습니다
+- 화면 전환에 부드러운 애니메이션을 적용했습니다
+- PC에서 더 넓은 화면으로 자료·질문 목록을 볼 수 있습니다
+
+**버그 수정**
+- 로그인 실패 시에도 로그인 중 화면이 표시됩니다
+- 긴 답변이 잘리지 않고 전체가 보입니다
+- 질문 상세 화면 상단 제목이 질문에 맞게 표시됩니다
+- PC 화면에서 배경이 어긋나 보이던 문제를 해결했습니다
+- 일부 화면이 깨져 보이던 문제를 해결했습니다
+
+**개선**
+- 글꼴 굵기와 색상이 디자인대로 일관되게 표시됩니다
+- 화면 곳곳의 글자 크기와 간격을 더 단정하게 정리했습니다
+- 앱이 더 가볍고 빠르게 동작하도록 정리했습니다
+- 로그인·오류 안내 동작을 더 안정적으로 개선했습니다
+
+---
+
+## [0.1.49] - 2026-06-17
+
+**PR:** #656  
+
+**새 기능**
+- 자료 게시판에서 검색바로 자료를 찾을 수 있습니다
+- 화면 전환에 부드러운 애니메이션을 적용했습니다
+- PC에서 더 넓은 화면으로 자료·질문 목록을 볼 수 있습니다
+
+**버그 수정**
+- 로그인 실패 시에도 로그인 중 화면이 표시됩니다
+- 긴 답변이 잘리지 않고 전체가 보입니다
+- 질문 상세 화면 상단 제목이 질문에 맞게 표시됩니다
+- PC 화면에서 배경이 어긋나 보이던 문제를 해결했습니다
+- 일부 화면이 깨져 보이던 문제를 해결했습니다
+
+**개선**
+- 글꼴 굵기와 색상이 디자인대로 일관되게 표시됩니다
+- 앱이 더 가볍고 빠르게 동작하도록 정리했습니다
+- 로그인·오류 안내 동작을 더 안정적으로 개선했습니다
 
 ---
 

README.md

@@ -3,7 +3,7 @@
 <!-- 수정하지마세요 자동으로 동기화 됩니다 -->
 
 <!-- 수정하지마세요 자동으로 동기화 됩니다 -->
-## 최신 버전 : v0.1.21 (2025-09-05)
+## 최신 버전 : v0.1.25 (2025-10-01)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 

docs/suh-template/issue/20260617_648_레거시_deprecated_제거.md

@@ -0,0 +1,26 @@
+## 📝 현재 문제점
+
+옛 디자인에서 새 디자인으로 전환하는 과정이 절반만 진행되어, 사용하지 않는 레거시 코드가 대량으로 방치되어 있습니다.
+
+- `src/deprecated/` 외 deprecated 폴더에 **약 89개 파일**이 남아 있으나, 실제 살아있는 코드가 import하는 것은 단 **2곳**뿐입니다.
+  - `src/components/documentDetail/DocDetail.tsx` → `@/deprecated/DCommentSection`
+  - `src/components/documentMain/TierBoard.tsx` → `@/deprecated/DocTierPageNav`
+- 나머지 약 87개 파일(`src/deprecated/*`, `src/apis/deprecated/*`, `src/components/deprecated/*`, `src/components/common/deprecated/*`)은 **아무도 import하지 않는 죽은 코드**입니다.
+- 죽은 코드가 IDE 자동완성·검색·코드 리뷰를 오염시키고, 신규 작업 시 어떤 컴포넌트가 진짜인지 혼란을 유발합니다.
+
+## 🛠️ 해결 방안 / 제안 기능
+
+⚙️ 작업 내용
+---
+- `DocDetail.tsx`의 `DCommentSection` 의존을 신식 댓글 컴포넌트로 교체 (CommentSection 신규/재사용)
+- `TierBoard.tsx`의 `DocTierPageNav` 의존을 신식 공통 헤더(CommonHeader 계열)로 교체
+- 위 2곳 교체 후 빌드가 통과하면, 사용하지 않는 deprecated 폴더 전체를 삭제:
+  - `src/deprecated/`
+  - `src/apis/deprecated/`
+  - `src/components/deprecated/`
+  - `src/components/common/deprecated/`
+- 삭제 후 `npm run build` 통과 및 dead import 0건 확인
+
+## 🙋‍♂️ 담당자
+
+- 프론트엔드: Cassiiopeia

docs/suh-template/issue/20260617_649_질문상세_API_신식통일.md

@@ -0,0 +1,31 @@
+## 📝 현재 문제점
+
+API 통신 패턴이 신식(`apiUtils`의 `postApiRequest` 기반 `~PostApi` 객체형)과 구식(개별 default-export 함수, `apiClient.post` 직접 호출)으로 혼재되어 있습니다.
+
+대부분의 화면은 신식 패턴으로 이전되었으나, **질문 상세/답변/댓글 영역만 아직 구식 API**를 사용합니다.
+
+- `src/app/board/question/detail/[id]/page.tsx` → `@/apis/question/getQuestionDetails` (구식)
+- `src/app/board/question/detail/[id]/answer/page.tsx` → `@/apis/question/postAnswer`, `getQuestionDetails` (구식)
+- `src/app/board/question/detail/[id]/comment/page.tsx` → `@/apis/question/getQuestionDetails` (구식)
+- `src/components/questionDetail/CommentInput.tsx` → `@/apis/question/postComment`, `refreshComments` (구식)
+- `src/components/questionDetail/AnswerSection.tsx` → `@/apis/question/getAnswer` (구식)
+- `src/components/questionDetail/ChaetaekCheckModal.tsx` → `@/apis/question/chaetaekAnswer` (구식)
+
+구식 함수는 자체 임시 타입을 쓰고 FormData를 수동 구성해, 타입 안정성과 일관성이 떨어집니다.
+
+## 🛠️ 해결 방안 / 제안 기능
+
+⚙️ 작업 내용
+---
+- 질문 상세/답변/댓글의 모든 구식 API 호출을 신식 패턴으로 교체:
+  - `getQuestionDetails` → `questionPostApi.getQuestionPost`
+  - `getAnswer` / `postAnswer` → `questionPostApi` 답변 메서드
+  - `chaetaekAnswer` → `questionPostApi` 채택 메서드
+  - `postComment` / `refreshComments` → `commentApi` (신식)
+- 백엔드 최신 엔드포인트와 정합성 확인 (BE: `/api/question/*`, `/api/comment/*` 멀티파트 기반)
+- 교체 완료 후 `src/apis/question/*` 구식 파일 제거
+- `npm run build` 통과 및 질문 상세 플로우 동작 확인
+
+## 🙋‍♂️ 담당자
+
+- 프론트엔드: Cassiiopeia

docs/suh-template/issue/20260617_650_스타일_디자인토큰_통일.md

@@ -0,0 +1,30 @@
+## 📝 현재 문제점
+
+`tailwind.config.ts`에 디자인 토큰(document-main, question-main, ui-muted, ui-divider, ui-count, tag-yeopjeon 등)이 충실히 정의되어 있으나, 실제 컴포넌트는 하드코딩 값을 광범위하게 사용해 디자인 통일성이 무너져 있습니다.
+
+- **하드코딩 hex 색상** (`text-[#929292]`, `border-[#F1F1F1]`, `bg-[#CAFFE5]` 등): 약 184건
+- **인라인 `style={{}}`** (`style={{ color: "#00E271" }}` 등): 약 54개 파일
+- **임의 픽셀값** (`w-[336px]`, `h-[48px]`, `rounded-[34px]`, `p-[20px]` 등): 약 80건
+- **z-index 하드코딩** (`z-[100]`, `z-[80]`, `z-[70]` 등): 약 10개 파일, 중앙 관리 부재
+
+CLAUDE.md의 스타일 규칙(Figma 값 직접 사용 금지, 디자인 토큰 필수)을 위반하는 상태입니다.
+
+## 🛠️ 해결 방안 / 제안 기능
+
+⚙️ 작업 내용
+---
+- 하드코딩 hex 색상을 기존 디자인 토큰으로 기계적 매핑:
+  - `text-[#929292]`, `text-[#ACACAC]` → `text-ui-count`
+  - `border-[#F1F1F1]`, `#F0F0F0` → `border-ui-divider`
+  - `text-[#00E271]` → `text-question-main`, `bg-[#CAFFE5]` → `bg-tag-preset-question-bg`
+  - 토큰 미정의 색상은 `tailwind.config.ts`에 신규 토큰으로 추가 후 매핑
+- 인라인 `style={{}}` 제거 → Tailwind 클래스 / 조건부 클래스(clsx)로 전환
+- 임의 픽셀값을 Tailwind 표준 스케일 또는 상대값(`w-full`, `flex-1`, `max-w-[640px]`)으로 변환
+- z-index 중앙 관리(`src/global/zIndex.ts` 상수 또는 tailwind z 토큰) 도입 후 하드코딩 제거
+- 영역별 진행 (landing → documentDetail → questionPost/documentPost → 나머지)
+- `npm run build` + `npx prettier --write .` 통과
+
+## 🙋‍♂️ 담당자
+
+- 프론트엔드: Cassiiopeia
+- 디자인: Cassiiopeia

docs/suh-template/issue/20260617_651_common_폴더_구조정리.md

@@ -0,0 +1,26 @@
+## 📝 현재 문제점
+
+`src/components/common/`은 "여러 영역에서 공유하는 진짜 공통 컴포넌트"를 담아야 하나, 실제로는 특정 도메인 전용 컴포넌트가 다수 섞여 있어 폴더 구조의 의미가 흐려졌습니다.
+
+- 도메인 전용인데 common에 위치한 컴포넌트 (약 13개):
+  - 자료: `DocumentCard`, `DocumentCommonInput`, `DocumentFilteringBottomSheet`, `MovingCardDocument`
+  - 질문: `QuestionCard`, `QuestionCommonInput`, `QuestionFilteringBottomSheet`, `ActiveQuestionFilters`, `MovingCardQuestion`, `BountySection`
+  - 공지: `MovingCardNotice`, `NoticeCard`
+- 명명 일관성 부족: `CommonNav`(실제 document 전용), `ChaetaekCheckModal` vs `ChaetaekSuccessModal` 등
+
+## 🛠️ 해결 방안 / 제안 기능
+
+⚙️ 작업 내용
+---
+- 진짜 공통(`Card`, `SearchBar`, `LoadingSpinner`, 스켈레톤 등)만 `common/`에 유지
+- 도메인 전용 컴포넌트를 각 도메인 폴더로 이동:
+  - Document 계열 → `documentMain/` 또는 `documentDetail/`
+  - Question 계열 → `questionMain/` 또는 `questionDetail/`
+  - Notice 계열 → `notice/`
+- 이동에 따른 import 경로 일괄 수정
+- 모호한 명명 정리 (예: `CommonNav` → 역할이 드러나는 이름)
+- 구조 변경은 동작 변경 없이 진행, `npm run build` 통과로 회귀 없음 확인
+
+## 🙋‍♂️ 담당자
+
+- 프론트엔드: Cassiiopeia

docs/suh-template/issue/20260617_652_운영API_검증_QA.md

@@ -0,0 +1,23 @@
+## 📝 현재 문제점
+
+대규모 레거시 제거·API 통일·스타일 통일·구조 정리 작업 이후, 회귀(regression) 없이 주요 사용자 플로우가 정상 동작하는지 검증이 필요합니다.
+
+- 백엔드 로컬 서버는 미기동 상태이나, 프론트 `appClient`의 baseURL이 운영 API(`https://api.sejong-malsami.co.kr`)로 설정되어 있어 운영 API 기준 검증이 가능합니다.
+
+## 🛠️ 해결 방안 / 제안 기능
+
+⚙️ 작업 내용
+---
+- 테스트 계정으로 로그인 플로우 검증
+- 주요 플로우 동작 확인:
+  - 랜딩 → 자료게시판/질문게시판 진입
+  - 자료 상세 / 질문 상세 (댓글·답변 영역 신식 API 동작)
+  - 게시글 작성 화면 렌더링
+  - 검색, 마이페이지
+- 정적 검증: `npm run build` 성공, TypeScript 에러 0, `npx prettier --write .` 통과
+- 발견된 회귀/버그는 즉시 수정 후 재검증
+
+## 🙋‍♂️ 담당자
+
+- 프론트엔드: Cassiiopeia
+- QA: Cassiiopeia

docs/suh-template/issue/20260617_654_Phase_0_죽은_코드_제거.md

@@ -0,0 +1,24 @@
+## 📝 현재 문제점
+
+- 이 프로젝트에는 현재 선언만 되고 사용되지 않는 Redux 슬라이스 5개, 미사용 API 함수(BE에도 엔드포인트 없음), 그리고 전체 주석 처리된 API 파일이 존재합니다.
+- 이러한 "죽은 코드(Dead Code)"는 이후 진행될 레거시 현대화 및 리팩토링 단계(API 표준화, 상태관리 재설계, UI 교체 등)에서 불필요한 인지 부하(Cognitive Load)를 발생시키고, 빌드 및 분석 시 노이즈를 초래합니다.
+- 따라서 본격적인 로직 리팩토링 및 UI 수술 전에 가장 하단의 사용되지 않는 코드를 청소하여 깔끔한 기반을 구축할 필요가 있습니다.
+
+## 🛠️ 해결 방안 / 제안 기능
+
+- 사용처가 0건인 Redux 슬라이스 5개(`filterOptionsSlice`, `docHotDownFilterOptionsSlice`, `docMyFacultyFilterOptionsSlice`, `docRequestFilterOptionsSlice`, `facultySlice`)를 완전 삭제하고, `src/global/store/index.ts`에서 등록을 해제합니다.
+- 사용처와 백엔드 엔드포인트가 모두 없는 `memberApi.getAllMemberPost` 함수(`/api/member/my-post`)를 제거합니다.
+- 전체 주석 처리되어 있으며 import처가 0건인 `src/apis/landingApi.ts` 파일을 삭제합니다.
+- 매 삭제 작업마다 `npm run build`를 통해 빌드가 정상적으로 완수되는지 확인하고, 개별 커밋으로 안전하게 적용합니다.
+
+⚙️ 작업 내용
+---
+- [ ] Task 1: 사용되지 않는 Redux 슬라이스 5개 파일 삭제 및 `store/index.ts` 정리
+- [ ] Task 2: `memberApi.ts`에서 미사용 API 함수 `getAllMemberPost` 제거 및 정리
+- [ ] Task 3: 전체 주석 처리된 `landingApi.ts` 파일 삭제
+- [ ] 각 단계별 `npm run build` 성공 검증 및 개별 커밋 분할 진행
+
+## 🙋‍♂️ 담당자
+
+- 백엔드: 없음 (FE 단독 작업)
+- 프론트엔드: Cassiiopeia

docs/suh-template/issue/20260617_655_레거시_UI_위생_청산.md

@@ -0,0 +1,27 @@
+## 📝 현재 문제점
+
+운영 중인 세종말싸미 FE(v0.1.39)는 빌드는 통과하지만, 누적된 스타일링 비일관성으로 인해 디자인 의도가 화면에 제대로 반영되지 않고 있습니다. 진단 결과 다음이 확인되었습니다.
+
+- **죽은 폰트 클래스**: `font-pretendard-{medium,semibold,bold}` 121건(42개 파일)이 `tailwind.config`·`globals.css` 어디에도 정의되어 있지 않아 전부 무시됨 → 굵기/텍스트 계층이 적용되지 않음
+- **픽셀 하드코딩**: `rounded-[8px]`·`gap-[4px]`·`ml-[8px]` 등 Tailwind 표준 스케일에 1:1 대응 가능한 임의값 픽셀이 다수 → 과도한 커스텀, 토큰 일관성 저하
+- **정적 인라인 스타일**: `style={{ cursor: "pointer" }}` 등 클래스로 대체 가능한 정적 인라인 스타일 잔존
+- **(후속) 반응형 부재**: `sm:/md:/lg:` 사용 6개 파일뿐, PC 대응 사실상 없음
+- **(후속) 구조 비일관**: 타입 25개 파일 명명 난장판, 훅 2개 폴더 분산, `global/` 잡탕, Redux 슬라이스 네이밍 정리 필요
+
+## 🛠️ 해결 방안 / 제안 기능
+
+토큰/표준으로 수렴하는 위생 청산을 **위험도 낮은 순서로 단계별 PR**로 진행하며, 각 단계마다 `prettier → npm run build` 검증을 통과한 것만 반영합니다.
+
+⚙️ 작업 내용
+---
+- [x] **죽은 폰트 청산**: `font-pretendard-*` → 프로젝트 표준 `font-suit-*`(globals.css 실존 유틸) 전수 치환 (42파일)
+- [x] **픽셀 하드코딩 토큰화**: 표준 스케일 대응 px → Tailwind 표준 클래스 (`max-w-[640px]` 공인 컨테이너 표준은 보존)
+- [x] **정적 인라인 스타일 정리**: `cursor: "pointer"` → `cursor-pointer` (동적 계산값 인라인은 보존)
+- [ ] **(후속) 반응형 전환**: 시각 검증 필요 → 담당자 복귀 후 진행
+- [ ] **(후속) 구조 재편**: 타입/훅/global/Redux 정돈 (import 대량 변경 → 신중 진행)
+
+각 단계는 빌드 검증을 통과했으며, 디자인 변경이 시각적으로 검증되어야 하는 항목(반응형·구조 재편)은 안전을 위해 후속 작업으로 분리했습니다.
+
+## 🙋‍♂️ 담당자
+
+- 프론트엔드: SUH SAECHAN