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+
• Redis (dla socket.io, opcjonalnie)
• Docker (opcjonalnie)

Instalacja lokalna

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

1. Skonfiguruj .env.

2. 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