opencode
6c92b6358d
Full documentation hub replacing the release-notes-only view: - Handbook pages (docs/handbook) for all features and admin/betrieb - API reference generated from lib/api-spec/openapi.yaml via scripts/src/generate-docs.mjs (replaces sync-release-docs.mjs): endpoints, schemas/fields, search index, per-release snapshots - mkdocs layout: sidebar nav, right TOC with scrollspy, search overlay, version dropdown, repo link - FieldHelp (?) buttons in forms linking to reference field docs - v0.7.0 release notes backfilled, v0.8.0 release notes added
46 lines
1.5 KiB
Markdown
46 lines
1.5 KiB
Markdown
---
|
||
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. |
|