Skip to content

기러기 토마토 스위스 인도인 별똥별 우영우.. 다루다↗️?

Notifications You must be signed in to change notification settings

SOPT-all/35-APPJAM-WEB-DARUDA

Repository files navigation

image

Group 2085665014 35-APPJAM-WEB-DARUDA

35기 AND SOPT 앱잼 웹 부문 - 다루다 레포지토리

1️⃣ 툴을 다루다
📍대학생활에 필요한 툴, 다루다
공부, 과제, 팀플, 동아리, 대외활동 등 대학생활에 빠질 수 없는 컴퓨터 작업은 다루다가 알려줘요.

2️⃣ 한눈에 다루다 _
📍내가 찾는 툴은 여기에, 툴 리스트
여러 정보를 찾으로 다닐 필요 없이 다루다에서 클릭 한 번에 다양한 정보를 확인하고 내게 꼭 맞는 툴을 찾아 보아요.

3️⃣ 함께 다루다 _
📍함께 성장하는 공간, 다루다 커뮤니티
툴 추천, 사용법, 궁금증에 대해서 주변에 물어볼 곳이 없다면 다루다에서 소통하세요.

💻 FE Developer

리드 김채현 김고은 노찬영 최 민
@imddoy @gonn-i @shroqkf @Minn-Choi


🛠 기술 스택

역할 종류 선정 이유
Library React 컴포넌트 기반 UI 개발에 적합하며, 강력한 생태계와 커뮤니티 지원을 통해 효율적인 프론트엔드 개발 가능.
Programming Language TypeScript 정적 타입 지원으로 코드 안정성을 높이고, 디버깅 및 유지보수성을 강화.
Styling Emotion Styled 컴포넌트 기반 스타일링으로, 동적 스타일 적용이 쉽고 CSS-in-JS 방식으로 관리가 간편.
Data Fetching Axios TanStack Query 비동기 데이터 관리와 캐싱을 효율적으로 처리하며, 서버 상태를 간단히 관리 가능.
API Documentation Swagger API 문서화를 위한 표준 도구로, 팀 간 소통과 유지보수를 용이하게 함.
Routing React Router SPA(Single Page Application)의 라우팅을 직관적으로 관리하며, 다양한 라우팅 옵션 제공.
Formatting ESLint Prettier Stylelint 코드 품질을 보장하고 일관된 코드 스타일을 유지하며,
협업 시 충돌을 줄이고 가독성을 향상.
Package Manager Yarn 의존성 관리를 빠르고 효율적으로 처리하며, workspace 기능으로 프로젝트 관리가 용이.
Deployment Vercel 프로젝트의 빠르고 쉬운 배포를 지원.
Bundler Vite 빠른 개발 환경 설정과 HMR(Hot Module Replacement)을 지원하여 개발 생산성을 향상.
UI Testing Tool Storybook UI 컴포넌트를 독립적으로 개발, 테스트, 문서화하여 재사용성을 극대화하며 타 파트의 빠른 피드백 반영에 유리.

🔗 구현화면

Image Image Image Image

Image

Image Image

Image

Image

Image

Image

🔗 Git Convention

🔥 Commit Message Convention

커밋 유형 설명
Init 초기 세팅시에만 사용 (패키지 설치, eslint/ prettier 작성)
Feat 새로운 기능 추가
Fix 버그 수정
Docs 문서 추가, 수정, 삭제
Style 코드 formatting, 세미콜론 누락, 코드 자체의 변경이 없는 경우
Refactor 코드 리팩토링
Test 테스트 코드, 리팩토링 테스트 코드 추가
Chore 패키지 매니저 수정, 그 외 기타 수정 ex) .gitignore
Build 빌드 관련 파일 수정에 대한 커밋
Design CSS 등 사용자 UI 디자인 변경
Comment 필요한 주석 추가 및 변경
Rename 파일 또는 폴더 명을 수정하거나 옮기는 작업만인 경우
Remove 파일을 삭제하는 작업만 수행한 경우
!HOTFIX 급하게 치명적인 버그를 고쳐야 하는 경우


🌿 Branch Convention

Branch Naming 규칙

  • 형식: <prefix>/<#issue 번호>/<상세기능>
  • Prefix 목록:
    • Init/: 초기 세팅 (패키지 설치, eslint/prettier 설정 등)
    • Feat/: 새로운 기능 개발
    • Fix/: 버그 수정
    • Docs/: 문서 추가, 수정, 삭제
    • Style/: 코드 formatting, 세미콜론 누락 등 코드 자체 변경이 없는 작업
    • Refactor/: 코드 리팩토링
    • Test/: 테스트 코드 작성 및 리팩토링
    • Chore/: 기타 작업 (패키지 매니저 수정, .gitignore 변경 등)
    • Build/: 빌드 관련 파일 수정
    • Design/: CSS 등 사용자 UI 디자인 변경
    • Comment/: 주석 추가 및 변경
    • Rename/: 파일 또는 폴더 이름 변경 및 이동
    • Remove/: 파일 삭제 작업만 수행한 경우
    • Hotfix/: 긴급하게 치명적인 버그 수정
  • 예시:
    • Feat/#12/logInPage
    • Fix/#25/headerBug

