# 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:

   ```bash
   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:

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

4. Uruchom aplikację:

   ```bash
   flask --app app.py run
   ```

## Deploy z Docker Compose

1. Skonfiguruj `.env`.

2. Uruchom:

   ```bash
   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:

```env
DB_ENGINE=pgsql
DB_HOST=db
DB_PORT=5432
DB_NAME=myapp
DB_USER=user
DB_PASSWORD=pass
```