• Commit Convention
  • feat: 새로운 기능
  • fix: 버그 수정
  • refactor: 리팩토링
  • docs: 문서 수정
  • chore: 기타 작업
  • test: 테스트 코드
  • style: 코드 스타일 수정

로컬 실행

1. 로컬 인프라 실행

docker compose up -d

기본 포트:

MySQL: localhost:3307
Redis: localhost:6380

2. 애플리케이션 실행

./gradlew bootRun --args='--spring.profiles.active=local'

실행 확인:

curl -i http://localhost:8080/swagger-ui/index.html

3. 클라이언트 실서버 모드 실행

채팅은 HTTP 히스토리 API와 STOMP WebSocket을 함께 사용합니다. 서버를 먼저 띄운 뒤 클라이언트를 실서버 모드로 실행합니다.

cd ../Client
VITE_API_MODE=real VITE_API_BASE_URL=http://localhost:8080/api pnpm dev --host 127.0.0.1

클라이언트는 VITE_API_BASE_URL이 http://localhost:8080/api일 때 WebSocket 엔드포인트를 ws://localhost:8080/ws로 계산합니다.

채팅 관련 서버 경로:

• REST 히스토리: GET /api/project-groups/{projectGroupId}/chat/messages
• REST 읽음 처리: PATCH /api/project-groups/{projectGroupId}/chat/read
• WebSocket 연결: ws://localhost:8080/ws
• STOMP 전송: /app/project-groups/{projectGroupId}/chat/messages
• STOMP 구독: /topic/project-groups/{projectGroupId}/chat/messages

4. 테스트와 빌드

전체 테스트:

./gradlew test

클린 빌드:

./gradlew clean build

Flyway MySQL 연동 테스트는 기본으로 비활성화되어 있습니다. 로컬 MySQL이 실행 중이고 src/test/resources/application-flyway.yml 설정을 사용할 때만 아래처럼 실행합니다.

RUN_DB_TESTS=true ./gradlew test