opencode
6eb3dfd8f9
- Remove all prior release notes and version snapshots (v0.6.0-v0.8.6) - Rename handbook to *.de.md; keep *.en.md - New release notes v0.9.0.de.md/.en.md with v0.9.0 snapshot - generate-docs.mjs: .de/.en convention incl. search index and en-fallback - docs.tsx: release fallback now uses version.de.md - Wording: neutral tagline, anonymous user, no gender forms - Add docs/examples/import-tools.yaml and link from administration docs
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).