admin/tool-evaluator

Fork 0

Files

T

History

opencode 8f2fd89847

Build & Push Docker Image / build (push) Successful in 2m49s

Details

feat(import): bulk tool import (CSV/JSON/YAML) for admins; NetBox-style help button

- Add POST /admin/tools/import with format auto-detect, CSV delimiters
  (comma/semicolon/tab), per-row validation via CreateToolBody, bulk insert,
  audit log entries per imported tool; gated by new 'tool-import' feature
  flag (premium/enterprise; admins always pass)
- Add tool-import-dialog UI (format tabs, delimiter select, textarea, file
  upload, result/error list) behind hasFeature('tool-import')
- Replace FieldHelp question marks and bare GuideHelp links with a NetBox-style
  'Hilfe/Help' outline button (HelpCircle + text) in form headers only
- Sync locales to 482 keys per language (de/en), update handbook docs
  (administration import section, index/plaene feature tables), regenerate
  API client + zod schemas, add yaml dependency

2026-08-04 23:09:11 +02:00

handbook

feat(import): bulk tool import (CSV/JSON/YAML) for admins; NetBox-style help button

2026-08-04 23:09:11 +02:00

releases

docs: add v0.8.5 release notes

2026-08-04 21:01:58 +02:00

dependency-policy.md

chore(deps): upgrade all dependencies to latest and pin exact

2026-08-03 12:56:00 +02:00

README.md

feat(docs): mkdocs-style documentation site served at /docs

2026-08-03 22:15:54 +02:00

README.md

Dokumentation (Handbuch, API-Referenz, Release-Notes)

Die App zeigt unter /docs eine MkDocs-artige Doku-Seite mit drei Bereichen:

Handbuch (docs/handbook/*.md) — von Hand gepflegte Anleitungen
API-Referenz (lib/api-spec/openapi.yaml) — automatisch generierte Endpunkte & Datenfelder (Schema-Detailseiten mit Feld-Ankern; die ?-Icons in Formularen verlinken auf diese Felder)
Release-Notes (docs/releases/vX.Y.Z.md) — pro Release

Struktur

docs/handbook/ — Handbuch-Seiten mit Frontmatter (title, order)
docs/releases/TEMPLATE.md — Vorlage für neue Releases
docs/releases/vX.Y.Z.md — Notes pro Release
docs/releases/vX.Y.Z/reference.json — API-Snapshot der jeweiligen Version

Generator

scripts/src/generate-docs.mjs wird beim Frontend-Build (und dev) automatisch ausgeführt und schreibt die Artefakte nach artifacts/toolrate/public/docs/:

reference.json (aktuelle API), search.json (Suchindex), index.json (Releases), handbook/*.md + handbook/index.json
releases/vX.Y.Z.md und versions/vX.Y.Z.json (API-Snapshots alter Versionen)

Manuell aufrufbar:

node scripts/src/generate-docs.mjs                  # Build-Modus
node scripts/src/generate-docs.mjs --snapshot v0.9.0   # Snapshot für neue Version

Workflow beim Release

Version taggen wie bisher (git tag vX.Y.Z, CI baut und deployed).
docs/releases/vX.Y.Z.md anlegen — Vorlage aus TEMPLATE.md kopieren, Entwurf aus der Git-Historie ableiten:
```
git log --oneline vX.Y.Z-1..vX.Y.Z
```
(API-Delta anhand lib/api-spec/openapi.yaml prüfen.)
API-Snapshot erzeugen: node scripts/src/generate-docs.mjs --snapshot vX.Y.Z erzeugt docs/releases/vX.Y.Z/reference.json.
Committen & pushen. Der Build kopiert die Dokumentation automatisch nach artifacts/toolrate/public/docs/ und generiert index.json.

Hinweis: Alle Dateien unter artifacts/toolrate/public/docs/ sind Build-Artefakte und werden bei jedem Build neu generiert — nicht von Hand bearbeiten. Einzige Quellen sind docs/handbook/, docs/releases/ und lib/api-spec/openapi.yaml.