Compare commits

..

2 Commits

Author SHA1 Message Date
92c892c42b oprava preklepov 2026-04-18 22:19:58 +02:00
e36b254282 readme + oprava preklepov 2026-04-18 22:19:03 +02:00
3 changed files with 74 additions and 1 deletions

51
README.md Normal file
View File

@@ -0,0 +1,51 @@
# Gobas Web
Tento projekt obsahuje jednoduchý statický web a backend pre kontaktný formulár. Celá aplikácia je kontajnerizovaná pomocou Dockeru a beží za NGINX reverzným proxy serverom pre bezproblémový a rýchly deployment.
## Architektúra
Projekt sa skladá z troch hlavných služieb definovaných v `docker-compose.yaml`:
* **Proxy (NGINX):** Prijíma prichádzajúcu prevádzku na porte 80 a smeruje ju buď na statický frontend alebo na API backendu.
* **Frontend:** Jednoduchá webová prezentácia.
* **Backend (Flask):** Python mikroservis, ktorý slúži na spracovanie a odosielanie emailov z kontaktného formulára pomocou knižnice `Flask-Mail`.
## Požiadavky
Pre úspešné lokálne spustenie alebo nasadenie na server je potrebné mať nainštalované:
* Docker
* Docker Compose
## Konfigurácia prostredia (.env)
Backendová časť potrebuje na odosielanie správ z formulára prístup k SMTP serveru (predvolený je Gmail).
V koreňovom adresári projektu (kde sa nachádza `docker-compose.yaml`) vytvorte súbor `.env` a doplňte doň svoje údaje:
```env
MAIL_USERNAME=tvoj@email.sk
MAIL_PASSWORD=tvoje_tajne_heslo_alebo_app_password
```
> **Poznámka pre Gmail:** Ak máte na Google účte zapnuté dvojfázové overenie (2FA), klasické heslo nebude fungovať. Je potrebné si v nastaveniach Google účtu vygenerovať tzv. Heslo aplikácie (App Password).
## Spustenie
Pre zostavenie Docker obrazov a naštartovanie všetkých služieb na pozadí spustite nasledujúci príkaz:
```bash
docker-compose up --build -d
```
Po úspešnom spustení bude webová stránka dostupná vo vašom prehliadači na adrese `http://localhost`.
Pre zastavenie bežiacich kontajnerov použite:
```bash
docker-compose down
```
## Štruktúra projektu
* `/frontend/` - Zdrojové kódy pre statický web a príslušný `Dockerfile`.
* `/backend/` - Zdrojové kódy pre Python Flask API a jeho `Dockerfile`.
* `/nginx/` - Konfiguračný súbor `nginx.conf` pre reverzné proxy.
* `docker-compose.yaml` - Hlavný predpis pre Docker služby.

View File

@@ -13,7 +13,7 @@ services:
frontend: frontend:
build: build:
context: ./frontned context: ./frontend
dockerfile: Dockerfile dockerfile: Dockerfile
container_name: gobas_frontend container_name: gobas_frontend
restart: unless-stopped restart: unless-stopped

22
nginx.conf Normal file
View File

@@ -0,0 +1,22 @@
server {
listen 80;
server_name localhost;
# Smerovanie bežných požiadaviek na frontend kontajner
location / {
proxy_pass http://frontend:80;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
# Smerovanie API požiadaviek (odosielanie emailu) na backend kontajner
location /send-email {
proxy_pass http://backend:5000/send-email;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}