Загрузить файлы в «z1»

z1/README.md

@@ -0,0 +1,72 @@
+# **Správa Používateľov - Docker Aplikácia**
+
+## **1. Podmienky na nasadenie a spustenie aplikácie**
+Aby ste mohli aplikáciu spustiť, musíte mať nainštalované:
+- **Linux** (napr. Ubuntu vo WSL, alebo iná distribúcia)
+- **Docker** (https://docs.docker.com/get-docker/)
+- **Docker Compose** (https://docs.docker.com/compose/install/)
+
+## **2. Opis aplikácie**
+Aplikácia poskytuje jednoduché webové rozhranie na správu používateľov. Používateľlia sú uložení v databáze PostgreSQL a aplikácia ich dokáže pridávať alebo mazať cez jednoduché API a webové rozhranie.
+
+## **3. Opis virtuálnych sietí a pomenovaných zväzkov**
+- **Virtuálna sieť `app_network`** - Umožňuje komunikáciu medzi kontajnermi (web, db, pgAdmin).
+- **Pomenovaný zväzok `pgdata`** - Používa sa na trvalé uloženie databázových údajov PostgreSQL, aby sa nestratili pri reštarte kontajnerov.
+
+## **4. Opis konfigurácie kontajnerov**
+Aplikácia používa **Docker Compose**, kde sú definované tri kontajnery:
+- **Web** (Flask aplikácia)
+  - Počúva na porte **5000**
+  - Komunikuje s databázou `db`
+- **DB** (PostgreSQL)
+  - Používa volume `pgdata` na trvalé uloženie údajov
+  - Počúva na porte **5432**
+- **pgAdmin** (Grafické rozhranie na správu PostgreSQL)
+  - Počúva na porte **8080**
+
+## **5. Zoznam použitých kontajnerov**
+- **Web (Flask)** - Používa Python 3.9 a Flask na poskytovanie webovej aplikácie.
+- **PostgreSQL** - Používa obraz `postgres:13`, databázu `mydatabase`.
+- **pgAdmin** - Používa obraz `dpage/pgadmin4`, port **8080**.
+
+## **6. Ako pripraviť, spustiť, pozastaviť a vymazať aplikáciu**
+
+### **Príprava aplikácie:**
+```bash
+./prepare-app.sh
+```
+Týmto príkazom sa vytvorí sieť, volume a pripraví databáza.
+
+### **Spustenie aplikácie:**
+```bash
+./start-app.sh
+```
+Aplikácia sa spustí a bude dostupná na **http://localhost:5000**.
+
+### **Pozastavenie aplikácie:**
+```bash
+./stop-app.sh
+```
+Pozastavenie aplikácie neodstráni údaje.
+
+### **Vymazanie aplikácie:**
+```bash
+./remove-app.sh
+```
+Tento príkaz **vymaže všetky kontajnery, sieť a volume**, čo znamená, že **databáza bude kompletne vymazaná**.
+
+## **7. Ako si pozrieť aplikáciu v prehliadači**
+- **Hlavná aplikácia:** [http://localhost:5000](http://localhost:5000)
+- **pgAdmin (správa databázy):** [http://localhost:8080](http://localhost:8080)
+
+## **8. Príklad práce s aplikáciou**
+
+### **Pridanie používateľa:**
+1. Otvorte aplikáciu na **http://localhost:5000**
+2. Zadajte meno do textového poľa.
+3. Kliknite na **"Pridať"**.
+4. Používateľ sa uloží do databázy a zobrazí na stránke.
+
+### **Odstránenie používateľa:**
+1. Kliknite na tlačidlo **"Odstrániť"** pri konkrétnom používateľovi.
+2. Používateľ bude vymazaný z databázy.