반려인의 위치를 기반으로 동물병원, 공원, 카페 등 반려동물 동반 가능 장소를 탐색하고,
장소를 리뷰•공유할 수 있는 반려동물 지도 기반 커뮤니티 서비스
| 최지혁 | 유호준 | 윤예지 | 이창중 | 주정윤 |
|---|---|---|---|---|
 최지혁 팀장 상품 주문 |
 유호준 팀원 지도/검색 |
 윤예지 팀원 리뷰/포인트 |
 이창중 팀원 마이페이지 |
 주정윤 팀원 회원가입/로그인 |
- 1. 핵심 탐색: 내 주변 반려동물 동반 가능 장소 검색
- 2. 커뮤니티: 리뷰 작성 및 포인트 리워드
- 3. 사용자: 회원가입/로그인 및 마이페이지 (반려동물 관리)
- 4. 커머스: 포인트 기반 상품 주문 시스템
-
주요 기능: 사용자 위치 기반 (반경 1~30km) 장소 검색
-
검색 방식:
- 1) 키워드 검색: '애견카페' 등 단어와 부분 일치하는 장소 검색
- 2) 카테고리 검색: '동물병원' 등 카테고리와 완전 일치하는 장소 검색
-
✨ 핵심 로직 (정확도 향상):
- 문화 공공 데이터 광장 API를 사용하여 반려동물 관련 카테고리가 아닌 장소는 필터링 (e.g., 일반 음식점, 카페 제외)
-
반경 기반 필터링 적용
-
사용자의 위도·경도와 장소의 위도·경도를 활용해 거리 계산(하버사인 기반 거리 공식 등)을 수행
-
지정 반경(1 ~ 30 km) 안에 있는 장소만 선별해서 반환
→ “지금 내 주변에서 실제로 갈 수 있는 곳”만 추천되도록 설계
-
-
복합 조건 검색 지원
-
위치(반경) + 키워드 + 카테고리(중분류) 조건을 동시에 걸 수 있음
-
예: “5km 안에서 ‘카페’ 키워드이면서 카테고리=애견동반카페”처럼 교차 필터 가능
→ 노이즈 많은 공공데이터를 사용자 의도에 맞게 정제
-
-
공공데이터 표준화/정제
- 공공데이터 API에서 내려오는 원본 응답을 내부 도메인 모델(Place)로 파싱 및 정리
- 영업시간, 휴무일, 반려동물 동반 가능 여부, 주차 여부 등 실제로 방문 결정에 필요한 필드만 추출/저장
- 잘못된/누락된 주소 정보 등은 가공해 프론트가 바로 표시 가능한 형태로 제공
-
장소별 평점 정보 캐싱
-
Place엔티티에서 평균 평점과 리뷰 수를 유지 -
리뷰 생성 시마다 평균/리뷰 수를 갱신해 둠으로써, 상세 조회에서 별도 집계 쿼리 없이 즉시 응답
→ 상세 화면 진입 속도 향상
-
-
장소 상세 조회 정보 패키징
- 상세 조회 시 단순 위치 정보만 주는 게 아니라:
- 장소 기본 정보 (이름, 주소, 영업시간, 휴무일, 전화번호 등)
- 반려동물 동반 가능 여부 / 제한 조건
- 별점 평균 / 리뷰 개수
- 원본 설명(rawDescription)까지 한 번에 내려줌
- 즉, 프론트는 추가 호출 없이 바로 상세 화면을 그릴 수 있음
- 상세 조회 시 단순 위치 정보만 주는 게 아니라:
- 리뷰 (CRUD):
- C (Create): 텍스트, 이미지(
AWS S3활용) 업로드로 리뷰 생성 - R (Read):
- 장소 ID별 리뷰 목록 조회
- 유저 ID별 (내가 쓴) 리뷰 목록 조회
- U/D (제한): 포인트 정책 및 상품 구매와 연동되어 수정 및 삭제는 제한
- C (Create): 텍스트, 이미지(
- 포인트 시스템 (보상):
- 지급 기준: 텍스트 리뷰 (50P), 텍스트+이미지 리뷰 (100P)
- 제한 로직:
- 일일 적립 한도 (1,000 포인트)
- 유저의 '오늘 획득 포인트'를 DB에서 체크
- 한도 초과 시, "
일일 포인트 적립 한도를 초과하여, 포인트가 적립되지 않았습니다." 알림 및 포인트 미지급
- 일일 한 장소 한개의 리뷰 적립 제한
- 오늘 날짜, 장소 ID와 유저 ID, 리뷰 ID를 DB에서 체크
- 일일 한 장소에 두 개 이상의 리뷰를 작성할 시, “
이미 오늘 해당 장소의 리뷰 포인트를 지급받아, 포인트가 적립되지 않았습니다.” 알림 및 포인트 미지급
- 일일 적립 한도 (1,000 포인트)
- R (Read) : 유저 포인트 적립 내역 조회
- 회원가입:
- 이메일, 비밀번호, 닉네임, 주소, 우편 번호 등 입력
- 이메일 인증:
- 이메일 인증(인증코드 입력) 성공 시 회원가입 가능
- 유효성 검사:
- 중복 검사 (이메일, 닉네임)
- 형식 및 길이 검사 (빈 칸, 특수문자 등)
- 성공 시: 사용자 ID 반환
- 로그인:
- 닉네임, 비밀번호 기반 인증
- 유효성 검사
- 형식 및 길이 검사 (빈 칸, 특수문자 등)
- 성공 시: 액세스 토큰(Access Token) 반환
- 로그아웃:
- 세션스토리지에 있는 토큰 삭제
- 내 정보 조회:
- 토큰을 기반으로 사용자 정보 (주소 포함) 조회
- 작성한 리뷰 조회
- 적립된 포인트 조회
- 사용자 반려동물 조회
- 반려동물 관리 (CUD):
- C (Create): 반려동물 정보 등록 (이름, 성별, 생년월일, 품종)
- U (Update): 기존 반려동물 정보 수정
- D (Delete): 등록된 반려동물 삭제
- (모든 기능은 액세스 토큰으로 인증된 사용자에 한해 실행)
- 주문 생성 (핵심 로직):
- [조건] 포인트 검사: 사용자의 (보유 포인트) >= (총 결제 가격)
- [실행] 조건 충족 시, 포인트 차감
- [예외] 조건 불충족 시, "포인트 부족"예외 처리
- 주문 상태 관리:
Scheduler활용- 조회: 사용자의 전체 주문 내역 조회
- 취소: '주문 완료(Ordered)' 상태일 때 사용자가 직접 '취소(Canceled)' 가능
- 배송 (자동화):
- 스케줄링 기능으로 매일 특정 시간, 'Ordered' 상태의 주문을 'Delivered*로 일괄 변경 (Canceled 제외)
| 이름 | 역할 | 담당 기능 |
|---|---|---|
| 최지혁 | 팀장 / ppt 제작 | 상품 주문 |
| 유호준 | ppt 제작 | 검색 |
| 이창중 | ppt 제작 | 마이페이지 |
| 윤예지 | ppt 제작 | 리뷰/포인트 |
| 주정윤 | 서기 / 발표 | 회원가입/로그인 |
- 추후 삽입 예정
우리 팀은 기존 main / feature 브랜치 구조에 develop 브랜치를 추가해 안정성과 협업 효율을 높였습니다.
- main
- 초기 상태 백업용 브랜치
- develop
- 새로운 기능 개발이 통합되는 기준 브랜치
- 브랜치 보호 규칙 적용 (PR + 리뷰 후 머지)
- feature/#(이슈 번호)
- 개별 기능 개발용 브랜치
- 이슈 단위로 생성하여 작업
- 작업 완료 후 PR을 통해 develop에 머지
- 이슈 생성 → 작업 단위 정의
- 브랜치 생성 → develop 브랜치에서 이슈별 작업 브랜치 생성
- Commit & Push
- PR 생성 & 코드 리뷰 → 최소 2명 승인 필요
- Merge & 브랜치 정리
- 리뷰 완료 후 develop 브랜치로 Merge
- Merge 후 이슈별 작업 브랜치 삭제
-
이슈
- 제목 규칙 :
[타입] 작업내용 - 예시 :
[feat] 로그인 기능 추가 - 본문은 템플릿에 맞춰서 작성
- 제목 규칙 :
-
PR
- 제목 규칙 :
[타입] 작업내용 - 예시 :
[feat] 로그인 기능 추가 - 본문은 템플릿에 맞춰서 작성
- 제목 규칙 :
-
브랜치
- 생성 기준 :
develop브랜치에서 생성 - 명명 규칙 :
타입/작업 내용 - 예시:
feat/조회 기능 개발 main과develop브랜치는 브랜치 보호 규칙이 적용되어, 반드시 PR을 통해 최소 2명의 팀원 리뷰 승인 후에만 머지할 수 있다.
- 생성 기준 :
-
Commit Message 규칙
타입 의미 feat 새로운 기능 추가 fix 버그 수정 docs 문서 수정 (README, 주석 등) style 코드 스타일 변경 (포맷팅, 세미콜론 등. 기능 변화 없음) refactor 코드 리팩토링 (동작 변화 없음) test 테스트 코드 추가/수정 chore 빌드, 패키지 매니저, 설정 파일 등 유지보수 작업(환경 설정) remove 파일, 폴더 삭제 rename 파일, 폴더명 수정 타입 : 작업내용- 예시:
feat : 로그인 기능 추가