qx-lib

1.0.0 • Public • Published

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

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

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

1. Python: Убедитесь, что у вас установлен Python. Вы можете скачать его с python.org (https://www.python.org/). Во время установки ОБЯЗАТЕЛЬНО отметьте галочку "Add Python to PATH". Рекомендуется версия Python 3.9 или выше.
2. Git: Система контроля версий Git необходима для клонирования репозитория. Скачать можно с git-scm.com (https://git-scm.com/).
3. pip: Менеджер пакетов Python, обычно устанавливается вместе с Python.

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

Откройте командную строку (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) в начале командной строки.

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

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

pip install -r requirements.txt

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

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

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

python manage.py migrate

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

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

python manage.py createsuperuser

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

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

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

python manage.py collectstatic

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

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

python manage.py runserver

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

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

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

9. ОСТАНОВКА СЕРВЕРА

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

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

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

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='email@example.com')
user.delete()

# Удалить всех суперпользователей
User.objects.filter(is_superuser=True).delete()

# Посмотреть всех суперпользователей перед удалением
User.objects.filter(is_superuser=True)

Readme

Keywords

none

Package Sidebar

Install

npm i qx-lib

Weekly Downloads

1

Version

1.0.0

License

ISC

Unpacked Size

1.24 MB

Total Files

126

Last publish

Collaborators

  • xalera