🚨 문제 상황

<aside>

BFF 패턴을 처음 도입하면서 기존과는 다른 방식의 역할 분리가 필요했습니다.

기존 프로젝트에서는 API 명세서 작성 시 기능별로 누가 무엇을 개발할지 분류하는 방식으로 충분했습니다. 그러나 BFF · Core 서버 구조에서는 단순히 기능을 나누는 것이 아니라 어느 서버가 어떤 로직을 처리할지에 대한 역할 경계가 필요한 전혀 다른 영역이었습니다.

실제로 아래와 같이 회의록 데이터를 누가 저장하는지에 대한 혼선이 팀 채팅에서 발생하기도 했습니다.

</aside>

• BFF 서버(NestJS 2명) · Core 서버(Spring Boot, 본인)가 각자 명세서를 작성하다 보니 인증 처리, 토큰 발급, 파일 처리 등 기능마다 담당 서버를 매번 구두로 결정해야 하는 상황 발생
• 결정한 내용을 별도로 문서화하지 않아 같은 내용을 반복적으로 소통하는 비효율 발생

🔍 문제 원인

<aside>

• BFF 패턴이 처음이다 보니 서버 간 역할 경계를 어떻게 정의해야 하는지 기준 자체가 없었음
• BFF · Core 서버의 역할을 큰 틀에서만 나누고 기능별 세부 처리 기준을 사전에 문서화하지 않았음
• 구두로 결정한 내용이 반복적으로 누락되어 매번 같은 소통이 반복됨 </aside>

해결 과정

기능별 담당 서버와 처리 흐름을 명확히 정의한 개발 규칙 문서를 작성하였습니다.

서버 역할 분리

주요 처리 흐름 정의

토큰 처리    | 인증은 BFF, 발급 · 저장 · 삭제는 Core
파일 처리    | 파일 → BFF → Core → S3 → DB(UUID 반환)
회의록 처리  | AI → BFF → Redis Stream → Core → DB
실시간 수어  | 클라이언트 ↔ AI 직접 연결

• 클라이언트는 반드시 BFF 서버로만 통신, Core · AI 서버 직접 접근 금지 규칙 명문화
• JWT 토큰 구조 · 에러 코드 · 공통 요청 DTO 등 팀 전체가 공유해야 하는 규격도 함께 문서화
• 개발 규칙 문서를 팀 전체가 공유하여 동일한 기준으로 개발 진행 → 반복적인 소통 비용 감소