플러스프로젝트 배경
서비스 기능이 늘어나면서 단일 API 서버의 배포 영향 범위가 넓어지고, 한 기능의 장애가 전체 서비스로 번지는 상황이었습니다. 동시에 API 문서가 관리되지 않아 기획·디자인팀과의 소통 비용이 크고, 장애 발생 시 원인 파악에도 시간이 오래 걸렸습니다.
프로젝트 성과
단일 API 서버를 7개 기능 단위로 분리
프로모션, CRM 푸시, 스케줄러, 구독 결제, 정산, 캐시, 썸네일 생성을 각각 독립 서비스로 점진 전환
핵심 기능
Swagger 기반 API 문서 자동화
서비스별 API 문서를 자동 생성하고 변경 이력을 추적, 기획팀용 명세는 Notion으로 별도 관리
진행 단계
단일 API 구조 분석 및 분리 순서 설계
2024.03.
배포 영향 범위와 장애 전파 경로를 분석해 분리 대상 기능을 선정하고, 서비스 중단 없는 전환 순서를 설계
프로젝트 상세
기존 Express 기반 단일 API 서버를 기능별 마이크로서비스로 분리하고, 문서화와 장애 대응 체계를 정비해 확장성·유지보수성을 높였습니다. 1인 수행 프로젝트입니다. [AS-IS] 모든 기능이 하나의 API 서버에 집중돼 있어 배포 영향 범위가 넓고, 기능을 확장할 때마다 전체 서비스 리스크가 커지는 구조였습니다. [TO-BE — 기능 단위 마이크로서비스로 점진 전환] 프로모션 / CRM
