Перейти к содержанию

Запуск проекта локально

Этот урок проведёт вас от чистого клона репозитория до работающего сайта в браузере. Просто выполняйте шаги по порядку — в конце вы увидите главную страницу на http://127.0.0.1:8000.

В локальной разработке проект использует SQLite (файл db.sqlite3), поэтому отдельная база данных и Docker не нужны — всё работает из коробки.

Что нужно заранее

  • Python 3.12 или 3.13
  • uv — менеджер зависимостей и виртуального окружения
  • Git

Шаг 1. Клонировать репозиторий

git clone https://github.com/Skerter/django-plastic-landing.git
cd django-plastic-landing

Шаг 2. Установить зависимости

uv sync --extra dev

Команда создаст виртуальное окружение .venv и поставит Django вместе с dev-инструментами (pytest, playwright).

Шаг 3. Создать файл .env

Скопируйте шаблон:

cp .env.example .env

Откройте .env и замените SECRET_KEY=change-me на любую случайную строку — для локального запуска этого достаточно. Остальные значения (SMTP, Telegram, amoCRM) нужны только на проде, локально их можно не трогать.

Почему дальше команды без DJANGO_SETTINGS_MODULE

Если запускать manage.py без .env (или вне uv run), Django возьмёт несуществующий модуль config.settings и упадёт. Тогда укажите настройки явно: 

DJANGO_SETTINGS_MODULE=config.settings.dev uv run python manage.py <команда>

Полное описание всех переменных — в справочнике Переменные окружения.

Шаг 4. Применить миграции

uv run python manage.py migrate

Команда создаст файл db.sqlite3 со всеми таблицами.

Шаг 5. Создать администратора

uv run python manage.py createsuperuser

Учётка нужна, чтобы зайти в админку /admin/ и наполнить каталог.

Шаг 6. Собрать CSS (Tailwind)

uv run python manage.py tailwind build

Без этого шага страницы откроются без стилей. После правок шаблонов CSS пересобирают этой же командой (или держат запущенным tailwind start — режим watch).

Шаг 7. Запустить сервер

uv run python manage.py runserver

Откройте http://127.0.0.1:8000 — увидите главную страницу. Админка — на http://127.0.0.1:8000/admin/.

Что дальше