동국대학교 Farm System 웹 플랫폼의 프론트엔드 모노레포입니다.

이 저장소는 공식 홈페이지(Website), 파밍로그(FarmingLog), 관리자(Admin), 내부 문서(Docs)를 포함한 통합 웹 플랫폼의 코드베이스를 관리합니다.
각 서비스는 Turborepo 기반의 모노레포 구조로 구성되어 있으며, 공통된 인증, API, 설정, 컴포넌트 등을 패키지로 분리하여 유지보수성과 확장성을 높였습니다.

• 모노레포 채택

(root)/
├─ .github/             # 깃허브 탬플릿, ci/cd를 위한 액션
├─ apps/                # 각 웹페이지가 들어있는 폴더
│  ├─ admin/            # 관리자 전용 웹페이지
│  ├─ docs/             # vitepress로 만든 내부 문서
│  ├─ farminglog/       # 팜시스템 playground, 파밍로그!
│  └─ website/          # 랜딩, 지원 등 팜시스템 대표 페이지
└─ packages/            # 공통로직을 담아두는 폴더

• www.farmsystem.kr
• 랜딩 홈페이지

src/
├─ assets/                # 이미지, 폰트 등 정적 자산 관리 폴더
├─ components/            # 재사용 가능한 공통 UI 컴포넌트
├─ config/                # Axios와 같은 설정을 관리하는 폴더
├─ hooks/                 # 사용자 정의 React 훅을 모아놓는 폴더
├─ models/                # API 데이터 모델 및 타입 정의
├─ pages/                 # 페이지별 컴포넌트들을 관리하는 폴더
├─ services/              # API 호출 및 외부 서비스와의 상호작용 관리
├─ store/                 # 전역 상태 관리를 위한 폴더 (예: Zustand)
└─ utils/                 # 유틸리티 함수 및 헬퍼 함수 모음 (jwt 함수 등)

• 프론트엔드: React (Vite, TypeScript)
• 상태 관리:
  • 서버 상태: TanStack Query (React Query)
  • 클라이언트 상태: Zustand
• 스타일링: Styled-Components
• API 요청: Axios
• 라우팅: React Router
• 배포: Vercel

• main: 배포 및 안정적인 코드가 위치하는 브랜치

• develop: 기능 개발이 진행되는 메인 브랜치로, feature 브랜치가 병합됨

• feature/#이슈번호: 새로운 기능 추가 및 개발 진행 (예: feature/#13, feature/#7)

• fix/: 기존 기능에서 발생한 버그를 수정하는 브랜치 (예: fix/#4)

1. Git Flow 기반 브랜치 전략을 준수합니다.
2. 새로운 기능 개발 시 feature/#이슈번호 브랜치를 생성하여 작업 후 develop 브랜치로 PR을 생성합니다.
3. R이 생성되면 CI/CD 파이프라인에서 코드 검사를 수행하고, 검사 통과 후 코드 리뷰를 진행합니다.
4. 코드 리뷰에서 approve를 받은 후 develop 브랜치에 병합합니다.
5. 일정 단위 개발이 완료되면 aprrove를 받고 develop 브랜치를 main 브랜치로 병합하여 배포합니다.
6. 모든 커밋 메시지는 Conventional Commit 형식을 따릅니다.
   • feat: 새로운 기능 추가
   • fix: 버그 수정
   • refactor: 코드 리팩토링
   • docs: 문서 변경
   • style: 스타일 변경 (코드 포맷, 세미콜론 추가 등)
   • chore: 빌드 설정 및 기타 변경사항

수정해서 CI/CD 파이프라인을 포함한 배포 방식을 정리할게.

이 프로젝트는 Vercel을 사용하여 배포되며, CI/CD 파이프라인을 통해 자동 배포가 이루어집니다.

• develop 브랜치: Vercel Preview URL에서 확인 가능
• main 브랜치: Production 배포

1. PR 생성 시 CI/CD 실행

   • feature/#이슈번호 → develop 브랜치로 PR을 생성하면, CI/CD에서 코드 검사 (Lint, Test 등)를 수행
   • 코드 검사를 통과하면 리뷰 후 develop 브랜치에 병합

2. develop 브랜치 병합 시 자동 배포 (Preview)

   • develop 브랜치로 병합되면, Vercel Preview 배포가 자동 실행
   • URL 예시: https://farming-log-develop.vercel.app/

3. main 브랜치 병합 시 프로덕션 배포

   • develop 브랜치를 main 브랜치에 병합하면 프로덕션(운영) 환경으로 자동 배포
   • 도메인 구매 후 설정 예정 (예: https://farming-log.com/)

• Preview (개발 환경): https://farming-log-develop.vercel.app/
  • develop 브랜치에 코드가 반영될 때 자동으로 배포됨
• Production (운영 환경): 도메인 구매 후 설정 예정
  • main 브랜치에 병합되면 자동으로 프로덕션 배포됨

VITE_API_BASE_URL=your-api-url
VITE_OTHER_CONFIG=your-config

⚠ Vercel 환경 변수 설정

• Vercel 대시보드에서 Environment Variables를 설정해야 정상 작동함
• develop과 main 환경에서 각각 다른 변수를 사용할 수도 있음

# 1. 레포지토리 클론
git clone https://github.com/DguFarmSystem/FarmingLong-FE.git

# 2. pnpm 설치
npm install -g pnpm

# 3. 패키지 설치
pnpm install

# 4. 개발 서버 실행
pnpm run dev