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