Hymmel/proj
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
proj/abgabe.md
Hymmel 94170330c7 gay
2026-01-22 12:19:53 +01:00

8.1 KiB
Raw Permalink Blame History

Abgabe-Dokumentation

Benutzerverwaltung

  • Registrierung von Nutzern möglich? Wo?

    • Ja, die Registrierung ist möglich.
    • Frontend: Frontend/components/auth/register-form.tsx (Das Formular).
    • Backend: Backend/src/main/java/de/itsolutions/ticketsystem/controller/AuthController.java (Endpoint /api/auth/register).

  • Pflichtfelder korrekt umgesetzt? (Name, Email, Passwort, Rolle) Wo?

    • Ja, die Pflichtfelder werden sowohl im Frontend als auch im Backend geprüft.
    • Frontend: Im RegisterForm sind die Input-Felder mit required markiert und eine TypeScript-Validierung verhindert das Absenden leerer Felder.
    • Backend: In Backend/src/main/java/de/itsolutions/ticketsystem/service/AuthService.java (Methode register) wird explizit geprüft, ob Vorname und Nachname vorhanden sind. Die Datenbank-Entität User.java setzt nullable = false für diese Felder.

  • Raumauswahl bei Registrierung für Raumbetreuer? Wo?

    • Ja, wenn die Rolle "Raumbetreuer" gewählt wird, erscheint eine Checkbox-Liste aller verfügbaren Räume.
    • Frontend: Frontend/components/auth/register-form.tsx (Zeilen 233-259, bedingtes Rendering: {role === "RAUMBETREUER" && ...}).

  • Anmelden mit Email und Passwort funktioniert? Wo?

    • Ja.
    • Frontend: Frontend/components/auth/login-form.tsx sendet die Daten an next-auth, welches den Backend-Endpoint aufruft.
    • Backend: Backend/src/main/java/de/itsolutions/ticketsystem/controller/AuthController.java (Endpoint /api/auth/login).

  • Persistente Anmeldung (keine Neuanmeldung bei jeder Nutzung)? Wie?

    • Ja, durch die Verwendung von NextAuth.js im Frontend und JWT (implizit via Session/Header Verwaltung in auth-context).
    • Frontend: Frontend/lib/auth-context.tsx nutzt den useSession Hook von NextAuth. Ein useEffect Hook (Zeilen 64-77) synchronisiert den Sitzungsstatus beim Laden der Seite automatisch, sodass der Nutzer eingeloggt bleibt. Zusätzlich prüft validateSession bei jeder Navigation die Gültigkeit beim Backend.

Ticketfunktionen Lehrer

  • Ticket kann erstellt werden? Wo?

    • Ja, über das "Ticket erstellen" Formular im Dashboard.
    • Frontend: Frontend/components/tickets/create-ticket-form.tsx.
    • Backend: Backend/src/main/java/de/itsolutions/ticketsystem/controller/TicketController.java (POST /api/tickets).

  • Pflichtangaben (Raum, Titel, Beschreibung)? Wo?

    • Ja.
    • Backend: Backend/src/main/java/de/itsolutions/ticketsystem/entity/Ticket.java definiert room, title, und owner mit @Column(nullable = false).
    • Service: Backend/src/main/java/de/itsolutions/ticketsystem/service/TicketService.java prüft, ob der Raum existiert.

  • Automatische Speicherung von Erstellungsdatum und Status "offen"? Wo?

    • Ja.
    • Backend: In Backend/src/main/java/de/itsolutions/ticketsystem/entity/Ticket.java:
      • createdAt wird initialisiert mit LocalDateTime.now() (Zeile 34).
      • status wird initialisiert mit "OPEN" (Zeile 37).

  • Eigene Tickets werden tabellarisch angezeigt? Wo?

    • Ja.
    • Frontend: Frontend/components/dashboard/teacher-dashboard.tsx nutzt die Komponente <TicketTable tickets={myTickets} />.

  • Sortierung nach Erstellungsdatum (absteigend)? Wo?

    • Ja.
    • Backend: Backend/src/main/java/de/itsolutions/ticketsystem/service/TicketService.java nutzt ticketRepository.findByOwnerIdOrderByCreatedAtDesc(user.getId()) (Zeile 75).

