Schema Bank Prototype
A schema describes the shape of some data: its fields, what each one means, and the rules a value has to follow. The schema bank is where a workspace will keep its schemas, in folders, so that nodes, pages and every AI you work with read the same shapes. An Interface is a page Thinky codes for you, with settings (its props) described by a schema of their own.
None of that is built yet. What you can open today is an experimental prototype of the screens: five windows that open in your workspace among the real ones, so you can try the ideas where they will live and say what should change.
It is a prototype
- Every window runs on made-up data: a sample shop with orders, and a plant with four lines. Your workspace's own data is never read.
- Nothing is saved or published. Save, Accept and Reject change only what the window shows. Close the window, or reload the page, and it starts again from the sample.
- Each window says so at the top, beside an Experimental UX pill, in a strip that reads: Prototype: sample data, nothing is saved or published.
- Thinky's part is scripted. It shows how Thinky would take part; you cannot type to it here.
Who sees it
The Schemas menu sits in the top bar, between Workstreams and APIs. It shows only for people
who hold both the Workspace.Experimental and the Workspace.Experimental.UX rights. Without both, the
menu is not there at all; it is never greyed out. No one holds these rights just by owning a workspace.
On the Fathym root, the root users get them through the All OpenX rights card, which the deployment's
root user list gives them at every start. Anyone else gets them only when they are given them. See
Permissions.
The windows check the right too. A window kept in a saved layout draws nothing for someone without it.
The five windows
Schemas > Schema bank
The bank and its editor. The folders are on the left and the schemas in the middle. The open schema is on the right, with the tabs Fields, JSON Schema, Zod, Test and Used by.
Try this:
- Search with
l:orders(by label) ortype:enum(by kind). A search that matches nothing says so. - Open Order. On its
stfield, add 4 returned to the allowed values. - Open JSON Schema, then Zod: both follow the change you made.
- Open Test and run it against the sample. Order O-1003 now passes. O-1002 still fails, because its total is below 0.
- Press Save v5.
Schemas > Slots on a node
A node's Inspector with schema slots. Here it is a warm query called orders-by-day, with an Arguments slot for its input and an Each row slot for its output. A slot says which schema the node uses for that part.
Try this:
- Drag Order onto Each row. The slot glows while you hold it there, and the schema is set when you let go.
- Drag Order status onto it. It is refused, with the reason: Order status is a list of values, and Each row takes an object. Nothing changes.
- Use the slot's round picker button to pick a schema from a list instead, with each one marked as fitting or not.
Thinky drafts a schema
From the round picker on Each row, choose New from this query's sample.... A window opens with Thinky's proposal: a new Order line schema drafted from the sample, each field with the meaning Thinky gave it.
Try this:
- Press Reject. Nothing is saved, and you can show the proposal again.
- Click the meaning of discount, write your own words, and press Done. The field is marked edited.
- Press Accept. The schema is saved with your meaning, and the window notes that 1 meaning was yours.
Schemas > Interface: Line board
An Interface's Inspector and panel, with Thinky's proposal for a board that shows four lines and turns a line red when it runs under target.
Try this:
- Switch between Saved (an empty placeholder page) and Proposed (Thinky's board).
- Open Code to see what the proposal changes.
- Press Accept. Publishing stays off while Interfaces are experimental.
- Open the Props tab. It opens the page's settings in their own window.
Props and live preview
The page's settings, as a form drawn from its props schema, beside a preview that follows what you change.
Try this:
- Set Refresh every to 2. It is refused, because the schema allows 5 to 3600 seconds, and the preview keeps its last good value.
- Set it to 10. The preview's footer follows.
- Untick Line 2. Its tile leaves the preview.
Tell us what to change
The prototype exists to settle how schemas and Interfaces should look and behave before they are built. What you notice in these windows shapes what gets built.
Related
- Describe Your Nodes - the descriptions every AI reads, which a schema's meanings add to.
- Workstreams Setup - another experimental prototype.
- Permissions - where your rights come from.
On fathym.com: OpenX →