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
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).