web app

README.md

@@ -1,2 +1,36 @@
-# opinie
+# Licznik opinii Google Maps
 
+Lekka strona pokazująca dokładne liczniki opinii 1–5. Odczytuje tekstowe wartości dostępności histogramu Google — nie szacuje ich z długości pasków, nie pobiera treści opinii i niczego nie zapisuje.
+
+## Lokalnie
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+playwright install chromium
+python app.py
+```
+
+Otwórz `http://127.0.0.1:8080`.
+
+## Raspberry Pi OS (bez Dockera)
+
+```bash
+sudo apt update
+sudo apt install chromium python3-venv
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+CHROMIUM_PATH=/usr/bin/chromium gunicorn --workers 1 --threads 2 --bind 127.0.0.1:8080 app:app
+```
+
+Na świat wystaw aplikację przez nginx/Caddy z HTTPS. Zostaw jeden worker: aplikacja celowo dopuszcza tylko jedno sprawdzenie naraz, by chronić RAM i CPU RPi.
+
+Google może czasem pokazać niezalogowanej przeglądarce „ograniczony widok” i ukryć wszystkie opinie. Wtedy aplikacja zwraca błąd — nigdy nie zgaduje wartości z długości pasków i nie wymaga przechowywania konta Google.
+
+## Testy
+
+```bash
+python -m unittest discover -s tests -v
+```