펫 인플루언서와 광고주를 연결하는 반려동물 헬스케어 & 마케팅 통합 플랫폼
2025.07.18 ~ 2025.09.10
PetFul은 펫 인플루언서와 광고주를 연결하는 반려동물 헬스케어 & 마케팅 통합 플랫폼입니다.
-
🐾 단일 회원가입 & 역할 기반 맞춤 기능
인플루언서와 광고주가 동일한 환경에서 각자의 필요에 최적화된 경험을 제공합니다. -
💡 다양한 기능 제공
반려동물 건강 관리, 광고상품 매칭, 체험단 운영, 커뮤니티 교류 등 펫 생태계 전 과정을 아우릅니다. -
🤖 최신 기술 접목
AI 기반 추천, 벡터 검색, 자동화된 게시물 분석을 통해 효율성과 신뢰성을 극대화합니다.
- MSA 아키텍처 기반 서비스 구현 및 운영 경험
- 실제 서비스 수준의 펫 인플루언서 플랫폼 개발
- CI/CD 파이프라인 구축 및 클라우드 배포 경험
- AI 기술 활용한 개인화 서비스 구현
| 이나영 | 이지용 | 임나연 | 임현우 | 정승원 |
|---|---|---|---|---|
 |
 |
 |
 |
 |
