https://github.com/codestates-seb/seb42_main_014
봉사활동 플랫폼, 좀 더 나은 세상
https://github.com/codestates-seb/seb42_main_014
Last synced: about 1 year ago
JSON representation
봉사활동 플랫폼, 좀 더 나은 세상
- Host: GitHub
- URL: https://github.com/codestates-seb/seb42_main_014
- Owner: codestates-seb
- Created: 2023-03-02T02:14:41.000Z (about 3 years ago)
- Default Branch: dev
- Last Pushed: 2023-04-27T06:06:39.000Z (about 3 years ago)
- Last Synced: 2025-04-13T01:42:29.634Z (about 1 year ago)
- Language: TypeScript
- Homepage: http://main014-bucket.s3-website.ap-northeast-2.amazonaws.com
- Size: 39.5 MB
- Stars: 5
- Watchers: 2
- Forks: 2
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
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

## JomNaSae Main Page

### 기능별 소개
봉사 자동 매칭

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

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

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

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

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

- 로그인한 사용자가 메인 네비게이션 메뉴에서 커뮤니티를 클릭후 원하는 그룹을 선택해 함께 하기 버튼을 누르게 되면 가입이 됩니다.
- 그룹에 가입한 사용자는 그룹의 커뮤니케이션 기능인 댓글로 다른 사용자들과 소통이 가능 합니다.
## 🧑💻 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|
| :---: | :---: |:---:|:---:|
|
|
|
|
|
### 🖥 **Front-end**
| Html | CSS | TypeScript | React | Styled-
Components | axios | prettier | ESLint | S3 |
| :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
|
|
|
|
|
|
|
|
|
|
### 🔒 **Back-end**
| Java | mySQL | AWS | Spring | Spring
Boot | JWT|Spring
Security
| :---: | :---: | :---: | :---: | :---: | :---: | :---: |
|
|
|
|
|
|
|
|
## ⚙️ **Project Architecture**

## :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]|브랜치 초기화 및 초기셋팅 관련된 설정일 경우|