Merging main -> Tymon

.env

@@ -0,0 +1,7 @@
+EXPO_PUBLIC_OPENAI_API_KEY=
+EXPO_PUBLIC_FIREBASE_API_KEY=
+EXPO_PUBLIC_FIREBASE_AUTH_DOMAIN=
+EXPO_PUBLIC_FIREBASE_PROJECT_ID=
+EXPO_PUBLIC_FIREBASE_STORAGE_BUCKET=
+EXPO_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=
+EXPO_PUBLIC_FIREBASE_APP_ID=

.eslintrc.js

@@ -1,3 +1,4 @@
+/* eslint-disable no-undef */
 module.exports = {
     root: true,
     parser: "@typescript-eslint/parser",

.gitignore

@@ -10,6 +10,8 @@ npm-debug.*
 *.orig.*
 web-build/
 .env
+firebase.config.ts
+secrets.txt
 
 # macOS
 .DS_Store

Documentation/app/(auth)/login.adoc

@@ -0,0 +1,77 @@
+= Dokumentacja komponentu `Login`
+
+Komponent `Login` umożliwia logowanie użytkownika w aplikacji mobilnej zbudowanej w React Native z wykorzystaniem Firebase. Zawiera formularz logowania z obsługą błędów i logiką uwierzytelniania użytkownika.
+
+== Importowane moduły i komponenty
+
+* `View`, `SafeAreaView`, `TouchableOpacity`, `Text`, `Alert` - komponenty React Native używane do tworzenia interfejsu użytkownika.
+* `useState` - hook React do zarządzania stanem komponentu.
+* `LoginSignupHeader` - komponent nagłówka logowania/rejestracji.
+* `CustomInput`, `CustomButton` - komponenty niestandardowe obsługujące pola wejściowe i przyciski.
+* `router` - moduł do nawigacji między ekranami.
+* `LoginSignupFooter` - komponent stopki logowania/rejestracji.
+* `signInWithEmailAndPassword`, `sendEmailVerification` - funkcje Firebase Authentication do logowania oraz wysyłania e-maila weryfikacyjnego.
+* `AsyncStorage` - moduł do przechowywania danych na urządzeniu.
+* `doc`, `getDoc`, `setDoc`, `updateDoc` - funkcje Firebase Firestore do zarządzania dokumentami w bazie danych.
+* `ChoseTeam` - komponent wyboru zespołu użytkownika.
+* `useThemeColor` - hook do pobrania koloru tła na podstawie motywu aplikacji.
+* `FIREBASE_AUTH`, `FIREBASE_DB` - instancje Firebase Authentication oraz Firebase Firestore.
+
+== Stan komponentu
+
+* `email` - przechowuje wprowadzony przez użytkownika adres e-mail.
+* `password` - przechowuje hasło użytkownika.
+* `loading` - wskazuje, czy trwa proces logowania.
+* `isChosingTeam` - informuje, czy użytkownik powinien wybrać zespół po zalogowaniu.
+* `backgroundColor` - kolor tła ekranu, dostosowany do motywu aplikacji.
+
+== Funkcje
+
+=== `signIn`
+
+Asynchroniczna funkcja do obsługi logowania użytkownika.
+- Uwierzytelnia użytkownika przy użyciu `signInWithEmailAndPassword`.
+- Wysyła e-mail weryfikacyjny, jeśli e-mail nie jest zweryfikowany.
+- Zapisuje dane użytkownika (`uid`, `email`) w `AsyncStorage`.
+- Pobiera dokument użytkownika z Firestore i sprawdza, czy użytkownik przypisany jest do zespołu.
+- Obsługuje błędy związane z logowaniem, wyświetlając odpowiednie komunikaty.
+
+=== `handleSignupPress`
+
+Obsługuje nawigację do ekranu rejestracji użytkownika, wywołując `router.replace("/signup")`.
+
+=== `handleTreeSelect`
+
+Przypisuje wybrany zespół do konta użytkownika.
+- Aktualizuje dokument użytkownika w Firestore.
+- Przekierowuje użytkownika do głównego ekranu aplikacji.
+
+== Struktura renderowania
+
+Komponent wyświetla różne elementy interfejsu użytkownika w zależności od wartości `isChosingTeam`:
+
+* Gdy `isChosingTeam` jest `true`, wyświetla komponent `ChoseTeam`, umożliwiający użytkownikowi wybór zespołu.
+* Gdy `isChosingTeam` jest `false`, wyświetla formularz logowania z:
+  ** `CustomInput` dla adresu e-mail i hasła,
+  ** `CustomButton` dla przycisku logowania,
+  ** `TouchableOpacity` z tekstem przekierowującym do rejestracji,
+  ** `LoginSignupHeader` oraz `LoginSignupFooter` w górnej i dolnej części ekranu.
+
+Całość jest otoczona w `SafeAreaView`, co zapewnia odpowiednie wyrównanie na urządzeniach z wycięciami lub zaokrąglonymi rogami.
+
+== Uwagi
+
+* Funkcje Firebase są asynchroniczne i mogą generować błędy; komponent zawiera obsługę typowych błędów logowania.
+* `AsyncStorage` przechowuje dane logowania, co umożliwia automatyczne logowanie po ponownym uruchomieniu aplikacji.
+* `useThemeColor` umożliwia dostosowanie tła do motywu aplikacji.
+
+== Przykład użycia
+
+```javascript
+import Login from './Login';
+
+export default function App() {
+    return (
+        <Login />
+    );
+}

Documentation/app/(auth)/privacy.adoc

@@ -0,0 +1,39 @@
+= Dokumentacja komponentu `Privacy`
+
+Komponent `Privacy` wyświetla politykę prywatności w aplikacji mobilnej. Umożliwia użytkownikowi powrót do ekranu logowania lub rejestracji w zależności od przekazanego parametru.
+
+== Importowane moduły i komponenty
+
+* `ThemedText` - komponent do wyświetlania tekstu z motywem kolorystycznym.
+* `useThemeColor` - hook dostosowujący kolor do motywu aplikacji.
+* `Ionicons` - ikony z biblioteki Expo.
+* `Href`, `router`, `useLocalSearchParams` - moduły `expo-router` do obsługi nawigacji i parametrów URL.
+* `SafeAreaView`, `TouchableOpacity`, `View`, `ScrollView` - komponenty React Native do budowy interfejsu.
+
+== Funkcje i logika komponentu
+
+=== `useLocalSearchParams`
+
+- Hook używany do pobrania parametrów przekazanych w URL (np. ścieżka powrotna).
+- Na podstawie parametru `redirect` ustala ścieżkę powrotną (`login` lub `signup`).
+
+=== `backgroundColor`
+
+- Przechowuje kolor tła ekranu, ustawiony w zależności od motywu aplikacji, pobrany za pomocą `useThemeColor`.
+
+== Struktura renderowania
+
+* Zawartość jest opakowana w `SafeAreaView` z klasą `flex-1`, co dostosowuje widok do wyświetlacza urządzenia.
+* Przyciski i ikony są ułożone w wierszu (`flex-row`) na górze ekranu, co umożliwia powrót do poprzedniego ekranu.
+* Przycisk `TouchableOpacity` z ikoną `Ionicons` służy do nawigacji powrotnej, odwołując się do `router.replace(redirect as Href)`.
+
+== Przykład użycia
+
+```javascript
+import Privacy from './Privacy';
+
+export default function App() {
+    return (
+        <Privacy />
+    );
+}

Documentation/app/(auth)/signup.adoc

@@ -0,0 +1,58 @@
+= Dokumentacja komponentu `Signup`
+
+Komponent `Signup` umożliwia rejestrację nowego użytkownika w aplikacji mobilnej, z użyciem Firebase Authentication. Komponent zawiera formularz do wprowadzenia e-maila i hasła oraz obsługę procesu tworzenia konta.
+
+== Importowane moduły i komponenty
+
+* `View`, `SafeAreaView`, `TouchableOpacity`, `Text`, `Alert` - komponenty React Native do tworzenia interfejsu użytkownika.
+* `LoginSignupHeader` - komponent nagłówka logowania/rejestracji.
+* `CustomInput`, `CustomButton` - komponenty do obsługi pól wejściowych i przycisków.
+* `router` - moduł `expo-router` do nawigacji między ekranami.
+* `LoginSignupFooter` - komponent stopki logowania/rejestracji.
+* `createUserWithEmailAndPassword`, `sendEmailVerification` - funkcje Firebase Authentication do rejestracji i weryfikacji adresu e-mail.
+* `FIREBASE_AUTH`, `FIREBASE_DB` - instancje Firebase Authentication i Firestore.
+* `doc`, `setDoc` - funkcje Firebase Firestore do operacji na dokumentach.
+* `useThemeColor` - hook dostosowujący kolor tła do motywu aplikacji.
+
+== Stan komponentu
+
+* `email` - przechowuje e-mail użytkownika.
+* `password` - przechowuje hasło użytkownika.
+* `repassword` - przechowuje ponownie wpisane hasło w celu weryfikacji.
+* `backgroundColor` - kolor tła ekranu, zależny od motywu aplikacji.
+
+== Funkcje
+
+=== `handleSignupPress`
+
+- Funkcja do obsługi nawigacji do ekranu logowania, używająca `router.replace("/login")`.
+
+=== `handleSignup`
+
+Asynchroniczna funkcja do rejestracji użytkownika.
+- Tworzy nowe konto użytkownika za pomocą `createUserWithEmailAndPassword`.
+- Wysyła e-mail weryfikacyjny do nowego użytkownika za pomocą `sendEmailVerification`.
+- Zapisuje podstawowe dane użytkownika (`uid`, `email`, `team`) w Firestore, aby umożliwić identyfikację w aplikacji.
+- Obsługuje błędy, wyświetlając odpowiednie komunikaty, np. w przypadku niepoprawnego adresu e-mail lub hasła.
+
+== Struktura renderowania
+
+* Ekran zawiera:
+  ** `LoginSignupHeader` jako nagłówek,
+  ** Formularz z polami `CustomInput` do wprowadzenia e-maila, hasła i powtórzenia hasła,
+  ** Przycisk `CustomButton` do rejestracji,
+  ** `TouchableOpacity` z tekstem umożliwiającym powrót do ekranu logowania,
+  ** `LoginSignupFooter` jako stopkę.
+
+* Widok zawiera `SafeAreaView` z klasą `flex-1`, aby zapewnić dopasowanie do ekranu urządzenia.
+
+== Przykład użycia
+
+```javascript
+import Signup from './Signup';
+
+export default function App() {
+    return (
+        <Signup />
+    );
+}

Documentation/app/(auth)/tos.adoc

@@ -0,0 +1,39 @@
+= Dokumentacja komponentu `TermsOfUse`
+
+Komponent `TermsOfUse` wyświetla warunki korzystania z aplikacji mobilnej. Umożliwia użytkownikowi powrót do ekranu logowania lub rejestracji, zależnie od przekazanych parametrów.
+
+== Importowane moduły i komponenty
+
+* `ThemedText` - komponent do wyświetlania tekstu w zgodzie z motywem aplikacji.
+* `useThemeColor` - hook dostosowujący kolor tła do motywu aplikacji.
+* `Ionicons` - ikony z biblioteki Expo.
+* `Href`, `router`, `useLocalSearchParams` - moduły `expo-router` do zarządzania nawigacją i przekazywanymi parametrami.
+* `SafeAreaView`, `TouchableOpacity`, `View`, `ScrollView` - komponenty React Native do tworzenia struktury i stylizacji interfejsu.
+
+== Funkcje i logika komponentu
+
+=== `useLocalSearchParams`
+
+- Pobiera parametry URL, np. `redirect`, aby ustawić odpowiedni ekran powrotny.
+- `redirect` wskazuje ścieżkę powrotną (np. `login` lub `signup`), która jest ustawiana na podstawie wartości parametru.
+
+=== `backgroundColor`
+
+- Kolor tła dostosowany do motywu aplikacji, ustawiony za pomocą `useThemeColor`.
+
+== Struktura renderowania
+
+* Cały ekran jest opakowany w `SafeAreaView` z klasą `flex-1`, co zapewnia responsywność.
+* Górna część zawiera przycisk `TouchableOpacity` z ikoną `Ionicons`, umożliwiający powrót do poprzedniego ekranu (logowania lub rejestracji).
+* Tekst warunków wyświetlany jest wewnątrz `ScrollView`, aby umożliwić przewijanie, co poprawia dostępność treści na urządzeniach mobilnych.
+
+== Przykład użycia
+
+```javascript
+import TermsOfUse from './TermsOfUse';
+
+export default function App() {
+    return (
+        <TermsOfUse />
+    );
+}

Documentation/app/(tabs)/_layout.adoc

@@ -0,0 +1,46 @@
+= Dokumentacja komponentu `TabLayout`
+
+Komponent `TabLayout` definiuje układ nawigacji dolnej (ang. *tab navigation*) dla aplikacji mobilnej. Każda karta (ang. *tab*) odpowiada innemu ekranowi aplikacji, w tym: głównej, wyzwań, drzewa i ustawień. Układ dostosowuje styl nawigacji w zależności od aktywnego motywu kolorystycznego (`light` lub `dark`).
+
+== Importowane moduły i komponenty
+
+* `Tabs` - komponent `expo-router` do definiowania układu kart w aplikacji.
+* `TabBarIcon` - niestandardowy komponent ikony nawigacji dolnej.
+* `Colors` - stała przechowująca kolory aplikacji dla różnych trybów kolorystycznych.
+* `useColorScheme` - hook do określania aktywnego schematu kolorów (`light` lub `dark`), dostosowujący kolory tła i aktywne kolory ikon.
+
+== Logika komponentu
+
+* `colorScheme` - wynik `useColorScheme`, wykorzystywany do dynamicznego ustawienia kolorów kart.
+* `Tabs` zawiera listę ekranów (`Screen`) jako karty z określonymi ikonami, tytułami i nazwami.
+
+== Struktura renderowania
+
+=== `Tabs` (Główna nawigacja)
+
+* `screenOptions` ustawia:
+  * `tabBarStyle.backgroundColor` - kolor tła, zależny od aktywnego motywu (`Colors.light.background` lub `Colors.dark.background`).
+  * `tabBarActiveTintColor` - kolor aktywnych ikon kart, zależny od motywu.
+  * `headerShown: false` - ukrywa nagłówek aplikacji.
+
+=== Ekrany kart
+
+Każda karta definiuje nazwę (`name`) i opcje (`options`), takie jak tytuł i ikona:
+
+* `index` (Główna): Ikona domku (`home` lub `home-outline`), tytuł `Główna`.
+* `challenges` (Wyzwania): Ikona sztangi (`barbell` lub `barbell-outline`), tytuł `Wyzwania`.
+* `tree` (Drzewko): Ikona liścia (`leaf` lub `leaf-outline`), tytuł `Drzewko`.
+* `settings` (Ustawienia): Ikona ustawień (`settings` lub `settings-outline`), tytuł `Ustawienia`.
+
+Każda ikona zmienia się zależnie od tego, czy karta jest aktywna (`focused`), co realizuje komponent `TabBarIcon`.
+
+== Przykład użycia
+
+```javascript
+import TabLayout from './TabLayout';
+
+export default function App() {
+    return (
+        <TabLayout />
+    );
+}

Documentation/app/(tabs)/challange.adoc

@@ -0,0 +1,68 @@
+= Dokumentacja komponentu Challenges
+
+Komponent `Challenges` to ekran w aplikacji, który zarządza wyzwaniami dla użytkowników. Pozwala na wyświetlanie aktywnego zadania oraz listy wyzwań. W tym komponencie zarządzane są także ustawienia związane z alertami oraz pobieraniem danych użytkownika z bazy Firebase.
+
+== Importowane moduły i komponenty
+
+* `Alert`, `BackHandler`, `Platform`, `SafeAreaView`, `View` - komponenty z `react-native` do obsługi UI i zdarzeń systemowych.
+* `SearchBar` - komponent wyszukiwania, umożliwia filtrowanie wyzwań na podstawie zapytania.
+* `ChallengesList` - komponent wyświetlający listę wyzwań.
+* `useEffect`, `useState` - hooki z Reacta do zarządzania stanem i efektami ubocznymi.
+* `useThemeColor` - niestandardowy hook, który zwraca kolor motywu w zależności od trybu.
+* `ThemedText` - komponent tekstowy, który automatycznie stosuje odpowiedni motyw.
+* `AsyncStorage` - służy do przechowywania danych lokalnych, np. flagi, czy użytkownik widział alert.
+* `doc`, `getDoc` - metody z Firebase Firestore do pobierania dokumentów z bazy danych.
+* `useUser` - niestandardowy hook, który zwraca dane użytkownika (np. `uid`, `loading`).
+
+== Zmienne stanu
+
+* `currentQuestId` - przechowuje identyfikator aktualnie aktywnego zadania.
+* `currentQuest` - przechowuje dane dotyczące aktualnego zadania (tytuł, poziom trudności, itd.).
+* `query` - zapytanie wprowadzane przez użytkownika w celu filtrowania listy wyzwań.
+
+== Funkcje i efekty
+
+### `useEffect`
+
+Hook `useEffect` wykonuje następujące czynności:
+1. **Sprawdzenie pierwszego użycia**: Sprawdza, czy użytkownik już widział alert o rzetelnym wypełnianiu wyzwań. Jeśli nie, wyświetla alert.
+2. **Pobieranie aktywnego zadania**: Jeśli użytkownik jest zalogowany, pobiera aktywne zadanie z bazy danych Firebase.
+
+### `checkFirstUse`
+
+Funkcja ta sprawdza, czy użytkownik widział już alert informujący o konieczności rzetelnego podejścia do wyzwań. Jeśli nie, wyświetla odpowiedni komunikat i zapisuje informację w `AsyncStorage`.
+
+### `fetchCurrentQuest`
+
+Funkcja ta pobiera aktualnie przypisane zadanie z bazy danych Firebase. Na podstawie `user.uid` pobiera dokument użytkownika, a następnie pobiera dokument wyzwania, które jest przypisane do użytkownika.
+
+### `getColor`
+
+Funkcja, która na podstawie poziomu trudności zadania przypisuje odpowiednią kolorystykę. Na przykład:
+- Poziom 1: Kolor podstawowy.
+- Poziom 2: Kolor pomarańczowy.
+- Poziom 3: Kolor czerwony.
+
+== Interfejs użytkownika
+
+1. **Alerty**: Użytkownik po pierwszym uruchomieniu aplikacji zostaje zapytany o zobowiązanie do rzetelnego wypełniania wyzwań. Możliwość odpowiedzi "Tak" lub "Nie", przy czym wybór "Nie" kończy działanie aplikacji.
+2. **Aktywne zadanie**: Wyświetlana jest sekcja z aktywnym zadaniem, jeśli użytkownik ma przypisane wyzwanie.
+3. **Lista wyzwań**: Poniżej sekcji z aktywnym zadaniem wyświetlana jest lista dostępnych wyzwań, która jest filtrowana na podstawie zapytania użytkownika.
+
+### Layout i UI
+
+- Górna sekcja wyświetla tytuł ekranu: "Wyzwania".
+- Pod tytułem znajduje się komponent `SearchBar`, umożliwiający filtrowanie listy wyzwań na podstawie zapytania.
+- Jeśli istnieje aktywne zadanie, wyświetlane jest ono w sekcji "Aktywne zadanie".
+- Na dole wyświetlana jest lista wyzwań (komponent `ChallengesList`), której zawartość jest filtrowana na podstawie zapytania.
+
+== Przykład użycia
+
+```javascript
+import Challenges from './Challenges';
+
+export default function App() {
+    return (
+        <Challenges />
+    );
+}