docs: add v0.8.4 release notes

- translate remaining pages/components (admin, analytics, redundancy,
  trash, compare, browse, watchlist, admin tools tab, category combobox,
  theme toggle, tool preview card, tool-new/edit) to t() calls
- locales: 453 keys each, parity verified
- docs: bilingual handbook + release notes via *.en.md variants,
  language-aware docs.tsx (markdown paths, nav titles, search index),
  LanguageSwitcher in docs header
- generate-docs: emit per-locale handbook/release/search output,
  localized index.json fields (fileEn/titleEn), en-aware snapshots

artifacts/toolrate/src/components/admin-tools-tab.tsx

@@ -1,4 +1,5 @@
 import { useEffect, useState } from "react";
+import { useTranslation } from "react-i18next";
 import { Link } from "wouter";
 import {
   useListTools,
@@ -10,7 +11,6 @@ import {
   getListAllTagsQueryKey,
   getGetTopToolsQueryKey,
   getGetAnalyticsSummaryQueryKey,
-  type ToolWithStats,
 } from "@workspace/api-client-react";
 import { useQueryClient } from "@tanstack/react-query";
 import { useAuth } from "@/hooks/use-auth";
@@ -27,6 +27,7 @@ import { Search, Trash2, ExternalLink, Pencil, Star } from "lucide-react";
 import { format } from "date-fns";
 
 export function AdminToolsTab() {
+  const { t } = useTranslation();
   const { isAdmin, isLoading: authLoading } = useAuth();
   const { toast } = useToast();
   const queryClient = useQueryClient();
@@ -82,20 +83,20 @@ export function AdminToolsTab() {
       { data: { ids } },
       {
         onSuccess: (res) => {
-          toast({ title: "Tools moved to trash", description: `${res.trashed ?? ids.length} tool(s) moved to trash.` });
+          toast({ title: t("adminTools.toastMoved"), description: t("adminTools.toastMovedSub", { count: res.trashed ?? ids.length }) });
           setSelected(new Set());
           setConfirmTrash(false);
           invalidate();
         },
         onError: (err) => {
-          toast({ title: "Failed to move to trash", description: err.data?.error ?? err.message, variant: "destructive" });
+          toast({ title: t("adminTools.toastMoveFailed"), description: err.data?.error ?? err.message, variant: "destructive" });
         },
       },
     );
   }
 
   if (!authLoading && !isAdmin) {
-    return <p className="text-sm text-muted-foreground py-8 text-center">Admin access required.</p>;
+    return <p className="text-sm text-muted-foreground py-8 text-center">{t("adminTools.accessRequired")}</p>;
   }
 
   const selectedIds = [...selected];
@@ -104,9 +105,9 @@ export function AdminToolsTab() {
     <Card>
       <CardHeader className="flex flex-row items-center justify-between gap-4 flex-wrap">
         <div className="space-y-1.5">
-          <CardTitle>All Tools</CardTitle>
+          <CardTitle>{t("adminTools.allTools")}</CardTitle>
           <CardDescription>
-            {selectedIds.length > 0 ? `${selectedIds.length} selected` : `${allTools.length} tool(s)`}
+            {selectedIds.length > 0 ? t("adminTools.selected", { count: selectedIds.length }) : t("adminTools.toolCount", { count: allTools.length })}
           </CardDescription>
         </div>
         <div className="flex items-center gap-2 flex-wrap">
@@ -114,7 +115,7 @@ export function AdminToolsTab() {
             <Search className="w-4 h-4 absolute left-2.5 top-1/2 -translate-y-1/2 text-muted-foreground" />
             <Input
               className="pl-8 w-56"
-              placeholder="Search tools…"
+              placeholder={t("adminTools.searchPlaceholder")}
               value={searchInput}
               onChange={(e) => setSearchInput(e.target.value)}
             />
@@ -125,7 +126,7 @@ export function AdminToolsTab() {
             disabled={selectedIds.length === 0 || trash.isPending}
             onClick={() => setConfirmTrash(true)}
           >
-            <Trash2 className="w-4 h-4 mr-2" /> Move to trash ({selectedIds.length})
+            <Trash2 className="w-4 h-4 mr-2" /> {t("adminTools.moveToTrash", { count: selectedIds.length })}
           </Button>
         </div>
       </CardHeader>
@@ -135,7 +136,7 @@ export function AdminToolsTab() {
             {[1, 2, 3].map((i) => <Skeleton key={i} className="h-12 w-full" />)}
           </div>
         ) : allTools.length === 0 ? (
-          <p className="text-sm text-muted-foreground py-8 text-center">{search ? "No tools match your search." : "No tools yet."}</p>
+          <p className="text-sm text-muted-foreground py-8 text-center">{search ? t("adminTools.noMatch") : t("adminTools.noToolsYet")}</p>
         ) : (
           <Table>
             <TableHeader>
@@ -144,58 +145,58 @@ export function AdminToolsTab() {
                   <Checkbox
                     checked={selected.size === allTools.length && allTools.length > 0}
                     onCheckedChange={toggleAll}
-                    aria-label="Select all"
+                    aria-label={t("adminTools.selectAll")}
                   />
                 </TableHead>
-                <TableHead>Name</TableHead>
-                <TableHead>Category</TableHead>
-                <TableHead>Rating</TableHead>
-                <TableHead>Created by</TableHead>
-                <TableHead>Created at</TableHead>
-                <TableHead className="text-right">Actions</TableHead>
+                <TableHead>{t("adminTools.name")}</TableHead>
+                <TableHead>{t("adminTools.category")}</TableHead>
+                <TableHead>{t("adminTools.rating")}</TableHead>
+                <TableHead>{t("adminTools.createdBy")}</TableHead>
+                <TableHead>{t("adminTools.createdAt")}</TableHead>
+                <TableHead className="text-right">{t("adminTools.actions")}</TableHead>
               </TableRow>
             </TableHeader>
             <TableBody>
-              {allTools.map((t: ToolWithStats) => (
-                <TableRow key={t.id} className={selected.has(t.id) ? "bg-muted/40" : undefined}>
+              {allTools.map((tool) => (
+                <TableRow key={tool.id} className={selected.has(tool.id) ? "bg-muted/40" : undefined}>
                   <TableCell>
                     <Checkbox
-                      checked={selected.has(t.id)}
-                      onCheckedChange={() => toggle(t.id)}
-                      aria-label={`Select ${t.name}`}
+                      checked={selected.has(tool.id)}
+                      onCheckedChange={() => toggle(tool.id)}
+                      aria-label={t("adminTools.selectName", { name: tool.name })}
                     />
                   </TableCell>
-                  <TableCell className="font-medium">{t.name}</TableCell>
+                  <TableCell className="font-medium">{tool.name}</TableCell>
                   <TableCell>
-                    <Badge variant="outline">{t.category}</Badge>
+                    <Badge variant="outline">{tool.category}</Badge>
                   </TableCell>
                   <TableCell className="text-sm text-muted-foreground">
-                    {t.ratingCount > 0 ? (
+                    {tool.ratingCount > 0 ? (
                       <span className="inline-flex items-center gap-1">
                         <Star className="w-3 h-3 fill-amber-500 text-amber-500" />
-                        {t.avgCombined != null ? t.avgCombined.toFixed(1) : "—"} ({t.ratingCount})
+                        {tool.avgCombined != null ? tool.avgCombined.toFixed(1) : "—"} ({tool.ratingCount})
                       </span>
                     ) : (
                       "—"
                     )}
                   </TableCell>
-                  <TableCell className="text-sm text-muted-foreground">{t.createdBy ?? "—"}</TableCell>
+                  <TableCell className="text-sm text-muted-foreground">{tool.createdBy ?? "—"}</TableCell>
                   <TableCell className="text-sm text-muted-foreground">
-                    {format(new Date(t.createdAt), "dd.MM.yyyy")}
+                    {format(new Date(tool.createdAt), "dd.MM.yyyy")}
                   </TableCell>
                   <TableCell className="text-right">
                     <div className="flex justify-end gap-1">
                       <Button variant="ghost" size="icon" className="h-8 w-8" asChild>
-                        <Link href={`/tools/${t.id}`}><ExternalLink className="w-3.5 h-3.5" /></Link>
+                        <Link href={`/tools/${tool.id}`}><ExternalLink className="w-3.5 h-3.5" /></Link>
                       </Button>
                       <Button variant="ghost" size="icon" className="h-8 w-8" asChild>
-                        <Link href={`/tools/${t.id}/edit`}><Pencil className="w-3.5 h-3.5" /></Link>
+                        <Link href={`/tools/${tool.id}/edit`}><Pencil className="w-3.5 h-3.5" /></Link>
                       </Button>
                       <Button
                         variant="ghost"
                         size="icon"
                         className="h-8 w-8 text-muted-foreground hover:text-destructive"
-                        onClick={() => handleTrash([t.id])}
+                        onClick={() => handleTrash([tool.id])}
                         disabled={trash.isPending}
                       >
                         <Trash2 className="w-3.5 h-3.5" />
@@ -212,18 +213,18 @@ export function AdminToolsTab() {
       <AlertDialog open={confirmTrash} onOpenChange={setConfirmTrash}>
         <AlertDialogContent>
           <AlertDialogHeader>
-            <AlertDialogTitle>Move {selectedIds.length} tool(s) to trash?</AlertDialogTitle>
+            <AlertDialogTitle>{t("adminTools.confirmTitle", { count: selectedIds.length })}</AlertDialogTitle>
             <AlertDialogDescription>
-              The selected tools will be hidden from all public views and moved to the trash, where they can be restored or permanently deleted.
+              {t("adminTools.confirmSub")}
             </AlertDialogDescription>
           </AlertDialogHeader>
           <AlertDialogFooter>
-            <AlertDialogCancel>Cancel</AlertDialogCancel>
+            <AlertDialogCancel>{t("common.cancel")}</AlertDialogCancel>
             <AlertDialogAction
               className="bg-destructive text-destructive-foreground hover:bg-destructive/90"
               onClick={() => handleTrash(selectedIds)}
             >
-              Move to trash
+              {t("adminTools.moveToTrashAction")}
             </AlertDialogAction>
           </AlertDialogFooter>
         </AlertDialogContent>

artifacts/toolrate/src/components/breadcrumbs.tsx

@@ -37,31 +37,6 @@ function buildCrumbs(location: string, t: TFunction): Crumb[] {
     crumbs.push({ label: t("compare.title") });
   } else if (location.startsWith("/analytics")) {
     crumbs.push({ label: t("nav.analytics") });
-  } else if (location.startsWith("/docs")) {
-    crumbs.push({ href: "/docs", label: t("docs.title") });
-    const m = location.replace(/^\/docs\/?/, "");
-    if (m.startsWith("handbook/")) {
-      crumbs.push({ href: "/docs/handbook", label: t("docs.guides") });
-      const slug = m.replace(/^handbook\//, "").split("#")[0];
-      if (slug) crumbs.push({ label: slug });
-    } else if (m.startsWith("reference/")) {
-      crumbs.push({ href: "/docs/reference/endpoints", label: t("docs.reference") });
-      const rest = m.replace(/^reference\//, "").split("#")[0];
-      if (rest.startsWith("schemas/")) {
-        crumbs.push({ label: t("docs.schemas") });
-        const name = rest.replace(/^schemas\//, "");
-        if (name) crumbs.push({ label: name });
-      } else {
-        const tag = rest.replace(/^endpoints\//, "");
-        if (tag) crumbs.push({ label: tag });
-      }
-    } else if (m.startsWith("releases/")) {
-      crumbs.push({ href: "/docs/releases", label: t("docs.releases") });
-      const version = m.replace(/^releases\//, "").split("#")[0];
-      if (version) crumbs.push({ label: version });
-    } else if (m) {
-      crumbs.push({ label: m });
-    }
   } else if (location.startsWith("/login")) {
     crumbs.push({ label: t("auth.signIn") });
   }

artifacts/toolrate/src/components/category-combobox.tsx

@@ -1,4 +1,5 @@
 import { useState, useEffect } from "react";
+import { useTranslation } from "react-i18next";
 import { Check, ChevronsUpDown } from "lucide-react";
 import { cn } from "@/lib/utils";
 import { Button } from "@/components/ui/button";
@@ -23,7 +24,8 @@ interface CategoryComboboxProps {
   placeholder?: string;
 }
 
-export function CategoryCombobox({ value, onChange, placeholder = "Select or type a category..." }: CategoryComboboxProps) {
+export function CategoryCombobox({ value, onChange, placeholder }: CategoryComboboxProps) {
+  const { t } = useTranslation();
   const [open, setOpen] = useState(false);
   const [inputValue, setInputValue] = useState(value);
 
@@ -49,6 +51,8 @@ export function CategoryCombobox({ value, onChange, placeholder = "Select or typ
     (c) => c.toLowerCase() === inputValue.toLowerCase()
   );
 
+  const resolvedPlaceholder = placeholder ?? t("category.placeholder");
+
   function select(val: string) {
     onChange(val);
     setInputValue(val);
@@ -66,7 +70,7 @@ export function CategoryCombobox({ value, onChange, placeholder = "Select or typ
           data-testid="button-category-combobox"
         >
           <span className={cn(!value && "text-muted-foreground")}>
-            {value || placeholder}
+            {value || resolvedPlaceholder}
           </span>
           <ChevronsUpDown className="ml-2 h-4 w-4 shrink-0 opacity-50" />
         </Button>
@@ -74,7 +78,7 @@ export function CategoryCombobox({ value, onChange, placeholder = "Select or typ
       <PopoverContent className="w-full p-0" align="start">
         <Command shouldFilter={false}>
           <CommandInput
-            placeholder="Search or enter new category..."
+            placeholder={t("category.searchPlaceholder")}
             value={inputValue}
             onValueChange={(v) => {
               setInputValue(v);
@@ -84,10 +88,10 @@ export function CategoryCombobox({ value, onChange, placeholder = "Select or typ
           />
           <CommandList>
             {filtered.length === 0 && !showCreateOption && (
-              <CommandEmpty>No categories found.</CommandEmpty>
+              <CommandEmpty>{t("category.noCategories")}</CommandEmpty>
             )}
             {filtered.length > 0 && (
-              <CommandGroup heading="Known categories">
+              <CommandGroup heading={t("category.knownCategories")}>
                 {filtered.map((cat) => (
                   <CommandItem
                     key={cat}
@@ -104,13 +108,13 @@ export function CategoryCombobox({ value, onChange, placeholder = "Select or typ
               </CommandGroup>
             )}
             {showCreateOption && (
-              <CommandGroup heading="Create new">
+              <CommandGroup heading={t("category.createNew")}>
                 <CommandItem
                   value={inputValue}
                   onSelect={() => select(inputValue.trim())}
                   data-testid="item-category-create-new"
                 >
-                  <span className="text-primary font-medium">+ Create</span>
+                  <span className="text-primary font-medium">{t("category.create")}</span>
                   <span className="ml-2 text-muted-foreground">&ldquo;{inputValue.trim()}&rdquo;</span>
                 </CommandItem>
               </CommandGroup>

artifacts/toolrate/src/components/guide-help.tsx

@@ -0,0 +1,29 @@
+import { BookOpen } from "lucide-react";
+import { Link } from "wouter";
+import { Tooltip, TooltipContent, TooltipTrigger } from "@/components/ui/tooltip";
+
+export function GuideHelp({
+  guide,
+  label,
+}: {
+  guide: string;
+  label: string;
+}) {
+  return (
+    <Tooltip>
+      <TooltipTrigger asChild>
+        <Link
+          href={`/docs/handbook/${guide}`}
+          target="_blank"
+          rel="noreferrer"
+          aria-label={`Help: ${label}`}
+          data-testid={`guide-${guide}`}
+          className="inline-flex shrink-0 text-muted-foreground hover:text-foreground transition-colors"
+        >
+          <BookOpen className="h-3.5 w-3.5" />
+        </Link>
+      </TooltipTrigger>
+      <TooltipContent>{label} — Anleitung in der Dokumentation</TooltipContent>
+    </Tooltip>
+  );
+}

artifacts/toolrate/src/components/theme-toggle.tsx

@@ -1,4 +1,5 @@
 import { ChevronDown, Lightbulb, LightbulbOff, Monitor, Moon, Sun } from "lucide-react";
+import { useTranslation } from "react-i18next";
 import { Button } from "@/components/ui/button";
 import {
   DropdownMenu,
@@ -11,6 +12,7 @@ import {
 import { useTheme, type Theme } from "@/hooks/use-theme";
 
 export function ThemeToggle() {
+  const { t } = useTranslation();
   const { theme, setTheme, resolvedTheme } = useTheme();
   const isDark = resolvedTheme === "dark";
 
@@ -25,8 +27,8 @@ export function ThemeToggle() {
         size="icon"
         className="h-9 w-9"
         onClick={quickToggle}
-        title={isDark ? "Switch to light theme" : "Switch to dark theme"}
-        aria-label={isDark ? "Switch to light theme" : "Switch to dark theme"}
+        title={isDark ? t("theme.switchLight") : t("theme.switchDark")}
+        aria-label={isDark ? t("theme.switchLight") : t("theme.switchDark")}
         data-testid="button-theme-quick-toggle"
       >
         {isDark ? <Lightbulb className="w-4 h-4" /> : <LightbulbOff className="w-4 h-4" />}
@@ -37,27 +39,27 @@ export function ThemeToggle() {
             variant="ghost"
             size="icon"
             className="h-9 w-9"
-            aria-label="Choose theme"
-            title="Choose theme"
+            aria-label={t("theme.chooseTitle")}
+            title={t("theme.chooseTitle")}
             data-testid="button-theme-menu"
           >
             <ChevronDown className="w-4 h-4" />
           </Button>
         </DropdownMenuTrigger>
         <DropdownMenuContent align="end" sideOffset={6}>
-          <DropdownMenuLabel>Theme</DropdownMenuLabel>
+          <DropdownMenuLabel>{t("theme.title")}</DropdownMenuLabel>
           <DropdownMenuRadioGroup value={theme} onValueChange={(v) => setTheme(v as Theme)}>
             <DropdownMenuRadioItem value="light">
               <Sun className="w-4 h-4 mr-2" />
-              Light
+              {t("theme.light")}
             </DropdownMenuRadioItem>
             <DropdownMenuRadioItem value="dark">
               <Moon className="w-4 h-4 mr-2" />
-              Dark
+              {t("theme.dark")}
             </DropdownMenuRadioItem>
             <DropdownMenuRadioItem value="system">
               <Monitor className="w-4 h-4 mr-2" />
-              System
+              {t("theme.system")}
             </DropdownMenuRadioItem>
           </DropdownMenuRadioGroup>
         </DropdownMenuContent>

artifacts/toolrate/src/components/tool-preview-card.tsx

@@ -1,4 +1,5 @@
 import { Link } from "wouter";
+import { useTranslation } from "react-i18next";
 import type { ToolWithStats } from "@workspace/api-client-react";
 
 import { Badge } from "@/components/ui/badge";
@@ -6,6 +7,7 @@ import { RatingStars } from "@/components/rating-stars";
 import { MiniBars } from "@/components/mini-bars";
 
 export function ToolPreviewCard({ tool }: { tool: ToolWithStats }) {
+  const { t } = useTranslation();
   return (
     <div className="space-y-3">
       <div>
@@ -22,7 +24,7 @@ export function ToolPreviewCard({ tool }: { tool: ToolWithStats }) {
 
       <div className="space-y-1.5">
         <div className="flex items-center justify-between text-xs">
-          <span className="text-muted-foreground">{tool.ratingCount} review{tool.ratingCount === 1 ? "" : "s"}</span>
+          <span className="text-muted-foreground">{t("browse.reviewCount", { count: tool.ratingCount })}</span>
           <span className="font-semibold tabular-nums">
             {tool.avgCombined != null ? tool.avgCombined.toFixed(1) : "–"}/5
           </span>
@@ -47,8 +49,7 @@ export function ToolPreviewCard({ tool }: { tool: ToolWithStats }) {
         href={`/tools/${tool.id}`}
         className="block w-full rounded-md border border-primary/40 bg-primary/5 px-3 py-1.5 text-center text-xs font-medium text-primary hover:bg-primary/10"
       >
-        View details
-      </Link>
-    </div>
+        {t("common.viewDetails")}
+      </Link>    </div>
   );
 }

artifacts/toolrate/src/i18n/locales/de.json

@@ -12,7 +12,7 @@
     "trash": "Papierkorb",
     "admin": "Admin",
     "redundancy": "Redundanz",
-    "docs": "Doku",
+    "docs": "Hilfe",
     "search": "Tools suchen…"
   },
   "auth": {
@@ -53,7 +53,9 @@
     "loading": "Wird geladen…",
     "all": "Alle",
     "none": "Keine",
-    "language": "Sprache"
+    "language": "Sprache",
+    "viewDetails": "Details ansehen",
+    "guideTooltip": "Anleitung in der Dokumentation"
   },
   "home": {
     "welcome": "Willkommen bei toolr",
@@ -80,6 +82,8 @@
     "category": "Kategorie",
     "rating": "Bewertung",
     "reviews": "Bewertungen",
+    "reviewCount_one": "{{count}} Bewertung",
+    "reviewCount_other": "{{count}} Bewertungen",
     "noToolsFound": "Keine Tools gefunden",
     "noToolsMatch": "Wir konnten keine Tools finden, die zu deinen Filtern passen. Versuche, die Suchkriterien anzupassen, oder füge ein neues Tool hinzu.",
     "addTool": "Tool hinzufügen",
@@ -103,7 +107,9 @@
     "features": "Funktionen",
     "minRating": "Mindestbewertung",
     "any": "Beliebig",
-    "clearFilters": "Filter zurücksetzen"
+    "clearFilters": "Filter zurücksetzen",
+    "removeFeature": "Funktion entfernen: {{feature}}",
+    "removeMinRating": "Mindestbewertung entfernen"
   },
   "detail": {
     "ratingBreakdown": "Bewertungsaufschlüsselung",
@@ -133,7 +139,65 @@
     "deleteToTrash": "Dies verschiebt {{name}} in den Papierkorb. Es kann später wiederhergestellt werden.",
     "deletePermanent": "Dies entfernt {{name}} dauerhaft inklusive aller Bewertungen. Das kann nicht rückgängig gemacht werden.",
     "deleting": "Löschen…",
-    "deleteAction": "Löschen"
+    "deleteAction": "Löschen",
+    "invalidToolId": "Ungültige Tool-ID",
+    "backToBrowse": "Zurück zur Übersicht",
+    "keyFeatures": "Wichtige Funktionen",
+    "toolNotFound": "Tool nicht gefunden.",
+    "similarTools": "Ähnliche Tools",
+    "noSimilarTools": "Keine ähnlichen Tools gefunden.",
+    "linkTool": "Tool verknüpfen",
+    "linkSimilarTool": "Ähnliches Tool verknüpfen",
+    "linkSimilarToolSub": "Verknüpfe dieses Tool manuell mit einem anderen Tool.",
+    "toolId": "Tool-ID",
+    "toolIdPlaceholder": "Ziel-Tool-ID eingeben",
+    "relationType": "Beziehungstyp",
+    "relationSimilar": "Ähnlich",
+    "relationReplaces": "Ersetzt",
+    "relationSupersededBy": "Ersetzt durch",
+    "notesOptional": "Notizen (optional)",
+    "notesPlaceholder": "Warum sind diese Tools verwandt?",
+    "createLink": "Verknüpfung erstellen",
+    "noCostInfo": "Noch keine Kosteninformationen hinzugefügt.",
+    "costDialogSub": "Verwalte die Lizenzkosteninformationen für dieses Tool.",
+    "licenseType": "Lizenztyp",
+    "licenseFree": "Kostenlos",
+    "licenseSubscription": "Abonnement",
+    "licenseOneTime": "Einmalig",
+    "licenseUsageBased": "Nutzungsbasiert",
+    "billingPeriod": "Abrechnungszeitraum",
+    "billingMonthly": "Monatlich",
+    "billingQuarterly": "Quartalsweise",
+    "billingYearly": "Jährlich",
+    "costLabel": "Kosten",
+    "currency": "Währung",
+    "costNotes": "Notizen",
+    "costNotesPlaceholder": "Abrechnungsdetails, Vertragsinformationen…",
+    "commentOptional": "Kommentar (optional)",
+    "commentLabel": "Kommentar",
+    "commentPlaceholder": "Was denkst du über dieses Tool?",
+    "nameOptional": "Name (optional)",
+    "nameLabel": "Name",
+    "anonymousPlaceholder": "Anonym",
+    "anonymousEngineer": "Anonymer Ingenieur",
+    "beFirstToReview": "Sei der Erste, der seine Gedanken zu diesem Tool teilt.",
+    "shareExperience": "Teile deine Erfahrung mit {{name}}",
+    "score": "Punktestand",
+    "toastRelationCreated": "Beziehung erstellt",
+    "toastRelationFailed": "Beziehung konnte nicht erstellt werden",
+    "toastRelationDeleted": "Beziehung gelöscht",
+    "toastRelationDeleteFailed": "Beziehung konnte nicht gelöscht werden",
+    "toastCostUpdated": "Kosten aktualisiert",
+    "toastCostAdded": "Kosten hinzugefügt",
+    "toastCostFailed": "Kosten konnten nicht gespeichert werden",
+    "toastCostDeleted": "Kosten gelöscht",
+    "toastCostDeleteFailed": "Kosten konnten nicht gelöscht werden",
+    "toastRatingSubmitted": "Bewertung abgesendet",
+    "toastRatingThanks": "Danke für dein Feedback!",
+    "toastRatingFailed": "Bewertung konnte nicht abgesendet werden",
+    "toastToolDeleted": "Tool gelöscht",
+    "toastDeleteFailed": "Löschen fehlgeschlagen",
+    "unexpectedError": "Ein unerwarteter Fehler ist aufgetreten."
   },
   "compare": {
     "title": "Tools vergleichen",
@@ -176,7 +240,29 @@
     "deletePermanently": "Endgültig löschen",
     "emptyTrash": "Papierkorb leeren",
     "deletedAt": "Gelöscht am",
-    "deletedBy": "Gelöscht von"
+    "deletedBy": "Gelöscht von",
+    "name": "Name",
+    "category": "Kategorie",
+    "actions": "Aktionen",
+    "selectAll": "Alle auswählen",
+    "selectName": "{{name}} auswählen",
+    "restoreAction": "Wiederherstellen",
+    "deleteAction": "Löschen",
+    "deleteConfirmTitle": "{{count}} Tool(s) endgültig löschen?",
+    "deleteConfirmSub": "Dies entfernt die ausgewählten Tools dauerhaft inklusive aller Bewertungen, Kosten und Beziehungen. Das kann nicht rückgängig gemacht werden.",
+    "emptyConfirmTitle": "Papierkorb leeren?",
+    "emptyConfirmSub": "Dies entfernt alle {{count}} Tool(s) im Papierkorb dauerhaft inklusive ihrer Bewertungen, Kosten und Beziehungen. Das kann nicht rückgängig gemacht werden.",
+    "toastRestored": "Tools wiederhergestellt",
+    "toastRestoredSub": "{{count}} Tool(s) wiederhergestellt.",
+    "toastRestoreFailed": "Wiederherstellen fehlgeschlagen",
+    "toastDeleted": "Tools gelöscht",
+    "toastDeletedSub": "{{count}} Tool(s) endgültig entfernt.",
+    "toastDeleteFailed": "Löschen fehlgeschlagen",
+    "toastEmptied": "Papierkorb geleert",
+    "toastEmptiedSub": "{{count}} Tool(s) endgültig entfernt.",
+    "toastEmptyFailed": "Papierkorb konnte nicht geleert werden",
+    "searchPlaceholder": "Tools suchen…",
+    "toolCount": "{{count}} Tool(s)"
   },
   "notFound": {
     "text": "Diese Seite existiert nicht.",
@@ -198,7 +284,21 @@
     "reference": "API-Referenz",
     "referenceIntro": "Automatisch aus der OpenAPI-Spezifikation generiert — alle Endpunkte und Datenfelder der aktuellen Version.",
     "onThisPage": "Auf dieser Seite",
-    "searchPlaceholder": "Doku durchsuchen…"
+    "searchPlaceholder": "Doku durchsuchen…",
+    "backToApp": "Zur App",
+    "field": "Feld",
+    "type": "Typ",
+    "required": "Pflicht",
+    "description": "Beschreibung",
+    "status": "Status",
+    "schema": "Schema",
+    "parameter": "Parameter",
+    "noResults": "Keine Treffer",
+    "fields": "Felder",
+    "fieldHelpHint": "Hinweis: Formular-Felder verlinken per ?-Icon direkt zu den jeweiligen Zeilen dieser Tabelle.",
+    "name": "Name",
+    "in": "In",
+    "requestBody": "Request-Body"
   },
   "command": {
     "navigate": "Navigation",
@@ -206,5 +306,192 @@
     "tools": "Tools",
     "noResults": "Keine Tools für „{{query}}“ gefunden.",
     "startTyping": "Beginne zu tippen, um Tools zu suchen."
+  },
+  "admin": {
+    "accessRequired": "Admin-Zugriff erforderlich",
+    "accessRequiredSub": "Du benötigst Admin-Rechte, um diese Seite anzusehen.",
+    "goHome": "Zur Startseite",
+    "panel": "Admin-Bereich",
+    "panelSub": "Benutzer verwalten und Systemänderungen einsehen.",
+    "redundancyDashboard": "Redundanz-Dashboard",
+    "tabUsers": "Benutzer",
+    "tabTools": "Tools",
+    "tabAudit": "Audit-Log",
+    "tabSystem": "System",
+    "localUsers": "Lokale Benutzer",
+    "localUsersSub": "Konten für die lokale Authentifizierung verwalten.",
+    "addUser": "Benutzer hinzufügen",
+    "noUsersYet": "Noch keine Benutzer.",
+    "auditLog": "Audit-Log",
+    "auditLogSub": "Alle vom System protokollierten Erstellungs-, Aktualisierungs- und Löschvorgänge.",
+    "by": "von",
+    "noAuditEntries": "Noch keine Audit-Einträge.",
+    "system": "System",
+    "systemSub": "Build-Informationen der aktuell laufenden Bereitstellung.",
+    "version": "Version",
+    "commit": "Commit",
+    "buildDate": "Build-Datum",
+    "trashRetention": "Papierkorb-Aufbewahrung",
+    "days": "Tage",
+    "keepForever": "Für immer behalten",
+    "createNewUser": "Neuen Benutzer erstellen",
+    "username": "Benutzername",
+    "password": "Passwort",
+    "emailOptional": "E-Mail (optional)",
+    "role": "Rolle",
+    "roleUser": "Benutzer",
+    "roleAdmin": "Admin",
+    "plan": "Plan",
+    "planFree": "Kostenlos",
+    "planPremium": "Premium",
+    "planEnterprise": "Enterprise",
+    "creating": "Erstelle…",
+    "createUser": "Benutzer erstellen",
+    "editUser": "Benutzer bearbeiten — {{username}}",
+    "setPassword": "Passwort festlegen",
+    "resetsPassword": "Setzt das Passwort des Benutzers sofort zurück.",
+    "idpManaged": "Das Passwort wird vom Identity-Provider (Keycloak) verwaltet. Setze es dort zurück.",
+    "setting": "Setze…",
+    "deleteUser": "Benutzer löschen",
+    "deleteUserConfirm": "Bist du sicher, dass du {{username}} löschen möchtest? Das kann nicht rückgängig gemacht werden.",
+    "minPasswordPlaceholder": "min. 6 Zeichen",
+    "usernamePlaceholder": "benutzername",
+    "emailPlaceholder": "user@example.com",
+    "toastUserCreated": "Benutzer erstellt",
+    "toastUserCreatedSub": "{{username}} wurde erstellt.",
+    "toastUserCreateFailed": "Benutzer konnte nicht erstellt werden",
+    "toastUserUpdated": "Benutzer aktualisiert",
+    "toastUserUpdateFailed": "Benutzer konnte nicht aktualisiert werden",
+    "toastPwTooShort": "Passwort zu kurz",
+    "toastPwTooShortSub": "Mindestens 6 Zeichen.",
+    "toastPwUpdated": "Passwort aktualisiert",
+    "toastPwUpdatedSub": "Passwort für {{username}} wurde festgelegt.",
+    "toastPwSetFailed": "Passwort konnte nicht festgelegt werden",
+    "toastUserDeleted": "Benutzer gelöscht",
+    "toastUserDeletedSub": "{{username}} wurde entfernt.",
+    "toastUserDeleteFailed": "Benutzer konnte nicht gelöscht werden"
+  },
+  "adminTools": {
+    "accessRequired": "Admin-Zugriff erforderlich.",
+    "allTools": "Alle Tools",
+    "toolCount": "{{count}} Tool(s)",
+    "selected": "{{count}} ausgewählt",
+    "searchPlaceholder": "Tools suchen…",
+    "moveToTrash": "In den Papierkorb verschieben ({{count}})",
+    "noMatch": "Keine Tools entsprechen deiner Suche.",
+    "noToolsYet": "Noch keine Tools.",
+    "selectAll": "Alle auswählen",
+    "selectName": "{{name}} auswählen",
+    "name": "Name",
+    "category": "Kategorie",
+    "rating": "Bewertung",
+    "createdBy": "Erstellt von",
+    "createdAt": "Erstellt am",
+    "actions": "Aktionen",
+    "confirmTitle": "{{count}} Tool(s) in den Papierkorb verschieben?",
+    "confirmSub": "Die ausgewählten Tools werden aus allen öffentlichen Ansichten entfernt und in den Papierkorb verschoben, wo sie wiederhergestellt oder endgültig gelöscht werden können.",
+    "moveToTrashAction": "In den Papierkorb verschieben",
+    "toastMoved": "Tools in den Papierkorb verschoben",
+    "toastMovedSub": "{{count}} Tool(s) in den Papierkorb verschoben.",
+    "toastMoveFailed": "Verschieben in den Papierkorb fehlgeschlagen"
+  },
+  "analytics": {
+    "title": "Plattform-Analysen",
+    "subtitle": "Makro-Einblicke in die Leistung der Tools und das Engagement der Community.",
+    "totalToolsIndexed": "Indexierte Tools gesamt",
+    "totalRatingsCast": "Abgegebene Bewertungen gesamt",
+    "activeCategories": "Aktive Kategorien",
+    "avgGlobalScore": "Ø Globaler Punktestand",
+    "top8Tools": "Top 8 Tools nach kombiniertem Punktestand",
+    "top8ToolsSub": "Die bestbewerteten Tools der Plattform",
+    "toolsByCategory": "Tools nach Kategorie",
+    "toolsByCategorySub": "Verteilung der Tools auf Kategorien",
+    "globalRatingDistribution": "Globale Bewertungsverteilung",
+    "globalRatingDistributionSub": "Wie Benutzer über alle Tools abstimmen",
+    "radarTools": "Tools"
+  },
+  "redundancy": {
+    "title": "Tool-Analyse & Empfehlungen",
+    "subtitle": "Automatische Redundanz-Erkennung mit Kosten- und Bewertungsvergleich. Admins können manuell bestätigen, welches Tool die bessere Wahl ist.",
+    "toolsComparisons": "{{tools}} Tools, {{pairs}} Vergleiche",
+    "totalMonthly": "/Monat gesamt",
+    "reviews": "Bewertungen",
+    "features": "Features",
+    "comparisonsTitle": "Vergleiche & Empfehlungen",
+    "vs": "gegen",
+    "noTools": "Keine Tools gefunden.",
+    "perMonth": "/Monat",
+    "toastEvalSaved": "Auswertung gespeichert",
+    "toastEvalFailed": "Auswertung konnte nicht gespeichert werden"
+  },
+  "toolForm": {
+    "backToBrowse": "Zurück zur Übersicht",
+    "backToTool": "Zurück zum Tool",
+    "addTitle": "Neues Tool hinzufügen",
+    "addSubtitle": "Reiche ein Tool ein, das du nutzt, damit die Community es bewerten kann.",
+    "editTitle": "Tool bearbeiten",
+    "editSubtitle": "Aktualisiere Tool-Details und Metadaten.",
+    "signInRequired": "Anmeldung erforderlich",
+    "signInRequiredSub": "Du musst angemeldet sein, um ein Tool einzureichen.",
+    "toolDetails": "Tool-Details",
+    "toolDetailsNewSub": "Gib die grundlegenden Informationen zum Tool an.",
+    "toolDetailsEditSub": "Ändere die Tool-Informationen unten.",
+    "name": "Name",
+    "nameMin": "Name muss mindestens 2 Zeichen haben",
+    "category": "Kategorie",
+    "categoryRequired": "Kategorie ist erforderlich",
+    "websiteUrl": "Website-URL",
+    "websiteUrlOptional": "Website-URL (optional)",
+    "iconUrl": "Icon-/Logo-URL",
+    "iconUrlOptional": "Icon-/Logo-URL (optional)",
+    "iconPreview": "Icon-Vorschau",
+    "description": "Beschreibung",
+    "descriptionMin": "Beschreibung muss mindestens 10 Zeichen haben",
+    "invalidUrl": "Muss eine gültige URL sein",
+    "features": "Features",
+    "featuresNewSub": "Liste die wichtigsten Funktionen auf. Vorhandene Features anderer Tools sind auswählbar.",
+    "featuresEditSub": "Wichtige Funktionen dieses Tools. Vorhandene Features anderer Tools sind auswählbar.",
+    "addFeature": "Feature hinzufügen",
+    "noFeatures": "Keine Features hinzugefügt.",
+    "featurePlaceholder": "z. B. Echtzeit-Zusammenarbeit",
+    "tags": "Tags",
+    "tagsNewSub": "Schlüsselwörter, um dieses Tool zu finden. Vorhandene Tags anderer Tools sind auswählbar.",
+    "tagsEditSub": "Schlüsselwörter für dieses Tool. Vorhandene Tags anderer Tools sind auswählbar.",
+    "addTag": "Tag hinzufügen",
+    "tag": "Tag",
+    "namePlaceholder": "z. B. React, Next.js, Postgres",
+    "urlPlaceholder": "https://…",
+    "logoPlaceholder": "https://example.com/logo.png",
+    "descriptionPlaceholderNew": "Was macht dieses Tool? Warum nutzen es Menschen?",
+    "descriptionPlaceholderEdit": "Was macht dieses Tool?",
+    "addingTool": "Füge Tool hinzu…",
+    "submitTool": "Tool einreichen",
+    "saving": "Speichere…",
+    "saveChanges": "Änderungen speichern",
+    "toastAdded": "Tool erfolgreich hinzugefügt",
+    "toastAddedSub": "Dein Tool ist jetzt zur Bewertung verfügbar.",
+    "toastAddFailed": "Tool konnte nicht hinzugefügt werden",
+    "toastUpdated": "Tool aktualisiert",
+    "toastUpdatedSub": "Änderungen erfolgreich gespeichert.",
+    "toastUpdateFailed": "Tool konnte nicht aktualisiert werden",
+    "tagsHelp": "Schlüsselwörter, die helfen, dieses Tool zu finden. Vorhandene Tags anderer Tools sind auswählbar.",
+    "tagPlaceholder": "Tag"
+  },
+  "category": {
+    "placeholder": "Kategorie auswählen oder eingeben…",
+    "searchPlaceholder": "Kategorie suchen oder neue eingeben…",
+    "noCategories": "Keine Kategorien gefunden.",
+    "knownCategories": "Bekannte Kategorien",
+    "createNew": "Neu erstellen",
+    "create": "+ Erstellen"
+  },
+  "theme": {
+    "title": "Design",
+    "light": "Hell",
+    "dark": "Dunkel",
+    "system": "System",
+    "chooseTitle": "Design auswählen",
+    "switchLight": "Zum hellen Design wechseln",
+    "switchDark": "Zum dunklen Design wechseln"
   }
 }

artifacts/toolrate/src/i18n/locales/en.json

@@ -12,7 +12,7 @@
     "trash": "Trash",
     "admin": "Admin",
     "redundancy": "Redundancy",
-    "docs": "Docs",
+    "docs": "Help",
     "search": "Search tools…"
   },
   "auth": {
@@ -53,7 +53,9 @@
     "loading": "Loading…",
     "all": "All",
     "none": "None",
-    "language": "Language"
+    "language": "Language",
+    "viewDetails": "View details",
+    "guideTooltip": "Guide in the documentation"
   },
   "home": {
     "welcome": "Welcome to toolr",
@@ -80,6 +82,8 @@
     "category": "Category",
     "rating": "Rating",
     "reviews": "Reviews",
+    "reviewCount_one": "{{count}} review",
+    "reviewCount_other": "{{count}} reviews",
     "noToolsFound": "No tools found",
     "noToolsMatch": "We couldn't find any tools matching your current filters. Try adjusting your search criteria or add a new tool.",
     "addTool": "Add Tool",
@@ -103,7 +107,9 @@
     "features": "Features",
     "minRating": "Min. rating",
     "any": "Any",
-    "clearFilters": "Clear filters"
+    "clearFilters": "Clear filters",
+    "removeFeature": "Remove feature: {{feature}}",
+    "removeMinRating": "Remove min rating"
   },
   "detail": {
     "ratingBreakdown": "Rating Breakdown",
@@ -133,7 +139,65 @@
     "deleteToTrash": "This will move {{name}} to the trash. It can be restored later.",
     "deletePermanent": "This will permanently remove {{name}} and all its ratings. This cannot be undone.",
     "deleting": "Deleting…",
-    "deleteAction": "Delete"
+    "deleteAction": "Delete",
+    "invalidToolId": "Invalid Tool ID",
+    "backToBrowse": "Back to browse",
+    "keyFeatures": "Key Features",
+    "toolNotFound": "Tool not found.",
+    "similarTools": "Similar Tools",
+    "noSimilarTools": "No similar tools found.",
+    "linkTool": "Link Tool",
+    "linkSimilarTool": "Link Similar Tool",
+    "linkSimilarToolSub": "Manually link this tool to another tool.",
+    "toolId": "Tool ID",
+    "toolIdPlaceholder": "Enter target tool ID",
+    "relationType": "Relation Type",
+    "relationSimilar": "Similar",
+    "relationReplaces": "Replaces",
+    "relationSupersededBy": "Superseded By",
+    "notesOptional": "Notes (Optional)",
+    "notesPlaceholder": "Why are these tools related?",
+    "createLink": "Create Link",
+    "noCostInfo": "No cost information added yet.",
+    "costDialogSub": "Manage license cost information for this tool.",
+    "licenseType": "License Type",
+    "licenseFree": "Free",
+    "licenseSubscription": "Subscription",
+    "licenseOneTime": "One-Time",
+    "licenseUsageBased": "Usage-Based",
+    "billingPeriod": "Billing Period",
+    "billingMonthly": "Monthly",
+    "billingQuarterly": "Quarterly",
+    "billingYearly": "Yearly",
+    "costLabel": "Cost",
+    "currency": "Currency",
+    "costNotes": "Notes",
+    "costNotesPlaceholder": "Billing details, contract info...",
+    "commentOptional": "Comment (Optional)",
+    "commentLabel": "Comment",
+    "commentPlaceholder": "What do you think about this tool?",
+    "nameOptional": "Name (Optional)",
+    "nameLabel": "Name",
+    "anonymousPlaceholder": "Anonymous",
+    "anonymousEngineer": "Anonymous Engineer",
+    "beFirstToReview": "Be the first to share your thoughts on this tool.",
+    "shareExperience": "Share your experience with {{name}}",
+    "score": "Score",
+    "toastRelationCreated": "Relation created",
+    "toastRelationFailed": "Failed to create relation",
+    "toastRelationDeleted": "Relation deleted",
+    "toastRelationDeleteFailed": "Failed to delete relation",
+    "toastCostUpdated": "Cost updated",
+    "toastCostAdded": "Cost added",
+    "toastCostFailed": "Failed to save cost",
+    "toastCostDeleted": "Cost deleted",
+    "toastCostDeleteFailed": "Failed to delete cost",
+    "toastRatingSubmitted": "Rating submitted",
+    "toastRatingThanks": "Thank you for your feedback!",
+    "toastRatingFailed": "Failed to submit rating",
+    "toastToolDeleted": "Tool deleted",
+    "toastDeleteFailed": "Failed to delete",
+    "unexpectedError": "An unexpected error occurred."
   },
   "compare": {
     "title": "Compare Tools",
@@ -176,7 +240,29 @@
     "deletePermanently": "Delete permanently",
     "emptyTrash": "Empty trash",
     "deletedAt": "Deleted at",
-    "deletedBy": "Deleted by"
+    "deletedBy": "Deleted by",
+    "name": "Name",
+    "category": "Category",
+    "actions": "Actions",
+    "selectAll": "Select all",
+    "selectName": "Select {{name}}",
+    "restoreAction": "Restore",
+    "deleteAction": "Delete",
+    "deleteConfirmTitle": "Delete {{count}} tool(s) permanently?",
+    "deleteConfirmSub": "This permanently removes the selected tools along with all their ratings, costs and relations. This cannot be undone.",
+    "emptyConfirmTitle": "Empty the trash?",
+    "emptyConfirmSub": "This permanently removes all {{count}} tool(s) in the trash along with their ratings, costs and relations. This cannot be undone.",
+    "toastRestored": "Tools restored",
+    "toastRestoredSub": "{{count}} tool(s) restored.",
+    "toastRestoreFailed": "Failed to restore",
+    "toastDeleted": "Tools deleted",
+    "toastDeletedSub": "{{count}} tool(s) permanently removed.",
+    "toastDeleteFailed": "Failed to delete",
+    "toastEmptied": "Trash emptied",
+    "toastEmptiedSub": "{{count}} tool(s) permanently removed.",
+    "toastEmptyFailed": "Failed to empty trash",
+    "searchPlaceholder": "Search tools…",
+    "toolCount": "{{count}} tool(s)"
   },
   "notFound": {
     "text": "This page doesn't exist.",
@@ -191,14 +277,28 @@
     "latest": "Latest",
     "repo": "Repository",
     "nav": "Documentation",
-    "guides": "Guide",
+    "guides": "Guides",
     "endpoints": "Endpoints",
     "schemas": "Data models",
     "releases": "Release notes",
     "reference": "API reference",
     "referenceIntro": "Generated automatically from the OpenAPI spec — all endpoints and data fields of the current version.",
     "onThisPage": "On this page",
-    "searchPlaceholder": "Search docs…"
+    "searchPlaceholder": "Search docs…",
+    "backToApp": "Back to app",
+    "field": "Field",
+    "type": "Type",
+    "required": "Required",
+    "description": "Description",
+    "status": "Status",
+    "schema": "Schema",
+    "parameter": "Parameter",
+    "noResults": "No results",
+    "fields": "Fields",
+    "fieldHelpHint": "Note: form fields link via the ? icon directly to the respective rows of this table.",
+    "name": "Name",
+    "in": "In",
+    "requestBody": "Request Body"
   },
   "command": {
     "navigate": "Navigate",
@@ -206,5 +306,192 @@
     "tools": "Tools",
     "noResults": "No tools found for \"{{query}}\".",
     "startTyping": "Start typing to search tools."
+  },
+  "admin": {
+    "accessRequired": "Admin Access Required",
+    "accessRequiredSub": "You need admin rights to view this page.",
+    "goHome": "Go Home",
+    "panel": "Admin Panel",
+    "panelSub": "Manage users and review system changes.",
+    "redundancyDashboard": "Redundancy Dashboard",
+    "tabUsers": "Users",
+    "tabTools": "Tools",
+    "tabAudit": "Audit Log",
+    "tabSystem": "System",
+    "localUsers": "Local Users",
+    "localUsersSub": "Manage accounts for local authentication.",
+    "addUser": "Add User",
+    "noUsersYet": "No users yet.",
+    "auditLog": "Audit Log",
+    "auditLogSub": "All create, update and delete operations tracked by the system.",
+    "by": "by",
+    "noAuditEntries": "No audit entries yet.",
+    "system": "System",
+    "systemSub": "Build information of the currently live deployment.",
+    "version": "Version",
+    "commit": "Commit",
+    "buildDate": "Build date",
+    "trashRetention": "Trash retention",
+    "days": "days",
+    "keepForever": "Keep forever",
+    "createNewUser": "Create New User",
+    "username": "Username",
+    "password": "Password",
+    "emailOptional": "Email (Optional)",
+    "role": "Role",
+    "roleUser": "User",
+    "roleAdmin": "Admin",
+    "plan": "Plan",
+    "planFree": "Free",
+    "planPremium": "Premium",
+    "planEnterprise": "Enterprise",
+    "creating": "Creating…",
+    "createUser": "Create User",
+    "editUser": "Edit User — {{username}}",
+    "setPassword": "Set Password",
+    "resetsPassword": "Resets the user's password immediately.",
+    "idpManaged": "Password is managed by the identity provider (Keycloak). Reset it there.",
+    "setting": "Setting…",
+    "deleteUser": "Delete User",
+    "deleteUserConfirm": "Are you sure you want to delete {{username}}? This cannot be undone.",
+    "minPasswordPlaceholder": "min. 6 characters",
+    "usernamePlaceholder": "username",
+    "emailPlaceholder": "user@example.com",
+    "toastUserCreated": "User created",
+    "toastUserCreatedSub": "{{username}} has been created.",
+    "toastUserCreateFailed": "Failed to create user",
+    "toastUserUpdated": "User updated",
+    "toastUserUpdateFailed": "Failed to update user",
+    "toastPwTooShort": "Password too short",
+    "toastPwTooShortSub": "Minimum 6 characters.",
+    "toastPwUpdated": "Password updated",
+    "toastPwUpdatedSub": "Password for {{username}} has been set.",
+    "toastPwSetFailed": "Failed to set password",
+    "toastUserDeleted": "User deleted",
+    "toastUserDeletedSub": "{{username}} has been removed.",
+    "toastUserDeleteFailed": "Failed to delete user"
+  },
+  "adminTools": {
+    "accessRequired": "Admin access required.",
+    "allTools": "All Tools",
+    "toolCount": "{{count}} tool(s)",
+    "selected": "{{count}} selected",
+    "searchPlaceholder": "Search tools…",
+    "moveToTrash": "Move to trash ({{count}})",
+    "noMatch": "No tools match your search.",
+    "noToolsYet": "No tools yet.",
+    "selectAll": "Select all",
+    "selectName": "Select {{name}}",
+    "name": "Name",
+    "category": "Category",
+    "rating": "Rating",
+    "createdBy": "Created by",
+    "createdAt": "Created at",
+    "actions": "Actions",
+    "confirmTitle": "Move {{count}} tool(s) to trash?",
+    "confirmSub": "The selected tools will be hidden from all public views and moved to the trash, where they can be restored or permanently deleted.",
+    "moveToTrashAction": "Move to trash",
+    "toastMoved": "Tools moved to trash",
+    "toastMovedSub": "{{count}} tool(s) moved to trash.",
+    "toastMoveFailed": "Failed to move to trash"
+  },
+  "analytics": {
+    "title": "Platform Analytics",
+    "subtitle": "Macro-level insights into tool performance and community engagement.",
+    "totalToolsIndexed": "Total Tools Indexed",
+    "totalRatingsCast": "Total Ratings Cast",
+    "activeCategories": "Active Categories",
+    "avgGlobalScore": "Avg Global Score",
+    "top8Tools": "Top 8 Tools by Combined Score",
+    "top8ToolsSub": "Highest rated tools across the platform",
+    "toolsByCategory": "Tools by Category",
+    "toolsByCategorySub": "Distribution of tools across categories",
+    "globalRatingDistribution": "Global Rating Distribution",
+    "globalRatingDistributionSub": "How users are voting across all tools",
+    "radarTools": "Tools"
+  },
+  "redundancy": {
+    "title": "Tool Analysis & Recommendations",
+    "subtitle": "Automatic redundancy detection with cost and rating comparison. Admin can manually confirm which tool is the better choice.",
+    "toolsComparisons": "{{tools}} tools, {{pairs}} comparisons",
+    "totalMonthly": "/mo total",
+    "reviews": "reviews",
+    "features": "features",
+    "comparisonsTitle": "Comparisons & Recommendations",
+    "vs": "vs",
+    "noTools": "No tools found.",
+    "perMonth": "/mo",
+    "toastEvalSaved": "Evaluation saved",
+    "toastEvalFailed": "Failed to save evaluation"
+  },
+  "toolForm": {
+    "backToBrowse": "Back to browse",
+    "backToTool": "Back to tool",
+    "addTitle": "Add a New Tool",
+    "addSubtitle": "Submit a tool you use to let the community rate and review it.",
+    "editTitle": "Edit Tool",
+    "editSubtitle": "Update tool details and metadata.",
+    "signInRequired": "Sign in required",
+    "signInRequiredSub": "You must be signed in to submit a tool.",
+    "toolDetails": "Tool Details",
+    "toolDetailsNewSub": "Provide the basic information about the tool.",
+    "toolDetailsEditSub": "Modify the tool information below.",
+    "name": "Name",
+    "nameMin": "Name must be at least 2 characters",
+    "category": "Category",
+    "categoryRequired": "Category is required",
+    "websiteUrl": "Website URL",
+    "websiteUrlOptional": "Website URL (Optional)",
+    "iconUrl": "Icon / Logo URL",
+    "iconUrlOptional": "Icon / Logo URL (Optional)",
+    "iconPreview": "icon preview",
+    "description": "Description",
+    "descriptionMin": "Description must be at least 10 characters",
+    "invalidUrl": "Must be a valid URL",
+    "features": "Features",
+    "featuresNewSub": "List key capabilities. Existing features from other tools are selectable.",
+    "featuresEditSub": "Key capabilities of this tool. Existing features from other tools are selectable.",
+    "addFeature": "Add Feature",
+    "noFeatures": "No features added.",
+    "featurePlaceholder": "e.g. Real-time collaboration",
+    "tags": "Tags",
+    "tagsNewSub": "Keywords to help find this tool. Existing tags from other tools are selectable.",
+    "tagsEditSub": "Keywords for this tool. Existing tags from other tools are selectable.",
+    "addTag": "Add Tag",
+    "tag": "Tag",
+    "namePlaceholder": "e.g. React, Next.js, Postgres",
+    "urlPlaceholder": "https://...",
+    "logoPlaceholder": "https://example.com/logo.png",
+    "descriptionPlaceholderNew": "What does this tool do? Why do people use it?",
+    "descriptionPlaceholderEdit": "What does this tool do?",
+    "addingTool": "Adding Tool...",
+    "submitTool": "Submit Tool",
+    "saving": "Saving…",
+    "saveChanges": "Save Changes",
+    "toastAdded": "Tool added successfully",
+    "toastAddedSub": "Your tool is now available for review.",
+    "toastAddFailed": "Failed to add tool",
+    "toastUpdated": "Tool updated",
+    "toastUpdatedSub": "Changes saved successfully.",
+    "toastUpdateFailed": "Failed to update tool",
+    "tagsHelp": "Keywords to help find this tool. Existing tags from other tools are selectable.",
+    "tagPlaceholder": "Tag"
+  },
+  "category": {
+    "placeholder": "Select or type a category...",
+    "searchPlaceholder": "Search or enter new category...",
+    "noCategories": "No categories found.",
+    "knownCategories": "Known categories",
+    "createNew": "Create new",
+    "create": "+ Create"
+  },
+  "theme": {
+    "title": "Theme",
+    "light": "Light",
+    "dark": "Dark",
+    "system": "System",
+    "chooseTitle": "Choose theme",
+    "switchLight": "Switch to light theme",
+    "switchDark": "Switch to dark theme"
   }
 }

artifacts/toolrate/src/pages/admin.tsx

@@ -29,8 +29,10 @@ import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
 import { Users, ScrollText, ShieldAlert, Plus, Pencil, Trash2, Clock, AlertTriangle, Wrench, Server } from "lucide-react";
 import { format } from "date-fns";
 import { AdminToolsTab } from "@/components/admin-tools-tab";
+import { useTranslation } from "react-i18next";
 
 export default function Admin() {
+  const { t } = useTranslation();
   const [, setLocation] = useLocation();
   const { user, isAdmin, isLoading: authLoading } = useAuth();
   const { toast } = useToast();
@@ -68,9 +70,9 @@ export default function Admin() {
       <Layout>
         <div className="flex flex-col items-center justify-center py-20 gap-4">
           <ShieldAlert className="w-12 h-12 text-muted-foreground" />
-          <h2 className="text-2xl font-bold">Admin Access Required</h2>
-          <p className="text-muted-foreground">You need admin rights to view this page.</p>
-          <Button variant="outline" onClick={() => setLocation("/")}>Go Home</Button>
+          <h2 className="text-2xl font-bold">{t("admin.accessRequired")}</h2>
+          <p className="text-muted-foreground">{t("admin.accessRequiredSub")}</p>
+          <Button variant="outline" onClick={() => setLocation("/")}>{t("admin.goHome")}</Button>
         </div>
       </Layout>
     );
@@ -82,7 +84,7 @@ export default function Admin() {
       { data: { username: newUsername, password: newPassword, email: newEmail || undefined, role: newRole, tier: newTier } },
       {
         onSuccess: () => {
-          toast({ title: "User created", description: `${newUsername} has been created.` });
+          toast({ title: t("admin.toastUserCreated"), description: t("admin.toastUserCreatedSub", { username: newUsername }) });
           queryClient.invalidateQueries({ queryKey: getListUsersQueryKey() });
           setCreateOpen(false);
           setNewUsername("");
@@ -91,7 +93,7 @@ export default function Admin() {
           setNewRole("user");
         },
         onError: (err) => {
-          toast({ title: "Failed to create user", description: err.data?.error ?? err.message, variant: "destructive" });
+          toast({ title: t("admin.toastUserCreateFailed"), description: err.data?.error ?? err.message, variant: "destructive" });
         },
       },
     );
@@ -103,12 +105,12 @@ export default function Admin() {
       { id: editUser.id, data: { role: editUser.role as "admin" | "user", tier: editUser.tier as "free" | "premium" | "enterprise" } },
       {
         onSuccess: () => {
-          toast({ title: "User updated" });
+          toast({ title: t("admin.toastUserUpdated") });
           queryClient.invalidateQueries({ queryKey: getListUsersQueryKey() });
           setEditUser(null);
         },
         onError: (err) => {
-          toast({ title: "Failed to update user", description: err.data?.error ?? err.message, variant: "destructive" });
+          toast({ title: t("admin.toastUserUpdateFailed"), description: err.data?.error ?? err.message, variant: "destructive" });
         },
       },
     );
@@ -117,18 +119,18 @@ export default function Admin() {
   const handleSetUserPassword = () => {
     if (!editUser || !editPassword) return;
     if (editPassword.length < 6) {
-      toast({ title: "Password too short", description: "Minimum 6 characters.", variant: "destructive" });
+      toast({ title: t("admin.toastPwTooShort"), description: t("admin.toastPwTooShortSub"), variant: "destructive" });
       return;
     }
     setUserPassword.mutate(
       { id: editUser.id, data: { password: editPassword } },
       {
         onSuccess: () => {
-          toast({ title: "Password updated", description: `Password for ${editUser.username} has been set.` });
+          toast({ title: t("admin.toastPwUpdated"), description: t("admin.toastPwUpdatedSub", { username: editUser.username }) });
           setEditPassword("");
         },
         onError: (err) => {
-          toast({ title: "Failed to set password", description: (err.data as { error?: string } | null)?.error ?? err.message, variant: "destructive" });
+          toast({ title: t("admin.toastPwSetFailed"), description: (err.data as { error?: string } | null)?.error ?? err.message, variant: "destructive" });
         },
       },
     );
@@ -140,12 +142,12 @@ export default function Admin() {
       { id: deleteConfirm.id },
       {
         onSuccess: () => {
-          toast({ title: "User deleted", description: `${deleteConfirm.username} has been removed.` });
+          toast({ title: t("admin.toastUserDeleted"), description: t("admin.toastUserDeletedSub", { username: deleteConfirm.username }) });
           queryClient.invalidateQueries({ queryKey: getListUsersQueryKey() });
           setDeleteConfirm(null);
         },
         onError: (err) => {
-          toast({ title: "Failed to delete user", description: (err.data as { error?: string } | null)?.error ?? err.message, variant: "destructive" });
+          toast({ title: t("admin.toastUserDeleteFailed"), description: (err.data as { error?: string } | null)?.error ?? err.message, variant: "destructive" });
         },
       },
     );
@@ -163,11 +165,11 @@ export default function Admin() {
         <div>
           <div className="flex items-start justify-between">
             <div>
-              <h1 className="text-3xl font-bold tracking-tight mb-2">Admin Panel</h1>
-              <p className="text-muted-foreground">Manage users and review system changes.</p>
+              <h1 className="text-3xl font-bold tracking-tight mb-2">{t("admin.panel")}</h1>
+              <p className="text-muted-foreground">{t("admin.panelSub")}</p>
             </div>
             <Button asChild variant="outline" size="sm" className="gap-2">
-              <Link href="/admin/redundancy"><AlertTriangle className="w-4 h-4" /> Redundancy Dashboard</Link>
+              <Link href="/admin/redundancy"><AlertTriangle className="w-4 h-4" /> {t("admin.redundancyDashboard")}</Link>
             </Button>
           </div>
         </div>
@@ -175,16 +177,16 @@ export default function Admin() {
         <Tabs defaultValue="users">
           <TabsList className="mb-4">
             <TabsTrigger value="users" className="gap-2">
-              <Users className="w-4 h-4" /> Users
+              <Users className="w-4 h-4" /> {t("admin.tabUsers")}
             </TabsTrigger>
             <TabsTrigger value="tools" className="gap-2">
-              <Wrench className="w-4 h-4" /> Tools
+              <Wrench className="w-4 h-4" /> {t("admin.tabTools")}
             </TabsTrigger>
             <TabsTrigger value="audit" className="gap-2">
-              <ScrollText className="w-4 h-4" /> Audit Log
+              <ScrollText className="w-4 h-4" /> {t("admin.tabAudit")}
             </TabsTrigger>
             <TabsTrigger value="system" className="gap-2">
-              <Server className="w-4 h-4" /> System
+              <Server className="w-4 h-4" /> {t("admin.tabSystem")}
             </TabsTrigger>
           </TabsList>
 
@@ -192,11 +194,11 @@ export default function Admin() {
             <Card>
               <CardHeader className="flex flex-row items-center justify-between">
                 <div>
-                  <CardTitle>Local Users</CardTitle>
-                  <CardDescription>Manage accounts for local authentication.</CardDescription>
+                  <CardTitle>{t("admin.localUsers")}</CardTitle>
+                  <CardDescription>{t("admin.localUsersSub")}</CardDescription>
                 </div>
                 <Button size="sm" onClick={() => setCreateOpen(true)}>
-                  <Plus className="w-4 h-4 mr-2" /> Add User
+                  <Plus className="w-4 h-4 mr-2" /> {t("admin.addUser")}
                 </Button>
               </CardHeader>
               <CardContent>
@@ -248,7 +250,7 @@ export default function Admin() {
                       </div>
                     ))}
                     {(!users || users.length === 0) && (
-                      <p className="text-sm text-muted-foreground py-4 text-center">No users yet.</p>
+                      <p className="text-sm text-muted-foreground py-4 text-center">{t("admin.noUsersYet")}</p>
                     )}
                   </div>
                 )}
@@ -263,8 +265,8 @@ export default function Admin() {
           <TabsContent value="audit">
             <Card>
               <CardHeader>
-                <CardTitle>Audit Log</CardTitle>
-                <CardDescription>All create, update and delete operations tracked by the system.</CardDescription>
+                <CardTitle>{t("admin.auditLog")}</CardTitle>
+                <CardDescription>{t("admin.auditLogSub")}</CardDescription>
               </CardHeader>
               <CardContent>
                 {loadingLogs ? (
@@ -289,8 +291,7 @@ export default function Admin() {
                           </span>
                         </div>
                         <div className="flex items-center gap-2 text-xs text-muted-foreground">
-                          <span>by <span className="font-medium text-foreground">{log.username}</span></span>
-                          {log.changes && (
+                          <span>{t("admin.by")} <span className="font-medium text-foreground">{log.username}</span></span>                          {log.changes && (
                             <span className="truncate max-w-[400px] font-mono bg-muted px-1.5 py-0.5 rounded text-[11px]">
                               {log.changes.length > 120 ? log.changes.slice(0, 120) + "…" : log.changes}
                             </span>
@@ -299,7 +300,7 @@ export default function Admin() {
                       </div>
                     ))}
                     {(!auditLogs || auditLogs.length === 0) && (
-                      <p className="text-sm text-muted-foreground py-4 text-center">No audit entries yet.</p>
+                      <p className="text-sm text-muted-foreground py-4 text-center">{t("admin.noAuditEntries")}</p>
                     )}
                   </div>
                 )}
@@ -310,17 +311,17 @@ export default function Admin() {
           <TabsContent value="system">
             <Card>
               <CardHeader>
-                <CardTitle>System</CardTitle>
-                <CardDescription>Build information of the currently live deployment.</CardDescription>
+                <CardTitle>{t("admin.system")}</CardTitle>
+                <CardDescription>{t("admin.systemSub")}</CardDescription>
               </CardHeader>
               <CardContent>
                 <div className="divide-y">
                   <div className="flex items-center justify-between py-3">
-                    <span className="text-sm text-muted-foreground">Version</span>
+                    <span className="text-sm text-muted-foreground">{t("admin.version")}</span>
                     <span className="text-sm font-medium">{versionInfo?.version || "dev"}</span>
                   </div>
                   <div className="flex items-center justify-between py-3">
-                    <span className="text-sm text-muted-foreground">Commit</span>
+                    <span className="text-sm text-muted-foreground">{t("admin.commit")}</span>
                     {versionInfo?.commitSha ? (
                       <a
                         href={`https://git.kubebase.de/admin/tool-evaluator/commit/${versionInfo.commitSha}`}
@@ -336,17 +337,17 @@ export default function Admin() {
                     )}
                   </div>
                   <div className="flex items-center justify-between py-3">
-                    <span className="text-sm text-muted-foreground">Build date</span>
+                    <span className="text-sm text-muted-foreground">{t("admin.buildDate")}</span>
                     <span className="text-sm">
                       {versionInfo?.buildDate ? format(new Date(versionInfo.buildDate), "dd.MM.yyyy HH:mm") : "—"}
                     </span>
                   </div>
                   <div className="flex items-center justify-between py-3">
-                    <span className="text-sm text-muted-foreground">Trash retention</span>
+                    <span className="text-sm text-muted-foreground">{t("admin.trashRetention")}</span>
                     <span className="text-sm">
                       {(versionInfo?.trashRetentionDays ?? 0) > 0
-                        ? `${versionInfo?.trashRetentionDays} days`
-                        : "Keep forever"}
+                        ? `${versionInfo?.trashRetentionDays} ${t("admin.days")}`
+                        : t("admin.keepForever")}
                     </span>
                   </div>
                 </div>
@@ -359,51 +360,51 @@ export default function Admin() {
       <Dialog open={createOpen} onOpenChange={setCreateOpen}>
         <DialogContent className="sm:max-w-md">
           <DialogHeader>
-            <DialogTitle>Create New User</DialogTitle>
+            <DialogTitle>{t("admin.createNewUser")}</DialogTitle>
           </DialogHeader>
           <div className="space-y-4 py-2">
             <div className="space-y-2">
-              <Label>Username</Label>
-              <Input value={newUsername} onChange={(e) => setNewUsername(e.target.value)} placeholder="username" />
+              <Label>{t("admin.username")}</Label>
+              <Input value={newUsername} onChange={(e) => setNewUsername(e.target.value)} placeholder={t("admin.usernamePlaceholder")} />
             </div>
             <div className="space-y-2">
-              <Label>Password</Label>
-              <PasswordInput value={newPassword} onChange={(e) => setNewPassword(e.target.value)} placeholder="min. 6 characters" />
+              <Label>{t("admin.password")}</Label>
+              <PasswordInput value={newPassword} onChange={(e) => setNewPassword(e.target.value)} placeholder={t("admin.minPasswordPlaceholder")} />
             </div>
             <div className="space-y-2">
-              <Label>Email (Optional)</Label>
-              <Input type="email" value={newEmail} onChange={(e) => setNewEmail(e.target.value)} placeholder="user@example.com" />
+              <Label>{t("admin.emailOptional")}</Label>
+              <Input type="email" value={newEmail} onChange={(e) => setNewEmail(e.target.value)} placeholder={t("admin.emailPlaceholder")} />
             </div>
             <div className="space-y-2">
-              <Label>Role</Label>
+              <Label>{t("admin.role")}</Label>
               <Select value={newRole} onValueChange={(v) => setNewRole(v as "admin" | "user")}>
                 <SelectTrigger>
                   <SelectValue />
                 </SelectTrigger>
                 <SelectContent>
-                  <SelectItem value="user">User</SelectItem>
-                  <SelectItem value="admin">Admin</SelectItem>
+                  <SelectItem value="user">{t("admin.roleUser")}</SelectItem>
+                  <SelectItem value="admin">{t("admin.roleAdmin")}</SelectItem>
                 </SelectContent>
               </Select>
             </div>
             <div className="space-y-2">
-              <Label>Plan</Label>
+              <Label>{t("admin.plan")}</Label>
               <Select value={newTier} onValueChange={(v) => setNewTier(v as "free" | "premium" | "enterprise")}>
                 <SelectTrigger>
                   <SelectValue />
                 </SelectTrigger>
                 <SelectContent>
-                  <SelectItem value="free">Free</SelectItem>
-                  <SelectItem value="premium">Premium</SelectItem>
-                  <SelectItem value="enterprise">Enterprise</SelectItem>
+                  <SelectItem value="free">{t("admin.planFree")}</SelectItem>
+                  <SelectItem value="premium">{t("admin.planPremium")}</SelectItem>
+                  <SelectItem value="enterprise">{t("admin.planEnterprise")}</SelectItem>
                 </SelectContent>
               </Select>
             </div>
           </div>
           <DialogFooter>
-            <Button variant="outline" onClick={() => setCreateOpen(false)}>Cancel</Button>
+            <Button variant="outline" onClick={() => setCreateOpen(false)}>{t("common.cancel")}</Button>
             <Button onClick={handleCreateUser} disabled={createUser.isPending || !newUsername || !newPassword}>
-              {createUser.isPending ? "Creating…" : "Create User"}
+              {createUser.isPending ? t("admin.creating") : t("admin.createUser")}
             </Button>
           </DialogFooter>
         </DialogContent>
@@ -412,11 +413,11 @@ export default function Admin() {
       <Dialog open={!!editUser} onOpenChange={(open) => { if (!open) { setEditUser(null); setEditPassword(""); } }}>
         <DialogContent className="sm:max-w-sm">
           <DialogHeader>
-            <DialogTitle>Edit User — {editUser?.username}</DialogTitle>
+            <DialogTitle>{t("admin.editUser", { username: editUser?.username })}</DialogTitle>
           </DialogHeader>
           <div className="space-y-4 py-2">
             <div className="space-y-2">
-              <Label>Role</Label>
+              <Label>{t("admin.role")}</Label>
               <Select
                 value={editUser?.role || "user"}
                 onValueChange={(v) => setEditUser(editUser ? { ...editUser, role: v } : null)}
@@ -425,13 +426,13 @@ export default function Admin() {
                   <SelectValue />
                 </SelectTrigger>
                 <SelectContent>
-                  <SelectItem value="user">User</SelectItem>
-                  <SelectItem value="admin">Admin</SelectItem>
+                  <SelectItem value="user">{t("admin.roleUser")}</SelectItem>
+                  <SelectItem value="admin">{t("admin.roleAdmin")}</SelectItem>
                 </SelectContent>
               </Select>
             </div>
             <div className="space-y-2">
-              <Label>Plan</Label>
+              <Label>{t("admin.plan")}</Label>
               <Select
                 value={editUser?.tier || "free"}
                 onValueChange={(v) => setEditUser(editUser ? { ...editUser, tier: v } : null)}
@@ -440,36 +441,36 @@ export default function Admin() {
                   <SelectValue />
                 </SelectTrigger>
                 <SelectContent>
-                  <SelectItem value="free">Free</SelectItem>
-                  <SelectItem value="premium">Premium</SelectItem>
-                  <SelectItem value="enterprise">Enterprise</SelectItem>
+                  <SelectItem value="free">{t("admin.planFree")}</SelectItem>
+                  <SelectItem value="premium">{t("admin.planPremium")}</SelectItem>
+                  <SelectItem value="enterprise">{t("admin.planEnterprise")}</SelectItem>
                 </SelectContent>
               </Select>
             </div>
             {editUser?.authProvider !== "oidc" ? (
               <div className="space-y-2 border-t pt-4">
-                <Label>Set Password</Label>
+                <Label>{t("admin.setPassword")}</Label>
                 <PasswordInput
                   value={editPassword}
                   onChange={(e) => setEditPassword(e.target.value)}
-                  placeholder="min. 6 characters"
+                  placeholder={t("admin.minPasswordPlaceholder")}
                   data-testid="input-set-password"
                 />
-                <p className="text-xs text-muted-foreground">Resets the user's password immediately.</p>
+                <p className="text-xs text-muted-foreground">{t("admin.resetsPassword")}</p>
               </div>
             ) : (
               <div className="space-y-2 border-t pt-4 text-sm text-muted-foreground">
-                Password is managed by the identity provider (Keycloak). Reset it there.
+                {t("admin.idpManaged")}
               </div>
             )}
           </div>
           <DialogFooter className="flex-col sm:flex-row sm:justify-end gap-2">
-            <Button variant="outline" onClick={() => { setEditUser(null); setEditPassword(""); }}>Cancel</Button>
+            <Button variant="outline" onClick={() => { setEditUser(null); setEditPassword(""); }}>{t("common.cancel")}</Button>
             <Button
               onClick={handleUpdateUser}
               disabled={updateUser.isPending}
             >
-              Save
+              {t("common.save")}
             </Button>
             {editUser?.authProvider !== "oidc" && (
               <Button
@@ -477,7 +478,7 @@ export default function Admin() {
                 onClick={handleSetUserPassword}
                 disabled={setUserPassword.isPending || !editPassword}
               >
-                {setUserPassword.isPending ? "Setting…" : "Set Password"}
+                {setUserPassword.isPending ? t("admin.setting") : t("admin.setPassword")}
               </Button>
             )}
           </DialogFooter>
@@ -487,15 +488,15 @@ export default function Admin() {
       <Dialog open={!!deleteConfirm} onOpenChange={(open) => !open && setDeleteConfirm(null)}>
         <DialogContent className="sm:max-w-sm">
           <DialogHeader>
-            <DialogTitle>Delete User</DialogTitle>
+            <DialogTitle>{t("admin.deleteUser")}</DialogTitle>
           </DialogHeader>
           <p className="text-sm text-muted-foreground py-2">
-            Are you sure you want to delete <span className="font-medium text-foreground">{deleteConfirm?.username}</span>? This cannot be undone.
+            {t("admin.deleteUserConfirm", { username: deleteConfirm?.username })}
           </p>
           <DialogFooter>
-            <Button variant="outline" onClick={() => setDeleteConfirm(null)}>Cancel</Button>
+            <Button variant="outline" onClick={() => setDeleteConfirm(null)}>{t("common.cancel")}</Button>
             <Button variant="destructive" onClick={handleDeleteUser} disabled={deleteUser.isPending}>
-              {deleteUser.isPending ? "Deleting…" : "Delete"}
+              {deleteUser.isPending ? t("detail.deleting") : t("common.delete")}
             </Button>
           </DialogFooter>
         </DialogContent>

artifacts/toolrate/src/pages/analytics.tsx

@@ -5,7 +5,9 @@ import {
   useGetRatingDistribution,
   GetTopToolsMetric
 } from "@workspace/api-client-react";
+import { useTranslation } from "react-i18next";
 import { Layout } from "@/components/layout";
+import { GuideHelp } from "@/components/guide-help";
 import { Card, CardContent, CardHeader, CardTitle, CardDescription } from "@/components/ui/card";
 import { Skeleton } from "@/components/ui/skeleton";
 import { 
@@ -16,6 +18,7 @@ import {
 import { BarChart3, TrendingUp, Layers, Activity } from "lucide-react";
 
 export default function Analytics() {
+  const { t } = useTranslation();
   const { data: summary, isLoading: loadingSummary } = useGetAnalyticsSummary();
   
   const { data: topTools, isLoading: loadingTopTools } = useGetTopTools({ 
@@ -48,8 +51,11 @@ export default function Analytics() {
     <Layout>
       <div className="space-y-6 pb-10">
         <div>
-          <h1 className="text-3xl font-bold tracking-tight mb-2">Platform Analytics</h1>
-          <p className="text-muted-foreground">Macro-level insights into tool performance and community engagement.</p>
+          <h1 className="text-3xl font-bold tracking-tight mb-2 flex items-center gap-2">
+            {t("analytics.title")}
+            <GuideHelp guide="analytics" label={t("analytics.title")} />
+          </h1>
+          <p className="text-muted-foreground">{t("analytics.subtitle")}</p>
         </div>
 
         {/* Top KPI Cards */}
@@ -57,7 +63,7 @@ export default function Analytics() {
           <Card>
             <CardContent className="p-6">
               <div className="flex items-center justify-between mb-4">
-                <span className="text-sm font-medium text-muted-foreground">Total Tools Indexed</span>
+                <span className="text-sm font-medium text-muted-foreground">{t("analytics.totalToolsIndexed")}</span>
                 <Layers className="w-4 h-4 text-muted-foreground" />
               </div>
               {loadingSummary ? <Skeleton className="h-8 w-16" /> : (
@@ -69,7 +75,7 @@ export default function Analytics() {
           <Card>
             <CardContent className="p-6">
               <div className="flex items-center justify-between mb-4">
-                <span className="text-sm font-medium text-muted-foreground">Total Ratings Cast</span>
+                <span className="text-sm font-medium text-muted-foreground">{t("analytics.totalRatingsCast")}</span>
                 <Activity className="w-4 h-4 text-muted-foreground" />
               </div>
               {loadingSummary ? <Skeleton className="h-8 w-16" /> : (
@@ -81,7 +87,7 @@ export default function Analytics() {
           <Card>
             <CardContent className="p-6">
               <div className="flex items-center justify-between mb-4">
-                <span className="text-sm font-medium text-muted-foreground">Active Categories</span>
+                <span className="text-sm font-medium text-muted-foreground">{t("analytics.activeCategories")}</span>
                 <BarChart3 className="w-4 h-4 text-muted-foreground" />
               </div>
               {loadingSummary ? <Skeleton className="h-8 w-16" /> : (
@@ -93,7 +99,7 @@ export default function Analytics() {
           <Card>
             <CardContent className="p-6">
               <div className="flex items-center justify-between mb-4">
-                <span className="text-sm font-medium text-muted-foreground">Avg Global Score</span>
+                <span className="text-sm font-medium text-muted-foreground">{t("analytics.avgGlobalScore")}</span>
                 <TrendingUp className="w-4 h-4 text-muted-foreground" />
               </div>
               {loadingSummary ? <Skeleton className="h-8 w-16" /> : (
@@ -108,8 +114,8 @@ export default function Analytics() {
           {/* Top Tools Chart */}
           <Card className="col-span-1 lg:col-span-2">
             <CardHeader>
-              <CardTitle>Top 8 Tools by Combined Score</CardTitle>
-              <CardDescription>Highest rated tools across the platform</CardDescription>
+              <CardTitle>{t("analytics.top8Tools")}</CardTitle>
+              <CardDescription>{t("analytics.top8ToolsSub")}</CardDescription>
             </CardHeader>
             <CardContent>
               {loadingTopTools ? (
@@ -136,8 +142,8 @@ export default function Analytics() {
           {/* Category Breakdown */}
           <Card>
             <CardHeader>
-              <CardTitle>Tools by Category</CardTitle>
-              <CardDescription>Distribution of tools across categories</CardDescription>
+              <CardTitle>{t("analytics.toolsByCategory")}</CardTitle>
+              <CardDescription>{t("analytics.toolsByCategorySub")}</CardDescription>
             </CardHeader>
             <CardContent>
               {loadingCategories ? (
@@ -149,7 +155,7 @@ export default function Analytics() {
                       <PolarGrid stroke="hsl(var(--border))" />
                       <PolarAngleAxis dataKey="category" tick={{ fill: 'hsl(var(--foreground))', fontSize: 12 }} />
                       <PolarRadiusAxis angle={30} domain={[0, 'auto']} tick={false} axisLine={false} />
-                      <Radar name="Tools" dataKey="tools" stroke="hsl(var(--primary))" fill="hsl(var(--primary))" fillOpacity={0.3} />
+                      <Radar name={t("analytics.radarTools")} dataKey="tools" stroke="hsl(var(--primary))" fill="hsl(var(--primary))" fillOpacity={0.3} />
                       <RechartsTooltip />
                     </RadarChart>
                   </ResponsiveContainer>
@@ -161,8 +167,8 @@ export default function Analytics() {
           {/* Rating Distributions */}
           <Card>
             <CardHeader>
-              <CardTitle>Global Rating Distribution</CardTitle>
-              <CardDescription>How users are voting across all tools</CardDescription>
+              <CardTitle>{t("analytics.globalRatingDistribution")}</CardTitle>
+              <CardDescription>{t("analytics.globalRatingDistributionSub")}</CardDescription>
             </CardHeader>
             <CardContent>
               {loadingDistribution ? (
@@ -170,7 +176,7 @@ export default function Analytics() {
               ) : (
                 <div className="space-y-5">
                   <div>
-                    <span className="text-xs font-semibold text-muted-foreground uppercase tracking-wider mb-2 block">Usefulness</span>
+                    <span className="text-xs font-semibold text-muted-foreground uppercase tracking-wider mb-2 block">{t("detail.usefulness")}</span>
                     <div className="h-[110px] w-full">
                       <ResponsiveContainer width="100%" height="100%">
                         <BarChart data={usefulnessData} margin={{ top: 4, right: 8, left: -20, bottom: 0 }}>
@@ -184,7 +190,7 @@ export default function Analytics() {
                     </div>
                   </div>
                   <div>
-                    <span className="text-xs font-semibold text-muted-foreground uppercase tracking-wider mb-2 block">Usability</span>
+                    <span className="text-xs font-semibold text-muted-foreground uppercase tracking-wider mb-2 block">{t("detail.usability")}</span>
                     <div className="h-[110px] w-full">
                       <ResponsiveContainer width="100%" height="100%">
                         <BarChart data={usabilityData} margin={{ top: 4, right: 8, left: -20, bottom: 0 }}>

artifacts/toolrate/src/pages/compare.tsx

@@ -8,6 +8,7 @@ import { Link, useSearch } from "wouter";
 import { Layout } from "@/components/layout";
 import { useAuth } from "@/hooks/use-auth";
 import { RatingStars } from "@/components/rating-stars";
+import { GuideHelp } from "@/components/guide-help";
 import { Badge } from "@/components/ui/badge";
 import { Button } from "@/components/ui/button";
 import { Skeleton } from "@/components/ui/skeleton";
@@ -101,7 +102,10 @@ export default function Compare() {
     <Layout>
       <div className="space-y-6 pb-10">
         <div>
-          <h1 className="text-3xl font-bold tracking-tight mb-2">{t("compare.title")}</h1>
+          <h1 className="text-3xl font-bold tracking-tight mb-2 flex items-center gap-2">
+            {t("compare.title")}
+            <GuideHelp guide="vergleichen" label={t("compare.title")} />
+          </h1>
           <p className="text-muted-foreground">{t("compare.subtitle", { count: list.length })}</p>
         </div>
 
@@ -141,7 +145,7 @@ export default function Compare() {
                   ))}
                 </TableRow>
                 <TableRow>
-                  <TableCell className="font-medium">Usefulness</TableCell>
+                  <TableCell className="font-medium">{t("detail.usefulness")}</TableCell>
                   {list.map((t) => (
                     <TableCell key={t.id} className={cn(isBest(t.avgUsefulness, bestUsefulness) && "bg-primary/5")}>
                       <span className="tabular-nums">{fmt(t.avgUsefulness)}/5</span>
@@ -149,7 +153,7 @@ export default function Compare() {
                   ))}
                 </TableRow>
                 <TableRow>
-                  <TableCell className="font-medium">Usability</TableCell>
+                  <TableCell className="font-medium">{t("detail.usability")}</TableCell>
                   {list.map((t) => (
                     <TableCell key={t.id} className={cn(isBest(t.avgUsability, bestUsability) && "bg-primary/5")}>
                       <span className="tabular-nums">{fmt(t.avgUsability)}/5</span>
@@ -173,7 +177,7 @@ export default function Compare() {
                   ))}
                 </TableRow>
                 <TableRow>
-                  <TableCell className="font-medium">Features</TableCell>
+                  <TableCell className="font-medium">{t("filter.features")}</TableCell>
                   {list.map((t) => (
                     <TableCell key={t.id} className="align-top">
                       <div className="flex flex-wrap gap-1">
@@ -186,7 +190,7 @@ export default function Compare() {
                   ))}
                 </TableRow>
                 <TableRow>
-                  <TableCell className="font-medium">Tags</TableCell>
+                  <TableCell className="font-medium">{t("filter.tags")}</TableCell>
                   {list.map((t) => (
                     <TableCell key={t.id} className="align-top">
                       <div className="flex flex-wrap gap-1">

artifacts/toolrate/src/pages/docs.tsx

@@ -1,13 +1,14 @@
-import { useEffect, useMemo, useState } from "react";
+import { useEffect, useMemo, useState, createContext, useContext } from "react";
 import { Link, useLocation } from "wouter";
 import { Marked } from "marked";
 import DOMPurify from "dompurify";
 import { useTranslation } from "react-i18next";
-import { Layout } from "@/components/layout";
 import { Skeleton } from "@/components/ui/skeleton";
 import { Badge } from "@/components/ui/badge";
 import { Input } from "@/components/ui/input";
 import { Button } from "@/components/ui/button";
+import { ThemeToggle } from "@/components/theme-toggle";
+import { LanguageSwitcher } from "@/components/language-switcher";
 import {
   Select,
   SelectContent,
@@ -15,8 +16,15 @@ import {
   SelectTrigger,
   SelectValue,
 } from "@/components/ui/select";
+import {
+  Sheet,
+  SheetContent,
+  SheetTitle,
+  SheetTrigger,
+} from "@/components/ui/sheet";
 import { useGetVersion, getGetVersionQueryKey } from "@workspace/api-client-react";
 import {
+  ArrowLeft,
   BookOpen,
   CalendarDays,
   ExternalLink,
@@ -24,15 +32,46 @@ import {
   GitBranch,
   HelpCircle,
   Library,
+  Menu,
   Search,
   Server,
   Tag,
+  Wrench,
   type LucideIcon,
 } from "lucide-react";
 
 const DOCS_BASE = `${import.meta.env.BASE_URL.replace(/\/$/, "")}/docs`;
 const REPO_URL = "https://git.kubebase.de/admin/tool-evaluator";
 
+// Active docs version (null = current docs). Shared via context so every
+// sub-view builds versioned links and file paths.
+const DocsVersionContext = createContext<string | null>(null);
+const useDocsVersion = () => useContext(DocsVersionContext);
+
+// Full in-app URL for a docs path, prefixed with the active version.
+function docsHref(version: string | null, path: string) {
+  return version === null ? `/docs/${path}` : `/docs/${version}/${path}`;
+}
+
+// Static file path under /docs, prefixed with the versioned snapshot dir.
+function docsFile(version: string | null, relPath: string) {
+  return version === null ? relPath : `versions/${version}/${relPath}`;
+}
+
+// Prefer the English file/title variant when the active UI language is English.
+function useDocsLocale() {
+  const { i18n } = useTranslation();
+  return (i18n.language ?? "en").toLowerCase().startsWith("en") ? "en" : "de";
+}
+
+function localizedFile(file: string, fileEn: string | null, locale: "en" | "de"): string {
+  return locale === "en" && fileEn ? fileEn : file;
+}
+
+function localizedTitle(title: string, titleEn: string | null, locale: "en" | "de"): string {
+  return locale === "en" && titleEn ? titleEn : title;
+}
+
 // ---------------------------------------------------------------------------
 // Types
 // ---------------------------------------------------------------------------
@@ -76,12 +115,22 @@ type Reference = { tags: TagGroup[]; schemas: SchemaModel[] };
 type ReleaseDoc = {
   version: string;
   file: string;
+  fileEn: string | null;
   title: string;
+  titleEn: string | null;
   date: string | null;
   hasReference: boolean;
+  hasHandbook: boolean;
 };
 
-type HandbookPage = { slug: string; file: string; title: string; order: number };
+type HandbookPage = {
+  slug: string;
+  file: string;
+  fileEn: string | null;
+  title: string;
+  titleEn: string | null;
+  order: number;
+};
 
 type SearchEntry = { title: string; href: string; kind: string; text: string };
 
@@ -221,8 +270,11 @@ function isLinkableType(t: FieldType): boolean {
 }
 
 function resolveTypeHref(t: FieldType): string | null {
-  if (t.kind === "ref") return `/docs/reference/schemas/${t.value}`;
-  if (t.kind === "array" && /^[A-Z]/.test(t.value)) return `/docs/reference/schemas/${t.value}`;
+  const version = useDocsVersion();
+  const href = (v: string | null) =>
+    v === null ? `/docs/reference/schemas/${t.value}` : `/docs/${v}/reference/schemas/${t.value}`;
+  if (t.kind === "ref") return href(version);
+  if (t.kind === "array" && /^[A-Z]/.test(t.value)) return href(version);
   return null;
 }
 
@@ -311,6 +363,7 @@ function DocsNav({
 }) {
   const [location] = useLocation();
   const { t } = useTranslation();
+  const locale = useDocsLocale();
 
   const navLink = (href: string) => {
     const active = location === href || (href !== "/docs" && location.startsWith(href));
@@ -319,14 +372,14 @@ function DocsNav({
 
   const groups: { label: string; icon: LucideIcon; items: { href: string; label: string; active: boolean }[] }[] = [];
 
-  if (handbook && handbook.length > 0 && version === null) {
+  if (handbook && handbook.length > 0) {
     groups.push({
       label: t("docs.guides"),
       icon: BookOpen,
       items: handbook.map((p) => ({
-        href: `/docs/handbook/${p.slug}`,
-        label: p.title,
-        active: navLink(`/docs/handbook/${p.slug}`),
+        href: docsHref(version, `handbook/${p.slug}`),
+        label: localizedTitle(p.title, p.titleEn, locale),
+        active: navLink(docsHref(version, `handbook/${p.slug}`)),
       })),
     });
   }
@@ -336,18 +389,18 @@ function DocsNav({
       label: t("docs.endpoints"),
       icon: Server,
       items: reference.tags.map((tag) => ({
-        href: `/docs/reference/endpoints/${tag.name}`,
+        href: docsHref(version, `reference/endpoints/${tag.name}`),
         label: tag.name,
-        active: navLink(`/docs/reference/endpoints/${tag.name}`),
+        active: navLink(docsHref(version, `reference/endpoints/${tag.name}`)),
       })),
     });
     groups.push({
       label: t("docs.schemas"),
       icon: Library,
       items: reference.schemas.map((s) => ({
-        href: `/docs/reference/schemas/${s.name}`,
+        href: docsHref(version, `reference/schemas/${s.name}`),
         label: s.name,
-        active: navLink(`/docs/reference/schemas/${s.name}`),
+        active: navLink(docsHref(version, `reference/schemas/${s.name}`)),
       })),
     });
   }
@@ -356,9 +409,7 @@ function DocsNav({
     label: t("docs.releases"),
     icon: Tag,
     items: versions.map((v) => ({
-      href: v.version === (version ?? versions[0]?.version) && version !== null
-        ? `/docs/releases/${v.version}`
-        : `/docs/releases/${v.version}`,
+      href: `/docs/releases/${v.version}`,
       label: v.version,
       active: navLink(`/docs/releases/${v.version}`),
     })),
@@ -485,15 +536,16 @@ function FieldTypeChip({ type }: { type: FieldType }) {
 }
 
 function FieldTable({ fields }: { fields: Field[] }) {
+  const { t } = useTranslation();
   return (
     <div className="overflow-x-auto rounded-lg border">
       <table className="w-full text-sm">
         <thead>
           <tr className="border-b bg-muted/50 text-left text-xs uppercase tracking-wider text-muted-foreground">
-            <th className="px-3 py-2 font-semibold">Feld</th>
-            <th className="px-3 py-2 font-semibold">Typ</th>
-            <th className="px-3 py-2 font-semibold">Pflicht</th>
-            <th className="px-3 py-2 font-semibold">Beschreibung</th>
+            <th className="px-3 py-2 font-semibold">{t("docs.field")}</th>
+            <th className="px-3 py-2 font-semibold">{t("docs.type")}</th>
+            <th className="px-3 py-2 font-semibold">{t("docs.required")}</th>
+            <th className="px-3 py-2 font-semibold">{t("docs.description")}</th>
           </tr>
         </thead>
         <tbody>
@@ -509,7 +561,7 @@ function FieldTable({ fields }: { fields: Field[] }) {
               </td>
               <td className="px-3 py-2">
                 {f.required ? (
-                  <Badge className="bg-primary/10 text-primary border-primary/20">required</Badge>
+                  <Badge className="bg-primary/10 text-primary border-primary/20">{t("docs.required")}</Badge>
                 ) : (
                   <span className="text-muted-foreground">–</span>
                 )}
@@ -529,6 +581,7 @@ function FieldTable({ fields }: { fields: Field[] }) {
 }
 
 function SchemaView({ schema }: { schema: SchemaModel }) {
+  const { t } = useTranslation();
   const headings: Heading[] = schema.fields.map((f) => ({ id: f.name, text: f.name, level: 2 }));
   return (
     <div className="flex flex-col lg:flex-row gap-8">
@@ -540,15 +593,16 @@ function SchemaView({ schema }: { schema: SchemaModel }) {
         <FieldTable fields={schema.fields} />
         <p className="text-xs text-muted-foreground">
           <HelpCircle className="h-3.5 w-3.5 inline mr-1" />
-          Hinweis: Formular-Felder verlinken per ?-Icon direkt zu den jeweiligen Zeilen dieser Tabelle.
+          {t("docs.fieldHelpHint")}
         </p>
       </div>
-      <Toc headings={headings} title="Felder" />
+      <Toc headings={headings} title={t("docs.fields")} />
     </div>
   );
 }
 
 function EndpointTagView({ tag }: { tag: TagGroup }) {
+  const { t } = useTranslation();
   const headings: Heading[] = tag.endpoints.map((e) => ({
     id: e.operationId,
     text: `${e.method} ${e.path}`,
@@ -577,16 +631,16 @@ function EndpointTagView({ tag }: { tag: TagGroup }) {
 
             {ep.parameters.length > 0 && (
               <div className="mb-3">
-                <p className="mb-1 text-xs font-semibold uppercase tracking-wider text-muted-foreground">Parameter</p>
+                <p className="mb-1 text-xs font-semibold uppercase tracking-wider text-muted-foreground">{t("docs.parameter")}</p>
                 <div className="overflow-x-auto rounded-lg border">
                   <table className="w-full text-sm">
                     <thead>
                       <tr className="border-b bg-muted/50 text-left text-xs uppercase tracking-wider text-muted-foreground">
-                        <th className="px-3 py-2 font-semibold">Name</th>
-                        <th className="px-3 py-2 font-semibold">In</th>
-                        <th className="px-3 py-2 font-semibold">Typ</th>
-                        <th className="px-3 py-2 font-semibold">Pflicht</th>
-                        <th className="px-3 py-2 font-semibold">Beschreibung</th>
+                        <th className="px-3 py-2 font-semibold">{t("docs.name")}</th>
+                        <th className="px-3 py-2 font-semibold">{t("docs.in")}</th>
+                        <th className="px-3 py-2 font-semibold">{t("docs.type")}</th>
+                        <th className="px-3 py-2 font-semibold">{t("docs.required")}</th>
+                        <th className="px-3 py-2 font-semibold">{t("docs.description")}</th>
                       </tr>
                     </thead>
                     <tbody>
@@ -596,7 +650,7 @@ function EndpointTagView({ tag }: { tag: TagGroup }) {
                           <td className="px-3 py-1.5 text-muted-foreground">{p.in}</td>
                           <td className="px-3 py-1.5"><FieldTypeChip type={p.type} /></td>
                           <td className="px-3 py-1.5">
-                            {p.required ? <Badge className="bg-primary/10 text-primary border-primary/20">req</Badge> : "–"}
+                            {p.required ? <Badge className="bg-primary/10 text-primary border-primary/20">{t("docs.required")}</Badge> : "–"}
                           </td>
                           <td className="px-3 py-1.5 text-muted-foreground">
                             {p.description}
@@ -613,7 +667,7 @@ function EndpointTagView({ tag }: { tag: TagGroup }) {
             {ep.requestBody && (
               <div className="mb-3 rounded-lg border bg-muted/30 p-3">
                 <p className="mb-1 text-xs font-semibold uppercase tracking-wider text-muted-foreground">
-                  Request Body {ep.requestBody.required && <Badge className="ml-1">required</Badge>}
+                  {t("docs.requestBody")} {ep.requestBody.required && <Badge className="ml-1">{t("docs.required")}</Badge>}
                 </p>
                 <FieldTypeChip type={ep.requestBody.schema} />
               </div>
@@ -623,9 +677,9 @@ function EndpointTagView({ tag }: { tag: TagGroup }) {
               <table className="w-full text-sm">
                 <thead>
                   <tr className="border-b bg-muted/50 text-left text-xs uppercase tracking-wider text-muted-foreground">
-                    <th className="px-3 py-2 font-semibold">Status</th>
-                    <th className="px-3 py-2 font-semibold">Beschreibung</th>
-                    <th className="px-3 py-2 font-semibold">Schema</th>
+                    <th className="px-3 py-2 font-semibold">{t("docs.status")}</th>
+                    <th className="px-3 py-2 font-semibold">{t("docs.description")}</th>
+                    <th className="px-3 py-2 font-semibold">{t("docs.schema")}</th>
                   </tr>
                 </thead>
                 <tbody>
@@ -642,7 +696,7 @@ function EndpointTagView({ tag }: { tag: TagGroup }) {
           </section>
         ))}
       </div>
-      <Toc headings={headings} title="Endpunkte" />
+      <Toc headings={headings} title={t("docs.endpoints")} />
     </div>
   );
 }
@@ -650,6 +704,7 @@ function EndpointTagView({ tag }: { tag: TagGroup }) {
 function ReleasesView({ versions }: { versions: ReleaseDoc[] }) {
   const [, setLocation] = useLocation();
   const { t } = useTranslation();
+  const locale = useDocsLocale();
   return (
     <div className="flex flex-col lg:flex-row gap-8">
       <div className="flex-1 min-w-0 max-w-3xl space-y-4">
@@ -668,7 +723,7 @@ function ReleasesView({ versions }: { versions: ReleaseDoc[] }) {
               <FileText className="h-4 w-4 shrink-0 text-primary" />
               <div className="min-w-0 flex-1">
                 <div className="flex items-center gap-2">
-                  <span className="font-semibold">{v.title}</span>
+                  <span className="font-semibold">{localizedTitle(v.title, v.titleEn, locale)}</span>
                   <Badge variant="secondary">{v.version}</Badge>
                 </div>
                 {v.date && (
@@ -678,7 +733,7 @@ function ReleasesView({ versions }: { versions: ReleaseDoc[] }) {
                   </span>
                 )}
               </div>
-              {v.hasReference && <Badge className="bg-primary/10 text-primary">API-Referenz</Badge>}
+              {v.hasReference && <Badge className="bg-primary/10 text-primary">{t("docs.reference")}</Badge>}
             </button>
           ))}
         </div>
@@ -688,7 +743,9 @@ function ReleasesView({ versions }: { versions: ReleaseDoc[] }) {
   );
 }
 
-function ReleaseNoteView({ version }: { version: string }) {
+function ReleaseNoteView({ version, doc }: { version: string; doc: ReleaseDoc | null }) {
+  const locale = useDocsLocale();
+  const file = doc ? `releases/${localizedFile(doc.file, doc.fileEn, locale)}` : `releases/${version}.md`;
   return (
     <div className="flex flex-col lg:flex-row gap-8">
       <div className="flex-1 min-w-0 max-w-3xl">
@@ -696,7 +753,7 @@ function ReleaseNoteView({ version }: { version: string }) {
           <Tag className="h-4 w-4" />
           <span className="font-mono">{version}</span>
           <a
-            href={`${REPO_URL}/tags/${version}`}
+            href={`${REPO_URL}/releases/tag/${version}`}
             target="_blank"
             rel="noreferrer"
             className="inline-flex items-center gap-1 hover:text-foreground"
@@ -704,15 +761,20 @@ function ReleaseNoteView({ version }: { version: string }) {
             <ExternalLink className="h-3.5 w-3.5" />
           </a>
         </div>
-        <MarkdownView file={`releases/${version}.md`} />
+        <MarkdownView file={file} />
       </div>
     </div>
   );
 }
 
-function HandbookView({ slug }: { slug: string }) {
-  const handbookFile = `${slug}.md`;
-  return <MarkdownView file={`handbook/${handbookFile}`} />;
+function HandbookView({ slug, pages }: { slug: string; pages: HandbookPage[] | null }) {
+  const version = useDocsVersion();
+  const locale = useDocsLocale();
+  const page = pages?.find((p) => p.slug === slug);
+  const file = page
+    ? docsFile(version, `handbook/${localizedFile(page.file, page.fileEn, locale)}`)
+    : docsFile(version, `handbook/${slug}.md`);
+  return <MarkdownView file={file} />;
 }
 
 // ---------------------------------------------------------------------------
@@ -720,7 +782,9 @@ function HandbookView({ slug }: { slug: string }) {
 // ---------------------------------------------------------------------------
 
 function useDocsSearch(query: string) {
-  const { data, error } = useJson<SearchEntry[]>(query ? `${DOCS_BASE}/search.json` : null);
+  const locale = useDocsLocale();
+  const indexFile = locale === "en" ? "search.en.json" : "search.json";
+  const { data, error } = useJson<SearchEntry[]>(query ? `${DOCS_BASE}/${indexFile}` : null);
   const results = useMemo(() => {
     if (!query.trim() || !data) return [];
     const q = query.trim().toLowerCase();
@@ -737,12 +801,13 @@ function useDocsSearch(query: string) {
 }
 
 function SearchOverlay({ query, onClose }: { query: string; onClose: () => void }) {
+  const { t } = useTranslation();
   const { results } = useDocsSearch(query);
   if (!query.trim()) return null;
   return (
     <div className="mt-3 rounded-lg border bg-card p-2 shadow-md max-h-96 overflow-auto">
       {results.length === 0 ? (
-        <p className="px-3 py-2 text-sm text-muted-foreground">Keine Treffer</p>
+        <p className="px-3 py-2 text-sm text-muted-foreground">{t("docs.noResults")}</p>
       ) : (
         results.map((r) => (
           <Link
@@ -776,6 +841,12 @@ export default function Docs() {
   const [location, setLocation] = useLocation();
   const { t } = useTranslation();
   const [searchQuery, setSearchQuery] = useState("");
+  const [navOpen, setNavOpen] = useState(false);
+
+  // Close the mobile nav drawer after navigating.
+  useEffect(() => {
+    setNavOpen(false);
+  }, [location]);
 
   const { version, path } = useMemo(() => parseDocsPath(location), [location]);
 
@@ -784,9 +855,11 @@ export default function Docs() {
   });
 
   const { data: releases, error: releasesError } = useJson<ReleaseDoc[]>(`${DOCS_BASE}/index.json`);
-  const { data: handbook, error: handbookError } = useJson<HandbookPage[]>(
-    version === null ? `${DOCS_BASE}/handbook/index.json` : null,
-  );
+
+  const activeRelease = releases?.find((r) => r.version === version) ?? null;
+  const handbookAvailable = version === null || activeRelease?.hasHandbook;
+  const handbookUrl = handbookAvailable ? `${DOCS_BASE}/${docsFile(version, "handbook/index.json")}` : null;
+  const { data: handbook, error: handbookError } = useJson<HandbookPage[]>(handbookUrl);
 
   const isCurrentVersion =
     version === null ||
@@ -795,7 +868,7 @@ export default function Docs() {
 
   const refUrl = version === null
     ? `${DOCS_BASE}/reference.json`
-    : releases?.find((r) => r.version === version)?.hasReference
+    : activeRelease?.hasReference
       ? `${DOCS_BASE}/versions/${version}.json`
       : null;
 
@@ -813,43 +886,52 @@ export default function Docs() {
     return null;
   }, [releases, versionInfo]);
 
-  // Redirect old-style /docs/vX.Y.Z to /docs/releases/vX.Y.Z
-  useEffect(() => {
-    if (version !== null && path.length === 0) {
-      setLocation(`/docs/releases/${version}`, { replace: true });
-    }
-  }, [version, path, setLocation]);
-
   const handleVersionChange = (v: string | null) => {
     setSearchQuery("");
     if (v === null || v === currentVersion) {
       setLocation("/docs");
       return;
     }
-    setLocation(`/docs/releases/${v}`);
+    setLocation(`/docs/${v}`);
   };
 
   // ---- route resolution ----
   const section = path[0] ?? "home";
   const param = path[1];
 
+  // Version shown in the header dropdown: an explicit first-segment version
+  // (/docs/vX.Y.Z) or the releases route (/docs/releases/vX.Y.Z).
+  const headerVersion =
+    version !== null
+      ? version
+      : section === "releases" && param
+        ? param
+        : null;
+
   let content: React.ReactNode = null;
 
   if (version !== null && path.length === 0) {
-    content = <ReleaseNoteView version={version} />;
+    content =
+      handbook && handbook.length > 0 ? (
+        <HandbookView slug={handbook[0].slug} pages={handbook} />
+      ) : (
+        <ReleaseNoteView version={version} doc={activeRelease} />
+      );
   } else if (section === "home") {
     content =
       handbook && handbook.length > 0 ? (
-        <HandbookView slug={handbook[0].slug} />
+        <HandbookView slug={handbook[0].slug} pages={handbook} />
       ) : releases && releases.length > 0 ? (
         <ReleasesView versions={releases} />
       ) : (
         <p className="text-sm text-muted-foreground">{t("docs.noDocs")}</p>
       );
   } else if (section === "handbook" && param) {
-    content = <HandbookView slug={param} />;
+    content = <HandbookView slug={param} pages={handbook} />;
   } else if (section === "reference" && param === "endpoints" && path[2]) {
-    const tag = reference?.tags.find((tg) => tg.name === path[2]);
+    const tag = reference?.tags.find(
+      (tg) => tg.name.toLowerCase() === path[2].toLowerCase(),
+    );
     content = tag ? (
       <EndpointTagView tag={tag} />
     ) : refError || (reference && !tag) ? (
@@ -858,7 +940,9 @@ export default function Docs() {
       <Skeleton className="h-64 w-full" />
     );
   } else if (section === "reference" && param === "schemas" && path[2]) {
-    const schema = reference?.schemas.find((s) => s.name === path[2]);
+    const schema = reference?.schemas.find(
+      (s) => s.name.toLowerCase() === path[2].toLowerCase(),
+    );
     content = schema ? (
       <SchemaView schema={schema} />
     ) : refError || (reference && !schema) ? (
@@ -881,7 +965,7 @@ export default function Docs() {
                   {reference.tags.map((tg) => (
                     <Link
                       key={tg.name}
-                      href={`/docs/reference/endpoints/${tg.name}`}
+                      href={docsHref(version, `reference/endpoints/${tg.name}`)}
                       className="rounded-lg border p-3 text-sm hover:bg-accent/50"
                     >
                       <span className="font-medium">{tg.name}</span>
@@ -898,7 +982,7 @@ export default function Docs() {
                   {reference.schemas.map((s) => (
                     <Link
                       key={s.name}
-                      href={`/docs/reference/schemas/${s.name}`}
+                      href={docsHref(version, `reference/schemas/${s.name}`)}
                       className="rounded-lg border p-3 text-sm font-mono hover:bg-accent/50"
                     >
                       {s.name}
@@ -913,7 +997,7 @@ export default function Docs() {
       </div>
     );
   } else if (section === "releases" && param) {
-    content = <ReleaseNoteView version={param} />;
+    content = <ReleaseNoteView version={param} doc={releases?.find((r) => r.version === param) ?? null} />;
   } else if (section === "releases") {
     content = releases ? <ReleasesView versions={releases} /> : <Skeleton className="h-64 w-full" />;
   } else {
@@ -923,11 +1007,57 @@ export default function Docs() {
   const showSearch = version === null && section !== "releases";
 
   return (
-    <Layout>
-      <div className="mx-auto max-w-6xl space-y-6 pb-10">
+    <DocsVersionContext.Provider value={version}>
+      <div className="min-h-screen bg-background flex flex-col">
+        <header className="border-b bg-card shrink-0">
+          <div className="mx-auto max-w-6xl px-4 md:px-6 h-14 flex items-center justify-between gap-3">
+            <div className="flex items-center gap-1 min-w-0">
+              <Sheet open={navOpen} onOpenChange={setNavOpen}>
+                <SheetTrigger asChild>
+                  <Button
+                    variant="ghost"
+                    size="icon"
+                    className="lg:hidden -ml-1 shrink-0"
+                    title={t("docs.nav")}
+                    data-testid="button-docs-nav-mobile"
+                  >
+                    <Menu className="h-5 w-5" />
+                  </Button>
+                </SheetTrigger>
+                <SheetContent side="left" className="w-80 overflow-y-auto p-4">
+                  <SheetTitle className="sr-only">{t("docs.nav")}</SheetTitle>
+                  <DocsNav
+                    version={version}
+                    handbook={handbook}
+                    reference={reference}
+                    versions={releases ?? []}
+                  />
+                </SheetContent>
+              </Sheet>
+              <Link
+                href="/"
+                className="inline-flex items-center gap-2 text-primary font-bold text-lg min-w-0"
+                data-testid="link-docs-back"
+              >
+                <Wrench className="w-5 h-5 shrink-0" />
+                <span className="truncate">toolr</span>
+                <span className="hidden md:inline-flex items-center gap-1 text-xs font-normal text-muted-foreground border-l pl-2 ml-1">
+                  <ArrowLeft className="w-3.5 h-3.5" />
+                  {t("docs.backToApp")}
+                </span>
+              </Link>
+            </div>
+            <div className="flex items-center gap-1.5 shrink-0">
+              <LanguageSwitcher />
+              <ThemeToggle />
+            </div>
+          </div>
+        </header>
+
+        <div className="mx-auto max-w-6xl w-full flex-1 space-y-6 px-4 md:px-6 py-6 pb-12">
           <DocsHeader
             versions={releases ?? []}
-          activeVersion={version}
+            activeVersion={headerVersion}
             onVersionChange={handleVersionChange}
             onSearchChange={showSearch ? setSearchQuery : undefined}
           />
@@ -948,6 +1078,7 @@ export default function Docs() {
             <div className="min-w-0">{content}</div>
           </div>
         </div>
-    </Layout>
+      </div>
+    </DocsVersionContext.Provider>
   );
 }

artifacts/toolrate/src/pages/redundancy.tsx

@@ -1,4 +1,5 @@
 import { useState, useEffect } from "react";
+import { useTranslation } from "react-i18next";
 import { Layout } from "@/components/layout";
 import { Card, CardContent } from "@/components/ui/card";
 import { Badge } from "@/components/ui/badge";
@@ -11,6 +12,7 @@ import { customFetch } from "@workspace/api-client-react";
 import { useToast } from "@/hooks/use-toast";
 
 export default function RedundancyPage() {
+  const { t } = useTranslation();
   const [data, setData] = useState<any[] | null>(null);
   const [loading, setLoading] = useState(true);
   const { toast } = useToast();
@@ -28,10 +30,10 @@ export default function RedundancyPage() {
         method: "POST",
         body: JSON.stringify({ toolId, relatedToolId, betterToolId }),
       });
-      toast({ title: "Evaluation saved" });
+      toast({ title: t("redundancy.toastEvalSaved") });
       setData(await customFetch<any[]>("/api/admin/redundancy"));
     } catch {
-      toast({ title: "Failed to save evaluation", variant: "destructive" });
+      toast({ title: t("redundancy.toastEvalFailed"), variant: "destructive" });
     }
   }
 
@@ -44,10 +46,10 @@ export default function RedundancyPage() {
       <div className="space-y-6">
         <div className="flex items-center gap-3">
           <AlertTriangle className="w-6 h-6 text-amber-500" />
-          <h1 className="text-3xl font-bold">Tool Analysis & Recommendations</h1>
+          <h1 className="text-3xl font-bold">{t("redundancy.title")}</h1>
         </div>
         <p className="text-muted-foreground">
-          Automatic redundancy detection with cost and rating comparison. Admin can manually confirm which tool is the better choice.
+          {t("redundancy.subtitle")}
         </p>
 
         {loading ? (
@@ -61,12 +63,12 @@ export default function RedundancyPage() {
                 <div className="flex items-center justify-between mb-4">
                   <div>
                     <h2 className="text-xl font-semibold capitalize">{group.category}</h2>
-                    <p className="text-xs text-muted-foreground mt-0.5">{group.tools.length} tools, {group.pairs.length} comparisons</p>
+                    <p className="text-xs text-muted-foreground mt-0.5">{t("redundancy.toolsComparisons", { tools: group.tools.length, pairs: group.pairs.length })}</p>
                   </div>
                   {group.totalMonthlyCost > 0 && (
                     <span className="text-xs text-muted-foreground flex items-center gap-1">
                       <DollarSign className="w-3 h-3" />
-                      {group.totalMonthlyCost.toFixed(2)}/mo total
+                      {group.totalMonthlyCost.toFixed(2)}{t("redundancy.totalMonthly")}
                     </span>
                   )}
                 </div>
@@ -82,12 +84,12 @@ export default function RedundancyPage() {
                                 <span className="font-medium">{tool.name}</span>
                                 {tool.costs?.length > 0 && tool.totalMonthly > 0 && (
                                   <Badge variant="outline" className="text-[10px] px-1 py-0 shrink-0">
-                                    {tool.totalMonthly.toFixed(2)}/mo
+                                    {tool.totalMonthly.toFixed(2)}{t("redundancy.perMonth")}
                                   </Badge>
                                 )}
                               </div>
                               <div className="flex items-center gap-2 mt-1 text-xs text-muted-foreground flex-wrap">
-                                <span>{tool.ratingCount} reviews</span>
+                                <span>{tool.ratingCount} {t("redundancy.reviews")}</span>
                                 {tool.avgCombined != null && (
                                   <>
                                     <span>·</span>
@@ -104,7 +106,7 @@ export default function RedundancyPage() {
                                 ))}
                               </div>
                             </div>
-                            <Badge variant="outline" className="shrink-0">{tool.features.length} features</Badge>
+                            <Badge variant="outline" className="shrink-0">{tool.features.length} {t("redundancy.features")}</Badge>
                           </div>
                         </CardContent>
                       </Card>
@@ -114,7 +116,7 @@ export default function RedundancyPage() {
 
                 {group.pairs.length > 0 && (
                   <div className="space-y-3">
-                    <h3 className="text-sm font-medium text-muted-foreground">Comparisons & Recommendations</h3>
+                    <h3 className="text-sm font-medium text-muted-foreground">{t("redundancy.comparisonsTitle")}</h3>
                     {group.pairs.map((pair: any, i: number) => (
                       <Card key={i} className={pair.recommendation.certainty === "high" ? "border-green-300" : pair.recommendation.certainty === "medium" ? "border-amber-200" : ""}>
                         <CardContent className="p-4">
@@ -126,11 +128,11 @@ export default function RedundancyPage() {
                                 </span>
                                 <span className="text-[10px] text-muted-foreground">
                                   {pair.a.avgCombined != null ? pair.a.avgCombined.toFixed(1) : "N/A"} ★
-                                  {pair.a.totalMonthly > 0 ? ` · ${pair.a.totalMonthly.toFixed(2)}/mo` : ""}
+                                  {pair.a.totalMonthly > 0 ? ` · ${pair.a.totalMonthly.toFixed(2)}${t("redundancy.perMonth")}` : ""}
                                 </span>
                               </div>
                               <div className="text-center shrink-0">
-                                <div className="text-xs text-muted-foreground font-medium">vs</div>
+                                <div className="text-xs text-muted-foreground font-medium">{t("redundancy.vs")}</div>
                                 <div className="flex items-center gap-1 justify-center mt-0.5">
                                   <Progress value={pair.overlap} className="w-12 h-1.5" />
                                   <span className="text-[10px] text-muted-foreground">{pair.overlap}%</span>
@@ -142,7 +144,7 @@ export default function RedundancyPage() {
                                 </span>
                                 <span className="text-[10px] text-muted-foreground">
                                   {pair.b.avgCombined != null ? pair.b.avgCombined.toFixed(1) : "N/A"} ★
-                                  {pair.b.totalMonthly > 0 ? ` · ${pair.b.totalMonthly.toFixed(2)}/mo` : ""}
+                                  {pair.b.totalMonthly > 0 ? ` · ${pair.b.totalMonthly.toFixed(2)}${t("redundancy.perMonth")}` : ""}
                                 </span>
                               </div>
                             </div>
@@ -188,7 +190,7 @@ export default function RedundancyPage() {
             ))}
           </div>
         ) : (
-          <p className="text-muted-foreground py-8 text-center">No tools found.</p>
+          <p className="text-muted-foreground py-8 text-center">{t("redundancy.noTools")}</p>
         )}
       </div>
     </Layout>

artifacts/toolrate/src/pages/tool-detail.tsx

@@ -61,6 +61,7 @@ import {
 import { customFetch } from "@workspace/api-client-react";
 import { recordRecentTool } from "@/lib/recent-tools";
 import { FieldHelp } from "@/components/field-help";
+import { GuideHelp } from "@/components/guide-help";
 
 const ratingSchema = z.object({
   usefulness: z.number().min(1).max(5),
@@ -120,24 +121,24 @@ export default function ToolDetail() {
         method: "POST",
         body: JSON.stringify({ relatedToolId: Number(linkToolId), relationType: linkType, notes: linkNotes || undefined }),
       });
-      toast({ title: "Relation created" });
+      toast({ title: t("detail.toastRelationCreated") });
       setLinkDialogOpen(false);
       setLinkToolId("");
       setLinkNotes("");
       setLinkType("similar");
       setSimilarData(await customFetch<any>(`/api/tools/${id}/similar`));
     } catch (err: any) {
-      toast({ title: "Failed to create relation", description: err.data?.error ?? err.message, variant: "destructive" });
+      toast({ title: t("detail.toastRelationFailed"), description: err.data?.error ?? err.message, variant: "destructive" });
     }
   }
 
   async function handleDeleteRelation(relationId: number) {
     try {
       await customFetch(`/api/tools/relations/${relationId}`, { method: "DELETE" });
-      toast({ title: "Relation deleted" });
+      toast({ title: t("detail.toastRelationDeleted") });
       setSimilarData(await customFetch<any>(`/api/tools/${id}/similar`));
     } catch {
-      toast({ title: "Failed to delete relation", variant: "destructive" });
+      toast({ title: t("detail.toastRelationDeleteFailed"), variant: "destructive" });
     }
   }
 
@@ -162,12 +163,12 @@ export default function ToolDetail() {
     if (costAmount) body.cost = costAmount;
     try {
       await customFetch(url, { method, body: JSON.stringify(body) });
-      toast({ title: editCost ? "Cost updated" : "Cost added" });
+      toast({ title: editCost ? t("detail.toastCostUpdated") : t("detail.toastCostAdded") });
       setCostDialogOpen(false);
       resetCostForm();
       setCosts(await customFetch<any[]>(`/api/tools/${id}/costs`));
     } catch (err: any) {
-      toast({ title: "Failed to save cost", description: err.data?.error ?? err.message, variant: "destructive" });
+      toast({ title: t("detail.toastCostFailed"), description: err.data?.error ?? err.message, variant: "destructive" });
     }
   }
 
@@ -193,10 +194,10 @@ export default function ToolDetail() {
   async function handleDeleteCost(costId: number) {
     try {
       await customFetch(`/api/costs/${costId}`, { method: "DELETE" });
-      toast({ title: "Cost deleted" });
+      toast({ title: t("detail.toastCostDeleted") });
       setCosts(await customFetch<any[]>(`/api/tools/${id}/costs`));
     } catch {
-      toast({ title: "Failed to delete cost", variant: "destructive" });
+      toast({ title: t("detail.toastCostDeleteFailed"), variant: "destructive" });
     }
   }
 
@@ -236,8 +237,8 @@ export default function ToolDetail() {
     createRating.mutate({ id, data }, {
       onSuccess: () => {
         toast({
-          title: "Rating submitted",
-          description: "Thank you for your feedback!",
+          title: t("detail.toastRatingSubmitted"),
+          description: t("detail.toastRatingThanks"),
         });
         setIsReviewFormOpen(false);
         form.reset();
@@ -251,8 +252,8 @@ export default function ToolDetail() {
       },
       onError: (error) => {
         toast({
-          title: "Failed to submit rating",
-          description: error.data?.error || error.message || "An unexpected error occurred.",
+          title: t("detail.toastRatingFailed"),
+          description: error.data?.error || error.message || t("detail.unexpectedError"),
           variant: "destructive"
         });
       }
@@ -263,9 +264,9 @@ export default function ToolDetail() {
     return (
       <Layout>
         <div className="flex flex-col items-center justify-center py-20">
-          <h2 className="text-2xl font-bold">Invalid Tool ID</h2>
+          <h2 className="text-2xl font-bold">{t("detail.invalidToolId")}</h2>
           <Button variant="link" asChild className="mt-4">
-            <Link href="/tools"><ArrowLeft className="w-4 h-4 mr-2" /> Back to tools</Link>
+            <Link href="/tools"><ArrowLeft className="w-4 h-4 mr-2" /> {t("detail.backToBrowse")}</Link>
           </Button>
         </div>
       </Layout>
@@ -287,7 +288,7 @@ export default function ToolDetail() {
       { id },
       {
         onSuccess: () => {
-          toast({ title: "Tool deleted" });
+          toast({ title: t("detail.toastToolDeleted") });
           queryClient.invalidateQueries({ queryKey: getListToolsQueryKey() });
           queryClient.invalidateQueries({ queryKey: getListCategoriesQueryKey() });
           queryClient.invalidateQueries({ queryKey: getListAllFeaturesQueryKey() });
@@ -296,7 +297,7 @@ export default function ToolDetail() {
           setLocation("/tools");
         },
         onError: (err) => {
-          toast({ title: "Failed to delete", description: err.data?.error || err.message, variant: "destructive" });
+          toast({ title: t("detail.toastDeleteFailed"), description: err.data?.error || err.message, variant: "destructive" });
           setDeleteOpen(false);
         },
       },
@@ -308,7 +309,7 @@ export default function ToolDetail() {
     <Layout>
       <div className="space-y-6 max-w-5xl mx-auto pb-10">
         <Button variant="ghost" asChild className="mb-2 -ml-4 text-muted-foreground">
-          <Link href="/tools"><ArrowLeft className="w-4 h-4 mr-2" /> Back to browse</Link>
+          <Link href="/tools"><ArrowLeft className="w-4 h-4 mr-2" /> {t("detail.backToBrowse")}</Link>
         </Button>
 
         {/* Header Section */}
@@ -407,7 +408,7 @@ export default function ToolDetail() {
 
             {tool.features && tool.features.length > 0 && (
               <div className="pt-6 border-t">
-                <h3 className="text-lg font-semibold mb-3">Key Features</h3>
+                <h3 className="text-lg font-semibold mb-3">{t("detail.keyFeatures")}</h3>
                 <ul className="grid grid-cols-1 sm:grid-cols-2 gap-2">
                   {tool.features.map((feature, i) => (
                     <li key={i} className="flex items-start gap-2">
@@ -422,17 +423,17 @@ export default function ToolDetail() {
             )}
           </div>
         ) : (
-          <div className="text-center py-10">Tool not found.</div>
+          <div className="text-center py-10">{t("detail.toolNotFound")}</div>
         )}
 
         {/* Similar Tools Section */}
         {tool && (
           <div className="space-y-4 mt-8">
             <div className="flex items-center justify-between">
-              <h3 className="text-xl font-bold">Similar Tools</h3>
+              <h3 className="text-xl font-bold">{t("detail.similarTools")}</h3>
               {isAdmin && (
                 <Button variant="outline" size="sm" onClick={() => setLinkDialogOpen(true)} className="gap-2">
-                  <LinkIcon className="w-4 h-4" /> Link Tool
+                  <LinkIcon className="w-4 h-4" /> {t("detail.linkTool")}
                 </Button>
               )}
             </div>
@@ -500,7 +501,7 @@ export default function ToolDetail() {
                               </>
                             )}
                             <span>·</span>
-                            <span>Score: {item.score}</span>
+                            <span>{t("detail.score")}: {item.score}</span>
                           </div>
                         </div>
                       </CardContent>
@@ -509,7 +510,7 @@ export default function ToolDetail() {
                 ))}
               </div>
             ) : similarData && similarData.manual.length === 0 && similarData.auto.length === 0 ? (
-              <p className="text-sm text-muted-foreground py-4">No similar tools found.</p>
+              <p className="text-sm text-muted-foreground py-4">{t("detail.noSimilarTools")}</p>
             ) : null}
           </div>
         )}
@@ -518,44 +519,44 @@ export default function ToolDetail() {
         <Dialog open={linkDialogOpen} onOpenChange={setLinkDialogOpen}>
           <DialogContent>
             <DialogHeader>
-              <DialogTitle>Link Similar Tool</DialogTitle>
-              <DialogDescription>Manually link this tool to another tool.</DialogDescription>
+              <DialogTitle>{t("detail.linkSimilarTool")}</DialogTitle>
+              <DialogDescription>{t("detail.linkSimilarToolSub")}</DialogDescription>
             </DialogHeader>
             <div className="space-y-4 py-2">
               <div className="space-y-2">
-                <label className="text-sm font-medium">Tool ID</label>
+                <label className="text-sm font-medium">{t("detail.toolId")}</label>
                 <Input
                   type="number"
-                  placeholder="Enter target tool ID"
+                  placeholder={t("detail.toolIdPlaceholder")}
                   value={linkToolId}
                   onChange={(e) => setLinkToolId(e.target.value)}
                 />
               </div>
               <div className="space-y-2">
-                <label className="text-sm font-medium">Relation Type</label>
+                <label className="text-sm font-medium">{t("detail.relationType")}</label>
                 <Select value={linkType} onValueChange={setLinkType}>
                   <SelectTrigger>
                     <SelectValue />
                   </SelectTrigger>
                   <SelectContent>
-                    <SelectItem value="similar">Similar</SelectItem>
-                    <SelectItem value="replaces">Replaces</SelectItem>
-                    <SelectItem value="superseded_by">Superseded By</SelectItem>
+                    <SelectItem value="similar">{t("detail.relationSimilar")}</SelectItem>
+                    <SelectItem value="replaces">{t("detail.relationReplaces")}</SelectItem>
+                    <SelectItem value="superseded_by">{t("detail.relationSupersededBy")}</SelectItem>
                   </SelectContent>
                 </Select>
               </div>
               <div className="space-y-2">
-                <label className="text-sm font-medium">Notes (Optional)</label>
+                <label className="text-sm font-medium">{t("detail.notesOptional")}</label>
                 <Textarea
-                  placeholder="Why are these tools related?"
+                  placeholder={t("detail.notesPlaceholder")}
                   value={linkNotes}
                   onChange={(e) => setLinkNotes(e.target.value)}
                 />
               </div>
             </div>
             <DialogFooter>
-              <Button variant="outline" onClick={() => setLinkDialogOpen(false)}>Cancel</Button>
-              <Button onClick={handleCreateRelation} disabled={!linkToolId}>Create Link</Button>
+              <Button variant="outline" onClick={() => setLinkDialogOpen(false)}>{t("common.cancel")}</Button>
+              <Button onClick={handleCreateRelation} disabled={!linkToolId}>{t("detail.createLink")}</Button>
             </DialogFooter>
           </DialogContent>
         </Dialog>
@@ -586,7 +587,7 @@ export default function ToolDetail() {
                             {c.billingPeriod && <span className="text-[10px] text-muted-foreground uppercase">{c.billingPeriod}</span>}
                           </div>
                           <div className="text-lg font-bold">
-                            {c.cost != null ? `${c.cost} ${c.currency ?? ""}` : "Free"}
+                            {c.cost != null ? `${c.cost} ${c.currency ?? ""}` : t("detail.licenseFree")}
                           </div>
                           {c.notes && <p className="text-xs text-muted-foreground mt-1 italic">{c.notes}</p>}
                         </div>
@@ -606,7 +607,7 @@ export default function ToolDetail() {
                 ))}
               </div>
             ) : (
-              <p className="text-sm text-muted-foreground py-4">No cost information added yet.</p>
+              <p className="text-sm text-muted-foreground py-4">{t("detail.noCostInfo")}</p>
             )}
           </div>
         )}
@@ -615,42 +616,45 @@ export default function ToolDetail() {
         <Dialog open={costDialogOpen} onOpenChange={(o) => { if (!o) setCostDialogOpen(false); }}>
           <DialogContent>
             <DialogHeader>
-              <DialogTitle>{editCost ? t("detail.edit") + " " + t("detail.costs") : t("detail.addCost")}</DialogTitle>
-              <DialogDescription>Manage license cost information for this tool.</DialogDescription>
+              <DialogTitle className="flex items-center gap-2">
+                {editCost ? t("detail.edit") + " " + t("detail.costs") : t("detail.addCost")}
+                <GuideHelp guide="kosten" label={t("detail.costs")} />
+              </DialogTitle>
+              <DialogDescription>{t("detail.costDialogSub")}</DialogDescription>
             </DialogHeader>
             <div className="space-y-4 py-2">
               <div className="space-y-2">
-                <label className="text-sm font-medium">License Type</label>
+                <label className="text-sm font-medium">{t("detail.licenseType")}</label>
                 <Select value={costLicenseType} onValueChange={setCostLicenseType}>
                   <SelectTrigger><SelectValue /></SelectTrigger>
                   <SelectContent>
-                    <SelectItem value="free">Free</SelectItem>
-                    <SelectItem value="subscription">Subscription</SelectItem>
-                    <SelectItem value="one_time">One-Time</SelectItem>
-                    <SelectItem value="usage_based">Usage-Based</SelectItem>
+                    <SelectItem value="free">{t("detail.licenseFree")}</SelectItem>
+                    <SelectItem value="subscription">{t("detail.licenseSubscription")}</SelectItem>
+                    <SelectItem value="one_time">{t("detail.licenseOneTime")}</SelectItem>
+                    <SelectItem value="usage_based">{t("detail.licenseUsageBased")}</SelectItem>
                   </SelectContent>
                 </Select>
               </div>
               {costLicenseType === "subscription" && (
                 <div className="space-y-2">
-                  <label className="text-sm font-medium">Billing Period</label>
+                  <label className="text-sm font-medium">{t("detail.billingPeriod")}</label>
                   <Select value={costBillingPeriod} onValueChange={setCostBillingPeriod}>
                     <SelectTrigger><SelectValue /></SelectTrigger>
                     <SelectContent>
-                      <SelectItem value="monthly">Monthly</SelectItem>
-                      <SelectItem value="quarterly">Quarterly</SelectItem>
-                      <SelectItem value="yearly">Yearly</SelectItem>
+                      <SelectItem value="monthly">{t("detail.billingMonthly")}</SelectItem>
+                      <SelectItem value="quarterly">{t("detail.billingQuarterly")}</SelectItem>
+                      <SelectItem value="yearly">{t("detail.billingYearly")}</SelectItem>
                     </SelectContent>
                   </Select>
                 </div>
               )}
               <div className="grid grid-cols-2 gap-4">
                 <div className="space-y-2">
-                  <label className="text-sm font-medium">Cost</label>
+                  <label className="text-sm font-medium">{t("detail.costLabel")}</label>
                   <Input type="number" step="0.01" placeholder="0.00" value={costAmount} onChange={(e) => setCostAmount(e.target.value)} />
                 </div>
                 <div className="space-y-2">
-                  <label className="text-sm font-medium">Currency</label>
+                  <label className="text-sm font-medium">{t("detail.currency")}</label>
                   <Select value={costCurrency} onValueChange={setCostCurrency}>
                     <SelectTrigger><SelectValue /></SelectTrigger>
                     <SelectContent>
@@ -663,13 +667,13 @@ export default function ToolDetail() {
                 </div>
               </div>
               <div className="space-y-2">
-                <label className="text-sm font-medium">Notes</label>
-                <Textarea placeholder="Billing details, contract info..." value={costNotes} onChange={(e) => setCostNotes(e.target.value)} />
+                <label className="text-sm font-medium">{t("detail.costNotes")}</label>
+                <Textarea placeholder={t("detail.costNotesPlaceholder")} value={costNotes} onChange={(e) => setCostNotes(e.target.value)} />
               </div>
             </div>
             <DialogFooter>
-              <Button variant="outline" onClick={() => setCostDialogOpen(false)}>Cancel</Button>
-              <Button onClick={handleSaveCost}>Save</Button>
+              <Button variant="outline" onClick={() => setCostDialogOpen(false)}>{t("common.cancel")}</Button>
+              <Button onClick={handleSaveCost}>{t("common.save")}</Button>
             </DialogFooter>
           </DialogContent>
         </Dialog>
@@ -740,9 +744,9 @@ export default function ToolDetail() {
                           <YAxis domain={[0, 5]} tick={{ fill: 'hsl(var(--foreground))', fontSize: 12 }} axisLine={false} tickLine={false} />
                           <Tooltip labelFormatter={(_, payload) => (payload?.[0] ? format(new Date(payload[0].payload.date), "dd.MM.yyyy HH:mm") : "")} />
                           <Legend wrapperStyle={{ fontSize: 12 }} />
-                          <Line type="monotone" dataKey="combined" name="Combined" stroke="hsl(var(--primary))" strokeWidth={2} dot={false} />
-                          <Line type="monotone" dataKey="usefulness" name="Usefulness" stroke="hsl(var(--success))" strokeWidth={1.5} dot={false} strokeDasharray="4 3" />
-                          <Line type="monotone" dataKey="usability" name="Usability" stroke="hsl(var(--warning))" strokeWidth={1.5} dot={false} strokeDasharray="4 3" />
+                          <Line type="monotone" dataKey="combined" name={t("detail.score")} stroke="hsl(var(--primary))" strokeWidth={2} dot={false} />
+                          <Line type="monotone" dataKey="usefulness" name={t("detail.usefulness")} stroke="hsl(var(--success))" strokeWidth={1.5} dot={false} strokeDasharray="4 3" />
+                          <Line type="monotone" dataKey="usability" name={t("detail.usability")} stroke="hsl(var(--warning))" strokeWidth={1.5} dot={false} strokeDasharray="4 3" />
                         </LineChart>
                       </ResponsiveContainer>
                     </div>
@@ -765,8 +769,11 @@ export default function ToolDetail() {
               {isReviewFormOpen && (
                 <Card className="border-primary shadow-sm">
                   <CardHeader>
-                    <CardTitle>{t("detail.addReview")}</CardTitle>
-                    <CardDescription>Share your experience with {tool.name}</CardDescription>
+                    <CardTitle className="flex items-center gap-2">
+                      {t("detail.addReview")}
+                      <GuideHelp guide="bewerten" label={t("detail.addReview")} />
+                    </CardTitle>
+                    <CardDescription>{t("detail.shareExperience", { name: tool.name })}</CardDescription>
                   </CardHeader>
                   <CardContent>
                     <Form {...form}>
@@ -822,12 +829,12 @@ export default function ToolDetail() {
                           render={({ field }) => (
                             <FormItem>
                               <FormLabel className="inline-flex items-center gap-1.5">
-                                Comment (Optional)
-                                <FieldHelp schema="RatingInput" field="comment">Comment</FieldHelp>
+                                {t("detail.commentOptional")}
+                                <FieldHelp schema="RatingInput" field="comment">{t("detail.commentLabel")}</FieldHelp>
                               </FormLabel>
                               <FormControl>
                                 <Textarea 
-                                  placeholder="What do you think about this tool?" 
+                                  placeholder={t("detail.commentPlaceholder")} 
                                   className="resize-none min-h-[100px]"
                                   {...field} 
                                 />
@@ -843,11 +850,11 @@ export default function ToolDetail() {
                           render={({ field }) => (
                             <FormItem>
                               <FormLabel className="inline-flex items-center gap-1.5">
-                                Name (Optional)
-                                <FieldHelp schema="RatingInput" field="reviewerName">Name</FieldHelp>
+                                {t("detail.nameOptional")}
+                                <FieldHelp schema="RatingInput" field="reviewerName">{t("detail.nameLabel")}</FieldHelp>
                               </FormLabel>
                               <FormControl>
-                                <Input placeholder="Anonymous" {...field} />
+                                <Input placeholder={t("detail.anonymousPlaceholder")} {...field} />
                               </FormControl>
                               <FormMessage />
                             </FormItem>
@@ -861,7 +868,7 @@ export default function ToolDetail() {
                             onClick={() => setIsReviewFormOpen(false)}
                             disabled={createRating.isPending}
                           >
-                            Cancel
+                            {t("common.cancel")}
                           </Button>
                           <Button type="submit" disabled={createRating.isPending}>
                             {createRating.isPending ? t("common.loading") : t("detail.submit")}
@@ -884,7 +891,7 @@ export default function ToolDetail() {
                       <CardContent className="p-6">
                         <div className="flex justify-between items-start mb-4">
                           <div>
-                            <span className="font-semibold">{rating.reviewerName || "Anonymous Engineer"}</span>
+                            <span className="font-semibold">{rating.reviewerName || t("detail.anonymousEngineer")}</span>
                             <span className="text-muted-foreground text-sm ml-2">
                               {format(new Date(rating.createdAt), "MMM d, yyyy")}
                             </span>
@@ -914,7 +921,7 @@ export default function ToolDetail() {
                   <div className="text-center py-12 bg-muted/30 border border-dashed rounded-xl">
                     <Star className="w-12 h-12 text-muted-foreground/30 mx-auto mb-3" />
                     <h4 className="text-lg font-medium">{t("detail.noReviews")}</h4>
-                    <p className="text-muted-foreground mt-1">Be the first to share your thoughts on this tool.</p>
+                    <p className="text-muted-foreground mt-1">{t("detail.beFirstToReview")}</p>
                   </div>
                 )}
               </div>

artifacts/toolrate/src/pages/tool-edit.tsx

@@ -31,28 +31,35 @@ import { FeatureInput } from "@/components/feature-input";
 import { TagInput } from "@/components/tag-input";
 import { useAuth } from "@/hooks/use-auth";
 import { FieldHelp } from "@/components/field-help";
+import { GuideHelp } from "@/components/guide-help";
+import { useTranslation } from "react-i18next";
 
-const toolSchema = z.object({
-  name: z.string().min(2, "Name must be at least 2 characters"),
-  description: z.string().min(10, "Description must be at least 10 characters"),
-  category: z.string().min(2, "Category is required"),
-  websiteUrl: z.string().url("Must be a valid URL").optional().or(z.literal("")),
-  iconUrl: z.string().url("Must be a valid URL").optional().or(z.literal("")),
+type ToolFormValues = z.infer<ReturnType<typeof buildToolSchema>>;
+
+function buildToolSchema(t: (key: string) => string) {
+  return z.object({
+    name: z.string().min(2, t("toolForm.nameMin")),
+    description: z.string().min(10, t("toolForm.descriptionMin")),
+    category: z.string().min(2, t("toolForm.categoryRequired")),
+    websiteUrl: z.string().url(t("toolForm.invalidUrl")).optional().or(z.literal("")),
+    iconUrl: z.string().url(t("toolForm.invalidUrl")).optional().or(z.literal("")),
     features: z.array(z.object({ value: z.string() })).optional(),
     tags: z.array(z.object({ value: z.string() })).optional(),
   });
-
-type ToolFormValues = z.infer<typeof toolSchema>;
+}
 
 export default function ToolEdit() {
   const [match, params] = useRoute("/tools/:id/edit");
   const [, setLocation] = useLocation();
   const id = parseInt(params?.id || "0", 10);
+  const { t } = useTranslation();
   const { toast } = useToast();
   const queryClient = useQueryClient();
   const updateTool = useUpdateTool();
   const { isAuthenticated, isAdmin } = useAuth();
 
+  const toolSchema = buildToolSchema(t);
+
   const { data: tool, isLoading } = useGetTool(id, {
     query: { enabled: !!id, queryKey: getGetToolQueryKey(id) },
   });
@@ -107,7 +114,7 @@ export default function ToolEdit() {
       { id, data: payload },
       {
         onSuccess: () => {
-          toast({ title: "Tool updated", description: "Changes saved successfully." });
+          toast({ title: t("toolForm.toastUpdated"), description: t("toolForm.toastUpdatedSub") });
           queryClient.invalidateQueries({ queryKey: getGetToolQueryKey(id) });
           queryClient.invalidateQueries({ queryKey: getListToolsQueryKey() });
           queryClient.invalidateQueries({ queryKey: getListCategoriesQueryKey() });
@@ -119,8 +126,8 @@ export default function ToolEdit() {
         },
         onError: (err) => {
           toast({
-            title: "Failed to update tool",
-            description: err.data?.error || err.message || "An unexpected error occurred.",
+            title: t("toolForm.toastUpdateFailed"),
+            description: err.data?.error || err.message || t("detail.unexpectedError"),
             variant: "destructive",
           });
         },
@@ -137,13 +144,13 @@ export default function ToolEdit() {
       <div className="max-w-3xl mx-auto space-y-6 pb-10">
         <Button variant="ghost" asChild className="mb-2 -ml-4 text-muted-foreground">
           <Link href={`/tools/${id}`}>
-            <ArrowLeft className="w-4 h-4 mr-2" /> Back to tool
+            <ArrowLeft className="w-4 h-4 mr-2" /> {t("toolForm.backToTool")}
           </Link>
         </Button>
 
         <div>
-          <h1 className="text-3xl font-bold tracking-tight mb-2">Edit Tool</h1>
-          <p className="text-muted-foreground">Update tool details and metadata.</p>
+          <h1 className="text-3xl font-bold tracking-tight mb-2">{t("toolForm.editTitle")}</h1>
+          <p className="text-muted-foreground">{t("toolForm.editSubtitle")}</p>
         </div>
 
         {isLoading ? (
@@ -159,9 +166,10 @@ export default function ToolEdit() {
             <CardHeader>
               <CardTitle className="flex items-center gap-2">
                 <Pencil className="w-5 h-5 text-primary" />
-                Tool Details
+                {t("toolForm.toolDetails")}
+                <GuideHelp guide="tool-bearbeiten" label={t("toolForm.toolDetails")} />
               </CardTitle>
-              <CardDescription>Modify the tool information below.</CardDescription>
+              <CardDescription>{t("toolForm.toolDetailsEditSub")}</CardDescription>
             </CardHeader>
             <CardContent>
               <Form {...form}>
@@ -173,11 +181,11 @@ export default function ToolEdit() {
                       render={({ field }) => (
                         <FormItem>
                           <FormLabel className="inline-flex items-center gap-1.5">
-                            Name
-                            <FieldHelp schema="ToolInput" field="name">Name</FieldHelp>
+                            {t("toolForm.name")}
+                            <FieldHelp schema="ToolInput" field="name">{t("toolForm.name")}</FieldHelp>
                           </FormLabel>
                           <FormControl>
-                            <Input placeholder="Tool name" {...field} />
+                            <Input placeholder={t("toolForm.name")} {...field} />
                           </FormControl>
                           <FormMessage />
                         </FormItem>
@@ -189,8 +197,8 @@ export default function ToolEdit() {
                       render={({ field }) => (
                         <FormItem>
                           <FormLabel className="inline-flex items-center gap-1.5">
-                            Category
-                            <FieldHelp schema="ToolInput" field="category">Category</FieldHelp>
+                            {t("toolForm.category")}
+                            <FieldHelp schema="ToolInput" field="category">{t("toolForm.category")}</FieldHelp>
                           </FormLabel>
                           <FormControl>
                             <CategoryCombobox value={field.value} onChange={field.onChange} />
@@ -207,11 +215,11 @@ export default function ToolEdit() {
                     render={({ field }) => (
                         <FormItem>
                           <FormLabel className="inline-flex items-center gap-1.5">
-                            Website URL (Optional)
-                            <FieldHelp schema="ToolInput" field="websiteUrl">Website URL</FieldHelp>
+                            {t("toolForm.websiteUrlOptional")}
+                            <FieldHelp schema="ToolInput" field="websiteUrl">{t("toolForm.websiteUrl")}</FieldHelp>
                           </FormLabel>
                         <FormControl>
-                          <Input placeholder="https://..." type="url" {...field} />
+                          <Input placeholder={t("toolForm.urlPlaceholder")} type="url" {...field} />
                         </FormControl>
                         <FormMessage />
                       </FormItem>
@@ -224,8 +232,8 @@ export default function ToolEdit() {
                     render={({ field }) => (
                         <FormItem>
                           <FormLabel className="inline-flex items-center gap-1.5">
-                            Icon / Logo URL (Optional)
-                            <FieldHelp schema="ToolInput" field="iconUrl">Icon / Logo URL</FieldHelp>
+                            {t("toolForm.iconUrlOptional")}
+                            <FieldHelp schema="ToolInput" field="iconUrl">{t("toolForm.iconUrl")}</FieldHelp>
                           </FormLabel>
                         <FormControl>
                           <div className="flex items-center gap-3">
@@ -233,16 +241,16 @@ export default function ToolEdit() {
                               {field.value ? (
                                 <img
                                   src={field.value}
-                                  alt="icon preview"
+                                  alt={t("toolForm.iconPreview")}
                                   className="w-full h-full object-contain p-0.5"
                                   onError={(e) => { (e.target as HTMLImageElement).style.display = "none"; }}
                                 />
                               ) : (
-                                <span className="text-xs text-muted-foreground">img</span>
+                                <span className="text-xs text-muted-foreground">{t("toolForm.name").charAt(0)}</span>
                               )}
                             </div>
                             <Input
-                              placeholder="https://example.com/logo.png"
+                              placeholder={t("toolForm.logoPlaceholder")}
                               type="url"
                               {...field}
                               className="flex-1"
@@ -260,12 +268,12 @@ export default function ToolEdit() {
                     render={({ field }) => (
                         <FormItem>
                           <FormLabel className="inline-flex items-center gap-1.5">
-                            Description
-                            <FieldHelp schema="ToolInput" field="description">Description</FieldHelp>
+                            {t("toolForm.description")}
+                            <FieldHelp schema="ToolInput" field="description">{t("toolForm.description")}</FieldHelp>
                           </FormLabel>
                         <FormControl>
                           <Textarea
-                            placeholder="What does this tool do?"
+                            placeholder={t("toolForm.descriptionPlaceholderEdit")}
                             className="min-h-[120px] resize-none"
                             {...field}
                           />
@@ -279,13 +287,13 @@ export default function ToolEdit() {
                     <div className="flex justify-between items-center">
                       <div>
                         <h3 className="text-lg font-medium inline-flex items-center gap-1.5">
-                          Features
-                          <FieldHelp schema="ToolInput" field="features">Features</FieldHelp>
+                          {t("toolForm.features")}
+                          <FieldHelp schema="ToolInput" field="features">{t("toolForm.features")}</FieldHelp>
                         </h3>
-                        <p className="text-sm text-muted-foreground">Key capabilities of this tool. Existing features from other tools are selectable.</p>
+                        <p className="text-sm text-muted-foreground">{t("toolForm.featuresEditSub")}</p>
                       </div>
                       <Button type="button" variant="outline" size="sm" onClick={() => appendFeature({ value: "" })}>
-                        <Plus className="w-4 h-4 mr-2" /> Add Feature
+                        <Plus className="w-4 h-4 mr-2" /> {t("toolForm.addFeature")}
                       </Button>
                     </div>
                     <div className="space-y-3">
@@ -300,7 +308,7 @@ export default function ToolEdit() {
                                 <FeatureInput
                                   value={field.value ?? ""}
                                   onChange={field.onChange}
-                                  placeholder="e.g. Real-time collaboration"
+                                  placeholder={t("toolForm.featurePlaceholder")}
                                 />
                               </FormControl>
                               <Button
@@ -317,7 +325,7 @@ export default function ToolEdit() {
                         />
                       ))}
                       {featureFields.length === 0 && (
-                        <p className="text-sm text-muted-foreground italic">No features added.</p>
+                        <p className="text-sm text-muted-foreground italic">{t("toolForm.noFeatures")}</p>
                       )}
                     </div>
                   </div>
@@ -326,13 +334,13 @@ export default function ToolEdit() {
                     <div className="flex justify-between items-center">
                       <div>
                         <h3 className="text-lg font-medium inline-flex items-center gap-1.5">
-                          Tags
-                          <FieldHelp schema="ToolInput" field="tags">Tags</FieldHelp>
+                          {t("toolForm.tags")}
+                          <FieldHelp schema="ToolInput" field="tags">{t("toolForm.tags")}</FieldHelp>
                         </h3>
-                        <p className="text-sm text-muted-foreground">Keywords for this tool. Existing tags from other tools are selectable.</p>
+                        <p className="text-sm text-muted-foreground">{t("toolForm.tagsEditSub")}</p>
                       </div>
                       <Button type="button" variant="outline" size="sm" onClick={() => appendTag({ value: "" })}>
-                        <Plus className="w-4 h-4 mr-2" /> Add Tag
+                        <Plus className="w-4 h-4 mr-2" /> {t("toolForm.addTag")}
                       </Button>
                     </div>
                     <div className="flex flex-wrap gap-2">
@@ -345,7 +353,7 @@ export default function ToolEdit() {
                             <FormItem className="flex items-center space-y-0 relative w-[200px]">
                               <FormControl>
                                 <TagInput
-                                  placeholder="Tag"
+                                  placeholder={t("toolForm.tag")}
                                   className="pr-8 h-9 text-sm"
                                   onChange={field.onChange}
                                   value={field.value ?? ""}
@@ -369,10 +377,10 @@ export default function ToolEdit() {
 
                   <div className="pt-6 border-t flex justify-end gap-3">
                     <Button type="button" variant="outline" asChild>
-                      <Link href={`/tools/${id}`}>Cancel</Link>
+                      <Link href={`/tools/${id}`}>{t("common.cancel")}</Link>
                     </Button>
                     <Button type="submit" disabled={updateTool.isPending || !isAuthenticated}>
-                      {updateTool.isPending ? "Saving…" : "Save Changes"}
+                      {updateTool.isPending ? t("toolForm.saving") : t("toolForm.saveChanges")}
                     </Button>
                   </div>
                 </form>

artifacts/toolrate/src/pages/tool-new.tsx

@@ -19,26 +19,33 @@ import { FeatureInput } from "@/components/feature-input";
 import { TagInput } from "@/components/tag-input";
 import { useAuth } from "@/hooks/use-auth";
 import { FieldHelp } from "@/components/field-help";
+import { GuideHelp } from "@/components/guide-help";
+import { useTranslation } from "react-i18next";
 
-const toolSchema = z.object({
-  name: z.string().min(2, "Name must be at least 2 characters"),
-  description: z.string().min(10, "Description must be at least 10 characters"),
-  category: z.string().min(2, "Category is required"),
-  websiteUrl: z.string().url("Must be a valid URL").optional().or(z.literal("")),
-  iconUrl: z.string().url("Must be a valid URL").optional().or(z.literal("")),
+type ToolFormValues = z.infer<ReturnType<typeof buildToolSchema>>;
+
+function buildToolSchema(t: (key: string) => string) {
+  return z.object({
+    name: z.string().min(2, t("toolForm.nameMin")),
+    description: z.string().min(10, t("toolForm.descriptionMin")),
+    category: z.string().min(2, t("toolForm.categoryRequired")),
+    websiteUrl: z.string().url(t("toolForm.invalidUrl")).optional().or(z.literal("")),
+    iconUrl: z.string().url(t("toolForm.invalidUrl")).optional().or(z.literal("")),
     features: z.array(z.object({ value: z.string() })).optional(),
     tags: z.array(z.object({ value: z.string() })).optional(),
   });
-
-type ToolFormValues = z.infer<typeof toolSchema>;
+}
 
 export default function ToolNew() {
   const [location, setLocation] = useLocation();
+  const { t } = useTranslation();
   const { toast } = useToast();
   const queryClient = useQueryClient();
   const createTool = useCreateTool();
   const { isAuthenticated, isLoading: authLoading, login } = useAuth();
 
+  const toolSchema = buildToolSchema(t);
+
   const form = useForm<ToolFormValues>({
     resolver: zodResolver(toolSchema),
     defaultValues: {
@@ -75,7 +82,7 @@ export default function ToolNew() {
       { data: payload },
       {
         onSuccess: (newTool) => {
-          toast({ title: "Tool added successfully", description: "Your tool is now available for review." });
+          toast({ title: t("toolForm.toastAdded"), description: t("toolForm.toastAddedSub") });
           queryClient.invalidateQueries({ queryKey: getListToolsQueryKey() });
           queryClient.invalidateQueries({ queryKey: getListCategoriesQueryKey() });
           queryClient.invalidateQueries({ queryKey: getListAllFeaturesQueryKey() });
@@ -85,7 +92,7 @@ export default function ToolNew() {
           setLocation(`/tools/${newTool.id}`);
         },
         onError: () => {
-          toast({ title: "Failed to add tool", description: "An unexpected error occurred.", variant: "destructive" });
+          toast({ title: t("toolForm.toastAddFailed"), description: t("detail.unexpectedError"), variant: "destructive" });
         },
       },
     );
@@ -96,24 +103,24 @@ export default function ToolNew() {
       <div className="max-w-3xl mx-auto space-y-6 pb-10">
         <Button variant="ghost" asChild className="mb-2 -ml-4 text-muted-foreground">
           <Link href="/tools">
-            <ArrowLeft className="w-4 h-4 mr-2" /> Back to browse
+            <ArrowLeft className="w-4 h-4 mr-2" /> {t("toolForm.backToBrowse")}
           </Link>
         </Button>
 
         <div>
-          <h1 className="text-3xl font-bold tracking-tight mb-2">Add a New Tool</h1>
-          <p className="text-muted-foreground">Submit a tool you use to let the community rate and review it.</p>
+          <h1 className="text-3xl font-bold tracking-tight mb-2">{t("toolForm.addTitle")}</h1>
+          <p className="text-muted-foreground">{t("toolForm.addSubtitle")}</p>
         </div>
 
         {!authLoading && !isAuthenticated && (
           <div className="flex items-center gap-4 rounded-md border border-primary/20 bg-primary/5 px-4 py-3">
             <LogIn className="w-5 h-5 text-primary shrink-0" />
             <div className="flex-1 min-w-0">
-              <p className="text-sm font-medium">Sign in required</p>
-              <p className="text-xs text-muted-foreground">You must be signed in to submit a tool.</p>
+              <p className="text-sm font-medium">{t("toolForm.signInRequired")}</p>
+              <p className="text-xs text-muted-foreground">{t("toolForm.signInRequiredSub")}</p>
             </div>
             <Button size="sm" onClick={() => login(location)} data-testid="button-login-prompt">
-              Sign in
+              {t("auth.signIn")}
             </Button>
           </div>
         )}
@@ -122,9 +129,10 @@ export default function ToolNew() {
           <CardHeader>
             <CardTitle className="flex items-center gap-2">
               <Wrench className="w-5 h-5 text-primary" />
-              Tool Details
+              {t("toolForm.toolDetails")}
+              <GuideHelp guide="tool-anlegen" label={t("toolForm.toolDetails")} />
             </CardTitle>
-            <CardDescription>Provide the basic information about the tool.</CardDescription>
+            <CardDescription>{t("toolForm.toolDetailsNewSub")}</CardDescription>
           </CardHeader>
           <CardContent>
             <Form {...form}>
@@ -136,11 +144,11 @@ export default function ToolNew() {
                     render={({ field }) => (
                       <FormItem>
                         <FormLabel className="inline-flex items-center gap-1.5">
-                          Name
-                          <FieldHelp schema="ToolInput" field="name">Name</FieldHelp>
+                          {t("toolForm.name")}
+                          <FieldHelp schema="ToolInput" field="name">{t("toolForm.name")}</FieldHelp>
                         </FormLabel>
                         <FormControl>
-                          <Input placeholder="e.g. React, Next.js, Postgres" {...field} data-testid="input-tool-name" />
+                          <Input placeholder={t("toolForm.namePlaceholder")} {...field} data-testid="input-tool-name" />
                         </FormControl>
                         <FormMessage />
                       </FormItem>
@@ -153,8 +161,8 @@ export default function ToolNew() {
                     render={({ field }) => (
                       <FormItem>
                         <FormLabel className="inline-flex items-center gap-1.5">
-                          Category
-                          <FieldHelp schema="ToolInput" field="category">Category</FieldHelp>
+                          {t("toolForm.category")}
+                          <FieldHelp schema="ToolInput" field="category">{t("toolForm.category")}</FieldHelp>
                         </FormLabel>
                         <FormControl>
                           <CategoryCombobox
@@ -174,11 +182,11 @@ export default function ToolNew() {
                     render={({ field }) => (
                       <FormItem>
                         <FormLabel className="inline-flex items-center gap-1.5">
-                          Website URL (Optional)
-                          <FieldHelp schema="ToolInput" field="websiteUrl">Website URL</FieldHelp>
+                          {t("toolForm.websiteUrlOptional")}
+                          <FieldHelp schema="ToolInput" field="websiteUrl">{t("toolForm.websiteUrl")}</FieldHelp>
                         </FormLabel>
                       <FormControl>
-                        <Input placeholder="https://..." type="url" {...field} data-testid="input-tool-url" />
+                        <Input placeholder={t("toolForm.urlPlaceholder")} type="url" {...field} data-testid="input-tool-url" />
                       </FormControl>
                       <FormMessage />
                     </FormItem>
@@ -191,8 +199,8 @@ export default function ToolNew() {
                   render={({ field }) => (
                     <FormItem>
                       <FormLabel className="inline-flex items-center gap-1.5">
-                        Icon / Logo URL (Optional)
-                        <FieldHelp schema="ToolInput" field="iconUrl">Icon / Logo URL</FieldHelp>
+                        {t("toolForm.iconUrlOptional")}
+                        <FieldHelp schema="ToolInput" field="iconUrl">{t("toolForm.iconUrl")}</FieldHelp>
                       </FormLabel>
                       <FormControl>
                         <div className="flex items-center gap-3">
@@ -200,16 +208,16 @@ export default function ToolNew() {
                             {field.value ? (
                               <img
                                 src={field.value}
-                                alt="icon preview"
+                                alt={t("toolForm.iconPreview")}
                                 className="w-full h-full object-contain p-0.5"
                                 onError={(e) => { (e.target as HTMLImageElement).style.display = "none"; }}
                               />
                             ) : (
-                              <span className="text-xs text-muted-foreground">img</span>
+                              <span className="text-xs text-muted-foreground">{t("toolForm.name").charAt(0)}</span>
                             )}
                           </div>
                           <Input
-                            placeholder="https://example.com/logo.png"
+                            placeholder={t("toolForm.logoPlaceholder")}
                             type="url"
                             {...field}
                             data-testid="input-tool-icon-url"
@@ -228,12 +236,12 @@ export default function ToolNew() {
                   render={({ field }) => (
                     <FormItem>
                       <FormLabel className="inline-flex items-center gap-1.5">
-                        Description
-                        <FieldHelp schema="ToolInput" field="description">Description</FieldHelp>
+                        {t("toolForm.description")}
+                        <FieldHelp schema="ToolInput" field="description">{t("toolForm.description")}</FieldHelp>
                       </FormLabel>
                       <FormControl>
                         <Textarea
-                          placeholder="What does this tool do? Why do people use it?"
+                          placeholder={t("toolForm.descriptionPlaceholderNew")}
                           className="min-h-[120px] resize-none"
                           {...field}
                           data-testid="input-tool-description"
@@ -248,10 +256,10 @@ export default function ToolNew() {
                   <div className="flex justify-between items-center">
                     <div>
                       <h3 className="text-lg font-medium inline-flex items-center gap-1.5">
-                        Features
-                        <FieldHelp schema="ToolInput" field="features">Features</FieldHelp>
+                        {t("toolForm.features")}
+                        <FieldHelp schema="ToolInput" field="features">{t("toolForm.features")}</FieldHelp>
                       </h3>
-                      <p className="text-sm text-muted-foreground">List key capabilities. Existing features from other tools are selectable.</p>
+                      <p className="text-sm text-muted-foreground">{t("toolForm.featuresNewSub")}</p>
                     </div>
                     <Button
                       type="button"
@@ -260,7 +268,7 @@ export default function ToolNew() {
                       onClick={() => appendFeature({ value: "" })}
                       data-testid="button-add-feature"
                     >
-                      <Plus className="w-4 h-4 mr-2" /> Add Feature
+                      <Plus className="w-4 h-4 mr-2" /> {t("toolForm.addFeature")}
                     </Button>
                   </div>
 
@@ -276,7 +284,7 @@ export default function ToolNew() {
                               <FeatureInput
                                 value={field.value ?? ""}
                                 onChange={field.onChange}
-                                placeholder="e.g. Real-time collaboration"
+                                placeholder={t("toolForm.featurePlaceholder")}
                                 data-testid={`input-feature-${index}`}
                               />
                             </FormControl>
@@ -295,7 +303,7 @@ export default function ToolNew() {
                       />
                     ))}
                     {featureFields.length === 0 && (
-                      <p className="text-sm text-muted-foreground italic">No features added.</p>
+                      <p className="text-sm text-muted-foreground italic">{t("toolForm.noFeatures")}</p>
                     )}
                   </div>
                 </div>
@@ -304,10 +312,10 @@ export default function ToolNew() {
                   <div className="flex justify-between items-center">
                     <div>
                       <h3 className="text-lg font-medium inline-flex items-center gap-1.5">
-                        Tags
-                        <FieldHelp schema="ToolInput" field="tags">Tags</FieldHelp>
+                        {t("toolForm.tags")}
+                        <FieldHelp schema="ToolInput" field="tags">{t("toolForm.tags")}</FieldHelp>
                       </h3>
-                      <p className="text-sm text-muted-foreground">Keywords to help find this tool. Existing tags from other tools are selectable.</p>
+                      <p className="text-sm text-muted-foreground">{t("toolForm.tagsHelp")}</p>
                     </div>
                     <Button
                       type="button"
@@ -316,7 +324,7 @@ export default function ToolNew() {
                       onClick={() => appendTag({ value: "" })}
                       data-testid="button-add-tag"
                     >
-                      <Plus className="w-4 h-4 mr-2" /> Add Tag
+                      <Plus className="w-4 h-4 mr-2" /> {t("toolForm.addTag")}
                     </Button>
                   </div>
 
@@ -330,7 +338,7 @@ export default function ToolNew() {
                           <FormItem className="flex items-center space-y-0 relative w-[200px]">
                             <FormControl>
                               <TagInput
-                                placeholder="Tag"
+                                placeholder={t("toolForm.tagPlaceholder")}
                                 className="pr-8 h-9 text-sm"
                                 onChange={field.onChange}
                                 value={field.value ?? ""}

artifacts/toolrate/src/pages/tools-browse.tsx

@@ -362,7 +362,7 @@ export default function ToolsBrowse() {
                 <button
                   onClick={() => setFeatures(features.filter((x) => x !== f))}
                   className="rounded-sm hover:bg-muted p-0.5"
-                  aria-label={`Remove feature ${f}`}
+                  aria-label={t("filter.removeFeature", { feature: f })}
                 >
                   <X className="w-3.5 h-3.5" />
                 </button>
@@ -374,14 +374,14 @@ export default function ToolsBrowse() {
                 <button
                   onClick={() => setMinRating(null)}
                   className="rounded-sm hover:bg-muted p-0.5"
-                  aria-label="Remove min rating"
+                  aria-label={t("filter.removeMinRating")}
                 >
                   <X className="w-3.5 h-3.5" />
                 </button>
               </Badge>
             )}
             <Button variant="link" size="sm" className="px-1 text-muted-foreground" onClick={clearFilters}>
-              Clear all
+              {t("common.clearAll")}
             </Button>
           </div>
         )}
@@ -521,15 +521,15 @@ export default function ToolsBrowse() {
       <AlertDialog open={compareUpsellOpen} onOpenChange={setCompareUpsellOpen}>
         <AlertDialogContent>
           <AlertDialogHeader>
-            <AlertDialogTitle>Compare is a Premium feature</AlertDialogTitle>
+            <AlertDialogTitle>{t("browse.comparePremiumTitle")}</AlertDialogTitle>
             <AlertDialogDescription>
-              Comparing tools side-by-side is available to Premium and Enterprise users. Upgrade your plan to unlock it.
+              {t("browse.comparePremiumSub")}
             </AlertDialogDescription>
           </AlertDialogHeader>
           <AlertDialogFooter>
-            <AlertDialogCancel>Not now</AlertDialogCancel>
+            <AlertDialogCancel>{t("browse.notNow")}</AlertDialogCancel>
             <AlertDialogAction asChild>
-              <a href="/admin?tab=plan">Upgrade to Premium</a>
+              <a href="/admin?tab=plan">{t("browse.upgradePremium")}</a>
             </AlertDialogAction>
           </AlertDialogFooter>
         </AlertDialogContent>

artifacts/toolrate/src/pages/trash.tsx

@@ -11,7 +11,6 @@ import {
   getListAllTagsQueryKey,
   getGetTopToolsQueryKey,
   getGetAnalyticsSummaryQueryKey,
-  type Tool,
 } from "@workspace/api-client-react";
 import { useQueryClient } from "@tanstack/react-query";
 import { useAuth } from "@/hooks/use-auth";
@@ -91,12 +90,12 @@ export default function Trash() {
       { data: { ids } },
       {
         onSuccess: (res) => {
-          toast({ title: "Tools restored", description: `${res.restored ?? ids.length} tool(s) restored.` });
+          toast({ title: t("trash.toastRestored"), description: t("trash.toastRestoredSub", { count: res.restored ?? ids.length }) });
           setSelected(new Set());
           invalidate();
         },
         onError: (err) => {
-          toast({ title: "Failed to restore", description: err.data?.error ?? err.message, variant: "destructive" });
+          toast({ title: t("trash.toastRestoreFailed"), description: err.data?.error ?? err.message, variant: "destructive" });
         },
       },
     );
@@ -107,13 +106,13 @@ export default function Trash() {
       { data: { ids } },
       {
         onSuccess: () => {
-          toast({ title: "Tools deleted", description: `${ids.length} tool(s) permanently removed.` });
+          toast({ title: t("trash.toastDeleted"), description: t("trash.toastDeletedSub", { count: ids.length }) });
           setSelected(new Set());
           setConfirmDelete(false);
           invalidate();
         },
         onError: (err) => {
-          toast({ title: "Failed to delete", description: err.data?.error ?? err.message, variant: "destructive" });
+          toast({ title: t("trash.toastDeleteFailed"), description: err.data?.error ?? err.message, variant: "destructive" });
         },
       },
     );
@@ -124,13 +123,13 @@ export default function Trash() {
       undefined,
       {
         onSuccess: (res) => {
-          toast({ title: "Trash emptied", description: `${res.deleted ?? 0} tool(s) permanently removed.` });
+          toast({ title: t("trash.toastEmptied"), description: t("trash.toastEmptiedSub", { count: res.deleted ?? 0 }) });
           setSelected(new Set());
           setConfirmEmpty(false);
           invalidate();
         },
         onError: (err) => {
-          toast({ title: "Failed to empty trash", description: err.data?.error ?? err.message, variant: "destructive" });
+          toast({ title: t("trash.toastEmptyFailed"), description: err.data?.error ?? err.message, variant: "destructive" });
         },
       },
     );
@@ -227,48 +226,48 @@ export default function Trash() {
                       <Checkbox
                         checked={selected.size === trashed.length && trashed.length > 0}
                         onCheckedChange={toggleAll}
-                        aria-label="Select all"
+                        aria-label={t("trash.selectAll")}
                       />
                     </TableHead>
-                    <TableHead>Name</TableHead>
-                    <TableHead>Category</TableHead>
+                    <TableHead>{t("trash.name")}</TableHead>
+                    <TableHead>{t("trash.category")}</TableHead>
                     <TableHead>{t("trash.deletedAt")}</TableHead>
                     <TableHead>{t("trash.deletedBy")}</TableHead>
-                    <TableHead className="text-right">Actions</TableHead>
+                    <TableHead className="text-right">{t("trash.actions")}</TableHead>
                   </TableRow>
                 </TableHeader>
                 <TableBody>
-                  {trashed.map((t: Tool) => (
-                    <TableRow key={t.id} className={selected.has(t.id) ? "bg-muted/40" : undefined}>
+                  {trashed.map((tool) => (
+                    <TableRow key={tool.id} className={selected.has(tool.id) ? "bg-muted/40" : undefined}>
                       <TableCell>
                         <Checkbox
-                          checked={selected.has(t.id)}
-                          onCheckedChange={() => toggle(t.id)}
-                          aria-label={`Select ${t.name}`}
+                          checked={selected.has(tool.id)}
+                          onCheckedChange={() => toggle(tool.id)}
+                          aria-label={t("trash.selectName", { name: tool.name })}
                         />
                       </TableCell>
-                      <TableCell className="font-medium">{t.name}</TableCell>
+                      <TableCell className="font-medium">{tool.name}</TableCell>
                       <TableCell>
-                        <Badge variant="outline">{t.category}</Badge>
+                        <Badge variant="outline">{tool.category}</Badge>
                       </TableCell>
                       <TableCell className="text-sm text-muted-foreground">
-                        {t.deletedAt ? format(new Date(t.deletedAt), "dd.MM.yyyy HH:mm") : "—"}
+                        {tool.deletedAt ? format(new Date(tool.deletedAt), "dd.MM.yyyy HH:mm") : "—"}
                       </TableCell>
-                      <TableCell className="text-sm text-muted-foreground">{t.deletedBy ?? "—"}</TableCell>
+                      <TableCell className="text-sm text-muted-foreground">{tool.deletedBy ?? "—"}</TableCell>
                       <TableCell className="text-right">
                         <div className="flex justify-end gap-1">
-                          <Button variant="ghost" size="sm" onClick={() => handleRestore([t.id])} disabled={restore.isPending}>
-                            <RotateCcw className="w-3.5 h-3.5" /> Restore
+                          <Button variant="ghost" size="sm" onClick={() => handleRestore([tool.id])} disabled={restore.isPending}>
+                            <RotateCcw className="w-3.5 h-3.5" /> {t("trash.restoreAction")}
                           </Button>
                           {isAdmin && (
                             <Button
                               variant="ghost"
                               size="sm"
                               className="text-destructive hover:text-destructive"
-                              onClick={() => handleDeletePermanent([t.id])}
+                              onClick={() => handleDeletePermanent([tool.id])}
                               disabled={deletePermanent.isPending}
                             >
-                              <TrashIcon className="w-3.5 h-3.5" /> Delete
+                              <TrashIcon className="w-3.5 h-3.5" /> {t("trash.deleteAction")}
                             </Button>
                           )}
                         </div>
@@ -285,13 +284,13 @@ export default function Trash() {
       <AlertDialog open={confirmDelete} onOpenChange={setConfirmDelete}>
         <AlertDialogContent>
           <AlertDialogHeader>
-            <AlertDialogTitle>Delete {selectedIds.length} tool(s) permanently?</AlertDialogTitle>
+            <AlertDialogTitle>{t("trash.deleteConfirmTitle", { count: selectedIds.length })}</AlertDialogTitle>
             <AlertDialogDescription>
-              This permanently removes the selected tools along with all their ratings, costs and relations. This cannot be undone.
+              {t("trash.deleteConfirmSub")}
             </AlertDialogDescription>
           </AlertDialogHeader>
           <AlertDialogFooter>
-            <AlertDialogCancel>Cancel</AlertDialogCancel>
+            <AlertDialogCancel>{t("common.cancel")}</AlertDialogCancel>
             <AlertDialogAction
               className="bg-destructive text-destructive-foreground hover:bg-destructive/90"
               onClick={() => handleDeletePermanent(selectedIds)}
@@ -305,13 +304,13 @@ export default function Trash() {
       <AlertDialog open={confirmEmpty} onOpenChange={setConfirmEmpty}>
         <AlertDialogContent>
           <AlertDialogHeader>
-            <AlertDialogTitle>Empty the trash?</AlertDialogTitle>
+            <AlertDialogTitle>{t("trash.emptyConfirmTitle")}</AlertDialogTitle>
             <AlertDialogDescription>
-              This permanently removes all {trashed.length} tool(s) in the trash along with their ratings, costs and relations. This cannot be undone.
+              {t("trash.emptyConfirmSub", { count: trashed.length })}
             </AlertDialogDescription>
           </AlertDialogHeader>
           <AlertDialogFooter>
-            <AlertDialogCancel>Cancel</AlertDialogCancel>
+            <AlertDialogCancel>{t("common.cancel")}</AlertDialogCancel>
             <AlertDialogAction
               className="bg-destructive text-destructive-foreground hover:bg-destructive/90"
               onClick={handleEmpty}

artifacts/toolrate/src/pages/watchlist.tsx

@@ -6,6 +6,7 @@ import { useAuth } from "@/hooks/use-auth";
 import { useWatchlist } from "@/hooks/use-watchlist";
 import { Layout } from "@/components/layout";
 import { ToolCard } from "@/components/tool-card";
+import { GuideHelp } from "@/components/guide-help";
 import { Button } from "@/components/ui/button";
 import { Skeleton } from "@/components/ui/skeleton";
 import { ShieldAlert, Bookmark } from "lucide-react";
@@ -42,7 +43,10 @@ export default function Watchlist() {
     <Layout>
       <div className="space-y-6 pb-10">
         <div>
-          <h1 className="text-3xl font-bold tracking-tight mb-2">{t("watchlist.title")}</h1>
+          <h1 className="text-3xl font-bold tracking-tight mb-2 flex items-center gap-2">
+            {t("watchlist.title")}
+            <GuideHelp guide="watchlist" label={t("watchlist.title")} />
+          </h1>
           <p className="text-muted-foreground">{t("watchlist.subtitle")}</p>
         </div>
 
@@ -58,7 +62,7 @@ export default function Watchlist() {
               {t("watchlist.emptySub")}
             </p>
             <Button variant="outline" asChild>
-              <a href="/tools">Browse tools</a>
+              <a href="/tools">{t("common.browseTools")}</a>
             </Button>
           </div>
         ) : (

docs/handbook/administration.en.md

@@ -0,0 +1,65 @@
+---
+title: Administration
+order: 13
+---
+
+# Administration
+
+The **Admin** area (`/admin`) is exclusively accessible to admins.
+Without the admin role, access is denied.
+
+> At the top right, the **Redundancy dashboard** button leads to the automatic
+> duplicate detection (see [Redundancy](/docs/handbook/redundanz)).
+
+## "Users" tab
+
+Management of local accounts.
+
+- **Add user:** username (required), password (at least 6 characters),
+  email (optional), **role** (User/Admin), **plan** (Free/Premium/Enterprise).
+- **Edit user:** set role, plan and (for local accounts) a new password.
+  For OIDC accounts, password management is offered in the identity provider
+  (e.g. Keycloak).
+- **Delete user:** permanently removes the account (not for your own account).
+
+API reference:
+[`POST /users`](/docs/reference/endpoints/users#createUser),
+[`PATCH /users/{id}`](/docs/reference/endpoints/users#updateUser),
+[`DELETE /users/{id}`](/docs/reference/endpoints/users#deleteUser).
+
+## "Tools" tab
+
+Central access to the tool catalog.
+
+- **Search** for tools.
+- View, edit or move individual tools to the trash.
+- **Bulk action:** select multiple tools and move them to the trash
+  (confirmation dialog; soft-deleted tools are removed from all public views
+  and can be restored or permanently deleted).
+
+## "Audit log" tab
+
+Chronological log of all creation, change and deletion operations
+(max. 100 entries): action, entity + ID, timestamp, executing person and
+changed fields.
+
+API reference: [`GET /audit-logs`](/docs/reference/endpoints/audit#listAuditLogs).
+
+## "System" tab
+
+Version information of the running instance:
+
+- **Version** (e.g. `v0.8.1`),
+- **Commit** (7-digit SHA, linked to the repository),
+- **Build date**,
+- **Trash retention** ("N days" or "Forever").
+
+## Tool links (Admin)
+
+On the detail page of a tool you can manage **links** as an admin
+(own/"manual" as well as automatically detected ones):
+
+- **Link tool:** dialog with tool ID, **relationship type**
+  (Similar / Replaces / Superseded by) and optional notes.
+- Relationship types are displayed as badges on the detail page.
+- Manual links can be removed again via the trash icon.

docs/handbook/administration.md

@@ -1,61 +1,65 @@
 ---
-title: Administration & Papierkorb
-order: 7
+title: Administration
+order: 13
 ---
 
-# Administration & Papierkorb
+# Administration
 
-Diese Bereiche sind nur für **Administrator:innen** sichtbar und nutzbar.
+Der Bereich **Admin** (`/admin`) ist ausschließlich für Admins zugänglich.
+Ohne Admin-Rolle erscheint eine Zugriffsverweigerung.
 
-## Nutzerverwaltung
+> Oben rechts führt die Schaltfläche **Redundanz-Dashboard** zur automatischen
+> Doppelungs-Erkennung (siehe [Redundanz](/docs/handbook/redundanz)).
 
-Unter **Admin → Nutzer** kannst du:
+## Tab „Nutzer"
 
-- **Lokale Nutzer anlegen** (Benutzername, Passwort, E-Mail, Rolle, Tier).
-- **Rollen/Tier ändern** (`admin`/`user`, `free`/`premium`/`enterprise`).
-- **Passwörter zurücksetzen** (nur lokale Nutzer).
-- **Nutzer löschen**.
+Verwaltung der lokalen Konten.
 
-Zugehörige Endpunkte (Admin-only):
+- **Nutzer hinzufügen:** Benutzername (Pflicht), Passwort (mind. 6 Zeichen),
+  E-Mail (optional), **Rolle** (User/Admin), **Tarif** (Free/Premium/Enterprise).
+- **Nutzer bearbeiten:** Rolle, Tarif und (für lokale Konten) ein neues Passwort
+  setzen. Für OIDC-Konten wird die Passwortverwaltung im Identitätsanbieter
+  (z. B. Keycloak) angeboten.
+- **Nutzer löschen:** Entfernt das Konto endgültig (nicht für das eigene Konto).
 
-- [`GET /users`](/docs/reference/endpoints/users#listusers)
-- [`POST /users`](/docs/reference/endpoints/users#createuser)
-- [`PATCH /users/{id}`](/docs/reference/endpoints/users#updateuser)
-- [`DELETE /users/{id}`](/docs/reference/endpoints/users#deleteuser)
-- [`PATCH /users/{id}/password`](/docs/reference/endpoints/users#setuserpassword)
+API-Referenz:
+[`POST /users`](/docs/reference/endpoints/users#createUser),
+[`PATCH /users/{id}`](/docs/reference/endpoints/users#updateUser),
+[`DELETE /users/{id}`](/docs/reference/endpoints/users#deleteUser).
 
-## Audit-Log
+## Tab „Tools"
 
-Das **Audit-Log** protokolliert sicherheitsrelevante Änderungen (wer hat wann
-was geändert). Es ist über
-[`GET /audit-logs`](/docs/reference/endpoints/audit#listauditlogs) abrufbar und
-filterbar nach Entitätstyp, Entitäts-ID und Limit.
+Zentraler Zugriff auf den Tool-Katalog.
 
-## Papierkorb (Trash)
+- **Suchen** nach Tools.
+- Tools einzeln ansehen, bearbeiten oder in den Papierkorb verschieben.
+- **Massenaktion:** mehrere Tools auswählen und in den Papierkorb verschieben
+  (Bestätigungsdialog; soft gelöschte Tools sind aus allen öffentlichen Ansichten
+  entfernt und können wiederhergestellt oder endgültig gelöscht werden).
 
-Tools werden nicht sofort gelöscht, sondern zuerst **soft gelöscht** (in den
-Papierkorb verschoben):
+## Tab „Audit-Log"
 
-- **Liste:** [`GET /tools/trash`](/docs/reference/endpoints/tools#listtrashedtools)
-- **In den Papierkorb verschieben:** [`POST /tools/trash`](/docs/reference/endpoints/tools#trashtools)
-- **Wiederherstellen:** [`POST /tools/trash/restore`](/docs/reference/endpoints/tools#restoretools)
-- **Endgültig löschen (einzeln):** [`DELETE /tools/trash`](/docs/reference/endpoints/tools#deletetrashedtools)
-- **Papierkorb leeren:** [`POST /tools/trash/empty`](/docs/reference/endpoints/tools#emptytrash)
+Chronologisches Protokoll aller Anlage-, Änderungs- und Löschvorgänge
+(max. 100 Einträge): Aktion, Entität + ID, Zeitstempel, ausführende Person und
+geänderte Felder.
 
-> Die Aufbewahrungsfrist des Papierkorbs (in Tagen) ist im
-> [`VersionInfo`](/docs/reference/schemas/versioninfo)-Schema als
-> `trashRetentionDays` verfügbar.
+API-Referenz: [`GET /audit-logs`](/docs/reference/endpoints/audit#listAuditLogs).
 
-## Felder im Überblick
+## Tab „System"
 
-### User
+Versionsinformationen der laufenden Instanz:
 
-| Feld | Typ | Bedeutung |
-| --- | --- | --- |
-| `id` | integer | Eindeutige Nutzer-ID. |
-| `username` | string | Anmeldename. |
-| `email` | string? | E-Mail-Adresse. |
-| `role` | string | `admin` oder `user`. |
-| `tier` | string | `free`, `premium` oder `enterprise`. |
-| `authProvider` | string | `local` oder `oidc`. |
-| `createdAt` | date-time | Erstellungszeitpunkt. |
+- **Version** (z. B. `v0.8.1`),
+- **Commit** (7-stelliger SHA, verlinkt zum Repository),
+- **Build-Datum**,
+- **Papierkorb-Aufbewahrung** („N Tage" oder „Für immer").
+
+## Tool-Verknüpfungen (Admin)
+
+Auf der Detailseite eines Tools kannst du als Admin **Verknüpfungen**
+(eigene/„manual" sowie automatisch erkannte) verwalten:
+
+- **Tool verknüpfen:** Dialog mit Tool-ID, **Beziehungstyp**
+  (Ähnlich / Ersetzt / Abgelöst durch) und optionalen Notizen.
+- Beziehungstypen werden als Badges auf der Detailseite angezeigt.
+- Manuelle Verknüpfungen lassen sich per Papierkorb-Icon wieder entfernen.

docs/handbook/analytics.en.md

@@ -0,0 +1,33 @@
+---
+title: Analytics
+order: 10
+---
+
+# Analytics
+
+The **Analytics** area (`/analytics`) is a public dashboard with
+metrics and charts based on all tools and ratings.
+
+## Metrics (KPI cards)
+
+- **Number of tools** — how many tools are recorded in the catalog.
+- **Number of ratings** — how many ratings were submitted in total.
+- **Active categories** — how many categories exist.
+- **Average rating** — global combined value.
+
+## Charts
+
+| Chart | Content |
+| --- | --- |
+| **Top 8 tools** | Bar chart of the tools with the highest combined score (0–5) |
+| **Tools per category** | Radar chart of the number of tools per category |
+| **Score distribution** | Two horizontal bar charts (usefulness & usability) per star |
+
+The charts are interactive (tooltips on hover).
+
+## API
+
+- [`GET /analytics/summary`](/docs/reference/endpoints/analytics#getAnalyticsSummary)
+- [`GET /analytics/top-tools`](/docs/reference/endpoints/analytics#getTopTools)
+- [`GET /analytics/by-category`](/docs/reference/endpoints/analytics#getAnalyticsByCategory)
+- [`GET /analytics/rating-distribution`](/docs/reference/endpoints/analytics#getRatingDistribution)

docs/handbook/analytics.md

@@ -1,37 +1,33 @@
 ---
 title: Analytics
-order: 6
+order: 10
 ---
 
 # Analytics
 
-Der Bereich **Analytics** fasst die Plattform-Statistiken zusammen — für alle
-Nutzer:innen ohne Einschränkung sichtbar.
+Der Bereich **Analytics** (`/analytics`) ist ein öffentliches Dashboard mit
+Kennzahlen und Diagrammen auf Basis aller Tools und Bewertungen.
 
-## Übersicht
+## Kennzahlen (KPI-Karten)
 
-| Widget | Quelle (Endpunkt) | Inhalt |
-| --- | --- | --- |
-| **Plattform-Kennzahlen** | [`GET /analytics/summary`](/docs/reference/endpoints/analytics#getanalyticssummary) | Gesamtzahl Tools, Bewertungen, Durchschnittswerte, Kategorienzahl. |
-| **Top-Tools** | [`GET /analytics/top-tools`](/docs/reference/endpoints/analytics#gettoppertools) | Bestbewertete Tools nach wählbarer Metrik (Nützlichkeit, Bedienbarkeit, kombiniert). |
-| **Nach Kategorie** | [`GET /analytics/by-category`](/docs/reference/endpoints/analytics#getanalyticsbycategory) | Kennzahlen je Kategorie. |
-| **Verteilung** | [`GET /analytics/rating-distribution`](/docs/reference/endpoints/analytics#getratingdistribution) | Verteilung der Bewertungswerte (optional je Tool). |
+- **Anzahl Tools** — wie viele Tools sind im Katalog erfasst.
+- **Anzahl Bewertungen** — wie viele Bewertungen wurden insgesamt abgegeben.
+- **Aktive Kategorien** — wie viele Kategorien existieren.
+- **Durchschnittliche Bewertung** — globaler kombinierter Wert.
 
-## Datenfelder
+## Diagramme
 
-### AnalyticsSummary
+| Diagramm | Inhalt |
+| --- | --- |
+| **Top 8 Tools** | Balkendiagramm der Tools mit der höchsten kombinierten Punktzahl (0–5) |
+| **Tools je Kategorie** | Radar-Diagramm der Tool-Anzahl pro Kategorie |
+| **Punkteverteilung** | Zwei horizontale Balken-Diagramme (Nützlichkeit & Bedienbarkeit) pro Stern |
 
-| Feld | Typ | Bedeutung |
-| --- | --- | --- |
-| `totalTools` | integer | Anzahl aller Tools. |
-| `totalRatings` | integer | Anzahl aller Bewertungen. |
-| `avgUsefulness` | number? | Durchschnittliche Nützlichkeit. |
-| `avgUsability` | number? | Durchschnittliche Bedienbarkeit. |
-| `avgCombined` | number? | Durchschnitt kombinierter Wert. |
-| `categoriesCount` | integer | Anzahl der Kategorien. |
-| `mostRatedTool` | ToolWithStats | Das meistbewertete Tool. |
+Die Diagramme sind interaktiv (Tooltips beim Überfahren).
 
-Vollständige Feldlisten: [`AnalyticsSummary`](/docs/reference/schemas/analyticssummary),
-[`TopToolEntry`](/docs/reference/schemas/topptoolentry),
-[`CategoryStats`](/docs/reference/schemas/categorystats),
-[`RatingDistribution`](/docs/reference/schemas/ratingdistribution).
+## API
+
+- [`GET /analytics/summary`](/docs/reference/endpoints/analytics#getAnalyticsSummary)
+- [`GET /analytics/top-tools`](/docs/reference/endpoints/analytics#getTopTools)
+- [`GET /analytics/by-category`](/docs/reference/endpoints/analytics#getAnalyticsByCategory)
+- [`GET /analytics/rating-distribution`](/docs/reference/endpoints/analytics#getRatingDistribution)

docs/handbook/bewerten.en.md

@@ -0,0 +1,43 @@
+---
+title: Rating
+order: 7
+---
+
+# Rating
+
+On the detail page of a tool you can share your experience. Click on
+**Submit a rating** (requires an account).
+
+## Form fields
+
+| Field | Required | Notes |
+| --- | --- | --- |
+| **Usefulness** | Yes | 1–5 stars |
+| **Usability** | Yes | 1–5 stars |
+| **Comment** | No | Free text |
+| **Name** | No | Defaults to "Anonymous" |
+
+Next to the fields, the **? icon** links directly to the associated field
+description in the [data model reference](/docs/reference/schemas/ratinginput).
+
+## What happens after submitting?
+
+- Your rating is saved immediately and appears in the **rating list** of the
+  detail page.
+- The **averages** (usefulness, usability, combined) and the **score
+  distribution** are updated.
+- The **statistics** in the [Analytics](/docs/handbook/analytics) section are
+  recalculated.
+
+## Statistic sections on the detail page
+
+- **Rating overview:** usefulness & usability as an average with progress
+  bars.
+- **Score distribution:** number of ratings per star (1★–5★).
+- **History:** line chart of combined/individual values over time
+  (only visible once there are several ratings).
+
+## API
+
+- [`POST /tools/{id}/ratings`](/docs/reference/endpoints/ratings#createRating) — Submit a rating
+- [`GET /tools/{id}/ratings`](/docs/reference/endpoints/ratings#listToolRatings) — Ratings of a tool

docs/handbook/bewerten.md

@@ -0,0 +1,43 @@
+---
+title: Bewerten
+order: 7
+---
+
+# Bewerten
+
+Auf der Detailseite eines Tools kannst du deine Erfahrung teilen. Klicke auf
+**Bewertung abgeben** (erfordert ein Konto).
+
+## Formularfelder
+
+| Feld | Pflicht | Hinweise |
+| --- | --- | --- |
+| **Nützlichkeit** | Ja | 1–5 Sterne |
+| **Bedienbarkeit** | Ja | 1–5 Sterne |
+| **Kommentar** | Nein | Freitext |
+| **Name** | Nein | Standard „Anonym" |
+
+Neben den Feldern führt das **?‑Icon** direkt zur zugehörigen Feldbeschreibung
+in der [Datenmodell-Referenz](/docs/reference/schemas/ratinginput).
+
+## Was passiert nach dem Abgeben?
+
+- Deine Bewertung wird sofort gespeichert und erscheint in der
+  **Bewertungsliste** der Detailseite.
+- Die **Durchschnittswerte** (Nützlichkeit, Bedienbarkeit, Kombiniert) und die
+  **Punkteverteilung** werden aktualisiert.
+- Die **Statistiken** im Bereich [Analytics](/docs/handbook/analytics) werden
+  neu berechnet.
+
+## Statistik-Bereiche auf der Detailseite
+
+- **Bewertungsübersicht:** Nützlichkeit & Bedienbarkeit als Durchschnitt mit
+  Fortschrittsbalken.
+- **Punkteverteilung:** Anzahl der Bewertungen pro Stern (1★–5★).
+- **Verlauf:** Linienchart der kombinierten/Teilwerte über die Zeit
+  (erst ab mehreren Bewertungen sichtbar).
+
+## API
+
+- [`POST /tools/{id}/ratings`](/docs/reference/endpoints/ratings#createRating) — Bewertung abgeben
+- [`GET /tools/{id}/ratings`](/docs/reference/endpoints/ratings#listToolRatings) — Bewertungen eines Tools

docs/handbook/bewertungen.md

@@ -1,45 +0,0 @@
----
-title: Bewertungen
-order: 4
----
-
-# Bewertungen
-
-Bewertungen sind das Herz von toolr: Sie zeigen, wie nützlich und wie gut
-bedienbar ein Tool in den Augen der Community ist.
-
-## Wie funktioniert die Bewertung?
-
-Auf der Detailseite eines Tools vergibst du zwei Werte (1–5 Sterne):
-
-- **Nützlichkeit** — Wie gut löst das Tool sein Kernproblem?
-- **Bedienbarkeit** — Wie einfach ist es zu bedienen?
-
-Optional kannst du einen **Kommentar** und deinen **Namen** hinterlassen. Die
-Eingabefelder entsprechen dem Schema
-[`RatingInput`](/docs/reference/schemas/ratinginput).
-
-## Was passiert mit meiner Bewertung?
-
-- Deine Bewertung wird sofort gespeichert und in den Durchschnittswerten des
-  Tools berücksichtigt.
-- Jede Bewertung ist über [`GET /tools/{id}/ratings`](/docs/reference/endpoints/ratings#listtoolratings)
-  abrufbar.
-- Der **Rating-Verlauf** über die Zeit ist über
-  [`GET /tools/{id}/rating-history`](/docs/reference/endpoints/tools#gettoolratinghistory)
-  einsehbar (grafisch auf der Detailseite).
-
-## Datenfelder
-
-Eine Bewertung besteht aus diesen Feldern
-([`Rating`](/docs/reference/schemas/rating)):
-
-| Feld | Typ | Bedeutung |
-| --- | --- | --- |
-| `id` | integer | Eindeutige ID der Bewertung. |
-| `toolId` | integer | ID des bewerteten Tools. |
-| `usefulness` | integer (1–5) | Nützlichkeitsbewertung. |
-| `usability` | integer (1–5) | Bedienbarkeitsbewertung. |
-| `comment` | string? | Optionaler Kommentar. |
-| `reviewerName` | string? | Optionaler Anzeigename des Bewerters. |
-| `createdAt` | date-time | Zeitpunkt der Bewertung. |

docs/handbook/datenmodell.en.md

@@ -0,0 +1,74 @@
+---
+title: Data model
+order: 17
+---
+
+# 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](/docs/reference/schemas/tool).
+
+## 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`](/docs/reference/schemas/toolinput) and
+[`ToolUpdate`](/docs/reference/schemas/toolupdate).
+Aggregated views are provided by [`ToolWithStats`](/docs/reference/schemas/toolwithstats)
+(e.g. with average rating).
+
+## Rating (Bewertung)
+
+A single rating for a tool:
+
+- `usefulness` (Nützlichkeit, 1–5) and `usability` (Bedienbarkeit, 1–5)
+- optional `comment` and a display name (`reviewerName`)
+- timestamp
+
+Input schema: [`RatingInput`](/docs/reference/schemas/ratinginput).
+
+## User & Auth
+
+- [`User`](/docs/reference/schemas/user) — user account with role (User/Admin)
+  and plan (Free/Premium/Enterprise).
+- [`AuthUser`](/docs/reference/schemas/authuser) — the logged-in profile
+  including `entitlements` (available features).
+- [`UserPreferences`](/docs/reference/schemas/userpreferences) — view and
+  density preferences as well as the `watchlist` (list of tool IDs).
+
+## Analytics
+
+The statistics endpoints provide aggregated data:
+
+- [`AnalyticsSummary`](/docs/reference/schemas/analyticssummary) — global
+  metrics (number of tools/ratings, categories, average).
+- [`TopToolEntry`](/docs/reference/schemas/TopToolEntry) — an entry of the
+  top tools.- [`CategoryStats`](/docs/reference/schemas/categorystats) — number of tools per
+  category.
+- [`RatingDistribution`](/docs/reference/schemas/ratingdistribution) —
+  score distribution (usefulness & usability).
+- [`ScoreBucket`](/docs/reference/schemas/scorebucket) — a value bucket.
+
+## Additional
+
+- [`VersionInfo`](/docs/reference/schemas/versioninfo) — version, commit SHA,
+  build date and trash retention of the running instance.
+- [`AuditLog`](/docs/reference/schemas/auditlog) — a log entry
+  (action, entity, timestamp, actor, changes).

docs/handbook/datenmodell.md

@@ -1,60 +1,74 @@
 ---
-title: Datenmodell & Felder
-order: 8
+title: Datenmodell
+order: 17
 ---
 
-# Datenmodell & Felder
+# Datenmodell
 
-Dieses Handbuch erklärt die zentralen Objekte von toolr auf verständliche
-Weise. Die **vollständige, maschinell generierte Feld-Referenz** findest du in
-der [Referenz](/docs/reference/schemas/tool) — dort sind alle Typen, Pflicht-
-angaben und Constraints der aktuellen Version dokumentiert.
+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](/docs/reference/schemas/tool).
 
-> Die Referenz ist **versionsgebunden**: Über das Versions-Dropdown oben
-> kannst du ältere API-Stände einsehen.
+## Tool
 
-## Die wichtigsten Objekte
+Das Herzstück: ein im Katalog erfasstes Werkzeug.
 
-### Tool
-
-Ein Tool ist der zentrale Eintrag im Katalog
-([Feld-Referenz](/docs/reference/schemas/tool)):
-
-| Feld | Bedeutung |
+| Eigenschaft | Beschreibung |
 | --- | --- |
-| `id` | Eindeutige ID. |
-| `name` | Anzeigename. |
-| `description` | Kurzbeschreibung. |
-| `category` | Kategorie-Zuordnung. |
-| `websiteUrl` / `iconUrl` | Offizielle Website bzw. Logo-Link (optional). |
-| `createdBy` | Nutzer, der das Tool angelegt hat (optional). |
-| `features` / `tags` | Listen von Schlüsselfähigkeiten bzw. Schlagwörtern. |
-| `createdAt` / `updatedAt` | Zeitstempel. |
-| `deletedAt` / `deletedBy` | Soft-Delete-Informationen (Papierkorb). |
+| `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) |
 
-> **ToolWithStats** erweitert `Tool` um die Aggregatwerte `ratingCount`,
-> `avgUsefulness`, `avgUsability` und `avgCombined` (siehe
-> [Feld-Referenz](/docs/reference/schemas/toolwithstats)).
+Eingabe-Formulare verwenden die abgeleiteten Schemas
+[`ToolInput`](/docs/reference/schemas/toolinput) und
+[`ToolUpdate`](/docs/reference/schemas/toolupdate).
+Aggregierte Ansichten liefert [`ToolWithStats`](/docs/reference/schemas/toolwithstats)
+(z. B. mit Durchschnittsbewertung).
 
-### Rating
+## Rating (Bewertung)
 
-Eine Bewertung (`Rating`) besteht aus `usefulness` und `usability` (jeweils
-1–5) sowie optionalem Kommentar und Bewerternamen. Details unter
-[Bewertungen](/docs/handbook/bewertungen).
+Eine einzelne Bewertung zu einem Tool:
 
-### User / AuthUser
+- `usefulness` (Nützlichkeit, 1–5) und `usability` (Bedienbarkeit, 1–5)
+- optional `comment` und ein Anzeigename (`reviewerName`)
+- Zeitstempel
 
-- **User** (Admin-Sicht): `id`, `username`, `email`, `role`, `tier`,
-  `authProvider`, `createdAt` — siehe [Administration](/docs/handbook/administration).
-- **AuthUser** (Eigenansicht): `sub`, `email`, `name`, `preferredUsername`,
-  `role`, `tier`, `entitlements`, `isLocal`.
+Eingabe-Schema: [`RatingInput`](/docs/reference/schemas/ratinginput).
 
-### VersionInfo
+## User & Auth
 
-`GET /version` liefert `version`, `commitSha`, `buildDate` und
-`trashRetentionDays` (siehe [Feld-Referenz](/docs/reference/schemas/versioninfo)).
+- [`User`](/docs/reference/schemas/user) — Benutzerkonto mit Rolle (User/Admin)
+  und Tarif (Free/Premium/Enterprise).
+- [`AuthUser`](/docs/reference/schemas/authuser) — das angemeldete Profil
+  inklusive `entitlements` (verfügbare Features).
+- [`UserPreferences`](/docs/reference/schemas/userpreferences) — Ansichts- und
+  Dichte-Präferenzen sowie die `watchlist` (Liste von Tool-IDs).
 
-## Referenz selber durchsuchen
+## Analytics
 
-Nutze das **Suchfeld** in der Doku-Seitenleiste: Es durchsucht Handbuch,
-Endpunkt- und Feldbeschreibungen und springt direkt zum passenden Anker.
+Die Statistik-Endpunkte liefern aggregierte Daten:
+
+- [`AnalyticsSummary`](/docs/reference/schemas/analyticssummary) — globale
+  Kennzahlen (Anzahl Tools/Bewertungen, Kategorien, Durchschnitt).
+- [`TopToolEntry`](/docs/reference/schemas/TopToolEntry) — ein Eintrag der
+  Top-Tools.- [`CategoryStats`](/docs/reference/schemas/categorystats) — Tool-Anzahl je
+  Kategorie.
+- [`RatingDistribution`](/docs/reference/schemas/ratingdistribution) —
+  Punkteverteilung (Nützlichkeit & Bedienbarkeit).
+- [`ScoreBucket`](/docs/reference/schemas/scorebucket) — ein Werte-Bucket.
+
+## Weitere
+
+- [`VersionInfo`](/docs/reference/schemas/versioninfo) — Version, Commit-SHA,
+  Build-Datum und Papierkorb-Aufbewahrung der laufenden Instanz.
+- [`AuditLog`](/docs/reference/schemas/auditlog) — ein Protokolleintrag
+  (Aktion, Entität, Zeitstempel, Akteur, Änderungen).

docs/handbook/getting-started.en.md

@@ -0,0 +1,57 @@
+---
+title: Getting Started
+order: 2
+---
+
+# Getting Started
+
+This page guides you through the most important workflows in toolr — from your
+first visit to creating and rating a tool.
+
+## 1. Sign in
+
+Most actions (create a tool, rate, watchlist, compare) require
+an account. Click **Sign in** in the bottom left corner. Depending on the
+instance configuration you have two options:
+
+- **Local accounts:** username + password. Access is created by an admin
+  (see [Administration](/docs/handbook/administration)).
+- **OIDC (SSO):** sign in with the configured identity provider (e.g.
+  Keycloak).
+
+Which mode is active is shown by the
+[`GET /auth/mode`](/docs/reference/endpoints/auth#getAuthMode) endpoint. Details
+can be found in the [Sign in & account](/docs/handbook/konto) section.
+
+## 2. Find tools
+
+Open the **Browse tools** section:
+
+- **Search** — full-text search across name & description (shortcut `/`).
+- **Filter** — by category, tags, features and minimum rating
+  (`minRating`).
+- **Sort** — by newest, top-rated, most rated, name
+  (ascending/descending) or last update.
+
+All options in detail: [Find & browse tools](/docs/handbook/tools-finden).
+
+## 3. Create a tool
+
+Go to **Add tool** and fill in the form. Details for each field can be found
+in the [Create a tool](/docs/handbook/tool-anlegen) section and in the
+[field reference](/docs/reference/schemas/toolinput).
+
+## 4. Rate
+
+On the detail page of a tool you can submit **usefulness** and **usability**
+(1–5 each) and optionally leave a comment. Your
+rating is immediately reflected in the statistics.
+See [Rating](/docs/handbook/bewerten).
+
+## 5. Further reading
+
+- [Compare tools](/docs/handbook/vergleichen)
+- [Watchlist](/docs/handbook/watchlist)
+- [Analytics](/docs/handbook/analytics)
+- [Plans & permissions](/docs/handbook/plaene)
+- [Administration](/docs/handbook/administration)

docs/handbook/getting-started.md

@@ -10,45 +10,48 @@ Besuch bis zum Anlegen und Bewerten eines Tools.
 
 ## 1. Anmelden
 
-Die meisten Aktionen (Tool anlegen, bewerten, Watchlist) erfordern ein
-Konto. Klicke oben rechts auf **Anmelden**. Je nach Konfiguration der Instanz
-hast du zwei Möglichkeiten:
+Die meisten Aktionen (Tool anlegen, bewerten, Watchlist, Vergleichen) erfordern
+ein Konto. Klicke unten links auf **Anmelden**. Je nach Konfiguration der
+Instanz hast du zwei Möglichkeiten:
 
 - **Lokale Konten:** Benutzername + Passwort. Der Zugang wird von einem Admin
   angelegt (siehe [Administration](/docs/handbook/administration)).
-- **OIDC (SSO):** Anmelden mit dem konfigurierten Identitätsanbieter.
+- **OIDC (SSO):** Anmelden mit dem konfigurierten Identitätsanbieter (z. B.
+  Keycloak).
 
-Welcher Modus aktiv ist, steht im [Endpunkt
-`GET /auth/mode`](/docs/reference/endpoints/auth#getauthmode).
+Welcher Modus aktiv ist, steht im Endpunkt
+[`GET /auth/mode`](/docs/reference/endpoints/auth#getAuthMode). Details findest
+du im Abschnitt [Anmelden & Konto](/docs/handbook/konto).
 
 ## 2. Tools finden
 
 Öffne den Bereich **Tools durchsuchen**:
 
-- **Suchen** — Volltextsuche über Name & Beschreibung.
-- **Filtern** — nach Kategorie, Tags und Features; zusätzlich
-  Mindestbewertung (`minRating`).
+- **Suchen** — Volltextsuche über Name & Beschreibung (Tastenkürzel `/`).
+- **Filtern** — nach Kategorie, Tags, Features und Mindestbewertung
+  (`minRating`).
 - **Sortieren** — nach Aktualität, Top-Bewertung, meistbewertet, Name
   (auf-/absteigend) oder letztem Update.
 
-Die Such-, Filter- und Sortierparameter entsprechen den Query-Parametern von
-[`GET /tools`](/docs/reference/endpoints/tools#listtools).
+Alle Optionen im Detail: [Tools finden & durchsuchen](/docs/handbook/tools-finden).
 
 ## 3. Tool anlegen
 
 Gehe auf **Tool hinzufügen** und fülle das Formular aus. Details zu jedem Feld
-findest du im [Handbuch "Tool anlegen"](/docs/handbook/tool-anlegen) und in der
+findest du im Abschnitt [Tool anlegen](/docs/handbook/tool-anlegen) und in der
 [Feld-Referenz](/docs/reference/schemas/toolinput).
 
 ## 4. Bewerten
 
-Auf der Detailseite eines Tools kannst du **Nützlichkeit** und
-**Bedienbarkeit** (jeweils 1–5) vergeben und optional einen Kommentar
-hinterlassen. Deine Bewertung fließt sofort in die Statistiken ein.
+Auf der Detailseite eines Tools kannst du **Nützlichkeit** und **Bedienbarkeit**
+(jeweils 1–5) vergeben und optional einen Kommentar hinterlassen. Deine
+Bewertung fließt sofort in die Statistiken ein.
+Siehe [Bewerten](/docs/handbook/bewerten).
 
 ## 5. Weiterführend
 
 - [Tools vergleichen](/docs/handbook/vergleichen)
 - [Watchlist](/docs/handbook/watchlist)
 - [Analytics](/docs/handbook/analytics)
-- [Administration & Papierkorb](/docs/handbook/administration)
+- [Pläne & Berechtigungen](/docs/handbook/plaene)
+- [Administration](/docs/handbook/administration)

docs/handbook/index.en.md

@@ -0,0 +1,55 @@
+---
+title: Overview
+order: 1
+---
+
+# Welcome to toolr
+
+toolr is a platform for **discovering, rating and comparing development
+tools**. Users maintain a shared catalog of tools, submit ratings
+(usefulness & usability) and use statistics to make the right choice.
+
+## What can you do with toolr?
+
+| Function | Description | Visibility |
+| --- | --- | --- |
+| **Browse tools** | Filter, sort and search the catalog | Everyone |
+| **Create a tool** | Add a new tool with description, category, features & tags | Logged in |
+| **Edit/delete tools** | Maintain your own tools (creator or admin) | Logged in |
+| **Rate** | Submit usefulness & usability (1–5) plus a comment | Logged in |
+| **Watchlist** | Save tools as favorites | Premium |
+| **Compare** | View tools side by side | Premium |
+| **Record costs** | Enter license and cost models per tool | Premium |
+| **Analytics** | Statistics, top tools, distributions | Everyone |
+| **Trash** | Restore soft-deleted tools or delete them permanently | Premium |
+| **Admin** | User management, audit log, system information | Admin |
+| **Redundancy detection** | Automatic duplicate detection | Admin |
+
+## How this documentation is organized
+
+- **User Guide** (these pages): step-by-step instructions for all
+  functions — from the [Getting Started](/docs/handbook/getting-started) to
+  [Administration](/docs/handbook/administration).
+- **API Reference**: automatically generated from the OpenAPI specification —
+  all [endpoints](/docs/reference/endpoints/tools) and
+  [data fields](/docs/reference/schemas/toolinput) of the current version.
+- **Release Notes**: what is new in each [version](/docs/releases/v0.8.1).
+
+## Getting started
+
+The fastest way:
+
+1. **Sign in** — without an account you can only browse
+   (see [Getting Started](/docs/handbook/getting-started#1-anmelden)).
+2. **Find tools** — search, filters and sorting in the
+   [Browse tools](/docs/handbook/tools-finden) section.
+3. **Create a tool** — via "Add tool"
+   ([guide](/docs/handbook/tool-anlegen)).
+4. **Rate** — on the detail page of a tool
+   ([guide](/docs/handbook/bewerten)).
+
+## Contact & source code
+
+The source code is available at
+[git.kubebase.de/admin/tool-evaluator](https://git.kubebase.de/admin/tool-evaluator) —
+you can reach it at any time via the repository icon in the top right corner.

docs/handbook/index.md

@@ -16,35 +16,41 @@ die richtige Wahl zu treffen.
 | --- | --- | --- |
 | **Tools durchsuchen** | Katalog filtern, sortieren und durchsuchen | Alle |
 | **Tool anlegen** | Neues Tool mit Beschreibung, Kategorie, Features & Tags eintragen | Angemeldet |
+| **Tool bearbeiten/löschen** | Eigene Tools pflegen (Ersteller:in oder Admin) | Angemeldet |
 | **Bewerten** | Nützlichkeit & Bedienbarkeit (1–5) plus Kommentar vergeben | Angemeldet |
-| **Vergleichen** | Tools nebeneinander gegenüberstellen | Premium |
 | **Watchlist** | Tools als Favoriten speichern | Premium |
+| **Vergleichen** | Tools nebeneinander gegenüberstellen | Premium |
+| **Kosten erfassen** | Lizenz- und Kostenmodelle je Tool eintragen | Premium |
 | **Analytics** | Statistiken, Top-Tools, Verteilungen | Alle |
-| **Admin** | Nutzerverwaltung, Audit-Log, Papierkorb | Admin |
-| **Trash** | Soft-gelöschte Tools wiederherstellen oder endgültig löschen | Admin |
+| **Papierkorb** | Soft-gelöschte Tools wiederherstellen oder endgültig löschen | Premium |
+| **Admin** | Nutzerverwaltung, Audit-Log, Systeminformationen | Admin |
+| **Redundanz** | Automatische Doppelungs-Erkennung | Admin |
 
-## Funktionen & Felder im Detail
+## Wie diese Doku aufgebaut ist
 
-Die **Referenz** ist automatisch aus der OpenAPI-Spezifikation generiert und
-deckt damit garantiert *alle* Endpunkte und Datenfelder der aktuellen Version
-ab:
+- **User Guide** (diese Seiten): Schritt-für-Schritt-Anleitungen für alle
+  Funktionen — von den [Ersten Schritten](/docs/handbook/getting-started) bis
+  zur [Administration](/docs/handbook/administration).
+- **API-Referenz**: automatisch aus der OpenAPI-Spezifikation generiert — alle
+  [Endpunkte](/docs/reference/endpoints/tools) und
+  [Datenfelder](/docs/reference/schemas/toolinput) der aktuellen Version.
+- **Release-Notes**: Was ist in welcher [Version](/docs/releases/v0.8.1) neu.
 
-- [Endpunkte](/docs/reference/endpoints/tools) — jede API-Operation mit
-  Parametern und Antwort-Schemas.
-- [Datenmodell & Felder](/docs/reference/schemas/tool) — jedes Feld mit Typ,
-  Pflichtstatus und Bedeutung.
+## Der Einstieg
 
-> Die Referenz ist **versionsgebunden**: Wähle oben rechts eine ältere Version,
-> um den API-Stand dieses Releases zu sehen.
+Der schnellste Weg:
 
-## Erste Schritte
+1. **Anmelden** — ohne Konto kannst du nur stöbern
+   (siehe [Erste Schritte](/docs/handbook/getting-started#1-anmelden)).
+2. **Tools finden** — Suche, Filter und Sortierung im Bereich
+   [Tools durchsuchen](/docs/handbook/tools-finden).
+3. **Tool anlegen** — über „Tool hinzufügen"
+   ([Anleitung](/docs/handbook/tool-anlegen)).
+4. **Bewerten** — auf der Detailseite eines Tools
+   ([Anleitung](/docs/handbook/bewerten)).
 
-- Neu hier? Starte mit dem [Erste-Schritte-Guide](/docs/handbook/getting-started).
-- Möchtest du ein Tool eintragen? Siehe [Tool anlegen](/docs/handbook/tool-anlegen).
-- Formulare zeigen neben jedem Feld ein **Hilfe-Icon (?)**, das direkt zur
-  Erklärung des Felds in der Doku springt.
+## Kontakt & Quellcode
 
-## Wo ist der Quellcode?
-
-Über das **Repository-Logo oben rechts** gelangst du direkt zum Quellcode auf
-GitHub.
+Der Quellcode liegt unter
+[git.kubebase.de/admin/tool-evaluator](https://git.kubebase.de/admin/tool-evaluator) —
+über das Repository-Icon oben rechts erreichst du ihn jederzeit.

docs/handbook/konto.en.md

@@ -0,0 +1,56 @@
+---
+title: Login & Account
+order: 3
+---
+
+# Login & Account
+
+## Logging in
+
+Click **Login** at the bottom left of the sidebar. Depending on the
+configuration of the instance:
+
+- **Local accounts:** enter username and password. The accounts are created
+  by an admin (see [Administration](/docs/handbook/administration)).
+- **OIDC (SSO):** you are redirected to the configured identity provider and
+  log in there.
+
+The active mode is available at the endpoint
+[`GET /auth/mode`](/docs/reference/endpoints/auth#getAuthMode).
+
+> You can reach the login page directly at `/login`. After a successful
+> login you are redirected back to the page you originally requested.
+
+## User profile
+
+You can see your profile (avatar, name, email, plan) at the bottom left in
+the user menu. There you have the following actions available:
+
+- **Watchlist** — your saved tools (only with the corresponding plan).
+- **Trash** — restorable, deleted tools (Premium/Enterprise).
+- **Change password** — directly in toolr for local accounts; for OIDC
+  accounts, password management is offered in the identity provider.
+- **Logout** — ends your session.
+
+## Changing your password (local account)
+
+1. Open the user menu at the bottom left.
+2. Select **Change password**.
+3. Enter the **current** and a **new** password (min. 6 characters) and
+   confirm it.
+4. Save — the password takes effect immediately.
+
+API reference: [`POST /auth/me/password`](/docs/reference/endpoints/auth#changeMyPassword).
+
+## Display settings
+
+Using the buttons at the top right you can:
+
+- switch the **language** (German / English),
+- toggle the **theme** (Light / Dark / System),
+- adjust the **list view** and **density** in the Browse tools section
+  (see [Finding & browsing tools](/docs/handbook/tools-finden)).
+
+Your preferences (incl. watchlist) are saved at the endpoint
+[`GET /auth/me/preferences`](/docs/reference/endpoints/auth#getMePreferences)
+and updated via [`PUT /auth/me/preferences`](/docs/reference/endpoints/auth#updateMePreferences).

docs/handbook/konto.md

@@ -0,0 +1,57 @@
+---
+title: Anmelden & Konto
+order: 3
+---
+
+# Anmelden & Konto
+
+## Anmelden
+
+Klicke unten links in der Seitenleiste auf **Anmelden**. Je nach Konfiguration
+der Instanz:
+
+- **Lokale Konten:** Benutzername und Passwort eingeben. Die Konten werden von
+  einem Admin angelegt (siehe [Administration](/docs/handbook/administration)).
+- **OIDC (SSO):** Du wirst an den konfigurierten Identitätsanbieter
+  weitergeleitet und meldest dich dort an.
+
+Der aktive Modus steht im Endpunkt
+[`GET /auth/mode`](/docs/reference/endpoints/auth#getAuthMode).
+
+> Die Login-Seite erreichst du direkt unter `/login`. Nach erfolgreicher
+> Anmeldung wirst du zur ursprünglich aufgerufenen Seite zurückgeleitet.
+
+## Benutzerprofil
+
+Dein Profil (Avatar, Name, E-Mail, Tarif) siehst du unten links im
+Benutzermenü. Dort stehen dir folgende Aktionen zur Verfügung:
+
+- **Watchlist** — deine gespeicherten Tools (nur mit dem entsprechenden Tarif).
+- **Papierkorb** — wiederherstellbare, gelöschte Tools (Premium/Enterprise).
+- **Passwort ändern** — für lokale Konten direkt in toolr; für OIDC-Konten wird
+  die Passwortverwaltung im Identitätsanbieter angeboten.
+- **Abmelden** — beendet deine Sitzung.
+
+## Passwort ändern (lokales Konto)
+
+1. Öffne das Benutzermenü unten links.
+2. Wähle **Passwort ändern**.
+3. Gib das **aktuelle** sowie ein **neues** Passwort ein (mind. 6 Zeichen) und
+   bestätige es.
+4. Speichern — das Passwort wird sofort übernommen.
+
+API-Referenz: [`POST /auth/me/password`](/docs/reference/endpoints/auth#changeMyPassword).
+
+## Anzeigeeinstellungen
+
+Über die Schaltflächen oben rechts kannst du:
+
+- **Sprache** wechseln (Deutsch / Englisch),
+- **Theme** umschalten (Hell / Dunkel / System),
+- die **Listenansicht** und **Dichte** im Bereich Tools durchsuchen anpassen
+  (siehe [Tools finden & durchsuchen](/docs/handbook/tools-finden)).
+
+Deine Präferenzen (inkl. Watchlist) werden im Endpunkt
+[`GET /auth/me/preferences`](/docs/reference/endpoints/auth#getMePreferences)
+gespeichert und über [`PUT /auth/me/preferences`](/docs/reference/endpoints/auth#updateMePreferences)
+aktualisiert.

docs/handbook/kosten.en.md

@@ -0,0 +1,39 @@
+---
+title: Recording Costs
+order: 12
+---
+
+# Recording Costs
+
+On the detail page of a tool you can enter cost and license models so that
+the total costs per tool become transparent.
+
+> Costs is a **premium feature** (`costs`, Premium/Enterprise). Admins always
+> have access.
+
+## Adding costs
+
+Click **Add costs** in the costs section of the detail page and fill out the
+form:
+
+| Field | Notes |
+| --- | --- |
+| **License type** | Free / Subscription / One-Time / Usage-Based |
+| **Billing period** | Only for "Subscription": Monthly / Quarterly / Annually |
+| **Costs** | Amount as a number |
+| **Currency** | EUR / USD / GBP / CHF |
+| **Notes** | Optional free text |
+
+Saving creates the entry. Each cost entry is displayed as a card with
+license badge, billing period, amount (`Amount Currency` or "Free") and
+notes.
+
+## Editing & deleting costs
+
+Hovering over a cost card shows the **Edit** (pencil) and **Delete** (trash)
+actions.
+
+## API
+
+The cost data is managed via the tool endpoints
+(see [API reference](/docs/reference/endpoints/tools)).

docs/handbook/kosten.md

@@ -0,0 +1,39 @@
+---
+title: Kosten erfassen
+order: 12
+---
+
+# Kosten erfassen
+
+Auf der Detailseite eines Tools kannst du Kosten- und Lizenzmodelle eintragen,
+damit die Gesamtkosten je Tool transparent werden.
+
+> Kosten ist ein **Premium-Feature** (`costs`, Premium/Enterprise). Admins
+> haben immer Zugriff.
+
+## Kosten hinzufügen
+
+Klicke auf **Kosten hinzufügen** im Kosten-Bereich der Detailseite und fülle
+das Formular aus:
+
+| Feld | Hinweise |
+| --- | --- |
+| **Lizenztyp** | Free / Subscription / One-Time / Usage-Based |
+| **Abrechnungszeitraum** | Nur für „Subscription": Monatlich / Quartalsweise / Jährlich |
+| **Kosten** | Betrag als Zahl |
+| **Währung** | EUR / USD / GBP / CHF |
+| **Notizen** | Optionaler Freitext |
+
+Speichern legt den Eintrag an. Jeder Kosten-Eintrag wird als Karte mit
+Lizenz-Badge, Abrechnungszeitraum, Betrag (`Betrag Währung` bzw. „Free") und
+Notizen angezeigt.
+
+## Kosten bearbeiten & löschen
+
+Beim Überfahren einer Kosten-Karte erscheinen die Aktionen **Bearbeiten**
+(Bleistift) und **Löschen** (Papierkorb).
+
+## API
+
+Die Kosten-Daten werden über die Tool-Endpunkte verwaltet
+(siehe [API-Referenz](/docs/reference/endpoints/tools)).

docs/handbook/papierkorb.en.md

@@ -0,0 +1,44 @@
+---
+title: Trash
+order: 15
+---
+
+# Trash
+
+The **trash** (`/trash`) contains soft-deleted tools. With trash access
+they can be restored; permanent deletion is reserved for admins.
+
+> The trash is a **premium feature** (`trash`, Premium/Enterprise).
+> Admins always have access.
+
+## Access
+
+The trash can be reached via the user menu or the sidebar.
+Without the `trash` permission, a hint about changing the plan appears.
+
+## Restoring
+
+- Select one or more tools (checkboxes).
+- Click on **Restore (N)** — the tools appear again in all
+  public views.
+
+> Restoring is available to anyone with trash access.
+
+## Permanently delete (admin only)
+
+- **Delete (N)** **permanently** removes the selected tools — including
+  all ratings, costs and links. This cannot be undone.
+- **Empty trash** permanently removes all soft-deleted tools.
+
+## Table
+
+The trash lists: name, category, **Deleted on** (`tt.MM.jjjj HH:mm`),
+**Deleted by** as well as actions (Restore; Delete admin only). The search
+filters by name.
+
+## API
+
+- [`GET /tools/trash`](/docs/reference/endpoints/tools#listTrashedTools) — list
+- [`POST /tools/trash/restore`](/docs/reference/endpoints/tools#restoreTools) — restore
+- [`DELETE /tools/trash`](/docs/reference/endpoints/tools#deleteTrashedTools) — permanently delete (admin)
+- [`POST /tools/trash/empty`](/docs/reference/endpoints/tools#emptyTrash) — empty trash (admin)

docs/handbook/papierkorb.md

@@ -0,0 +1,45 @@
+---
+title: Papierkorb
+order: 15
+---
+
+# Papierkorb
+
+Der **Papierkorb** (`/trash`) enthält soft gelöschte Tools. Mit Papierkorb-Zugang
+können sie wiederhergestellt werden; endgültiges Löschen ist Admins vorbehalten.
+
+> Der Papierkorb ist ein **Premium-Feature** (`trash`, Premium/Enterprise).
+> Admins haben immer Zugriff.
+
+## Zugang
+
+Der Papierkorb ist über das Benutzermenü oder die Seitenleiste erreichbar.
+Ohne `trash`-Berechtigung erscheint ein Hinweis auf den Tarifwechsel.
+
+## Wiederherstellen
+
+- Markiere ein oder mehrere Tools (Checkboxen).
+- Klicke auf **Wiederherstellen (N)** — die Tools erscheinen wieder in allen
+  öffentlichen Ansichten.
+
+> Wiederherstellen steht jeder Person mit Papierkorb-Zugang zur Verfügung.
+
+## Endgültig löschen (nur Admin)
+
+- **Löschen (N)** entfernt die ausgewählten Tools **endgültig** — inklusive
+  aller Bewertungen, Kosten und Verknüpfungen. Das kann nicht rückgängig
+  gemacht werden.
+- **Papierkorb leeren** entfernt alle soft gelöschten Tools endgültig.
+
+## Tabelle
+
+Der Papierkorb listet: Name, Kategorie, **Gelöscht am** (`tt.MM.jjjj HH:mm`),
+**Gelöscht von** sowie Aktionen (Wiederherstellen; Löschen nur Admin). Die Suche
+filtert nach Namen.
+
+## API
+
+- [`GET /tools/trash`](/docs/reference/endpoints/tools#listTrashedTools) — Liste
+- [`POST /tools/trash/restore`](/docs/reference/endpoints/tools#restoreTools) — Wiederherstellen
+- [`DELETE /tools/trash`](/docs/reference/endpoints/tools#deleteTrashedTools) — Endgültig löschen (Admin)
+- [`POST /tools/trash/empty`](/docs/reference/endpoints/tools#emptyTrash) — Papierkorb leeren (Admin)

docs/handbook/plaene.en.md

@@ -0,0 +1,45 @@
+---
+title: Plans & Permissions
+order: 11
+---
+
+# Plans & Permissions
+
+toolr distinguishes **plans** (tier) and **roles**. Admins bypass all feature
+restrictions.
+
+## Plans
+
+| Plan | Description |
+| --- | --- |
+| **Free** | Basic functions: search, filter, view, analytics |
+| **Premium** | Additionally watchlist, compare, trash, costs |
+| **Enterprise** | All premium features + extended support |
+
+### Feature permissions
+
+Premium/Enterprise unlock the following features:
+
+| Feature | Function | Learn more |
+| --- | --- | --- |
+| `compare` | Compare tools | [Compare](/docs/handbook/vergleichen) |
+| `watchlist` | Favorites list | [Watchlist](/docs/handbook/watchlist) |
+| `trash` | Trash (soft-deleted tools) | [Trash](/docs/handbook/papierkorb) |
+| `costs` | Record cost/license models | [Recording costs](/docs/handbook/kosten) |
+
+If you are missing a feature, the app shows an **upgrade notice** with a link
+to the plan management.
+
+## Roles
+
+| Role | Permissions |
+| --- | --- |
+| **User** | Standard account: create/rate tools, edit your own tools |
+| **Admin** | All user rights + administration, audit log, redundancy, empty trash, tool links |
+
+Admins pass **all** feature checks — even without a premium plan.
+
+## Plan/role management
+
+The assignment of role and plan is managed by admins in the
+[Administration](/docs/handbook/administration) section (tab "Users").

docs/handbook/plaene.md

@@ -0,0 +1,45 @@
+---
+title: Pläne & Berechtigungen
+order: 11
+---
+
+# Pläne & Berechtigungen
+
+toolr unterscheidet **Tarife** (Tier) und **Rollen**. Admins umgehen alle
+Feature-Beschränkungen.
+
+## Tarife
+
+| Tarif | Beschreibung |
+| --- | --- |
+| **Free** | Grundfunktionen: suchen, filtern, ansehen, Analytics |
+| **Premium** | Zusätzlich Watchlist, Vergleichen, Papierkorb, Kosten |
+| **Enterprise** | Alle Premium-Features + erweiterter Support |
+
+### Feature-Berechtigungen
+
+Premium/Enterprise schalten folgende Features frei:
+
+| Feature | Funktion | Mehr erfahren |
+| --- | --- | --- |
+| `compare` | Tools vergleichen | [Vergleichen](/docs/handbook/vergleichen) |
+| `watchlist` | Favoritenliste | [Watchlist](/docs/handbook/watchlist) |
+| `trash` | Papierkorb (soft gelöschte Tools) | [Papierkorb](/docs/handbook/papierkorb) |
+| `costs` | Kosten-/Lizenzmodelle erfassen | [Kosten erfassen](/docs/handbook/kosten) |
+
+Fehlt dir ein Feature, zeigt die App einen **Upgrade-Hinweis** mit Link zur
+Tarifverwaltung.
+
+## Rollen
+
+| Rolle | Berechtigungen |
+| --- | --- |
+| **User** | Standard-Konto: Tools anlegen/bewerten, eigene Tools bearbeiten |
+| **Admin** | Alle User-Rechte + Verwaltung, Audit-Log, Redundanz, Papierkorb leeren, Tool-Verknüpfungen |
+
+Admins passieren **alle** Feature-Checks — auch ohne Premium-Tarif.
+
+## Tarif-/Rollenverwaltung
+
+Die Zuordnung von Rolle und Tarif wird durch Admins im Bereich
+[Administration](/docs/handbook/administration) (Tab „Nutzer") verwaltet.

docs/handbook/redundanz.en.md

@@ -0,0 +1,42 @@
+---
+title: Redundancy dashboard
+order: 14
+---
+
+# Redundancy dashboard
+
+The **Redundancy dashboard** (`/admin/redundancy`) is an admin tool for
+automatic detection of duplicate or strongly overlapping tools — per
+category — including cost and rating comparison.
+
+> Access is reserved exclusively for admins (the API is
+> admin-protected).
+
+## Layout
+
+- **Per category** a group is shown: name of the category,
+  number of tools and comparisons as well as the **total monthly costs**
+  if applicable (e.g. `€X.XX/mo total`).
+- Each tool is displayed as a card: name, monthly costs, number of
+  ratings, combined rating, license badges and number of features.
+
+## Comparisons & recommendations
+
+For each tool pair the following appears:
+
+- Tool A vs. Tool B, each with rating (`X.X ★`) and monthly costs.
+- **Overlap** in percent (progress bar in the middle).
+- A **recommendation** with confidence color:
+  - **high** (green), **medium** (yellow), **low** (gray)
+- The recommended, better tool is marked with a "thumbs up" and justified.
+
+## Manual rating
+
+You can rate a pair manually: click on Tool A or Tool B to
+record which one is better. The selection is saved and the
+display is updated.
+
+## API
+
+- [`GET /api/admin/redundancy`](#) — load data (admin-protected)
+- [`POST /api/admin/redundancy/evaluate`](#) — save manual rating

docs/handbook/redundanz.md

@@ -0,0 +1,42 @@
+---
+title: Redundanz-Dashboard
+order: 14
+---
+
+# Redundanz-Dashboard
+
+Das **Redundanz-Dashboard** (`/admin/redundancy`) ist ein Admin-Werkzeug zur
+automatischen Erkennung doppelter oder stark überlappender Tools — jeweils
+pro Kategorie — inklusive Kosten- und Bewertungsvergleich.
+
+> Der Zugriff ist ausschließlich Admins vorbehalten (die API ist
+> admin-geschützt).
+
+## Aufbau
+
+- **Pro Kategorie** wird eine Gruppe angezeigt: Name der Kategorie,
+  Anzahl Tools und Vergleiche sowie ggf. die **gesamten monatlichen Kosten**
+  (z. B. `€X.XX/mo gesamt`).
+- Jedes Tool wird als Karte dargestellt: Name, monatliche Kosten, Anzahl der
+  Bewertungen, kombinierte Bewertung, Lizenz-Badges und Feature-Anzahl.
+
+## Vergleiche & Empfehlungen
+
+Für jedes Tool-Paar erscheint:
+
+- Tool A vs. Tool B, jeweils mit Bewertung (`X.X ★`) und monatlichen Kosten.
+- **Überlappung** in Prozent (Fortschrittsbalken in der Mitte).
+- Eine **Empfehlung** mit Konfidenz-Farbe:
+  - **hoch** (grün), **mittel** (gelb), **niedrig** (grau)
+- Das empfohlene, bessere Tool wird mit „Daumen hoch" markiert und begründet.
+
+## Manuelle Bewertung
+
+Du kannst ein Paar manuell bewerten: Klicke auf Tool A oder Tool B, um
+festzuhalten, welches besser ist. Die Auswahl wird gespeichert und die
+Darstellung aktualisiert.
+
+## API
+
+- [`GET /api/admin/redundancy`](#) — Daten laden (admin-geschützt)
+- [`POST /api/admin/redundancy/evaluate`](#) — manuelle Bewertung speichern

docs/handbook/tastatur.en.md

@@ -0,0 +1,40 @@
+---
+title: Keyboard shortcuts & command palette
+order: 16
+---
+
+# Keyboard shortcuts & command palette
+
+## Command palette
+
+The command palette is the central quick navigation:
+
+- Open with **`⌘K`** (macOS) or **`Ctrl+K`** (Windows/Linux).
+- Alternatively via the search bar at the top right ("Search tools… ⌘K") or the
+  search icon on mobile devices.
+
+### Empty state
+
+Without input, the palette shows:
+
+- **Recently viewed** — the last 5 tools you visited.
+- **Navigation** — browse tools, add tool, analytics as well as
+  (depending on permissions) watchlist, trash and admin.
+
+### Search
+
+Type to search for tools live (max. 10 results, incl. rating
+`X.X★`).
+
+## Overview of keyboard shortcuts
+
+| Shortcut | Action |
+| --- | --- |
+| `⌘K` / `Ctrl+K` | Open command palette |
+| `/` | Focus search in the "Browse tools" area |
+
+## Additional notes
+
+- **Recently viewed** is stored locally in the browser (max. 5 entries).
+- The sidebar (left navigation) can be collapsed on desktop; the
+  breadcrumb at the top shows your current location.

docs/handbook/tastatur.md

@@ -0,0 +1,40 @@
+---
+title: Tastenkürzel & Kommandopalette
+order: 16
+---
+
+# Tastenkürzel & Kommandopalette
+
+## Kommandopalette
+
+Die Kommandopalette ist die zentrale Schnellnavigation:
+
+- Öffnen mit **`⌘K`** (macOS) bzw. **`Ctrl+K`** (Windows/Linux).
+- Alternativ über die Suchleiste oben rechts („Tools suchen… ⌘K") oder das
+  Such-Icon auf Mobilgeräten.
+
+### Leerer Zustand
+
+Ohne Eingabe zeigt die Palette:
+
+- **Zuletzt angesehen** — die letzten 5 Tools, die du besucht hast.
+- **Navigation** — Tools durchsuchen, Tool hinzufügen, Analytics sowie
+  (abhängig von Berechtigungen) Watchlist, Papierkorb und Admin.
+
+### Suche
+
+Tippe, um live nach Tools zu suchen (max. 10 Ergebnisse, inkl. Bewertung
+`X.X★`).
+
+## Tastenkürzel im Überblick
+
+| Kürzel | Aktion |
+| --- | --- |
+| `⌘K` / `Ctrl+K` | Kommandopalette öffnen |
+| `/` | Suche im Bereich „Tools durchsuchen" fokussieren |
+
+## Weitere Hinweise
+
+- **Zuletzt angesehen** wird lokal im Browser gespeichert (max. 5 Einträge).
+- Die Seitenleiste (linke Navigation) ist auf Desktop einklappbar; der
+  Breadcrumb oben zeigt deinen aktuellen Ort.

docs/handbook/tool-anlegen.en.md

@@ -0,0 +1,50 @@
+---
+title: Create a tool
+order: 5
+---
+
+# Create a tool
+
+To add a new tool to the catalog, click **Add tool**
+(`/tools/new`). Creating a tool requires an account — without being signed in
+a notice with a login button appears.
+
+## Form fields
+
+| Field | Required | Notes |
+| --- | --- | --- |
+| **Name** | Yes | At least 2 characters |
+| **Category** | Yes | Dropdown; new categories can be created directly |
+| **Website URL** | No | Valid URL (e.g. `https://...`) |
+| **Icon / Logo URL** | No | Valid URL; preview is shown live |
+| **Description** | Yes | At least 10 characters; describe what the tool does |
+| **Features** | No | Dynamic list with autocomplete (max. 6) |
+| **Tags** | No | Dynamic list with autocomplete |
+
+Next to each field, the **? icon** takes you directly to the corresponding
+field description in the [data model reference](/docs/reference/schemas/toolinput).
+
+### Category
+
+- Type to search for existing categories.
+- Select **+ Create "..."** to create a new category.
+
+### Features & tags
+
+- **Add feature** / **Add tag** appends a new row.
+- The input fields suggest existing features/tags
+  (autocomplete, max. 6 suggestions).
+- Use the **×** button to remove individual rows.
+- Features and tags help with filtering and finding tools again.
+
+## Save
+
+Click **Add tool**. After successful creation you will be redirected to the
+detail page of the new tool.
+
+## API
+
+- [`POST /tools`](/docs/reference/endpoints/tools#createTool) — create a tool
+- [`GET /categories`](/docs/reference/endpoints/tools#listCategories) — categories
+- [`GET /features/all`](/docs/reference/endpoints/tools#listAllFeatures) — features
+- [`GET /tags/all`](/docs/reference/endpoints/tools#listAllTags) — tags

docs/handbook/tool-anlegen.md

@@ -1,49 +1,50 @@
 ---
-title: Tool anlegen & bearbeiten
-order: 3
+title: Tool anlegen
+order: 5
 ---
 
-# Tool anlegen & bearbeiten
+# Tool anlegen
 
-## Neues Tool anlegen
+Um ein neues Tool zum Katalog hinzuzufügen, klicke auf **Tool hinzufügen**
+(`/tools/new`). Das Anlegen erfordert ein Konto — ohne Anmeldung erscheint ein
+Hinweis mit Login-Button.
 
-Unter **Tool hinzufügen** legst du ein neues Tool an. Die Felder entsprechen
-dem Eingabeschema [`ToolInput`](/docs/reference/schemas/toolinput):
+## Formularfelder
 
-| Feld | Pflicht | Bedeutung |
+| Feld | Pflicht | Hinweise |
 | --- | --- | --- |
-| **Name** | ja | Anzeigename des Tools (min. 2 Zeichen). |
-| **Beschreibung** | ja | Was tut das Tool, warum nutzen es Leute? (min. 10 Zeichen) |
-| **Kategorie** | ja | Zugeordnete Kategorie (aus bestehenden Kategorien wählbar). |
-| **Website-URL** | nein | Offizielle Website (`https://…`). |
-| **Icon-/Logo-URL** | nein | Direktlink zu einem Logo-Bild. |
-| **Features** | nein | Schlüsselfähigkeiten, z. B. „Echtzeit-Kollaboration“. Bereits bekannte Features sind auswählbar. |
-| **Tags** | nein | Schlagwörter zum Auffinden. Bereits bekannte Tags sind auswählbar. |
+| **Name** | Ja | Mind. 2 Zeichen |
+| **Kategorie** | Ja | Auswahlliste; neue Kategorien lassen sich direkt anlegen |
+| **Website URL** | Nein | Gültige URL (z. B. `https://...`) |
+| **Icon / Logo URL** | Nein | Gültige URL; Vorschau wird live angezeigt |
+| **Beschreibung** | Ja | Mind. 10 Zeichen; beschreibe, was das Tool tut |
+| **Features** | Nein | Dynamische Liste mit Autovervollständigung (max. 6) |
+| **Tags** | Nein | Dynamische Liste mit Autovervollständigung |
 
-> Hinter jedem Label findest du ein **Hilfe-Icon (?)** — es verlinkt direkt
-> zur Feldbeschreibung in dieser Doku.
+Neben jedem Feld führt das **?‑Icon** direkt zur zugehörigen Feldbeschreibung
+in der [Datenmodell-Referenz](/docs/reference/schemas/toolinput).
 
-### Hinweise
+### Kategorie
 
-- **Features & Tags** sind Listen. Über **+ Feature / + Tag** fügst du weitere
-  Einträge hinzu; über das ✕-Symbol entfernst du sie.
-- URLs müssen absolut und gültig sein.
-- Leere Einträge in Feature-/Tag-Listen werden beim Speichern verworfen.
+- Tippe, um nach bestehenden Kategorien zu suchen.
+- Wähle **+ Erstelle „..."**, um eine neue Kategorie anzulegen.
 
-## Tool bearbeiten
+### Features & Tags
 
-Auf der Detailseite eines Tools öffnet **Bearbeiten** das Formular mit den
-aktuellen Werten. Du kannst Name, Beschreibung, Kategorie, URLs, Features und
-Tags ändern. Nur angemeldete Nutzer:innen können Tools bearbeiten.
+- **Feature hinzufügen** / **Tag hinzufügen** hängt eine neue Zeile an.
+- Die Eingabefelder schlagen bestehende Features/Tags vor
+  (Autovervollständigung, max. 6 Vorschläge).
+- Mit dem **×**‑Button entfernst du einzelne Zeilen.
+- Features und Tags helfen beim Filtern und Wiederfinden.
 
-## Tool löschen
+## Speichern
 
-Über die Detailseite kannst du ein Tool **in den Papierkorb verschieben**
-(Soft-Delete). Es verschwindet aus dem Katalog, bleibt aber im Papierkorb
-erhalten. Siehe [Administration & Papierkorb](/docs/handbook/administration).
+Klicke auf **Tool hinzufügen**. Nach erfolgreicher Anlage wirst du auf die
+Detailseite des neuen Tools weitergeleitet.
 
-## Zugehörige Endpunkte
+## API
 
-- [`POST /tools`](/docs/reference/endpoints/tools#createtool) — Tool anlegen
-- [`PATCH /tools/{id}`](/docs/reference/endpoints/tools#updatetool) — Tool bearbeiten
-- [`DELETE /tools/{id}`](/docs/reference/endpoints/tools#deletetool) — Tool löschen
+- [`POST /tools`](/docs/reference/endpoints/tools#createTool) — Tool anlegen
+- [`GET /categories`](/docs/reference/endpoints/tools#listCategories) — Kategorien
+- [`GET /features/all`](/docs/reference/endpoints/tools#listAllFeatures) — Features
+- [`GET /tags/all`](/docs/reference/endpoints/tools#listAllTags) — Tags

docs/handbook/tool-bearbeiten.en.md

@@ -0,0 +1,36 @@
+---
+title: Edit & delete tools
+order: 6
+---
+
+# Edit & delete tools
+
+## Editing
+
+On the detail page of a tool you will find the **Edit** button
+(only for the person who created the tool, as well as for admins).
+
+The edit page (`/tools/:id/edit`) contains the same fields as when
+creating (name, category, website/icon URL, description, features, tags) —
+already filled with the current values.
+
+- **Save** applies the changes.
+- **Cancel** takes you back to the detail page.
+
+API reference: [`PATCH /tools/{id}`](/docs/reference/endpoints/tools#updateTool).
+
+## Deleting
+
+Via **Delete** on the detail page the tool is removed. The behavior
+depends on your plan:
+
+- **With trash access** (Premium/Enterprise or Admin): the tool is
+  **soft deleted** — it disappears from all public views, but can
+  be restored or permanently deleted in the [trash](/docs/handbook/papierkorb).
+- **Without trash access:** the tool is **permanently** deleted and cannot
+  be restored.
+
+Deletion is only possible for the person who created the tool, as well as
+for admins.
+
+API reference: [`DELETE /tools/{id}`](/docs/reference/endpoints/tools#deleteTool).

docs/handbook/tool-bearbeiten.md

@@ -0,0 +1,37 @@
+---
+title: Tool bearbeiten & löschen
+order: 6
+---
+
+# Tool bearbeiten & löschen
+
+## Bearbeiten
+
+Auf der Detailseite eines Tools findest du die Schaltfläche **Bearbeiten**
+(nur für die Person, die das Tool angelegt hat, sowie für Admins).
+
+Die Bearbeitungsseite (`/tools/:id/edit`) enthält dieselben Felder wie beim
+Anlegen (Name, Kategorie, Website/Icon-URL, Beschreibung, Features, Tags) —
+bereits mit den aktuellen Werten befüllt.
+
+- **Speichern** übernimmt die Änderungen.
+- **Abbrechen** führt zurück zur Detailseite.
+
+API-Referenz: [`PATCH /tools/{id}`](/docs/reference/endpoints/tools#updateTool).
+
+## Löschen
+
+Über **Löschen** auf der Detailseite wird das Tool entfernt. Das Verhalten
+hängt von deinem Tarif ab:
+
+- **Mit Papierkorb-Zugang** (Premium/Enterprise oder Admin): Das Tool wird
+  **soft gelöscht** — es verschwindet aus allen öffentlichen Ansichten, kann
+  aber im [Papierkorb](/docs/handbook/papierkorb) wiederhergestellt oder
+  endgültig gelöscht werden.
+- **Ohne Papierkorb-Zugang:** Das Tool wird **endgültig** gelöscht und kann
+  nicht wiederhergestellt werden.
+
+Die Löschung ist nur für die Person, die das Tool angelegt hat, sowie für
+Admins möglich.
+
+API-Referenz: [`DELETE /tools/{id}`](/docs/reference/endpoints/tools#deleteTool).

docs/handbook/tools-finden.en.md

@@ -0,0 +1,70 @@
+---
+title: Find & browse tools
+order: 4
+---
+
+# Find & browse tools
+
+The **Browse tools** section (`/tools`) is your entry point to the catalog.
+Here you combine search, filters and sorting to find exactly the tools
+you are interested in.
+
+## Search
+
+- The **search bar** searches name and description (full text).
+- Shortcut: Press **`/`** to focus the search.
+- The input is debounced so that filtering happens immediately with each
+  keystroke.
+
+## Filter
+
+Via the **Filter** button (with a badge for the number of active filters)
+you open the filter popover with:
+
+- **Tags** — selection via checkboxes (scrollable list).
+- **Features** — selection via checkboxes.
+- **Minimum rating** — slider from 0 to 5 (in steps of 0.5); shows
+  e.g. "3.0+".
+
+Active filters appear as **removable chips** above the result list.
+Use **Reset filters** or **Remove all** to clear them again.
+
+## Sort
+
+The **Sort** dropdown offers the following options:
+
+| Sort | Description |
+| --- | --- |
+| Newest | New tools first |
+| Top rated | By combined rating |
+| Most rated | By number of ratings |
+| Name (A–Z) | Alphabetically ascending |
+| Name (Z–A) | Alphabetically descending |
+| Last updated | By last update |
+
+## View & density
+
+- **Switch view:** grid / table / rows.
+- **Density:** comfortable / compact (slider).
+
+Your selection is saved — locally in the browser and, for logged-in users,
+additionally on the server in the preferences. View, density, search, filters
+and sorting are reflected in the URL so you can share results.
+
+## Table view
+
+In the table view the columns **Tool**, **Rating** and **Number of
+ratings** are sortable. Hovering over a row shows a preview
+with rating details, tags and mini bars.
+
+## Selecting for comparison & watchlist
+
+- On every card/row you find a **compare icon** that lets you add tools to the
+  [compare bar](/docs/handbook/vergleichen).
+- The **bookmark icon** saves tools to your
+  [watchlist](/docs/handbook/watchlist) (only with the corresponding plan).
+
+## API
+
+All search, filter and sort parameters correspond to the query parameters of
+[`GET /tools`](/docs/reference/endpoints/tools#listTools).

docs/handbook/tools-finden.md

@@ -0,0 +1,71 @@
+---
+title: Tools finden & durchsuchen
+order: 4
+---
+
+# Tools finden & durchsuchen
+
+Der Bereich **Tools durchsuchen** (`/tools`) ist der Einstieg in den Katalog.
+Hier kombinierst du Suche, Filter und Sortierung, um genau die Tools zu finden,
+die dich interessieren.
+
+## Suche
+
+- Die **Suchleiste** durchsucht Name und Beschreibung (Volltext).
+- Tastenkürzel: Drücke **`/`**, um die Suche zu fokussieren.
+- Die Eingabe ist deaktiviert (Debounce), damit bei jedem Tastendruck sofort
+  nachgefiltert wird.
+
+## Filtern
+
+Über die Schaltfläche **Filter** (mit Badge für die Anzahl aktiver Filter)
+öffnest du den Filter-Popover mit:
+
+- **Tags** — Auswahl über Checkboxen (scrollbare Liste).
+- **Features** — Auswahl über Checkboxen.
+- **Mindestbewertung** — Schieberegler von 0 bis 5 (Schritte von 0,5); zeigt
+  z. B. „3.0+" an.
+
+Aktive Filter erscheinen als **entfernbare Chips** über der Ergebnisliste.
+Mit **Filter zurücksetzen** bzw. **Alle entfernen** räumst du sie wieder auf.
+
+## Sortieren
+
+Über das Dropdown **Sortieren** stehen folgende Optionen zur Verfügung:
+
+| Sortierung | Beschreibung |
+| --- | --- |
+| Neueste | Neue Tools zuerst |
+| Top bewertet | Nach kombinierter Bewertung |
+| Meistbewertet | Nach Anzahl der Bewertungen |
+| Name (A–Z) | Alphabetisch aufsteigend |
+| Name (Z–A) | Alphabetisch absteigend |
+| Zuletzt aktualisiert | Nach letztem Update |
+
+## Ansicht & Dichte
+
+- **Ansicht wechseln:** Raster / Tabelle / Zeilen.
+- **Dichte:** gemütlich / kompakt (Schieberegler).
+
+Deine Auswahl wird gespeichert — lokal im Browser und für angemeldete Nutzer:innen
+zusätzlich serverseitig in den Präferenzen. Ansicht, Dichte, Suche, Filter und
+Sortierung werden dabei in die URL übernommen, sodass du Ergebnisse teilen
+kannst.
+
+## Tabellenansicht
+
+In der Tabellenansicht sind die Spalten **Tool**, **Bewertung** und **Anzahl
+Bewertungen** sortierbar. Beim Überfahren einer Zeile erscheint eine Vorschau
+mit Bewertungsdetails, Tags und Mini-Balken.
+
+## Auswählen für Vergleich & Watchlist
+
+- Auf jeder Karte/Zeile findest du ein **Vergleichs-Icon**, mit dem du Tools zur
+  [Vergleichsleiste](/docs/handbook/vergleichen) hinzufügst.
+- Das **Lesezeichen-Icon** speichert Tools in deiner
+  [Watchlist](/docs/handbook/watchlist) (nur mit dem entsprechenden Tarif).
+
+## API
+
+Alle Such-, Filter- und Sortierparameter entsprechen den Query-Parametern von
+[`GET /tools`](/docs/reference/endpoints/tools#listTools).

docs/handbook/vergleichen-watchlist.md

@@ -1,46 +0,0 @@
----
-title: Vergleichen & Watchlist
-order: 5
----
-
-# Vergleichen & Watchlist
-
-Diese Funktionen sind für **Premium-Nutzer:innen** verfügbar.
-
-## Tools vergleichen
-
-Mit **Vergleichen** stellst du mehrere Tools nebeneinander und siehst deren
-Daten auf einen Blick — ideal für die Tool-Auswahl.
-
-1. Füge Tools über die **Vergleichsleiste** (Vergleichs-Icon auf Karten) hinzu.
-2. Öffne den Bereich **Vergleichen**. Die Tools erscheinen in der gewählten
-   Reihenfolge.
-3. Die Vergleichsansicht zeigt pro Tool die wichtigsten Felder und
-   Durchschnittswerte.
-
-Der zugrunde liegende Endpunkt ist
-[`GET /compare`](/docs/reference/endpoints/tools#listcomparetools) mit dem
-Parameter `ids` (kommagetrennt). Ohne Premium-Berechtigung liefert er `403`.
-
-## Watchlist
-
-Die **Watchlist** ist deine persönliche Favoritenliste:
-
-- **Hinzufügen/Entfernen:** Nutze das Lesezeichen-Symbol auf der
-  Tool-Karte oder der Detailseite.
-- Die gespeicherte Reihenfolge bleibt erhalten.
-- Sie wird über [`GET /auth/me/watchlist`](/docs/reference/endpoints/auth#getmewatchlist)
-  geladen; das Setzen erfolgt über
-  [`PUT /auth/me/preferences`](/docs/reference/endpoints/auth#updatemepreferences)
-  (Feld `watchlist`).
-
-### Feld `watchlist`
-
-Das Feld `watchlist` in [`UserPreferences`](/docs/reference/schemas/userpreferences)
-ist ein Array von Tool-IDs in gespeicherter Reihenfolge:
-
-| Feld | Typ | Bedeutung |
-| --- | --- | --- |
-| `view` | string | Ansichtsmodus (`grid`, `table`, `rows`). |
-| `density` | string | Dichte (`cozy`, `compact`). |
-| `watchlist` | integer[] | Tool-IDs in Favoriten-Reihenfolge. |

docs/handbook/vergleichen.en.md

@@ -0,0 +1,46 @@
+---
+title: Compare
+order: 9
+---
+
+# Compare
+
+With the compare function you can put several tools **side by side** —
+ideal for making a well-informed decision.
+
+> Comparing is a **premium feature** (Premium/Enterprise) and is always
+> available to admins.
+
+## Selecting tools
+
+1. In the **Browse tools** section, click the **compare icon** (scales) on
+   each card/row.
+2. The **compare bar** appears at the bottom with the selected tools as
+   chips. You can remove individual tools (×) or clear the selection.
+3. Click **Compare (N)** to go to the compare view.
+
+> Without a premium plan the button is locked (lock icon). The dialog takes
+> you to the plan switch
+> (see [Plans & permissions](/docs/handbook/plaene)).
+
+## The compare view
+
+The view shows a table with one column per tool. Rows:
+
+| Row | Content |
+| --- | --- |
+| **Rating** | Stars + value (e.g. `4.2/5`) |
+| **Usefulness** | Value (X.X/5) |
+| **Usability** | Value (X.X/5) |
+| **Number of ratings** | Count |
+| **Description** | Text |
+| **Features** | Badges |
+| **Tags** | Badges |
+| **Last updated** | Date |
+
+The **best value** per row is highlighted (with trophy icon).
+
+## API
+
+The compare view reads the data via
+[`GET /compare`](/docs/reference/endpoints/tools#listCompareTools).

docs/handbook/vergleichen.md

@@ -0,0 +1,46 @@
+---
+title: Vergleichen
+order: 9
+---
+
+# Vergleichen
+
+Mit der Vergleichsfunktion stellst du mehrere Tools **nebeneinander** gegenüber —
+ideal, um eine fundierte Entscheidung zu treffen.
+
+> Vergleichen ist ein **Premium-Feature** (Premium/Enterprise) und steht Admins
+> immer zur Verfügung.
+
+## Tools auswählen
+
+1. Im Bereich **Tools durchsuchen** klickst du auf jeder Karte/Zeile auf das
+   **Vergleichs-Icon** (Waage).
+2. Unten erscheint die **Vergleichsleiste** mit den ausgewählten Tools als
+   Chips. Du kannst einzelne Tools entfernen (×) oder die Auswahl leeren.
+3. Klicke auf **Vergleichen (N)**, um zur Vergleichsansicht zu gelangen.
+
+> Ohne Premium-Tarif ist der Button gesperrt (Schloss-Icon). Über den
+> Dialog gelangst du zum Tarifwechsel
+> (siehe [Pläne & Berechtigungen](/docs/handbook/plaene)).
+
+## Die Vergleichsansicht
+
+Die Ansicht zeigt eine Tabelle mit einer Spalte pro Tool. Zeilen:
+
+| Zeile | Inhalt |
+| --- | --- |
+| **Bewertung** | Sterne + Wert (z. B. `4.2/5`) |
+| **Nützlichkeit** | Wert (X.X/5) |
+| **Bedienbarkeit** | Wert (X.X/5) |
+| **Anzahl Bewertungen** | Anzahl |
+| **Beschreibung** | Text |
+| **Features** | Badges |
+| **Tags** | Badges |
+| **Zuletzt aktualisiert** | Datum |
+
+Der **beste Wert** pro Zeile wird hervorgehoben (mit Trophäen-Icon).
+
+## API
+
+Die Vergleichsansicht liest die Daten über
+[`GET /compare`](/docs/reference/endpoints/tools#listCompareTools).

docs/handbook/watchlist.en.md

@@ -0,0 +1,37 @@
+---
+title: Watchlist
+order: 8
+---
+
+# Watchlist
+
+The **watchlist** is a personal favorites list. You can open and compare the
+tools in it at any time with a click.
+
+> The watchlist is a **premium feature** (Premium/Enterprise) and is always
+> available to admins.
+
+## Prerequisite
+
+You need a plan with the `watchlist` permission. If it is missing, a note
+about switching plans appears at the bookmark
+(see [Plans & permissions](/docs/handbook/plaene)).
+
+## Saving a tool
+
+- On every card/row in the **Browse tools** section you will find the
+  **bookmark icon**.
+- A click saves the tool to your watchlist — the icon becomes filled.
+- Clicking it again removes it.
+
+## Viewing the watchlist
+
+Open the watchlist via the user menu or the sidebar. It shows all saved tools
+as cards. The filled bookmark on a card removes the tool from the list.
+
+## Where is the watchlist stored?
+
+The watchlist is a list of tool IDs in your **user preferences**. This way it
+is linked to your account across devices.
+
+API reference: [`GET /auth/me/watchlist`](/docs/reference/endpoints/auth#getMeWatchlist).

docs/handbook/watchlist.md

@@ -0,0 +1,38 @@
+---
+title: Watchlist
+order: 8
+---
+
+# Watchlist
+
+Die **Watchlist** ist eine persönliche Favoritenliste. Tools darin kannst du
+jederzeit per Klick wieder aufrufen und vergleichen.
+
+> Die Watchlist ist ein **Premium-Feature** (Premium/Enterprise) und steht
+> Admins immer zur Verfügung.
+
+## Voraussetzung
+
+Du benötigst einen Tarif mit `watchlist`-Berechtigung. Fehlt diese, erscheint
+beim Lesezeichen ein Hinweis auf den Tarifwechsel
+(siehe [Pläne & Berechtigungen](/docs/handbook/plaene)).
+
+## Tool speichern
+
+- Auf jeder Karte/Zeile im Bereich **Tools durchsuchen** findest du das
+  **Lesezeichen-Icon**.
+- Ein Klick speichert das Tool in deiner Watchlist — das Icon wird gefüllt.
+- Ein erneuter Klick entfernt es wieder.
+
+## Watchlist ansehen
+
+Öffne die Watchlist über das Benutzermenü oder die Seitenleiste. Sie zeigt alle
+gespeicherten Tools als Karten. Das gefüllte Lesezeichen auf einer Karte
+entfernt das Tool aus der Liste.
+
+## Wo wird die Watchlist gespeichert?
+
+Die Watchlist ist eine Liste von Tool-IDs in deinen **Benutzerpräferenzen**.
+Damit ist sie geräteübergreifend mit deinem Konto verbunden.
+
+API-Referenz: [`GET /auth/me/watchlist`](/docs/reference/endpoints/auth#getMeWatchlist).

docs/releases/TEMPLATE.md

@@ -5,7 +5,7 @@
 > nicht zutreffen entfernen. Die Seite wird unter `/docs/vX.Y.Z` in der App
 > angezeigt.
 
-**Datum:** YYYY-MM-DD · **Tag:** [`vX.Y.Z`](https://git.kubebase.de/admin/tool-evaluator/tags/vX.Y.Z)
+**Datum:** YYYY-MM-DD · **Tag:** [`vX.Y.Z`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/vX.Y.Z)
 
 ## Neue Features
 
@@ -32,4 +32,4 @@
 ## Links
 
 - Commit: [`<short-sha>`](https://git.kubebase.de/admin/tool-evaluator/commit/<short-sha>)
-- Tag: [`vX.Y.Z`](https://git.kubebase.de/admin/tool-evaluator/tags/vX.Y.Z)
+- Tag: [`vX.Y.Z`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/vX.Y.Z)

docs/releases/v0.6.0.en.md

@@ -0,0 +1,37 @@
+# v0.6.0 — Release Notes
+
+**Date:** 2026-08-03 · **Tag:** [`v0.6.0`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.6.0)
+
+## New features
+
+- Complete modernization of all dependencies to the current major versions
+  (TypeScript 7, Vite 8, React 19.2, openid-client 6, zod 4, recharts 3, react-day-picker 10).
+
+## Fixes & improvements
+
+- CI build fixed via `allowBuilds` configuration for pnpm 11
+  (build scripts for esbuild & Co. are no longer blocked).
+- Image tagging simplified: only `latest` and `v*` tags, no more `nightly-*`/`sha-*` tags.
+- All dependencies pinned exactly; automatic updates via Renovate prepared
+  (`renovate.json`, `docs/dependency-policy.md`).
+
+## API changes
+
+- No breaking changes to the API. openid-client internally migrated to v6
+  (auth flow behaves identically).
+
+## Operations / upgrade
+
+- **Env vars:** unchanged. Node image pinned to `node:24.18.1-alpine`.
+- **Migration:** no database migration required.
+- **Breaking changes:** none.
+
+## Known limitations
+
+- `typedoc` (indirect orval dependency) shows a peer-dependency warning
+  (expects TypeScript 5.x/6.x, 7.x is installed) — harmless for build and runtime.
+
+## Links
+
+- Commit: [`2f66fff`](https://git.kubebase.de/admin/tool-evaluator/commit/2f66fff)
+- Tag: [`v0.6.0`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.6.0)

docs/releases/v0.6.0.md

@@ -1,6 +1,6 @@
 # v0.6.0 — Release Notes
 
-**Datum:** 2026-08-03 · **Tag:** [`v0.6.0`](https://git.kubebase.de/admin/tool-evaluator/tags/v0.6.0)
+**Datum:** 2026-08-03 · **Tag:** [`v0.6.0`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.6.0)
 
 ## Neue Features
 
@@ -34,4 +34,4 @@
 ## Links
 
 - Commit: [`2f66fff`](https://git.kubebase.de/admin/tool-evaluator/commit/2f66fff)
-- Tag: [`v0.6.0`](https://git.kubebase.de/admin/tool-evaluator/tags/v0.6.0)
+- Tag: [`v0.6.0`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.6.0)

docs/releases/v0.7.0.en.md

@@ -0,0 +1,35 @@
+# v0.7.0 — Release Notes
+
+**Date:** 2026-08-03 · **Tag:** [`v0.7.0`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.7.0)
+
+## New features
+
+- Version-bound **release documentation** in the app under `/docs`
+  (index + detail page per version, Markdown from `docs/releases/`).
+- Generated release template (`docs/releases/TEMPLATE.md`) and
+  sync step for the frontend build.
+
+## Fixes & improvements
+
+- `tsx` bumped to 4.23.4 — last outdated dependency in the workspace
+  (`pnpm outdated -r` is now empty).
+
+## API changes
+
+- No breaking changes to the API.
+
+## Operations / upgrade
+
+- **Env vars:** unchanged.
+- **Migration:** none.
+- **Breaking changes:** none.
+
+## Known limitations
+
+- The documentation is currently limited to release notes; a complete
+  API/field reference will follow in v0.8.0.
+
+## Links
+
+- Commit: [`520f917`](https://git.kubebase.de/admin/tool-evaluator/commit/520f917)
+- Tag: [`v0.7.0`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.7.0)

docs/releases/v0.7.0.md

@@ -1,6 +1,6 @@
 # v0.7.0 — Release Notes
 
-**Datum:** 2026-08-03 · **Tag:** [`v0.7.0`](https://git.kubebase.de/admin/tool-evaluator/tags/v0.7.0)
+**Datum:** 2026-08-03 · **Tag:** [`v0.7.0`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.7.0)
 
 ## Neue Features
 
@@ -32,4 +32,4 @@
 ## Links
 
 - Commit: [`520f917`](https://git.kubebase.de/admin/tool-evaluator/commit/520f917)
-- Tag: [`v0.7.0`](https://git.kubebase.de/admin/tool-evaluator/tags/v0.7.0)
+- Tag: [`v0.7.0`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.7.0)

docs/releases/v0.8.0.en.md

@@ -0,0 +1,46 @@
+# v0.8.0 — Release Notes
+
+**Date:** 2026-08-03 · **Tag:** [`v0.8.0`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.8.0)
+
+## New features
+
+- **Complete documentation site** in mkdocs look under `/docs`:
+  - **Manual** with understandable explanations of all features
+    (Getting started, creating a tool, evaluations, comparing, watchlist,
+    analytics, administration, data model).
+  - **Automatically generated reference** from `lib/api-spec/openapi.yaml`:
+    all endpoints and data fields (type, required status, constraints) —
+    this guarantees that *every* feature is documented.
+  - **Search** across the manual, endpoints, and fields.
+  - **Version dropdown**: older releases keep their full field/endpoint
+    reference as a snapshot.
+  - **Repo link** to the source in the top right.
+- **Help buttons (?) in forms** (NetBox style): next to each field,
+  an icon jumps directly to the field description in the docs.
+
+## Fixes & improvements
+
+- Docs generator `scripts/src/generate-docs.mjs` replaces the previous
+  `sync-release-docs.mjs` (OpenAPI parsing, manual, search index, snapshots).
+- Documentation for v0.7.0 backfilled.
+
+## API changes
+
+- No breaking changes to the API.
+
+## Operations / upgrade
+
+- **Env vars:** unchanged.
+- **Migration:** none.
+- **Breaking changes:** none.
+
+## Known limitations
+
+- Manual & reference apply to the current version; older versions
+  show their release notes and a reference snapshot, if generated at
+  release time (`node scripts/src/generate-docs.mjs --snapshot vX.Y.Z`).
+
+## Links
+
+- Commit: [`6c92b63`](https://git.kubebase.de/admin/tool-evaluator/commit/6c92b63)
+- Tag: [`v0.8.0`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.8.0)

docs/releases/v0.8.0.md

@@ -1,6 +1,6 @@
 # v0.8.0 — Release Notes
 
-**Datum:** 2026-08-03 · **Tag:** [`v0.8.0`](https://git.kubebase.de/admin/tool-evaluator/tags/v0.8.0)
+**Datum:** 2026-08-03 · **Tag:** [`v0.8.0`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.8.0)
 
 ## Neue Features
 
@@ -43,4 +43,4 @@
 ## Links
 
 - Commit: [`6c92b63`](https://git.kubebase.de/admin/tool-evaluator/commit/6c92b63)
-- Tag: [`v0.8.0`](https://git.kubebase.de/admin/tool-evaluator/tags/v0.8.0)
+- Tag: [`v0.8.0`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.8.0)

docs/releases/v0.8.1.en.md

@@ -0,0 +1,47 @@
+# v0.8.1 — Release Notes
+
+**Date:** 2026-08-03 · **Tag:** [`v0.8.1`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.8.1)
+
+## New features
+
+- **Standalone docs page**: The documentation is now available as its own,
+  mkdocs-like page at `toolr.kubebase.de/docs` — without the app shell
+  (own header with repo link, version dropdown, search, theme toggle
+  and link back to the app).
+- **Navigation renamed**: The sidebar entry is now called **"Help"**
+  and leads to the standalone docs.
+- **User guide completely revised**: 17 manual pages with
+  step-by-step instructions for all features (finding tools, creating a
+  tool, evaluating, watchlist, comparing, costs, analytics, plans,
+  administration, redundancy, trash, keyboard shortcuts, data model).
+
+## Fixes & improvements
+
+- Reference links are now case-insensitive
+  (schema/endpoint slugs such as `toolinput` and `ToolInput` both work).
+- Manual links to endpoint anchors corrected (PascalCase operation IDs).
+- Outdated, broken manual links (`vergleichen`, `watchlist` …) replaced.
+- Documentation table headers and notice texts in the docs page
+  internationalized via i18n (de/en).
+
+## API changes
+
+- No changes to the API.
+
+## Operations / upgrade
+
+- **Env vars:** unchanged.
+- **Migration:** none.
+- **Breaking changes:** none. The docs page is reachable under `/docs` as
+  before; only the presentation is now standalone.
+
+## Known limitations
+
+- Manual & reference apply to the current version; older versions show
+  their release notes and a reference snapshot, if generated at release time
+  (`node scripts/src/generate-docs.mjs --snapshot vX.Y.Z`).
+
+## Links
+
+- Commit: [`fdf2d74`](https://git.kubebase.de/admin/tool-evaluator/commit/fdf2d74)
+- Tag: [`v0.8.1`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.8.1)

docs/releases/v0.8.1.md

@@ -0,0 +1,47 @@
+# v0.8.1 — Release Notes
+
+**Datum:** 2026-08-03 · **Tag:** [`v0.8.1`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.8.1)
+
+## Neue Features
+
+- **Standalone-Doku-Seite**: Die Dokumentation steht jetzt als eigene,
+  mkdocs-artige Seite unter `toolr.kubebase.de/docs` — ohne die App-Shell
+  (eigene Kopfzeile mit Repo-Link, Versions-Dropdown, Suche, Theme-Umschalter
+  und Link zurück zur App).
+- **Navigation umbenannt**: Der Seitenleisten-Eintrag heißt jetzt **„Hilfe"**
+  und führt zur Standalone-Doku.
+- **User Guide komplett überarbeitet**: 17 Handbuch-Seiten mit
+  Schritt-für-Schritt-Anleitungen für alle Funktionen (Tools finden, Tool
+  anlegen, Bewerten, Watchlist, Vergleichen, Kosten, Analytics, Pläne,
+  Administration, Redundanz, Papierkorb, Tastenkürzel, Datenmodell).
+
+## Fixes & Verbesserungen
+
+- Referenz-Links sind jetzt unabhängig von Groß-/Kleinschreibung
+  (Schema-/Endpoint-Slugs wie `toolinput` und `ToolInput` funktionieren beide).
+- Handbuch-Links auf Endpunkt-Anker korrigiert (PascalCase-OperationIds).
+- Veraltete, kaputte Handbuch-Links (`vergleichen`, `watchlist` …) ersetzt.
+- Dokumentations-Tabellenkopfzeilen und Hinweistexte in der Doku-Seite über
+  i18n internationalisiert (de/en).
+
+## API-Änderungen
+
+- Keine Änderungen an der API.
+
+## Betrieb / Upgrade
+
+- **Env-Vars:** unverändert.
+- **Migration:** keine.
+- **Breaking Changes:** keine. Die Doku-Seite ist unter `/docs` erreichbar wie
+  bisher; lediglich die Darstellung ist nun eigenständig.
+
+## Bekannte Einschränkungen
+
+- Handbuch & Referenz gelten für die aktuelle Version; ältere Versionen zeigen
+  ihre Release-Notes und einen Referenz-Snapshot, sofern beim Release erzeugt
+  (`node scripts/src/generate-docs.mjs --snapshot vX.Y.Z`).
+
+## Links
+
+- Commit: [`fdf2d74`](https://git.kubebase.de/admin/tool-evaluator/commit/fdf2d74)
+- Tag: [`v0.8.1`](https://git.kubebase.de/admin/tool-evaluator/releases/tag/v0.8.1)

docs/releases/v0.8.1/handbook/administration.en.md

@@ -0,0 +1,61 @@
+
+# Administration
+
+The **Admin** area (`/admin`) is exclusively accessible to admins.
+Without the admin role, access is denied.
+
+> At the top right, the **Redundancy dashboard** button leads to the automatic
+> duplicate detection (see [Redundancy](/docs/handbook/redundanz)).
+
+## "Users" tab
+
+Management of local accounts.
+
+- **Add user:** username (required), password (at least 6 characters),
+  email (optional), **role** (User/Admin), **plan** (Free/Premium/Enterprise).
+- **Edit user:** set role, plan and (for local accounts) a new password.
+  For OIDC accounts, password management is offered in the identity provider
+  (e.g. Keycloak).
+- **Delete user:** permanently removes the account (not for your own account).
+
+API reference:
+[`POST /users`](/docs/reference/endpoints/users#createUser),
+[`PATCH /users/{id}`](/docs/reference/endpoints/users#updateUser),
+[`DELETE /users/{id}`](/docs/reference/endpoints/users#deleteUser).
+
+## "Tools" tab
+
+Central access to the tool catalog.
+
+- **Search** for tools.
+- View, edit or move individual tools to the trash.
+- **Bulk action:** select multiple tools and move them to the trash
+  (confirmation dialog; soft-deleted tools are removed from all public views
+  and can be restored or permanently deleted).
+
+## "Audit log" tab
+
+Chronological log of all creation, change and deletion operations
+(max. 100 entries): action, entity + ID, timestamp, executing person and
+changed fields.
+
+API reference: [`GET /audit-logs`](/docs/reference/endpoints/audit#listAuditLogs).
+
+## "System" tab
+
+Version information of the running instance:
+
+- **Version** (e.g. `v0.8.1`),
+- **Commit** (7-digit SHA, linked to the repository),
+- **Build date**,
+- **Trash retention** ("N days" or "Forever").
+
+## Tool links (Admin)
+
+On the detail page of a tool you can manage **links** as an admin
+(own/"manual" as well as automatically detected ones):
+
+- **Link tool:** dialog with tool ID, **relationship type**
+  (Similar / Replaces / Superseded by) and optional notes.
+- Relationship types are displayed as badges on the detail page.
+- Manual links can be removed again via the trash icon.

docs/releases/v0.8.1/handbook/administration.md

@@ -0,0 +1,61 @@
+
+# Administration
+
+Der Bereich **Admin** (`/admin`) ist ausschließlich für Admins zugänglich.
+Ohne Admin-Rolle erscheint eine Zugriffsverweigerung.
+
+> Oben rechts führt die Schaltfläche **Redundanz-Dashboard** zur automatischen
+> Doppelungs-Erkennung (siehe [Redundanz](/docs/handbook/redundanz)).
+
+## Tab „Nutzer"
+
+Verwaltung der lokalen Konten.
+
+- **Nutzer hinzufügen:** Benutzername (Pflicht), Passwort (mind. 6 Zeichen),
+  E-Mail (optional), **Rolle** (User/Admin), **Tarif** (Free/Premium/Enterprise).
+- **Nutzer bearbeiten:** Rolle, Tarif und (für lokale Konten) ein neues Passwort
+  setzen. Für OIDC-Konten wird die Passwortverwaltung im Identitätsanbieter
+  (z. B. Keycloak) angeboten.
+- **Nutzer löschen:** Entfernt das Konto endgültig (nicht für das eigene Konto).
+
+API-Referenz:
+[`POST /users`](/docs/reference/endpoints/users#createUser),
+[`PATCH /users/{id}`](/docs/reference/endpoints/users#updateUser),
+[`DELETE /users/{id}`](/docs/reference/endpoints/users#deleteUser).
+
+## Tab „Tools"
+
+Zentraler Zugriff auf den Tool-Katalog.
+
+- **Suchen** nach Tools.
+- Tools einzeln ansehen, bearbeiten oder in den Papierkorb verschieben.
+- **Massenaktion:** mehrere Tools auswählen und in den Papierkorb verschieben
+  (Bestätigungsdialog; soft gelöschte Tools sind aus allen öffentlichen Ansichten
+  entfernt und können wiederhergestellt oder endgültig gelöscht werden).
+
+## Tab „Audit-Log"
+
+Chronologisches Protokoll aller Anlage-, Änderungs- und Löschvorgänge
+(max. 100 Einträge): Aktion, Entität + ID, Zeitstempel, ausführende Person und
+geänderte Felder.
+
+API-Referenz: [`GET /audit-logs`](/docs/reference/endpoints/audit#listAuditLogs).
+
+## Tab „System"
+
+Versionsinformationen der laufenden Instanz:
+
+- **Version** (z. B. `v0.8.1`),
+- **Commit** (7-stelliger SHA, verlinkt zum Repository),
+- **Build-Datum**,
+- **Papierkorb-Aufbewahrung** („N Tage" oder „Für immer").
+
+## Tool-Verknüpfungen (Admin)
+
+Auf der Detailseite eines Tools kannst du als Admin **Verknüpfungen**
+(eigene/„manual" sowie automatisch erkannte) verwalten:
+
+- **Tool verknüpfen:** Dialog mit Tool-ID, **Beziehungstyp**
+  (Ähnlich / Ersetzt / Abgelöst durch) und optionalen Notizen.
+- Beziehungstypen werden als Badges auf der Detailseite angezeigt.
+- Manuelle Verknüpfungen lassen sich per Papierkorb-Icon wieder entfernen.

docs/releases/v0.8.1/handbook/analytics.en.md

@@ -0,0 +1,29 @@
+
+# Analytics
+
+The **Analytics** area (`/analytics`) is a public dashboard with
+metrics and charts based on all tools and ratings.
+
+## Metrics (KPI cards)
+
+- **Number of tools** — how many tools are recorded in the catalog.
+- **Number of ratings** — how many ratings were submitted in total.
+- **Active categories** — how many categories exist.
+- **Average rating** — global combined value.
+
+## Charts
+
+| Chart | Content |
+| --- | --- |
+| **Top 8 tools** | Bar chart of the tools with the highest combined score (0–5) |
+| **Tools per category** | Radar chart of the number of tools per category |
+| **Score distribution** | Two horizontal bar charts (usefulness & usability) per star |
+
+The charts are interactive (tooltips on hover).
+
+## API
+
+- [`GET /analytics/summary`](/docs/reference/endpoints/analytics#getAnalyticsSummary)
+- [`GET /analytics/top-tools`](/docs/reference/endpoints/analytics#getTopTools)
+- [`GET /analytics/by-category`](/docs/reference/endpoints/analytics#getAnalyticsByCategory)
+- [`GET /analytics/rating-distribution`](/docs/reference/endpoints/analytics#getRatingDistribution)

docs/releases/v0.8.1/handbook/analytics.md

@@ -0,0 +1,29 @@
+
+# Analytics
+
+Der Bereich **Analytics** (`/analytics`) ist ein öffentliches Dashboard mit
+Kennzahlen und Diagrammen auf Basis aller Tools und Bewertungen.
+
+## Kennzahlen (KPI-Karten)
+
+- **Anzahl Tools** — wie viele Tools sind im Katalog erfasst.
+- **Anzahl Bewertungen** — wie viele Bewertungen wurden insgesamt abgegeben.
+- **Aktive Kategorien** — wie viele Kategorien existieren.
+- **Durchschnittliche Bewertung** — globaler kombinierter Wert.
+
+## Diagramme
+
+| Diagramm | Inhalt |
+| --- | --- |
+| **Top 8 Tools** | Balkendiagramm der Tools mit der höchsten kombinierten Punktzahl (0–5) |
+| **Tools je Kategorie** | Radar-Diagramm der Tool-Anzahl pro Kategorie |
+| **Punkteverteilung** | Zwei horizontale Balken-Diagramme (Nützlichkeit & Bedienbarkeit) pro Stern |
+
+Die Diagramme sind interaktiv (Tooltips beim Überfahren).
+
+## API
+
+- [`GET /analytics/summary`](/docs/reference/endpoints/analytics#getAnalyticsSummary)
+- [`GET /analytics/top-tools`](/docs/reference/endpoints/analytics#getTopTools)
+- [`GET /analytics/by-category`](/docs/reference/endpoints/analytics#getAnalyticsByCategory)
+- [`GET /analytics/rating-distribution`](/docs/reference/endpoints/analytics#getRatingDistribution)

docs/releases/v0.8.1/handbook/bewerten.en.md

@@ -0,0 +1,39 @@
+
+# Rating
+
+On the detail page of a tool you can share your experience. Click on
+**Submit a rating** (requires an account).
+
+## Form fields
+
+| Field | Required | Notes |
+| --- | --- | --- |
+| **Usefulness** | Yes | 1–5 stars |
+| **Usability** | Yes | 1–5 stars |
+| **Comment** | No | Free text |
+| **Name** | No | Defaults to "Anonymous" |
+
+Next to the fields, the **? icon** links directly to the associated field
+description in the [data model reference](/docs/reference/schemas/ratinginput).
+
+## What happens after submitting?
+
+- Your rating is saved immediately and appears in the **rating list** of the
+  detail page.
+- The **averages** (usefulness, usability, combined) and the **score
+  distribution** are updated.
+- The **statistics** in the [Analytics](/docs/handbook/analytics) section are
+  recalculated.
+
+## Statistic sections on the detail page
+
+- **Rating overview:** usefulness & usability as an average with progress
+  bars.
+- **Score distribution:** number of ratings per star (1★–5★).
+- **History:** line chart of combined/individual values over time
+  (only visible once there are several ratings).
+
+## API
+
+- [`POST /tools/{id}/ratings`](/docs/reference/endpoints/ratings#createRating) — Submit a rating
+- [`GET /tools/{id}/ratings`](/docs/reference/endpoints/ratings#listToolRatings) — Ratings of a tool

docs/releases/v0.8.1/handbook/bewerten.md

@@ -0,0 +1,39 @@
+
+# Bewerten
+
+Auf der Detailseite eines Tools kannst du deine Erfahrung teilen. Klicke auf
+**Bewertung abgeben** (erfordert ein Konto).
+
+## Formularfelder
+
+| Feld | Pflicht | Hinweise |
+| --- | --- | --- |
+| **Nützlichkeit** | Ja | 1–5 Sterne |
+| **Bedienbarkeit** | Ja | 1–5 Sterne |
+| **Kommentar** | Nein | Freitext |
+| **Name** | Nein | Standard „Anonym" |
+
+Neben den Feldern führt das **?‑Icon** direkt zur zugehörigen Feldbeschreibung
+in der [Datenmodell-Referenz](/docs/reference/schemas/ratinginput).
+
+## Was passiert nach dem Abgeben?
+
+- Deine Bewertung wird sofort gespeichert und erscheint in der
+  **Bewertungsliste** der Detailseite.
+- Die **Durchschnittswerte** (Nützlichkeit, Bedienbarkeit, Kombiniert) und die
+  **Punkteverteilung** werden aktualisiert.
+- Die **Statistiken** im Bereich [Analytics](/docs/handbook/analytics) werden
+  neu berechnet.
+
+## Statistik-Bereiche auf der Detailseite
+
+- **Bewertungsübersicht:** Nützlichkeit & Bedienbarkeit als Durchschnitt mit
+  Fortschrittsbalken.
+- **Punkteverteilung:** Anzahl der Bewertungen pro Stern (1★–5★).
+- **Verlauf:** Linienchart der kombinierten/Teilwerte über die Zeit
+  (erst ab mehreren Bewertungen sichtbar).
+
+## API
+
+- [`POST /tools/{id}/ratings`](/docs/reference/endpoints/ratings#createRating) — Bewertung abgeben
+- [`GET /tools/{id}/ratings`](/docs/reference/endpoints/ratings#listToolRatings) — Bewertungen eines Tools

docs/releases/v0.8.1/handbook/datenmodell.en.md

@@ -0,0 +1,70 @@
+
+# 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](/docs/reference/schemas/tool).
+
+## 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`](/docs/reference/schemas/toolinput) and
+[`ToolUpdate`](/docs/reference/schemas/toolupdate).
+Aggregated views are provided by [`ToolWithStats`](/docs/reference/schemas/toolwithstats)
+(e.g. with average rating).
+
+## Rating (Bewertung)
+
+A single rating for a tool:
+
+- `usefulness` (Nützlichkeit, 1–5) and `usability` (Bedienbarkeit, 1–5)
+- optional `comment` and a display name (`reviewerName`)
+- timestamp
+
+Input schema: [`RatingInput`](/docs/reference/schemas/ratinginput).
+
+## User & Auth
+
+- [`User`](/docs/reference/schemas/user) — user account with role (User/Admin)
+  and plan (Free/Premium/Enterprise).
+- [`AuthUser`](/docs/reference/schemas/authuser) — the logged-in profile
+  including `entitlements` (available features).
+- [`UserPreferences`](/docs/reference/schemas/userpreferences) — view and
+  density preferences as well as the `watchlist` (list of tool IDs).
+
+## Analytics
+
+The statistics endpoints provide aggregated data:
+
+- [`AnalyticsSummary`](/docs/reference/schemas/analyticssummary) — global
+  metrics (number of tools/ratings, categories, average).
+- [`TopToolEntry`](/docs/reference/schemas/TopToolEntry) — an entry of the
+  top tools.- [`CategoryStats`](/docs/reference/schemas/categorystats) — number of tools per
+  category.
+- [`RatingDistribution`](/docs/reference/schemas/ratingdistribution) —
+  score distribution (usefulness & usability).
+- [`ScoreBucket`](/docs/reference/schemas/scorebucket) — a value bucket.
+
+## Additional
+
+- [`VersionInfo`](/docs/reference/schemas/versioninfo) — version, commit SHA,
+  build date and trash retention of the running instance.
+- [`AuditLog`](/docs/reference/schemas/auditlog) — a log entry
+  (action, entity, timestamp, actor, changes).

docs/releases/v0.8.1/handbook/datenmodell.md

@@ -0,0 +1,70 @@
+
+# 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](/docs/reference/schemas/tool).
+
+## 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`](/docs/reference/schemas/toolinput) und
+[`ToolUpdate`](/docs/reference/schemas/toolupdate).
+Aggregierte Ansichten liefert [`ToolWithStats`](/docs/reference/schemas/toolwithstats)
+(z. B. mit Durchschnittsbewertung).
+
+## Rating (Bewertung)
+
+Eine einzelne Bewertung zu einem Tool:
+
+- `usefulness` (Nützlichkeit, 1–5) und `usability` (Bedienbarkeit, 1–5)
+- optional `comment` und ein Anzeigename (`reviewerName`)
+- Zeitstempel
+
+Eingabe-Schema: [`RatingInput`](/docs/reference/schemas/ratinginput).
+
+## User & Auth
+
+- [`User`](/docs/reference/schemas/user) — Benutzerkonto mit Rolle (User/Admin)
+  und Tarif (Free/Premium/Enterprise).
+- [`AuthUser`](/docs/reference/schemas/authuser) — das angemeldete Profil
+  inklusive `entitlements` (verfügbare Features).
+- [`UserPreferences`](/docs/reference/schemas/userpreferences) — Ansichts- und
+  Dichte-Präferenzen sowie die `watchlist` (Liste von Tool-IDs).
+
+## Analytics
+
+Die Statistik-Endpunkte liefern aggregierte Daten:
+
+- [`AnalyticsSummary`](/docs/reference/schemas/analyticssummary) — globale
+  Kennzahlen (Anzahl Tools/Bewertungen, Kategorien, Durchschnitt).
+- [`TopToolEntry`](/docs/reference/schemas/TopToolEntry) — ein Eintrag der
+  Top-Tools.- [`CategoryStats`](/docs/reference/schemas/categorystats) — Tool-Anzahl je
+  Kategorie.
+- [`RatingDistribution`](/docs/reference/schemas/ratingdistribution) —
+  Punkteverteilung (Nützlichkeit & Bedienbarkeit).
+- [`ScoreBucket`](/docs/reference/schemas/scorebucket) — ein Werte-Bucket.
+
+## Weitere
+
+- [`VersionInfo`](/docs/reference/schemas/versioninfo) — Version, Commit-SHA,
+  Build-Datum und Papierkorb-Aufbewahrung der laufenden Instanz.
+- [`AuditLog`](/docs/reference/schemas/auditlog) — ein Protokolleintrag
+  (Aktion, Entität, Zeitstempel, Akteur, Änderungen).

docs/releases/v0.8.1/handbook/getting-started.en.md

@@ -0,0 +1,53 @@
+
+# Getting Started
+
+This page guides you through the most important workflows in toolr — from your
+first visit to creating and rating a tool.
+
+## 1. Sign in
+
+Most actions (create a tool, rate, watchlist, compare) require
+an account. Click **Sign in** in the bottom left corner. Depending on the
+instance configuration you have two options:
+
+- **Local accounts:** username + password. Access is created by an admin
+  (see [Administration](/docs/handbook/administration)).
+- **OIDC (SSO):** sign in with the configured identity provider (e.g.
+  Keycloak).
+
+Which mode is active is shown by the
+[`GET /auth/mode`](/docs/reference/endpoints/auth#getAuthMode) endpoint. Details
+can be found in the [Sign in & account](/docs/handbook/konto) section.
+
+## 2. Find tools
+
+Open the **Browse tools** section:
+
+- **Search** — full-text search across name & description (shortcut `/`).
+- **Filter** — by category, tags, features and minimum rating
+  (`minRating`).
+- **Sort** — by newest, top-rated, most rated, name
+  (ascending/descending) or last update.
+
+All options in detail: [Find & browse tools](/docs/handbook/tools-finden).
+
+## 3. Create a tool
+
+Go to **Add tool** and fill in the form. Details for each field can be found
+in the [Create a tool](/docs/handbook/tool-anlegen) section and in the
+[field reference](/docs/reference/schemas/toolinput).
+
+## 4. Rate
+
+On the detail page of a tool you can submit **usefulness** and **usability**
+(1–5 each) and optionally leave a comment. Your
+rating is immediately reflected in the statistics.
+See [Rating](/docs/handbook/bewerten).
+
+## 5. Further reading
+
+- [Compare tools](/docs/handbook/vergleichen)
+- [Watchlist](/docs/handbook/watchlist)
+- [Analytics](/docs/handbook/analytics)
+- [Plans & permissions](/docs/handbook/plaene)
+- [Administration](/docs/handbook/administration)

docs/releases/v0.8.1/handbook/getting-started.md

@@ -0,0 +1,53 @@
+
+# Erste Schritte
+
+Diese Seite führt dich durch die wichtigsten Abläufe in toolr — vom ersten
+Besuch bis zum Anlegen und Bewerten eines Tools.
+
+## 1. Anmelden
+
+Die meisten Aktionen (Tool anlegen, bewerten, Watchlist, Vergleichen) erfordern
+ein Konto. Klicke unten links auf **Anmelden**. Je nach Konfiguration der
+Instanz hast du zwei Möglichkeiten:
+
+- **Lokale Konten:** Benutzername + Passwort. Der Zugang wird von einem Admin
+  angelegt (siehe [Administration](/docs/handbook/administration)).
+- **OIDC (SSO):** Anmelden mit dem konfigurierten Identitätsanbieter (z. B.
+  Keycloak).
+
+Welcher Modus aktiv ist, steht im Endpunkt
+[`GET /auth/mode`](/docs/reference/endpoints/auth#getAuthMode). Details findest
+du im Abschnitt [Anmelden & Konto](/docs/handbook/konto).
+
+## 2. Tools finden
+
+Öffne den Bereich **Tools durchsuchen**:
+
+- **Suchen** — Volltextsuche über Name & Beschreibung (Tastenkürzel `/`).
+- **Filtern** — nach Kategorie, Tags, Features und Mindestbewertung
+  (`minRating`).
+- **Sortieren** — nach Aktualität, Top-Bewertung, meistbewertet, Name
+  (auf-/absteigend) oder letztem Update.
+
+Alle Optionen im Detail: [Tools finden & durchsuchen](/docs/handbook/tools-finden).
+
+## 3. Tool anlegen
+
+Gehe auf **Tool hinzufügen** und fülle das Formular aus. Details zu jedem Feld
+findest du im Abschnitt [Tool anlegen](/docs/handbook/tool-anlegen) und in der
+[Feld-Referenz](/docs/reference/schemas/toolinput).
+
+## 4. Bewerten
+
+Auf der Detailseite eines Tools kannst du **Nützlichkeit** und **Bedienbarkeit**
+(jeweils 1–5) vergeben und optional einen Kommentar hinterlassen. Deine
+Bewertung fließt sofort in die Statistiken ein.
+Siehe [Bewerten](/docs/handbook/bewerten).
+
+## 5. Weiterführend
+
+- [Tools vergleichen](/docs/handbook/vergleichen)
+- [Watchlist](/docs/handbook/watchlist)
+- [Analytics](/docs/handbook/analytics)
+- [Pläne & Berechtigungen](/docs/handbook/plaene)
+- [Administration](/docs/handbook/administration)

docs/releases/v0.8.1/handbook/index.en.md

@@ -0,0 +1,51 @@
+
+# Welcome to toolr
+
+toolr is a platform for **discovering, rating and comparing development
+tools**. Users maintain a shared catalog of tools, submit ratings
+(usefulness & usability) and use statistics to make the right choice.
+
+## What can you do with toolr?
+
+| Function | Description | Visibility |
+| --- | --- | --- |
+| **Browse tools** | Filter, sort and search the catalog | Everyone |
+| **Create a tool** | Add a new tool with description, category, features & tags | Logged in |
+| **Edit/delete tools** | Maintain your own tools (creator or admin) | Logged in |
+| **Rate** | Submit usefulness & usability (1–5) plus a comment | Logged in |
+| **Watchlist** | Save tools as favorites | Premium |
+| **Compare** | View tools side by side | Premium |
+| **Record costs** | Enter license and cost models per tool | Premium |
+| **Analytics** | Statistics, top tools, distributions | Everyone |
+| **Trash** | Restore soft-deleted tools or delete them permanently | Premium |
+| **Admin** | User management, audit log, system information | Admin |
+| **Redundancy detection** | Automatic duplicate detection | Admin |
+
+## How this documentation is organized
+
+- **User Guide** (these pages): step-by-step instructions for all
+  functions — from the [Getting Started](/docs/handbook/getting-started) to
+  [Administration](/docs/handbook/administration).
+- **API Reference**: automatically generated from the OpenAPI specification —
+  all [endpoints](/docs/reference/endpoints/tools) and
+  [data fields](/docs/reference/schemas/toolinput) of the current version.
+- **Release Notes**: what is new in each [version](/docs/releases/v0.8.1).
+
+## Getting started
+
+The fastest way:
+
+1. **Sign in** — without an account you can only browse
+   (see [Getting Started](/docs/handbook/getting-started#1-anmelden)).
+2. **Find tools** — search, filters and sorting in the
+   [Browse tools](/docs/handbook/tools-finden) section.
+3. **Create a tool** — via "Add tool"
+   ([guide](/docs/handbook/tool-anlegen)).
+4. **Rate** — on the detail page of a tool
+   ([guide](/docs/handbook/bewerten)).
+
+## Contact & source code
+
+The source code is available at
+[git.kubebase.de/admin/tool-evaluator](https://git.kubebase.de/admin/tool-evaluator) —
+you can reach it at any time via the repository icon in the top right corner.

docs/releases/v0.8.1/handbook/index.json

@@ -0,0 +1,138 @@
+[
+  {
+    "slug": "index",
+    "file": "index.md",
+    "title": "Überblick",
+    "order": 1,
+    "fileEn": "index.en.md",
+    "titleEn": "Overview"
+  },
+  {
+    "slug": "getting-started",
+    "file": "getting-started.md",
+    "title": "Erste Schritte",
+    "order": 2,
+    "fileEn": "getting-started.en.md",
+    "titleEn": "Getting Started"
+  },
+  {
+    "slug": "konto",
+    "file": "konto.md",
+    "title": "Anmelden & Konto",
+    "order": 3,
+    "fileEn": "konto.en.md",
+    "titleEn": "Login & Account"
+  },
+  {
+    "slug": "tools-finden",
+    "file": "tools-finden.md",
+    "title": "Tools finden & durchsuchen",
+    "order": 4,
+    "fileEn": "tools-finden.en.md",
+    "titleEn": "Find & browse tools"
+  },
+  {
+    "slug": "tool-anlegen",
+    "file": "tool-anlegen.md",
+    "title": "Tool anlegen",
+    "order": 5,
+    "fileEn": "tool-anlegen.en.md",
+    "titleEn": "Create a tool"
+  },
+  {
+    "slug": "tool-bearbeiten",
+    "file": "tool-bearbeiten.md",
+    "title": "Tool bearbeiten & löschen",
+    "order": 6,
+    "fileEn": "tool-bearbeiten.en.md",
+    "titleEn": "Edit & delete tools"
+  },
+  {
+    "slug": "bewerten",
+    "file": "bewerten.md",
+    "title": "Bewerten",
+    "order": 7,
+    "fileEn": "bewerten.en.md",
+    "titleEn": "Rating"
+  },
+  {
+    "slug": "watchlist",
+    "file": "watchlist.md",
+    "title": "Watchlist",
+    "order": 8,
+    "fileEn": "watchlist.en.md",
+    "titleEn": "Watchlist"
+  },
+  {
+    "slug": "vergleichen",
+    "file": "vergleichen.md",
+    "title": "Vergleichen",
+    "order": 9,
+    "fileEn": "vergleichen.en.md",
+    "titleEn": "Compare"
+  },
+  {
+    "slug": "analytics",
+    "file": "analytics.md",
+    "title": "Analytics",
+    "order": 10,
+    "fileEn": "analytics.en.md",
+    "titleEn": "Analytics"
+  },
+  {
+    "slug": "plaene",
+    "file": "plaene.md",
+    "title": "Pläne & Berechtigungen",
+    "order": 11,
+    "fileEn": "plaene.en.md",
+    "titleEn": "Plans & Permissions"
+  },
+  {
+    "slug": "kosten",
+    "file": "kosten.md",
+    "title": "Kosten erfassen",
+    "order": 12,
+    "fileEn": "kosten.en.md",
+    "titleEn": "Recording Costs"
+  },
+  {
+    "slug": "administration",
+    "file": "administration.md",
+    "title": "Administration",
+    "order": 13,
+    "fileEn": "administration.en.md",
+    "titleEn": "Administration"
+  },
+  {
+    "slug": "redundanz",
+    "file": "redundanz.md",
+    "title": "Redundanz-Dashboard",
+    "order": 14,
+    "fileEn": "redundanz.en.md",
+    "titleEn": "Redundancy dashboard"
+  },
+  {
+    "slug": "papierkorb",
+    "file": "papierkorb.md",
+    "title": "Papierkorb",
+    "order": 15,
+    "fileEn": "papierkorb.en.md",
+    "titleEn": "Trash"
+  },
+  {
+    "slug": "tastatur",
+    "file": "tastatur.md",
+    "title": "Tastenkürzel & Kommandopalette",
+    "order": 16,
+    "fileEn": "tastatur.en.md",
+    "titleEn": "Keyboard shortcuts & command palette"
+  },
+  {
+    "slug": "datenmodell",
+    "file": "datenmodell.md",
+    "title": "Datenmodell",
+    "order": 17,
+    "fileEn": "datenmodell.en.md",
+    "titleEn": "Data model"
+  }
+]

docs/releases/v0.8.1/handbook/index.md

@@ -0,0 +1,52 @@
+
+# Willkommen bei toolr
+
+toolr ist eine Plattform zum **Entdecken, Bewerten und Vergleichen von
+Entwicklungstools**. Nutzer:innen pflegen einen gemeinsamen Katalog von Tools,
+vergeben Bewertungen (Nützlichkeit & Bedienbarkeit) und nutzen Statistiken, um
+die richtige Wahl zu treffen.
+
+## Was kannst du mit toolr tun?
+
+| Funktion | Beschreibung | Sichtbarkeit |
+| --- | --- | --- |
+| **Tools durchsuchen** | Katalog filtern, sortieren und durchsuchen | Alle |
+| **Tool anlegen** | Neues Tool mit Beschreibung, Kategorie, Features & Tags eintragen | Angemeldet |
+| **Tool bearbeiten/löschen** | Eigene Tools pflegen (Ersteller:in oder Admin) | Angemeldet |
+| **Bewerten** | Nützlichkeit & Bedienbarkeit (1–5) plus Kommentar vergeben | Angemeldet |
+| **Watchlist** | Tools als Favoriten speichern | Premium |
+| **Vergleichen** | Tools nebeneinander gegenüberstellen | Premium |
+| **Kosten erfassen** | Lizenz- und Kostenmodelle je Tool eintragen | Premium |
+| **Analytics** | Statistiken, Top-Tools, Verteilungen | Alle |
+| **Papierkorb** | Soft-gelöschte Tools wiederherstellen oder endgültig löschen | Premium |
+| **Admin** | Nutzerverwaltung, Audit-Log, Systeminformationen | Admin |
+| **Redundanz** | Automatische Doppelungs-Erkennung | Admin |
+
+## Wie diese Doku aufgebaut ist
+
+- **User Guide** (diese Seiten): Schritt-für-Schritt-Anleitungen für alle
+  Funktionen — von den [Ersten Schritten](/docs/handbook/getting-started) bis
+  zur [Administration](/docs/handbook/administration).
+- **API-Referenz**: automatisch aus der OpenAPI-Spezifikation generiert — alle
+  [Endpunkte](/docs/reference/endpoints/tools) und
+  [Datenfelder](/docs/reference/schemas/toolinput) der aktuellen Version.
+- **Release-Notes**: Was ist in welcher [Version](/docs/releases/v0.8.1) neu.
+
+## Der Einstieg
+
+Der schnellste Weg:
+
+1. **Anmelden** — ohne Konto kannst du nur stöbern
+   (siehe [Erste Schritte](/docs/handbook/getting-started#1-anmelden)).
+2. **Tools finden** — Suche, Filter und Sortierung im Bereich
+   [Tools durchsuchen](/docs/handbook/tools-finden).
+3. **Tool anlegen** — über „Tool hinzufügen"
+   ([Anleitung](/docs/handbook/tool-anlegen)).
+4. **Bewerten** — auf der Detailseite eines Tools
+   ([Anleitung](/docs/handbook/bewerten)).
+
+## Kontakt & Quellcode
+
+Der Quellcode liegt unter
+[git.kubebase.de/admin/tool-evaluator](https://git.kubebase.de/admin/tool-evaluator) —
+über das Repository-Icon oben rechts erreichst du ihn jederzeit.

docs/releases/v0.8.1/handbook/konto.en.md

@@ -0,0 +1,52 @@
+
+# Login & Account
+
+## Logging in
+
+Click **Login** at the bottom left of the sidebar. Depending on the
+configuration of the instance:
+
+- **Local accounts:** enter username and password. The accounts are created
+  by an admin (see [Administration](/docs/handbook/administration)).
+- **OIDC (SSO):** you are redirected to the configured identity provider and
+  log in there.
+
+The active mode is available at the endpoint
+[`GET /auth/mode`](/docs/reference/endpoints/auth#getAuthMode).
+
+> You can reach the login page directly at `/login`. After a successful
+> login you are redirected back to the page you originally requested.
+
+## User profile
+
+You can see your profile (avatar, name, email, plan) at the bottom left in
+the user menu. There you have the following actions available:
+
+- **Watchlist** — your saved tools (only with the corresponding plan).
+- **Trash** — restorable, deleted tools (Premium/Enterprise).
+- **Change password** — directly in toolr for local accounts; for OIDC
+  accounts, password management is offered in the identity provider.
+- **Logout** — ends your session.
+
+## Changing your password (local account)
+
+1. Open the user menu at the bottom left.
+2. Select **Change password**.
+3. Enter the **current** and a **new** password (min. 6 characters) and
+   confirm it.
+4. Save — the password takes effect immediately.
+
+API reference: [`POST /auth/me/password`](/docs/reference/endpoints/auth#changeMyPassword).
+
+## Display settings
+
+Using the buttons at the top right you can:
+
+- switch the **language** (German / English),
+- toggle the **theme** (Light / Dark / System),
+- adjust the **list view** and **density** in the Browse tools section
+  (see [Finding & browsing tools](/docs/handbook/tools-finden)).
+
+Your preferences (incl. watchlist) are saved at the endpoint
+[`GET /auth/me/preferences`](/docs/reference/endpoints/auth#getMePreferences)
+and updated via [`PUT /auth/me/preferences`](/docs/reference/endpoints/auth#updateMePreferences).

docs/releases/v0.8.1/handbook/konto.md

@@ -0,0 +1,53 @@
+
+# Anmelden & Konto
+
+## Anmelden
+
+Klicke unten links in der Seitenleiste auf **Anmelden**. Je nach Konfiguration
+der Instanz:
+
+- **Lokale Konten:** Benutzername und Passwort eingeben. Die Konten werden von
+  einem Admin angelegt (siehe [Administration](/docs/handbook/administration)).
+- **OIDC (SSO):** Du wirst an den konfigurierten Identitätsanbieter
+  weitergeleitet und meldest dich dort an.
+
+Der aktive Modus steht im Endpunkt
+[`GET /auth/mode`](/docs/reference/endpoints/auth#getAuthMode).
+
+> Die Login-Seite erreichst du direkt unter `/login`. Nach erfolgreicher
+> Anmeldung wirst du zur ursprünglich aufgerufenen Seite zurückgeleitet.
+
+## Benutzerprofil
+
+Dein Profil (Avatar, Name, E-Mail, Tarif) siehst du unten links im
+Benutzermenü. Dort stehen dir folgende Aktionen zur Verfügung:
+
+- **Watchlist** — deine gespeicherten Tools (nur mit dem entsprechenden Tarif).
+- **Papierkorb** — wiederherstellbare, gelöschte Tools (Premium/Enterprise).
+- **Passwort ändern** — für lokale Konten direkt in toolr; für OIDC-Konten wird
+  die Passwortverwaltung im Identitätsanbieter angeboten.
+- **Abmelden** — beendet deine Sitzung.
+
+## Passwort ändern (lokales Konto)
+
+1. Öffne das Benutzermenü unten links.
+2. Wähle **Passwort ändern**.
+3. Gib das **aktuelle** sowie ein **neues** Passwort ein (mind. 6 Zeichen) und
+   bestätige es.
+4. Speichern — das Passwort wird sofort übernommen.
+
+API-Referenz: [`POST /auth/me/password`](/docs/reference/endpoints/auth#changeMyPassword).
+
+## Anzeigeeinstellungen
+
+Über die Schaltflächen oben rechts kannst du:
+
+- **Sprache** wechseln (Deutsch / Englisch),
+- **Theme** umschalten (Hell / Dunkel / System),
+- die **Listenansicht** und **Dichte** im Bereich Tools durchsuchen anpassen
+  (siehe [Tools finden & durchsuchen](/docs/handbook/tools-finden)).
+
+Deine Präferenzen (inkl. Watchlist) werden im Endpunkt
+[`GET /auth/me/preferences`](/docs/reference/endpoints/auth#getMePreferences)
+gespeichert und über [`PUT /auth/me/preferences`](/docs/reference/endpoints/auth#updateMePreferences)
+aktualisiert.

docs/releases/v0.8.1/handbook/kosten.en.md

@@ -0,0 +1,35 @@
+
+# Recording Costs
+
+On the detail page of a tool you can enter cost and license models so that
+the total costs per tool become transparent.
+
+> Costs is a **premium feature** (`costs`, Premium/Enterprise). Admins always
+> have access.
+
+## Adding costs
+
+Click **Add costs** in the costs section of the detail page and fill out the
+form:
+
+| Field | Notes |
+| --- | --- |
+| **License type** | Free / Subscription / One-Time / Usage-Based |
+| **Billing period** | Only for "Subscription": Monthly / Quarterly / Annually |
+| **Costs** | Amount as a number |
+| **Currency** | EUR / USD / GBP / CHF |
+| **Notes** | Optional free text |
+
+Saving creates the entry. Each cost entry is displayed as a card with
+license badge, billing period, amount (`Amount Currency` or "Free") and
+notes.
+
+## Editing & deleting costs
+
+Hovering over a cost card shows the **Edit** (pencil) and **Delete** (trash)
+actions.
+
+## API
+
+The cost data is managed via the tool endpoints
+(see [API reference](/docs/reference/endpoints/tools)).

docs/releases/v0.8.1/handbook/kosten.md

@@ -0,0 +1,35 @@
+
+# Kosten erfassen
+
+Auf der Detailseite eines Tools kannst du Kosten- und Lizenzmodelle eintragen,
+damit die Gesamtkosten je Tool transparent werden.
+
+> Kosten ist ein **Premium-Feature** (`costs`, Premium/Enterprise). Admins
+> haben immer Zugriff.
+
+## Kosten hinzufügen
+
+Klicke auf **Kosten hinzufügen** im Kosten-Bereich der Detailseite und fülle
+das Formular aus:
+
+| Feld | Hinweise |
+| --- | --- |
+| **Lizenztyp** | Free / Subscription / One-Time / Usage-Based |
+| **Abrechnungszeitraum** | Nur für „Subscription": Monatlich / Quartalsweise / Jährlich |
+| **Kosten** | Betrag als Zahl |
+| **Währung** | EUR / USD / GBP / CHF |
+| **Notizen** | Optionaler Freitext |
+
+Speichern legt den Eintrag an. Jeder Kosten-Eintrag wird als Karte mit
+Lizenz-Badge, Abrechnungszeitraum, Betrag (`Betrag Währung` bzw. „Free") und
+Notizen angezeigt.
+
+## Kosten bearbeiten & löschen
+
+Beim Überfahren einer Kosten-Karte erscheinen die Aktionen **Bearbeiten**
+(Bleistift) und **Löschen** (Papierkorb).
+
+## API
+
+Die Kosten-Daten werden über die Tool-Endpunkte verwaltet
+(siehe [API-Referenz](/docs/reference/endpoints/tools)).

docs/releases/v0.8.1/handbook/papierkorb.en.md

@@ -0,0 +1,40 @@
+
+# Trash
+
+The **trash** (`/trash`) contains soft-deleted tools. With trash access
+they can be restored; permanent deletion is reserved for admins.
+
+> The trash is a **premium feature** (`trash`, Premium/Enterprise).
+> Admins always have access.
+
+## Access
+
+The trash can be reached via the user menu or the sidebar.
+Without the `trash` permission, a hint about changing the plan appears.
+
+## Restoring
+
+- Select one or more tools (checkboxes).
+- Click on **Restore (N)** — the tools appear again in all
+  public views.
+
+> Restoring is available to anyone with trash access.
+
+## Permanently delete (admin only)
+
+- **Delete (N)** **permanently** removes the selected tools — including
+  all ratings, costs and links. This cannot be undone.
+- **Empty trash** permanently removes all soft-deleted tools.
+
+## Table
+
+The trash lists: name, category, **Deleted on** (`tt.MM.jjjj HH:mm`),
+**Deleted by** as well as actions (Restore; Delete admin only). The search
+filters by name.
+
+## API
+
+- [`GET /tools/trash`](/docs/reference/endpoints/tools#listTrashedTools) — list
+- [`POST /tools/trash/restore`](/docs/reference/endpoints/tools#restoreTools) — restore
+- [`DELETE /tools/trash`](/docs/reference/endpoints/tools#deleteTrashedTools) — permanently delete (admin)
+- [`POST /tools/trash/empty`](/docs/reference/endpoints/tools#emptyTrash) — empty trash (admin)

docs/releases/v0.8.1/handbook/papierkorb.md

@@ -0,0 +1,41 @@
+
+# Papierkorb
+
+Der **Papierkorb** (`/trash`) enthält soft gelöschte Tools. Mit Papierkorb-Zugang
+können sie wiederhergestellt werden; endgültiges Löschen ist Admins vorbehalten.
+
+> Der Papierkorb ist ein **Premium-Feature** (`trash`, Premium/Enterprise).
+> Admins haben immer Zugriff.
+
+## Zugang
+
+Der Papierkorb ist über das Benutzermenü oder die Seitenleiste erreichbar.
+Ohne `trash`-Berechtigung erscheint ein Hinweis auf den Tarifwechsel.
+
+## Wiederherstellen
+
+- Markiere ein oder mehrere Tools (Checkboxen).
+- Klicke auf **Wiederherstellen (N)** — die Tools erscheinen wieder in allen
+  öffentlichen Ansichten.
+
+> Wiederherstellen steht jeder Person mit Papierkorb-Zugang zur Verfügung.
+
+## Endgültig löschen (nur Admin)
+
+- **Löschen (N)** entfernt die ausgewählten Tools **endgültig** — inklusive
+  aller Bewertungen, Kosten und Verknüpfungen. Das kann nicht rückgängig
+  gemacht werden.
+- **Papierkorb leeren** entfernt alle soft gelöschten Tools endgültig.
+
+## Tabelle
+
+Der Papierkorb listet: Name, Kategorie, **Gelöscht am** (`tt.MM.jjjj HH:mm`),
+**Gelöscht von** sowie Aktionen (Wiederherstellen; Löschen nur Admin). Die Suche
+filtert nach Namen.
+
+## API
+
+- [`GET /tools/trash`](/docs/reference/endpoints/tools#listTrashedTools) — Liste
+- [`POST /tools/trash/restore`](/docs/reference/endpoints/tools#restoreTools) — Wiederherstellen
+- [`DELETE /tools/trash`](/docs/reference/endpoints/tools#deleteTrashedTools) — Endgültig löschen (Admin)
+- [`POST /tools/trash/empty`](/docs/reference/endpoints/tools#emptyTrash) — Papierkorb leeren (Admin)

docs/releases/v0.8.1/handbook/plaene.en.md

@@ -0,0 +1,41 @@
+
+# Plans & Permissions
+
+toolr distinguishes **plans** (tier) and **roles**. Admins bypass all feature
+restrictions.
+
+## Plans
+
+| Plan | Description |
+| --- | --- |
+| **Free** | Basic functions: search, filter, view, analytics |
+| **Premium** | Additionally watchlist, compare, trash, costs |
+| **Enterprise** | All premium features + extended support |
+
+### Feature permissions
+
+Premium/Enterprise unlock the following features:
+
+| Feature | Function | Learn more |
+| --- | --- | --- |
+| `compare` | Compare tools | [Compare](/docs/handbook/vergleichen) |
+| `watchlist` | Favorites list | [Watchlist](/docs/handbook/watchlist) |
+| `trash` | Trash (soft-deleted tools) | [Trash](/docs/handbook/papierkorb) |
+| `costs` | Record cost/license models | [Recording costs](/docs/handbook/kosten) |
+
+If you are missing a feature, the app shows an **upgrade notice** with a link
+to the plan management.
+
+## Roles
+
+| Role | Permissions |
+| --- | --- |
+| **User** | Standard account: create/rate tools, edit your own tools |
+| **Admin** | All user rights + administration, audit log, redundancy, empty trash, tool links |
+
+Admins pass **all** feature checks — even without a premium plan.
+
+## Plan/role management
+
+The assignment of role and plan is managed by admins in the
+[Administration](/docs/handbook/administration) section (tab "Users").

docs/releases/v0.8.1/handbook/plaene.md

@@ -0,0 +1,41 @@
+
+# Pläne & Berechtigungen
+
+toolr unterscheidet **Tarife** (Tier) und **Rollen**. Admins umgehen alle
+Feature-Beschränkungen.
+
+## Tarife
+
+| Tarif | Beschreibung |
+| --- | --- |
+| **Free** | Grundfunktionen: suchen, filtern, ansehen, Analytics |
+| **Premium** | Zusätzlich Watchlist, Vergleichen, Papierkorb, Kosten |
+| **Enterprise** | Alle Premium-Features + erweiterter Support |
+
+### Feature-Berechtigungen
+
+Premium/Enterprise schalten folgende Features frei:
+
+| Feature | Funktion | Mehr erfahren |
+| --- | --- | --- |
+| `compare` | Tools vergleichen | [Vergleichen](/docs/handbook/vergleichen) |
+| `watchlist` | Favoritenliste | [Watchlist](/docs/handbook/watchlist) |
+| `trash` | Papierkorb (soft gelöschte Tools) | [Papierkorb](/docs/handbook/papierkorb) |
+| `costs` | Kosten-/Lizenzmodelle erfassen | [Kosten erfassen](/docs/handbook/kosten) |
+
+Fehlt dir ein Feature, zeigt die App einen **Upgrade-Hinweis** mit Link zur
+Tarifverwaltung.
+
+## Rollen
+
+| Rolle | Berechtigungen |
+| --- | --- |
+| **User** | Standard-Konto: Tools anlegen/bewerten, eigene Tools bearbeiten |
+| **Admin** | Alle User-Rechte + Verwaltung, Audit-Log, Redundanz, Papierkorb leeren, Tool-Verknüpfungen |
+
+Admins passieren **alle** Feature-Checks — auch ohne Premium-Tarif.
+
+## Tarif-/Rollenverwaltung
+
+Die Zuordnung von Rolle und Tarif wird durch Admins im Bereich
+[Administration](/docs/handbook/administration) (Tab „Nutzer") verwaltet.

docs/releases/v0.8.1/handbook/redundanz.en.md

@@ -0,0 +1,38 @@
+
+# Redundancy dashboard
+
+The **Redundancy dashboard** (`/admin/redundancy`) is an admin tool for
+automatic detection of duplicate or strongly overlapping tools — per
+category — including cost and rating comparison.
+
+> Access is reserved exclusively for admins (the API is
+> admin-protected).
+
+## Layout
+
+- **Per category** a group is shown: name of the category,
+  number of tools and comparisons as well as the **total monthly costs**
+  if applicable (e.g. `€X.XX/mo total`).
+- Each tool is displayed as a card: name, monthly costs, number of
+  ratings, combined rating, license badges and number of features.
+
+## Comparisons & recommendations
+
+For each tool pair the following appears:
+
+- Tool A vs. Tool B, each with rating (`X.X ★`) and monthly costs.
+- **Overlap** in percent (progress bar in the middle).
+- A **recommendation** with confidence color:
+  - **high** (green), **medium** (yellow), **low** (gray)
+- The recommended, better tool is marked with a "thumbs up" and justified.
+
+## Manual rating
+
+You can rate a pair manually: click on Tool A or Tool B to
+record which one is better. The selection is saved and the
+display is updated.
+
+## API
+
+- [`GET /api/admin/redundancy`](#) — load data (admin-protected)
+- [`POST /api/admin/redundancy/evaluate`](#) — save manual rating

docs/releases/v0.8.1/handbook/redundanz.md

@@ -0,0 +1,38 @@
+
+# Redundanz-Dashboard
+
+Das **Redundanz-Dashboard** (`/admin/redundancy`) ist ein Admin-Werkzeug zur
+automatischen Erkennung doppelter oder stark überlappender Tools — jeweils
+pro Kategorie — inklusive Kosten- und Bewertungsvergleich.
+
+> Der Zugriff ist ausschließlich Admins vorbehalten (die API ist
+> admin-geschützt).
+
+## Aufbau
+
+- **Pro Kategorie** wird eine Gruppe angezeigt: Name der Kategorie,
+  Anzahl Tools und Vergleiche sowie ggf. die **gesamten monatlichen Kosten**
+  (z. B. `€X.XX/mo gesamt`).
+- Jedes Tool wird als Karte dargestellt: Name, monatliche Kosten, Anzahl der
+  Bewertungen, kombinierte Bewertung, Lizenz-Badges und Feature-Anzahl.
+
+## Vergleiche & Empfehlungen
+
+Für jedes Tool-Paar erscheint:
+
+- Tool A vs. Tool B, jeweils mit Bewertung (`X.X ★`) und monatlichen Kosten.
+- **Überlappung** in Prozent (Fortschrittsbalken in der Mitte).
+- Eine **Empfehlung** mit Konfidenz-Farbe:
+  - **hoch** (grün), **mittel** (gelb), **niedrig** (grau)
+- Das empfohlene, bessere Tool wird mit „Daumen hoch" markiert und begründet.
+
+## Manuelle Bewertung
+
+Du kannst ein Paar manuell bewerten: Klicke auf Tool A oder Tool B, um
+festzuhalten, welches besser ist. Die Auswahl wird gespeichert und die
+Darstellung aktualisiert.
+
+## API
+
+- [`GET /api/admin/redundancy`](#) — Daten laden (admin-geschützt)
+- [`POST /api/admin/redundancy/evaluate`](#) — manuelle Bewertung speichern

docs/releases/v0.8.1/handbook/tastatur.en.md

@@ -0,0 +1,36 @@
+
+# Keyboard shortcuts & command palette
+
+## Command palette
+
+The command palette is the central quick navigation:
+
+- Open with **`⌘K`** (macOS) or **`Ctrl+K`** (Windows/Linux).
+- Alternatively via the search bar at the top right ("Search tools… ⌘K") or the
+  search icon on mobile devices.
+
+### Empty state
+
+Without input, the palette shows:
+
+- **Recently viewed** — the last 5 tools you visited.
+- **Navigation** — browse tools, add tool, analytics as well as
+  (depending on permissions) watchlist, trash and admin.
+
+### Search
+
+Type to search for tools live (max. 10 results, incl. rating
+`X.X★`).
+
+## Overview of keyboard shortcuts
+
+| Shortcut | Action |
+| --- | --- |
+| `⌘K` / `Ctrl+K` | Open command palette |
+| `/` | Focus search in the "Browse tools" area |
+
+## Additional notes
+
+- **Recently viewed** is stored locally in the browser (max. 5 entries).
+- The sidebar (left navigation) can be collapsed on desktop; the
+  breadcrumb at the top shows your current location.

docs/releases/v0.8.1/handbook/tastatur.md

@@ -0,0 +1,36 @@
+
+# Tastenkürzel & Kommandopalette
+
+## Kommandopalette
+
+Die Kommandopalette ist die zentrale Schnellnavigation:
+
+- Öffnen mit **`⌘K`** (macOS) bzw. **`Ctrl+K`** (Windows/Linux).
+- Alternativ über die Suchleiste oben rechts („Tools suchen… ⌘K") oder das
+  Such-Icon auf Mobilgeräten.
+
+### Leerer Zustand
+
+Ohne Eingabe zeigt die Palette:
+
+- **Zuletzt angesehen** — die letzten 5 Tools, die du besucht hast.
+- **Navigation** — Tools durchsuchen, Tool hinzufügen, Analytics sowie
+  (abhängig von Berechtigungen) Watchlist, Papierkorb und Admin.
+
+### Suche
+
+Tippe, um live nach Tools zu suchen (max. 10 Ergebnisse, inkl. Bewertung
+`X.X★`).
+
+## Tastenkürzel im Überblick
+
+| Kürzel | Aktion |
+| --- | --- |
+| `⌘K` / `Ctrl+K` | Kommandopalette öffnen |
+| `/` | Suche im Bereich „Tools durchsuchen" fokussieren |
+
+## Weitere Hinweise
+
+- **Zuletzt angesehen** wird lokal im Browser gespeichert (max. 5 Einträge).
+- Die Seitenleiste (linke Navigation) ist auf Desktop einklappbar; der
+  Breadcrumb oben zeigt deinen aktuellen Ort.

docs/releases/v0.8.1/handbook/tool-anlegen.en.md

@@ -0,0 +1,46 @@
+
+# Create a tool
+
+To add a new tool to the catalog, click **Add tool**
+(`/tools/new`). Creating a tool requires an account — without being signed in
+a notice with a login button appears.
+
+## Form fields
+
+| Field | Required | Notes |
+| --- | --- | --- |
+| **Name** | Yes | At least 2 characters |
+| **Category** | Yes | Dropdown; new categories can be created directly |
+| **Website URL** | No | Valid URL (e.g. `https://...`) |
+| **Icon / Logo URL** | No | Valid URL; preview is shown live |
+| **Description** | Yes | At least 10 characters; describe what the tool does |
+| **Features** | No | Dynamic list with autocomplete (max. 6) |
+| **Tags** | No | Dynamic list with autocomplete |
+
+Next to each field, the **? icon** takes you directly to the corresponding
+field description in the [data model reference](/docs/reference/schemas/toolinput).
+
+### Category
+
+- Type to search for existing categories.
+- Select **+ Create "..."** to create a new category.
+
+### Features & tags
+
+- **Add feature** / **Add tag** appends a new row.
+- The input fields suggest existing features/tags
+  (autocomplete, max. 6 suggestions).
+- Use the **×** button to remove individual rows.
+- Features and tags help with filtering and finding tools again.
+
+## Save
+
+Click **Add tool**. After successful creation you will be redirected to the
+detail page of the new tool.
+
+## API
+
+- [`POST /tools`](/docs/reference/endpoints/tools#createTool) — create a tool
+- [`GET /categories`](/docs/reference/endpoints/tools#listCategories) — categories
+- [`GET /features/all`](/docs/reference/endpoints/tools#listAllFeatures) — features
+- [`GET /tags/all`](/docs/reference/endpoints/tools#listAllTags) — tags

docs/releases/v0.8.1/handbook/tool-anlegen.md

@@ -0,0 +1,46 @@
+
+# Tool anlegen
+
+Um ein neues Tool zum Katalog hinzuzufügen, klicke auf **Tool hinzufügen**
+(`/tools/new`). Das Anlegen erfordert ein Konto — ohne Anmeldung erscheint ein
+Hinweis mit Login-Button.
+
+## Formularfelder
+
+| Feld | Pflicht | Hinweise |
+| --- | --- | --- |
+| **Name** | Ja | Mind. 2 Zeichen |
+| **Kategorie** | Ja | Auswahlliste; neue Kategorien lassen sich direkt anlegen |
+| **Website URL** | Nein | Gültige URL (z. B. `https://...`) |
+| **Icon / Logo URL** | Nein | Gültige URL; Vorschau wird live angezeigt |
+| **Beschreibung** | Ja | Mind. 10 Zeichen; beschreibe, was das Tool tut |
+| **Features** | Nein | Dynamische Liste mit Autovervollständigung (max. 6) |
+| **Tags** | Nein | Dynamische Liste mit Autovervollständigung |
+
+Neben jedem Feld führt das **?‑Icon** direkt zur zugehörigen Feldbeschreibung
+in der [Datenmodell-Referenz](/docs/reference/schemas/toolinput).
+
+### Kategorie
+
+- Tippe, um nach bestehenden Kategorien zu suchen.
+- Wähle **+ Erstelle „..."**, um eine neue Kategorie anzulegen.
+
+### Features & Tags
+
+- **Feature hinzufügen** / **Tag hinzufügen** hängt eine neue Zeile an.
+- Die Eingabefelder schlagen bestehende Features/Tags vor
+  (Autovervollständigung, max. 6 Vorschläge).
+- Mit dem **×**‑Button entfernst du einzelne Zeilen.
+- Features und Tags helfen beim Filtern und Wiederfinden.
+
+## Speichern
+
+Klicke auf **Tool hinzufügen**. Nach erfolgreicher Anlage wirst du auf die
+Detailseite des neuen Tools weitergeleitet.
+
+## API
+
+- [`POST /tools`](/docs/reference/endpoints/tools#createTool) — Tool anlegen
+- [`GET /categories`](/docs/reference/endpoints/tools#listCategories) — Kategorien
+- [`GET /features/all`](/docs/reference/endpoints/tools#listAllFeatures) — Features
+- [`GET /tags/all`](/docs/reference/endpoints/tools#listAllTags) — Tags

docs/releases/v0.8.1/handbook/tool-bearbeiten.en.md

@@ -0,0 +1,32 @@
+
+# Edit & delete tools
+
+## Editing
+
+On the detail page of a tool you will find the **Edit** button
+(only for the person who created the tool, as well as for admins).
+
+The edit page (`/tools/:id/edit`) contains the same fields as when
+creating (name, category, website/icon URL, description, features, tags) —
+already filled with the current values.
+
+- **Save** applies the changes.
+- **Cancel** takes you back to the detail page.
+
+API reference: [`PATCH /tools/{id}`](/docs/reference/endpoints/tools#updateTool).
+
+## Deleting
+
+Via **Delete** on the detail page the tool is removed. The behavior
+depends on your plan:
+
+- **With trash access** (Premium/Enterprise or Admin): the tool is
+  **soft deleted** — it disappears from all public views, but can
+  be restored or permanently deleted in the [trash](/docs/handbook/papierkorb).
+- **Without trash access:** the tool is **permanently** deleted and cannot
+  be restored.
+
+Deletion is only possible for the person who created the tool, as well as
+for admins.
+
+API reference: [`DELETE /tools/{id}`](/docs/reference/endpoints/tools#deleteTool).

docs/releases/v0.8.1/handbook/tool-bearbeiten.md

@@ -0,0 +1,33 @@
+
+# Tool bearbeiten & löschen
+
+## Bearbeiten
+
+Auf der Detailseite eines Tools findest du die Schaltfläche **Bearbeiten**
+(nur für die Person, die das Tool angelegt hat, sowie für Admins).
+
+Die Bearbeitungsseite (`/tools/:id/edit`) enthält dieselben Felder wie beim
+Anlegen (Name, Kategorie, Website/Icon-URL, Beschreibung, Features, Tags) —
+bereits mit den aktuellen Werten befüllt.
+
+- **Speichern** übernimmt die Änderungen.
+- **Abbrechen** führt zurück zur Detailseite.
+
+API-Referenz: [`PATCH /tools/{id}`](/docs/reference/endpoints/tools#updateTool).
+
+## Löschen
+
+Über **Löschen** auf der Detailseite wird das Tool entfernt. Das Verhalten
+hängt von deinem Tarif ab:
+
+- **Mit Papierkorb-Zugang** (Premium/Enterprise oder Admin): Das Tool wird
+  **soft gelöscht** — es verschwindet aus allen öffentlichen Ansichten, kann
+  aber im [Papierkorb](/docs/handbook/papierkorb) wiederhergestellt oder
+  endgültig gelöscht werden.
+- **Ohne Papierkorb-Zugang:** Das Tool wird **endgültig** gelöscht und kann
+  nicht wiederhergestellt werden.
+
+Die Löschung ist nur für die Person, die das Tool angelegt hat, sowie für
+Admins möglich.
+
+API-Referenz: [`DELETE /tools/{id}`](/docs/reference/endpoints/tools#deleteTool).

docs/releases/v0.8.1/handbook/tools-finden.en.md

@@ -0,0 +1,66 @@
+
+# Find & browse tools
+
+The **Browse tools** section (`/tools`) is your entry point to the catalog.
+Here you combine search, filters and sorting to find exactly the tools
+you are interested in.
+
+## Search
+
+- The **search bar** searches name and description (full text).
+- Shortcut: Press **`/`** to focus the search.
+- The input is debounced so that filtering happens immediately with each
+  keystroke.
+
+## Filter
+
+Via the **Filter** button (with a badge for the number of active filters)
+you open the filter popover with:
+
+- **Tags** — selection via checkboxes (scrollable list).
+- **Features** — selection via checkboxes.
+- **Minimum rating** — slider from 0 to 5 (in steps of 0.5); shows
+  e.g. "3.0+".
+
+Active filters appear as **removable chips** above the result list.
+Use **Reset filters** or **Remove all** to clear them again.
+
+## Sort
+
+The **Sort** dropdown offers the following options:
+
+| Sort | Description |
+| --- | --- |
+| Newest | New tools first |
+| Top rated | By combined rating |
+| Most rated | By number of ratings |
+| Name (A–Z) | Alphabetically ascending |
+| Name (Z–A) | Alphabetically descending |
+| Last updated | By last update |
+
+## View & density
+
+- **Switch view:** grid / table / rows.
+- **Density:** comfortable / compact (slider).
+
+Your selection is saved — locally in the browser and, for logged-in users,
+additionally on the server in the preferences. View, density, search, filters
+and sorting are reflected in the URL so you can share results.
+
+## Table view
+
+In the table view the columns **Tool**, **Rating** and **Number of
+ratings** are sortable. Hovering over a row shows a preview
+with rating details, tags and mini bars.
+
+## Selecting for comparison & watchlist
+
+- On every card/row you find a **compare icon** that lets you add tools to the
+  [compare bar](/docs/handbook/vergleichen).
+- The **bookmark icon** saves tools to your
+  [watchlist](/docs/handbook/watchlist) (only with the corresponding plan).
+
+## API
+
+All search, filter and sort parameters correspond to the query parameters of
+[`GET /tools`](/docs/reference/endpoints/tools#listTools).

docs/releases/v0.8.1/handbook/tools-finden.md

@@ -0,0 +1,67 @@
+
+# Tools finden & durchsuchen
+
+Der Bereich **Tools durchsuchen** (`/tools`) ist der Einstieg in den Katalog.
+Hier kombinierst du Suche, Filter und Sortierung, um genau die Tools zu finden,
+die dich interessieren.
+
+## Suche
+
+- Die **Suchleiste** durchsucht Name und Beschreibung (Volltext).
+- Tastenkürzel: Drücke **`/`**, um die Suche zu fokussieren.
+- Die Eingabe ist deaktiviert (Debounce), damit bei jedem Tastendruck sofort
+  nachgefiltert wird.
+
+## Filtern
+
+Über die Schaltfläche **Filter** (mit Badge für die Anzahl aktiver Filter)
+öffnest du den Filter-Popover mit:
+
+- **Tags** — Auswahl über Checkboxen (scrollbare Liste).
+- **Features** — Auswahl über Checkboxen.
+- **Mindestbewertung** — Schieberegler von 0 bis 5 (Schritte von 0,5); zeigt
+  z. B. „3.0+" an.
+
+Aktive Filter erscheinen als **entfernbare Chips** über der Ergebnisliste.
+Mit **Filter zurücksetzen** bzw. **Alle entfernen** räumst du sie wieder auf.
+
+## Sortieren
+
+Über das Dropdown **Sortieren** stehen folgende Optionen zur Verfügung:
+
+| Sortierung | Beschreibung |
+| --- | --- |
+| Neueste | Neue Tools zuerst |
+| Top bewertet | Nach kombinierter Bewertung |
+| Meistbewertet | Nach Anzahl der Bewertungen |
+| Name (A–Z) | Alphabetisch aufsteigend |
+| Name (Z–A) | Alphabetisch absteigend |
+| Zuletzt aktualisiert | Nach letztem Update |
+
+## Ansicht & Dichte
+
+- **Ansicht wechseln:** Raster / Tabelle / Zeilen.
+- **Dichte:** gemütlich / kompakt (Schieberegler).
+
+Deine Auswahl wird gespeichert — lokal im Browser und für angemeldete Nutzer:innen
+zusätzlich serverseitig in den Präferenzen. Ansicht, Dichte, Suche, Filter und
+Sortierung werden dabei in die URL übernommen, sodass du Ergebnisse teilen
+kannst.
+
+## Tabellenansicht
+
+In der Tabellenansicht sind die Spalten **Tool**, **Bewertung** und **Anzahl
+Bewertungen** sortierbar. Beim Überfahren einer Zeile erscheint eine Vorschau
+mit Bewertungsdetails, Tags und Mini-Balken.
+
+## Auswählen für Vergleich & Watchlist
+
+- Auf jeder Karte/Zeile findest du ein **Vergleichs-Icon**, mit dem du Tools zur
+  [Vergleichsleiste](/docs/handbook/vergleichen) hinzufügst.
+- Das **Lesezeichen-Icon** speichert Tools in deiner
+  [Watchlist](/docs/handbook/watchlist) (nur mit dem entsprechenden Tarif).
+
+## API
+
+Alle Such-, Filter- und Sortierparameter entsprechen den Query-Parametern von
+[`GET /tools`](/docs/reference/endpoints/tools#listTools).

docs/releases/v0.8.1/handbook/vergleichen.en.md

@@ -0,0 +1,42 @@
+
+# Compare
+
+With the compare function you can put several tools **side by side** —
+ideal for making a well-informed decision.
+
+> Comparing is a **premium feature** (Premium/Enterprise) and is always
+> available to admins.
+
+## Selecting tools
+
+1. In the **Browse tools** section, click the **compare icon** (scales) on
+   each card/row.
+2. The **compare bar** appears at the bottom with the selected tools as
+   chips. You can remove individual tools (×) or clear the selection.
+3. Click **Compare (N)** to go to the compare view.
+
+> Without a premium plan the button is locked (lock icon). The dialog takes
+> you to the plan switch
+> (see [Plans & permissions](/docs/handbook/plaene)).
+
+## The compare view
+
+The view shows a table with one column per tool. Rows:
+
+| Row | Content |
+| --- | --- |
+| **Rating** | Stars + value (e.g. `4.2/5`) |
+| **Usefulness** | Value (X.X/5) |
+| **Usability** | Value (X.X/5) |
+| **Number of ratings** | Count |
+| **Description** | Text |
+| **Features** | Badges |
+| **Tags** | Badges |
+| **Last updated** | Date |
+
+The **best value** per row is highlighted (with trophy icon).
+
+## API
+
+The compare view reads the data via
+[`GET /compare`](/docs/reference/endpoints/tools#listCompareTools).

docs/releases/v0.8.1/handbook/vergleichen.md

@@ -0,0 +1,42 @@
+
+# Vergleichen
+
+Mit der Vergleichsfunktion stellst du mehrere Tools **nebeneinander** gegenüber —
+ideal, um eine fundierte Entscheidung zu treffen.
+
+> Vergleichen ist ein **Premium-Feature** (Premium/Enterprise) und steht Admins
+> immer zur Verfügung.
+
+## Tools auswählen
+
+1. Im Bereich **Tools durchsuchen** klickst du auf jeder Karte/Zeile auf das
+   **Vergleichs-Icon** (Waage).
+2. Unten erscheint die **Vergleichsleiste** mit den ausgewählten Tools als
+   Chips. Du kannst einzelne Tools entfernen (×) oder die Auswahl leeren.
+3. Klicke auf **Vergleichen (N)**, um zur Vergleichsansicht zu gelangen.
+
+> Ohne Premium-Tarif ist der Button gesperrt (Schloss-Icon). Über den
+> Dialog gelangst du zum Tarifwechsel
+> (siehe [Pläne & Berechtigungen](/docs/handbook/plaene)).
+
+## Die Vergleichsansicht
+
+Die Ansicht zeigt eine Tabelle mit einer Spalte pro Tool. Zeilen:
+
+| Zeile | Inhalt |
+| --- | --- |
+| **Bewertung** | Sterne + Wert (z. B. `4.2/5`) |
+| **Nützlichkeit** | Wert (X.X/5) |
+| **Bedienbarkeit** | Wert (X.X/5) |
+| **Anzahl Bewertungen** | Anzahl |
+| **Beschreibung** | Text |
+| **Features** | Badges |
+| **Tags** | Badges |
+| **Zuletzt aktualisiert** | Datum |
+
+Der **beste Wert** pro Zeile wird hervorgehoben (mit Trophäen-Icon).
+
+## API
+
+Die Vergleichsansicht liest die Daten über
+[`GET /compare`](/docs/reference/endpoints/tools#listCompareTools).

docs/releases/v0.8.1/handbook/watchlist.en.md

@@ -0,0 +1,33 @@
+
+# Watchlist
+
+The **watchlist** is a personal favorites list. You can open and compare the
+tools in it at any time with a click.
+
+> The watchlist is a **premium feature** (Premium/Enterprise) and is always
+> available to admins.
+
+## Prerequisite
+
+You need a plan with the `watchlist` permission. If it is missing, a note
+about switching plans appears at the bookmark
+(see [Plans & permissions](/docs/handbook/plaene)).
+
+## Saving a tool
+
+- On every card/row in the **Browse tools** section you will find the
+  **bookmark icon**.
+- A click saves the tool to your watchlist — the icon becomes filled.
+- Clicking it again removes it.
+
+## Viewing the watchlist
+
+Open the watchlist via the user menu or the sidebar. It shows all saved tools
+as cards. The filled bookmark on a card removes the tool from the list.
+
+## Where is the watchlist stored?
+
+The watchlist is a list of tool IDs in your **user preferences**. This way it
+is linked to your account across devices.
+
+API reference: [`GET /auth/me/watchlist`](/docs/reference/endpoints/auth#getMeWatchlist).

docs/releases/v0.8.1/handbook/watchlist.md

@@ -0,0 +1,34 @@
+
+# Watchlist
+
+Die **Watchlist** ist eine persönliche Favoritenliste. Tools darin kannst du
+jederzeit per Klick wieder aufrufen und vergleichen.
+
+> Die Watchlist ist ein **Premium-Feature** (Premium/Enterprise) und steht
+> Admins immer zur Verfügung.
+
+## Voraussetzung
+
+Du benötigst einen Tarif mit `watchlist`-Berechtigung. Fehlt diese, erscheint
+beim Lesezeichen ein Hinweis auf den Tarifwechsel
+(siehe [Pläne & Berechtigungen](/docs/handbook/plaene)).
+
+## Tool speichern
+
+- Auf jeder Karte/Zeile im Bereich **Tools durchsuchen** findest du das
+  **Lesezeichen-Icon**.
+- Ein Klick speichert das Tool in deiner Watchlist — das Icon wird gefüllt.
+- Ein erneuter Klick entfernt es wieder.
+
+## Watchlist ansehen
+
+Öffne die Watchlist über das Benutzermenü oder die Seitenleiste. Sie zeigt alle
+gespeicherten Tools als Karten. Das gefüllte Lesezeichen auf einer Karte
+entfernt das Tool aus der Liste.
+
+## Wo wird die Watchlist gespeichert?
+
+Die Watchlist ist eine Liste von Tool-IDs in deinen **Benutzerpräferenzen**.
+Damit ist sie geräteübergreifend mit deinem Konto verbunden.
+
+API-Referenz: [`GET /auth/me/watchlist`](/docs/reference/endpoints/auth#getMeWatchlist).