Files

T

opencode 3bb4598d04 feat(docs): version-based docs, correct Gitea tag links, form guide help

- each release now carries a full docs snapshot (reference + handbook)
  under docs/releases/<v>/; the docs frontend loads a version's snapshot
  for /docs/vX.Y.Z/* and shows the handbook/reference of that version
- version dropdown navigates to /docs/<version> (docs home) instead of
  the release notes page; old /docs/vX.Y.Z redirect removed
- generator: --snapshot writes handbook + reference; build copies
  versioned snapshots (last 7 versions) into /docs/versions/<v>/
- fix Gitea tag links: /admin/tool-evaluator/tags/<v> was 404, correct
  URL is /releases/tag/<v>
- add GuideHelp button to forms/pages linking to the matching handbook
  guide (rating, tool add/edit, costs, compare, watchlist, analytics)

2026-08-04 07:31:47 +02:00

2.6 KiB

Raw Blame History

Datenmodell

Dieses Kapitel erklärt die zentralen Datenobjekte von toolr auf Ebene der Anwendung. Die vollständige, automatisch generierte Referenz aller Felder, Typen und Constraints findest du in der API-Referenz.

Tool

Das Herzstück: ein im Katalog erfasstes Werkzeug.

Eigenschaft	Beschreibung
`id`	Eindeutige Kennung
`name`	Anzeigename
`description`	Beschreibung (Was macht das Tool?)
`category`	Kategorie-Zuordnung
`websiteUrl`	Offizielle Website (optional)
`iconUrl`	Logo-/Icon-URL (optional)
`features`	Liste von Fähigkeiten
`tags`	Liste von Schlagwörtern
`createdAt` / `updatedAt`	Zeitstempel
`createdBy`	Erstellende Person
`deletedAt` / `deletedBy`	Soft-Löschung (Papierkorb)

Eingabe-Formulare verwenden die abgeleiteten Schemas ToolInput und ToolUpdate. Aggregierte Ansichten liefert ToolWithStats (z. B. mit Durchschnittsbewertung).

Rating (Bewertung)

Eine einzelne Bewertung zu einem Tool:

usefulness (Nützlichkeit, 1–5) und usability (Bedienbarkeit, 1–5)
optional comment und ein Anzeigename (reviewerName)
Zeitstempel

Eingabe-Schema: RatingInput.

User & Auth

User — Benutzerkonto mit Rolle (User/Admin) und Tarif (Free/Premium/Enterprise).
AuthUser — das angemeldete Profil inklusive entitlements (verfügbare Features).
UserPreferences — Ansichts- und Dichte-Präferenzen sowie die watchlist (Liste von Tool-IDs).

Analytics

Die Statistik-Endpunkte liefern aggregierte Daten:

AnalyticsSummary — globale Kennzahlen (Anzahl Tools/Bewertungen, Kategorien, Durchschnitt).
TopToolEntry — ein Eintrag der Top-Tools.- CategoryStats — Tool-Anzahl je Kategorie.
RatingDistribution — Punkteverteilung (Nützlichkeit & Bedienbarkeit).
ScoreBucket — ein Werte-Bucket.

Weitere

VersionInfo — Version, Commit-SHA, Build-Datum und Papierkorb-Aufbewahrung der laufenden Instanz.
AuditLog — ein Protokolleintrag (Aktion, Entität, Zeitstempel, Akteur, Änderungen).

2.6 KiB Raw Blame History Unescape Escape