feat: add comprehensive project documentation in README and project summary

README.md

@@ -0,0 +1,52 @@
+# Kalkulator Godzin Odoo (Duck Odoo Calc)
+
+Aplikacja webowa służąca do pobierania, analizowania oraz interaktywnego kalkulowania godzin pracy na podstawie rejestru obecności z systemu **Odoo** (`hr.attendance`).
+
+## Główne Funkcjonalności
+*   **Logowanie danymi Odoo**: Bezpieczne logowanie i generowanie sesji JWT.
+*   **Automatyczne pobieranie danych**: Pobieranie historii wejść/wyjść dla wybranego miesiąca i roku.
+*   **Wizualizacja danych**: Stackowany wykres kolumnowy (Chart.js) prezentujący przepracowany czas, dni urlopowe oraz chorobowe.
+*   **Interaktywny kalendarz**:
+    *   Szybkie dodawanie i usuwanie wpisów obecności.
+    *   Wygodne suwaki czasu (`TimeStepper`) do edycji godzin wejścia/wyjścia (z dokładnością do minuty).
+    *   Możliwość oznaczania dni jako urlop (8h) lub chorobowe (6.4h - 80%).
+*   **Automatyczne przeliczanie**:
+    *   Uwzględnianie świąt państwowych w Polsce oraz weekendów.
+    *   Automatyczne odliczanie 15-minutowej przerwy obiadowej (0.25h) przy każdym dniu pracy.
+    *   Bieżące wyliczanie salda nadgodzin (bilansu dziennego i ogólnego).
+
+---
+
+## Wymagania i Konfiguracja
+
+Przed uruchomieniem aplikacji należy utworzyć plik `.env` w katalogu `backend/` i skonfigurować następujące zmienne:
+
+```env
+SECRET_KEY=twoj_klucz_jwt_np_z_openssl_rand_hex_32
+ALGORITHM=HS256
+ACCESS_TOKEN_EXPIRE_MINUTES=60
+ODDO_URL=https://odoo.twoja-firma.pl
+DB_NAME=nazwa_bazy_danych_odoo
+ORIGINS=http://localhost:6080
+```
+
+---
+
+## Uruchomienie Projektu
+
+Aplikacja jest w pełni konteneryzowana za pomocą Docker Compose. Aby ją zbudować i uruchomić locally, wykonaj polecenie:
+
+```bash
+docker compose up --build
+```
+
+Po uruchomieniu:
+*   Aplikacja frontendowa (Vue) będzie dostępna pod adresem: **`http://localhost:6080/odoo/`**
+*   API backendowe (FastAPI) będzie dostępne pod adresem: **`http://localhost:8000/`** (proxy z frontendu przekierowuje zapytania `/odoo/api/` na backend).
+
+---
+
+## Szczegółowa Dokumentacja
+
+Pełna specyfikacja techniczna, w tym struktura plików, algorytmy obliczeniowe, konfiguracja Nginx oraz opis testów jednostkowych znajduje się w pliku:
+*   [project_summary.md](project_summary.md)