diff --git a/README.md b/README.md index 7ab3255..7335a0b 100644 --- a/README.md +++ b/README.md @@ -1,61 +1,105 @@ -# Commit Convention - -컨벤션 규칙은 프로젝트가 마무리되면 삭제하고 팀원 및 프로젝트 소개만 남길 예정입니다. - ---- -commit message 구조 : 제목(필수), 본문, 꼬릿말 형식 -```javascript -[][optional scope]: - -[optional body] - -[optional footer(s)] -``` - -type은 반드시 작성하며 첫글자는 대문자로 작성합니다. 다음 값 중 하나를 선택합니다. -``` -feat: 새로운 기능 추가 -fix: 버그 수정 -docs: 문서 수정 -style: 코드 포맷팅, 세미콜론 누락 등 코드 변경이 없는 경우 -refactor: 코드 리팩토링 -test: 테스트 코드 추가, 리팩토링 (프로덕션 코드 변경 없음) -chore: 빌드 업무 수정, 패키지 매니저 수정 등 (코드 변경 없음) -``` - -`` 다음에는 선택적으로 ``를 작성할 수 있습니다. 변경한 부분 등을 명시할 때 사용합니다. - -``은 변경 사항의 간단한 요약을 작성합니다. 예를 들어, "로그인 기능 추가"와 같이 변경 내용을 간단히 요약합니다. - -`[optional body]`는 변경 사항에 대한 자세한 내용을 작성하는 부분입니다. 이 부분은 생략할 수 있습니다. - -`[optional footer(s)]`는 이슈 트래커 ID나 참조 등을 작성하는 부분입니다. 이 부분도 생략 가능합니다. 다음의 규칙을 지킵니다. -``` -꼬리말은 "유형: #이슈 번호" 형식으로 사용한다. -여러 개의 이슈 번호를 적을 때는 `쉼표(,)`로 구분한다. -이슈 트래커 유형은 다음 중 하나를 사용한다. -- Fixes: 이슈 수정중 (아직 해결되지 않은 경우) -- Resolves: 이슈를 해결했을 때 사용 -- Ref: 참고할 이슈가 있을 때 사용 -- Related to: 해당 커밋에 관련된 이슈번호 (아직 해결되지 않은 경우) -ex) Fixes: #45 Related to: #34, #23 -``` - - ---- -commit convention을 고려한 commit 작성 예시 -``` -: (예: feat: 회원가입 기능 추가) -: (예: docs: README 이미지 추가) -[]: (예: docs[README]: 프로젝트 소개 업데이트 -: (예: chore: 패키지 의존성 -``` - - - - - -참고: https://velog.io/@shin6403/Git-git-%EC%BB%A4%EB%B0%8B-%EC%BB%A8%EB%B2%A4%EC%85%98-%EC%84%A4%EC%A0%95%ED%95%98%EA%B8%B0 - - - +# Passionroad (열정도) + +**팀원 : 김재구, 김태영, 한우창, 한현우** + +**프론트 : 한우창, 김재구** +**백엔드 : 한현우, 김태영** + + +## 소개 + + **화상채팅을 활용한 비대면 스터디, 팀프로젝트 플랫폼** + + 코로나로 인한 팬데믹 이후 많은 활동이 비대면에서 이루어지고 있습니다. 강의, 스터디, 팀프로젝트도 예외는 아니었습니다. 줌, WebEx등의 화상채팅 프로그램을 활용하는 사례가 늘었고 이에 대한 사람들의 선호도도 높아졌습니다. 하지만, 함께할 사람들을 모으고 쉽게 정보를 공유할 공간이 마련되어 있지는 않았습니다. + 우리는 기존의 화상채팅 프로그램을 개선하여 정보를 공유하고 사람을 모을 수 있는 게시판과 자신의 일정을 기록할 수 있는 캘린더를 추가한 웹 서비스를 구현하기로 하였습니다. + +## 목표 + + 1. 비대면 환경에서 다른 사람과의 원격 화상채팅 제공 + 2. 사람들과 소통할 수 있는 게시판 제공 + 3. 자신의 공부시간, 작성한 게시글, 참여하고있는 스터디 등을 확인할 수 있는 대시보드 제공 + 4. 자신의 일정을 기록할 수 있는 캘린더 제공 + +## 시연 화면 + +| 홈페이지 | 화상채팅 | +|---------|---------| +| 홈페이지 | 화상채팅화면 + +| 대시보드 | 캘린더 | +|---------|-------| +|대시보드|캘린더| + +| 게시판 | 게시글조회 | +|-------|-----------| +|게시판|게시글조회| + +## 프로젝트 구조 + +![프로젝트구조](https://github.com/hyeonwoo-han/2023-hansung-capstone/assets/53888037/22b312d4-16ab-4d89-a5e2-bf160f580a6c) + +## 사용언어 및 기술 +* Language : Java / Javascript / SQL +* OS : Windows / Mac / Linux Ubuntu (AWS EC2) +* Framework & Library : React / Tailwind / Recoil / Spring Boot / QueryDSL / OpenVidu +* Tool : intelliJ / VSCode / Docker / MariaDB + + + + +## 배포 +* **도메인 구입, HTTPS SSL 인증서발급** +* **OpenVidu 도커 컨테이너 실행** +* **Nginx ( React )** + * Nginx 설치 + * 설치 경로로 이동 + * `cd /etc/nginx/sites-available` + * default 설정 삭제 + * 새로운 sites-available 설정파일 작성 + ``` + server { + + location / { + root [리액트앱 빌드파일 경로]; + index index.html index.htm; + try_files $uri $uri/ /index.html; # 파일이 존재하지 않을 시 index.html로 redirect + } + + location /api { + proxy_pass https://[스프링 API 서버 ip]:[포트번호]; + } + + listen 443 ssl; # managed by Certbot + ssl_certificate /etc/letsencrypt/live/[도메인주소]/fullchain.pem; # managed by Certbot + ssl_certificate_key /etc/letsencrypt/live/[도메인주소]/privkey.pem; # managed by Certbot + # include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot + # ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot + } + + server { + if ($host = [도메인주소]) { + return 301 https://$host$request_uri; + } # managed by Certbot + + listen 80; + server_name [도메인주소]; + return 404; # managed by Certbot + } + ``` + * sites-enabled 에 심볼릭 링크 생성 + * `sudo ln -s /etc/nginx/sites-available/[설정파일이름] /etc/nginx/sites-enabled` + * nginx 시작 + * `sudo systemctl start nginx.service` + + +* **Tomcat ( Spring API 서버 )** + * Spring Boot 의 내장 Tomcat 사용 + * 프로젝트 루트 위치로 이동 + * 테스트 없이 빌드 : + * `./gradlew clean build -x test` + * 빌드 파일 위치로 이동 + * `cd build/libs` + * 빌드 배포 + * `nohup java -jar [file name].jar &` + * 로그 확인 + * `cat nohup.out`