opencode
fdf2d741a1
- docs route renders without the app shell (own header, back-to-app link, theme toggle) - nav entry renamed to Hilfe (de) / Help (en) - reference links now case-insensitive (schema/tag slugs) - handbook rewritten as 17-page user guide with links into the API reference - release notes v0.8.1 added
2.6 KiB
2.6 KiB
title, order
| title | order |
|---|---|
| Datenmodell | 17 |
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).