---

Aplikacja webowa stworzona w Django 4.2.5 i pythonie 3.11.1

---

Zawartość REDME

1. 🏃 Cel aplikacji
2. 📜 Funkcjonalność
3. 💻 Uruchomienie aplikacji lokalnie
4. 🔧 Konfiguracja
5. 📡 Wdrożenie na serwer pythonanywhere
6. 🌐 Działanie aplikacji na serwerze

Cel aplikacji

Aplikacja została stworzona na potrzeby wydarzenia dwudniowego biegu, zaczynającego się wieczorem i kończącego ranem następnego dnia.
Aplikacja umożliwia prezentacje wyników biegaczy w formie wykresu i tabeli.
Zarządzanie danymi biegów aplikacji odbywa się w dostosowanym panelu administracyjnym lub domyślnym panelu administracyjnym.

Funkcjonalność

1. Wykres z wynikami biegaczy
2. Tabela z wynikami biegaczy
3. Tabela z wynikami pojedyńczego biegacza
4. Dostosowany panel administracyjny
5. Strandardowy panel administracyjny Django

Instrukcja uruchomienia aplikacji lokalnie:

Tworzymy wirtualne środowisko

python -m venv venv

Aktywujemy wirtualne środowisko

.\venv\Scripts\activate

Instalujemy wszystkie potrzebne biblioteki z pliku requirements.txt

pip install -r .\requirements.txt

Uruchomienie projektu Django

python manage.py runserver 'nrPortu opcjonalnie'

Konfiguracja:

Important

Ustawiamy datę biegu w:

runProject\settings.py ${\textsf{\color{gold}FIRST\_DAY}}$ datetime(2024, 11, 2, 21, 30)

Kod FIRST_DAY zawierający datę biegu datetime(2024, 11, 2, 21, 30)

from pathlib import Path

from datetime import datetime, timedelta
FIRST_DAY = datetime(2024, 11, 2, 21, 30)
SECOND_DAY = FIRST_DAY + timedelta(days=1)

Important

W settings.py do ALLOWED_HOSTS dodać adres url, gdzie będzie wystawiona aplikacja:

np. 'nocnybieg2023.pythonanywhere.com', 'ultradoba2024.pythonanywhere.com', 'ultradoba2025.pythonanywhere.com'.

Przydatne polecenia:

Tworzenie migracji po zmianie modelów

python manage.py makemigrations appName --name changeName

Zatwierdzenie migracji

python manage.py migrate  

Tworzenie super użytkownika

python manage.py createsuperuser

Włączenie shell-a w konsoli (pozwala na komunikacje z bazą danych przez ORM)

python manage.py shell

Wdrożenie na serwer pythonanywhere:

Uruchomienie konsoli w pythonanywhere:

W sekcji Consoles
Uruchamiamy konsole:

Klonujemy repozytorium:

git clone https://github.com/rzymski/runnersChart.git

Tworzymy wirtaulne środowisko:

mkvirtualenv --python=/usr/bin/python3.10 venv

Pobieramy wszystkie potrzebne pakiety z requirements.txt:

pip install -r ./runnersChart/requirements.txt

Dodanie aplikacji do serwera:

Add a new web app --> ... --> Manual Configuration --> Python 3.10 --> ...

Ustawienia w sekcji Web:

Source code: /home/nazwaUzytkownika/runnersChart (nazwa głównego folderu projektu i nazwa repozytorium na github-ie)

Working directory: /home/nazwaUzytkownika

Virtualenv: /home/nazwaUzytkownika/.virtualenvs/venv

Static files:
  URL: /static/
  DIRECTORY: /home/nazwaUzytkownika/runnersChart/static

WSGI configuration file:

import os
import sys
path = os.path.expanduser('~/runnersChart')
if path not in sys.path:
    sys.path.insert(0, path)
os.environ['DJANGO_SETTINGS_MODULE'] = 'runProject.settings'
from django.core.wsgi import get_wsgi_application
from django.contrib.staticfiles.handlers import StaticFilesHandler
application = StaticFilesHandler(get_wsgi_application())

Po skonfigurowaniu warto również dla pewności jeszcze raz upewnić się, że pliki statyczne są załadowane.
Polecenie do przeładowania plików statycznych:

python manage.py collectstatic

Przeładowanie aplikacji na serwerze:

W przypadku wyłączenia się konsoli i zamknięcia wirtualnego środowiska, żeby włączyć z powrotem wirtualne środowisko w /home/ultradoba2024/.virtualenvs:

workon venv

Może wystąpić potrzeba zmigrowania, dla poprawnego działania aplikacji:

python manage.py migrate

Działanie aplikacji na serwerze

Można sprawdzić działanie aplikacji w:

• https://ultradoba2024.pythonanywhere.com/

Wykres:

• https://ultradoba2024.pythonanywhere.com/chart/line

Tabela z wynikami biegaczy:

• https://ultradoba2024.pythonanywhere.com/table/result

Tabela wyników pojedyńczego biegacza:

• https://ultradoba2024.pythonanywhere.com/table/runnerResults/1 id biegacza

Spersonalizowany panel administracyjny:

• https://ultradoba2024.pythonanywhere.com/admin/customAdmin

Domyślny panel administracyjny:

• https://ultradoba2024.pythonanywhere.com/admin