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.5 KiB
2.5 KiB
Data model
This chapter explains the central data objects of toolr at the application level. The complete, automatically generated reference of all fields, types and constraints can be found in the API reference.
Tool
The heart of it all: a tool recorded in the catalog.
| Property | Description |
|---|---|
id |
Unique identifier |
name |
Display name |
description |
Description (what does the tool do?) |
category |
Category assignment |
websiteUrl |
Official website (optional) |
iconUrl |
Logo/icon URL (optional) |
features |
List of capabilities |
tags |
List of keywords |
createdAt / updatedAt |
Timestamps |
createdBy |
Person who created it |
deletedAt / deletedBy |
Soft deletion (trash) |
Input forms use the derived schemas
ToolInput and
ToolUpdate.
Aggregated views are provided by ToolWithStats
(e.g. with average rating).
Rating (Bewertung)
A single rating for a tool:
usefulness(Nützlichkeit, 1–5) andusability(Bedienbarkeit, 1–5)- optional
commentand a display name (reviewerName) - timestamp
Input schema: RatingInput.
User & Auth
User— user account with role (User/Admin) and plan (Free/Premium/Enterprise).AuthUser— the logged-in profile includingentitlements(available features).UserPreferences— view and density preferences as well as thewatchlist(list of tool IDs).
Analytics
The statistics endpoints provide aggregated data:
AnalyticsSummary— global metrics (number of tools/ratings, categories, average).TopToolEntry— an entry of the top tools.-CategoryStats— number of tools per category.RatingDistribution— score distribution (usefulness & usability).ScoreBucket— a value bucket.
Additional
VersionInfo— version, commit SHA, build date and trash retention of the running instance.AuditLog— a log entry (action, entity, timestamp, actor, changes).