---
title: Bewertungen
order: 4
---

# Bewertungen

Bewertungen sind das Herz von toolr: Sie zeigen, wie nützlich und wie gut
bedienbar ein Tool in den Augen der Community ist.

## Wie funktioniert die Bewertung?

Auf der Detailseite eines Tools vergibst du zwei Werte (1–5 Sterne):

- **Nützlichkeit** — Wie gut löst das Tool sein Kernproblem?
- **Bedienbarkeit** — Wie einfach ist es zu bedienen?

Optional kannst du einen **Kommentar** und deinen **Namen** hinterlassen. Die
Eingabefelder entsprechen dem Schema
[`RatingInput`](/docs/reference/schemas/ratinginput).

## Was passiert mit meiner Bewertung?

- Deine Bewertung wird sofort gespeichert und in den Durchschnittswerten des
  Tools berücksichtigt.
- Jede Bewertung ist über [`GET /tools/{id}/ratings`](/docs/reference/endpoints/ratings#listtoolratings)
  abrufbar.
- Der **Rating-Verlauf** über die Zeit ist über
  [`GET /tools/{id}/rating-history`](/docs/reference/endpoints/tools#gettoolratinghistory)
  einsehbar (grafisch auf der Detailseite).

## Datenfelder

Eine Bewertung besteht aus diesen Feldern
([`Rating`](/docs/reference/schemas/rating)):

| Feld | Typ | Bedeutung |
| --- | --- | --- |
| `id` | integer | Eindeutige ID der Bewertung. |
| `toolId` | integer | ID des bewerteten Tools. |
| `usefulness` | integer (1–5) | Nützlichkeitsbewertung. |
| `usability` | integer (1–5) | Bedienbarkeitsbewertung. |
| `comment` | string? | Optionaler Kommentar. |
| `reviewerName` | string? | Optionaler Anzeigename des Bewerters. |
| `createdAt` | date-time | Zeitpunkt der Bewertung. |