병렬 개발을 위한 FE/BE 협업 전략

sojw·2025년 6월 9일

핵심 원칙

  1. API First 개발: API 명세 우선 정의로 병렬 개발 활성화하여 대기 시간 제거
  2. 느슨한 결합: Mock 기반 환경을 통한 독릭 개발 환경 구축
  3. 투명한 소통: 진행상황과 블로커 실시간 공유로 문제를 조기 발견하고 해결
  4. 유연한 대응: 지연 발생시 우선순위 재조정 및 범위 축소를 통한 빠른 의사결정
  5. 실용적 접근: 완벽함보다는 릴리즈 가능한 수준을 우선하여 지속적 개선

전체 개발 플로우

1단계: API 설계 및 합의

요구사항 분석 및 API 설계:
- 비즈니스 요구사항 분석 및 API 엔드포인트 정의
- FE 필요 데이터 구조 및 BE 기술적 제약사항 공유

API 명세 확정 및 Mock 준비:
- API 명세 작성 및 확정
- Mock 구축 및 개발 환경 준비

2단계: 병렬 구현

BE 구현:
- API 구현 및 비즈니스 로직 개발
- 단위 테스트 작성 및 API 문서/Swagger 업데이트

FE 구현:
- Mock API 기반 화면 구현
- 예외 처리 로직 등 개발 완성

공통:
- Scrum 시, 진행상황 공유
- 블로커 및 API 변경사항 실시간 소통

3단계: API 엔드포인트 공유 및 통합

API 준비 완료:
- BE 구현 완료 알림 및 테스트 서버 정보 공유

FE 통합 작업:
- Mock에서 실제 API로 전환 및 통합 테스트

최종 검수:
- 통합 테스트 및 배포 준비

Jira Task 구조

예:

Epic: 주문 관리 시스템
├─ Task: 주문 목록 조회
│  ├─ [BE] 주문 목록 API 구현
│  ├─ [FE] 주문 목록 화면 구현
│  └─ [통합] API 연동 및 테스트
└─ Task: 주문 생성
   ├─ [BE] 주문 생성 API 구현  
   ├─ [FE] 주문 생성 폼 구현
   └─ [통합] API 연동 및 테스트

필수 입력 필드:

  • 상태: TODO/진행중/블로킹됨/완료
  • 의존성: 이 작업이 관계 있는 다른 작업과 연결 하기
  • 예상완료일: 개발자가 예측하는 완료 시점

작업 지연 대응 전략

지연 발생시 즉시 대응

대응

즉시 대응:
  - Slack/Scrum 에서 상황 공유 및 해결방안 논의
  - 필요시 논의미팅

BE API 지연 → FE 개발 막힘

즉시 액션: Mock API 대체 가능 유무, FE 다른 화면 우선 작업, BE 완료일 재산정
당일 결정: 릴리즈 포함 여부, 개발자 추가 투입, 기능 범위 축소 검토

FE 화면 지연 → BE 테스트 불가

즉시 액션: Swagger/수기 API 테스트, BE 다른 작업 진행
당일 결정: 통합 테스트 일정 조정, 전체 일정 영향도 검토

API 변경시 소통 규칙

API 변경 발생시:
  1. 해당 API Task에 Jira 코멘트로 변경사항 기록
  2. 변경 이유, 영향 범위, 기존 버전 지원 기간 명시
  3. 관련 FE Task에 멘션하여 알림
  4. 관련 팀 확인 후 진행

기대효과

  • FE/BE 팀 간 상호 대기 시간 단축
  • API 변경으로 인한 불필요한 재작업 최소화
  • 예측 가능한 일정 관리 및 작업량 분산으로 업무 스트레스 감소
  • 체계적인 소통 구조를 통한 팀워크 및 협업 만족도 향상

0개의 댓글