Files
neomovies/README.md
2024-12-31 21:11:13 +00:00

160 lines
5.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🎬 Neo Movies
<div align="center">
<img src="public/logo.png" alt="Neo Movies Logo" width="200"/>
<p><strong>Современный онлайн-кинотеатр с удобным интерфейсом</strong></p>
</div>
## 📋 О проекте
Neo Movies - это современная веб-платформа для просмотра фильмов, построенная с использованием передовых технологий. Проект предлагает удобный интерфейс, быструю навигацию и множество функций для комфортного просмотра фильмов.
### ✨ Основные возможности
- 🎥 Три встроенных видеоплеера на выбор (Alloha, Collaps, Lumex)
- 🔍 Умный поиск по фильмам
- 📱 Адаптивный дизайн для всех устройств
- 🌙 Темная тема
- 👤 Система авторизации и профили пользователей
- ❤️ Возможность добавлять фильмы в избранное
- ⚡ Быстрая загрузка и оптимизированная производительность
## 🛠 Технологии
- **Frontend:**
- Next.js 13+ (App Router)
- React 18
- TypeScript
- Styled Components
- NextAuth.js
- **Backend:**
- Next.js
- MongoDB
- Mongoose
- **Дополнительно:**
- ESLint
- Prettier
- Git
- npm
## Установка
1. **Клонируйте репозиторий:**
```bash
git clone https://gitlab.com/foxixus/neomovies.git
cd neomovies
```
2. **Установите зависимости:**
```bash
npm install
```
3. **Создайте файл `.env` в корневой директории и добавьте следующие переменные:**
```env
# База данных MongoDB
MONGODB_URI=your_mongodb_uri
# NextAuth конфигурация
NEXTAUTH_SECRET=your_nextauth_secret
NEXTAUTH_URL=http://localhost:3000
# Google OAuth
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
# Email конфигурация (для подтверждения регистрации)
GMAIL_USER=your_gmail@gmail.com
GMAIL_APP_PASSWORD=your_app_specific_password
# TMDB API (для получения информации о фильмах)
NEXT_PUBLIC_TMDB_API_KEY=your_tmdb_api_key
NEXT_PUBLIC_TMDB_ACCESS_TOKEN=your_tmdb_access_token
# JWT конфигурация
JWT_SECRET=your_jwt_secret
# Lumex Player URL
NEXT_PUBLIC_LUMEX_URL=your_lumex_player_url
```
4. **Запустите проект:**
```bash
# Режим разработки
npm run dev
# Сборка для продакшена
npm run build
npm start
```
## Получение API ключей
### TMDB API
1. Создайте аккаунт на [TMDB](https://www.themoviedb.org/)
2. Перейдите в настройки профиля -> API
3. Создайте новое API приложение
4. Скопируйте API ключ и Access Token
### Google OAuth
1. Перейдите в [Google Cloud Console](https://console.cloud.google.com/)
2. Создайте новый проект
3. Включите Google OAuth API
4. Создайте учетные данные OAuth 2.0
5. Добавьте разрешенные URI перенаправления:
- http://localhost:3000/api/auth/callback/google
- https://your-domain.com/api/auth/callback/google
### Gmail App Password
1. Включите двухфакторную аутентификацию в аккаунте Google
2. Перейдите в настройки безопасности
3. Создайте пароль приложения
4. Используйте этот пароль в GMAIL_APP_PASSWORD
## Разработка
### Структура проекта
```
neo-movies-web/
├── src/
│ ├── app/ # App Router pages
│ ├── components/ # React компоненты
│ ├── hooks/ # React хуки
│ ├── lib/ # Утилиты и API
│ ├── models/ # MongoDB модели
│ └── styles/ # Глобальные стили
├── public/ # Статические файлы
└── package.json
```
## 👥 Авторы
- **Frontend Developer** - [Foxix](https://gitlab.com/fenixoffc1)
## 📄 Лицензия
Этот проект распространяется под лицензией MIT. Подробности в файле [LICENSE](LICENSE).
## 🤝 Участие в проекте
Мы приветствуем любой вклад в развитие проекта! Если у вас есть предложения по улучшению:
1. Форкните репозиторий
2. Создайте ветку для ваших изменений
3. Внесите изменения
4. Отправьте pull request
## 📞 Контакты
Если у вас возникли вопросы или предложения, свяжитесь с нами:
- Email: neo.movies.mail@gmail.com
- Telegram: @foxix_us
---
<div align="center">
<p>Made with ❤️ by Foxix</p>
</div>