[Init] Initialization of the POD_V5 project (Backend)

.env.docker

@@ -0,0 +1,20 @@
+# --- Security ---
+DJANGO_SETTINGS_MODULE=config.django.dev.docker
+SECRET_KEY=change-me-in-prod-secret-key
+EXPOSITION_PORT=8000
+
+# --- Database ---
+MYSQL_DATABASE=pod_db
+MYSQL_USER=pod_user
+MYSQL_PASSWORD=pod_password
+MYSQL_ROOT_PASSWORD=root_password
+MYSQL_HOST=db
+MYSQL_PORT=3307
+
+# --- Superuser ---
+DJANGO_SUPERUSER_USERNAME=admin
+DJANGO_SUPERUSER_EMAIL=admin@example.com
+DJANGO_SUPERUSER_PASSWORD=admin
+
+# --- Versioning ---
+VERSION=5.0.0-DEV

.flake8

@@ -0,0 +1,16 @@
+[flake8]
+# E501: Lines too long (limit increased to 120)
+# W503: Line break before binary operator (conflict with Black/Ruff)
+# F403: 'from module import *' (tolerated in settings)
+ignore = E501, W503, F403
+
+# We exclude files managed by Git or Django
+exclude =
+    .git,
+    __pycache__,
+    venv,
+    */migrations/*
+
+# The standard length for modern Django
+max-line-length = 120
+max-complexity = 18

.gitattributes

@@ -0,0 +1,2 @@
+*.sh text eol=lf
+Dockerfile text eol=lf

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,5 @@
+# Before sending your pull request, make sure the following are done
+
+* [ ] You have read our [contribution guidelines](CONTRIBUTING.md).
+* [ ] Your PR targets the `dev_v5` branch.
+* [ ] Your PR status is in `draft` if it’s still a work in progress.

.github/workflows/build-dev.yml

@@ -0,0 +1,52 @@
+name: Build and Push Dev Image
+
+on:
+  push:
+    branches:
+      - "**"
+    paths:
+      - "deployment/dev/**"
+      - "src/**"
+      - "requirements.txt"
+      - ".github/workflows/build-dev.yml"
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build-and-push-dev:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Log in to the Container registry
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=ref,event=branch
+            type=sha,format=short
+            type=raw,value=dev-{{branch}}-{{sha}}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          file: deployment/dev/Dockerfile
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

.github/workflows/ci.yml

@@ -0,0 +1,101 @@
+name: Pod V5 CI/CD
+
+on:
+  push:
+    branches:
+      - dev_v5
+      - feature/LLMS-instruction-file
+  pull_request:
+    branches:
+      - dev_v5
+      - main
+      - feature/LLMS-instruction-file
+
+jobs:
+  # 1. Code Quality
+  quality-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: 'pip'
+      - name: Install dependencies
+        run: pip install flake8
+      - name: Lint with flake8
+        run: flake8 src --count --show-source --statistics
+
+  # 2. Docker Integration, E2E & Security (The Authoritative Test)
+  test-docker-full:
+    needs: [quality-check]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python 3.12
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Create .env file
+        run: cp .env.docker .env
+
+      - name: Build Stack
+        env:
+          VERSION: 5.0.0-DEV
+          DJANGO_SETTINGS_MODULE: config.django.dev.docker
+        run: make build
+
+      - name: Start Stack
+        env:
+          VERSION: 5.0.0-DEV
+          DJANGO_SETTINGS_MODULE: config.django.dev.docker
+        run: make start
+
+      - name: Wait for Services
+        run: |
+          set -e
+          echo "Waiting for API..."
+          # Retry loop to wait for API to be ready
+          count=0
+          until curl -sf http://127.0.0.1:8000/api/docs/ > /dev/null || [ $count -eq 60 ]; do
+             echo "Waiting for API... ($count/60)"
+             sleep 2
+             count=$((count+1))
+          done
+
+          if [ $count -eq 60 ]; then
+            echo "API failed to start"
+            make logs
+            exit 1
+          fi
+
+      - name: Run Tests with Coverage (Inside Docker)
+        run: make test
+
+      - name: Install E2E dependencies
+        run: |
+          pip install --upgrade pip
+          pip install requests
+
+      - name: Run Smoke & E2E Tests
+        # Runs against the running docker container from the host
+        run: python src/config/django/test/e2e_scenario.py
+
+      - name: Basic Load Test
+        run: |
+          fail=0
+          for i in {1..50}; do
+            curl -sf http://127.0.0.1:8000/api/docs/ > /dev/null || fail=1 &
+          done
+          wait
+          if [ "$fail" -ne 0 ]; then
+            echo "Load test failed"
+            exit 1
+          fi
+
+      - name: Teardown
+        if: always()
+        run: make clean

.gitignore

@@ -0,0 +1,42 @@
+# --- Python ---
+__pycache__/
+*.py[cod]
+*$py.class
+*.pyc
+
+# --- Django ---
+*.log
+settings_local.py
+db.sqlite3
+db.sqlite3-journal
+media/
+staticfiles/
+
+# --- Environnement & Secrets ---
+.env
+.env.prod
+
+.venv/
+venv/
+env/
+
+# --- IDE & OS ---
+.idea/
+.vscode/
+*.swp
+.DS_Store
+Thumbs.db
+
+# --- Docker ---
+mysql_data/
+
+# --- Custom files ---
+log/
+media/
+transcription/
+
+
+# --- Tests & Coverage ---
+.coverage
+.pytest_cache/
+htmlcov/

AUTHORS.md

@@ -0,0 +1,56 @@
+Esup-Pod Authors
+================
+
+Maintainer
+----------
+
+ [Esup Portail](https://www.esup-portail.org/)
+
+Original Authors
+----------------
+
+* Nicolas Can, University of Lille, France ([@ptitloup](https://github.com/ptitloup))
+
+Contributors for the V3
+----------------------------
+
+A list of much-appreciated contributors
+who have submitted patches and reported bugs for the V3:
+
+* Olivier Bado-Faustin, University Cote d'Azur (design and template)
+* Nicolas Lahoche, University of Lille (design and template) with all the PRI Team
+* Nathaniel Burlot, University of Lille (member of PRI team for Logo and color of V3)
+* Céline Didier and Matthieu Bildstein, University of Lorraine (Live's Event App)
+* Farid Ait Karra, University of Lille (Docker part)
+* Maxime Taisne and Laurine Sajdak, University of Lille (Documentation and User part)
+* French Ministry of Education (who funded the development of some features)
+
+Partnership
+----------------------------
+
+* Elygames
+* OrionStudio
+
+Previous Author/Contributors
+----------------------------
+
+A list of much-appreciated contributors who have submitted patches and reported bugs:
+
+* Joël Obled, Esup-Portail Consortium, France ([@DrClockwork](https://github.com/DrClockwork))
+* Charlotte Benard (Logo and color of V2)
+* Frederic Sene, INSA Rennes
+* Frédéric Colau, Eliam Lotonga and Jeremie Grepilloux, University Grenoble Alpes
+* Loic Bonavent, University of Montpellier
+* Guillaume Condesse, University of Bordeaux
+* All participants of the October 2018 Pod Technical Workshop
+
+Pictures credits
+----------------------------
+
+* default.svg: adapted from Play button Icon
+  by [Freepik](https://www.freepik.com/free-vector) - Freepik License
+* cookie.svg:
+  [oatmeal cookie created by pch.vector](https://www.freepik.com/vectors/logo) - Freepik License
+* default-playlist.svg: Music, Note, Musical Note
+  by [krzysztof-m](https://pixabay.com/fr/users/1363864/) -
+  [Pixabay free for use & download licence](https://pixabay.com/fr/service/terms/)