Algoy-Web

Algoy Web Repository

Stars
2

high-five(Algoy)

목차

1. 프로젝트 소개 2. 팀 편성 3. 개발 기간 4. 기술 스택 5. 프로젝트 구조 6. 아키텍처 7. UI 설계 8. 기능 명세 9. API 명세 10. ERD 11. Trouble Shooting 12. 프로젝트 회고

1. 프로젝트 소개

이 프로젝트는 Alan API를 활용한 코딩 테스트 전용 플래너 오답노트 서비스입니다. 여러 코딩 테스트 관리를 한 곳에서, 플래너와 오답노트를 같이 이용할 수 있습니다. 또한, ESTsoft에서 제공하는 Alan AI를 통해 맞춤형 문제를 제공받을 수 있습니다.

배포 URL: http://43.203.144.232/algoy/home

관리자용 계정

테스트용 계정

2. 팀 편성

지승우 김주영 김창섭 성창용 안유석 조아라
팀장 팀원 팀원 팀원 팀원 팀원
챗봇 기능 구현채팅 기능 구현CI/CD 설정 로그인 구현회원 정보 수정 구현회원 탈퇴 구현홈화면 구현 플래너 구현스터디 구현 오답노트 구현 Security회원가입 구현비밀번호 찾기 구현관리자 화면 구현 AI 문제 추천 기능 구현CI/CD 배포 및 Nginx 설정서버 환경 구축

3. 개발 기간

프로젝트 일정: 08/19 (월) ~ 09/12 (목) 프로젝트 발표: 09/13 (금)

4. 기술 스택

[Front_end] [Back_end] [DB] [IDE] [버전 관리] [협업 도구] [개발 환경 및 도구] [서버 및 배포]

5. 프로젝트 구조

├─main
│  ├─generated
│  ├─java
│  │  └─com
│  │      └─example
│  │          └─algoyweb
│  │              ├─config # 애플리케이션 설정 파일
│  │              │  └─chatting
│  │              ├─controller # 컨트롤러 클래스 (클라이언트 요청 처리)
│  │              │  ├─allen
│  │              │  ├─chatting
│  │              │  ├─planner
│  │              │  ├─study
│  │              │  ├─temp
│  │              │  ├─user
│  │              │  └─WrongAnswerNote
│  │              ├─exception # 예외 처리
│  │              │  ├─chatting
│  │              │  ├─errorcode
│  │              │  └─user
│  │              ├─model # 데이터 모델 정의
│  │              │  ├─dto # 데이터 전송 객체
│  │              │  │  ├─allen
│  │              │  │  ├─auth
│  │              │  │  ├─chatting
│  │              │  │  ├─comment
│  │              │  │  ├─planner
│  │              │  │  ├─study
│  │              │  │  ├─user
│  │              │  │  └─WrongAnswerNote
│  │              │  └─entity # 엔티티
│  │              │      ├─allen
│  │              │      ├─auth
│  │              │      ├─chatting
│  │              │      ├─planner
│  │              │      ├─study
│  │              │      ├─user
│  │              │      └─WrongAnswerNote
│  │              ├─repository # 레포지토리
│  │              │  ├─allen
│  │              │  ├─chatting
│  │              │  ├─planner
│  │              │  ├─study
│  │              │  ├─user
│  │              │  └─WrongAnswerNote
│  │              ├─service # 서비스 클래스 (비즈니스 로직 처리)
│  │              │  ├─allen
│  │              │  ├─auth
│  │              │  ├─chatting
│  │              │  ├─planner
│  │              │  ├─study
│  │              │  ├─user
│  │              │  └─WrongAnswerNote
│  │              └─util  # 유틸리티 클래스 (공통 기능 제공)
│  │                  ├─chatting
│  │                  ├─user
│  │                  └─WrongAnswerNote
│  └─resources
│      ├─static # 정적 파일 (CSS, JavaScript, 이미지)
│      │  ├─css
│      │  │  ├─allen
│      │  │  ├─fragments
│      │  │  ├─home
│      │  │  ├─mypage
│      │  │  ├─password
│      │  │  ├─planner
│      │  │  ├─signup
│      │  │  ├─study
│      │  │  ├─user
│      │  │  └─wronganswernote
│      │  ├─img
│      │  └─js
│      │      ├─fragments
│      │      ├─graph
│      │      ├─mypage
│      │      ├─planner
│      │      ├─signup
│      │      ├─study
│      │      ├─user
│      │      └─wronganswernote
│      ├─templates # 템플릿 파일 (HTML)
│      │  ├─fragments
│      │  ├─mypage
│      │  ├─password
│      │  ├─planner
│      │  ├─signup
│      │  ├─study
│      │  ├─temp
│      │  ├─user
│      │  └─wronganswernote
│      └─application.yml # 애플리케이션 설정 파일 (예: 데이터베이스, 서버 포트, 프로파일 설정 등)

6. 아키텍처

7. UI 설계

algoy-figma

