[2025 상반기] 💌조각집 - 기억 저장 및 공유 서비스 웹페이지 제작

코드잇부스트 동아리의 마지막 활동으로 부스트 데모데이에 참여하게 되었다. 이번 프로젝트의 <조각집>은 추억을 저장하고 공유할 수 있는 서비스이다. 코드잇부스트에서는 개발에만 집중할 수 있도록 디자인 시안을 제공해줬다. 따라서 이번 프로젝트에서는 제시된 모든 기능 요구사항을 충족하기 위하여 백엔드 개발에 집중하였다.

먼저 프로젝트 개요는 다음과 같다.

---

프로젝트 개요

개발 기간 2025.02.04 ~ 2025.02.22 (2주)

플랫폼 Web

개발 인원 7명 (백엔드4 / 프론트엔드2)

담당 역할 - 백엔드 • 로그인 및 회원 관리 (기여도 100%)
• 마이페이지 웹서버 구현 (기여도 100%)
• 서비스 기획 및 방향성 설정 (기여도 80%)

🔒개발 환경

🚀 Stacks HTML, CSS(SCSS), JavaScript, React.js, Node.js

🛠 Tools Figma, Git

👥 Collaboration GitHub, Notion, Discord, Slack

---

본격적인 프로젝트 작업에 들어가기에 앞서 팀원들과 프로젝트 작업 일정과 규칙을 조율하고 아래와 같은 소통 방식을 사용했다.

---

웹페이지 디자인 수정

기존에 코드잇에서 제공했던 디자인과 요구사항 중에 몇 가지 내용을 변경하여 아래와 같은 디자인으로 새롭게 디자인했다.

구체적인 변경 내용은 다음과 같다.

---

API 명세서

그룹 및 게시글 API 명세서

섹션	Method	URL	기능/설명
그룹	POST	/api/groups	그룹 등록
그룹	GET	/api/groups	그룹 목록 조회
그룹	PUT	/api/groups/{groupId}	그룹 수정
그룹	DELETE	/api/groups/{groupId}	그룹 삭제
그룹	GET	/api/groups/{groupId}	그룹 상세 정보 조회
그룹	POST	/api/groups/{groupId}/verify-password	그룹 조회 권한 확인
그룹	POST	/api/groups/{groupId}/like	그룹 공감하기
그룹	GET	/api/groups/{groupId}/is-public	그룹 공개 여부 확인
게시글	POST	/api/groups/{groupId}/posts	게시글 등록
게시글	GET	/api/groups/{groupId}/posts	게시글 목록 조회
게시글	PUT	/api/posts/{postId}	게시글 수정
게시글	DELETE	/api/posts/{postId}	게시글 삭제
게시글	GET	/api/posts/{postId}	게시글 상세 정보 조회
게시글	POST	/api/posts/{postId}/verify-password	게시글 조회 권한 확인
게시글	POST	/api/posts/{postId}/like	게시글 공감하기
게시글	GET	/api/posts/{postId}/is-public	게시글 공개 여부 확인
댓글	POST	/api/posts/{postId}/comments	댓글 등록
댓글	GET	/api/posts/{postId}/comments	댓글 목록 조회
댓글	PUT	/api/comments/{commentId}	댓글 수정
댓글	DELETE	/api/comments/{commentId}	댓글 삭제

---

🌿 Userflow

역할분담

• 그룹 목록 페이지 (기여도 100%)
• 그룹 상세 페이지 (기여도 100%)
• 추억 상세 페이지 (기여도 100%)
• 공개 그룹 목록 페이지 (기여도 100%)
• 댓글 작성/수정/삭제 페이지 (기여도 100%)
• 메인페이지 (기여도 70%)
• 마이페이지 (기여도 60%)

---

ERD 다이어그램

---

수상

---

회고

API 키 설정과 로컬 개발 환경에서 ‘서버 테스트’를 진행하는 데 여러 어려움이 있었다. 특히 환경 변수를 설정하고 로컬과 배포 서버 간의 차이점을 이해하는 데 다소 시간이 걸렸다.

그리고 Prisma와 데이터베이스 스키마 관리에서도 복잡한 상황을 겪었다. 직접 SQL 명령어로 데이터베이스 컬럼을 추가하게 되면서 Prisma 스키마와 실제 데이터베이스 구조가 일치하지 않는다는 문제가 발생했다. 이로 인해 팀원들과의 데이터베이스 migration 과정에서 충돌이 생다.

따라서 먼저 .env 파일을 통해 환경 변수를 관리하고, Postman을 활용해서 각각의 API 를 단계별로 검증하는 과정을 거쳤다.

그리고 팀원들과 계속적으로 소통하면서, DB 스키마 관리에서 발생한 문제를 해결했다. 데이터베이스 스키마와 코드 간의 일관성을 유지했고, 팀 전체가 동일한 데이터베이스 상태를 공유할 수 있도록 변경사항이 있을 때마다 공지를 하는 등 소통 횟수를 늘려나갔다.

직접 SQL 명령어로 DB를 변경하면서 발생한 스키마 불일치 문제를 해결하기 위해서는 Prisma의 마이그레이션 도구를 활용했다. 우선 로컬 환경에서 발생하는 문제를 해결해야 했고, 그 후에는 서버에서 발생할 수 있는 오류를 줄여나갔다.

---