Merge branch 'dev' of https://github.com/prgrms-web-devcourse-final-project/WEB5_6_HaeDokCoding_FE into dev

Author: ahk0413

README.md

@@ -0,0 +1,169 @@
+# SSOUL 프로젝트 인수인계 문서
+
+## �� 프로젝트 개요
+
+**프로젝트명**: SSOUL (칵테일을 좋아하는 사람들을 위한 서비스)  
+**기술 스택**: Next.js 15, React 19, TypeScript, Tailwind CSS  
+**저장소**: https://github.com/prgrms-web-devcourse-final-project/WEB5_6_HaeDokCoding_FE
+
+## �� 시작하기
+
+### 개발 환경 설정
+```bash
+# 의존성 설치
+npm install
+
+# 개발 서버 실행
+npm run dev
+
+# 빌드
+npm run build
+
+# 코드 포맷팅
+npm run format
+
+# 린트 검사
+npm run lint
+```
+
+### 환경 변수
+프로젝트는 개발/운영 환경에 따라 다른 API URL을 사용합니다:
+- `NEXT_PUBLIC_API_URL_DEV`: 개발 환경 API URL
+- `NEXT_PUBLIC_API_URL_PROD`: 운영 환경 API URL
+
+## �� 프로젝트 구조
+
+```
+src/
+├── app/                          # Next.js App Router 페이지
+│   ├── layout.tsx               # 루트 레이아웃
+│   ├── page.tsx                 # 메인 페이지
+│   ├── community/               # 커뮤니티 관련 페이지
+│   ├── recipe/                  # 칵테일 레시피 페이지
+│   ├── recommend/               # 취향 추천 페이지
+│   ├── login/                   # 로그인 관련 페이지
+│   ├── mypage/                  # 마이페이지
+│   └── api/                     # API 설정
+├── domains/                      # 도메인별 컴포넌트
+│   ├── community/               # 커뮤니티 도메인
+│   ├── recipe/                  # 레시피 도메인
+│   ├── recommend/               # 추천 도메인
+│   ├── login/                   # 로그인 도메인
+│   ├── mypage/                  # 마이페이지 도메인
+│   └── shared/                  # 공통 도메인 컴포넌트
+└── shared/                       # 공통 컴포넌트 및 유틸
+    ├── components/              # 공통 UI 컴포넌트
+    ├── styles/                  # 글로벌 스타일
+    ├── assets/                  # 이미지, 아이콘 등
+    ├── hook/                    # 공통 훅
+    ├── types/                   # 타입 정의
+    └── utills/                  # 유틸리티 함수
+```
+
+## �� 주요 기능
+
+### 1. 인증 시스템
+- **소셜 로그인**: Google, Kakao, Naver 지원
+- **상태 관리**: Zustand + localStorage persist
+- **주요 파일**:
+  - `src/domains/shared/store/auth.ts`: 인증 상태 관리
+  - `src/domains/login/hook/useAuthHooks.ts`: 로그인 관련 훅
+  - `src/app/api/config/appConfig.ts`: API 설정
+
+### 2. 페이지별 기능
+
+#### �� 메인 페이지 (`/`)
+- 현재 기본 구조만 구현됨
+- 추후 확장 예정
+
+#### �� 칵테일 레시피 (`/recipe`)
+- **주요 컴포넌트**: 
+  - `CocktailList`: 칵테일 목록 표시
+  - `Accordion`: 필터링 옵션
+  - `SelectBox`: 정렬 옵션
+- **기능**: 검색, 필터링, 정렬
+- **상세 페이지**: `/recipe/[id]` - 개별 칵테일 상세 정보
+
+#### �� 커뮤니티 (`/community`)
+- **주요 컴포넌트**:
+  - `PostCard`: 게시물 카드
+  - `CommunityTab`: 카테고리 탭
+  - `WriteBtn`: 글쓰기 버튼
+- **카테고리**: 레시피, 팁, 질문, 자유
+- **글쓰기**: `/community/write`
+- **상세 페이지**: `/community/[id]`
+
+#### �� 취향 추천 (`/recommend`)
+- **챗봇 기반 추천**: `ChatSection` 컴포넌트
+- **주요 컴포넌트**:
+  - `BotMessage`, `UserMessage`: 메시지 컴포넌트
+  - `BotOptions`: 선택 옵션
+  - `MessageInput`: 입력창
+  - `TypingIndicator`: 타이핑 효과
+
+#### �� 마이페이지 (`/mypage`)
+- **기본 리다이렉트**: `/mypage` → `/mypage/mybar`
+- **주요 섹션**:
+  - `/mypage/mybar`: 나만의 바
+  - `/mypage/my-active`: 활동 내역 (게시물, 댓글, 좋아요)
+  - `/mypage/my-alarm`: 알림 설정
+  - `/mypage/my-setting`: 계정 설정
+
+#### �� 로그인 (`/login`)
+- **소셜 로그인**: `SocialLogin` 컴포넌트
+- **성공 페이지**: `/login/success`
+- **신규 사용자**: `/login/user/first-user`
+
+## �� 기술적 세부사항
+
+### 상태 관리
+- **Zustand**: 클라이언트 상태 관리
+- **Persist**: localStorage를 통한 상태 영속화
+- **주요 스토어**:
+  - `auth.ts`: 사용자 인증 상태
+  - `accordionStore.ts`: 아코디언 UI 상태
+
+### UI/UX
+- **Tailwind CSS**: 스타일링
+- **React Hot Toast**: 토스트 알림
+- **Lottie**: 로딩 애니메이션
+- **GSAP**: 고급 애니메이션
+- **Responsive**: 모바일/데스크톱 대응
+
+### 개발 도구
+- **ESLint**: 코드 품질 관리
+- **Prettier**: 코드 포맷팅
+- **Husky**: Git hooks
+- **Lint-staged**: 커밋 전 검사
+
+## �� 주요 설정 파일
+
+- `next.config.ts`: Next.js 설정
+- `tailwind.config.js`: Tailwind CSS 설정
+- `eslint.config.mjs`: ESLint 설정
+- `tsconfig.json`: TypeScript 설정
+
+## �� 반응형 디자인
+
+프로젝트는 모바일 우선(Mobile-first) 접근 방식을 사용합니다:
+- **모바일**: 기본 스타일
+- **태블릿**: `md:` prefix
+- **데스크톱**: `lg:`, `xl:` prefix
+
+## �� 주의사항
+
+1. **환경 변수**: 개발/운영 환경에 맞는 API URL 설정 필요
+2. **인증 토큰**: localStorage에 저장되므로 보안 고려 필요
+3. **API 통신**: `credentials: 'include'` 설정으로 쿠키 기반 인증
+4. **Git Hooks**: Husky 설정으로 커밋 전 자동 검사
+
+## �� 추가 문의
+
+- **저장소 이슈**: https://github.com/prgrms-web-devcourse-final-project/WEB5_6_HaeDokCoding_FE/issues
+- **주요 브랜치**: `main` (메인), `dev` (개발)
+
+---
+
+**작성일**: 2025-10-14  
+**작성자**: 이성헌  
+**버전**: 1.0

