An open API service indexing awesome lists of open source software.

https://github.com/codestates-seb/seb42_main_014

봉사활동 플랫폼, 좀 더 나은 세상
https://github.com/codestates-seb/seb42_main_014

Last synced: about 1 year ago
JSON representation

봉사활동 플랫폼, 좀 더 나은 세상

Awesome Lists containing this project

README

          

# 좀나세(조금 더 나은 세상) :sparkles:


**`팀 이름` :** 구현동화 : 소중한 거북이와 악어 🐢🐊

**`프로젝트 기간` :** 2023.03.03. - 2023.03.29

**`배포 링크`:** [jomnasae.site](http://abetterworld.s3-website.ap-northeast-2.amazonaws.com/)

**`서비스 매뉴얼`:** [좀나세 서비스 메뉴얼 보러가기](https://www.miricanvas.com/v/11w2m9f)

**`개인 기술 발표`:** [팀원들의 개인 기술 발표 보러가기](https://youtu.be/NntrXZBIWEA)

**`개인 기술 발표 자료`:** [개인 기술 발표 자료 보러가기](https://www.miricanvas.com/v/11w6li8)


## About JomNaSae
![image](https://user-images.githubusercontent.com/62414231/228397430-d645f09c-621b-4ee5-9143-aa39267429e6.png)

## JomNaSae Main Page
![main](https://user-images.githubusercontent.com/88031716/228534048-52e7e6cb-755a-404d-9302-15b5d5cb0cfe.gif)

### 기능별 소개

봉사 자동 매칭



![봉사 성향 테스트](https://user-images.githubusercontent.com/88031716/228540661-879cb369-5460-4a1c-980d-c7dcb1d0ca21.gif)

- 사용자가 어떤 봉사가 사용자한테 맞을지 궁금할때 봉사 자동 매칭 기능으로 봉사를 추천해 줄 수 있습니다.

봉사 등록 및 관리



![봉사등록 및 관리](https://user-images.githubusercontent.com/88031716/228536375-c1f90888-74fa-4bfe-a9d6-7b51955ffbfc.gif)

- 기관으로 회원가입후, 메인 네비게이션에서 봉사활동 등록하기를 클릭해 봉사활동을 등록 할 수 있습니다.

- 로그인후 메인 네비게이션에서 마이페이지에서 내 게시물 관리, 등록된 봉사활동의 신청자를 조회 할 수 있습니다.

봉사 조회



![봉사 조회](https://user-images.githubusercontent.com/88031716/228537703-04117ea5-d2da-4104-a416-7eefe576580f.gif)

- 사용자가 봉사 카테고리(어린이, 장애인, 노인, 동물, 환경)을 클릭하여 카테고리에 맞는 봉사활동을 조회할 수 있습니다.
- 사용자가 검색창에 봉사명 혹은, 지역별로 필터링 하여 봉사활동을 조회 할 수 있습니다.

봉사 신청



![봉사 신청](https://user-images.githubusercontent.com/88031716/228538391-074a4954-d976-4f94-9aac-78722c94e7bd.gif)

- 로그인한 사용자가 원하는 봉사활동을 클릭하여, 봉사활동 상세에 나도 할래 버튼을 클릭하면 신청이 가능합니다.
- 로그인한 사용자가 마이페이지에서 봉사활동을 신청한 봉사활동을 관리, 취소가 가능합니다.
- 봉사신청 완료후 봉사를 참가 하게 되면 봉사점수를 얻게 되며 봉사 상세에서 후기를 작성 할 수 있습니다.

봉사 그룹 개설



![봉사 그룹 개설](https://user-images.githubusercontent.com/88031716/228539300-04d82a04-038f-4dbe-9a53-76016cb8cb8b.gif)

- 봉사 포인트가 15점인 사용자가 그룹을 개설 할 수 있으며, 그룹을 개설하게 되면 그룹장 뱃지를 얻게 됩니다.
- 봉사 성향이 비슷한 사용자 끼리 만나 커뮤니티를 형성 할 수 있습니다.

봉사 그룹 참여



![봉사 그룹 참여](https://user-images.githubusercontent.com/88031716/228540053-66a61556-9940-4acc-a87d-ec2c367bb497.gif)

- 로그인한 사용자가 메인 네비게이션 메뉴에서 커뮤니티를 클릭후 원하는 그룹을 선택해 함께 하기 버튼을 누르게 되면 가입이 됩니다.
- 그룹에 가입한 사용자는 그룹의 커뮤니케이션 기능인 댓글로 다른 사용자들과 소통이 가능 합니다.

## 🧑‍💻 Member
### 저희는 좀 더 나은 세상을 만들기 위해 모였습니다.

| [김민소
(BE, 팀장)](https://github.com/kms310272) | [강은서
(BE)](https://github.com/kdmstj) | [이우연
(BE)](https://github.com/2uyyn2) | [박주혁
(FE)](https://github.com/Juhyuk-Park) | [임성은
(FE, 부팀장)](https://github.com/Limcroco) | [장지우
(FE)](https://github.com/Juhyuk-Park) |
| :---: | :---: | :---: | :---: | :---: | :---: |
| 김민소 | 강은서 | 이우연 | 박주혁 | 임성은 | 장지우
|

- 커뮤니티
- 그룹 생성 및
로그인 한 사용자
그룹 가입 기능
- 그룹 조회 기능
- 그룹 가입한 회원 조회 기능
- 그룹 상세 댓글 기능

|

- AWS 배포 환경 구축
- 봉사 등록
- 등록된 봉사 관리 기능
-봉사 조회 기능
(필터,정렬,검색)
- 봉사 신청 기능
- 봉사 찜하기 기능
- 봉사 후기 작성 기능
-Github Actions 자동배포화

|

- 로그인 인증
(JWT 발급, 인증)
- OAuth2.0 로그인
(카카오)
- Spring Security
- 사용자 CRUD
- S3 이미지 업로드 관리

|

- 카카오로그인 구현
- 봉사매칭서비스 구현
- **Create** :봉사 신청, 찜하기- **Read** :봉사상세페이지- **Delete** :찜하기 취소

|

-로그인 전역 유지 구현-찜하기 유지- 필터,정렬 구현(카테고리,드롭다운)-테스트 기능 구현-모달구현(이미지프리뷰 외..)-페이지네이션 구현 - **Create** :댓글,봉사후기- **Read** :댓글,봉사후기,마이페이지- **Update** :댓글,봉사후기,마이페이지- **Delete** :봉사후기,댓글,마이페이지, 그룹페이지

|

- 메인 페이지 구현- About 페이지 구현- 404 페이지 구현- 전체 Form data 관리- Header, Footer 구현- 카카오 톡상담, 공유하기 연동- 봉사 검색- 필터 기능(내가 쓴 댓글)- 로딩 및 에러창 구현- **Create** : 로그인(기업, 개인),회원가입, 이미지(S3),봉사 등록, 그룹 등록- **Read** :봉사 목록, 그룹 목록,그룹 상세- **Update** : 회원정보 수정(기업, 개인)- **Delete** : 회원 탈퇴기능


## ⚙️ **Tools**
| Github | Discord |Notion|ZEP|
| :---: | :---: |:---:|:---:|
| github logo | Discord logo |Notion logo|ZEP logo|


### 🖥 **Front-end**
| Html | CSS | TypeScript | React | Styled-
Components | axios | prettier | ESLint | S3 |
| :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
| Html |

CSS
|

icon
|
icon
|
styled-components icon
|
|
icon
|
icon
|
icon
|


### 🔒 **Back-end**
| Java | mySQL | AWS | Spring | Spring
Boot | JWT|Spring
Security
| :---: | :---: | :---: | :---: | :---: | :---: | :---: |
|

icon
|
icon
|
icon
| spring logo | spring-boot logo | spring-boot logo| spring-boot logo|


## ⚙️ **Project Architecture**
![main (6)](https://user-images.githubusercontent.com/115993576/228547761-ca499f52-b86c-4285-b173-f8abb4a6dc9d.png)


## :notebook: Documentation
[사용자 요구사항 정의서](https://docs.google.com/spreadsheets/d/1a2mPp-aHX2ZtKxpZODTXdB32jx8wEgU-qwEKKoZK96E/edit?usp=sharing)

[화면 정의서](https://docs.google.com/spreadsheets/d/1diyZCDXtD4uy7uxghARHBWdQ6GP7Xe6cHnMXqCVPTbE/edit?usp=sharing)

[테이블 명세서](https://docs.google.com/spreadsheets/d/1bZMTka87Bo2Xr0J5iPaPhBehiibfbZURot4m6X12Cs8/edit?usp=sharing)

[ERD](https://dbdiagram.io/d/64058b2e296d97641d85a3df)

[API 명세서](https://documenter.getpostman.com/view/24688542/2s93JutNq9#a7c2003a-7e01-4dfb-8059-361cae7af8f2)

[개발자 테스트 체크 리스트](https://codestates.notion.site/741862f21b964b7e8ce68d86d9c5cdc6)


## :sloth: Git
### :wood: Branch
`main` : 배포 브랜치

`release` : 메인 브랜치 배포전 테스트 브랜치

`feat/역할군/개발명` : 기능 개발 브랜치 ex) feat/FE/Askquestion
`test/역할군/테스트명` : 기능 테스트 브랜치 ex) feat/BE/voluteer


### ✉️ Commit Message

|Message|설명|
|:---:|:---|
|[feat]|새로운 기능을 추가할 경우|
|[fix]|버그를 고친 경우|
|[design]|CSS 등 사용자 UI 디자인 변경|
|[style]|코드 포맷변경, 세미콜론 누락, 코드수정이 없는 경우.|
|[refactor] |프로덕션 코드 리펙토링할 경우|
|[comment]|필요한 주석 추가 및 변경|
|[docs]|문서를 수정한 경우|
|[test]|테스트 코드 작업을할 경우|
|[chore]|빌드 테스트 업데이트, 패키지 매니저를 설정하는 경우|
|[rename]|파일 혹은 폴더명을 수정하거나 옮기는 작업만 하는 경우|
|[remove]|삭제하는 작업만 수행한 경우|
|[init]|브랜치 초기화 및 초기셋팅 관련된 설정일 경우|