안녕하세요. 백엔드 개발자 홍윤표 입니다. 제가 진행했던 프로젝트 중 고민에 대한 통해 개선하였던 경험을 기술하였습니다.

PROJECT.

중고 상품 결제 환경 구축 - 헥사고날 아키텍처 도입

밀크코퍼레이션 2024.09. ~ 2024.10.

Java17, Spring boot 3.2, Spring batch, JPA, Querydsl, Spock framework, JUnit

프로젝트 목적

<aside> 📌

육아용품 중심의 이커머스 플랫폼 ‘키즈닝’은, 최근 빠르게 성장하는 육아용품 중고 거래 시장의 수요에 대응하기 위해, 앱 내에 중고 거래 기능과 판매자의 수거, 검수, 배송까지 대행하는 통합 서비스를 구축하고자 했습니다.

본 프로젝트에서는 기존 레거시 구조에서 반복되던 중복 코드 문제, 외부 API와의 높은 결합도, 변경에 대한 유연성 부족 문제를 해결하고자, 헥사고날 아키텍처를 도입하여 유지보수성과 확장성을 개선하는 것을 목표로 삼았습니다.

</aside>

헥사고날 아키텍처 도입 이유

기존의 레이어드 아키텍처 구조에서는 다음과 같은 문제들이 있었으며, 이를 해결하고자 헥사고날 아키텍처 도입을 ****결정하였습니다.

중복된 기능 구현 문제: 결제, 배송 관련 기능을 여러 프로젝트에서 각각 구현하면서, 중복 코드가 다수 발생하고 재사용, 유지보수의 어려움이 발생하는 구조였습니다.
비즈니스 로직 수정의 어려움: 기존 구조는 외부 연동 코드와 핵심 로직이 강하게 결합되어 있어, PG사 교체와 같은 주요 변경 작업을 하게되면 전체 서비스에 영향을 미치고 안정적으로 수정하기 어려운 환경이었습니다.
향후 확장을 고려한 유연한 구조 필요: 중고 거래 서비스가 활성화될 경우, 외부 API를 사용하지 않고 자체 배송 시스템을 도입해야 할 가능성이 있었고,이를 위해 외부 시스템의 변경이나 확장에도 유연하게 대응 가능한 구조 설계가 필요했습니다.

프로젝트 구조 및 설계도

[세컨핸드]중고_상품설계-프로젝트 아키텍처-class.jpg

Domain:

service: usecase를 상속 받은 서비스의 비즈니스 로직 구현을 담당
entity: 도메인 엔티티를 담당

Adapter: 외부 API, DB 등 인프라 관련 담당

in.web: 웹훅 요청을 받을 Controller 구현
out: persistence, API 연동 등 인프라 관련 로직 구현을 담당

Application:

port.in: 비즈니스 구현을 위한 Usecase 인터페이스 정의를 담당
port.out: 외부와 연결하기 위한 Port 인터페이스 정의를 담당

프로젝트 플로우 차트

배치의 경우 Process, Writer 에서 Port, Usecase 를 주입받아 구현되었습니다.

[세컨핸드]중고_상품설계-프로젝트 아키텍처-수정찐막.jpg

결과 및 성과

비즈니스 로직과 인프라 코드의 명확한 분리
- 외부 API 연동(SweetTracker, Solapi 등), DB 접근, 메시지 발송 등 인프라 관련 로직은 모두 Adapter 계층으로 분리하고, 핵심 비즈니스 로직은 Usecase 및 Service 계층에 집중시켜 도메인 중심 구조를 구현했습니다. 이로 인해 계층별 책임이 명확해졌고, 유지보수 시 수정 범위와 복잡도가 크게 줄어들었습니다.
확장성과 유연성 확보
- 외부 시스템(SweetTracker 등)을 다른 API로 교체해야 할 경우, Adapter만 수정하면 되도록 설계했습니다.
- 각 기능은 Port 인터페이스를 기준으로 의존성을 갖기 때문에, 기능 확장이나 시스템 교체 시 전체 서비스에 영향을 주지 않고 유연하게 대응할 수 있습니다.
- 비즈니스 로직 구현을 담당하는 Service에서는 비즈니스 로직에만 집중하도록 하여 Port, Adapter의 변경 사항에 영향을 받지 않도록 설계했습니다.

개인화 추천 영역 고도화

밀크코퍼레이션 2024.03. ~ 2024.03. (2주)

Java17, Spring boot 2.7, AWS Personalize , JPA, Querydsl

프로젝트 목적

<aside> 📌

기존 개인화 추천 시스템은 회원 가입 시 등록한 관심 카테고리와 아이정보를 기반으로 추천하여, 회원의 최근 관심사 반영을 하지 못하는 한계가 있었습니다. 이를 개선하고자 회원 활동 데이터를 기반으로 한 실시간 추천 구현을 목표로 AWS Personalize 도입을 제안하고 추천 시스템 설계 및 구현하였습니다.

</aside>