| GitHub | GitHub | GitHub | GitHub | GitHub |
| 광고주/체험단 서비스 | SNS관리/서버구축/인프라구축 | 건강관리 서비스 | 알림/커뮤니티/관리자 서비스 | 게이트웨이/유저 서비스/펫 서비스 |
graph TB
subgraph "Frontend"
FE[Next.js Frontend<br/>:3000]
end
subgraph "API Gateway"
GW[Gateway Service<br/>:8000]
end
subgraph "Core Services"
US[User Service<br/>:8081]
AS[Advertiser Service<br/>:8088]
CMS[Campaign Service<br/>:8089]
COMS[Community Service<br/>:8090]
NTS[Notification Service<br/>:8091]
PS[Pet Service<br/>:8092]
SNS[SNS Service<br/>:8093]
HS[Health Service<br/>:8087]
end
subgraph "Infrastructure"
DSV[Discovery Service<br/>:8761]
CFG[Config Service<br/>:8888]
DB[(MySQL)]
RD[(Redis)]
MQ[RabbitMQ]
end
FE --> GW
GW --> US
GW --> AS
GW --> CMS
GW --> COMS
GW --> NTS
GW --> PS
GW --> SNS
GW --> HS
US --> DSV
AS --> DSV
CMS --> DSV
COMS --> DSV
NTS --> DSV
PS --> DSV
SNS --> DSV
HS --> DSV
DSV --> CFG
US --> DB
AS --> DB
CMS --> DB
COMS --> DB
NTS --> DB
PS --> DB
SNS --> DB
HS --> DB
US --> RD
NTS --> MQ
NTS --> MQ
| 서비스명 | 담당자 | 주요 기능 |
|---|---|---|
| Gateway Service | 정승원 | API Gateway, 라우팅, 인증, 로드밸런싱 |
| User Service | 정승원 | 회원가입/로그인, JWT 토큰인가, 마이페이지 |
| Advertiser Service | 이나영 | 광고주 관리, 광고 상품 등록/관리 |
| Campaign Service | 이나영 | 캠페인 관리, 체험단 운영, 매칭 시스템 |
| Community Service | 임현우 | 커뮤니티 기능, 게시글/댓글 관리 |
| Notification Service | 임현우 | 알림 서비스, 푸시 알림, 이메일 발송 |
| Pet Service | 정승원 | 반려동물 관리, 펫스타 신청, 포트폴리오 |
| SNS Service | 이지용 | 인스타그램 연동, SNS 게시물 분석 |
| Health Service | 임나연 | 활동 관리, 투약/돌봄 일정 관리 |
| Discovery Service | 이지용 | Eureka 서버, 서비스 등록/발견 |
| Config Service | 이지용 | 공통 환경설정,repo파일로 설정 따로 관리 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- Java 17+
- Docker & Docker Compose
- Node.js 18+
- MySQL 8.0+
- Redis 7+
- 저장소 클론
git clone https://github.com/your-org/BE09-Final-3team-BE.git
cd BE09-Final-3team-BE- 환경 변수 설정
# .env 파일 생성
cp .env.example .env
# 필요한 환경 변수 설정- 인프라 서비스 실행
# Redis, RabbitMQ 실행
docker-compose up -d- 서비스 빌드 및 실행
# 모든 서비스 빌드
./gradlew build
# 서비스별 실행 (순서 중요)
# 1. Config Service
cd config-service && ./gradlew bootRun
# 2. Discovery Service
cd discovery-service && ./gradlew bootRun
# 3. Gateway Service
cd gateway-service && ./gradlew bootRun
# 4. 기타 서비스들
cd user-service && ./gradlew bootRun
cd pet-service && ./gradlew bootRun
cd advertiser-service && ./gradlew bootRun
cd campaign-service && ./gradlew bootRun
cd community-service && ./gradlew bootRun
cd notification-service && ./gradlew bootRun
cd sns-service && ./gradlew bootRun
cd health-service && ./gradlew bootRun- Frontend: http://localhost:3000
- Gateway: http://localhost:8000
- Discovery Service: http://localhost:8761
- Config Service: http://localhost:8888
- RabbitMQ Management: http://localhost:15672
- Redis: http://localhost:6379
POST /auth/signup # 회원가입
POST /auth/login # 로그인
POST /auth/refresh # 토큰 갱신
GET /auth/profile # 프로필 조회
PATCH /auth/profile # 프로필 수정POST /pets # 반려동물 등록
GET /pets # 반려동물 목록 조회
GET /pets/{id} # 반려동물 상세 조회
PUT /pets/{id} # 반려동물 정보 수정
DELETE /pets/{id} # 반려동물 삭제
POST /pets/{id}/portfolio # 포트폴리오 등록POST /advertisers/signup # 광고주 회원가입
POST /advertisers/login # 광고주 로그인
GET /advertisers/products # 광고 상품 목록
POST /advertisers/products # 광고 상품 등록
PUT /advertisers/products/{id} # 광고 상품 수정GET /campaigns # 캠페인 목록 조회
POST /campaigns # 캠페인 생성
GET /campaigns/{id} # 캠페인 상세 조회
PUT /campaigns/{id} # 캠페인 수정
POST /campaigns/{id}/apply # 캠페인 신청POST /sns/instagram/connect # 인스타그램 연동
GET /sns/instagram/profile # 인스타그램 프로필 조회
GET /sns/instagram/media # 인스타그램 게시물 조회
POST /sns/instagram/analyze # 게시물 분석GET /community/posts # 게시글 목록
POST /community/posts # 게시글 작성
GET /community/posts/{id} # 게시글 상세
POST /community/posts/{id}/comments # 댓글 작성GET /notifications # 알림 목록 조회
PUT /notifications/{id}/read # 알림 읽음 처리
POST /notifications/subscribe # 알림 구독- 동기 통신: REST API (HTTP/HTTPS)
- 비동기 통신: RabbitMQ (메시지 큐)
- 서비스 발견: Eureka Server
- 설정 관리: Spring Cloud Config
- 서비스 간 호출: OpenFeign
- 인증: JWT 토큰 기반
- 인가: Spring Security + Role-based
- API Gateway: 중앙 집중식 인증/인가
- CORS: 프론트엔드 도메인 허용
- 사용자 등록 → User Service
- 반려동물 등록 → Pet Service
- SNS 연동 → SNS Service
- 캠페인 생성 → Campaign Service
- 매칭 시스템 → 추천 알고리즘
- 알림 발송 → Notification Service
- 개발/프리뷰: https://petful-teal.vercel.app
- 실서비스: https://petful.site
# 이미지 빌드
docker build -t petful-gateway ./gateway-service
docker build -t petful-user ./user-service
docker build -t petful-pet ./pet-service
# ... 기타 서비스들
# 컨테이너 실행
docker run -d -p 8080:8080 petful-gateway- EC2: 서비스 호스팅
- ECS: 컨테이너 오케스트레이션
- RDS: MySQL 데이터베이스
- ElastiCache: Redis 캐시
- SES: 이메일 발송
# Jenkinsfile 예시
pipeline {
agent any
stages {
stage('Build') {
steps {
sh './gradlew build'
}
}
stage('Test') {
steps {
sh './gradlew test'
}
}
stage('Docker Build') {
steps {
sh 'docker build -t petful .'
}
}
stage('Deploy') {
steps {
sh 'docker push petful:latest'
}
}
}
}주요 역할: 광고주 서비스, 캠페인 관리, 광고 상품 등록/관리
느낀 점: 이번 프로젝트는 기획부터 개발, 배포까지 전 과정을 직접 경험해볼 수 있는 값진 기회였습니다. 과정 속에서 늘 새로운 문제들이 마주했지만, 단순히 포기하지 않고 원인을 집요하게 파고들며 해결했을 때 느낀 성취감은 말로 표현하기 어려울 만큼 컸습니다. 특히 체험단과 광고주 기능은 구현해야 할 범위가 넓고 복잡해서 초반에는 부담도 있었지만 하나씩 완성되어 눈앞에 결과물이 보일 때마다 큰 보람을 느낄 수 있었습니다.광고주-펫 인플루언서 간 협업을 위한 코사인 유사도 기반의 펫스타 추천 기능을 구현하는 과정은 저에게 가장 큰 도전이었습니다. FastAPI와 Uvicorn으로 별도의 파이썬 서버를 구축하고 이를 Spring Cloud Gateway와 연동하는 작업은 처음 해보는 일이었고 Hugging Face 모델 선택, 임베딩 벡터화, 코사인 유사도 계산, 그리고 Spring 서비스와의 API 연동까지 모든 과정이 낯설었습니다.
하지만 어려운 과정을 끝까지 밀고 나가면서 기한 내에 기능을 완성할 수 있었고 그 과정에서 게이트웨이 화이트리스트 관리, 토큰 재사용을 통한 서비스 간 API 호출 등 다양한 기술을 깊이 있게 다룰 수 있었습니다. 무엇보다도, 함께한 팀원들의 열정과 꾸준한 노력 덕분에 끝까지 힘을 내어 프로젝트를 완수할 수 있었습니다. 이번 경험은 단순한 기능 구현을 넘어, 문제 해결 능력과 협업의 가치를 몸소 느낄 수 있었던 소중한 자산이 되었다고 생각합니다.
주요 역할: SNS 연동, 인스타그램 API 연동, 서버 인프라 구축 , MSA 인프라 구축
느낀 점: 부트캠프의 마지막 프로젝트를 통해 기획부터 CI/CD 파이프라인 구축까지, 개발의 전 과정을 온전히 경험할 수 있었습니다. 특히 인스타그램, CLOVA 등 외부 API를 연동하며 기술의 확장성을 체감했고, 자동 댓글 관리 기능을 성공적으로 구현했을 때의 뿌듯함은 잊을 수 없습니다. 인프라 설정부터 최종 배포까지, 수많은 시행착오를 동료들과 함께 해결해나가며 느꼈던 희열은 최고의 동기부여가 되었습니다. 단순히 코드를 작성하는 것을 넘어, 하나의 서비스를 완성해가는 과정 속에서 문제 해결 능력과 협업의 중요성을 깊이 깨달았습니다. 이번 프로젝트는 미래의 개발자로서 갖춰야 할 실전 역량을 미리 경험해 볼 수 있었던 귀중한 자산이 되었습니다.
주요 역할: 헬스 서비스
느낀 점: 서비스를 맡아 반려동물의 활동 및 투약 일정을 체계적으로 관리할 수 있는 기능을 구현했습니다. Clova OCR API를 활용해 처방전 텍스트를 자동 추출·파싱하며, 외부 API 연동 경험과 안정적인 인식 로직 설계 가능성을 확인할 수 있었습니다. 여러 테스트를 거쳐 템플릿 기반 방식을 적용하니 원하는 데이터를 안정적으로 추출할 수 있었고, 추출된 정보를 일정 등록과 연결해 실제 서비스 흐름 안에서 활용하는 과정을 경험하며 기능 확장의 가능성과 한계를 직접 체감할 수 있었습니다.또한 통합 스케줄러를 설계해 투약 일정과 돌봄 일정을 구분하고, 일정 유형별 반복 주기를 반영하면서 날짜 검증, 입력 제한, 예외 처리 등 다양한 케이스를 고려했습니다. 단순 반복이 아닌, 실제 사용자가 편리하게 쓸 수 있는 구조를 고민하다 보니 기능 하나에도 예상보다 많은 설계와 검증 과정이 필요하다는 것을 깨달았고, 요구사항 변경과 기능 확장으로 ERD를 여러 차례 수정하며 설계와 구현 간의 차이를 실감했습니다. 이를 통해 데이터 모델링을 유연하게 설계하는 역량의 중요성도 배울 수 있었습니다.
마지막 프로젝트를 통해 단순 기능 구현을 넘어, MSA 구조 속에서 기획–프론트엔드/백엔드 개발–테스트까지 전체 흐름을 경험하며, 서비스 완성도를 높여가는 과정에서 협업과 문제 해결의 가치를 체감하고 개발자로서 한 단계 성장할 수 있었습니다.
주요 역할: 알림 서비스, 커뮤니티 기능, 관리자 대시보드
느낀 점: 이번 프로젝트를 통해 마이크로서비스 아키텍처와 실시간 알림 시스템을 처음으로 구현해보면서, 대규모 시스템 설계의 복잡성과 중요성을 깊이 이해할 수 있었습니다. 특히 Web Push API 구현 과정에서 브라우저와 서버 간의 복잡한 인증 과정을 학습하고, 비동기 처리를 통한 성능 최적화 방법을 체득할 수 있었습니다. RabbitMQ를 통한 이벤트 기반 아키텍처 구현으로 서비스 간 결합도를 낮추고 확장성을 확보할 수 있었으며, 향후 Kafka로의 마이그레이션을 통해 더욱 대규모 트래픽을 처리할 수 있는 시스템으로 발전시킬 수 있을 것 같습니다. 가장 중요한 교훈은 협업의 중요성이었습니다. 중간에 팀원의 코드가 날아간 경험을 통해 Git 사용의 중요성과 정기적인 백업의 필요성을 절실히 느꼈습니다. 또한 팀원 간의 소통과 상호 지원이 프로젝트 성공에 얼마나 중요한지 깨달을 수 있었습니다. 관리자 기능을 여러 서비스에 걸쳐 구현하면서 일관성 있는 API 설계와 권한 관리의 중요성도 깨달았습니다. 앞으로는 모니터링과 로깅 시스템을 더욱 강화하여 운영 안정성을 높이고, 협업 프로세스를 개선하여 더욱 효율적인 팀워크를 만들어가고 싶습니다.
주요 역할: API Gateway, 유저 서비스, JWT 토큰 구축, 펫 서비스, 파일서버 연동
느낀 점
MSA 아키텍처에서 중요한 역할을 하는 게이트웨이를 직접 구축하면서 보안의 중요성을 깊이 체감할 수 있었습니다.
특히 JWT 기반 인증·인가를 처음 적용하다 보니 초반에는 로직 이해에 어려움이 있었지만,
시행착오를 거치면서 점차 구조를 익히고 문제를 해결할 수 있었습니다.초기에는 막막함과 부담감이 컸지만, 오류를 하나씩 고쳐 나가면서 경험이 쌓였고,
다른 서비스와 토큰 인가가 연결될 때 발생하는 영향까지 고려하는 사고를 배울 수 있었습니다.해결 과정에서는 웹 서핑과 이전 프로젝트 코드 분석을 통해 차이점을 파악하고 적용했으며,
팀원들의 꾸준한 피드백이 큰 도움이 되었다. 또한 파일 서버 연동을 통해 단순히 파일을 업로드하는 것을 넘어
DB와 직접 연결해 URL 기반으로 관리·표시하는 방식을 구현하면서 많은 배움을 얻을 수 있었습니다.이메일 발송 기능 구현 과정에서는 Redis를 Docker 환경에 적용하는 방법을 다시 학습했고,
구글 오픈 키를 이용해 실제로 이메일 발송 기능을 완성했을 때 뿌듯함을 느꼈습니다.이번 부트캠프 마지막 프로젝트를 통해 다양한 기술을 직접 경험하며 단순 구현을 넘어
보안·인프라·데이터 처리 전반의 실무 감각을 익힐 수 있었습니다.
앞으로도 이번에 익힌 다양한 스킬들을 토대로 실무 환경에서 적극적으로 적용하고 성장해 나가볼려고 합니다.
🐕 PetFul과 함께 펫 인플루언서의 새로운 경험을 시작하세요! 🐕