Web-Engineering-Projekt
TreeLine

🚀 Was ist das hier?

Diese Repository enthält den Sourcecode für das Web-Engineering Projekt im 2. Semester des Studiengangs Informatik an der DHBW Karlsruhe.
Das Projekt enthält TreeLine, eine Webanwendung zur Erstellung und Darstellung eines Stammbaums, welche mit XML, XSLT und NodeJS + Express umgesetzt wurde.

• Infos zur Projektstruktur
• Feature-Liste

📘 Installation und Entwicklung

📦 Installation mit Docker (empfohlen)

Zum Starten der Anwendung wird Docker Desktop (mit dem vorinstallierten docker compose Plugin) benötigt.

💿 Vorgefertigtes Docker Image

Hier wird das über GitHub-Actions automatisch gebuildete Docker Image verwendet.

1. docker-compose.yaml Datei erstellen mit Inhalt von docker-compose.yml
2. Starten der Anwendung mit Terminal-Befehl docker-compose up bzw. docker-compose up -d, um die Anwendung im Hintergrund zu starten.
3. Anwendung ist unter http://localhost:8080 erreichbar, (optional, phpMyAdmin unter http://localhost:8090)

🛠️ Eigenes Docker Image

Hier wird das Docker Image lokal gebaut und gestartet.

1. Repository klonen git clone https://github.com/TINF23B6/TreeLine.git oder als ZIP herunterladen
2. cd TreeLine in das Verzeichnis wechseln
3. Mit docker compose --build und anschließend docker compose up das Docker Image erstellen und die Anwendung starten
4. Anwendung ist unter http://localhost:8080 erreichbar, (optional, phpMyAdmin unter http://localhost:8090)

⌨️ Weitere Befehle

Befehl	Beschreibung
docker-compose up	Erstellt und startet den Container-Stack (mit -d im Hintergrund)
docker-compose down	Stoppt die Anwendung und entfernt Container
docker-compose stop	Stoppt die Anwendung
docker-compose start	Startet die Anwendung
docker-compose restart	Startet die Anwendung neu

---

🗜️ Standalone Installation / Entwicklung

Zum Starten der Anwendung müssen Node.js (v22.1+) und npm installiert sein. Eine frische MySQL Datenbank wird ebenfalls benötigt.

1. Repository klonen git clone https://github.com/TINF23B6/TreeLine.git oder als ZIP herunterladen
2. Mit cd TreeLine in das Verzeichnis wechseln
3. .env Mit den entsprechenden Verbindungs-Daten für die MySQL Datenbank füllen.
4. npm install ausführen um die Abhängigkeiten zu installieren
5. npm start bzw. npm run dev (Mit autom. Neustart bei Dateiänderungen) ausführen
6. Anwendung ist unter http://localhost:8080 erreichbar

---

Note

Die Standard-Anmeldedaten für die Anwendung sind:
Benutzername: treeline
Passwort: treeline

---

🖼️ Screenshots