add ReadME

Author: snu-BuMinSeong

README.md

@@ -1,159 +1,89 @@
-# 23-5-team9-server
-### 와플스튜디오 23.5기 9조 server Workflow
+## Team 9
 
-Change IP
+### Frontend
 
-- 기본 작업 브랜치: `dev`
-- 각 기능들을 개발할 때: `feature/function` 브랜치를 만들어 해당 브랜치에서 작업
-- 기능이 완성된 경우 `dev` 브랜치로 병합 후 디버깅
-- 디비깅이 완료되면 `main` 브랜치로 병합
+* 설한동, 정현수
 
----
+### Backend
 
-# 기능 매핑 및 구현 범위
+* 부민성, 장우혁, 송민혁
 
-## 1. 인증 / 회원 관리
 
-### 회원가입
-- 이메일 / 비밀번호 기반 회원가입
-- 비밀번호 해싱 처리
-- 이메일 중복 검사
-- 입력값 유효성 검증
+---
 
-### 로그인 / 로그아웃
-- 이메일 + 비밀번호 로그인
-- 인증 토큰 발급 (Access / Refresh)
-- 로그아웃 시 토큰 무효화
+## About The Project
 
-### 소셜 로그인
-- OAuth2 기반 소셜 로그인 (예: Google, Kakao)
-- 최초 로그인 시 회원 자동 생성
-- 기존 계정과의 연동 정책 정의
+본 레포지토리는 **와플스튜디오 23.5기 9조**의 중고거래/경매 프로젝트입니다.
+**빈티지 물품을 경매로 사고 팔 수 있는 중고거래 사이트**를 목표로 하며, 기본적인 중고 거래 기능에 더해 실시간 채팅과 경매 시스템을 제공합니다.
 
 ---
 
-## 2. 게시물 (중고 거래)
-
-### 게시물 관리
-- 게시물 생성 / 조회 / 수정 / 삭제 (CRUD)
-- 작성자 권한 검증
-- 게시물 상태 관리
-  - 판매중 / 거래완료
-
-### 게시물 정보
-- 제목, 내용, 가격
-- 카테고리
-- 지역 정보
-- 이미지 다중 첨부  
-  → 이미지 업로드 기능을 활용
+## Tech Stack
 
-### 목록 조회
-- 최신순 / 가격순 정렬
-- 카테고리 필터
-- 지역 기반 필터
-- 페이지네이션 적용  
-  → **중고 거래(게시물) 페이지네이션**
+* **Backend**: FastAPI
+* **Database**: MySQL
+* **Storage**: AWS S3
+* **Infra**: Docker, Nginx
+* **CI/CD**: GitHub Actions
 
 ---
 
-## 3. 지역 선택
+## Workflow
 
-### 지역 설정
-- 유저 기본 지역 설정
-- 지역 변경 기능
-
-### 지역 기반 노출
-- 게시물 조회 시 지역 필터 적용
-- 내 지역 중심 피드 구성
+* 기본 작업 브랜치: `dev`
+* 기능 개발: `feature/<function>` 브랜치
+* 기능 완료 후 `dev` 병합 및 디버깅
+* 안정화 후 `main` 브랜치 병합
 
 ---
 
-## 4. 좋아요 / 즐겨찾기
+## Features
 
-### 좋아요 기능
-- 게시물 좋아요 등록 / 취소
-- 중복 좋아요 방지
+### 1. 인증 / 회원 관리
 
-### 관심 목록
-- 내가 좋아요한 게시물 목록 조회
-- 페이지네이션 적용  
-  → **프로필 페이지네이션**
+* 이메일 기반 회원가입 / 로그인
+* 비밀번호 해싱 및 중복 검사
+* JWT 인증 (Access / Refresh)
+* OAuth2 소셜 로그인 (확장)
 
----
+### 2. 게시물 (중고 거래)
 
-## 5. 중고 거래 + 가상 화폐 결제
+* 게시물 CRUD
+* 카테고리 / 지역 기반 필터링
+* 이미지 다중 업로드
+* 페이지네이션 지원
 
-### 가상 화폐(포인트)
-- 사용자 지갑 관리
-- 잔액 조회
-- 포인트 충전 (테스트용)
+### 3. 지역 설정
 
-### 거래 프로세스
-- 구매 요청 → 판매자 수락 → 결제 → 거래 완료
-- 거래 상태 관리
-  - `REQUESTED / ACCEPTED / PAID / COMPLETED / CANCELED`
+* 사용자 기본 지역 설정
+* 지역 기반 게시물 노출
 
-### 정합성 처리
-- 잔액 부족 검증
-- 중복 결제 방지
-- 트랜잭션 처리
+### 4. 좋아요 / 관심 목록
 
-### 거래 내역 조회
-- 구매 / 판매 내역 조회
-- 페이지네이션 적용  
-  → **프로필 페이지네이션**
+* 게시물 좋아요 등록 / 취소
+* 관심 게시물 목록 조회
 
----
+### 5. 가상 화폐 거래
 
-## 6. 채팅
+* 포인트 지갑 관리
+* 거래 상태 관리
+* 트랜잭션 기반 정합성 처리
 
-### 채팅 유형
-- 게시물 기반 1:1 채팅
+### 6. 채팅
 
-### 기능
-- 채팅방 생성
-- 메시지 전송 / 조회
-- 채팅방 목록 조회
+* 게시물 기반 1:1 채팅
+* WebSocket 실시간 메시지
+* 채팅방 / 메시지 페이지네이션
 
-### 실시간 통신
-- WebSocket 기반 실시간 메시지 처리
-- (선택) 읽음 상태 처리
+### 7. 경매 (추가 기능)
 
-### 목록 조회
-- 채팅방 목록 페이지네이션
-- 메시지 히스토리 페이지네이션  
-  → **채팅 페이지네이션**
+* 경매 게시물 관리
+* 입찰 시스템 및 동시성 제어
+* 낙찰 및 자동 결제 처리
 
 ---
 
-## 7. 경매 (추가 기능)
-
-### 경매 게시물
-- 경매 전용 게시물 생성
-- 시작가 / 즉시구매가 / 최소입찰단위
-- 경매 시작 / 종료 시간
-- 경매 상태 관리
-  - `SCHEDULED / LIVE / ENDED / CANCELED`
-- 이미지 첨부  
-  → 이미지 업로드 기능 활용
-
-### 경매 목록
-- 경매 게시물 목록 조회
-- 페이지네이션 적용  
-  → **경매 페이지네이션**
-
-### 그룹 채팅
-- 경매 참가자 전용 그룹 채팅방
-- 참가 버튼을 통한 입장
-- 시스템 메시지(입찰 갱신, 마감 안내 등)
-
-### 입찰 시스템
-- 입찰 금액 검증
-- 최소 입찰 단위 검증
-- 마감 이후 입찰 차단
-- 동시성 제어를 통한 최고가 보장
-
-### 낙찰 및 결제
-- 경매 종료 시 자동 낙찰 처리
-- 낙찰자 가상 화폐 결제
-- 거래 기록 생성
+## Contributing
+
+* 기능 단위로 브랜치 생성
+* PR 시 기능 설명 및 테스트 내용 명시