🐂 Bulls & Bears Backend

주식 초보자들을 위한 배당금 수익 예측 서비스 Bulls & Bears의 백엔드 서버입니다.

🧑‍💻 역할

Bulls & Bears Backend는 서비스의 핵심 데이터와 비즈니스 로직을 담당하는 서버 애플리케이션입니다.

주요 역할은 다음과 같습니다:

• 사용자 인증 및 권한 관리 (JWT 기반)
• 배당 데이터 및 포트폴리오 관리
• Redis 캐싱을 통한 성능 최적화
• 외부 금융 API 연동
• 클라우드 배포 및 확장 고려한 설계

🎨 아키텍처

[User] <----> [Frontend] <----> [Backend Server] <----> [MySQL / Redis / 외부 금융 API]

• Backend Server: Spring Boot 기반 API 서버
• Database: MySQL (거래/배당 데이터 관리)
• Cache: Redis (조회 성능 향상)
• External API: 주식/금융 데이터 연동

🔌 예제 API 흐름

1. 사용자가 로그인 요청

POST /api/auth/login
{
  "username": "user1",
  "password": "password"
}

2. 서버는 JWT 토큰 발급 후 반환

{
  "token": "eyJhbGciOiJIUzI1NiIsInR..."
}

3. 사용자는 토큰으로 거래/배당 데이터 요청

GET /api/dividends/current
Authorization: Bearer <token>

---

🧰 기술 스택

🚀 Getting Started

# Clone
git clone https://github.com/kkkwp/server.git
cd server

# Build
./gradlew clean build

# Run
./gradlew bootRun

• 기본 포트: 8080
• 환경설정: src/main/resources/application.yml (DB, Redis, 외부 API Key)

---

⚙️ CI/CD 요약

• CI: GitHub Actions → 빌드/테스트 및 Docker 이미지 생성
• CD: DockerHub → Kubernetes / Docker Compose 배포

---

📄 참고

👉 서비스 전체 개요 및 클라이언트는 팀 레포지토리 참고