init

README.md

@@ -1,3 +1,57 @@
-# django_przyklad_generic_admin
+# Przykładowa aplikacja w Django
+
+Przykład projektu Django z widokami generycznymi. 
+Logowanie: admin, hasło: ZAQ!2wsx
+
+# Wymagania
+
+Zainstalowany Python 3.10+
+
+Sprawdź: python --version
+
+albo
+
+python3 --version
+
+Jeśli masz oba, na Linux/Mac zwykle używasz python3, na Windows – python.
+
+Wymagany program GIT
+
+# Instalacja
+
+1. Sklonuj repozytorium na dysk
+   git clone https://git.smartwmt.pl/admin/django_przyklad_generic_admin.git
+2. Otwórz folder projektu np. w Visual Studio Code
+3. Terminal -> Nowy terminal
+4. Utwórz i włącz wirtualne środowisko python -m vevn venv
+5. Aktywuj środowisko wirtualne: 
+    
+    Windows: venv\Scripts\activate
+    
+    Linux / macOS: source venv/bin/activate
+6. Po aktywacji w konsoli powinna pojawić się nazwa środowiska, np. (venv).
+7. Zainstaluj zależności z pliku requirements.txt
+    
+    pip install -r requirements.txt
+8. Uruchom serwer: 
+  
+   python manage.py runserver
+
+## Jeśli usuniesz bazę i chcesz utworzyć nową i superużytkownika
+
+1. Utwórz bazę (migracje)
+
+   python manage.py migrate
+2. Utwórz konto administratora
+
+    python manage.py createsuperuser
+
+3. Uruchom serwer developerski
+
+    python manage.py runserver
+
+Domyślnie aplikacja działa pod adresem:
+
+http://127.0.0.1:8000/ (to samo co http://localhost:8000/)
+
 
-Przykład projektu Django z widokami generycznymi. Logowanie: admin, hasło: 12345678