目標

What is	This is
この連載の目的	連続名（Consecutive name）ツールを作る
この記事の目標	いきなり連続名（Consecutive name）ツールを作るのは難しいから、まずマスターデータを作る

情報

👇 この記事はレッスン編と前回の記事を読み終えた人を対象とする

What is	This is
レッスン編	📖 [O1o1o0] DjangoとDockerでゲーム対局サーバーを作ろう！
前回の記事	📖 [OAAA1001o2o0] 連続名ツールを作ろう！

👇 Step の変な数字の説明

📖 電脳向量表記

手順

Step [OAAA1001o2o1o0g1o0] Dockerコンテナの起動

（していなければ） Docker コンテナを起動しておいてほしい

# docker-compose.yml ファイルを置いてあるディレクトリーへ移動してほしい
cd src1

# Docker コンテナ起動
docker-compose up

Step [OAAA1001o2o1o0g2o0] マスターデータ作成 - data/event/ver1o0.json ファイル

👇 以下のファイルを新規作成してほしい

    └── 📂 src1
        └── 📂 apps1
            └── 📂 consecutive_name_vol1o0              # アプリケーション
                └── 📂 static
                    └── 📂 consecutive_name_vol1o0      # アプリケーションと同名
                        └── 📂 data
                            └── 📂 event
👉                              └── 📄 ver1o0.json

{
    "events": [
        {
            "id": "1",
            "event": "ダミーデータを扱う大会",
            "event_s": "ダミー大会",
            "sort": 1.1
        },
        {
            "id": "2",
            "event": "予備データを眺める選手権",
            "event_s": "予備デー選手権",
            "sort": 1.2
        }
    ]
}

Step [OAAA1001o2o1o0g2o1o0] マスターデータ作成 - data/volume/ver1o0.json ファイル

👇 以下のファイルを新規作成してほしい

    └── 📂 src1
        └── 📂 apps1
            └── 📂 consecutive_name_vol1o0              # アプリケーション
                └── 📂 static
                    └── 📂 consecutive_name_vol1o0      # アプリケーションと同名
                        └── 📂 data
                            └── 📂 volume
👉                              └── 📄 ver1o0.json

{
    "events": [
        {
            "event_id": "1",
            "id": "1",
            "volume": "2020年スプリング杯",
            "volume_s": "2020春",
            "sort": 1.1
        },
        {
            "event_id": "1",
            "id": "2",
            "volume": "2020年ウィンター杯",
            "volume_s": "2020冬",
            "sort": 1.2
        },
        {
            "event_id": "1",
            "id": "3",
            "volume": "2021年スプリング杯",
            "volume_s": "2021春",
            "sort": 1.3
        },
        {
            "event_id": "1",
            "id": "4",
            "volume": "2021年ウィンター杯",
            "volume_s": "2021冬",
            "sort": 1.4
        },
        {
            "event_id": "1",
            "id": "5",
            "volume": "2022春スプリング杯",
            "volume_s": "2022春",
            "sort": 1.5
        },
        {
            "event_id": "1",
            "id": "6",
            "volume": "2022冬スプリング杯",
            "volume_s": "2022冬",
            "sort": 1.6
        }
    ]
}

Step [OAAA1001o2o1o0g3o0] モデル作成 - event/ver1o0.py ファイル

👇 以下のファイルを新規作成してほしい

    └── 📂 src1
        └── 📂 apps1
            └── 📂 consecutive_name_vol1o0              # アプリケーション
                └── 📂 models
                    └── 📂 event
                        └── 📄 ver1o0.py

# BOF [OAAA1001o2o1o0g3o0]

# See also: https://qiita.com/zaburo/items/ab7f0eeeaec0e60d6b92
from django.db import models


class Event(models.Model):
    """[OAAA1001o2o1o0g3o0] 催事種別"""

    # プロパティの仕様を決める感じで
    id = models.AutoField('Id', primary_key=True)
    name = models.CharField('名称', max_length=32, blank=True, null=True)
    name_s = models.CharField('名称_短縮', max_length=16, blank=True, null=True)
    sort = models.FloatField('順番', blank=True, default=0)

    def __str__(self):
        """このオブジェクトを文字列にしたとき返るもの"""
        return f"{self.name} event"

# EOF [OAAA1001o2o1o0g3o0]

Step [OAAA1001o2o1o0g3o1o0] モデル作成 - event_volume/ver1o0.py ファイル

👇 以下のファイルを新規作成してほしい

    └── 📂 src1
        └── 📂 apps1
            └── 📂 consecutive_name_vol1o0              # アプリケーション
                └── 📂 models
                    ├── 📂 event
                    │   └── 📄 ver1o0.py
                    └── 📂 event_volume
👉                      └── 📄 ver1o0.py

# BOF [OAAA1001o2o1o0g3o1o0]

# See also: https://qiita.com/zaburo/items/ab7f0eeeaec0e60d6b92
from django.db import models


