fix: visualise data models

.github/workflows/main.yml

@@ -21,38 +21,26 @@ jobs:
       matrix:
         python-version: [3.8]
     steps:
-      - name: 🛫 Checkout
-        uses: actions/checkout@v3
-
-      - name: 🐍 Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v4
+      - uses: ocadotechnology/codeforlife-workspace/.github/actions/python/test@main
         with:
           python-version: ${{ matrix.python-version }}
 
-      - name: 🛠 Install Dependencies
-        run: |
-          python -m pip install --upgrade pip
-          python -m pip install pipenv
-          pipenv install --dev
-
-      - name: 🔎 Check Code Format
-        run: if ! pipenv run black --check .; then exit 1; fi
-
-      - name: 🔎 Check Migrations
-        run: pipenv run python manage.py makemigrations --check --dry-run
-
-      # TODO: assert code coverage target.
-      - name: 🧪 Test Code Units
-        run: pipenv run pytest
+  docs:
+    runs-on: ubuntu-latest
+    needs: [test]
+    steps:
+      - uses: ocadotechnology/codeforlife-workspace/.github/actions/python/docs@main
+        with:
+          python-version: ${{ env.PYTHON_VERSION }}
 
   release:
     concurrency: release
     runs-on: ubuntu-latest
-    needs: [test]
+    needs: [docs]
     if: github.ref_name == 'main'
     steps:
       - name: 🛫 Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           token: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
           fetch-depth: 0
@@ -67,10 +55,7 @@ jobs:
           python -m pip install --upgrade pip
           python -m pip install python-semantic-release~=7.33
 
-      - name: ⚙️ Configure Git
-        run: |
-          git config --local user.name cfl-bot
-          git config --local user.email [email protected]
+      - uses: ocadotechnology/codeforlife-workspace/.github/actions/git/setup-bot@main
 
       - name: 🚀 Publish Semantic Release
         env:

.gitignore

@@ -40,10 +40,10 @@ pip-log.txt
 pip-delete-this-directory.txt
 
 # Any graphs generated in the docs
-docs/*.png
+# docs/*.png
 
 # Any dot files generated by pydot
-*.dot
+# *.dot
 
 # Unit test / coverage reports
 htmlcov/

.vscode/settings.json

@@ -23,6 +23,7 @@
         "--load-plugins=pylint_django"
     ],
     "python.testing.pytestArgs": [
+        "-n=auto",
         "-c=pyproject.toml",
         "."
     ],

Pipfile

@@ -27,6 +27,8 @@ django-stubs = {version = "==4.2.6", extras = ["compatible-mypy"]}
 djangorestframework-stubs = {version = "==3.14.4", extras = ["compatible-mypy"]}
 pylint = "==3.0.2"
 pylint-django = "==2.5.5"
+pygraphviz = "==1.11"
+pytest-xdist = {version = "==3.5.0", extras = ["psutil"]}
 
 [requires]
 python_version = "3.8"

codeforlife/settings/third_party.py

@@ -23,3 +23,16 @@
     ],
     "DEFAULT_PAGINATION_CLASS": "codeforlife.pagination.LimitOffsetPagination",
 }
+
+# Django Extensions - Graph Models
+# https://django-extensions.readthedocs.io/en/latest/graph_models.html?highlight=graph_models#default-settings
+
+GRAPH_MODELS = {
+    "all_applications": True,
+    "group_models": True,
+    "pygraphviz": True,
+    "output": "docs/entity_relationship_diagram.png",
+    "arrow_shape": "normal",
+    "color_code_deletions": True,
+    "rankdir": "BT",
+}

codeforlife/user/migrations/0001_initial.py

@@ -1,4 +1,4 @@
-# Generated by Django 3.2.20 on 2023-12-15 17:11
+# Generated by Django 3.2.20 on 2023-12-18 11:09
 
 from django.conf import settings
 import django.core.validators

manage.py

@@ -13,6 +13,7 @@
     "django.contrib.staticfiles",
     "django.contrib.sites",
     "codeforlife.user",
+    "django_extensions",
 ]
 
 MIDDLEWARE = [