ApptiveDev/apptive-academy-project

프로젝트형 스터디 (20기)

프로젝트형 스터디

• 📐 진행 방식
• 📑 관리 규칙
  • 🌵 브랜치
  • 📁 폴더
• 🌏️ 백엔드-프론트 연동

이곳은 팀장 간 회의를 통해 주어지는 MVP 미션을 모든 직군의 개발자가 함께 구현하는 곳입니다.

📐 진행 방식

1. MVP 회의 이후 해당 미션 폴더와 미션 브랜치를 생성합니다. (<미션명>/main)
2. 팀장은 미션 브랜치에서 직군별 폴더와 직군별 브랜치를 생성합니다. (<미션명>/<직군명>/develop)
   • 초기 세팅을 하고 브랜치에 push합니다.
3. 팀원은 직군별 브랜치에서 자신의 브랜치를 따 미션을 진행합니다.
   • 미션을 쪼개 중간중간 다함께 코드리뷰를 진행합니다.
   • <미션명>/<직군명>/<이름> -> <미션명>/<직군명>/develop
4. 미션 이후 직군별 브랜치를 미션 브랜치에 병합합니다.
   • <미션명>/<직군명> -> <미션명>/main

📑 관리 규칙

🌵 브랜치

미션 진행을 위한 브랜치 구조는 아래와 같이 Git Flow를 따릅니다. 단, 간소화하여 main, develop, feature(개인브랜치) 정도로만 구분합니다.

main
  - <미션명>/main                    #  잘 동작하는 프론트, 백엔드 코드 합본
    - <미션명>/frontend/develop      #  프론트엔드팀 미션 진행 공간
      - <미션명>/frontend/<이름>      #  프론트엔드팀 개인별 미션 진행 공간
      - ...
    - <미션명>/backend/develop       #  백엔드팀 미션 진행 공간
      - <미션명>/backend/<이름>       #  백엔드팀 개인별 미션 진행 공간
      - ...

📁 폴더

|- <미션명>
  |- backend   # 백엔드 작업공간
  |- frontend  # 프론트 작업공간
  |- android   # 안드로이드 작업공간
  |- docker    # 백엔드-프론트 로컬 연동
|- <미션명>
  |- ...

🌏️ 백엔드-프론트 연동

1. 백엔드는 기능 구현 후 서버를 빌드하여 <미션명>/docker 폴더에 옮깁니다.
2. 프론트는 <미션명>/docker 폴더에서 docker compose up --build 명령어로 서버를 띄웁니다.
   • 약 30초~1분 정도 소요
3. 프론트는 서버에 API 테스트를 진행합니다.
   • 접근주소: localhost:8080
   • ctrl+c로 서버 절전
4. 서버 사용 이후 <미션명>/docker 폴더에서 docker compose down 명령어로 서버를 완전히 끕니다.