docs(tools): document project-dependent behavior
Deploy tibi-docs / build-and-deploy (push) Failing after 51s

This commit is contained in:
apairon committed 2026-10-20 20:46:32 +00:00
1 parent c22b324294
commit 03a1b83cc7
1 file changed
+21
+21
View File
@@ -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 bewusst wie der Admin aus; das Projekt-Theme kann über `meta.ui.css` gescopet
ergänzt werden. 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 ## Grenzen
- Tools laufen im Browser mit der Admin-Session. Es gibt in v1 keine iframe-Sandbox. - Tools laufen im Browser mit der Admin-Session. Es gibt in v1 keine iframe-Sandbox.