README.md

Wyniki WF

Aplikacja umożliwia zarządzanie wynikami z przedmiotu wychowania fizycznego. Pozwala na podstawowe operacje na danych (dla nauczyciela), oraz na wyświetlanie swoich wyników (dla ucznia). Dostęp do aplikacji jest przyznawany poprzez zalogowanie

Uruchomienie

1. Sklonuj repozytorium:

   $ git clone https://github.com/marcinadd/django-wf.git

2. Przejdź do katalogu sklonowanej aplikacji:

   $ cd django-wf/

3. Utwórz i aktywuj wirtualne środowisko:

    $ python3 -m venv pve3
    $ source pve3/bin/activate    

4. Zainstaluj wymagane zależności:

   $ pip install -r requirements.txt

5. Wykonaj migracje:

   $ python manage.py migrate

6. Utwórz konto administratora:

   $ python manage.py createsuperuser

7. Uruchom serwer deweloperski:

   $ python manage.py runserver

Uruchomienie testów

Aby uruchomić testy w katalogu głównym repozytorium wywołaj polecenie:

$ python manage.py test 

Konfiguracja

• Dodawanie i podgląd informacji wymaga zalogowania jako superużytkownik (na konto utworzone w pkt.7 instrukcji uruchomienia projektu) pod adresem:

  http://localhost:8000/admin
  

• Do aplikacji należy logować się przez konta Google w domenie szkolnej, lecz należy pierw uzupełnić client_id i secret w fixtures/allauth.json i wydać polecenie:

  $ python manage.py loaddata fixtures/allauth.json

  Wartości te można uzyskać tworząc Identyfikator klienta OAuth na stronie https://console.developers.google.com

  Domyślnie każdy zalogowany użytkownik jest traktowany jako uczeń (ma możliwość oglądania tylko swoich wyników), aby dodać możliwość zmiany i wyświetlania wszystkich danych, należy mianować użytkownika na superużytkownika w panelu administracyjnym. Teraz użytkownik (nauczyciel) może logować się ze swojego konta Google.

Przykłaoowe dane

Aby wczytać przykładowe dane należy wydać polecenie:

$ python manage.py loaddata fixtures/example.json

Twórcy

• marcinadd
• marcins1
• inari6735