public/fonts/NanumSquareNeo-Variable.ttf

@@ -1,12 +1,13 @@
-import FooterWrapper from '@/shared/components/footer/FooterWrapper';
 import Header from '@/shared/components/header/Header';
 
 function NoLayout({ children }: { children: React.ReactNode }) {
   return (
     <>
-      <Header className="bg-transparent w-full h-[44px] md:h-[60px] flex items-center justify-between px-[12px] fixed top-0 left-0 z-50 transition-transform duration-200 ease-in-ou" />
+      <Header
+        isMain={true}
+        className="w-full h-[44px] md:h-[60px] flex items-center justify-between px-[12px] fixed top-0 left-0 z-50 transition-transform duration-200 ease-in-ou"
+      />
       <main className="flex flex-1">{children}</main>
-      <FooterWrapper />
     </>
   );
 }

src/app/(main)/layout.tsx

@@ -44,11 +44,23 @@ function CocktailDrop({ isDesktop = false }: CocktailDropProps) {
       );
 
       // 로고 위에서 아래로 자연스럽게 등장
+      const screenWidth = window.innerWidth;
+      const viewportHeight = window.innerHeight;
+      const isTablet = screenWidth >= 640 && screenWidth < 1024;
+      const isMobile = screenWidth < 640;
+
+      // 뷰포트 높이 기반으로 로고 위치 계산
+      const logoFinalY = isMobile
+        ? `-${viewportHeight * 0.3}px`
+        : isTablet
+          ? `-${viewportHeight * -0.8}px`
+          : '0px';
+
       gsap.fromTo(
         logoRef.current,
         { y: -300, opacity: 0 },
         {
-          y: !isDesktop ? -230 : -18, // 데스크톱이 아닐 때 더 위로
+          y: logoFinalY, // 뷰포트 높이 기반 계산
           opacity: 1,
           duration: 3,
           ease: 'power3.out',
@@ -69,7 +81,7 @@ function CocktailDrop({ isDesktop = false }: CocktailDropProps) {
   return (
     <div
       ref={containerRef}
-      className="relative w-full lg:min-h-[110vh] min-h-[89vh] flex flex-col md:justify-center justify-end items-center mt-10 overflow-hidden"
+      className="relative w-full lg:min-h-[120vh] md:min-h-[95vh] min-h-[87vh] flex flex-col lg:justify-center md:justify-center justify-end items-center mt-10 overflow-hidden"
       id="scroll-fixed"
     >
       {/* 대각선 줄 1 */}
@@ -84,7 +96,7 @@ function CocktailDrop({ isDesktop = false }: CocktailDropProps) {
       />
 
       {/* 로고 */}
-      <div ref={logoRef} className="absolute md:w-115 w-85 md:h-90 h-40">
+      <div ref={logoRef} className="absolute z-4 md:w-115 w-65 md:h-90 h-40">
         <Image
           src="/logo.svg"
           alt="로고 이미지"
@@ -95,20 +107,17 @@ function CocktailDrop({ isDesktop = false }: CocktailDropProps) {
         />
       </div>
 
-      <div className="w-full md:h-90 h-30"></div>
-
       {/* 컵 이미지 - 모바일에서 바닥에 붙도록 */}
-      <div className="md:relative absolute bottom-0">
+      <div className="z-5 absolute bottom-0">
         <Image
           src={Cocktailcup}
           alt="칵테일 컵"
-          width={900}
-          height={700}
           priority
-          className="md:w-auto md:h-auto w-[500px] h-[400px] object-cover"
+          style={{ height: 'auto' }}
+          className="md:w-[700px] w-[500px] object-contain"
         />
       </div>
-      <div className="absolute md:bottom-35 bottom-20 flex items-center justify-center z-3 w-full">
+      <div className="absolute md:bottom-35 bottom-20 flex items-center justify-center z-10 w-full">
         <PassBtn />
       </div>
     </div>

src/domains/main/cocktailDrop/CocktailDrop.tsx

@@ -3,8 +3,8 @@ import Image from 'next/image';
 function HomeLogo({ isDesktop }: { isDesktop: boolean }) {
   return (
     <div
-      className="z-5 absolute md:top-8 md:left-10 md:translate-none top-13 left-1/2 -translate-x-1/2"
-      style={{ width: !isDesktop ? 400 : 700, height: !isDesktop ? 70 : 240 }}
+      className="z-5 absolute md:top-22 md:left-10 md:translate-none top-30 left-1/2 -translate-x-1/2"
+      style={{ width: !isDesktop ? 400 : 580, height: !isDesktop ? 70 : 210 }}
     >
       <Image src={'/logo.svg'} alt="로고 이미지" fill priority className="object-contain" />
     </div>

src/domains/main/components/3d/HomeLogo.tsx

@@ -42,8 +42,8 @@ function Model({ onLoaded }: Props) {
   return (
     <primitive
       object={scene}
-      scale={5.8}
-      position={[0, -1.2, 0]}
+      scale={4.6}
+      position={[0, -0.6, 0]}
       rotation={[-0.15, Math.PI + 3, 0]}
     />
   );

src/domains/main/components/3d/HomeModel.tsx

@@ -2,8 +2,9 @@ function HomeText({ isDesktop }: { isDesktop: boolean }) {
   return (
     <>
       {!isDesktop ? (
-        <p className="absolute top-32 text-sm left-1/2 -translate-x-1/2 whitespace-nowrap">
-          어떤 칵테일이 끌리시나요? SSoul이 쉽게 골라드릴게요.
+        <p className="absolute top-48 text-sm left-1/2 -translate-x-1/2 text-center mt-4">
+          어떤 칵테일이 끌리시나요? <br />
+          SSoul이 쉽게 골라드릴게요.
         </p>
       ) : (
         <p className="absolute bottom-45 right-12 font-serif text-xl text-right font-normal z-20">

src/domains/main/components/3d/HomeText.tsx

@@ -19,7 +19,7 @@ function ModelImage({ onLoaded }: Props) {
           width={260}
           height={290}
           priority
-          className="object-cover w-[300px] h-[390px]"
+          className="object-cover w-[300px] h-[350px]"
         />
       </div>
     </div>

src/domains/main/components/3d/ModelImage.tsx

@@ -14,6 +14,10 @@ function StarMain() {
   useEffect(() => {
     if (!background.current || !foreground.current) return;
 
+    // 모바일에서는 별 애니메이션 비활성화
+    const isMobile = window.innerWidth < 768;
+    if (isMobile) return;
+
     const bgX = gsap.quickSetter(background.current, 'x', 'px');
     const bgY = gsap.quickSetter(background.current, 'y', 'px');
     const bgRotate = gsap.quickSetter(background.current, 'rotate', 'deg');
@@ -43,20 +47,11 @@ function StarMain() {
       mouse.current = { x, y };
     };
 
-    const handleTouchMove = (e: TouchEvent) => {
-      const touch = e.touches[0];
-      const x = (touch.clientX / window.innerWidth - 0.5) * 2;
-      const y = (touch.clientY / window.innerHeight - 0.5) * 2;
-      mouse.current = { x, y };
-    };
-
     window.addEventListener('mousemove', handleMouseMove);
-    window.addEventListener('touchmove', handleTouchMove);
     rafId.current = requestAnimationFrame(update);
 
     return () => {
       window.removeEventListener('mousemove', handleMouseMove);
-      window.removeEventListener('touchmove', handleTouchMove);
       if (rafId.current) cancelAnimationFrame(rafId.current);
     };
   }, []);

src/domains/main/components/3d/StarMain.tsx

@@ -20,6 +20,10 @@ function MyLike() {
     fetchLike();
   }, []);
 
+  useEffect(() => {
+    console.log(myLike);
+  }, [myLike]);
+
   return (
     <section className="flex justify-center">
       {myLike.length > 0 ? (