🐧 대규모 모임 관리 시스템 - MOIM

대규모 모임의 인원관리, 일정조율, 소통을 효율적으로 도와주는 MSA 기반 모임 통합 관리 서비스
개발 기간 : 2025.04 ~ 2025.05

🎯 Members (팀원 및 팀 소개)

김형주	박용훈	최진영	김대연	박규원
게시글, 일정	소모임, 세션	회원	알림, 모임	채팅, 댓글
Lead	Tech Lead	BE	BE	BE

✨ Getting Started (서비스 URL 및 API 명세서)

• 서비스 URL : https://moim.agong.store
• API : (wiki에 문서화할 예정입니다.)

🧑‍💻 About Project

🧩 서버 아키텍처

프로젝트 목적

• 대규모 모임 관리를 보다 쉽고 편하게 도와주는 서비스 입니다.

프로젝트 설명

• 모든 인원이 공지를 확인할 수 있도록 주기적으로 알람을 보내주고, 선착순 세션, 채팅, 투표 등의 부가적인 기능을 통해 모임을 관리를 수월하게 할 수 있도록 지원해줍니다.

프로젝트 구성

• 회원, 세션, 알림, 채팅, 모임, 소모임, 게시글, 댓글, 일정 도메인으로 이루어져 있으며, 서비스 간의 통신은 FeignClient로 이루어집니다. 또한 Kafka를 사용하여 이벤트 기반 아키텍처를 구성하였으며, OpenTelemetry를 통하여 모든 로그들을 효율적으로 수집하였으며, 분산추적을 수행하였고, Grafana로 시각화를 진행하여 지속적인 모니터링을 진행했습니다.

아키텍쳐 설명

• MSA 기반이며, 각 서비스 인스턴스들은 AWS ECS 에서 동작합니다. 젠킨스를 통한 CI/CD 파이프라인을 구축하였습니다. RDB는 MySQL을 사용하였고, AWS RDS에 DB서버를 구축하였습니다. NoSQL인 Redis와 MongoDB는 AWS EC2에 구축하였습니다. Kafka/Zookeeper, Prometheus, Grafana, Grafana Tempo, Grafana Loki, OpenTelemetry는 AWS EC2에 배포환경을 구축하였습니다.

🔑 Key Features (주요 기능)

• 회원:

  • 회원가입이 가능합니다.username은 유니크하며, password는 인코딩되어 저장됩니다.
  • 로그인/로그아웃이 가능합니다. 로그인 시 JWT를 쿠키로 발급하고, 로그아웃 시 쿠키를 만료시킵니다.
  • 게이트웨이로부터 인증 요청이 들어오면, 검증을 수행한 뒤 Passport를 발급합니다. Passport는 각 서비스에서 현재 요청의 유저 정보로 활용됩니다.
  • 회원 조회, 수정, 삭제가 가능합니다.

• 세션:

  • 세션 생성/수정이 가능합니다.
  • 세션에 참여/나가기가 가능하도록 설계되었습니다.
  • 세션 생성을 하게 되면 모임 - 매니저가 승인을 시켜 세션을 활성화가 가능합니다.
  • 다수의 사용자가 동시에 입장할 수 있도록 루아스크립트를 통해 원자성을 제어하고 있습니다.

• 알림:

  • 다양한 서비스로부터 발생한 이벤트를 수신하여 알림을 생성합니다. 예를 들어, 모임 가입 신청, 승인 등의 이벤트를 처리합니다.
  • 이벤트 타입에 따라 사전에 정의된 알림 템플릿을 사용하여 사용자에게 전달할 알림 메시지를 자동으로 생성합니다.
  • 생성된 알림은 DB에 저장되며, 각 알림은 읽음/안읽음 상태를 통해 구분됩니다. 이를 기반으로 필터링된 알림 조회가 가능합니다.
  • 다양한 알림 유형이 전략 패턴 기반으로 구현되어 있어 새로운 알림 타입이 쉽게 확장 가능합니다.

• 채팅:

  • ws-stomp를 통해 실시간 채팅이 가능합니다. (1대1 채팅과 1대N 채팅이 가능합니다)
  • Kafka를 채팅 브로커로 사용하여, 대용량 채팅 트래픽을 견딜 수 있도록 설계되었습니다.
  • 기획상으로, 모임 1개당 채팅방을 1개만 생성할 수 있도록 설계되었지만, 추후 확장이 가능합니다.

• 모임:

  • 사용자는 새로운 모임을 생성할 수 있으며, 모임 이름, 설명, 모집 조건 등 다양한 정보를 입력하여 개설할 수 있습니다.
  • 사용자는 관심 있는 모임에 신청할 수 있고, 관리자는 신청자를 승인 또는 거절할 수 있습니다. 이 과정은 알림 시스템과 연동됩니다.
  • 관리자는 모임에 가입된 멤버들의 Role을 부여하거나, 멤버를 추가/삭제할 수 있습니다. Role에 따라 접근 권한이 구분됩니다.
  • 모임 멤버 정보를 캐시(Redis)에 저장하여 조회 성능을 향상시켰습니다. 자주 조회되는 멤버 정보 요청에 빠른 응답이 가능합니다.

• 소모임:

  • 소모임 생성/수정이 가능합니다.
  • 소모임에 참여/나가기가 가능하도록 설계되었습니다.

• 게시글

  • 모임별 게시글 관리가 가능하며, 게시글은 피드 혹은 투표로 생성할 수 있습니다.
  • 권한에 따라 게시글 수정 및 삭제가 가능합니다.
  • 조회가 빈번할 것으로 판단하여, CQRS를 활용하여 읽기 DB(MongoDB)를 분리함으로써 조회 성능을 높였습니다.
  • DB 사이의 데이터 일관성은 이벤트 소싱으로 구성했으며, 정확히 한번을 보장하기 위해 OutBox패턴과 멱등적 소비자 패턴을 활용하였습니다.
  • 캐시와 인덱스를 활용하여 조회 성능을 더욱 최적화 가능합니다.

• 댓글

  • 게시글과 댓글 도메인은 분리되어 있습니다.
  • 부모댓글과 자식댓글을 구분하여 댓글과 대댓글을 구분지었습니다.
  • 게시된지 시간이 지난 게시글의 댓글은 수정이 빈번하게 일어나지 않는다고 판단하여, 댓글 조회 최적화를 위해 캐싱을 도입하였습니다.
  • 게시글이 삭제되면, 댓글도 모두 삭제되는 트랜잭션을 갖고 있습니다.

• 일정

  • 모임별 일정 관리가 가능합니다.
  • 모임의 권한에 따라 일정을 수정하고, 삭제할 수 있습니다.

📚 트러블 슈팅

• 🚧 알림 서비스 잦은 INSERT로 인한 DB 부하
• 🚧 taggedIds 변경시, 발생하는 쿼리 수 최적화

💬 개발 과정에서의 고민 (구현/로직/리팩토링)

• 🤔 대기큐 처리 속도 개선
• 🤔 Redisson 기반 세션 참가 기능 최적화 과정
• 🤔 쿼리튜닝 ‐ 쓰기 최적화
• 🤔 관측 환경 구축 Part#1
• 🤔 관측 환경 구축 Part#2

📊 ERD

🔗 ERDCloud Link

📝 Technology Stack (기술 스택)

Framework

Database

Monitoring

Infra

🎲 Development Convention (개발 컨벤션)

• 🚀 개발 컨벤션

📌 Development Workflow (개발 워크플로우)

• 🚀 Development Workflow (개발 워크플로우)