RedPill

Team Members:

1. Sakibul Hassan Shovon - ID: 20220204060
2. Md. Iftekhar Zawad - ID: 20220204067
3. Ariful Islam - ID: 20220204071
4. Mahfuza Sultana Borsha - ID: 20220204084

Project Live Link: https://redpill-sandy.vercel.app/

---

Table of Contents

1. Project Description
2. Workflow Overview
3. Main Features
4. Technologies Used
5. System Architecture
6. Setup Guidelines
   • Backend
   • Frontend
7. Running the Application
8. Deployment Status & Tests
9. Contribution Table
10. Screenshots
11. Limitations / Known Issues

---

1. Project Description

RedPill is a full-stack movie platform for discovering, reviewing, and discussing movies. It offers AI-powered recommendations, a social community, and a modern UI for movie lovers. Users can search, review, manage watchlists, and interact with others.

---

2. Workflow Overview

User registration/login → Browse/search movies → Add to watchlist → Write reviews → Get AI recommendations → Join community discussions.

---

3. Main Features

• User authentication (register, login, logout)
• Movie search & advanced filtering
• AI-powered movie recommendations (Gemini/OpenRouter/DeepSeek)
• Movie details with AI-generated summary
• Review system (write, rate, vote)
• Watchlist management
• Community forum & discussion
• Chatbot assistant (AI, FAQ fallback, rate limit)
• Responsive, modern UI

---

4. Technologies Used

• Frontend: React, Tailwind CSS
• Backend: Php Laravel, MySQL
• Database: MySQL
• APIs: RESTful APIs, TMDB, Gemini/OpenRouter/DeepSeek
• Other Tools: Docker, Vite, GitHub Actions

---

5. System Architecture

Frontend (React) ↔ Backend (Laravel API) ↔ MySQL Database. AI APIs (Gemini/OpenRouter/DeepSeek) are called from backend and frontend for recommendations, summaries, and chatbot.

---

6. Setup Guidelines

Backend

# Clone the repository
git clone https://github.com/RedPill-Team/RedPill
cd backend

# Install dependencies
composer install

# migrate database
php artisan migrate 

# Setup environment variables
cp .env.example .env
# Edit .env as needed

# Generate keys
php artisan passport:install

# Run backend server
php artisan serve

Frontend

cd frontend

# Install dependencies
npm install

# Setup environment variables
cp .env.example .env
# Edit .env as needed

# Run frontend
npm run dev

---

7. Running the Application

• Start backend: php artisan serve (default: http://localhost:8000)
• Start frontend: npm run dev (default: http://localhost:5173)
• Access via browser at frontend URL.

8. Deployment Status & Tests

Component	Is Deployed?	Is Dockerized?	Unit Tests Added? (Optional)	Is AI feature implemented? (Optional)
Backend	Yes	Yes	Yes	Yes
Frontend	Yes	Yes	Yes	Yes

⏱️ Wakatime

Md. Iftekhar Zawad - ID : 20220204067

Sakibul Hassan Shovon - ID : 20220204060

Ariful Islam - ID : 2022204071

Mahfuza Sultana Borsha - ID : 2022204084

---

9. Contribution Table

Metric	Total	Backend	Frontend	Member 1	Member 2	Member 3	Member 4
Issues Solved	44	16	18	17	18	5	5
WakaTime Contribution (Hours)	127	80	47	36	41	23	27
Percent Contribution (%)	100	60	40	40	40	10	10

10. Screenshots

11. Limitations / Known Issues

AI Integration Problem: Rate limits, token budget issues, Ollama hosting failed Solution: Switched to OpenRouter, shorter prompts, retry logic Status: Working ✅

Friendship System Problem: Duplicate requests, messy states, slow queries Solution: Single request per pair, clean states, optimized tracking Status: Core fixed ✅