Aplikacja List Zakupów
Prosta aplikacja webowa do zarządzania listami zakupów z obsługą użytkowników, OCR paragonów, statystykami i trybem współdzielenia.
Główne funkcje
- Logowanie i zarządzanie użytkownikami (admin/user)
- Tworzenie list zakupów z pozycjami i ilością
- Wgrywanie paragonów (podstawowa obsługa OCR)
- Archiwizacja i udostępnianie list (publiczne/prywatne)
- Statystyki wydatków z podziałem na okresy, statystyki dla użytkowników
- Panel administracyjny (statystyki, produkty, paragony, zarządzanie, użytkowmicy)
Wymagania
- Python 3.9+
- Docker (opcjonalnie dla produkcji)
Instalacja lokalna
-
Sklonuj repozytorium:
git https://gitea.linuxiarz.pl/gru/lista_zakupowa_live.git cd lista_zakupowa_live -
Utwórz i uzupełnij plik
.env(zobacz.env example). -
Utwórz środowisko i zainstaluj zależności:
python -m venv venv source venv/bin/activate pip install -r requirements.txt -
Uruchom aplikację:
flask --app app.py run
Deploy z Docker Compose
-
Skonfiguruj
.env. -
Uruchom:
docker-compose up --build
Aplikacja będzie dostępna pod http://localhost:8000.
Domyślne dane logowania
- Główne hasło systemowe:
admin - Admin:
admin/admin123
Konfiguracja bazy danych
Obsługiwane silniki: sqlite, pgsql, mysql.
Ustaw DB_ENGINE oraz odpowiednie zmienne w .env:
Przykład dla PostgreSQL:
DB_ENGINE=pgsql
DB_HOST=db
DB_PORT=5432
DB_NAME=myapp
DB_USER=user
DB_PASSWORD=pass