11# SSOUL 프로젝트 인수인계 문서
22
3- ## �� 프로젝트 개요
3+ ## 프로젝트 개요
44
55** 프로젝트명** : SSOUL (칵테일을 좋아하는 사람들을 위한 서비스)
66** 기술 스택** : Next.js 15, React 19, TypeScript, Tailwind CSS
77** 저장소** : https://github.com/prgrms-web-devcourse-final-project/WEB5_6_HaeDokCoding_FE
88
9- ## �� 시작하기
9+ ## 시작하기
1010
1111### 개발 환경 설정
1212``` bash
@@ -31,7 +31,7 @@ npm run lint
3131- ` NEXT_PUBLIC_API_URL_DEV ` : 개발 환경 API URL
3232- ` NEXT_PUBLIC_API_URL_PROD ` : 운영 환경 API URL
3333
34- ## �� 프로젝트 구조
34+ ## 프로젝트 구조
3535
3636```
3737src/
6060 └── utills/ # 유틸리티 함수
6161```
6262
63- ## �� 주요 기능
63+ ## 주요 기능
6464
6565### 1. 인증 시스템
6666- ** 소셜 로그인** : Google, Kakao, Naver 지원
7272
7373### 2. 페이지별 기능
7474
75- #### �� 메인 페이지 (` / ` )
75+ #### 메인 페이지 (` / ` )
7676- 현재 기본 구조만 구현됨
7777- 추후 확장 예정
7878
79- #### �� 칵테일 레시피 (` /recipe ` )
79+ #### 칵테일 레시피 (` /recipe ` )
8080- ** 주요 컴포넌트** :
8181 - ` CocktailList ` : 칵테일 목록 표시
8282 - ` Accordion ` : 필터링 옵션
8383 - ` SelectBox ` : 정렬 옵션
8484- ** 기능** : 검색, 필터링, 정렬
8585- ** 상세 페이지** : ` /recipe/[id] ` - 개별 칵테일 상세 정보
8686
87- #### �� 커뮤니티 (` /community ` )
87+ #### 커뮤니티 (` /community ` )
8888- ** 주요 컴포넌트** :
8989 - ` PostCard ` : 게시물 카드
9090 - ` CommunityTab ` : 카테고리 탭
9393- ** 글쓰기** : ` /community/write `
9494- ** 상세 페이지** : ` /community/[id] `
9595
96- #### �� 취향 추천 (` /recommend ` )
96+ #### 취향 추천 (` /recommend ` )
9797- ** 챗봇 기반 추천** : ` ChatSection ` 컴포넌트
9898- ** 주요 컴포넌트** :
9999 - ` BotMessage ` , ` UserMessage ` : 메시지 컴포넌트
100100 - ` BotOptions ` : 선택 옵션
101101 - ` MessageInput ` : 입력창
102102 - ` TypingIndicator ` : 타이핑 효과
103103
104- #### �� 마이페이지 (` /mypage ` )
104+ #### 마이페이지 (` /mypage ` )
105105- ** 기본 리다이렉트** : ` /mypage ` → ` /mypage/mybar `
106106- ** 주요 섹션** :
107107 - ` /mypage/mybar ` : 나만의 바
108108 - ` /mypage/my-active ` : 활동 내역 (게시물, 댓글, 좋아요)
109109 - ` /mypage/my-alarm ` : 알림 설정
110110 - ` /mypage/my-setting ` : 계정 설정
111111
112- #### �� 로그인 (` /login ` )
112+ #### 로그인 (` /login ` )
113113- ** 소셜 로그인** : ` SocialLogin ` 컴포넌트
114114- ** 성공 페이지** : ` /login/success `
115115- ** 신규 사용자** : ` /login/user/first-user `
116116
117- ## �� 기술적 세부사항
117+ ## 기술적 세부사항
118118
119119### 상태 관리
120120- ** Zustand** : 클라이언트 상태 관리
@@ -136,34 +136,34 @@ src/
136136- ** Husky** : Git hooks
137137- ** Lint-staged** : 커밋 전 검사
138138
139- ## �� 주요 설정 파일
139+ ## 주요 설정 파일
140140
141141- ` next.config.ts ` : Next.js 설정
142142- ` tailwind.config.js ` : Tailwind CSS 설정
143143- ` eslint.config.mjs ` : ESLint 설정
144144- ` tsconfig.json ` : TypeScript 설정
145145
146- ## �� 반응형 디자인
146+ ## 반응형 디자인
147147
148148프로젝트는 모바일 우선(Mobile-first) 접근 방식을 사용합니다:
149149- ** 모바일** : 기본 스타일
150150- ** 태블릿** : ` md: ` prefix
151151- ** 데스크톱** : ` lg: ` , ` xl: ` prefix
152152
153- ## �� 주의사항
153+ ## 주의사항
154154
1551551 . ** 환경 변수** : 개발/운영 환경에 맞는 API URL 설정 필요
1561562 . ** 인증 토큰** : localStorage에 저장되므로 보안 고려 필요
1571573 . ** API 통신** : ` credentials: 'include' ` 설정으로 쿠키 기반 인증
1581584 . ** Git Hooks** : Husky 설정으로 커밋 전 자동 검사
159159
160- ## �� 추가 문의
160+ ## 추가 문의
161161
162162- ** 저장소 이슈** : https://github.com/prgrms-web-devcourse-final-project/WEB5_6_HaeDokCoding_FE/issues
163163- ** 주요 브랜치** : ` main ` (메인), ` dev ` (개발)
164164
165165---
166166
167167** 작성일** : 2025-10-14
168- ** 작성자** : 이성헌
169- ** 버전** : 1.0
168+ ** 작성자** : 정은빈 | 김아현 | 문태민
169+ ** 버전** : 1.0
0 commit comments