drobne zmiany i readme

This commit is contained in:
Mateusz Gruszczyński
2025-07-03 22:19:40 +02:00
parent f03c71cb85
commit 33af290b80
6 changed files with 64 additions and 3 deletions

View File

@ -11,4 +11,5 @@ SYSTEM_PASSWORD=admin
DEFAULT_ADMIN_USERNAME=admin
DEFAULT_ADMIN_PASSWORD=admin123
# Katalog wgrywanych plików
UPLOAD_FOLDER=uploads

58
README.md Normal file
View File

@ -0,0 +1,58 @@
# Live Lista Zakupów
Aplikacja webowa do współdzielonych list zakupów z obsługą wielu użytkowników, trybem współpracy w czasie rzeczywistym, panelami administracyjnymi oraz możliwością załączania paragonów.
## Funkcje
- Tworzenie, edycja i archiwizacja list zakupów
- Dodawanie, edycja, usuwanie produktów i oznaczanie ich jako kupione
- Udostępnianie list przez link (token)
- Wgrywanie zdjęć paragonów do listy zakupów
- Wyszukiwarka produktów i podpowiedzi
- Komentarze do produktów
- Panel administracyjny (zarządzanie użytkownikami, listami, paragonami)
- Obsługa w czasie rzeczywistym (Socket.IO)
- Logowanie i autoryzacja użytkowników
- Systemowe hasło dostępu do aplikacji
## Wymagania
- Docker
- Docker Compose
## Sposób uruchomienia z Docker Compose
1. **Przygotuj plik `.env` w katalogu głównym projektu** (przykład):
APP_PORT=8000
SECRET_KEY=twoj_super_tajny_klucz
SYSTEM_PASSWORD=haslo_do_aplikacji
DEFAULT_ADMIN_USERNAME=admin
DEFAULT_ADMIN_PASSWORD=admin123
2. **Uruchom aplikację:**
Domyślnie aplikacja będzie dostępna pod adresem:
**http://localhost:8000**
3. **Pierwsze logowanie:**
- Po wejściu na stronę zostaniesz poproszony o podanie hasła systemowego (`SYSTEM_PASSWORD`).
- Przy pierwszym uruchomieniu zostanie automatycznie utworzone konto administratora na podstawie zmiennych `DEFAULT_ADMIN_USERNAME` i `DEFAULT_ADMIN_PASSWORD`.
## Domyślne dane logowania
- **Login administratora:** `admin` (lub wartość z `DEFAULT_ADMIN_USERNAME`)
- **Hasło administratora:** `admin123` (lub wartość z `DEFAULT_ADMIN_PASSWORD`)
4. **Aby uruchomić aplikację w Dockerze, wykonaj następujące kroki:**
## Przygotuj plik .env w katalogu projektu z wymaganymi zmiennymi środowiskowymi
## Upewnij się, że w katalogu projektu znajdują się pliki:
## Uruchom aplikację poleceniem:
docker compose up --build
---
**Miłego korzystania z aplikacji!**

View File

@ -11,5 +11,6 @@ services:
- SYSTEM_PASSWORD=${SYSTEM_PASSWORD}
- DEFAULT_ADMIN_USERNAME=${DEFAULT_ADMIN_USERNAME}
- DEFAULT_ADMIN_PASSWORD=${DEFAULT_ADMIN_PASSWORD}
- UPLOAD_FOLDER=${UPLOAD_FOLDER}
volumes:
- .:/app

View File

@ -58,6 +58,7 @@
{% endwith %}
});
</script>
<script src="https://code.jquery.com/jquery-3.6.0.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/lightbox2/2.11.4/js/lightbox.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>

View File

@ -50,7 +50,7 @@
{% endfor %}
</ul>
{% else %}
<p>Nie masz jeszcze żadnych list. Utwórz pierwszą, korzystając z formularza powyżej!</p>
<p><span class="badge bg-secondary">Nie masz jeszcze żadnych list. Utwórz pierwszą, korzystając z formularza powyżej!</span></p>
{% endif %}
{% endblock %}

View File

@ -73,8 +73,8 @@
</div>
{% else %}
<hr>
<p class="text-muted">Brak wgranych paragonów do tej listy.</p>
{% endif %}
<p><span class="badge bg-secondary">Brak wgranych paragonów do tej listy.</span></p>
{% endif %}
<div id="toast-container" class="toast-container position-fixed bottom-0 end-0 p-3"></div>