Перейти до змісту

Seed Data

seed_demo_data — Django management command що заповнює БД демо-даними для розробки. Дозволяє відразу побачити застосунок з реальними нотатками, групами і чатом.

Навіщо seed data

Проблема: при першому docker compose up БД порожня. Ти бачиш порожній застосунок — нема нотаток, нема груп, чат мовчить. Важко показати студентам як виглядає реальний застосунок і важко перевірити групові функції.

Рішення: seed command створює реалістичні демо-дані: - 3 юзери з паролями — можна одразу залогінитись - Групи з учасниками — можна тестувати групові нотатки і чат у різних вкладках - Різні типи нотаток (особисті, групові, закріплені, архівні) — видна вся функціональність - Повідомлення у групових чатах — чат не виглядає порожнім

Що створює seed_demo_data

Юзери

Логін Пароль Роль
demo_alice demo1234 Основний юзер: нотатки, todos, групи
demo_bob demo1234 Учасник "Команда розробки"
demo_carol demo1234 Учасник "Сімя"

Кожен юзер має свій UserProfile.

Групи та учасники

Група Учасники
Команда розробки alice, bob
Сімя alice, carol

Alice — учасниця обох груп → бачить нотатки і чат обох груп.

Нотатки alice

Тип Кількість
Особисті (різні пріоритети) ~5
Закріплені (is_pinned=True) 1
Архівні (is_archived=True) 1
Групові (group="Команда розробки") 2

Інші дані

  • Notebooks: "Особисті" (default), "Робота", "Проєкти"
  • Tags: python, django, ідеї, туторіали — кожен з унікальним кольором
  • TodoList з 3 незавершеними TodoItems
  • ShoppingList з продуктами
  • ChatMessages для групових чатів — history для обох груп

SEED_DEMO_DATA=1 при старті

Коли SEED_DEMO_DATA=1 встановлено у .env, seed виконується автоматично при кожному docker compose up через entrypoint.sh:

# entrypoint.sh
if [ "${SEED_DEMO_DATA}" = "1" ]; then
    python manage.py seed_demo_data --force
fi

# docker-compose.yml
web:
  environment:
    SEED_DEMO_DATA: ${SEED_DEMO_DATA:-0}
    # ↑ Якщо .env не містить SEED_DEMO_DATA — default 0 (seed вимкнений)

# .env:
SEED_DEMO_DATA=1   # вмикає автосід при кожному docker compose up

Команди

# Перший запуск (SEED_DEMO_DATA=1 у .env → автоматично при docker compose up):
docker compose up

# Вручну — перший раз (БД порожня):
docker compose exec web python manage.py seed_demo_data

# Вручну — скидання і повторне заповнення (БД вже є):
docker compose exec web python manage.py seed_demo_data --reset
# --reset: видаляє всіх demo_* юзерів і пов'язані дані → сіде заново

# Без стека (окремий контейнер — тільки якщо БД вже має дані з попереднього up):
docker compose run --rm web python manage.py seed_demo_data

--force у entrypoint.sh

entrypoint.sh запускає seed_demo_data --force, а не --reset. --force дозволяє виконати seed навіть якщо БД не порожня, але не видаляє існуючі дані. --reset спочатку видаляє demo дані, потім сідує знову.

Перевірити що seed спрацював

# Швидка перевірка через shell:
docker compose exec web python manage.py shell -c "
from django.contrib.auth.models import User
from notes_app.models import Note, ChatMessage
from django.contrib.auth.models import Group

print('Users:', User.objects.count())
print('Notes:', Note.objects.count())
print('Groups:', Group.objects.count())
print('ChatMessages:', ChatMessage.objects.count())
"

# Очікуваний вивід:
# Users: 3
# Notes: 9
# Groups: 2
# ChatMessages: 8 (або більше)

# Або напряму у PostgreSQL:
docker compose exec db psql -U notes_user -d notes_db -c "
SELECT username FROM auth_user WHERE username LIKE 'demo_%';
"
#  demo_alice
#  demo_bob
#  demo_carol

Тестування групових функцій з двома акаунтами

Seed дозволяє тестувати реальні сценарії:

Сценарій: групова нотатка

1. Браузер 1: залогінись як demo_alice
2. Браузер 2 (або Private): залогінись як demo_bob
3. Alice: відкрий нотатку з групи "Команда розробки"
4. Bob: відкрий ту саму нотатку (видна через group membership)

Сценарій: груповий чат у реальному часі

1. Браузер 1: demo_alice → Groups → "Команда розробки" → Chat
2. Браузер 2: demo_bob → Groups → "Команда розробки" → Chat
3. Alice: введи повідомлення → Enter
4. Bob: повідомлення з'являється миттєво (WebSocket!)

Сценарій: ізоляція даних

1. demo_carol: намагається відкрити нотатку demo_alice
2. → 404 (alice не є членом груп carol, нотатка не з спільної групи)
3. demo_bob: намагається відкрити нотатку demo_alice
4. → 404 якщо особиста нотатка, 200 якщо з "Команди розробки"

.env конфігурація для dev

# .env (скопіюй з .env.example)

POSTGRES_DB=notes_db
POSTGRES_USER=notes_user
POSTGRES_PASSWORD=notes_password_dev

SECRET_KEY=dev-secret-key-not-for-production
DEBUG=True
ALLOWED_HOSTS=localhost,127.0.0.1

REDIS_URL=redis://redis:6379/0
DATABASE_URL=postgres://notes_user:notes_password_dev@db:5432/notes_db

# Seed demo data при кожному docker compose up:
SEED_DEMO_DATA=1

# ngrok (потрібен тільки для публічного доступу)
NGROK_AUTHTOKEN=          # отримати на ngrok.com
NGROK_DOMAIN=             # твій static domain (ngrok free tier: 1 static domain)

Скопіювати шаблон:

cp .env.example .env
# Відредагуй: додати NGROK_AUTHTOKEN і NGROK_DOMAIN якщо потрібно

Debugging: коли seed не спрацьовує

CommandError: Demo data disabled

CommandError: seed_demo_data disabled in production (DEBUG=False)
Use --force to override

Причина: seed_demo_data перевіряє DEBUG = True. У production він вимкнений за замовчуванням щоб не перезаписати реальні дані.

Рішення: entrypoint.sh вже передає --force, тому ця помилка виникає тільки при ручному запуску без прапору.

# Правильно для ручного запуску при DEBUG=False:
docker compose exec web python manage.py seed_demo_data --force

IntegrityError: duplicate key

Якщо запустити seed двічі без --reset:

django.db.utils.IntegrityError: duplicate key value violates unique constraint
"auth_user_username_key"
DETAIL: Key (username)=(demo_alice) already exists.

Рішення: 

docker compose exec web python manage.py seed_demo_data --reset
# --reset видаляє існуючих demo_ юзерів перед створенням нових

БД не ініціалізована

django.db.utils.OperationalError: could not connect to server

Причина: спробував запустити seed перед docker compose up або після docker compose down -v.

Рішення: 

docker compose up -d
# Дочекатись поки web container стане healthy
docker compose ps    # web: healthy?
docker compose exec web python manage.py seed_demo_data

Demо облікові записи після seed

Після успішного seed можна відкрити http://localhost і залогінитись:

http://localhost/accounts/login/
  Username: demo_alice
  Password: demo1234

Alice бачить: - Особисті нотатки з різними пріоритетами і тегами - Закріплена нотатка вгорі списку - Групові нотатки "Команда розробки" і "Сімя" - Активний Todo список з кількома задачами - Shopping list з продуктами - Групові чати обох груп з history повідомлень

У книзі

Офіційна документація