https://github.com/setung/photogram
https://github.com/setung/photogram
Last synced: 12 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/setung/photogram
- Owner: setung
- Created: 2025-04-01T12:55:51.000Z (about 1 year ago)
- Default Branch: develop
- Last Pushed: 2025-04-16T16:15:17.000Z (about 1 year ago)
- Last Synced: 2025-04-17T00:13:11.972Z (about 1 year ago)
- Language: Kotlin
- Size: 218 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# photogram
Instagram을 모티브로 한 MSA 기반의 SNS 프로젝트입니다.
대규모 트래픽 처리와 이벤트 기반 아키텍처 설계를 목표로 구현되었습니다.
---
## 프로젝트 목표
- MSA 구조 설계 및 구현
- Kafka 기반 이벤트 처리 경험
- ElasticSearch를 활용한 태그 기반 검색
- 대규모 시스템 설계 및 트래픽 처리 구조 학습
---
## 시스템 아키텍처
- **Gateway**: 진입점, JWT 인증 및 라우팅
- **Discovery**: 마이크로서비스 등록 및 위치 탐색
- **Config**: 설정 중앙관리
- **User-service**: 회원가입, 로그인, 유저/팔로우 관리
- **Post-service**: 게시글, 이미지 업로드, 좋아요, 댓글
- **Feed-service**: 팔로우 기반 피드 구성
- **Post-Search-service**: 태그 기반 게시글 검색
---
## 기술 스택
| 분류 | 기술 |
|------------------|--------------------------------------------------------------|
| Backend | Spring Boot (Kotlin), Spring Cloud |
| DB | MySQL, Redis |
| 메시징 | Kafka |
| 검색 | ElasticSearch |
| 스토리지 | AWS S3 |
| 이메일 | AWS SES |
| 인프라 | Config Server, Discovery(Eureka), Gateway |
| 모니터링 | Micrometer, Grafana, Prometheus |
| 분산 추적 | Sleuth, Zipkin |
| 장애 대응 | Resilience4j |
---
## 실행 방법
```bash
./gradlew build
docker-compose up
```
---
## [마이크로서비스간 장애 전파 막기](https://dev-setung.tistory.com/58) (Resilience4j + Redis)
**문제점**
- Post-service에서 게시글 조회 시, 작성자 정보를 User-service에 의존함 → User-service 장애 시 Post-service도 함께 실패하는 장애 전파 문제 발생
**해결방안**
- Redis 캐싱: User-service 응답을 Redis에 저장, 이후 요청 시 캐시 우선 조회
- Resilience4j CircuitBreaker + Fallback: 캐시 미스 + User-service 장애 시, Fallback으로 비공개 사용자 정보 반환
---
## [태그 기반 게시글 검색](https://dev-setung.tistory.com/56) (ElasticSearch + Kafka)
- 게시글 저장 시 Kafka를 통해 게시글 정보를 `post-search-service`로 전송
- `post-search-service`는 해당 데이터를 ElasticSearch에 인덱싱
- 검색 요청 시 ES에서 `multi_match` 쿼리로 태그 기반 게시글 검색 수행
- 태그 자동 완성 또는 관련성 높은 검색 기능 확장 가능
---
## [Push 기반 피드 구현](https://dev-setung.tistory.com/57)
- 클라이언트가 게시글 업로드 요청을 보낸다.
- post-service는 게시글을 DB에 저장한 뒤, 게시글 업로드 이벤트를 Kafka로 발행한다.
event_payload : { postId, writerId }
- feed-service는 Kafka에서 해당 업로드 이벤트를 pull(구독) 한다.
- 이벤트를 가져온 feed-service는 writerId를 기반으로 user-service에 팔로워 목록을 요청한다.
- 받아온 팔로워 목록을 순회하며, 각 유저의 피드 정보(Redis, Sorted Set)에 업로드된 게시글 ID를 저장한다.
- 사용자가 피드를 조회할 때, Redis에 저장된 게시글 ID를 통해 빠르게 가져올 수 있게 된다.
---
## [인증 시스템](https://dev-setung.tistory.com/55) (JWT + Gateway 인증 필터)
- 로그인 시 `user-service`에서 JWT를 생성하고 클라이언트에 전달
- 모든 요청은 `Gateway`에서 JWT를 검증 후 `user-id`를 헤더로 추가해 마이크로서비스로 전달
- 각 서비스에서는 `user-id`를 통해 인증된 사용자 정보를 활용
- 익명 사용자 요청도 지원 (JWT 미포함 시 `user-id: -1`로 간주)
- 인증이 필요한 API와 아닌 API를 구분할 수 있는 설정 제공 (`allowAnonymous`)
---