ClassroomReservationBackend

소개

경북대학교 컴퓨터학부 강의실/시설물 예약 시스템의 백엔드 서버입니다.
Spring Boot, JPA, MySQL, Spring Security 기반으로 개발되었습니다.

주요 기능

• 회원가입/로그인 (아이디, 비밀번호 기반)
• 강의실/시설물 목록 및 상세 조회
• 예약 생성/조회/취소

실행 방법

로컬 환경에서 실행

1. MySQL에 classroom_reservation 데이터베이스를 생성하세요.
2. src/main/resources/application.yml에서 DB 계정 정보를 입력하세요.
3. 아래 명령어로 서버를 실행하세요.

   ./gradlew build
   ./gradlew bootRun

4. API는 기본적으로 http://localhost:8080에서 동작합니다.

Docker를 사용한 실행

Docker Compose를 이용한 전체 스택 실행 (권장)

# MySQL과 애플리케이션을 함께 실행
docker-compose up -d

# 로그 확인
docker-compose logs -f

# 종료
docker-compose down

Docker만 사용하여 실행

# Docker 이미지 빌드
docker build -t classroom-reservation .

# 컨테이너 실행 (MySQL이 별도로 실행 중이어야 함)
docker run -p 8080:8080 \
  -e SPRING_DATASOURCE_URL=jdbc:mysql://host.docker.internal:3306/classroom_reservation?serverTimezone=Asia/Seoul \
  -e SPRING_DATASOURCE_USERNAME=classroom_reservation \
  -e SPRING_DATASOURCE_PASSWORD=Knu2025java11! \
  classroom-reservation

API 예시

• 회원가입: POST /api/auth/register
• 로그인: POST /api/auth/login
• 강의실 목록: GET /api/rooms
• 예약 생성: POST /api/reservations

개발 환경

• Java 17 이상
• Spring Boot 3.x
• MySQL 8.x

기여 방법

• dev 브랜치에서 기능별 브랜치를 생성해 작업 후 Pull Request를 올려주세요.