23-5-team9-server

와플스튜디오 23.5기 9조 server Workflow

• 기본 작업 브랜치: dev
• 각 기능들을 개발할 때: feature/function 브랜치를 만들어 해당 브랜치에서 작업
• 기능이 완성된 경우 dev 브랜치로 병합 후 디버깅
• 디비깅이 완료되면 main 브랜치로 병합

---

기능 매핑 및 구현 범위

1. 인증 / 회원 관리

회원가입

• 이메일 / 비밀번호 기반 회원가입
• 비밀번호 해싱 처리
• 이메일 중복 검사
• 입력값 유효성 검증

로그인 / 로그아웃

• 이메일 + 비밀번호 로그인
• 인증 토큰 발급 (Access / Refresh)
• 로그아웃 시 토큰 무효화

소셜 로그인

• OAuth2 기반 소셜 로그인 (예: Google, Kakao)
• 최초 로그인 시 회원 자동 생성
• 기존 계정과의 연동 정책 정의

---

2. 게시물 (중고 거래)

게시물 관리

• 게시물 생성 / 조회 / 수정 / 삭제 (CRUD)
• 작성자 권한 검증
• 게시물 상태 관리
  • 판매중 / 거래완료

게시물 정보

• 제목, 내용, 가격
• 카테고리
• 지역 정보
• 이미지 다중 첨부
  → 이미지 업로드 기능을 활용

목록 조회

• 최신순 / 가격순 정렬
• 카테고리 필터
• 지역 기반 필터
• 페이지네이션 적용
  → 중고 거래(게시물) 페이지네이션

---

3. 지역 선택

지역 설정

• 유저 기본 지역 설정
• 지역 변경 기능

지역 기반 노출

• 게시물 조회 시 지역 필터 적용
• 내 지역 중심 피드 구성

---

4. 좋아요 / 즐겨찾기

좋아요 기능

• 게시물 좋아요 등록 / 취소
• 중복 좋아요 방지

관심 목록

• 내가 좋아요한 게시물 목록 조회
• 페이지네이션 적용
  → 프로필 페이지네이션

---

5. 중고 거래 + 가상 화폐 결제

가상 화폐(포인트)

• 사용자 지갑 관리
• 잔액 조회
• 포인트 충전 (테스트용)

거래 프로세스

• 구매 요청 → 판매자 수락 → 결제 → 거래 완료
• 거래 상태 관리
  • REQUESTED / ACCEPTED / PAID / COMPLETED / CANCELED

정합성 처리

• 잔액 부족 검증
• 중복 결제 방지
• 트랜잭션 처리

거래 내역 조회

• 구매 / 판매 내역 조회
• 페이지네이션 적용
  → 프로필 페이지네이션

---

6. 채팅

채팅 유형

• 게시물 기반 1:1 채팅

기능

• 채팅방 생성
• 메시지 전송 / 조회
• 채팅방 목록 조회

실시간 통신

• WebSocket 기반 실시간 메시지 처리
• (선택) 읽음 상태 처리

목록 조회

• 채팅방 목록 페이지네이션
• 메시지 히스토리 페이지네이션
  → 채팅 페이지네이션

---

7. 경매 (추가 기능)

경매 게시물

• 경매 전용 게시물 생성
• 시작가 / 즉시구매가 / 최소입찰단위
• 경매 시작 / 종료 시간
• 경매 상태 관리
  • SCHEDULED / LIVE / ENDED / CANCELED
• 이미지 첨부
  → 이미지 업로드 기능 활용

경매 목록

• 경매 게시물 목록 조회
• 페이지네이션 적용
  → 경매 페이지네이션

그룹 채팅

• 경매 참가자 전용 그룹 채팅방
• 참가 버튼을 통한 입장
• 시스템 메시지(입찰 갱신, 마감 안내 등)

입찰 시스템

• 입찰 금액 검증
• 최소 입찰 단위 검증
• 마감 이후 입찰 차단
• 동시성 제어를 통한 최고가 보장

낙찰 및 결제

• 경매 종료 시 자동 낙찰 처리
• 낙찰자 가상 화폐 결제
• 거래 기록 생성