배추마켓 (CABBAGE-MARKET)

목차

1. 프로젝트 소개
2. 기술 스택
3. 주요 기능
4. 실행 화면
5. 프로젝트 구성도
6. 개발 팀 소개
7. 개발 기간

프로젝트 소개

사용자가 중고 물품을 등록하고, 게시글을 통해 거래할 수 있는 중고거래 특성을 반영한 게시판 기반 웹 플랫폼

기술 스택

Front-end

HTML5	CSS3	JavaScript

Back-end

Spring	MySQL	GCP

주요 기능

기능	설명
게시글 관리	게시글 작성, 수정, 삭제, 조회 및 검색 기능 지원 이미지 포함 가능, 제한된 게시글은 작성자 또는 관리자만 조회 가능
댓글 기능	게시글에 댓글 작성, 수정, 삭제 가능
좋아요 기능	게시글에 좋아요 토글(등록/취소) 및 현재 사용자의 좋아요 여부 확인 가능
게시글 신고	게시글에 대한 신고 기능 제공 (사유 포함), 관리자 페이지에서 신고 내역 확인 가능
반성문 제출 및 승인	제한된 게시글에 대해 반성문 제출 가능 (100자 이상), 관리자는 반성문 조회 및 승인/거절 처리
게시글 제한 관리	신고 누적으로 제한된 게시글 목록을 관리자 페이지에서 확인 가능
마이페이지 관리	현재 로그인 사용자의 정보 조회 및 이름, 프로필 이미지 수정/초기화 가능
회원가입 및 인증	사용자 회원가입, 로그아웃, 현재 로그인 사용자 정보 조회 가능
조회수 추적	게시글을 열람할 때마다 조회수 증가 처리 가능 (IP주소 당 30초에 1번)

API 목록

API 종류	메서드	URL	설명
Admin	GET	/posts/restricted	신고 누적으로 제한된 게시글 목록 조회
	GET	/reports	전체 신고 내역 조회
	GET	/apologies	승인 대기 중인 반성문 목록 조회
	GET	/apologies/{id}	특정 반성문 상세 조회
	POST	/apologies/{id}/review?accept=...	반성문 승인 또는 거절 처리 (accept=true/false)
Comment	POST	/posts/{postId}/comments	특정 게시글에 댓글 작성
	PUT	/comments/{commentId}	댓글 수정
	DELETE	/comments/{commentId}	댓글 삭제
Like	POST	/{postId}	게시글 좋아요 또는 좋아요 취소 (토글)
	GET	/{postId}	현재 로그인 사용자의 게시글 좋아요 여부 조회
Post	GET	/posts	전체 게시글 목록 조회 (페이징 지원)
	GET	/posts/{postId}	게시글 상세 조회 ※ 제한 게시글은 작성자 또는 관리자만 접근 가능
	POST	/posts	게시글 작성 (이미지 포함, multipart/form-data)
	PUT	/posts/{postId}	게시글 수정 (이미지 포함, multipart/form-data)
	DELETE	/posts/{postId}	게시글 삭제 (작성자만 가능)
	POST	/posts/{postId}/view	게시글 조회수 증가
	GET	/posts/search	게시글 검색 검색어, 가격 범위, 상태(enum) 등 조건 지원
Report	POST	/apologies/{postId}	제한된 게시글에 대한 반성문 제출 (최소 100자 이상)
	POST	/reports/{postId}	특정 게시글에 대한 신고 등록 (신고 사유 포함)
Auth	POST	/users/register	사용자 회원가입
	POST	/users/logout	로그아웃 (세션 무효화)
	GET	/users/me	현재 로그인된 사용자 정보 조회
MyPage	GET	/users/mypage	현재 로그인된 사용자의 마이페이지 정보 조회
	PUT	/users/mypage/profile	사용자 이름(프로필 정보) 변경
	PUT	/users/mypage/profile-image	프로필 이미지 수정 (multipart/form-data)
	DELETE	/users/mypage/profile-image/reset	프로필 이미지를 기본 이미지로 초기화

실행 화면

메인화면	게시글 목록 + 검색 필터 화면

게시글 작성 화면	게시글 상세 조회 화면

반성문 작성 화면	관리자 반성문 승인 화면

마이페이지	신고 등록 화면

프로젝트 구성도

• SW 아키텍처

• ERD

개발 팀 소개

장현서	이본규

이름	역할	개발 내용
장현서	Frontend, Backend	- Post/Comment/Admin 도메인 구현 - GCS 이미지 업로드 구현 - 좋아요 동시성 해결 - UI 설계
이본규	Frontend, Backend	- User/Like/Report 도메인 구현 - Spring Security - 조회수 기능(캐시메모리) - UI 설계

개발 기간 및 일정

• 2025.05.08 ~2025.05.16(1주)