Skip to content

Repository files navigation

제목: 미루어보자

취향을 분석해서 영화를 만든다

🎬 미루어보자 (Mirueoboja)

Version Python Node.js MongoDB License

AI 기반 개인 맞춤형 영화 추천 플랫폼

취향을 분석해서 당신만을 위한 영화를 찾아드립니다 🎥

데모 보기 · 모바일 버전 · 이슈 제보


📋 목차


✨ 주요 기능

🎭 AI 취향 분석

  • Claude AI 기반 개인화된 취향 분석
  • 사용자 선호도 학습 및 저장
  • 실시간 영화 추천 알고리즘

🎬 스마트 추천

  • 장르, 감독, 배우 기반 추천
  • 평점 및 리뷰 데이터 활용
  • 최신 트렌드 반영

👤 사용자 관리

  • JWT 기반 보안 인증
  • 개인 프로필 및 취향 관리
  • 시청 기록 추적

📱 반응형 디자인

  • 모바일 최적화 UI
  • 크로스 플랫폼 지원
  • 직관적인 사용자 경험

🎯 프로젝트 개요

미루어보자는 AI를 활용하여 사용자의 영화 취향을 분석하고, 개인화된 영화를 추천하는 플랫폼입니다. 무엇을 볼지 고민하는 시간을 줄이고, 당신이 진짜 좋아할 영화를 찾아드립니다.

💡 탄생 배경

  • 넷플릭스 같은 OTT 서비스의 영화가 너무 많아서 선택이 어려움
  • 단순 평점이 아닌 개인 취향 기반 추천의 필요성
  • AI 기술을 활용한 더 정확한 추천 시스템 구현

🏗️ 기술 스택

Backend

Node.js

Database

MongoDB Mongoose

Frontend

Next.js
React
TypeScript
TSX

AI/ML

Claude AI
Gemini

DevOps & Tools

Git GitHub Postman


🚀 빠른 시작

전제 조건

# Node.js 18.0 이상
node --version

# MongoDB 설치 또는 MongoDB Atlas 계정
---

## 📦 설치된 모든 확장
mhutchie.git-graph
ms-python.debugpy
ms-python.python
ms-python.vscode-pylance
ms-python.vscode-python-envs
ms-toolsai.jupyter
ms-toolsai.jupyter-keymap
ms-toolsai.jupyter-renderers
ms-toolsai.vscode-jupyter-cell-tags
ms-toolsai.vscode-jupyter-slideshow


## 실행방법

cd backend
1.node server.js 
2.ngrok [아이피] [포트]
따로

#### 📄 package.json
```json
{
  "name": "backend",
  "version": "1.0.0",
  "type": "module", 
  "main": "server.js"

}
---

API 테스트

# HumanMovieProject API 명세 ()

이 문서는 HumanMovieProject 서버에서 제공하는 주요 API 엔드포인트를 한눈에 확인할 수 있는 명세입니다.
API 테스트하는법 postman
---

## 1. 질문 목록 조회
- **URL**: `http://125.129.177.130:4000/questions`  
- **설명**: 사용자의 영화/음악 취향을 묻는 질문 목록 반환  

---

## 2. 인기 영화 추천
- **URL**: `http://125.129.177.130:4000/select1`  
- **설명**: 인기 영화 리스트 반환  

---

## 3. 최근 개봉작 추천
- **URL**: `http://125.129.177.130:4000/select2`  
- **설명**: 최근 개봉 영화 리스트 반환  

---

## 4. 장르별 추천
- **URL**: `http://125.129.177.130:4000/select3`  
- **설명**: 장르별 추천 영화 리스트 반환  

---

## 5. 추천 받기 (영화 + 음악)
- **URL**: `http://125.129.177.130:4000/recommend`  
- **설명**: 사용자가 선택한 항목 5개를 기반으로 영화 3개 + 음악 3개 추천  

---

## 6. 선택 기록 확인
- **URL**: `http://125.129.177.130:4000/selections`  
- **설명**: 지금까지 저장된 사용자의 선택 목록 조회  


📁 프로젝트 구조

mirueoboja/
├── 📂 backend/                 # Node.js 백엔드
│   ├── server.js              # 메인 서버
│   ├── package.json           # 의존성
│   ├── .env                   # 환경 변수
│   └── models/                # MongoDB 스키마
│       ├── User.js
│       ├── Movie.js
│       └── Recommendation.js
│
├── 📂 python-backend/         # Python AI 엔진
│   ├── main.py                # FastAPI 서버
│   ├── requirements.txt       # Python 의존성
│   ├── .env                   # 환경 변수
│   └── services/
│       ├── ai_service.py      # Claude AI 연동
│       └── recommendation.py  # 추천 알고리즘
│
├── 📂 frontend/               # 프론트엔드 (선택사항)
│   ├── index.html
│   ├── styles.css
│   └── app.js
│
├── 📂 docs/                   # 문서
│   ├── API.md                 # API 문서
│   └── ARCHITECTURE.md        # 아키텍처 설명
│
├── .gitignore
├── README.md
└── LICENSE

📞 문의 및 지원


👥 팀


황인성

Backend Lead

임찬혁

AI Engineer

📄 라이선스

이 프로젝트는 MIT 라이선스를 따릅니다. 자세한 내용은 LICENSE 파일을 참고하세요.


🙏 감사의 말


⭐ 이 프로젝트가 마음에 드셨다면 Star를 눌러주세요! ⭐

Made with ❤️ by Mirueoboja Team

🔝 맨 위로 가기

About

취향을 분석해서 영화를 만든다

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages