qx-lib

РУКОВОДСТВО ПО РАЗВЕРТЫВАНИЮ ВЕБ-ПРИЛОЖЕНИЯ НА WINDOWS

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

ПРЕДВАРИТЕЛЬНЫЕ ТРЕБОВАНИЯ

• Python: Убедитесь, что у вас установлен Python. Вы можете скачать его с python.org (https://www.python.org/). Во время установки ОБЯЗАТЕЛЬНО отметьте галочку "Add Python to PATH". Рекомендуется версия Python 3.9 или выше.

• Git: Система контроля версий Git необходима для клонирования репозитория. Скачать можно с git-scm.com (https://git-scm.com/).

• pip: Менеджер пакетов Python, обычно устанавливается вместе с Python.

• КЛОНИРОВАНИЕ РЕПОЗИТОРИЯ

Откройте командную строку (CMD) или PowerShell и выполните команду:

git clone <URL_вашего_репозитория>
cd <имя_папки_проекта> # Обычно это имя репозитория

2. СОЗДАНИЕ И АКТИВАЦИЯ ВИРТУАЛЬНОГО ОКРУЖЕНИЯ

Виртуальное окружение помогает изолировать зависимости проекта.

python -m venv venv

Для активации виртуального окружения:

• В CMD: .\venv\Scripts\activate.bat

• В PowerShell: .\venv\Scripts\Activate.ps1

  Если в PowerShell возникает ошибка, связанная с политикой выполнения скриптов, выполните следующую команду от имени администратора и попробуйте снова:

  Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  

После активации вы увидите (venv) в начале командной строки.

• УСТАНОВКА ЗАВИСИМОСТЕЙ

Установите все необходимые пакеты, перечисленные в файле requirements.txt:

pip install -r requirements.txt

4. НАСТРОЙКА БАЗЫ ДАННЫХ

Данный проект по умолчанию использует SQLite, которая не требует дополнительной настройки для разработки.

Выполните миграции для создания таблиц в базе данных:

python manage.py migrate

5. СОЗДАНИЕ СУПЕРПОЛЬЗОВАТЕЛЯ (АДМИНИСТРАТОРА)

Для доступа к административной панели Django создайте суперпользователя:

python manage.py createsuperuser

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

• СБОР СТАТИЧЕСКИХ ФАЙЛОВ (ДЛЯ DEBUG=FALSE)

Для локальной разработки с DEBUG=True этот шаг обычно не требуется, так как Django автоматически обрабатывает статические файлы. Однако, если вы планируете тестировать с DEBUG=False, выполните:

python manage.py collectstatic

7. ЗАПУСК СЕРВЕРА РАЗРАБОТКИ

Запустите встроенный веб-сервер Django:

python manage.py runserver

После запуска сервер будет доступен по адресу http://127.0.0.1:8000/ в вашем веб-браузере.

• ВОЗМОЖНЫЕ ПРОБЛЕМЫ И ИХ РЕШЕНИЯ

• ModuleNotFoundError: Если возникает ошибка, что какой-то модуль не найден, убедитесь, что виртуальное окружение активировано и все зависимости из requirements.txt установлены корректно.
• Кодировка файлов: Убедитесь, что все файлы проекта сохранены в кодировке UTF-8, особенно если вы редактируете их в различных редакторах на Windows.

• ОСТАНОВКА СЕРВЕРА

Чтобы остановить сервер разработки, нажмите Ctrl+C в командной строке, где он был запущен.

• ДЕАКТИВАЦИЯ ВИРТУАЛЬНОГО ОКРУЖЕНИЯ

Когда вы закончили работу с проектом, деактивируйте виртуальное окружение:

deactivate

Это базовое руководство. Для полноценного производственного развертывания на Windows потребуются дополнительные шаги, такие как настройка веб-сервера (например, IIS, Apache или Nginx с Gunicorn/Waitress), управление статическими файлами и медиа, настройка переменных окружения и обеспечение безопасности.

Команды: django-admin startproject triangle_project

cd triangle_project

python3 -m venv env

source env/bin/activate env\Scripts\activate

deactivate

pip install django

python manage.py startapp triangle

python manage.py runserver

python manage.py makemigrations python manage.py migrate

python manage.py runserver

python manage.py createsuperuser

Откатиться к конкретной миграции (по номеру)

python manage.py migrate app_name 0001

Откатиться к предыдущей миграции

python manage.py migrate app_name 0001_initial

Откатиться на одну миграцию назад

python manage.py migrate app_name --fake-initial

Откатить все миграции приложения

python manage.py migrate app_name zero

Просто удалить файл миграции

rm app_name/migrations/0002_unwanted_migration.py

Узнать текущее состояние

python manage.py showmigrations

Откатиться к предпоследней миграции

python manage.py migrate app_name 0001

Пометить миграцию как неприменённую без изменения БД

python manage.py migrate app_name 0001 --fake

1. Откатиться к рабочей миграции

python manage.py migrate app_name 0001

2. Удалить проблемную миграцию

rm app_name/migrations/0002_problem_migration.py

3. Создать новую правильную миграцию

python manage.py makemigrations python manage.py migrate

python manage.py shell

from django.contrib.auth.models import User

Найти пользователя по username

user = User.objects.get(username='имя_пользователя') user.delete()

Или найти по email

user = User.objects.get(email='[e-mail]') user.delete()

Удалить всех суперпользователей

User.objects.filter(is_superuser=True).delete()

Посмотреть всех суперпользователей перед удалением

User.objects.filter(is_superuser=True)