README.md 1.59 KB
Newer Older
Robert Czechowski's avatar
Robert Czechowski committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
# BwInf Alumni Vereinssystem



## Installation

Für eine Testinstallation brauchen wir Python 3 und Django. Unter
Debian/Ubuntu heißt das:

    apt install python3 python3-django

Zuerst muss eine Datenbank angelegt werden und ein Account erstellt
werden

    cd bwinf-alumni
Robert Czechowski's avatar
Robert Czechowski committed
16
    python3 manage.py makemigrations benutzer mitglieder umsaetze profil
Robert Czechowski's avatar
Robert Czechowski committed
17 18 19 20 21 22 23 24 25 26 27 28
    python3 manage.py migrate            # Datenbank anlegen (sqlite)
    python3 manage.py createsuperuser    # Test-Admin erstellen 
    
Jetzt kann man der Server starten
    
    python3 manage.py runserver          # Server starten
    
Ein Webserver müsste jetzt auf Port 8000 lauschen.

Mit dem vorher angelegtem Admin-Account kann man sich jetzt unter
http://localhost:8000/admin anmelden.

Robert Czechowski's avatar
Robert Czechowski committed
29
## Testdaten erzeugen
Robert Czechowski's avatar
Robert Czechowski committed
30

Robert Czechowski's avatar
Robert Czechowski committed
31 32 33 34 35 36 37 38 39 40 41 42 43 44
Um ein paar Testdaten zu erzeugen, muss erst eine Django-Shell gestartet
werden

    python3 manage.py shell
    
Dann kann man mithilfe des Pakets `mockverein` Testdaten erzeugen

    import mockverein
    mockverein.erstelle_mockdaten()

Dieses Skript kann nur einmal aufgerufen werden, da sonst versucht wird
doppelte Nutzer/Mitglieder zu erzeugen. Ggf. können diese aber mit 
`mockverein.loesche_nutzer()` wieder entfernt werden.
    
Robert Czechowski's avatar
Robert Czechowski committed
45 46
## Funktionalität hinzufügen

47 48
Dafür bitte eine neue App erstellen und in INSTALLED_APPS eintragen 
(bwinfalumni/settings.py)
Robert Czechowski's avatar
Robert Czechowski committed
49 50 51

    python3 manage.py startapp <name>
    
52 53
Bestehende Apps als Referenz sind:
`benutzer`, `mitglieder`, `mitgliederverwaltung`, `mitgliedskonto`, `profil`, `umsaetze`.
Robert Czechowski's avatar
Robert Czechowski committed
54 55
    
Für alle weiteren Schritte, bitte die Django-Dokumentation zu rate
56
ziehen: https://docs.djangoproject.com/en/2.2/
Robert Czechowski's avatar
Robert Czechowski committed
57