StayJ — 제주 게스트하우스 홈페이지

제주 게스트하우스를 검색/예약할 수 있는 웹 서비스입니다. 프론트엔드는 React, 백엔드는 Spring Boot(Gradle), 정적 업로드/모킹 데이터는 upload repo로 관리합니다.

레포 구성

• 루트 모노레포: SDS-TEAM3/StayJ

  • StayJ_FE/ → React 프론트엔드 (서브모듈) — SDS-TEAM3/StayJ_FE

  • StayJ_BE/ → Spring Boot 백엔드 (서브모듈) — SDS-TEAM3/StayJ_BE

  • upload/ → 업로드/모킹 데이터 - SDS-TEAM3/upload

    ㄴ guesthouses/ (초기 게스트하우스 이미지)
    ㄴ rooms/ (초기 방 이미지)
    ㄴ data.sql (MySQL mock data 삽입용 SQL)

1) 프로젝트 클론

(권장) 서브모듈 포함 클론

git clone --recurse-submodules https://github.com/SDS-TEAM3/StayJ.git
cd StayJ
# 이미 일반 clone 했었다면:
# git submodule update --init --recursive

2) 프론트엔드 (React)

요구사항

• Node.js 18+ (LTS), npm 9+

실행

cd StayJ_FE
npm install
npm start

• 개발 서버: http://localhost:3000

3) 백엔드 (Spring Boot / Gradle)

요구사항

• JDK 17+
• Gradle (사용 권장)
• STS 또는 IntelliJ IDEA

빌드 & 실행

cd StayJ_BE
# 빌드
./gradlew build         # Windows: .\gradlew.bat build
# 실행 (둘 중 하나)
./gradlew bootRun       # 또는
# java -jar build/libs/*.jar

기본 서버: http://localhost:8080

4) 초기 DB(Mock Data) 세팅

upload repo의 data.sql에 있는 스크립트를 순서대로 적용하세요. (MySQL)

5) 서브모듈 업데이트

최신 반영 시:

# FE 최신
cd StayJ_FE && git checkout main && git pull
cd ..

# BE 최신
cd StayJ_BE && git checkout main && git pull
cd ..

# 루트에서 서브모듈 포인터 커밋
git add StayJ_FE StayJ_BE
git commit -m "chore: update submodules"

upload 폴더는 C://에 위치시키면 됩니다. (로컬 기준)