CODE

🔗 Jak udostępniać i dołączać do wyjazdu?

Wysyłanie linku: Aby zaprosić znajomych do wspólnego wyjazdu, kliknij niebieski przycisk 🔗 (Ikona łańcucha) w prawym górnym rogu ekranu. Link zostanie automatycznie skopiowany do schowka – możesz go wysłać przez WhatsApp, Messenger, SMS lub e-mail.

Dołączanie: Osoba, która otrzyma link i kliknie go na swoim telefonie, zobaczy ekran "Kim jesteś w tej grupie?". Może wybrać swoje imię z listy, dopisać się jako nowa osoba lub zaznaczyć opcję dołączenia jako para.

📸 1. Skanowanie paragonów (AI OCR)

Nie musisz ręcznie przepisywać kwot! Kliknij 📸 Aparat lub 📁 Galeria w formularzu dodawania wydatku. Sztuczna inteligencja odczyta zdjęcie paragonu, ustali łączną kwotę, walutę oraz sugerowany opis rachunku (np. nazwa sklepu/restauracji) i sama uzupełni formularz.

🎙️ 2. Dyktowanie głosowe (AI Voice)

Wolisz mówić niż pisać? Kliknij 🎙️ Podyktuj i powiedz na głos, np.: "Janek zapłacił 120 zł za obiad w restauracji" albo "Kasia kupiła paliwo za 50 euro dla wszystkich oprócz Tomka". AI przeanalizuje mowę i wstawi właściwego płatnika, kwotę, walutę oraz osoby korzystające z wydatku!

⚖️ 3. Podział kosztów (Dla kogo?)

Aplikacja oferuje pełną elastyczność przy rozdzielaniu rachunku:

• Domyślnie po równo (Wszyscy): Wydatek dzieli się automatycznie na każdego uczestnika wyjazdu.
• Dla wybranych osób: Odznacz ptaszek Wszyscy i zaznacz tylko te osoby, które brały udział w wydatku.
• Własne / Nierówne kwoty: Możesz wpisać konkretną kwotę przy jednej lub kilku osobach (np. Tomek zjadł danie za 45 zł). Pozostała kwota rachunku automatycznie podzieli się po równo między resztę zaznaczonych osób!

💱 4. Przeliczanie kursów i wielowalutowość

Zagraniczny wyjazd? Możesz dodawać wydatki w dowolnej walucie (EUR, USD, CHF, GBP itp.). Aplikacja automatycznie przelicza je na główną walutę grupy wg średnich kursów dziennych (z NBP/ECB). Jeśli kupowaliście walutę po konkretnym kursie w kantorze, w ⚙️ Ustawieniach wyjazdu (zakładka 💱 Kursy) możesz ustawić własny, stały kurs wymiany.

👫 5. Tożsamość i konto dla Pary

Każdy uczestnik wybiera swoje imię. Jeśli podróżujesz z partnerem/ką i macie wspólny budżet, włączcie opcję 👫 Jesteśmy parą w Ustawieniach profilu lub przy dołączaniu. Daje to możliwość wygenerowania jednorazowego linku zaproszenia dla drugiej osoby – po kliknięciu oboje korzystacie ze wspólnej tożsamości na swoich telefonach.

🔒 6. Bezpieczeństwo danych i architektura

Brak tradycyjnych haseł: Aplikacja nie wymaga zakładania konta z loginem i hasłem, eliminując ryzyko wycieku Twoich haseł.

Prywatne tokeny kryptograficzne: Po wybraniu swojej tożsamości przeglądarka generuje unikalny token kryptograficzny (UUID), zapamiętywany lokalnie w Twoim telefonie (`localStorage`). Serwer weryfikuje ten token przy każdej zmianie – nikt postronny z innego urządzenia nie może podszyć się pod Twoją tożsamość bez prywatnego tokenu.

Szyfrowana chmura: Dane przechowywane są w globalnej, bezserwerowej bazie Cloudflare D1 z pełnym szyfrowaniem HTTPS.

👑 7. Zarządzanie grupą i zamykanie wyjazdu

Założyciel grupy (Administrator) w oknie Ustawień ⚙️ może dodawać uczestników, ustawiać datę od kiedy dana osoba dołączyła do wyjazdu (żeby nie płaciła za wcześniejsze koszty) oraz – po zakończeniu wyjazdu – oficjalnie zamknąć wyjazd, blokując go przed przypadkowymi zmianami.

☁️ 8. Działanie offline i przenoszenie danych

Aplikacja działa także bez zasięgu sieci! Wydatki zostaną zapisane lokalnie na telefonie i automatycznie wysłane do chmury po odzyskaniu połączenia z internetem. W menu głównym znajdziesz opcję ☁️ Przenieś / Odzyskaj dane, która pozwala przenieść Twoje wyjazdy na nowy telefon za pomocą prostej cyfrowej kopii.

📲 9. Instalacja jako aplikacja (PWA)

Czym jest PWA (Progressive Web App)? Kwita działa jak nowoczesna, natywna aplikacja mobilna, ale nie wymaga pobierania ze sklepów App Store czy Google Play. Możesz dodać ją bezpośrednio na pulpit swojego telefonu – dzięki temu otwiera się na pełnym ekranie (bez pasków przeglądarki), ładuje się błyskawicznie i zapewnia stabilne działanie offline.

Jak zainstalować na swoim telefonie:

• 🤖 Android (Google Chrome): Otwórz stronę w Chrome -> kliknij przycisk trzech kropek ⋮ w prawym górnym rogu -> wybierz "Zainstaluj aplikację" lub "Dodaj do ekranu głównego".
• 🍏 iPhone / iPad (Safari): Otwórz stronę w przeglądarce Safari -> kliknij przycisk Udostępnij ⎋ (kwadrat ze strzałką w górę na dolnym pasku) -> przewiń w dół i kliknij "Do ekranu początkowego".