【超簡単】Djangoのmigrate実行時に初期データをデータベースへ自動追加する方法

sample_web/
├── .env                  # 環境変数ファイル
├── db.sqlite3            # SQLiteデータベースファイル
├── docker-compose.yml    # Docker Compose設定ファイル
├── Dockerfile            # Dockerイメージ定義ファイル
├── manage.py             # Django管理スクリプト
├── requirements.txt      # プロジェクトの依存ライブラリ一覧
│
├─home                    # Djangoアプリケーションフォルダ
│   ├── admin.py          # 管理サイト設定ファイル
│   ├── apps.py           # アプリケーション設定ファイル
│   ├── management.py     # カスタム管理コマンドやシグナルハンドラなどを配置
│   ├── models.py         # データベースモデル定義ファイル
│   ├── tests.py          # テストファイル
│   ├── urls.py           # アプリケーションのURLルーティング
│   ├── views.py          # ビュー関数/クラス定義ファイル
│   └── __init__.py       # Pythonパッケージとして認識させるためのファイル
│   └─migrations          # データベーススキーマ変更履歴（マイグレーションファイル）
│       ├── 0001_initial.py # 初期マイグレーションファイル
│       └── __init__.py     # Pythonパッケージとして認識させるためのファイル
│
└─sample_project          # Djangoプロジェクトのメイン設定フォルダ
    ├── asgi.py           # ASGI互換Webサーバーエントリーポイント
    ├── settings.py       # プロジェクトの主要設定ファイル
    ├── urls.py           # プロジェクト全体のURLルーティング
    ├── wsgi.py           # WSGI互換Webサーバーエントリーポイント
    └── __init__.py       # Pythonパッケージとして認識させるためのファイル

from django.db import models


# ゲームカテゴリー管理モデル
class Category(models.Model):

    # ID（手動入力）
    id = models.PositiveIntegerField(primary_key=True, unique=True, verbose_name="ID")

    # ゲームカテゴリー名
    name = models.CharField(max_length=50, unique=True, verbose_name="ゲームカテゴリー名")

    class Meta:
        verbose_name = "ゲームカテゴリー"
        verbose_name_plural = "ゲームカテゴリー"
        ordering = ["id"]

    def __str__(self):
        return f"{self.id}: {self.name}"

from .models import Category

# マイグレーション完了後に初期カテゴリーデータを追加するハンドラ
def create_initial_data(sender, **kwargs):

    # 追加したい初期データ
    initial_categories_data = [
        {"id": 1, "name": "アクション"},
        {"id": 2, "name": "RPG"},
        {"id": 3, "name": "アドベンチャー"},
        {"id": 4, "name": "シミュレーション"},
        {"id": 5, "name": "ストラテジー"},
        {"id": 6, "name": "パズル"},
        {"id": 7, "name": "スポーツ"},
        {"id": 8, "name": "レース"},
        {"id": 9, "name": "ホラー"},
        {"id": 10, "name": "音楽"},
    ]

    # 作成数カウント
    created_count = 0

    # データをDBに追加
    for category_data in initial_categories_data:

        # idとnameが一致すれば既存とみなし、なければ新規作成またはID衝突エラー
        category, created = Category.objects.get_or_create(
            id=category_data["id"], name=category_data["name"]
        )

        # 新規作成した場合はカウントを加算
        if created:
            created_count += 1

    print(f"--- 初期カテゴリーデータの追加が完了しました ({created_count}件追加) ---")

# 追加したい初期データ
initial_categories_data = [
    {"id": 1, "name": "アクション"},
    {"id": 2, "name": "RPG"},
    {"id": 3, "name": "アドベンチャー"},
    {"id": 4, "name": "シミュレーション"},
    {"id": 5, "name": "ストラテジー"},
    {"id": 6, "name": "パズル"},
    {"id": 7, "name": "スポーツ"},
    {"id": 8, "name": "レース"},
    {"id": 9, "name": "ホラー"},
    {"id": 10, "name": "音楽"},
]

# 作成数カウント
created_count = 0

# データをDBに追加
for category_data in initial_categories_data:

    # idとnameが一致すれば既存とみなし、なければ新規作成またはID衝突エラー
    category, created = Category.objects.get_or_create(
        id=category_data["id"], name=category_data["name"]
    )

    # 新規作成した場合はカウントを加算
    if created:
        created_count += 1

from django.apps import AppConfig
from django.db.models.signals import post_migrate


class HomeConfig(AppConfig):
    default_auto_field = "django.db.models.BigAutoField"
    name = "home"

    # migrateコマンド実行時、ゲームカテゴリーデータをDBに追加
    def ready(self):
        from .management import create_initial_data

        post_migrate.connect(create_initial_data, sender=self)

    # migrateコマンド実行時、ゲームカテゴリーデータをDBに追加
    def ready(self):
        from .management import create_initial_data

        post_migrate.connect(create_initial_data, sender=self)

from django.contrib import admin
from .models import Category


# Categoryモデルの管理サイトでの表示設定
class CategoryAdmin(admin.ModelAdmin):

    # 一覧画面に表示するフィールド
    list_display = ("id", "name")

    # 検索ボックスの対象とするフィールド
    search_fields = ("name",)

    # デフォルトの並び順
    ordering = ("id",)


admin.site.register(Category, CategoryAdmin)

python manage.py makemigrations
python manage.py migrate