# Music Collection — Музыкальная коллекция

## Аннотация

Music Collection — это веб-приложение для каталогизации музыкальных произведений, сбора пользовательских оценок и формирования рейтингов. Система позволяет управлять информацией об исполнителях, альбомах, песнях и жанрах, а также предоставляет пользователям возможность оценивать песни и получать персональные рекомендации.

## Введение

### Основные возможности

- Регистрация и авторизация пользователей
- Разграничение прав доступа (администратор, менеджер, читатель)
- CRUD-операции для исполнителей, альбомов и песен
- Система выставления оценок (1-10) с расчетом среднего рейтинга
- Персональные рекомендации на основе предпочтений
- Профиль пользователя с расчетными атрибутами (возраст, статистика оценок)
- Интерактивный поиск по названию и исполнителю
- Административная панель Django

## Назначение и условия применения

### Назначение

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

### Условия применения

- Операционная система: Linux (Ubuntu 22.04+), Windows 10/11, macOS
- Установленный Docker и Docker Compose (рекомендуемый способ)
- Или Python 3.11+, PostgreSQL 15+ (для ручной установки)
- Доступ к интернету для установки зависимостей

## Установка

### Установка через Docker (рекомендуемый способ)

- [X] **Шаг 1:** Клонируйте репозиторий

```bash
git clone https://gogs.itiscaf.ru/comper123/music_collection.git
cd music_collection
```

- [X] **Шаг 2:** Создайте файл .env на основе .env.example

```bash
cp .env.example .env
```

- [X] **Шаг 3:** Запустите Docker Compose

```bash
docker-compose up --build
```

Процесс сборки может занять несколько минут. После успешного завершения вы увидите сообщения о запуске контейнеров.

- [X] **Шаг 4:** Создайте суперпользователя

Откройте новый терминал и выполните:

```bash
docker-compose exec web python manage.py createsuperuser
```

Следуйте инструкциям для ввода имени пользователя, email и пароля.

- [X] **Шаг 5:** Откройте браузер и перейдите по адресу

```bash
http://localhost:8000
```

- [X] **Шаг 6:** Для остановки системы

```bash
docker-compose down
```