홈 화면 회원가입
home signup
비밀번호 찾기: 본인확인 비밀번호 찾기: 비밀번호 재설정
find_pw find_pw
로그인 구글 로그인
login login_google
스터디 모집 목록 스터디 모집 작성
study study
스터디 모집 상세보기 스터디 모집 수정
study study
플래너 목록 플래너 작성
planner planner
플래너 수정 플래너 모달
planner planner
오답노트 목록 오답노트 작성
wrong answer note wrong answer note
오답노트 상세보기 오답노트 수정
wrong answer note wrong answer note
오답노트: 코드 추가 마이페이지
wrong answer note
회원정보 수정 회원 탈퇴
user edit user delete
계정 복구 관리자 페이지
account recovery admin page
유저 정지: 정지 사유 입력
user ban reason

8. 기능 명세

NAME은 컨트롤러에서 만든 메서드명 작성

chatting

🏷NAME ⚙METHOD 📎URL 📖DESCRIPTION
getRooms GET /algoy/apo/chat/rooms 채팅방 목록 가져오기
getRoomMessages GET /algoy/apo/chat/room/{roomId}/messages 채팅 내역 가져오기
createRoom POST /algoy/apo/chat/room 채팅방 생성
joinRoom POST /algoy/apo/chat/room/{roomId}/join 채팅방 참여
leaveRoom POST /algoy/apo/chat/room/{roomId}/leave 채팅방 나가기
inviteToRoomByNickname POST /algoy/apo/chat/room/{roomId}/invite-by-nickname 채팅방에 초대

chat bot

🏷NAME ⚙METHOD 📎URL 📖DESCRIPTION
solvedac GET /algoy/allen/solvedac solvedAC 기반으로 문제 추천 받기
chatPage GET /algoy/chatbot-demo 챗봇 페이지

wrong answer note

🏷NAME ⚙METHOD 📎URL 📖DESCRIPTION
getAllWrongAnswerNotes GET /algoy/commit 오답 노트 조회
getWrongAnswerNoteById GET /algoy/commit/{id} 오답 노트 상세보기
createWrongAnswerNoteForm GET /algoy/commit/create 오답 노트 작성 폼
createWrongAnswerNote POST /algoy/commit/create 오답 노트 작성하기
editWrongAnswerNoteForm GET /algoy/commit/{id}/edit 오답 노트 수정 폼
updateWrongAnswerNote POST /algoy/commit/{id}/edit 오답 노트 수정하기
deleteWrongAnswerNote POST /api/algoy/commit/{id} 오답 노트 삭제하기
getCodesByWrongAnswerNoteId GET /api/codes/{wrongAnswerNoteId} 오답 노트 코드 목록
saveCode POST /api/codes 오답 노트 코드 작성하기
updateCode PUT /api/codes/{codeId} 오답 노트 코드 수정하기
deleteCode DELETE /api/codes/{codeId} 오답 노트 코드 삭제하기

planner

🏷NAME ⚙METHOD 📎URL 📖DESCRIPTION
getCalender GET /algoy/planner 캘린더 월 별 조회
getPlan GET /algoy/planner/{id} 플랜 상세 보기
saveForm GET /algoy/planner/save-form 플랜 생성 폼
savePlan POST /algoy/planner/save 플랜 생성
editForm GET /algoy/planner/edit-form 플랜 수정 폼
editPlan POST /algoy/planner/edit/{id} 플랜 수정
deletePlan POST /algoy/planner/delete/{id} 플랜 삭제
search GET /algoy/planner/search 플랜 검색
viewMain GET /algoy/planner/main 플래너 메인 페이지
getPlanner GET /algoy/planner/get/plans 유저의 전체 플래너 조회

study

🏷NAME ⚙METHOD 📎URL 📖DESCRIPTION
getStudyList GET /algoy/study/gets 게시물 목록 조회
getStudy GET /algoy/study/get/{id} 게시글 조회
getNew GET /algoy/study/new-form 게시글 작성 폼
createStudy POST /algoy/study/new 게시글 작성
getEdit GET /algoy/study/edit-form 게시글 수정폼 조회
updateStudy POST /algoy/study/update/{id} 게시물 수정
deleteStudy POST /algoy/study/delete/{id} 게시물 삭제

comment

🏷NAME ⚙METHOD 📎URL 📖DESCRIPTION
getComments GET /algoy/comment/gets 댓글 조회
createNonReply POST /algoy/comment/reply 댓글 작성
updateComment POST /algoy/comment/update 댓글 수정
deleteComment POST /algoy/comment/delete 댓글 삭제

mypage

🏷NAME ⚙METHOD 📎URL 📖DESCRIPTION
GET /algoy/user 마이페이지
editForm GET /algoy/user/edit 회원 정보 수정 폼
updateUser POST /algoy/user/update 회원 정보 수정
deleteForm GET /algoy/user/delete 회원 탈퇴 폼
deleteRequest POST /algoy/user/delete 회원 탈퇴
getUserNickname GET /algoy/user/nickname 닉네임 표시
restoreAccountPage GET /algoy/user/restore 계정 복구

user

🏷NAME ⚙METHOD 📎URL 📖DESCRIPTION
showSignUpForm GET /algoy/sign 회원 가입 폼
signUp POST /algoy/sign 회원 가입
checkEmailDuplicate POST /algoy/check-email-duplicate 이메일 중복 확인
checkNicknameDuplicate POST /algoy/check-nickname-duplicate 닉네임 중복 확인
showLoginForm GET /algoy/login 로그인 폼
showFindPasswordPage GET /algoy/find-password 비밀번호 찾기 폼
findPassword POST /algoy/find-password 비밀번호 찾기
setPasswordPage GET /algoy/set-password 비밀번호 재설정 폼
setPassword POST /algoy/set-password 비밀번호 재설정
showAdminPage GET /algoy/admin 관리자 페이지 폼
changeUserRole POST /algoy/admin/role-control 유저 권한 변경

9. API 명세

카테고리 요구사항명 Method URL 비고
HOME 홈 화면 GET /algoy/home 홈 화면
QUIZ NOTE 오답 노트 조회 GET /algoy/commit
오답 노트 상세보기 GET /algoy/commit/{id}
오답 노트 작성 폼 GET /algoy/commit/create
오답 노트 작성하기 POST /algoy/commit/create
오답 노트 수정 폼 GET /algoy/commit/{id}/edit
오답 노트 수정하기 POST /algoy/commit/{id}/edit
오답 노트 삭제하기 POST /api/algoy/commit/{id}
오답 노트 코드 목록 GET /api/codes/{wrongAnswerNoteId}
오답 노트 코드 작성하기 POST /api/codes
오답 노트 코드 수정하기 PUT /api/codes/{codeId}
오답 노트 코드 삭제하기 DELETE /api/codes/{codeId}
PLANNER 캘린더 월 별 조회 GET /algoy/planner
플래너 메인 페이지 GET /algoy/planner/main
투두리스트 검색 GET /algoy/planner/search
유저의 투두리스트 조회 GET /algoy/planner/get/plans
투두리스트 상세보기 GET /algoy/planner/{id}
투두리스트 생성폼 GET /algoy/planner/save-form
투두리스트 생성 POST /algoy/planner/save
투두리스트 수정 폼 GET /algoy/planner/edit-form
투두리스트 수정 POST /algoy/planner/edit/{id}
투두리스트 삭제 POST /algoy/planner/delete/{id}
MY PAGE 회원 정보 수정 폼 GET /algoy/user/edit
회원 정보 수정 POST /algoy/user/update
회원 탈퇴 폼 GET /algoy/user/delete
회원 탈퇴 POST /algoy/user/delete 소프트 딜리트
닉네임 표시 GET /algoy/user/nickname
계정 복구 폼 GET /algoy/user/restore
계정 복구 POST /algoy/user/restore
USER 로그인 폼 GET /algoy/algoy/login
로그아웃 GET /algoy/logout
회원 가입 폼 GET /algoy/sign
회원 가입 POST /algoy/sign
e-mail 중복 확인 POST /algoy/check-email-duplicate
닉네임 중복 확인 POST /algoy/check-nickname-duplicate
비밀번호 찾기 폼 GET /algoy/find-password
비밀번호 찾기 요청 POST /algoy/find-password
비밀번호 재설정 폼 GET /algoy/set-password
비밀번호 재설정 요청 POST /algoy/set-password
현재 인증된 사용자 정보 GET /algoy/api/user/current
관리자 페이지 GET /algoy/admin
유저 권한 관리 POST /algoy/admin/role-control 관리자, 일반, 정지
STUDY 스터디 메인 GET /algoy/study/main
스터디 목록 GET /algoy/study/gets
스터디 상세 보기 GET /algoy/study/detail
스터디 게시물 가져오기 GET /algoy/study/get/{id}
스터디 작성 폼 GET /algoy/study/new-form
스터디 작성 POST /algoy/study/new
스터디 삭제 POST /algoy/study/delete/{id}
스터디 수정 폼 GET /algoy/study/edit-form
스터디 수정 POST /algoy/study/update/{id}
스터디 인원 GET /algoy/study/count
스터디 상태로 검색 GET /algoy/study/search-status
COMMENT 댓글 가져오기 GET /algoy/comment/gets
댓글 POST /algoy/comment/non-reply
대댓글 POST /algoy/comment/reply
댓글 수정하기 POST /algoy/comment/update
댓글 삭제하기 POST /algoy/comment/delete
스터디 참여 POST /algoy/comment/join
스터디 탈퇴 POST /algoy/comment/out
댓글 내용 검색 GET /algoy/comment/find-part
댓글 작성자 검색 GET /algoy/comment/find-user
CHATTING 채팅방 목록 가져오기 GET /algoy/api/chat/rooms
채팅 내역 가져오기 GET /algoy/api/chat/room/{roomId}/messages
채팅방 생성 POST /algoy/api/chat/room
채팅방 참여 POST /algoy/api/chat/room/{roomId}/join
채팅방 나가기 POST /algoy/api/chat/room/{roomId}/leave
채팅방에 초대 POST /algoy/api/chat/room/{roomId}/invite-by-nickname
CHAT BOT solvedAC 기반 문제 추천 GET /algoy/allen/solvedac
챗봇 페이지 GET /algoy/chatbot-demo

10. ERD

erd-cloud algoy erd

11. Trouble Shooting

김주영

로그인 트러블 슈팅

  1. 페이지 무한 리디렉션
    • "리디렉션한 횟수가 너무 많습니다"라는 오류 메시지와 함께 로그인 페이지가 제대로 표시되지 않는 문제가 발생했습니다.
    • 이 문제는 Spring Security가 자동으로 POST 요청을 처리하기 때문에, 별도로 @PostMapping을 Controller에 추가할 필요가 없다는 점을 간과하여 발생했습니다. 이를
      해결하기 위해 @PostMapping 어노테이션을 제거했습니다.
  2. 화이트라벨 오류 발생
    • 설정 파일에서 지정된 로그인 URL이 잘못 입력되어 발생한 오류였습니다. Controller에 올바르게 매핑된 URL을 입력하여 문제를 해결했습니다.
  3. Invalid email or password
    • 로그인 실패 시 "Invalid email or password" 메시지가 출력되도록 설정했으나, 문법적 오류는 발견되지 않았습니다.
    • 이 과정에서, Spring Security의 UserDetailsService가 이메일로 사용자 객체를 찾고, 비밀번호를 비교하여 URL을 반환하는 구조를 이해했습니다.
      • email을 입력 받으면 DetailService에서 객체를 찾고 객체를 Spring Security가 읽고 비교해서 url을 반환하는 구조라고 생각했다.
      • email로 객체를 찾았지만 password를 비교하는 로직이 없다고 생각하여 추가해야하나? 생각했지만, Spring Security는 자동으로 비밀번호 비교를 처리하기 때문에, 추가적인 로직이
        필요 없다는 것을 확인했습니다.
      • security관련 Debug를 보고 싶어서 yml 파일에 security: DEBUG를 추가하여 디버깅을 진행했으며, "Failed to find user"라는 로그가 출력되었습니다.
      • password가 security에 의해 암호화된 채 mysql에 저장 되도록 설정하고, 데이터를 읽을 때도 암호화하여 읽으므로 local MySQL에 저장된 password를
        BCryptPasswordEncoder 형식으로 바꾸어 저장했습니다.
      • 여전히 실행이 안되어서 다른 방향을 찾다가, 로그인 폼의 필드 이름이 Spring Security의 기본 요구 사항과 일치하는지! 확인을 해보았다.
      • 작성한 로그인 폼이 name이 email로 되어있던 것. name을 username으로 변경해주니
        로그인 문제를 해결할 수 있었습니다.

항상 오타에 주의하자

  1. 캘린더 API를 로드하는 과정에서 302 및 404 오류가 발생했습니다.
    • 302 오류는 config에서 permitAll을 추가해 보았으나, 필요 없는 설정이었습니다.
  2. 404 에러
    • 둘다 외부 파일로 분리해두었는데, 이렇게 써놨던 것… <script *th:src*="@{/calendar.global.js}"></script> ← js 디렉토리 설정을 안함(그래서 url
      주소로 인식한 것 같다.) <script *th:src*="@{/js/calendar/add-events.js}"></script> ← event로 해놓고 events라고 작성.
    • 올바르게 수정하니 <script *th:src*="@{/js/calendar/calendar.global.js}"></script>
      <script *th:src*="@{/js/calendar/add-event.js}"></script> API를 무사히 가져올 수 있었습니다.

로그인시 탈퇴 유저인지 확인 후 복구 페이지로 리다이렉트

  1. 복구를 물어보는 html에서는 post method를 사용하여 쉽게 이동이 가능했는데, 로그인 시 /login으로 이동하며 500에러가 발생했다.
    • authorize처럼 html에서 isDeleted를 처리할 수 있지 않을까? 했지만 오류가계속 발생했고 좋은 방법이 아닌 것 같았다.
    • 해결 방법을 찾아 보다가 로그인 관련은 security에서 처리가 되므로 Handler가 필요하다는 글을 보았다.
  2. Handler를 작성하고 config에 주입하였으나 순환참조 오류가 발생했다.
    • 기존에 어노테이션을 통해 생성자 주입을 했었는데 이를 해결하기 위해 @Lazy 어노테이션을 사용하여 순환 참조 문제를 해결하였습니다.
      • 이 방법이 최선인지에 대한 의문은 남습니다.

탈퇴 요청 시 로그아웃이 안되는 현상

  • 디버그 로그를 보니까 remeber-me 설정이 되어 있다는 로그가 있었다.
  • 아무리 생각해도 순서가 반대인 것 같았다. 로그아웃이 되지 않아 remember-me가 유지되는 것 같았다.
  • 검색해보니 탈퇴 처리 후 SecurityContextHolder.clearContext(); 이 코드를 꼭 작성해주어야 한다고 한다.
  • controller, service 둘 다 추가해보았으나 여전히 로그아웃이 되지 않았다.
  • 검색해보니 service에서 쿠키를 명시적으로 삭제하는 방법도 있다고 하여 이 방법을 사용해 보았다.
  • 결과적으로 잘 처리 되었으나, 이 방법 역시 좋은 해결 방법인지는 모르겠어서 아쉬운 부분이다.

로그인과 회원가입 병합

  1. 회원가입 에러 발생

    • 유석님이 작성한 코드와 제가 작성한 코드를 병합하는 과정에서 회원가입이 되지 않는 에러가 발생했습니다. 초기에는 토큰 변경을 시도했지만, 보안이 아직 중요하지 않은 상태였기 때문에 토큰을 사용하지 않는
      방향으로
      설정을 조정했습니다. 이 과정에서도 별다른 효과가 없었습니다.
  2. 순환 참조 문제

    • 로그인 시 UserServiceConfig 파일 간의 순환 참조 문제로 인해 UserDetailsService 클래스를 별도로 작성하였습니다. 하지만,
      UserDetailsService는 Spring
      Security에서 제공하는 인터페이스로, 이를 구현하기 위해 UserService에서 UserDetailsService를 구현하도록 수정하였습니다. 이 수정에도 불구하고 회원가입은
      여전히 실패했습니다.
  3. 회원가입 시 비밀번호 오류

    • 회원가입 시 "Cannot invoke 'String.equals(Object)' because the return value of 'UserDto.getPassword()' is null"이라는 오류가
      발생하였습니다. UserDtogetPassword() 메서드가 null을 반환하는 문제를 해결하기 위해 비밀번호가 null인지 확인하는 로직을 추가했으나,
      여전히 비밀번호가 null로 반환되었습니다.
      User
      엔티티의 password 컬럼이 nullable=true로 설정되어 있어도 객체 생성이 실패하는 문제가 발생했습니다. 이로 인해 객체 생성에 문제가 있는지 의심하였으나, 아무런 에러나
      오류 메시지가
      출력되지 않아
      디버깅에 어려움을 겪었습니다.
    • 필드 이름 충돌 확인
      로그인 폼의 name="username"User 엔티티의 username 컬럼 간의 충돌을 의심하여, usernamefirstname으로
      변경하였으나, 별다른 효과는 없었습니다.
    • 최종 해결책: 새로운 프로젝트와 코드 비교
      결국, 개발 브랜치를 다시 version control을 통해 받아와 새 프로젝트를 열고, 제가 작성한 로그인 코드를 기존 코드와 비교하여 붙여보기로 했습니다. 이 과정에서 회원가입은 성공적으로
      작동했지만
      로그인에는 여전히 문제가 발생했습니다. 이를 해결하기 위해 Config 파일과 UserService 파일을 통합하고, 유석님과 협력하여 PasswordEncoder
      UserService에서 생성자로
      주입받는
      방식으로 변경하였습니다. 또한, UserDetailsService 인터페이스에 대한 설명을 통해 로직을 명확히 정리하였습니다. 로직을 차근차근 검토한 결과, User에서 null 오류가
      해결되었습니다.

협업 및 팀 프로젝트 경험:

  • 이 과정에서 유석님과의 긴밀한 협업이 큰 도움이 되었습니다. 서로의 코드와 설정을 면밀히 검토하고 조율하는 과정에서 문제를 명확히 파악하고 해결하는 데 유용한 통찰을 얻었습니다. 협업을 통해 문제를
    공유하고 해결 방안을 모색하는 경험은 팀 프로젝트에서의 중요성을 새삼 느끼게 했습니다.

김창섭

Comment의 생명주기에 관한 시나리오를 가진 테스트를 작성 중에 Join과 Out에 대한 검증이 전부 다 같은 결과를 도출하는 것을 발견 -> 트랜잭션 분리 후 해결

대댓글 구현 시, 부모 자식 댓글 간의 연결 문제 -> 쿼리로 조건에 해당하는 코멘트를 모두 가져온 뒤 서비스 레이어에서 재조립

AOP 작성 중 작성한 AOP가 무한반복 되는 버그 -> 포인트 컷을 더 정확하게 작성

성창용

오답노트를 개인 게시판으로 전환하는 작업을 진행하던 중 INVALID_PARAMETER","message":"For input string: "[email protected] 오류 발생 User 엔티티와 WrongAnswerNote 엔티티 간의 관계를 추가하고 이메일을 User 객체로 참조하도록 수정하여 해결

안유석

  1. GitHub 푸시 거부 현상
    • 프로젝트를 시작하고 첫 커밋을 할 때 갑자기 푸시 거부가 떴다. remote를 찾을 수 없다는 것.
    • git remote -v 명령어를 실행해 보았는데 잘 연결되어 있었다.
    • 해결: git fetch를 실행 후 git push를 하니 해결되었다.
  2. Spring Security 권한 검사
    • .hasAnyAuthority("ROLE_NORMAL")) 같은 코드로 URL에 대해, "ROLE_NORMAL" 권한을 가진 사용자만 접근할 수 있도록 제한하려 했는데 이상하게도 모두가 접근이 되었다.
      찾아보니 Spring Security는 기본적으로 역할(Role)을 처리할 때 ROLE_ 접두사를 자동으로 붙이기에 Role.java를 수정해야겠다고 생각했다.
    • 해결: Role.java를 다시 한번 보니 NORMAL("NORMAL", "일반 사용자")로 되어 있어, NORMAL("ROLE_NORMAL", "일반 사용자")로 수정해 주니 해결되었다.
  3. oauth2 null point exception
    • 상황: 로컬에서 로그인 기능은 정상 작동하는 상태였다. 그러나 마이 페이지에서 닉네임이 표시되는 게 아닌 오류 메시지가 표시되었다.
      Cannot invoke "org.springframework.security.core.userdetails.UserDetails.getUsername()" because "user" is null]
      이에 확인해 보니 user 객체가 null 이어서 읽어 올 수 없다는 것.
    • 원인: CustomOAuth2UserService에서 OAuth2 인증 후 반환하는 사용자 객체(DefaultOAuth2User)가 문제였다.
    • 해결: OAuth2User와 UserDetails를 구현하는 CustomOAuth2User 클래스 정의 후 반환하여 해결
  4. 기타 다양한 오류
    • 프로젝트 마지막 주차에 원인 미상의 여러 가지 오류가 생겼다. 모두 내 로컬 환경에서 발생했는데 갑자기 회원가입이 안 되거나, 로그인 후 회원 정보 수정, 플래너 등 여러 가지 기능이 전부 안 되었다.
      다른 팀원들은 잘 되는 상태였고 나만 안 되어서 뭔가 이상했다. (따로 코드 수정은 없었다)
    • 해결: 창섭님의 제안으로 VSC를 통해 새롭게 클론 받아와 새로운 프로젝트에서 열어보니 모든 문제가 깔끔히 해결되었다. 로컬에서도 회원가입부터 플래너까지 모든 게 정상 작동하였다. 솔직히 아직도 뭐가
      문제인지는 모르겠다.
  5. 배포 환경에서 구글 로그인 안 되는 현상
    • 로컬에서는 잘 되는데 배포한 서버에서는 구글 로그인이 안 되는 현상이 발생했다.
    • 원인 추측: 배포 서버에서 환경 변수가 제대로 로드되지 않는 것으로 추정.
    • 현재는 미해결 상태.

조아라

기존 기능

  • AlAN AI에게 문제 추천 받는 기능이 비회원 접근도 가능했다.
  • 기존 로직은 사용자가 백준에서 문제를 풀때만 추천문제 갱신이 되어 서비스 측면에서 효율성이 낮다고 생각했다.

추가 개발

  • 로그인 성공 시 Handler가 작동하며 자동으로 ALAN API 호출을 하여 다수의 문제를 수신한다.
  • DB에 리스트로 저장하여 홈 화면 접속시 랜덤으로 한문제씩 화면에 보여준다.

트러블 슈팅

  • Handler 충돌
  • 기존 코드에서 개발 하는 중에 config 파일에 등록된 Handler에서 충돌 발생.
  • 회원 탈퇴 기능을 구현하던 팀원님의 코드와 충돌이 났으나, 해당 기능을 알지 못해 새로운 handler를 적용하였다.
  • 하지만 그 후에도 로그인 시 ALAN API를 받아오지 못하는 오류가 발생
  • 추후 팀원들과 상의 후 Handler의 중복성 문제를 파악하고 코드를 합치면서 해당 문제 해결

깨닫게 된 점

  • 코드를 통합할 시 코드 충돌날 수 있는 확률이 높기 때문에 각자 기능 개발할때 코드리뷰를 실행하며 해당 서비스 기능의 전체적인 로직을 파악하는 것이 중요하다는 사실을 깨달았습니다
  • 코드 통합 시 발생하는 충돌을 예방하기 위해 본인 코드에 대한 명확한 전달과 소통방식이 중요하다고 생각합니다.

문제 상황 : web-spring과 ai-spring을 각각 Github Actions로 CI/CD 자동 배포를 구현했다. 문제 : 두 개의 애플리케이션이 하나의 pid로 배포 진행이 되고 있었다. (편집됨)

첫 설정을 pid가 진행되고 있으면 삭제하고 새로운 pid 생성하게 코드를 짰는데 pid 이름 설정을 따로 하지 않아서 하나의 pid로 배포가 운영되고 있었다. 이렇게 된다면 각각의 애플리케이션 운영을 동시에 할 수 없다.

해결

  • 각각 yml 파일에 pid이름을 따로 설정했다.
    • ai-application → ai-pid
    • web-application → web-pid

상황 데모로 연동이 되었으니 Nginx 문제는 해결되었다고 생각하고 ai 레포와 web레포를 배포 후 Nginx를 통해 통신해 보았다.

  • ai 레포는 접근 성공
  • web 레포는 /login으로 자동 이동되면서 다시 에러가 발생하였다. (/web/planner/ 로 이동했는데)

문제 원격저장소에 올라온 코드를 보니 Security 의존성이 추가되어 사용되고 있었다. 로그인 기능이 구현되지 않은 현재 상황에서 자동으로 로그인으로 페이지가 이동한다고 했다. 문제는 /web으로 접근해야지 Nginx에서 8081을 찾아갈 수 있는데 자동으로 /login을 호출하기 때문에 config 파일을 구현해야하는 상황이었다. 문제 해결방법으로 web 쪽 url은 root(/)를 사용했을때 들어가는 해결책을 팀원들과 회의를 통해 찾았다

