Eventownik Solvro – Mobile Legacy

Warning

To repozytorium zawiera starą wersję aplikacji. Nowa wersja aplikacji rozwijana jest w repozytorium mobile-eventownik-v2.

Uruchomienie lokalne

Wymagania

• Node.js
• npm (dostarczany z Node.js)

Instalacja

1. Sklonuj repozytorium

   git clone https://github.com/Solvro/mobile-eventownik.git
   cd mobile-eventownik

2. Zainstaluj zależności

   npm install

3. Ustaw zmienne środowiskowe z URL do API

   export VITE_API_URL='http://localhost:8000/api/'
   export VITE_WS_API_URL='ws://localhost:8000/'

4. Uruchom serwer deweloperski (upewnij się, że serwer API działa)

   ionic serve

Testy E2E (Cypress)

1. Dodaj poniższe zmienne środowiskowe do serwera API, aby wyłączyć limity (throttling) dla testów:

   ANON_THROTTLE_RATE = 'None'
   USER_THROTTLE_RATE = 'None'

2. W osobnym terminalu uruchom środowisko Cypress:

   npx cypress open

3. Upewnij się, że aplikacja kliencka działa równolegle (ionic serve).

Dostępne skrypty

Komenda	Opis
ionic serve	Uruchamia lokalny serwer deweloperski aplikacji
npm install	Instaluje wszystkie wymagane zależności projektu
npx cypress open	Otwiera okno uruchomieniowe testów end-to-end Cypress

Struktura projektu

• src/ – Główny katalog źródłowy aplikacji.
  • assets/ – Zasoby statyczne, takie jak style CSS i obrazy.
    • main.css – Główne style aplikacji.
    • variables.css – Zmienne CSS motywu.
  • components/ – Komponenty Vue używane w aplikacji.
    • ExampleComponent.vue – Przykładowy komponent.
  • router/ – Konfiguracja routingu aplikacji.
    • index.js – Definicje ścieżek aplikacji.
  • store/ – Zarządzanie stanem aplikacji (Pinia).
  • App.vue – Główny komponent aplikacji.
  • main.js – Punkt wejściowy aplikacji.
• public/ – Pliki publiczne dostępne bezpośrednio (np. index.html).
• package.json – Plik konfiguracyjny projektu zawierający zależności i skrypty.
• vite.config.js – Konfiguracja Vite.

Stack technologiczny

Frontend

• Framework: Vue.js 3
• Stan globalny: Pinia
• Build Tool: Vite
• Routing: Vue Router

UI & Mobile

• Cross-platform Runtime: Capacitor
• UI Framework: Ionic

Testy

• E2E Testing: Cypress

---

Licencja

Projekt jest udostępniany na warunkach licencji AGPL (GNU Affero General Public License).

---

Stworzone przez KN Solvro dla studentów Politechniki Wrocławskiej