tm216ux/bakalarka_praca
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
226a072e93
bakalarka_praca/website
History
Tetiana Mohorian 226a072e93 Aktualizovat website/README.md
2025-05-20 11:11:02 +00:00
..
backend Nahrát soubory do „website/backend“ 2025-05-20 11:05:57 +00:00
frontend Nahrát soubory do „website/frontend/public“ 2025-05-20 11:08:49 +00:00
docker-compose.yaml Nahrát soubory do „website“ 2025-05-20 11:05:36 +00:00
Dockerfile Nahrát soubory do „website“ 2025-05-20 11:05:36 +00:00
history.json Nahrát soubory do „website“ 2025-05-20 11:05:36 +00:00
package-lock.json Nahrát soubory do „website“ 2025-05-20 11:05:36 +00:00
package.json Nahrát soubory do „website“ 2025-05-20 11:05:36 +00:00
prepare-app-cloud.sh Nahrát soubory do „website“ 2025-05-20 11:05:36 +00:00
README.md Aktualizovat website/README.md 2025-05-20 11:11:02 +00:00
remove-app-cloud.sh Nahrát soubory do „website“ 2025-05-20 11:05:36 +00:00

README.md

Hate Speech Bot – Dokumentácia

Opis aplikácie

Ide o kompletný systém na detekciu nenávistných správ v prostredí Telegramu. Obsahuje Telegram bota, ktorý analyzuje správy, zaznamenáva porušenia do databázy MySQL, a webovú aplikáciu (Flask), ktorá tieto dáta zobrazuje v reálnom čase. Webová stránka sa automaticky aktualizuje každých 5 sekúnd a zobrazí najnovších porušovateľov.

Zoznam použitých kontajnerov

Kontajner Popis
tetianamohorian/hate-speech-bot Obsahuje Telegram bota a Flask webovú aplikáciu v jednom kontajneri.
mysql:8 Databázový server pre ukladanie porušení.

Zoznam Kubernetes objektov

Objekt Popis
Namespace: botspace Oddelený menný priestor pre všetky objekty aplikácie.
Deployment: bot-deployment Spúšťa Telegram bota.
Deployment: flask-web Spúšťa webovú aplikáciu.
StatefulSet: mysql Stabilné nasadenie MySQL databázy s uchovaním dát.
PersistentVolume Trvalý zväzok na fyzickom disku pre MySQL.
PersistentVolumeClaim Požiadavka na disk pre MySQL.
Service: mysql Interný prístup k databáze z iných podov.
Service: flask-service Sprístupňuje Flask web cez port-forward.
ConfigMap: init-sql Obsahuje SQL skript na inicializáciu databázy.
Secret: bot-secret Bezpečne uchováva Telegram API token.

Virtuálne siete a pomenované zväzky

  • Všetky pod-y komunikujú v internej sieti v rámci botspace.
  • PersistentVolume pripojený k MySQL cez PersistentVolumeClaim zabezpečuje trvalé uloženie údajov v /var/lib/mysql.

Konfigurácia kontajnerov

  • flask-web je nakonfigurovaný na porte 5000, ktorý je sprístupnený cez službu flask-service.
  • bot-deployment využíva Secret na získanie Telegram tokenu.
  • mysql inicializuje databázu automaticky pomocou initContainer a ConfigMap so SQL skriptom.

Návod na použitie

Príprava aplikácie:

./prepare-app.sh

Vytvorí Docker image a pushne ho na Docker Hub.

Spustenie aplikácie:

./start-app.sh

Vytvorí všetky Kubernetes objekty a spustí port-forward (napr. na localhost:8080).

Pozastavenie aplikácie (port-forward):

pkill -f "kubectl port-forward"

Odstránenie celej aplikácie:

./stop-app.sh

Zmaže celý namespace botspace a všetky objekty.

Prístup k webovej aplikácii

Po spustení aplikácie si otvor webový prehliadač a zadaj adresu:

http://localhost:8888

Zobrazí sa webová stránka s tabuľkou porušovateľov, ktorá sa aktualizuje každých 5 sekúnd.