lista_zakupowa_live/README.md

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 (deweloperska)

1. Sklonuj repozytorium:

   git https://gitea.linuxiarz.pl/gru/lista_zakupowa_live.git
   cd lista_zakupowa_live
   

2. Utwórz i uzupełnij plik .env (zobacz .env example).

3. Utwórz środowisko i zainstaluj zależności:

   python -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt
   

4. Uruchom aplikację:

   flask --app app.py run
   

Deploy z Docker Compose - stack (zalecana)

1. Skonfiguruj .env.

2.1 Uruchom: (pgsql)

bash deploy_docker.sh pgsql

2.2 Uruchom: (mysql)

bash deploy_docker.sh mysql

2.3 Uruchom: (sqlite)

bash deploy_docker.sh sqlite

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