Django для начинающих: первый проект по шагам

Что сделаем

Простой список заметок: можно добавлять записи, смотреть список, редактировать через панель управления. Это займёт вечер и даст понимание, как устроен фреймворк.

Шаг 1. Окружение и установка

python -m venv .venv
source .venv/bin/activate
pip install django

Шаг 2. Создание проекта

django-admin startproject notes .

Точка в конце важна: без неё создастся лишняя вложенная папка.

Появятся файл управления проектом и папка с настройками.

Шаг 3. Создание приложения

python manage.py startapp diary

В Django проект состоит из приложений — отдельных частей со своей логикой. Даже для маленького проекта так принято.

Подключите приложение в настройках проекта, добавив его в список установленных.

Шаг 4. Модель

Модель — описание того, что будет храниться в базе. В файле моделей приложения опишите заметку: заголовок, текст, дата создания.

Дальше две команды:

python manage.py makemigrations
python manage.py migrate

Первая создаёт описание изменений базы, вторая применяет их. Понимание разницы важно: первая — план, вторая — исполнение.

Шаг 5. Панель управления

Зарегистрируйте модель в файле настроек панели, создайте пользователя:

python manage.py createsuperuser

Запустите:

python manage.py runserver

Зайдите по адресу с добавлением пути к панели — и вы уже можете добавлять и редактировать записи. Это то, ради чего многие и выбирают Django: полноценная панель управления без единой написанной строчки интерфейса.

Шаг 6. Отображение и адрес

Опишите отображение, которое достаёт список заметок и передаёт в шаблон, добавьте адрес в список маршрутов приложения и подключите его к маршрутам проекта.

Здесь важно понять схему: пришёл запрос — фреймворк по адресу нашёл отображение — отображение достало данные — передало в шаблон — вернулся ответ.

Шаг 7. Шаблон

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

Запустите и убедитесь, что записи, добавленные через панель, видны на странице.

Что вы поняли за вечер

Схему любого веб-фреймворка: маршрут, обработчик, данные, шаблон, ответ. Она одинакова в Django, Flask и почти везде — меняется синтаксис.

Что делать дальше

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

Вот это уже будет проект для портфолио — при условии, что вы доведёте его до конца и напишете описание.