📋 Issue Convention

Issue Title 규칙

  • 형식: [태그] 제목
  • 태그 목록:
    • Init: 초기 세팅 (패키지 설치, eslint/prettier 설정 등)
    • Feat: 새로운 기능 개발
    • Fix: 버그 수정
    • Docs: 문서 추가, 수정, 삭제
    • Style: 코드 formatting, 세미콜론 누락 등 코드 자체 변경이 없는 작업
    • Refactor: 코드 리팩토링
    • Test: 테스트 코드 작성 및 리팩토링
    • Chore: 기타 작업 (패키지 매니저 수정, .gitignore 변경 등)
    • Build: 빌드 관련 파일 수정
    • Design: CSS 등 사용자 UI 디자인 변경
    • Comment: 주석 추가 및 변경
    • Rename: 파일 또는 폴더 이름 변경 및 이동
    • Remove: 파일 삭제 작업만 수행한 경우
    • Hotfix: 긴급하게 치명적인 버그 수정
  • 예시:
    • [Feat] Tool List Card 공통 컴포넌트 구현
    • [Init] ESLint, Prettier, StyleLint 초기세팅

Issue Template

  • 제목: [Feat] 간단한 요약
  • 내용:
    ## 📄 작업할 내용
    - 작업할 기능에 대한 설명을 작성해주세요.
    
    ## ✅ 작업할 내용
    - 작업할 내용을 최대한 세분화 하여 작성해주세요.
    - [ ] todo
    - [ ] todo
    
    ## 🎨 뷰 미리보기
    - 작업하고자 하는 기능의 뷰를 첨부해주세요.
  • 제목: [Bug] 간단한 요약
  • 내용:
    ## 🐛 버그 설명
    - 버그가 언제, 어떻게 발생했는지 작성해주세요.
    
    ## 👍 정상 동작
    - 정상적인 동작에 대해 설명해주세요.

🔄 Pull Request (PR) Convention

PR Title 규칙

  • 형식: [태그] 제목
  • 태그 목록:
    • Feat: 새로운 기능 개발
    • Fix: 버그 수정
    • Docs: 문서 추가/수정
    • Style: 코드 스타일 변경
    • Refactor: 코드 리팩토링
    • Test: 테스트 코드 작성/수정
    • Chore: 기타 작업
    • Build: 빌드 관련 작업
    • Design: UI/디자인 작업
    • Comment: 주석 추가/수정
    • Rename: 파일/폴더 이름 변경
    • Remove: 파일 삭제
    • Hotfix: 긴급한 버그 수정
  • 예시:
    • [Feat] Tool List Card 공통 컴포넌트 구현
    • [Fix] Header 컴포넌트의 버그 수정

PR Template

  • PR 작성 규칙:
    ## 📑 이슈 번호
    <!-- 이슈 번호를 작성해주세요 ex) #11 -->
    - close #
    
    ## ✨️ 작업 내용
    <!-- 작업 내용을 간략히 설명해주세요 -->
    
    ## 💙 코멘트
    <!-- 리뷰어가 중점적으로 봐주었으면 하는 부분이나 궁금한 점을 자유롭게 남겨주세요! -->
    
    ## 📸 구현 결과
    <!-- 구현한 기능이 모두 결과물에 포함되도록 자유롭게 첨부해주세요 (스크린샷, gif, 동영상, 배포링크 등) -->
    
    <!-- ⚠️⚠️⚠️⚠️⚠️⚠️ 잠깐 !!!! ⚠️⚠️⚠️⚠️⚠️ -->
    <!-- PR 제목 컨벤션에 맞게 잘 작성했는지, assignee 및 reviewer 지정했는지 다시 한 번 체크하기 !! -->

📂 프로젝트 구조

|-- 📁 .github
|-- 📁 node_modules
|-- 📁 public
|-- 📁 src
|   |-- 📁 apis
|   |-- 📁 assets
|   |-- 📁 components
|   |-- 📁 constants
|   |-- 📁 hooks
|   |-- 📁 pages
|   |   |-- 📁 페이지1
|   |   |   |-- 📁 apis
|   |   |   |-- 📁 types
|   |   |   |-- 📁 assets
|   |   |   |-- 📁 components
|   |   |   |-- 📁 constants
|   |   |   |-- 📁 hooks
|   |   |-- 📁 페이지2
|   |-- 📁 styles
|   |-- 📁 types
|   |-- 📁 utils
|   |-- 📁 routes
|-- .env
|-- .eslintignore
|-- .eslintrc.json
|-- .gitignore
|-- .prettierignore
|-- .prettierrc
|-- .stylelintrc.json
|-- index.html
|-- package.json
|-- svg.d.ts
|-- README.md
|-- tsconfig.json
|-- tsconfig.node.json
|-- vite.config.ts
|-- yarn.lock

About

기러기 토마토 스위스 인도인 별똥별 우영우.. 다루다↗️?

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •