PROJECT

Team Personal

STUDY

Language Framework

PHOTO

PIOMS

👨🏻‍💻 내가 기여한 부분

📚 사용 기술

🧩 System Architecture

내가 기여한 부분

•

본사 관리자, 가맹점주, 배송기사에 대한 정보를 생성 및 관리할 수 있는 기능을 구현

•

로그인별 RULE 설정을 통해 페이지 접근 권한을 세분화하고, 각 사용자별로 적절한 권한을 부여

•

JWT를 활용한 인증 절차를 구축하고, Redis에 토큰을 저장하여 보안성을 강화

•

프로젝트에서 속도 최적화 문제를 해결하기 전, 사용자 불편을 줄이기 위해 프론트부분에서 Swal(SweetAlert)을 도입하여 로딩 시 화면을 대체, 결과적으로 사용자에게 시각적인 피드백을 제공하여 UX를 개선하는 데 기여

•

대시보드의 데이터 로딩 성능을 개선하기 위해 JPA의 default_batch_fetch_size를 설정하여 N+1 쿼리 문제를 최적화하여 조회속도를 88.9% 개선

•

GitHub을 통한 형상 관리를 수행하며, Git Flow 전략, 커밋 및 PR 컨벤션 적용, 컨벤션을 어려워하는 팀원들을 위해 가이드 제공

•

테스트코드 도입으로인하여 코드품질을 높이도록 기여

•

카카오 메시지 API를 활용하여 재고 부족 상황 발생 시 자동으로 알림톡을 발송하는 기능을 개발

•

GitHub Actions와 AWS를 활용하여 CI/CD 파이프라인을 구축하고, 배포를 설정

•

이전 PM 경험을 바탕으로 이커머스와 물류 서비스의 설계 및 Flow Chart 작성에 주도적으로 기여하며, 프로젝트 전반의 방향성을 설정

•

프로젝트 기간 내 차질이 없도록 서비스 기획과 방향성을 설정하고, Daily Scrum도입 및 암묵지를 제거하며 명확한 규칙과 명명을 통해 프로젝트의 일관성을 유지

•

모든 화면에 규칙적인 정리를 통해 프론트엔드 작업에도 기여

사용 기술

•

DataBase

◦

MariaDB / Redis / H2

•

BackEnd

◦

Java / Spring Boot / Spring Data JPA / Spring Security / JWT / Junit5 / Mokito

•

API

◦

Swagger / Kakao Message

•

Software Architecture Pattern

◦

Microservices Architecture

•

FrontEnd

◦

HTML / CSS / JavaScript / Vue.js / VueX

•

DevOps

◦

GitHub Actions / AWS(Elastic Beanstalk, EC2, RDS, S3, Route53)

•

Collaboration

◦

GitHub / Slack / Notion / Figma / Miro

System Architecture

PIOMS System Architecture

트러블 슈팅 1

문제 배경

PIOMS 프로젝트에서 JPA 사용 중 N+1 문제로 인해 API 응답 시간이 비정상적으로 길어졌습니다. 특히 Admin 엔티티와 연관된 Franchise 데이터를 조회할 때, 각각의 엔티티가 개별 쿼리로 호출되면서 데이터베이스에서 불필요한 수많은 쿼리가 발생했습니다. 그 결과, 대시보드 같은경우는 응답 시간이 9초 이상으로 증가하는 성능 저하 문제가 발생했습니다.

해결 방법

Batch Fetching 설정: application.yml에서 hibernate.default_batch_fetch_size 값을 설정하여 연관된 엔티티 데이터를 일괄적으로 가져오도록 하여 쿼리 횟수를 줄였습니다.

Lazy Loading 적용: @OneToMany 관계에서 기본적으로 Lazy Loading을 사용하여, 실제로 Franchise 데이터가 필요할 때만 조회하도록 했습니다. 이렇게 하면서 Admin 데이터를 로드할 때 불필요한 Franchise 데이터 로딩을 방지할 수 있었습니다.

개선 결과

•

N+1 문제 해결을 통해 응답 시간이 9초에서 1초로 대폭 개선되었습니다.

•

Batch Fetching과 Lazy Loading 설정만으로도 복잡한 관계에서 발생하는 성능 문제를 상당 부분 개선할 수 있었습니다.

해당 경험을 통해 알게 된 점

Lazy Loading과 Batch Fetching만으로도 JPA 성능을 효과적으로 최적화할 수 있음을 확인했습니다.

이번 경험을 통해, 복잡한 엔티티 간의 연관 관계를 다룰 때 N+1 문제를 방지하기 위한 기본적인 설정을 항상 점검하고, 필요에 따라 적절한 Fetch 전략을 선택하는 것이 필수적이라는 것을 다시 한 번 느꼈습니다.

TISTORYJPA에서 N+1 문제 해결

Lazy Loading 적용

application.yml에 default_batch_fetch_size값 설정

트러블 슈팅 2

문제 배경

PIOMS 프로젝트의 CI/CD 파이프라인에서 GitHub Actions를 사용해 자동 배포를 설정하던 중, 환경 변수 설정 누락으로 인해 AWS와의 통신 문제와 파일 업로드 오류가 발생했습니다. 특히, application.yml 파일에서 민감한 정보가 환경 변수로 제대로 주입되지 않으면서 문제가 시작되었습니다. 이로 인해, 배포 실패 및 애플리케이션의 환경 변수 미처리 문제가 발생했습니다.

해결 방법

배포 과정에서 누락된 환경 변수를 GitHub Secrets를 통해 설정했습니다. envsubst를 사용하여 환경 변수를 YAML 템플릿에 주입하는 방식을 사용했으며, 배포 시 AWS_ACCESS_KEY_ID와 같은 민감 정보가 GitHub Secrets에서 제대로 가져와질 수 있도록 설정했습니다.

파일이 제대로 생성되고 환경 변수가 주입되었는지 확인하기 위해 cat 명령어로 application.yml과 application-test.yml 내용을 로그에 출력하여 파악했습니다.

JAR 파일 및 Elastic Beanstalk에서 필요한 파일들이 존재하는지 확인하는 로직을 추가하고, 만약 파일이 존재하지 않을 경우 오류를 발생시켜 조기에 문제를 확인할 수 있도록 처리했습니다.

개선 결과

•

배포 과정에서 발생하던 환경 변수 누락 문제를 해결해 안정적인 배포가 가능해졌습니다.

•

자동화된 테스트가 제대로 동작하며, AWS S3 및 Elastic Beanstalk에 배포 패키지를 올리는 과정이 원활하게 진행되었습니다.

해당 경험을 통해 알게 된 점

CI/CD 파이프라인에서 환경 변수를 안정적으로 관리하는 것이 얼마나 중요한지를 깨달았습니다. 특히, 민감한 정보는 GitHub Secrets, .env 혹은 Spring Boot의 Configurations와같은 안전한 방법으로 관리하고 설정해야 하며, 환경 변수 주입 및 설정 파일 생성 과정에서 세심한 확인과 테스트가 필요하다는 점을 다시 한번 느꼈습니다.

GitHub Secrets에 설정한 변수

envsubst 명령어를 사용하여 템플릿에 환경 변수를 주입하고 확인하는 부분

파일이 존재하지 않을 경우 오류를 발생시키는 로직

트러블 슈팅 3

문제 배경

테스트 코드 작성 시, 데이터베이스와 Redis 서버에 대한 의존성이 높아 테스트 환경을 설정하는 데 어려움이 발생했습니다. 특히, 테스트 중에 실제 Redis 서버에 연결되지 않으면 테스트가 실패가 발생했었습니다.

해결 방법

MockRedisConfig를 도입해 Redis 의존성을 제거했습니다. 실제 Redis 서버 대신 가상 환경에서 Redis의 역할을 대체할 수 있도록 설정하였습니다.

개선 결과

Redis 의존성 없이 독립적인 테스트 환경을 구성할 수 있었고, 빠르고 안정적인 테스트가 가능해졌습니다.

해당 경험을 통해 알게 된 점

테스트 환경에서 외부 서비스에 대한 의존성을 최소화하는 것이 테스트의 안정성과 효율성을 높일 수 있음을 배웠습니다. Mocking을 통한 의존성 제거는 개발 단계에서 큰 도움이 되며, CI/CD 파이프라인에서 안정적인 테스트 실행을 보장할 수 있음을 알게 되었습니다.

테스트 환경에서 Redis 의존성을 제거하기 위한 Mock Redis 설정

테스트 환경에서 Redis 의존성을 Mocking하여 AdminInfoService의 기능을 검증하는 테스트 클래스 설정

테스트환경에서의 application-test.yml 설정

🫡 회고

“헤어 나올 수 없는 미로 속에서 길을 찾는 여정"

PIOMS 프로젝트는 제 인생 슬로건인 “환골탈태”를 실천하며 기술적 역량과 협업 능력을 크게 성장시킨 경험이었습니다. 다양한 기술적 문제를 해결하면서 배운 것들을 바탕으로 문제 해결 능력을 더욱 키워나갔습니다. 팀원들과 협력하여 서로 다른 시각과 접근 방식을 통합하며 프로젝트를 성공적으로 완성할 수 있었고, 팀워크의 중요성도 다시금 깨달았습니다. 이번 프로젝트는 새로운 기술을 습득하고, 발전해 나갈 수 있는 중요한 전환점이었습니다.

GitHubPIOMS Retrospect

PIOMS

트러블 슈팅 2

문제 배경

해결 방법

개선 결과

해당 경험을 통해 알게 된 점

트러블 슈팅 3

문제 배경

해결 방법

개선 결과

해당 경험을 통해 알게 된 점

.css-hopgjw{font-family:var(--emoji-font-family);white-space:nowrap;}🫡 회고

🫡 회고