|
|
@@ -1,10 +1,13 @@
|
|
|
# Music Collection — Музыкальная коллекция
|
|
|
|
|
|
## Аннотация
|
|
|
+
|
|
|
Music Collection — это веб-приложение для каталогизации музыкальных произведений, сбора пользовательских оценок и формирования рейтингов. Система позволяет управлять информацией об исполнителях, альбомах, песнях и жанрах, а также предоставляет пользователям возможность оценивать песни и получать персональные рекомендации.
|
|
|
|
|
|
## Введение
|
|
|
+
|
|
|
### Основные возможности
|
|
|
+
|
|
|
- Регистрация и авторизация пользователей
|
|
|
- Разграничение прав доступа (администратор, менеджер, читатель)
|
|
|
- CRUD-операции для исполнителей, альбомов и песен
|
|
|
@@ -15,20 +18,61 @@ Music Collection — это веб-приложение для каталоги
|
|
|
- Административная панель Django
|
|
|
|
|
|
## Назначение и условия применения
|
|
|
+
|
|
|
### Назначение
|
|
|
+
|
|
|
Система предназначена для любителей музыки, коллекционеров и музыкальных критиков, желающих структурировать информацию о музыкальных произведениях, делиться мнениями и находить новые песни на основе оценок других пользователей.
|
|
|
|
|
|
### Условия применения
|
|
|
+
|
|
|
- Операционная система: Linux (Ubuntu 22.04+), Windows 10/11, macOS
|
|
|
- Установленный Docker и Docker Compose (рекомендуемый способ)
|
|
|
- Или Python 3.11+, PostgreSQL 15+ (для ручной установки)
|
|
|
- Доступ к интернету для установки зависимостей
|
|
|
|
|
|
## Установка
|
|
|
+
|
|
|
### Установка через Docker (рекомендуемый способ)
|
|
|
|
|
|
-- [x] **Шаг 1:** Клонируйте репозиторий
|
|
|
+- [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
|
|
|
+```
|
Ilia