class EventVolume(models.Model):
    """[OAAA1001o2o1o0g3o1o0] 催事巻"""

    # プロパティの仕様を決める感じで
    id = models.AutoField('Id', primary_key=True)
    event_id = models.IntegerField('催事種別Id', blank=True, default=0)
    name = models.CharField('名称', max_length=64, blank=True, null=True)
    name_s = models.CharField('名称_短縮', max_length=16, blank=True, null=True)
    sort = models.FloatField('順番', blank=True, default=0)

    def __str__(self):
        """このオブジェクトを文字列にしたとき返るもの"""
        return f"{self.name} event-volume"

# EOF [OAAA1001o2o1o0g3o1o0]

Step [OAAA1001o2o1o0g4o0] モデル登録 - admin.py ファイル

👇 以下の既存ファイルに追記してほしい

    └── 📂 src1
        └── 📂 apps1
            └── 📂 consecutive_name_vol1o0              # アプリケーション
                ├── 📂 models
                │   └── 📂 event
                │       └── 📄 ver1o0.py
👉              └── 📄 admin.py

# ...略... from django.contrib import admin


# [OAAA1001o2o1o0g4o0] 連続名1.0巻 催事種別1.0版
from .models.event.ver1o0 import Event
#    --------------------        -----
#    1                           2
# 1. このファイルと同じディレクトリにある `models/event/ver1o0.py` ファイルの拡張子抜き
#                                      ----------------------
# 2. クラス

# [OAAA1001o2o1o0g4o0] 連続名1.0巻 催事巻1.0版
from .models.event_volume.ver1o0 import EventVolume


# ...略...


# Register your models here.
#   └── * 管理画面にモデルが表示されるようになる
#       └── * `manage.py makemigrations` コマンドの実行対象になる


# ...略...


# [OAAA1001o2o1o0g4o0] 連続名1.0巻 催事種別1.0版
admin.site.register(Event)

# [OAAA1001o2o1o0g4o0] 連続名1.0巻 催事巻1.0版
admin.site.register(EventVolume)

👆 管理画面に EventVolume オブジェクトが表示されるようにしている

Step [OAAA1001o2o1o0g5o0] マイグレーションファイル生成 - コマンド実行

# docker-compose.yml ファイルを置いてあるディレクトリーへ移動してほしい
# cd src1

docker-compose run --rm web python3 manage.py makemigrations consecutive_name_vol1o0
#                                                            -----------------------
#                                                            1
# 1. アプリケーション
#    settings.py に `apps1.consecutive_name_vol1o0` と 書いていても、ここには `consecutive_name_vol1o0` と書く

👇 以下のファイルが生成される

    └── 📂 src1
        └── 📂 apps1
            └── 📂 consecutive_name_vol1o0              # アプリケーション
                ├── 📂 migrations
                │   ├── 📄 __init__.py
👉              │   └── 📄 0001_initial.py
                ├── 📂 models
                │   └── 📂 event
                │       └── 📄 ver1o0.py
👉              └── 📄 admin.py

👆 この生成されたファイルはマイグレーションファイルと呼ぶらしい

まだマイグレーション作業は完了していない

Step [OAAA1001o2o1o0g6o0] マイグレーション - コマンド実行

docker-compose run --rm web python manage.py migrate

👆 ここまでやってマイグレーションという作業が終わるらしい

Step [OAAA1001o2o1o0g7o0] スーパーユーザーでWebの管理画面へアクセス

👇 スーパーユーザーでログインすること

📖 http://localhost:8000/admin

👇 画面左に以下のように表示されていればOK

+------------------------------------+
| CONSECUTIVE_NAME_VOL1O0            |
+---------------+--------+-----------+
| Event volumes | ➕ Add | 🖊 Change |
+---------------+--------+-----------+
| Events        | ➕ Add | 🖊 Change |
+---------------+--------+-----------+

Step [OAAA1001o2o1o0g8o0] Event をいくつか追加してほしい

Events ラベルの右横の ➕ Add リンクをクリックしてほしい

名称:
         ----------------
名称_短縮:
         ----------------
順番:     0
         ----------------

                [Save and add another] [Save and continue editing] [SAVE]

👆 入力フォームが出てくるから、以前に作ったJSONを参考に、何件か適当に追加してほしい。
Id は　ずれるものだから、合わせようとせず、違ったら違ったでうまくやってほしい。
[SAVE] が追加ボタンのようだ

Step [OAAA1001o2o1o0g8o1o0] 登録した Event を確認してほしい

Events ラベルをクリックすると、一覧画面が出てくる

Step [OAAA1001o2o1o0g9o0] EventVolume をいくつか追加してほしい

EventVolumes ラベルの右横の ➕ Add リンクをクリックしてほしい

催事種別Id: 0
           ----------------
名称:
           ----------------
名称_短縮:
           ----------------
順番:       0
           ----------------

                [Save and add another] [Save and continue editing] [SAVE]

👆 入力フォームが出てくるから、以前に作ったJSONを参考に、何件か適当に追加してほしい。
Id は　ずれるものだから、合わせようとせず、違ったら違ったでうまくやってほしい。
[SAVE] が追加ボタンのようだ

Step [OAAA1001o2o1o0g9o1o0] 登録した EventVolume を確認してほしい

EventVolumes ラベルをクリックすると、一覧画面が出てくる

参考にした記事

Django モデル

📖 Djangoモデルフィールドのnullとblankの違いを理解する
📖 Django 4.0 のモデルフィールドリファレンスまとめ

以上