Ticketfunktionen Raumbetreuer

  • Anzeige aller Tickets der betreuten Räume? Wo?

    • Ja.
    • Frontend: Frontend/components/dashboard/supervisor-dashboard.tsx filtert und zeigt Tickets für die betreuten Räume an.
    • Backend: Backend/src/main/java/de/itsolutions/ticketsystem/service/TicketService.java ermittelt die roomIds des Betreuers und lädt passende Tickets (Zeilen 76-83).

  • Ticketinfos vollständig dargestellt? Wo?

    • Ja, die Tabelle (TicketTable) zeigt Titel, Raum, Status, Datum und Aktionen an. Details können (implizit durch die Struktur) eingesehen werden.

  • Sortierung nach Erstellungsdatum (absteigend)? Wo?

    • Ja.
    • Backend: TicketService.java nutzt ticketRepository.findByRoomIdInOrderByCreatedAtDesc(roomIds) (Zeile 83).

  • Änderung des Ticketstatus? Wo?

    • Ja, direkt in der Tabelle im Dashboard.
    • Frontend: Frontend/components/dashboard/supervisor-dashboard.tsx übergibt showStatusUpdate={true} an die TicketTable.
    • Backend: Backend/src/main/java/de/itsolutions/ticketsystem/controller/TicketController.java (PATCH /api/tickets/{id}/status).

  • Statuswechsel wird korrekt gespeichert? Wo?

    • Ja.
    • Backend: Backend/src/main/java/de/itsolutions/ticketsystem/service/TicketService.java Methode updateTicketStatus lädt das Ticket, setzt den neuen Status und speichert es mit ticketRepository.save(ticket).

Navigation & Bedienlogik

  • Rollenabhängiger Zugriff auf Funktionen? Wo und Wie?

    • Ja.
    • Frontend: In Frontend/lib/auth-context.tsx und den Dashboard-Komponenten (teacher-dashboard.tsx vs supervisor-dashboard.tsx) wird basierend auf user.role entschieden, welche Inhalte angezeigt werden. Das AppShell zeigt z.B. das "Admin"-Badge nur für Admins.
    • Backend: TicketService liefert je nach Rolle (LEHRKRAFT, RAUMBETREUER, ADMIN) unterschiedliche Ticket-Listen zurück.

  • Fehlermeldung bei falscher Eingabe? Wo und Wie?

    • Ja.
    • Frontend: Frontend/components/auth/register-form.tsx nutzt einen error State, um z.B. "Registrierung fehlgeschlagen" oder "Bitte akzeptieren Sie die Datenschutzerklärung" anzuzeigen. In anderen Teilen wird der useToast Hook verwendet, um Popups anzuzeigen.

Datenschutz & Sicherheit

  • Passwörter werden als Hash gespeichert? Wo und Wie?

    • Ja, mittels BCrypt.
    • Backend: Backend/src/main/java/de/itsolutions/ticketsystem/service/AuthService.java nutzt passwordEncoder.encode(request.getPassword()) vor dem Speichern (Zeile 56).
    • Konfiguration: Backend/src/main/java/de/itsolutions/ticketsystem/config/SecurityConfig.java definiert die BCryptPasswordEncoder Bean.

  • Checkbox zur Datenschutzeinwilligung mit Datenschutzrichtlinien? Wo und Wie?

    • Ja.
    • Frontend: Frontend/components/auth/register-form.tsx enthält eine Checkbox ("Ich akzeptiere die Datenschutzerklärung"), die angehakt sein muss, bevor der "Registrieren"-Button funktioniert (Zeilen 206-231).

Technische Qualität & Wartbarkeit

  • Saubere Backendstruktur? (Spring Boot, JPA)

    • Ja, das Projekt folgt einer klassischen Schichtenarchitektur:
      • Controller Layer (de.itsolutions.ticketsystem.controller): Handhabt HTTP-Requests (REST).
      • Service Layer (de.itsolutions.ticketsystem.service): Beinhaltet die Geschäftslogik (z.B. TicketService, AuthService).
      • Repository Layer (de.itsolutions.ticketsystem.repository): Interface für Datenbankzugriffe (Spring Data JPA).
      • Entity Layer (de.itsolutions.ticketsystem.entity): Bildet Datenbanktabellen als Java-Klassen ab (JPA/Hibernate).
      • DTOs (de.itsolutions.ticketsystem.dto): Kapselt Daten für den Datentransfer, um Entitäten nicht direkt zu exponieren.

  • REST-API konsistent und JSON basiert? Wo und Wie?

    • Ja.
    • Alle Controller sind mit @RestController annotiert.
    • Endpoints nutzen Standard-Methoden (GET, POST, PUT, DELETE).
    • Daten werden als JSON gesendet (@RequestBody) und empfangen (ResponseEntity<User>, ResponseEntity<Ticket>).
    • Beispiel: AuthController (Authentifizierung), TicketController (Ticket-Verwaltung).

  • Anwendung stabil und reproduzierbar lauffähig?

    • Ja, da die Anwendung vollständig containerisiert ist via Docker.
    • docker-compose.yml definiert die Services (Frontend, Backend, Datenbank), was eine konsistente Umgebung unabhängig vom Host-System garantiert.