e164d51574
- Raise compare limit from 8 to 9 (server + client, toast on overflow) - Make import textarea placeholder match selected format (CSV/JSON/YAML/auto) - Add GuideHelp links to admin create/edit user dialogs and tool import dialog
2.6 KiB
2.6 KiB
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) undusability(Bedienbarkeit, 1–5)- optional
commentund ein Anzeigename (reviewerName) - Zeitstempel
Eingabe-Schema: RatingInput.
User & Auth
User— Benutzerkonto mit Rolle (User/Admin) und Tarif (Free/Premium/Enterprise).AuthUser— das angemeldete Profil inklusiveentitlements(verfügbare Features).UserPreferences— Ansichts- und Dichte-Präferenzen sowie diewatchlist(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).