지승우

챗봇 마지막 응답을 받아오지 못함

  • 이 문제는 SSE 방식으로 Alan AI API에게 응답을 받아올 경우 마지막 응답까지 계속해서 일정 주기 단위로 문장이 끊겨서 전송되고 마지막 응답이 들어오는 JSON 형태로 값을 전달 받기 때문에 발생하는
    문제입니다.
  • 예를 들면, '안녕'이라는 응답이 {'type': 'continue', 'data': {'content': '안'}} {'type': 'continue', 'data': {'content': '녕'}}
    {'type': 'complete', 'data': {'content: '안녕'}}으로 들어옵니다.
  • 해결 방식: DB에 모든 메시지 정보 저장하면서 클라이언트 단에서만 마지막 응답을 띄우는 방식 -> 파싱한 마지막 메시지만 DB에 담고 그 내용을 클라이언트에 띄움.

챗봇 XSS 취약점 발견

  • 이 문제는 챗봇 출력에 마크 다운을 적용한 뒤, HTML 코드를 입력해보고 화면에 창이 뜨는 걸 확인하여 XSS에 취약점이 있다는 문제입니다.
  • 해결 방식:
    • 클라이언트 - HTML에 헤더에 DOMPurify 라이브러리 추가 및 Java Script에 살균 코드 추가
    • 서버 - Jsoup과 apache.commons.text의 StringEscapeUtils를 이용하여 입력 살균 역할을 하는 InputSanitizer 클래스 추가 후 컨트롤러에 입력 살균 코드 추가

배포 환경에서 포트 간 통신이 안됨

  • 로컬에서는 잘 되던 포트 간 SSE 통신이 배포 환경에서는 되지 않는 문제를 발견하였습니다. (500 에러)
  • 해결 방식:
    • WebConfig 문제일 것으로 추정한 뒤 localhost:${Port}로 설정하였습니다.
    • 그러나 해결이 안 되어서 NginX나 EC2 방화벽 문제인 줄 알고 서버 소유자 분을 통해 해당 설정을 확인 하였습니다. -> 해결 X
    • 다시 코드 문제로 추측하고, 이번엔 클라이언트에 backendUrl을 http://${IP}:${서버 Port}로 설정 하였습니다. -> (403 에러)
    • 상태 코드가 500에서 403으로 바뀐 것을 확인하고, WebConfig의 allowedOrigins를 http://${IP}로 수정하여 문제를 최종적으로 해결 하였습니다.

새로고침 혹은 페이지 전환 시 챗봇에서 이전 메시지 내용을 출력하지 못하는 문제와 채팅에서 사용자 정보를 기억하지 못하는 문제 발견

  • 해결 방식:
    • 이 문제들은 공통적으로 해당 세션에서 어떤 정보를 기억하지 못한다는 원인을 가지고 있습니다.
    • 따라서, 로컬 스토리지나 세션 스토리지 방식을 사용할 수 있었는데, 로컬 스토리지는 브라우저에서 영구적으로 데이터를 가지고 있는 것이므로 해당 상황에 적합하지 않았습니다.
    • 세션 스토리지 방식을 채택하여 이 문제를 해결하였습니다.

12. 프로젝트 회고

김주영

자체 평가 9점입니다! 사전 기획했던 부분을 최대한 수행했다는 점에 큰 점수를 주고 싶어요. 개인적으로 코드 퀄리티를 잡고 싶었는데 이 부분이 아쉽습니다. 팀원들이 다들 잘하셔서 자연스럽게 목표가 실재하는 수준으로 높아진 것 같은데 항상 빠른 피드백과 소통 주셔서 감사했습니다! 처음으로 자바를 배우는 도전 속에서 뿌듯함을 많이 느꼈던 프로젝트였고 아직은 공부가 더 필요하다는 생각이 들었습니다.

후기 제 몫을 다하는 게 목표였는데 지나고 보니 아쉬운 점이 또 남게 되네요..! 부족한 점이 많았지만, 의견에 귀 기울여주셔서 감사하고, 항상 잘한다는 칭찬 아낌없이 해주신 팀원 분들 덕분에 끝까지 마무리 할 수 있었습니다!! 그리고 수시로 들려서 피드백, 응원해주신 영진 멘토님께도 감사드립니다ㅎㅎ 마지막 프로젝트로 부트캠프가 끝났는데 계속해서 백엔드 공부, 취업까지 파이팅입니다!!!!! 꼭 같은 업종으로 취업해서 다시 만나요~ 더운 여름에 정말 고생 많으셨습니다!

김창섭

크게 어려운 점은 없었지만, 협업 과정에서 의견 조율에 대해서 협업 경험이 많이 부족한 탓인지 미숙한 점이 많이 드러났습니다. 종종, 소통이 제대로 이루어지지 않아서 일부 작업이 겹치는 일이 발생하기도 했습니다. 그래서 작업이 온전히 원활하게 이루어지진 못했지만, 그래도 조원들간의 협력을 통해서 어느정도 원활히 진행되었다는 점에 뿌듯했습니다. 학창 시절엔 협업 없이 대부분 혼자 작업하여 마무리 짓는 것이 많았는데. 오르미를 통해서 정말 다양한 분들과 협업하고 많은 경험을 쌓았습니다. 조원들 모두가 하시는 일 잘 되시길 기원합니다.

성창용

백엔드 개발에 관심이 생겨서 아무 지식 없이 무작정 뛰어들었는데 이번 부트 캠프를 선택하길 정말 잘했다고 생각이 드는 시간이었습니다. 수업을 듣고 혼자 공부를 하며 배우는 것도 많았지만 이번 프로젝트를 하며 정말 많이 배우고 감사한 시간이었습니다. 든든하고 좋은 팀원이 있다는 점만으로도 힘들 때마다 힘을 낼 수 있는 원동력이 되었고, 근 한 달이라는 시간이 어떻게 지나갔는지도 모르게 지나갔습니다. 이번 프로젝트를 통해 협업에 대해 배울 수 있었고, 다른 모든 부분들이 저에게는 소중한 배움의 시간이었습니다. 사실 아직 이해가 안 가는 부분도 많고 시간을 많이 투자하고도 해결하지 못한 부분도 많지만 그 시간들이 쌓여 성장의 밑거름이 될 것이라 생각이 듭니다. 추후에 이 부분은 더 파고들어서 해결하는 것이 목표입니다! 모두 정말 너무너무 고생하셨고, 앞으로 좋은 일만 있으셨으면 좋겠습니다!!!

안유석

강의를 들으며 어렵고 이해가 안 되는 게 많았지만 저녁에 복습하고 TIL도 적으면서 정리해 보며 조금씩이나마 감을 익히게 되었고, 무엇보다 이번 프로젝트를 하며 정말 많이 배우고 성장하는 감사하고 소중한 시간이 되었습니다. 아쉬운 점을 몇 개 꼽자면 발표일 전까지 끝내 배포 서버에서 구글 로그인이 안 되는 오류를 잡지 못한 것과 개인적 목표였던 좋은 퀄리티의 코드를 짜지 못했다는 점이 있겠지만, 그래도 프로젝트를 하며 가장 기억에 남는 건 "Null Point Exception"인 거 같습니다. 최대한 신경 써서 코드를 작성했는데도 자주 오류가 발생해서 힘들었던 기억이 납니다. 프로젝트를 진행하며 팀원분들 모두 잘하고 정말 열심히 하셔서 힘들어도 이겨내는 힘이 되어 너무 감사했습니다. 끝으로 긴 시간 동안 운영해 주신 운영진님들과 강의해 주신 강사님, 계속해서 응원하고 피드백해 주신 멘토님께도 감사드립니다. 모두 정말 고생하셨고, 앞으로 모두 꼭 취업하고 좋은 일만 생기면 좋겠습니다. 모두 긴 시간 동안 고생 많으셨습니다!!

조아라

개발환경에서 문제 없던 코드들이 배포환경에서 발생하는 경우가 많아 어려움이 있었지만, CI/CD를 구축하여 개발과 동시에 배포 환경에서도 이슈 트래킹을 할 수 있어서 뜻깊은 경험이었습니다. 또한, 각자 기능 개발 후 코드 통합하는 과정에서 충돌이 있었지만, 원활한 팀원들의 소통을 통해 코드 공유를 문제 없이 할 수 있었고 본 경험을 통해 소통의 중요성을 알 수 있었습니다. 팀원 모두 각자 맡은 기능을 충실히 수행하여 비교적 짧은 개발시간에 많은 도메인을 개발할 수 있었습니다. 팀워크가 좋았고, 소통도 잘되어 프로젝트를 잘 마무리 할 수 있었습니다. 저는 기술적인 부분부터 팀워크에 대한 부분까지 많은 것을 얻어갈 수 있었던 프로젝트였습니다. 감사합니다!

지승우

HTTP 방식만 사용 해왔는데, SSE 방식과 Web Socket 방식을 둘 다 써볼 수 있는 기회여서 좋았습니다! 덕분에 실시간 통신이 무엇인지 알게 되었고, 단방향 통신과 양방향 통신의 차이점도 알 게 되었습니다. 어떤 상황에 HTTP, SSE, Web Socket을 적용해야 하는지 판단할 수 있게 된 거 같고 처음 보는 기술에 대한 적용을 하는 데에 좀 더 자신감을 얻게 되었습니다! 또, 레포지토리를 2개 써보거나 NginX를 활용해서 통신을 한다 던가 CI/CD에서 이슈를 겪는다던가 처음 경험해보는 이슈가 많아서 기술적으로 더 성장한 것 같습니다! 팀장 역할을 맡게 되었는데 부트 캠프를 하기 전엔 제대로 팀장 역할을 수행하지 못했는데 이번에 원활한 협업과 효율을 위해 소통을 하려 노력했고 팀원 분들도 잘 참여해주셔서 프로젝트 마무리를 잘 할 수 있었던 것 같습니다. 모자란 팀장 데리고 끝까지 프로젝트에 잘 참여해주셔서 감사합니다!

Related Projects