diff --git a/src/content/docs/admin/tools.mdx b/src/content/docs/admin/tools.mdx index da15b62..6b958d9 100644 --- a/src/content/docs/admin/tools.mdx +++ b/src/content/docs/admin/tools.mdx @@ -38,6 +38,27 @@ Ein Tool kann eigene UI mitbringen oder die Admin-Widgets verwenden. Beides sieh bewusst wie der Admin aus; das Projekt-Theme kann über `meta.ui.css` gescopet ergänzt werden. +## Projektabhängige Funktionen + +Einige Funktionen lassen sich nicht sinnvoll generisch testen, weil sie vom +Projekt abhängen: + +- **Pagebuilder:** Blocktypen, Registry und erlaubte Reihenfolge kommen aus + `collection.meta.pagebuilder.blockRegistry` des Projekts. Der Admin stellt die + vorhandene Pagebuilder-Komponente bereit; ein generischer Reorder-Test wäre nur + eine Aussage über die Mock-Blöcke. +- **Fremdschlüssel:** Ziel-Sammlung, Anzeigefeld und Filter stehen im Feld-Meta. + Die Auswahl- und Entfernen-Interaktion ist getestet; die konkreten Werte sind + projektspezifisch. +- **Suche/Filter/Sortierung:** Spalten und Suchmodi kommen aus der + Sammlungs-Config. Die UI-Helfer sind vorhanden, die Semantik bleibt Projekt-Config. +- **Asset-Auslieferung:** Ob `.js`/`.mjs` mit JavaScript-MIME und ohne Token + erreichbar sind, ist eine Deployment-Eigenschaft des Projekts (siehe + [Custom Tools schreiben](/projekt/tools-schreiben/#auslieferung-und-deployment)). + +Diese Punkte sind bewusst als projektabhängig dokumentiert, statt sie mit +Mock-spezifischen Assertions festzuschreiben. + ## Grenzen - Tools laufen im Browser mit der Admin-Session. Es gibt in v1 keine iframe-Sandbox.