Skip to content

prgrms-web-devcourse-final-project/WEB1_1_Bongdari_FE

Folders and files

NameName
Last commit message
Last commit date
Feb 7, 2025
Jan 16, 2025
Nov 26, 2024
Feb 10, 2025
Nov 26, 2024
Nov 26, 2024
Nov 26, 2024
Dec 9, 2024
Nov 26, 2024
Dec 9, 2024
Feb 4, 2025
Dec 2, 2024
Nov 26, 2024
Nov 26, 2024
Feb 4, 2025
Feb 4, 2025

Repository files navigation

🦺 구호활동 연결 플랫폼 손모아

재해나 지원이 필요한 현장에서 도움을 원하는 단체와 자원봉사자를 연결해주는 중계 플랫폼입니다.

배포 URL: https://www.somemore.site/
노션 링크: https://www.notion.so/prgrms/Team08-81045d7e1f3e48ccbb9b215a663b97c6
프론트 레포지토리: https://github.com/prgrms-web-devcourse-final-project/WEB1_1_Bongdari_FE
백엔드 레포지토리: https://github.com/prgrms-web-devcourse-final-project/WEB1_1_Bongdari_BE

🎇프로젝트 개요

손모아의 목표는 "사회지원 활동 참여를 쉽게 만들자" 입니다.

전화, 방문 등 기존의 복잡한 절차의 불편함을 해소해 접근성을 향상 시키기 위해 이 프로젝트를 기획하게 되었습니다.

도움이 필요하지만 모집 방법이 게시글 등록이 전부였던 기관들에게 봉사자에게 직접 도움을 요청할 수 있게 하여 봉사자와 기관 간의 커뮤니케이션을 활성화할 수 있고,
봉사 시간에 따라 티어를 부여하고 "이 주의 봉사왕" 랭킹과 같은 게이미피케이션(Gamification)을 통해 봉사자들은 성취감을 느낄 수 있습니다.

📃목차

👩🏻‍💻프로젝트 구성원

Backend

Backend Backend Backend Backend
조재중(팀장) 윤서진(PM) 양아영 이범수

@m-a-king

@7zrv

@ayoung-dev

@leebs0521

Frontend

Frontend Frontend Frontend
홍유진(팀장) 김민준 김주영

@youjin-hong

@minjoon97

@djm06294

💡주요 기능

✔️메인 기능

  • 기관은 봉사 활동에 대한 모집글을 등록할 수 있습니다.


  • 봉사자는 기관들이 올린 봉사 활동 모집글들을 전부 볼 수 있고, 원하는 봉사 활동 모집글에 대해 지원할 수 있습니다.


  • 기관은 자신이 올린 봉사 활동에 지원한 봉사자들의 명단을 리스트로 관리하며 지원 수락, 반려할 수 있습니다.


  • 기관은 해당 봉사 활동이 종료된 후, 봉사 활동에 참여한 지원자들에 한하여 봉사 시간을 정산할 수 있습니다.


✔️콘텐츠 기능

  • 메인 페이지에는 봉사자들의 프로필에 등록돼있는 봉사 시간을 기준으로 "이 달의 봉사왕" 봉사시간이 많은 봉사자 4명의 랭킹이 매겨집니다.


  • 각 봉사자들은 봉사 시간/횟수에 따라 10단계의 티어를 가질 수 있습니다.


  • 기관과 봉사자는 모두 커뮤니티를 공유하며, 댓글과 대댓글 기능을 통해 활발한 소통을 할 수 있습니다.


✔️편의 기능

  • 기관은 봉사자에게, 봉사자는 기관에게 쪽지를 전달할 수 있습니다. 이를 통해 기관과 봉사자의 소통에 편의를 보장합니다.


  • 기관과 봉사자 모두 쪽지, 리뷰, 봉사 신청 결과 등을 실시간 알림으로 받아볼 수 있습니다.


🛠기술 스택

📌 Frontend Tech Stack

🔤 언어

🛠 프레임워크

📡 상태 관리 & 데이터 통신

🔌 외부 라이브러리 & 서비스

📌 Backend Tech Stack

🔤 언어

🛠 프레임워크

💾 데이터베이스

🚀 배포

🤝 협업 Tool


📁폴더 구조

프론트엔드 디렉토리 구조

src
├── assets
│   └── images
├── components
│   ├── component1
│   │   ├── logic
│   │   ├── ui
│   │   ├── index.tsx
│   │   └── indexCss.ts
│   └── component2
│       ├── logic
│       ├── ui
│       ├── index.tsx
│       └── indexCss.ts
├── features
│   ├── feature1
│   │   ├── logic
│   │   ├── ui
│   │   ├── index.tsx
│   │   └── indexCss.ts
│   └── feature2
│       ├── logic
│       ├── ui
│       ├── index.tsx
│       └── indexCss.ts
├── api
│   ├── endPoints.ts
│   └── client.ts
├── store
│   ├── queries
│   │   └── login
│   │       └── loginData.ts
│   └── stores
├── styles
│   ├── myreset.css
│   └── global.css
├── shared
│   ├── hooks
│   └── types
├── mocks
├── pages
│   ├── main-page
│   │   ├── index.tsx
│   │   └── indexCss.ts
│   └── login-page
│       ├── index.tsx
│       └── indexCss.ts
└── layout
    ├── header
    └── footer
백엔드 디렉토리 구조

com.example.develetter
├── global
│   ├── config
│   ├── exception
│   ├── handler
│		├── common
│   └── util
├── center
│   ├── domain
│ 	│   └── entity
│   ├── controller
│   │   ├── query
│   │   └── command
│   ├── service
│   │   ├── query
│   │   └── command
│   ├── dto
│   │   ├── request
│   │   └── response
│   ├── repository
│   │   ├── query
│   │   └── command             
│   └── scheduler
├── volunteer
│   ├── domain
│ 	│   └── entity
│   ├── controller
│   │   ├── query
│   │   └── command
│   ├── service
│   │   ├── query
│   │   └── command
│   ├── dto
│   │   ├── request
│   │   └── response
│   ├── repository
│   │   ├── query
│   │   └── command             
│   └── scheduler
  

🔄 User Flow

주요 사용자 흐름

  1. 비로그인 사용자(기관/봉사자 구분 x): 봉사 활동 모집글/커뮤니티/메인페이지 이용 가능
  2. 기관: 도움요청글 작성/수정/삭제, 지원자 수락/반려/정산, 커뮤니티 글 작성/삭제/댓글, 쪽지/리뷰, 알림, 마이페이지 이용
  3. 봉사자: 도움요청글 조회/지원/지원 철회, 커뮤니티 글 작성/삭제/댓글, 쪽지/리뷰, 알림, 마이페이지 이용

🚀설치 및 실행 방법

설치

  1. 저장소 복제하기
git clone https://github.com/prgrms-web-devcourse-final-project/WEB1_1_Bongdari_FE.git

  1. 프론트엔드 종속성 설치
yarn install
  1. 환경 변수 설정
  • frontend: 백엔드 도메인 주소, 카카오맵 api Javascript key 등록
  1. 개발 서버 시작
yarn dev

📆개발 기간

  • 기획: 2024.11.12~2024.11.25
  • 개발: 2024.11.25~2024.12.9

🛠트러블 슈팅

  • TODO: 노션링크 연결 또는 직접 작성

🔧향후 개선 사항

  • TODO
  • TODO
  • TODO

👥팀원 소개 및 느낀점

김민준
  • 작성 예정
김주영
  • 작성 예정
홍유진
  • 작성 예정