반려동물 산책 코스 공유 서비스의 Spring Boot 백엔드 MVP입니다.
- Java 17, Spring Boot 3.3, Spring Web
- Spring Data JPA, PostgreSQL 16
- JWT(jjwt), BCrypt, springdoc OpenAPI
docker compose up -d db
mvn spring-boot:run기본 DB 접속 정보는 application.yml과 docker-compose.yml을 따르며, 운영 환경에서는 DB_URL, DB_USERNAME, DB_PASSWORD, JWT_SECRET을 반드시 변경하세요.
Swagger: http://localhost:8080/swagger-ui.html
| 영역 | API |
|---|---|
| 인증 | POST /api/auth/signup, POST /api/auth/login |
| 반려견 | GET/PUT /api/dog |
| 코스 | POST /api/courses, GET /api/courses?lat=&lng= |
| 좋아요 | POST/DELETE /api/courses/{id}/like |
| 산책일지 | POST/GET /api/walk-logs |
로그인이 필요한 API는 Authorization: Bearer {accessToken} 헤더를 사용합니다. 추천 코스는 명세대로 시작점 기준 반경 3km 안에서 좋아요 수 내림차순, 같은 경우 거리 오름차순으로 정렬합니다. 거리는 PostgreSQL의 삼각함수 기반 Haversine 계산으로 조회합니다.
이미지 업로드는 MVP에서 S3 또는 Cloudinary의 업로드 URL을 요청 본문으로 받는 방식으로 두었습니다. 실제 파일 업로드가 필요해지는 시점에 presigned URL API를 추가하면 됩니다.
- 이슈를 만들고 담당자를 정합니다. 기능·오류·리팩터링·저장소 작업 양식은
.github/ISSUE_TEMPLATE/에 있습니다. develop에서 이슈 번호가 들어간 작업 브랜치를 만듭니다.- 작업 후
develop대상으로 PR을 열고 다른 팀원의 리뷰를 받습니다. PR 본문에Closes #이슈번호를 적습니다. - CI의 Java 17 빌드·테스트가 통과하면 병합합니다. 시연·배포할 변경을 모아
develop에서main으로 PR을 엽니다.
git fetch origin
git switch develop
git pull --ff-only origin develop
git switch -c 'feat/walk-log#12' # 이슈 #12 예시
# 작업 후
git push -u origin 'feat/walk-log#12'브랜치 앞부분은 작업에 따라 feat/, fix/, refactor/, chore/를 사용합니다. 커밋은 feat:, fix:, refactor:, chore:, docs: 접두사를 사용합니다.