Skip to content

Latest commit

 

History

History
145 lines (99 loc) · 5.3 KB

README_RU.md

File metadata and controls

145 lines (99 loc) · 5.3 KB

🎉 BirthdayWishes 🎉

BirthdayWishes — веб-приложение для отправки и просмотра персонализированных видеопоздравлений на день рождения. Проект позволяет загрузить видео-поздравления от разных знакомых, а Именинник может просматривать их с возможностью переключения между видео.

Русский | English

preview

📋 Описание

BirthdayWishes создан для того, чтобы объединить все видео-поздравления с днем рождения в одном месте, предоставляя простой и удобный интерфейс для их просмотра. Пользователи могут смотреть видео, перематывать на нужное место, а также переключаться между поздравлениями с помощью кнопок навигации.

🚀 Технологии

  • Backend: Django
  • Frontend: Vue.js, Video.js, Bootstrap
  • База данных: SQLite
  • Прочие библиотеки: FFmpeg для обработки видеофайлов в потоковую передачу

📂 Структура проекта

BirthdayWishes/
├── app/                # Django приложения
│   ├── api/            # api для videos
│   ├── videos          # Модель видео
│   └── wish            # ? Обдумывание
├── BirthdayWishes      # Настройки Django
├── media/              # Хранение загруженных видео
│   ├── hsl/            # Конвертированные видео для потоковой передачи
│   └── videos/         # Иходные видео. Лучше всего загружать видео в mp4
├── core                # Гланое приложение
├── locale              # Переводы
├── static/             # Статические файлы (CSS, JS)
│   ├── css/
│   ├── img/
│   └── js/
└── README.md           # Документация проекта

📦 Установка и настройка

Требования

  • Python
  • FFmpeg (для конвертации и обработки видео)

Установка

  1. Склонируйте репозиторий и перейдите в директорию проекта:
git clone https://github.com/Riffaells/BirthdayWishes.git
cd BirthdayWishes
  1. Создайте виртуальное окружение и активируйте его:
python -m venv venv
source venv/bin/activate  # Для Linux/macOS  # Для Windows venv\Scripts\activate
  1. Установите зависимости проекта:
pip install -r requirements.txt
  1. Настройте базу данных и миграции:
python manage.py makemigrations
python manage.py migrate
  1. Создание суперпользователя:
python manage.py createsuperuser
  1. Соберите статические файлы:
python manage.py collectstatic
  1. Запустите сервер разработки:
python manage.py runserver
python manage.py runserver 0.0.0.0:8000 # Если хотите развернуть локально

8Откройте приложение в браузере:

Перейдите по адресу http://localhost:8000 для доступа к приложению.

FFmpeg

Убедитесь, что FFmpeg установлен на вашем устройстве и доступен в PATH. Вы можете проверить его установку, запустив команду:

ffmpeg -version

📖 API эндпоинты

  • GET /api/videos/: Возвращает список всех видео в формате JSON.

Пример ответа JSON для /api/videos/

[
    {
        "id": "uuid-12345",
        "title": "Happy Birthday from John",
        "file": "/media/videos/uuid-12345.m3u8",
        "author": "John",
        "wish_message": "С днем рождения! Желаю тебе всего самого лучшего!",
        "created_at": "2024-11-03T10:15:30Z"
    }
]

📚 Полезные команды

  • Запуск сервера разработки: python manage.py runserver
  • Миграция базы данных: python manage.py migrate
  • Создание суперпользователя: python manage.py createsuperuser

📄 Лицензия

Этот проект распространяется под лицензией MIT. Подробнее см. файл LICENSE.

🎂 Наслаждайтесь использованием BirthdayWishes! Пусть каждый день рождения будет наполнен теплыми поздравлениями и радостью! 🎂