# Instrukcja instalacji aplikacji EQ2.

## Wstęp

Całe środowisko skłąda się z 3 instalacji.

- main-page: zawiera kod źródłowy strony głównej https://eq2.pl
- landing-page: zawiera kod źródłowy strony z formularzem https://lp.eq2.pl
- api: zawiera kod źródłowy API, które jest odpowiedzialne za przetwarzanie leadów z formularzy
- database.sql: export bazy danych, który należy zaimportować

API zostało przygotowane z wykorzystaniem composer'a (https://getcomposer.org/) oraz frameworka symfony 4 (https://symfony.com/). Aplikacje frontendowe wykorzystują narzędzia node (v 10.20.*), yarn (1.22.*) i webpack (3.10)  W razie późniejszych modyfikacji zalecana jest znajomość wskazanych narzędzi.

## Wymagania

- środowisko unix
- php w wersji co najmniej 7.1
- moduł php-mysql (w wersji odpowiadającej wersji php)
- mysql w wersji 5.7
- apache2 z modułem mod_php7 oraz mod_rewrite
	- zalecamy apache2 ale można wykorzystać nginx

## Instrukcja

### Baza danych

- Należy utworzyć bazę danych dla EQ2
- Do bazy danych zaimportować dane z `database.sql`
- zmienić treść pliku `api/.env.local` i wyedytować zmienną DATABASE_URL zgodnie z przykładem

### Mailer

- należy skonfigurować pocztę e-mail na serwerze (SMTP)
- zmienić treść pliku `api/.env.local` i wyedytować zmienne odpowiedzialne za wysyłkę maili (zgodnie z przykładami)
	- MAILER_URL
	- SENDER_MAIL
	- SENDER_NAME
	- RECIPIENT_MAIL

### Serwer HTTPS

Nasz zespół do serwowania stron korzystaliśmy z apache2.

- konfiguracja domeny głównej `eq2.pl` musi wskazywać na folder `main-page/dist`
- w folderze main-page dist musi istnieć link symboliczny wskazujący na folder `api/public`
	- `cd ./main-page/dist && ln -s ../../api/public ./main-page/dist/api`
- konfiguracja subdomeny `lp.eq2.pl` musi wskazywać na folder `landing-page/dist`

**UWAGA!** dla każdej strony jest skonfigurowany .htaccess (api/public/.htaccess, main-page/dist/.htaccess, landing-page/dist/.htaccess) w taki sposób, że wymuszany jest HTTPS! W związku z tym dla serwera musi być skonfirurowany HTTPS oraz ważny certyfikat.