37-COLLABORATION-WEB-TICKETBAY

DIVE SOPT

🎫 모바일 웹 1조 티켓베이 🎫

👥 OUR TEAM

🤴 장정훈	정유진	민경빈	박소현
@jeonghoon11	@hello-yujin	@gyeongbibin	@Sohyunnnn

티켓베이 클라이언트팀 기술 스택

카테고리	기술 스택
UI Library
Server State Management
Language
Build Tool
Styling
Package Manager
CI/CD

폴더 구조

|-- 📁 node_modules
|-- 📁 public                          # 정적 파일 (이미지, 아이콘 등)
|-- 📁 src
      |-- 📁 app                       # 애플리케이션 진입점 및 최상위 설정
      |      |-App.tsx
      |      |-main.tsx
      |-- 📁 assets                    # 정적 리소스 (아이콘, SVG 등)
      |      |--📁icons
      |      |--📁svg
      |-- 📁 entities                  # 비즈니스 엔티티 (도메인별 데이터 모델 및 UI)
      |      |--📁ticket               # 티켓 엔티티
      |            |--📁api            # 티켓 관련 API 함수
      |            |--📁queries        # React Query 쿼리 및 키 정의
      |            |--📁types          # 티켓 관련 타입 정의
      |            |--📁ui             # 티켓 관련 UI 컴포넌트
      |-- 📁 pages                     # 페이지 컴포넌트 (라우트별 최상위 컴포넌트)
      |      |--📁home                 # 홈 페이지
      |      |--📁select-ticket        # 티켓 선택 페이지
      |      |     |-select-ticket.tsx # 티켓 선택 페이지 컴포넌트
      |      |--📁ticket-detail        # 티켓 상세 페이지
      |-- 📁 shared                    # 공유 리소스 (프로젝트 전역에서 사용)
      |      |--📁apis                 # API 인스턴스 설정 (axios 등)
      |      |--📁components
      |      |--📁config               # 애플리케이션 설정 파일
      |      |--📁constants
      |      |--📁hooks
      |      |--📁layouts              # 레이아웃 컴포넌트
      |      |--📁query                # React Query 설정 (클라이언트, 프로바이더)
      |      |--📁router
      |      |--📁styles
      |      |--📁types
      |      |--📁utils
      |-- 📁 types
      |-- 📁 widgets                   # 복합 UI 컴포넌트 (페이지별 위젯)
      |      |--📁home                 # 홈 페이지 위젯
      |      |--📁select-ticket        # 티켓 선택 페이지 위젯
      |      |     |--📁components
      |      |     |--📁configs
      |      |     |--📁constants
      |      |     |--📁hooks
      |      |     |--📁types
      |      |     |--📁utils
      |      |--📁ticket-detail        # 티켓 상세 페이지 위젯
|-- .eslintrc.json
|-- .prettierrc
|-- eslint.config.js
|-- package.json
|-- pnpm-lock.yaml
|-- README.md
|-- tsconfig.json
|-- tsconfig.app.json
|-- tsconfig.node.json
|-- vercel.json                        # Vercel 배포 설정
|-- vite.config.ts

TicketBay Convention

📭 Git Convention

Git Flow

• main branch
  main 브랜치는 언제나 배포 가능한 안정된 상태만 관리합니다.

• develop branch
  develop 브랜치는 통합 브랜치로, 모든 기능 개발이 이곳을 기반으로 진행됩니다.
  평소에는 develop에서 기능별 Feature branch를 분기하고, 개발이 완료된 후 다시 develop으로 병합합니다.
  develop 브랜치는 항상 안정적인 상태를 유지하며, 배포 가능한 상태가 되면 main 브랜치로 병합하여 CI/CD를 통해 배포를 진행합니다.

• Feature branch develop 브랜치에서 분기하여 기능별 개발을 진행하고, 완료 후 다시 develop 브랜치로 병합합니다.

Commit Convention

feat : 새로운 기능 추가
fix : 버그 수정
chore : 빌드 업무, 패키지 매니저, 라이브러리, dependencies 설정
docs : 문서 수정 - ex) [README.md](http://readme.md/)
style : 기능 수정 없는 코드 스타일 변경
refactor : 코드 리팩터링
test : 테스트 코드, 리펙토링 테스트 코드 추가
ci : ci 설정 파일 수정
init: 초기 세팅
code review: 코드 리뷰 반영

📦 뷰 & 공통 컴포넌트 역할 분배

구분	담당자
티켓 선택 페이지	장정훈
카테고리 아이콘	장정훈
Navigation	장정훈
티켓 상세 페이지	정유진
버튼	정유진
Tabbar	정유진
홈 페이지 (상단 헤더, 공지 영역)	민경빈
플로팅 버튼	민경빈
사이드바	민경빈
홈 페이지 ( 컨텐츠 영역 )	박소현
Tab 컴포넌트	박소현
Footer	박소현

---

🔧 API 역할 분배

기능	담당자
최근 본 티켓	박소현
베스트 인기티켓	민경빈
티켓 목록 조회	장정훈
티켓 상세 조회	정유진