@lotics/cli 0.312.4 → 0.312.5

package/dist/src/cli.js

@@ -35968,7 +35968,7 @@ var MODEL_RULES = {
     sentence: '`layout: "plan"` and `plan` go together: `at` is a one-row link to an entity whose `records` states a `plan_place`, `across` and `up` two different numbers of the row, `fill` a single select; a plan has no `tabs`, `group` or `attention`. A write that sets `at`, `across` or `up` is refused unless it clears all three, or places the row at a free cell of a bay (a row from 1 to the bay\'s `across`, a tier from 1 to its `up`, resting on a present item), or at an area with neither.'
   },
   "register.plan-mark": {
-    sentence: "A plan's `mark` names a single select of the row, in every book too, and an option of it by alias: a row holding that option wears a dot in the option's colour, which the legend names by its label."
+    sentence: "A plan's `mark` names a single select of the row and an option of it by alias: a row holding that option wears a dot in the option's colour, which the legend names by its label. A book that holds the select must hold it as a single select with that option; a book lacking it never marks its rows (`app.book-lacks`)."
   },
   "register.loads": {
     sentence: `\`loads\` names one to ${LANE_LOADS} numbers a block adds \u2014 never a percent \u2014 each against a number of the lane's row, in one unit or two of one dimension.`
@@ -37740,7 +37740,7 @@ var registerPlanSchema = zod_default.object({
   mark: zod_default.object({
     field: fieldAlias2.describe("A single select of this entity"),
     option: alias.describe("An option alias of that select")
-  }).strict().optional().describe("A row holding the option wears a dot on its box, in the option's own colour, and the legend names it by the option's label; in books, the select is matched by option alias")
+  }).strict().optional().describe("A row holding the option wears a dot on its box, in the option's own colour, and the legend names it by the option's label; in books, the select is matched by option alias, and a book lacking the select never marks its rows")
 }).strict();
 var registerSchema = zod_default.object({
   columns: zod_default.array(fieldAlias2).optional().describe("Fields read as columns after the row's title \u2014 on a calendar's entry or a lane's block, its facts after its title; never what the row draws itself (its subtitle, image, status, figure, or the bound its figure's meter reads against), which the runtime places. At most 5 besides the row's name, status, deadlines and figure: a table draws every column and folds the last stated onto the name's line as it narrows, so more is refused"),
@@ -42023,7 +42023,7 @@ function translateBook(model, app, main2, book, stated, index) {
   }
   const layout = app.register?.layout;
   if (layout !== void 0 && layout !== "table" && layout !== "cards" && layout !== "plan") refuse(`stands in a ${layout} \u2014 a register reads books only as a table, cards or a plan`);
-  const plan = app.register?.plan === void 0 ? void 0 : translatePlan(app.register.plan, main2, book, to, held2, refuse);
+  const plan = app.register?.plan === void 0 ? void 0 : translatePlan(app.register.plan, main2, book, to, held2, refuse, drop);
   const asked = app.register?.create;
   const missing = Array.isArray(asked) ? asked.filter((alias2) => to(alias2) === void 0) : [];
   if (missing.length > 0) drop(`adds no row: its add asks ${missing.map((one) => `"${one}"`).join(", ")}, which "${book.alias}" lacks`);
@@ -42102,7 +42102,7 @@ function translateBook(model, app, main2, book, stated, index) {
   };
   return { index, entity: book.alias, app: bookApp, model: ownModel, lineUp, named, findings };
 }
-function translatePlan(plan, main2, book, to, optionsHeld, refuse) {
+function translatePlan(plan, main2, book, to, optionsHeld, refuse, drop) {
   const held2 = [plan.at, plan.across, plan.up].map((name) => ({ name, own: to(name) }));
   for (const { name, own: own2 } of held2) if (own2 === void 0) refuse(`lacks "${name}", which the register's \`plan\` stands its rows at \u2014 a book's rows stand where the app's do`);
   const [at2, across, up] = held2.map((one) => one.own);
@@ -42117,7 +42117,7 @@ function translatePlan(plan, main2, book, to, optionsHeld, refuse) {
   if (plan.mark !== void 0) {
     const own2 = to(plan.mark.field);
     const field = own2 === void 0 ? void 0 : fieldOf(book, own2);
-    if (own2 === void 0) refuse(`lacks "${plan.mark.field}", the select the register's \`plan\` marks its rows by`);
+    if (own2 === void 0) drop(`never marks its rows: it lacks "${plan.mark.field}", the select the register's \`plan\` marks its rows by`);
     else if (field === void 0 || !isSingleSelect(field)) refuse(`holds "${own2}", which is not a single select \u2014 the register's \`plan\` marks its rows by one`);
     else if (optionsHeld(plan.mark.field, [plan.mark.option]).length === 0) refuse(`holds no option "${plan.mark.option}" in "${own2}", which the register's \`plan\` marks its rows by`);
     else mark = { field: own2, option: plan.mark.option };
@@ -46557,7 +46557,7 @@ async function saveSignedLinks(links, dir) {
 }
 
 // src/version.ts
-var VERSION = "0.312.4";
+var VERSION = "0.312.5";
 var APP_SDK_VERSION = "0.122.4";
 
 // src/timezone.ts
@@ -46577,7 +46577,7 @@ import { spawn as spawn2 } from "node:child_process";
 var design_default = "# Designing an app\n\nStart here to build an app. This page is the method and the choice of treatment for each thing a job\nreads; every key it names is a key of `model.json`, and the page of the `model` reference stating a\ntreatment's keys stands beside it in \xA7 Treatments. A treatment worked through in an app of a complete model\nis a page at `examples/<treatment>` \u2014 `lotics docs`, or the `docs` tool.\n\nA model states COMPOSITION \u2014 which fields, lists and acts each job's screen holds. How each piece looks is\nthe platform's, one way per concept, and no key changes it. What the model leaves unnamed is never drawn,\nand a list the model leaves as a table is drawn as one, even where a calendar, a face or a picture would\nanswer the reader at a glance. That is the most common failure of a model, so the apply refuses an app leaving\nout a treatment it requires \u2014 a register's readings, a record's sections and children, its status moves, a picture,\nrows in time, a template's act \u2014 until the model states it or declines it.\n\n## The method\n\n1. **People and jobs, before any table.** Name each person by the work they do, then each JOB in one\n   sentence: who does it, what exists when it is done, the record it moves. The sentence is the app's\n   `name` and `description`. A job is a desk a person works every day from its own list; one app per job,\n   each one working register over one entity \u2014 an app per table, or one app holding every table, is no job's\n   screen. What was brought into that register's rows or done to them \u2014 the files imported, the runs of a\n   batch \u2014 is read beside it as a log of the same app (`logs`, at most three), never an app of its own.\n   A job is the record it moves and the rhythm it moves at \u2014 the first list it opens on. What that record\n   owns (a vehicle's papers, its services, its fines) is sections, blocks and acts of it, never an app;\n   work over another record or at another rhythm (the week's dispatch runs, beside each vehicle's file) is\n   another app, even when one person works both.\n   A list worked only in passing on the way through another job \u2014 the rates a quote is priced from, the\n   transfers its receipts are matched to, the statement sent from its records \u2014 is a block, a section or an\n   act of that job's app, never an app of its own. A small business usually lands at four to six.\n2. **The entities the jobs touch.** A status is a state the work sits in, six options or fewer: a touch\n   (\"called\") is a row of a log, a money fact (\"paid in full\") a formula the figure shows. A quantity is a\n   number with its `unit`, never words in a text field; a quantity of several kinds is child rows, one per\n   kind, totalled at the foot of their block.\n3. **How each row is recognised** \u2014 a `records` entry for every entity an app lists, opens or picks: its\n   `title` (who or what it is, never a code \u2014 the code is a `subtitle`), up to two `subtitle` fields the job\n   reads at first glance, its `image`, its `party`, its `status` and which options are `closed`, its\n   `figure`, its `due` dates.\n4. **Each app's composition** \u2014 the register's `columns` in the order the job reads them, as many as fit a\n   desk (one that does not fit is drawn nowhere in the row; what is read only on the way deeper is the\n   record's), the `filters` it narrows by every day (at most 3, each a field the rows show, or a formula yes/no of fields they show), its `layout`\n   and `readings`; the record's `sections` in the order the work reaches them, each one's `fields`, `blocks`\n   and `acts`; the `checks` that warn or refuse. A rule the business states \u2014 a field needed before an act,\n   a quantity bounded, a picker narrowed, a duplicate reused \u2014 is the model's (an act's `requires`, a check's\n   `blocks`, `write_rules`), and every write re-checks it; a check without `blocks` only warns.\n5. **What a person would ask an agent in each app.** Write the asks down per app \u2014 every act, each list\n   narrowed the way a person narrows it, one record with its lines and papers, every figure, data brought\n   in \u2014 and beside each the query or workflow of the app that answers it (`agent_surface`). What the screen\n   reads and does is generated. An ask no screen makes is declared: a read in `queries` (`model/queries`),\n   a write in `workflows` (`model/workflows`). A figure an agent calls states its `alias`. An ask with\n   nothing to answer it is a gap in the model, closed before the apply. An app is built to be run by an agent:\n   every flow a person works can be driven end to end through its workflows, the person is asked only where\n   their judgement or authority is needed, and the screens show what was done and let a person do or put back\n   any step by hand.\n6. **A treatment for every list and every entity** \u2014 the next section. Choose it from what the rows ARE,\n   before writing any register.\n7. **Plan, apply, look.** The `check_model` tool (`lotics model check` on the CLI) checks the\n   whole model beside the workspace's rows and writes nothing \u2014 the patch adopting each app's decisions in\n   `designs`, and the app's body as they leave it its `draft`; `apply_model` (`lotics model apply`) mints each app live. Then look at each app \u2014\n   \xA7 Look at it \u2014 and judge it against \xA7 The visual bar. A correction is a change to the model, applied again.\n\n## Treatments\n\nA finding naming a section below is a treatment the model left out. A decided one refuses the apply, and the\ncheck gives each app it refuses a patch stating its decided treatments: merge the patches in the order the check gives\nthem, or state why the app stays as it is in its `declines` (`model/declines`), under the key the finding names \u2014\nthen check again. A note refuses nothing.\n\n| The rows are | The treatment | Its keys |\n|---|---|---|\n| People or organisations | `records.<entity>.party`, with a photo or logo as its `image` | `model/records` |\n| Things with a photo, a scan or a paper | `records.<entity>.image`; `layout: \"cards\"` where the picture is how a row is found | `model/records`, `model/cards` |\n| Read by their day | `layout: \"calendar\"`; on a record, an `agenda` block | `model/calendar`, `model/timeline-and-agenda` |\n| Booked on a resource | `layout: \"lanes\"` with `lanes`, and `write_rules` `no_overlap` | `model/lanes`, `model/write-rules` |\n| A plan of spans | `layout: \"gantt\"` with `gantt` | `model/gantt` |\n| Stood at a place \u2014 pallets, bins | `layout: \"plan\"`; places state `plan_place` | `model/plan` |\n| Who did what on which day | `layout: \"roster\"` with `roster` | `model/roster` |\n| A log of what happened | a `timeline` block | `model/timeline-and-agenda` |\n| Opened to be worked on | the record's `sections`, in the order the work reaches them \u2014 `at` where it moves in steps | `model/record-page` |\n| A record whose page is its own arrangement of pieces the app already states | `record.compose` | `model/composed-page` |\n| Rows that each belong to another row | a `rows` block on that row's record; a `list` block where read-only | `model/blocks`, `model/list-block` |\n| Moving through a status | an act per move, `status.history`, and the register's `readings` | `model/acts`, `model/status`, `model/readings` |\n| Steps people drop out of between | a `funnel` block on the record whose child rows count them | `model/reading-blocks` |\n| A record's own numbers nobody keys, read at a glance | a `figures` block of two to eight tiles | `model/reading-blocks` |\n| Counted over a period | the register's `tabs` over one `period`; an `open` tab's `where` reads only what was true at the period's end, never a status the row moves on from | `model/tabs` |\n| Papers a case gathers | a rows block with `expect`; the papers made, an act's `templates` | `model/blocks`, `model/papers-and-recordings` |\n| Rows that are each a place a record is sent | a rows block with `expect` on the link to those places and `post`: each ticked, the post written there and read as its feed shows it | `model/publish-desk` |\n| Papers an agent reads, where the owner asked for one | an act's `intake` with `fills` | `model/papers-and-recordings` |\n| Calls and visits | an act's `record` | `model/papers-and-recordings` |\n| Changes a workflow proposes that a person approves row by row \u2014 a price list applied, a statement matched to what is owed | an act's `workflow` with `review`, its body returning a changeset in `data.review` | `model/acts` |\n| Documents covering lines | a rows block with `under` | `model/blocks` |\n| Rows on file a record takes in | a rows block with `pick` | `model/blocks` |\n| One owner's question across jobs | a dashboard app | `model/dashboards` |\n\n### Faces and pictures\n\n#### Party\n\n`records.<entity>.party` is `\"person\"` where the rows are people (a contact, a patient, a driver) and\n`\"organization\"` where they are companies (a customer, a supplier, a carrier). Every surface drawing one of\nits rows \u2014 the register's row, a link's chip, a picker's option, the record's header \u2014 then draws a face:\nits `image` (a photo, a logo), else its initials. Without it, a person is drawn as a thing. A workspace\nmember is a `select_member` field, and is drawn by their face already. Worked: `examples/party`.\n\n#### Image\n\n`records.<entity>.image` names the files field that pictures a row \u2014 a product's photo, a damage photo, a\nscan, a receipt. Every row of it then leads with its picture, or its paper's preview, wherever it is drawn;\na link to it previews the file. Never a field an act keeps the paper it makes in (`into`). Register\n`layout: \"cards\"` where the picture is how a row is found. A files field the record keeps as a folder of\npapers is a `files` block, read whole. Worked: `examples/cards`.\n\n#### A link opens its row\n\nOn a record, a link to one row opens its peek: a drawer on a desk, a sheet on a phone, reading the\nrow's face \u2014 its mark, name, status, the line under it and its figure by its field's name \u2014 and nothing to edit. A link read in a\nrow's cell or on its line opens from its name; a link the record keeps as a field rests as its picker, and\nits way out stands at the field's label where the row has somewhere to go. The peek's one act leaves for\nthe app whose register is that entity's rows \u2014 the first, in the model's order, that the member\ncan open \u2014 at the row's address, or goes to the row inside this app where the entity is the app's own,\none of its books' or a log's, in that list \u2014 a log's rows only from their own app. With no such app the peek has no act, and a link answered in what an act asks opens\nno peek. The model states none of it: give the entity an app of its own and\nits links lead there. The app opened decides what the member reads of the row; a row it withholds\nlands them on its not-found.\n\n### Rows in time\n\nRows that each stand on a day, or hold a run of days or hours, are read where they stand in time \u2014 never\nas two date columns. A row holds a span when its `records` line (title and subtitle) holds two dates, its\n`records.frees` names the day it ends, or `write_rules.<entity>.no_overlap` books it on a row its `by` links to (a\nchair, a machine). A `no_overlap` by a person or a value alone keeps one row at a time each \u2014 a member's periods in\nturn \u2014 read by what they hold.\n\n#### Calendar\n\n`register.layout: \"calendar\"`: the rows by their day \u2014 a month, a week, a day or a list; an entry at its\nhour where its date holds one, over its span where its line holds a second date. An entry pressed opens a card on\nit: the row, Delete, its acts, Reschedule (the day alone moves; its hour and its length stay) and Open. Worked:\n`examples/calendar`.\n\n#### Lanes\n\n`register.layout: \"lanes\"` with `lanes` naming a one-row link whose target's rows are the lanes (a chair, a\nmachine, a room), each drawn even when empty: every row a block from the first date on its line to the\nsecond, and a free stretch adds a row there. `loads` reads what a lane carries against what it holds. A\n`no_overlap` `by` the same link refuses two rows on one resource at once. Worked: `examples/lanes`.\n\n#### Gantt\n\n`register.layout: \"gantt\"` with `gantt.start` (and `end`, else the entity's first `due`): one bar a row over\nits run of days \u2014 a shipment, a hire, a task of a project \u2014 read against today. `gantt.milestones` marks\ndates on the bar, `planned` the plan under it, `progress` how far it is done, `after` the rows it waits on;\nthe register's `group` is its lanes. Worked: `examples/gantt`.\n\n#### Roster\n\n`register.layout: \"roster\"` with `roster` naming the child whose rows fill the days \u2014 one link back to the\nregister's entity and a date on its line: what each row did on each day (shifts, runs, attendance). With\n`expect` (and `of`) the columns are the options of a select instead of days: which papers each row holds.\nWorked: `examples/roster`.\n\n#### Agenda\n\nAn `agenda` block on a record: a child's planned entries by day, soonest first, today marked, each with its\npicture; within a day by the hour, or by a single select of the part of the day. `start` counts Day 1 from a\ndate of the record (a trip, a course).\n\n#### Timeline\n\nA `timeline` block on a record: a child read as a log of dated entries, newest first, with a composer \u2014 the\ncalls, visits and notes about the record, each with who and when, and its files where the child's `image`\nnames them. Entries planned ahead are an `agenda`; the status's moves are its history. Worked:\n`examples/party`.\n\n### Moves and numbers\n\n#### Moves\n\nRows a status stages towards its `closed` options move by acts: each moves one option on to the next (`when` the\nstatus holds it, `set` to the next), at the foot of the section whose work it ends. A status with nothing closed is a\ncondition a person sets. A value decided as a row reaches an outcome \u2014 why it was lost, refused, voided \u2014 is that\nact's `asks`, never a field the reader must remember to fill. An act reaching past the workspace \u2014 sending an invoice\nto a service, a letter by mail \u2014 runs its `workflow`, and what the workflow keeps from the answer (an invoice's id,\nits link) is named in `writes`, the act's as what it sets is. A stage the work only steps aside into from one step\nand leaves only back to it \u2014 a pause, a repair \u2014 is a detour: its option and its section stand before that step,\nentered by its own act; listed after, it reads as the work's next step.\n\n#### Stages\n\nName each job's work plan by its shape: a status a person sets; a pipeline, where who holds the row and for how long\nmatter; or tasks, where only how many are done counts (`records.<entity>.task`). A pipeline states each stage once in\n`records.<entity>.status.stages` \u2014 its `owner` (a member field, a link's member field, or a `role`) and its target\n`within` days \u2014 and the server holds it: only the owner's acts move the row on, and a level an amount skips stands\nnamed with why. Late rows, rows due soon, a warning the line draws and rows waiting on the reader stand first in a\nregister; a register whose job is a strict order, a first-come queue, states `register.attention: false`.\n\n#### History\n\n`records.<entity>.status.history` names a child the app's own writes append one row to per status move: its\nlink to the row, the new status, the moment and who. It keeps when each row entered each status and who\nmoved it \u2014 what the rail reads. A record's activity shows every move as a change, so `record.history: true` adds\nnothing \u2014 and beside `record.activity: false`, which shows them nowhere, it is\nrefused. Worked: `examples/approval`.\n\n#### Readings\n\n`register.readings` stand above the rows and read the rows in view. Lead with the job's headline number \u2014\nits exception as a formula's yes/no in a `metric`'s `where` (what is late, what is short; the rows draw it where every field of its own row it reads is drawn, at that width), never a stage the\nstatus chips already count \u2014 then at most the mix (`breakdown`) and the movement (`trend`), varied by job.\nA `pivot` reads on a dashboard. A dashboard app (`dashboard`) answers one owner's question across jobs, each\nreading windowed by the period the reader picks, and a `list` reading hands over the rows to act on. A\ndashboard of many readings states `tabs` (2 to 5) and each reading the `tab` it stands under, so one sheet draws at a time. A\nrecord's `metric`, `breakdown` and `trend` blocks read its own child rows. Worked: `examples/approval`, `examples/dashboard`.\n\n#### Funnel\n\nA `funnel` block reads a record's child rows as steps, each a number column summed over them \u2014 a week's channels\nfrom impressions to bookings, an order's lines from ordered to shipped. It states how much of the first step\neach later one keeps, the share lost between two neighbours, and the last over the first. State two to eight\n`steps` in one unit; where the path turns \u2014 reach, then conversion \u2014 state two blocks one straight after the\nother, so the second's bars are read over its own first step: they draw on one grid, every bar starting at one\nedge and every value ending at another, each under its own label. A step no row holds a number in reads as not measured, so leave a count empty\nrather than typing a zero nobody measured.\n\n#### Priced lines\n\nA quote's items, an estimate's works, a repair sheet's damages are lines priced off a book: an entity whose\n`records` names each item, puts the code people type on its line and its price as its `figure`. The line links to\nit, asks the link and its quantities in its block's `create`, and copies the price (`default_from`), so the quote\nkeeps what was quoted when the book moves. A line's amount is a formula, the record's total a rollup over the rows\nthe block shows \u2014 what is not paid for is a second rollup, never a filter on the first, so each group subtotals.\nGroup the lines by the parts the record is quoted in (a container, a room, a leg), a field the line asks. The book\nis its keeper's desk, an app of its own.\n\n### The record\n\n#### Sections\n\n`record.sections`, in the order the work reaches them: the fields people write, a `files` block per paper the record\nkeeps, a block per child, the acts at each one's foot. A register laid out in time (calendar, lanes, roster) opens the\ndefault record: every field a person writes. `record.compose` is not for a record a standard section order would\ndo, and never for behaviour, which belongs in an act.\n\n#### Children\n\nRows that each belong to one row of another entity (a one-row link to it) are drawn under that row: a `rows` block on\nits record, a `timeline` where they are a log, an `agenda` where they are planned on a day and within it, a roster of\nthem, or lanes of them by that link. Which children a record lists is the author's \u2014 one of them at least. A block\nlisting only some of them narrows by its `where`: a select (one leg's fees), or a yes/no \u2014 a formula's for what is\nstill owed \u2014 on a block that adds no rows. Rows on\nfile before the row they come to belong to \u2014 a job's cost lines before the supplier bill over them \u2014 are picked into\nit: a rows block with `pick`, often with `create: false` and `remove: false`.\n\n### Papers\n\n#### Expect\n\nA rows block with `expect` naming the child's title \u2014 a single select of kinds, or a one-row link to a\ncatalog: one line per kind, the ones not yet filled standing empty, filled in place. `of` narrows the kinds\nto the record's own multi-select of those it needs. The papers a case gathers, the fees a record knows it\nowes. Worked: `examples/case`.\n\n#### Templates\n\nA paper the business makes is an act's `template`, kept in the record's files field `into` \u2014 or several at\nonce, `templates`: listed where the act stands, each made one as its file and each not yet made as a\nplaceholder, the reader ticking which to make. A template no act names is made by nothing. Worked: `examples/case`.\n\n#### Intake\n\nA paper the business is brought and reads is an act's `intake`: the press takes the papers, an agent reads\nthem, and each is filed as the line of its kind in the child the record `expect`s, while `fills` writes what\nthey state into the record's fields \u2014 a single link as a row the agent finds among those the app reads of its\nentity \u2014 shown before it is saved. Worked: `examples/case`.\n\nAn agent act \u2014 an `intake`, a `record`'s `fills` \u2014 spends a run on every press and writes what the record\nsays, so it is stated only where the owner asked for an agent to do that job; otherwise a paper brought is its\nline of the `expect` block, and a person types what it states.\n\n#### Under\n\nA rows block with `under`: the documents that cover lines (an invoice over its fee lines) stand as headings\nover the lines they cover, and a line no document covers offers to make one. A document entered as it arrives,\nover lines already on file (a supplier bill), picks them from its own record instead: a rows block with `pick`.\nChoose one per document: a document a make covers lines by is never also picked into, since a pick does not check\nwhat the make does.\n\n### Calls\n\n#### Record act\n\nAn act's `record`: the press records a call, visit or meeting \u2014 its audio, its transcript, its screen where\ncaptured \u2014 and files it as a new row of the record's `timeline` child (`into`), stamped `at` and `by`;\n`fills` lets an agent fill that row's fields from the transcript, where the owner asked for one. Worked: `examples/calls`.\n\n## The visual bar\n\n- A person shows a face, a thing its picture, a file its preview, a plan its days on a time axis, a\n  quantity a meter (`records.limits`) or a chart, a register its `readings` under its title, and long text\n  reads whole (a `text` block).\n- Every app states its tile's colour (`theme.color`), apart from the workspace's other apps where it can be,\n  so the launcher tells the desks apart before their names are read.\n- Every category the job reads is coloured: each select option's `color`, and a `mark` where a brand or a\n  glyph names it \u2014 on every option of a select read down a column (how it was paid, the channel, the mode).\n- Someone is a face wherever they are read. A person is a member field and a party a row of an entity stating\n  `party`; where a select's options name people or organisations who are neither, every option's `mark` is\n  its face (`{\"kind\": \"avatar\", \"name\": \"person\"}`), never a colour dot.\n- Every files field is drawn somewhere \u2014 a section's `fields`, a `files` block, the `image`, or where the\n  act making it stands.\n- The paperwork is the proof of the work, so every paper the job takes in and every document it issues has a\n  place on the record, in the section where that work happens: a files field per purpose (what arrived, what\n  was issued to the customer, to the carrier, to the authority), each kept visible after the stage that made it,\n  and a source \u2014 a screenshot, an email, a sheet \u2014 on the row whose figure came from it.\n- A screen with none of these is bland, and bland is a finding: text drawn where a treatment above exists\n  is a change to the model.\n\n## Look at it\n\nAfter an apply, the `screenshot_app` tool draws each app as its people see it \u2014 the register, and a record\nby its `path` \u2014 at a desk's width and a phone's, one screen a shot, naming the columns a table left off at\neach width: `screen` names which screen of a long record. From the CLI, `-o <dir>` saves the shots. Beside the shots, its `verdict` is what a plan of the workspace's\nmodel finds of the app now, beside its rows: what the next apply would refuse it for and the notes on it, the\n`patch` adopting the decisions among them, and the app's body as the patch leaves it (`draft`). Judge each shot\nagainst \xA7 The visual bar, change the model, and apply again. The `rollback_app` tool returns an app to an earlier\nversion; the tables and rows stay as they are.\n";
 
 // src/model_reference.md
-var model_reference_default = '# The Lotics workspace model (`model.json`)\n\nOne JSON file describing a workspace: its tables, fields, options, views, roles,\nfirst rows, how a row of each table is recognised, and the apps over them. Each \xA7\nis its own page at `model/<section>` \u2014 `lotics docs`, or the `docs` tool. Which treatment each job\'s\nscreen needs: the `design` reference. Each treatment worked through in an app of a complete model: the\n`examples` reference.\n\n**What a model composes with**\n\n- **Entities and fields** (\xA7 Entity, \xA7 Field) \u2014 the tables, their columns, options and links.\n- **Records** (\xA7 Records, then \xA7 Status) \u2014 how a row of each entity is RECOGNISED: its title, the line\n  under it, its picture, its status, the one number it stands for. Stated once per entity\n  and read by every surface that draws one of its rows.\n- **Write rules** (\xA7 Write rules) \u2014 what a write finds, bounds and picks among.\n- **Apps** (\xA7 Apps, then a page each: \xA7 Logs, \xA7 Workflows, \xA7 Queries, \xA7 Register, \xA7 Layouts, \xA7 Tabs, \xA7 Export, \xA7 Readings,\n  \xA7 Averages and bands, \xA7 Dashboards, \xA7 Record page, \xA7 Blocks, \xA7 Composed page, \xA7 Publish desk, \xA7 Timeline and agenda, \xA7 Statements, \xA7 Reading blocks, \xA7 List block, \xA7 Tasks, \xA7 Acts,\n  \xA7 Papers and recordings, \xA7 Checks) \u2014 one\n  working register over one entity and the record each row opens, with the logs beside it:\n  which fields go where, the acts, and the checks that guard them \u2014 or a dashboard of readings.\n  How each thing LOOKS is the runtime\'s, one treatment per concept; no key here changes it.\n  A screen the job needs and no key states is a `lotics report` \u2014 the job, what the model\n  drew, the word wanted \u2014 never keys bent to approximate it.\n\n**The working order**\n\n1. Name the people and each one\'s JOB \u2014 the work they alone decide or write.\n2. The entities and fields those jobs touch, and a `records` entry for every entity an\n   app lists, opens or picks.\n3. One app per job in `apps[]` \u2014 the record a person moves and the rhythm they move it at, its own list; what that record owns is its sections, blocks and acts, and work over another record or at another rhythm is another app, even for the same person \u2014 each one working register over one entity; a list worked only in passing is a section of the app it serves, and the log of what was brought into the register\'s rows is a log beside it (`logs`).\n4. `lotics model apply model.json` \u2014 the file is checked first, every problem in one run;\n   then the tables, then a new version of every app, live\n   (`lotics setup model.json --email you@company.com` where no account exists yet).\n5. Change the file and apply it again; `lotics model pull -o model.json` writes what the\n   workspace holds, and each apply of that file sends only what it changes. `apply_model` takes\n   a `patch` in place of `model`: a JSON merge patch (RFC 7396) over the workspace\'s model, each\n   list whose items carry an `alias` written as an object keyed by it \u2014\n   `{ "apps": { "desk": { "acts": { "close": null } } } }` removes one act. Where an aliased item\n   stands is a move beside the patch, `"moves": [{ "at": "apps.desk.acts.close", "after": "hold" }]`\n   (or `"first": true`), placed once the patch merged \u2014 built into an app\'s acts, and a select\'s\n   options (`entities.<entity>.fields.<field>.options.<option>`) reordered on its table, the plan\n   saying each order it writes; a table\'s\n   fields and views and the apps themselves keep the workspace\'s order. A patch whose every key and\n   move lies inside one app\'s body leaves the tables as they stand and builds that app, beside any\n   other app whose build reads what it changed. A `null` removes only\n   what an apply writes as the model states it \u2014 anything inside an app, a `records` entry\n   (`"records": { "<entity>": null }`), a write rule, an entity\'s `singular` and `writes`, a\n   field\'s `default`, `required` and `writes`, a text field\'s `format`, a number\'s `notation`, a field itself, which leaves its table where no row holds a value in it and nothing reads it \u2014 and is refused\n   anywhere else, a table, view, role, template or app among them; one naming\n   nothing the model holds changes nothing. A `null` on a select\'s option is taken, as\n   leaving it out of a whole model is: the model stops stating it, so each app is built without it, its\n   table keeps it and its rows still read, and the apply notes it \u2014 `update_table` removes one, refused\n   while an app still names it. `get_model` with `app` reads one app and the\n   entities it reads.\n   Rolling an app back (`lotics run rollback_app`) restores its earlier version \u2014 table\n   changes and data writes stay.\n\n## The rules\n\n- **At least one entity, at most 50.** More tables than that is a data model\n  being designed, not applied \u2014 apply the rest in a second call.\n- **An existing table is adopted.** `lotics model apply` binds an entity whose `label`\n  already names a table in the workspace, and adds the fields, options and\n  views it is missing. No stored value is ever changed or deleted: a field it\n  adopts takes the model\'s `default` and `required`, a text field\'s `format`, and\n  the `notation` it reads in, where that only relabels \u2014 a date\'s format and a unit\n  converting its figures are left. A computed field\'s definition follows the model: a formula\'s expression,\n  notation and options, a rollup\'s link, aggregation and filter, a\n  lookup\'s link, field and order, and an autonumber\'s `template` (new rows only \u2014\n  existing numbers keep theirs). A check and the apply name each one that changes.\n  Applying the same model twice changes nothing the second time.\n- **A field the file stops stating leaves its table** \u2014 one an earlier apply stated,\n  or one the pulled file stated \u2014 where that loses nothing: no row holds a value in\n  it, and nothing outside the model\'s own apps reads it (a formula, rollup or\n  lookup, a figure\'s unit, a `default_from` copy, a unique set, a query, an agent,\n  a table check or a workflow body of the workspace). Otherwise nothing is applied,\n  and the refusal names the field, how many rows hold a value and what reads it:\n  state the field again to keep it, or clear those rows and stop those readers. A\n  field of the table no model ever stated stays as it is, and so does one a read\n  of the workspace\'s model leaves out \u2014 `get_model` and `lotics model pull` name\n  each in their findings \u2014 since no file made from that read could state it.\n  `lotics model check` names each field the apply would take off.\n- **A label the file changes is a rename.** A field\'s `label`, a select option\'s\n  `label` and a table\'s `description` are written onto the table as the file states\n  them, each named by a check and by the apply. A table\'s own name, a template\'s and\n  a role\'s are reported where they differ and left; a table is deleted on the CLI by\n  `lotics run delete_table`, or by a member in Lotics (\xA7 What a run remembers).\n- **An app\'s labels decide its language.** A model names no locale \u2014 the words an\n  app draws itself (its buttons, empty states, refusals) are in the language its\n  own labels are written in, so a Vietnamese desk beside English ones answers in\n  Vietnamese, and `model apply` notes a label written the other way from the rest\n  of its app\'s. The generated screens read the kit\'s\n  pack, and a generated WRITE cannot: its refusals run on the server, so they are\n  worded in that same language. Mix the two within one app and it answers in two.\n- **Rows land only where every bound table is empty.** One table already holding\n  records and no rows are written anywhere: sample rows landing among a\n  customer\'s real ones cannot be told apart from them.\n- **`lotics model apply` checks all of it before anything is written**, and\n  reports every problem in one run rather than the first. Each section of this\n  page ends its keys with the rules the check enforces there, one sentence each\n  under an id; a finding names its rule\'s id (`[register.filter]`), and\n  `model/<rule id>` is that one rule\'s page.\n\n<!-- generated:start rules-model -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `model.schema` | Every key is one its table lists, holding the type its row gives, and every required key is stated. |\n| `model.retired` | `field_roles`, `table_workflows` and `connections` are no longer part of a model: `records` states how a row is recognised, and an app\'s own writes do what a table automation did. |\n| `model.names-declared` | Every alias a key names is declared: an entity of this model, a field of the entity the key reads, an option of the select it names, an act of the app, a template or an app of this model. |\n| `model.tables` | A model declares at least one table and at most 50; apply the rest as a second model. |\n| `model.rows-cap` | Rows are a sample: at most 200 per entity, 2000 per model and 2000 documents attached \u2014 a real data set belongs in an import. |\n| `model.language` | *Noted, never refused:* A label or description written in the other language than the rest of its app\'s labels \u2014 with or without diacritics. |\n| `model.alias-unique` | An alias is unique where it is named: entities, roles and templates in the model, fields and views in their entity, options in their select. |\n| `model.label-unique` | A label is unique where apply finds it by label: entities, roles and templates in the model, fields and views in their entity, options in their select \u2014 and no view takes its entity\'s own label, which names the whole-table grid apply makes. |\n| `model.template-sha` | A template\'s `content_sha256`, where stated, is the 64-character lowercase hex sha256 of its content. |\n| `model.template-kind` | An act\'s paper and a register\'s `export` are made from an html or an excel template, never an email one. |\n| `model.template-act` | *Refused until adopted or declined:* In a model stating apps none of whose acts runs an authored `workflow`, every html or excel template is made by an act (`template`, `templates`) or filled by a register\'s `export` \u2014 the patch adds the act to the app over the entity whose fields it prints most. |\n| `model.filter` | A filter \u2014 a view\'s, a rollup\'s \u2014 tests fields of the entity it reads, through links as `entity.field` hops each standing on the entity the last lands on, by options its select declares. |\n\n<!-- generated:end rules-model -->\n\n## Top level\n\nEvery table of keys on this page is generated from the schema `model apply`\nparses the file with, so it is the whole of what a key may hold.\n\n<!-- generated:start top-level -->\n\n#### Model file\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `entities` | list of [Entity](#entity) | yes | The tables this model creates, with their fields, options and views |\n| `roles` | list of [Role](#role) | no | Workspace groups to create; members are added to them afterwards |\n| `templates` | list of [Template](#template) | no | Document templates: html and email inline, excel made from an uploaded workbook |\n| `rows` | map of alias \u2192 list of [Row](#row) | no | First records, keyed by entity alias \u2014 written only where every table they land in is empty |\n| `records` | map of alias \u2192 [Record](#record) \\| `null` | no | How a row of each entity is recognised, keyed by entity alias. Every entity an app lists, opens or picks has one; `null` removes the entry its table holds |\n| `write_rules` | map of alias \u2192 [Entity write rules](#entity-write-rules) | no | Entity alias \u2192 what a write of that entity finds, bounds and picks among |\n| `apps` | list of ([App](#app) \\| [Dashboard app](#dashboard-app)) | no | The apps this workspace will have \u2014 each one working register over an entity, with the logs that stand beside it, or a dashboard of readings |\n\n<!-- generated:end top-level -->\n\n**A model carries no** `fixtures`, `knowledge` or `knowledge_expects`, and no\n`word` / `pdf-form` template: file content is uploaded to the workspace, never\nstated in a model \u2014 an `excel` template names its uploaded workbook by `file_id`. `apps` here is what an agent states to make an app,\nnever built code. An unknown top-level key is an error, never ignored.\n\n### Aliases\n\nEvery `alias` is a lowercase slug \u2014 a letter, then letters, digits and\nunderscores (`unit_price`, `so_1001`). Aliases are how the file cross-references\nitself; they are never shown to anyone. `label` is what a person sees.\n\nLabels must be unique within their namespace \u2014 two entities, two fields on one\nentity, two options on one field, two views on one entity, two roles or two\ntemplates cannot share a label, because `apply` matches by label.\n\n## Entity\n\n<!-- generated:start entity -->\n\n#### Entity\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | yes | Stable entity alias, unique within the contract |\n| `label` | text | yes | The table\'s name in the workspace, which apply names it |\n| `singular` | text | no | One row of this table, in the business\'s own words \u2014 what a create\'s button and panel name |\n| `description` | text | no | The table\'s description, written onto the table in the workspace, where a caller of an app\'s queries and workflows reads it beside them |\n| `writes` | `false` | no | false: no app opens or edits this table\'s rows. Direct writes follow the table\'s access, as on any table |\n| `fields` | list of [Field](#field) (at least one) | yes | The table\'s columns |\n| `read_scope` | [Read scope](#read-scope) | no | Which rows a member reads. Absent, every member with access to the table reads every row. |\n| `unique` | list of list of alias (at least one) (at least one) | no | Sets of fields whose values no two live rows share \u2014 each a list of field aliases (text, number, date, a single select, or a link of cardinality "one"). A create or update landing a second row with the same values is refused. |\n| `views` | list of [View](#view) | no | Saved views, in the order they are listed; with none, the table still opens on its default grid |\n\n#### Read scope\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `any` | list of ([Read scope by role](#read-scope-by-role) \\| [Read scope by member](#read-scope-by-member) \\| [Read scope by option](#read-scope-by-option)) (at least one) | yes | A row is readable when ANY of these holds |\n\n#### Read scope by role\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `member_of` | alias | yes | A role alias: whoever is in the group it binds to reads the row |\n\n#### Read scope by member\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `through` | list of alias (1\u20133) | no | select_record_link aliases from this entity outward, each of cardinality "one" \u2014 the clause\'s field is on the entity the last hop lands on |\n| `field` | alias | yes | A select_member field alias on this entity, or on the entity `through` lands on |\n| `is` | `"self"` | yes | The members this column names on a row read that row |\n\n#### Read scope by option\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `through` | list of alias (1\u20133) | no | select_record_link aliases from this entity outward, each of cardinality "one" \u2014 the clause\'s field is on the entity the last hop lands on |\n| `field` | alias | yes | A single-select field alias on this entity, or on the entity `through` lands on |\n| `is` | list of alias (at least one) | yes | Its option aliases whose rows are readable \u2014 naming none would hide every row |\n\n<!-- generated:end entity -->\n\n<!-- generated:start rules-entity -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `entity.singular` | An entity a create is mounted over \u2014 a register that adds, a rows block \u2014 states its `singular`: one row of it, in the business\'s words. |\n| `entity.required-cycle` | Required links never wait on each other in a loop: no row of the loop could be created first. |\n| `entity.link-format` | A text field of `format: "link"` holds web addresses; one whose rows hold a phone or a mail address states no format. |\n| `entity.read-scope` | A `read_scope` clause names a declared role (`member_of`) or a field of its entity reached through one-row links: `"self"` a member field, options a single select declares. |\n| `entity.unique` | A `unique` set names two fields or more of its entity once each, each holding one value to compare \u2014 text, a number, a date, a single select, a one-row link \u2014 and is stated once; one field alone is `unique: true` on it. |\n\n<!-- generated:end rules-entity -->\n\n**`unique` is a set of values no two live rows share.** Each entry names fields\nof this entity holding ONE value \u2014 text, number, date, a single select, a link\nof cardinality `"one"` \u2014 and a create or update landing a second row with the\nsame values is refused. A set of one text field is that field\'s own `unique:\ntrue`, so it is refused here. A create carries each set in the names its panel\nsends, so the panel can name the duplicate before the write does.\n\n**`singular` is what a create says** \u2014 `New Order`, `Add Claim line`, `H\u1ED3 s\u01A1\nm\u1EDBi` \u2014 while `label` names the table, so without it the button reads `New\nOrders`. Nothing derives it: English plurals are irregular, and no language is\nexempt. In a language without plural forms it is usually the label itself,\nless any word for the collection. `model apply` REFUSES a model where a table\nsome create opens \u2014 a register\'s own, or a record section\'s add \u2014 states none.\n\n**`writes: false` says no app opens, edits or files these rows** \u2014 a log of what\nthe system sent, a copy of what another system holds. A record listing them\nkeeps the section and opens each row at rest, with no Add; a screen over the\nentity operates at most the rows its record owns; a party of it is picked, never\nfound or minted; and the generator writes no create and no update for it, and\nnever notes it as created nowhere. It shapes the apps, not who may write: a\ndirect write \u2014 the records API, the chat agent, an import \u2014 follows the table\'s\naccess, as on any table. A `lifecycle` on it is refused \u2014 a row walked\nthrough stages is worked by a person \u2014 and so is a publish desk over it (a rows\nblock\'s `post`), whose ticks make its rows. Absent,\napps open and edit the rows; `true` is not a value.\n\n**`read_scope` is a ROW rule, enforced by the platform.** It is resolved at\napply into the table\'s own row filters, so an app, a workflow reading for a\nviewer, and the API all answer the same rows \u2014 a per-record visibility field the\napp merely honours is a convention, not a gate. A `"self"` clause reads a column\nof one member or several, and every role alias and option alias a clause names\nmust be one this model declares. `apply` writes the rule onto a table it\nCREATES; a table it adopted that ALREADY CARRIES a rule keeps that one, because\nthe rule is the workspace\'s own statement about its rows \u2014 and a run whose model\nstates a different rule reports the entity rather than leaving the claim silent.\n\n**An app may state that its sharing is its read gate: `"reads": "shared"`.** An\napp reads as its owner, so the rule reaches a viewer only as the predicate every\nquery and editor guard of every app over the entity carries \u2014 right for a desk of\none\'s own rows, wrong for a desk whose audience its sharing already decides, where\nwidening the rule meant a role group nobody remembers to fill. Stated on an APP,\nits queries, pickers and guards carry no entity\'s rule and whoever the app is\nshared with reads and writes every row it draws; every other app and the table\'s\nown filters keep the rule. Share it deliberately. Refused on an app none of whose\ntables states a `read_scope`.\n\n**A row rule is never inherited.** A child read under a private record states\nits own: the record\'s `member_of` clauses as they are, and its column clauses\n`through` the one-row link the child hangs by \u2014 over one hop or several, each a\nlink of `"cardinality": "one"`, since over several rows the rule would admit a\nreader any one of them admits while the editor\'s guard reads the first. Only the\nstatus history takes its record\'s rule.\n\n## Field\n\nEvery field carries the keys below, and its `type`\'s section adds the rest; a\ntype whose section names no `default` takes none. `label` may not contain `{` or\n`}` (formulas reference fields by label at the platform level). Every row in `rows` states each\n`required` field it carries (neither a default nor a `default_from` copy is applied to them), and a required\nLINK is written with its row: the entity it names is created first, and entities\nwhose required links name each other are refused, since none of their rows could\never be created.\n\n**A stored field\'s `writes: false` says no person keys it in an app** \u2014 a post\'s\nid a publishing workflow brings back, a count a sync fills. Every app draws it\nread wherever it is placed, no add or act asks it, no paper fills it, and the\ngenerator writes it in no create and no update; a statement line reads it as a\nfigure no person keys, and beside `default_from` it is copied when the row is\nmade and never keyed. It shapes the apps, not who may write: a workflow, the\nrecords API, the chat agent and an import write it as the table\'s access allows.\nA formula, a rollup, a lookup, an autonumber and a date `derive_from` stamps take\nno such key \u2014 no one keys them already. Absent, a person keys the field; `true`\nis not a value.\n\n<!-- generated:start field -->\n\n#### Field\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `type` | `"text"` \\| `"number"` \\| `"date"` \\| `"boolean"` \\| `"select"` \\| `"select_member"` \\| `"select_record_link"` \\| `"files"` \\| `"formula"` \\| `"rollup"` \\| `"lookup"` \\| `"autonumber"` | yes | What the field holds \u2014 each type takes the further keys its own section lists |\n| `alias` | alias | yes | Stable local alias, unique within the entity |\n| `label` | text | yes | The field\'s name in the workspace, which apply names it |\n| `description` | text | no | The field\'s description, written onto the field in the workspace |\n| `required` | boolean | no | Refuse a record whose cell for this field is empty. Apply writes it onto the field, and every write path \u2014 create, update, an agent\'s tool call, a workflow\'s set \u2014 refuses the row by field name. |\n\n<!-- generated:end field -->\n\n### `text`\n\n<!-- generated:start field-text -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `default` | text | no | Value pre-filled into a new record when none is supplied for this field. Applied on create only \u2014 existing records are never backfilled. |\n| `writes` | `false` | no | false: no person keys this field in an app \u2014 a workflow or an integration writes it. Every app draws it read, no add or act asks it and no paper fills it. Direct writes follow the table\'s access, as on any field |\n| `unique` | boolean | no | Unique values required |\n| `format` | `"text"` \\| `"link"` \\| `"markdown"` | no | How the words are drawn \u2014 plain, as a link that opens, or as markdown |\n| `default_from` | text | no | Copied when a record is made off the row a one-row link of this entity names \u2014 `<link alias>.<field alias>` \u2014 and never re-read, so the source changing later leaves the row alone. A value the add states wins; a select copies each option as this field\'s option of the same alias. |\n\n<!-- generated:end field-text -->\n\n### `number`\n\n<!-- generated:start field-number -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `default` | number | no | Value pre-filled into a new record when none is supplied for this field. Applied on create only \u2014 existing records are never backfilled. |\n| `writes` | `false` | no | false: no person keys this field in an app \u2014 a workflow or an integration writes it. Every app draws it read, no add or act asks it and no paper fills it. Direct writes follow the table\'s access, as on any field |\n| `notation` | [notation](#number) | no | How the figure reads: { "style": "decimal" }; money, { "style": "currency", "currency": an ISO 4217 code (USD, VND) }; or a quantity, { "style": "unit", "unit": "percent" (10 reads "10%"), or a measured code (g, kg, t, l, m3, cbm, mm, cm, m, km, m2, min, h, day), which converts and scales within its dimension, or any other noun of at most 12 characters (ki\u1EC7n, pallet, TEU), which never does }. A currency or unit read on each row from a single select of that row is { "per_row": that select }. Omitted, a decimal. |\n| `default_from` | text | no | Copied when a record is made off the row a one-row link of this entity names \u2014 `<link alias>.<field alias>` \u2014 and never re-read, so the source changing later leaves the row alone. A value the add states wins; a select copies each option as this field\'s option of the same alias. |\n\n<!-- generated:end field-number -->\n\n`notation` is how the number reads, and every surface reads it:\n`{ "style": "currency", "currency": "USD" }` prints as money in its code,\n`{ "style": "unit", "unit": "kg" }` as a quantity with its unit after it,\n`{ "style": "unit", "unit": "percent" }` as a percent \u2014 10 is "10%", never\nmultiplied \u2014 and `{ "style": "decimal" }`, or no notation, as a plain number. One\nkey, so a figure reads one way.\n\nThe keys `notation` replaced \u2014 `format`, `currency`, `unit`, `unit_field` and\n`currency_field`, on a number or in a formula, and a formula\'s `format: "link"`\nfor `link: true` \u2014 are no longer read. A field stating them naming another\nreading than its `notation` (a decimal, where it states none) is refused, and the\nfinding names the `notation` to write in their place: `"format": "currency",\n"currency": "USD"` becomes `"notation": { "style": "currency", "currency": "USD" }`.\nWrite `notation`.\n\nAn ABSENT number is drawn absent \u2014 the one exception is a\n`sum` or count rollup the plan reads as a **`measure`**: that is the thing\naccumulated toward a bound, so nothing accumulated yet is zero and the meter\ndraws it. The same rollup read as an `amount` keeps its blank, and so does every\nother role: nothing added to what a row is WORTH means unpriced, not free. A\nformula reading only such sums and counts, and reading zero where each does\n(`{received} - {refunded}`), is one too. A `min`, an `avg`, a percentage of\nnothing and every other formula stay blank in any role, because none of them has\nan answer to give. This is why the pair on one\nscreen reads two ways \u2014 what has come in against what is owed \u2014 and why a\nmeasure\'s own LIMIT, an amount, leaves an unquoted row out of the count rather\nthan reporting it as nothing collected. **AND WHERE THAT LIMIT IS ABSENT \u2014 OR\nZERO \u2014 THERE IS NO LEVEL AT ALL**: a level is a reading AGAINST a bound, so a row\nthat states no bound, or a bound of nothing, draws nothing \u2014 cell, fact and all \u2014\nrather than a numerator whose whole meaning was the comparison. "Collected 0"\nbeside a blank total reads as money against a job worth nothing, and "0 of 0"\nagainst a count of nothing owed claims a comparison nobody can make. A measure the model gives no limit is a plain figure\nand is unaffected. A share is stored in percent units \u2014 68.1 is 68.1 % \u2014 and the\ncolumn, the fact behind it, the meter it is judged by and the figure over the\nregister all say so.\n\nA unit \u2014 `{ "style": "unit", "unit": "kg" }` \u2014 is what a figure counts or\nmeasures; `percent` aside, it is measured or counted. A **measured** unit is a code of one catalog \u2014 mass `g`\n`kg` `t`, volume `l` `m3` `cbm` (a cubic metre under freight\'s name), length\n`mm` `cm` `m` `km`, area `m2`, duration `min` `h` `day` \u2014 so a figure typed in\nanother unit of its dimension converts (`12,5 t` into a `kg` field is 12 500),\nand a tile or a chart reads it in the largest unit it reaches (12 500 kg as\n12,5 t\u1EA5n; CBM never scales) while a cell, a fact and a column always read in the\nfield\'s own. Any other noun of at most 12 characters (`ki\u1EC7n`, `pallet`, `TEU`) is a\n**counted** unit: a word after the figure that never converts. A measured unit is\nwritten as its code \u2014 `t\u1EA5n`, `KG` or `m\xB3` is refused, naming the code. A formula\nstates its own in `formula.notation`; a rollup that keeps the value (`sum`, `avg`,\n`median`, `min`, `max`, `range`) and a lookup carry the unit of the figure they\nread, exactly as they carry a currency, and a count carries none. A quantity is a\nnumber with its unit, never words (`3 cartons` in a text field): only a number\nsums, converts and reads down a column.\n\nA field\'s cells always hold figures in its own unit, so moving it between two\nunits of one dimension (`kg` to `t`) converts every stored figure \u2014 a change made\nin the workspace, in the field\'s settings (which say how many first) or through\n`lotics run update_table`. `model apply` never makes it: the model states the\nworkspace\'s unit until then. Any other change of unit\nrelabels.\n\nA figure whose unit or currency varies by row names a single select of its own\nrow as `per_row` \u2014 `{ "style": "unit", "unit": { "per_row": "uom" } }`,\n`{ "style": "currency", "currency": { "per_row": "currency" } }` \u2014 or a lookup of\none through a one-link, a line reading its shipment\'s currency. That select\'s\noptions are the vocabulary: each label a unit (`chi\u1EBFc`, `kg`), or an ISO 4217 code\n(`USD`). A label outside it is refused when the figure is written and when the\nselect is \u2014 its options, its type or its deletion while a figure names it. A row\nwhose select is empty reads its figure bare. Every app reads each row\'s figure in\nits own row\'s unit, and a sum never mixes units: totals are one per unit, a\nchart draws one at a time. A rollup that keeps the value (`sum`, `avg`, `min`\u2026)\nover such a figure stands only where the child\'s select is a lookup, through\nthe rollup\'s own link, of a select on this entity \u2014 the rollup reads that\nselect\'s unit; otherwise it is refused, as is any lookup of such a figure (its\nunit lives on the other row). A count is unaffected. Moving a field between a\nfixed and a per-row unit relabels.\n\n### `date`\n\n<!-- generated:start field-date -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `default` | text | no | Value pre-filled into a new record when none is supplied for this field. Applied on create only \u2014 existing records are never backfilled. A date string in the field\'s format. |\n| `writes` | `false` | no | false: no person keys this field in an app \u2014 a workflow or an integration writes it. Every app draws it read, no add or act asks it and no paper fills it. Direct writes follow the table\'s access, as on any field |\n| `format` | `"date"` \\| `"datetime"` \\| `"date_range"` \\| `"datetime_range"` | no | Whether the field holds a day or a moment, alone or as a span |\n| `timezone` | text | no | IANA timezone |\n| `derive_from` | `"created_at"` \\| `"updated_at"` | no | Auto-populate from the row\'s system timestamp; the field becomes read-only. |\n| `default_from` | text | no | Copied when a record is made off the row a one-row link of this entity names \u2014 `<link alias>.<field alias>` \u2014 and never re-read, so the source changing later leaves the row alone. A value the add states wins; a select copies each option as this field\'s option of the same alias. |\n\n<!-- generated:end field-date -->\n\nA `default` is refused beside `derive_from`: the platform stamps that date.\n\n### `boolean`\n\n<!-- generated:start field-boolean -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `default` | boolean | no | Value pre-filled into a new record when none is supplied for this field. Applied on create only \u2014 existing records are never backfilled. |\n| `writes` | `false` | no | false: no person keys this field in an app \u2014 a workflow or an integration writes it. Every app draws it read, no add or act asks it and no paper fills it. Direct writes follow the table\'s access, as on any field |\n| `default_from` | text | no | Copied when a record is made off the row a one-row link of this entity names \u2014 `<link alias>.<field alias>` \u2014 and never re-read, so the source changing later leaves the row alone. A value the add states wins; a select copies each option as this field\'s option of the same alias. |\n\n<!-- generated:end field-boolean -->\n\n### `select`\n\n<!-- generated:start field-select -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `default` | list of alias | no | Value pre-filled into a new record when none is supplied for this field. Applied on create only \u2014 existing records are never backfilled. Option alias(es) this field declares \u2014 one for single-select. |\n| `writes` | `false` | no | false: no person keys this field in an app \u2014 a workflow or an integration writes it. Every app draws it read, no add or act asks it and no paper fills it. Direct writes follow the table\'s access, as on any field |\n| `options` | list of [Select option](#select-option) (at least one) | yes | The choices, in the order every picker and every ladder lists them |\n| `multi` | boolean | no | Allow multiple selections |\n| `default_from` | text | no | Copied when a record is made off the row a one-row link of this entity names \u2014 `<link alias>.<field alias>` \u2014 and never re-read, so the source changing later leaves the row alone. A value the add states wins; a select copies each option as this field\'s option of the same alias. |\n\n#### Select option\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | yes | Stable local alias, unique within the field |\n| `label` | text | yes | Display label for the option |\n| `color` | [colour](#select) | yes | The colour the option\'s badge is drawn in |\n| `mark` | [mark](#select) | no | The option\'s own mark, drawn in place of its colour dot wherever the option is shown: the brand it is ({kind: "brand", name: one of facebook, instagram, threads, meta, tiktok, google-ads, zalo, linkedin, x, google-meet, youtube, telegram, whatsapp, gmail, google-drive, outlook, kiotviet, misa, lark, payos}) a kit glyph ({kind: "icon", name: "wrench"}) or the face of who it is, drawn from its label ({kind: "avatar", name: "person" or "organization"}). Every option of a field has one, or none does. A mark a reader does not draw falls back to the dot |\n\n<!-- generated:end field-select -->\n\n`color` is one of: `red`, `orange`, `amber`, `yellow`, `lime`, `green`,\n`emerald`, `teal`, `cyan`, `sky`, `blue`, `indigo`, `violet`, `purple`,\n`fuchsia`, `pink`, `rose`, `slate`, `gray`, `zinc`, `neutral`, `stone`.\nEvery option is drawn in its colour wherever it shows \u2014 a cell, a row\'s line,\na record, a picker, the bar a reading splits the rows by.\n\nAn option may carry its own `mark`, drawn in place of its colour dot wherever\nthe option is shown \u2014 a stage, a chip, a filter, a fact, an entry of a log, a\nreading\'s part, a lookup of the select on another entity. Where the select is its\nrows\' `records` `mark`, a brand stands on the row\'s lead tile and any other option\nleads with its colour dot there. A select a reader scans\ndown a column \u2014 how a payment was made, the channel, the mode \u2014 states one on every\noption, since a glyph reads before its word: the brand it IS\n(`{"kind": "brand", "name": "tiktok"}` \u2014 one of `facebook`, `instagram`,\n`threads`, `meta`, `tiktok`, `google-ads`, `zalo`, `linkedin`, `x`,\n`google-meet`, `youtube`, `telegram`, `whatsapp`, `gmail`, `google-drive`,\n`outlook`, `kiotviet`, `misa`, `lark`, `payos`), a glyph the kit draws\n(`{"kind": "icon", "name": "wrench"}`; any other name is refused), or \u2014 where the\noptions name people or organisations who are no member and no row \u2014 the face of who\nit is, drawn from its label (`{"kind": "avatar", "name": "person"}` or\n`"organization"`). Every option of a select has one, or none does: a run of chips\nwhere one carries no mark reads as the one missing something. `apply` writes the\nmarks onto the table, sets one an adopted option lacks, and reports one it wears\ndifferently rather than overwrite it. The glyphs:\n\n<!-- generated:start field-select-glyphs -->\n\nactivity, align-center, align-left, align-right, align-vertical-justify-center, align-vertical-justify-end, align-vertical-justify-start, arrow-down, arrow-down-a-z, arrow-down-up, arrow-down-wide-narrow, arrow-left, arrow-left-from-line, arrow-right, arrow-right-from-line, arrow-right-left, arrow-up, arrow-up-down, arrow-up-wide-narrow, arrow-up-z-a, ban, banknote, bed, bell, between-horizontal-start, between-vertical-start, bold, bolt, book-marked, book-open, book-text, bot, box, brackets, brain, briefcase, building-2, calculator, calendar, calendar-clock, calendar-off, camera, car, chart-column, check, chevron-down, chevron-left, chevron-right, chevron-up, chevrons-down-up, chevrons-up-down, circle-alert, circle-check, circle-x, clipboard-list, clipboard-paste, clock, code, code-xml, columns-3, columns-3-cog, combine, construction, container, copy, credit-card, database, decimals-arrow-left, decimals-arrow-right, dollar-sign, download, ellipsis, eraser, expand, external-link, eye, eye-off, facebook, file, file-csv, file-down, file-question, file-spreadsheet, file-stack, file-text, file-up, folder, folder-closed, folder-open, folder-pen, form, funnel-plus, funnel-x, gauge, globe, gpu, grid-2x2, grip-vertical, group, hand-coins, hash, heading, heading-1, heading-2, heading-3, history, house, image, inbox, info, instagram, italic, keyboard, languages, layout-dashboard, layout-grid, library-big, link-2, link-2-off, linkedin, list, list-checks, list-collapse, list-filter, list-filter-plus, list-ordered, loader, lock, lock-keyhole, lock-keyhole-open, lock-open, log-in, log-out, mail, map-pin, maximize-2, megaphone, menu, message-circle, message-circle-question-mark, message-square, messages-square, mic, minimize-2, minus, monitor, mouse, mouse-pointer-click, music, newspaper, notepad-text-dashed, package, paint-bucket, paintbrush-vertical, palette, panel-left, panel-left-close, panel-left-open, panel-right, panel-right-close, panel-right-open, paperclip, pause, pencil, percent, phone, pin, pin-off, plane, play, plug, plus, receipt, rectangle-ellipsis, redo, refresh-cw, repeat, rotate-ccw, rotate-cw, rows-3, scan, scan-line, scissors, search, send, settings, share, share-2, shield, shield-alert, shield-check, shopping-cart, sigma, sliders-horizontal, smile, smile-plus, snowflake, sparkles, split, square, square-check, square-pen, square-sigma, stethoscope, sticky-note, strikethrough, table, table-2, tag, target, text-quote, text-wrap, thumbs-down, thumbs-up, ticket, trash, trending-down, trending-up, triangle-alert, truck, tv-minimal, twitter, type, underline, undo, upload, user, user-check, user-pen, users, utensils, waypoints, workflow, wrench, x, zap, zoom-in, zoom-out\n\n<!-- generated:end field-select-glyphs -->\n\n```jsonc\n"options": [\n  { "alias": "short_video", "label": "Short video", "color": "zinc", "mark": { "kind": "brand", "name": "tiktok" } },\n  { "alias": "print",       "label": "Print",       "color": "amber", "mark": { "kind": "icon", "name": "newspaper" } }\n]\n```\n\n### `select_member`\n\nA person picker over the workspace\'s members. No default: a model cannot name\nmembers of a workspace that does not exist yet. With no role it is still drawn \u2014\nface and name, ranked as a `party` \u2014 in a screen\'s `columns` and in the register\na record draws of these rows.\n\n<!-- generated:start field-select_member -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `writes` | `false` | no | false: no person keys this field in an app \u2014 a workflow or an integration writes it. Every app draws it read, no add or act asks it and no paper fills it. Direct writes follow the table\'s access, as on any field |\n| `multi` | boolean | no | Allow multiple selections |\n| `default_from` | text | no | Copied when a record is made off the row a one-row link of this entity names \u2014 `<link alias>.<field alias>` \u2014 and never re-read, so the source changing later leaves the row alone. A value the add states wins; a select copies each option as this field\'s option of the same alias. |\n\n<!-- generated:end field-select_member -->\n\n### `select_record_link`\n\n<!-- generated:start field-select_record_link -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `writes` | `false` | no | false: no person keys this field in an app \u2014 a workflow or an integration writes it. Every app draws it read, no add or act asks it and no paper fills it. Direct writes follow the table\'s access, as on any field |\n| `target_entity` | alias | yes | Alias of the entity this field links to |\n| `sync_both_ways` | boolean | no | Create a paired link field on the target entity for bidirectional sync |\n| `paired_field_alias` | alias | no | The pair edge of a bidirectional link: the field alias ON THE TARGET ENTITY that is this link\'s sync partner. Both sides of a pair carry it, each naming the other. Apply creates whichever side it reaches first WITH the pairing (the platform auto-creates the partner) and binds the partner alias to the auto-created field \u2014 without this edge the two contract fields would be created independently and collide with the auto-created partner. |\n| `cardinality` | `"one"` \\| `"many"` | no | How many linked records this field holds. Default \'many\'. \'one\' holds a single row and needs no partner; where the link IS paired, the partner side holds many. |\n| `display_field_aliases` | list of alias | no | Field aliases on the target entity shown as the link\'s display text / picker columns |\n| `default_from` | text | no | Copied when a record is made off the row a one-row link of this entity names \u2014 `<link alias>.<field alias>` \u2014 and never re-read, so the source changing later leaves the row alone. A value the add states wins; a select copies each option as this field\'s option of the same alias. |\n\n<!-- generated:end field-select_record_link -->\n\nA two-way link is declared on BOTH sides, each naming the other as its\n`paired_field_alias`; the pair must be symmetric or the model is refused.\n\n**A single-valued link needs no partner.** `"cardinality": "one"` on its own is a\nlink that holds one row \u2014 one customer on an invoice, one project on a device \u2014\nand nothing is created on the target. The mirror invariant belongs to a PAIRED\nlink: pair a link when the target\'s own record should list what points at it, and\nleave it unpaired when it should not. Either way the record plan draws the\nrelation as a section on the side it points at, so an unpaired link costs the\ntarget nothing.\n\n### `files`\n\nA row attaches documents to it (\xA7 Rows). Each file\nis drawn by its kind, with no key to choose: a picture (an image, a video) as its\nthumbnail, a document (a PDF, a sheet) as its type\'s badge and its filename.\n\n<!-- generated:start field-files -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `writes` | `false` | no | false: no person keys this field in an app \u2014 a workflow or an integration writes it. Every app draws it read, no add or act asks it and no paper fills it. Direct writes follow the table\'s access, as on any field |\n\n<!-- generated:end field-files -->\n\n### `formula`\n\n<!-- generated:start field-formula -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `formula` | [Formula](#formula) | yes | Formula config. The expression references other fields on the SAME entity by alias in braces, e.g. `{quantity} * {unit_price}`. |\n\n#### Formula\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `expression` | text | yes | The expression, over fields of THIS entity by alias in braces \u2014 `{quantity} * {unit_price}` |\n| `notation` | [notation](#number) | no | How the figure reads: { "style": "decimal" }; money, { "style": "currency", "currency": an ISO 4217 code (USD, VND) }; or a quantity, { "style": "unit", "unit": "percent" (10 reads "10%"), or a measured code (g, kg, t, l, m3, cbm, mm, cm, m, km, m2, min, h, day), which converts and scales within its dimension, or any other noun of at most 12 characters (ki\u1EC7n, pallet, TEU), which never does }. A currency or unit read on each row from a single select of that row is { "per_row": that select }. For a formula yielding a number. |\n| `link` | `true` | no | The formula yields a URL as text, drawn as a link that opens. |\n| `options` | list of [Select option](#select-option) (at least one) | no | The categories the formula yields, drawn as a single select\'s options are (read-only). The expression yields one of them as `{this_field:option}`, or null \u2014 `{days_idle} > 30 ? {warmth:cold} : {warmth:hot}`. Omit for a formula yielding a plain value. |\n| `output_type` | `"number"` \\| `"text"` \\| `"date"` \\| `"datetime"` \\| `"boolean"` \\| `"select"` | no | What the expression YIELDS \u2014 the kind the platform infers at write time, declared here so the offline checks can read it. `notation` beside it is how a number result reads, not what it is. Ignored on the wire (the platform re-infers it); `lotics model pull` writes the inferred value. |\n\n<!-- generated:end field-formula -->\n\n`output_type` is what lets a role or a screen clause accept a computed value: a\ncaption over a derived name (`output_type: "text"`), a period over a settled date\n(`"date"`). A formula declaring no `output_type`, `notation` or `link` says nothing\nabout its result, and every rule that needs one refuses it by name. A formula stating\n`options` is a computed category: read-only, and read as a single select\nwherever it is drawn \u2014 a column, a filter, a reading\'s `by` or `where`.\n\n**A select reaches a formula as the KEYS of its chosen options**, a list \u2014\nnever their labels, and never their aliases \u2014 and a model has no keys: the\nworkspace mints them when the table is made. So an option is named in a formula\nas `{field:option}`, both aliases, and the copy writes that option\'s key in its\nplace: `includes({kind}, {kind:crate})` for a select holding one or several,\n`{kind}[0] == {kind:crate}` for a single one. A select compared to its own words\n(`{kind} != "Crate"`) matches no row and computes the other branch everywhere,\nso the check refuses it and names the token. A select looked up from another\nentity is tested there, in a formula of its own, and that result looked up.\n\n**The language.** The offline check and the platform compute a formula with one\nengine, and the check refuses a call or a name it cannot run, naming what to write:\n\n<!-- generated:start field-formula-language -->\n\n- Operators: `+ - * / %`, `== != > < >= <=`, `&& || !`; `+` also joins text\n- Numbers: arithmetic is exact decimal (`0.1 * 3` is `0.3`), a division that does not end the nearest double; a comparison between two numbers reads both at 15 significant digits; `round` rounds a half away from zero (`round(-2.5)` is `-3`)\n- Conditionals: a ternary only \u2014 `{amount} > 100 ? "High" : "Low"`\n- Not supported: optional chaining (`?.`), nullish coalescing (`??`), template literals, arrow functions \u2014 use `get(obj, "path", default)`, `coalesce(v1, v2)`\n- Helpers are these names, spelled exactly; a spreadsheet function (`IF`, `SUM`, `LEN`, `DATEDIF`) is none of them, and a formula calling one is refused\n- Math: round(n,decimals?), ceil(n), floor(n), abs(n), min(a,b), max(a,b), sum(arr), mean(arr), clamp(n,min,max), percentage(part,total,decimals?), pow(base,exp), sqrt(n), mod(n,divisor)\n- Strings: upper(s), lower(s), trim(s), capitalize(s), length(s), contains(s,search), join(arr,sep), split(s,sep), replace(s,search,rep), replaceAll(s,search,rep), startsWith(s,prefix), endsWith(s,suffix), substring(s,start,end?), padStart(s,len,char), padEnd(s,len,char), numberToWords(n, lang?) (lang \'vi\' default, or \'en\')\n- Lists: includes(list,value), first(list), last(list), unique(list), compact(list) \u2014 length(list) counts one\n- Dates: now(), formatDate(d,fmt), addDays(d,n), subDays(d,n), addHours(d,n), subHours(d,n), addMinutes(d,n), subMinutes(d,n), startOfDay(d), endOfDay(d), differenceInCalendarDays(later,earlier), differenceInHours(later,earlier), differenceInMinutes(later,earlier), isBefore(d1,d2), isAfter(d1,d2), isSameDay(d1,d2), isToday(d), isWithinRange(d,start,end), parseDate(d)\n- Null/type: isNull(v), isEmpty(v) (also true for "" and []), coalesce(v1,v2,...), isString(v), isNumber(v), isBoolean(v), isArray(v), toNumber(v), toString(v)\n- Other: formatCurrency(amount,locale,currency), formatDecimal(value,decimals,locale) (grouped quantity, no symbol), get(obj,"path",default?)\n- Empty cells: a cell nobody filled is null inside a formula, whatever its type; one holding 0, false or "0" is not empty. Test it with `isEmpty({note})` \u2014 `{note} == ""` and `{done} == false` are false on an unset cell\n- Arithmetic over an empty cell: `+` and `-` read it as 0 beside a value (`{fee} + {surcharge}` is `{fee}` when the surcharge is empty, null when both are); `*`, `/`, `%` and a unary `-` yield null (`{price} * {qty}` is null, not 0, when the quantity is empty)\n- No helper throws on an empty cell: the math helpers and toNumber return null, the string helpers "". A value of the wrong type still errors. When EVERY field a formula reads is empty it is null \u2014 unless it reads each only as the argument of isEmpty, isNull or isNotNull (`!isEmpty({file})` is false there, not null)\n\n<!-- generated:end field-formula-language -->\n\n### `rollup`\n\nAggregates the records reached through a link on this entity.\n\n<!-- generated:start field-rollup -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `source_field_alias` | alias | yes | Alias of a select_record_link field on this entity to roll up from |\n| `aggregate_option` | [aggregation](#rollup) | yes | Aggregation operation. Its `field_key` names a field alias on the linked entity. |\n| `filter` | [filter](#views) group | no | Only linked records matching this filter are aggregated; one condition on its own is a group of one. Every `field_key` in it names a field alias on the linked entity, and a select condition\'s value names an option alias there. A traversal node reaches past that entity, so its `path` hops and inner `field_key` are fully-qualified `entity.field` aliases. |\n\n<!-- generated:end field-rollup -->\n\n`aggregate_option` is `{ "operation": \u2026, "field_key": \u2026 }` \u2014 `field_key` a field\nalias on the linked entity (`count` may omit it), and `operation` one of `count`,\n`sum`, `avg`, `median`, `min`, `max`, `range`, `empty`, `filled`,\n`percent_empty`, `percent_filled`, `unique`, `percent_unique`, `earliest`,\n`latest`, `date_range`, `checked`, `unchecked`, `percent_checked`,\n`percent_unchecked`. The operation must be one the aggregated field\'s type\nallows \u2014 `sum` over a number, `earliest` over a date, `filled` over any stored or\nformula field. A lookup is never rolled up: roll up the child\'s own field, or a formula\nover it. A rollup states no `notation`: `sum`, `avg`, `median`, `min`, `max` and `range`\nread in the aggregated figure\'s, a count as a plain number, and a `percent_*` as a\npercent (0\u2013100), in the app as in the table.\n\n### `lookup`\n\nDisplays a field from the linked records.\n\n<!-- generated:start field-lookup -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `source_field_alias` | alias | yes | Alias of a select_record_link field on this entity to look up through |\n| `lookup_field_alias` | alias | yes | Alias of the field on the linked entity to display |\n| `order_by` | [Lookup order](#lookup-order) | no | Show ONE linked row\'s value \u2014 the first in this order \u2014 rather than every linked row\'s |\n\n#### Lookup order\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field_key` | text | yes | A field alias on the linked entity the rows are ordered by |\n| `direction` | `"asc"` \\| `"desc"` | yes | Which end of that order the one row is taken from |\n\n<!-- generated:end field-lookup -->\n\nInside a formula, a lookup holding one value is that value (`{due_soon}` is\n`true`, not `[true]`); several values are a list.\n\n### `autonumber`\n\n<!-- generated:start field-autonumber -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `prefix` | text | no | Literal prefix prepended to every display value (e.g. \'KH-\' \u2192 \'KH-001\'). Ignored when `template` is set. |\n| `padding` | integer | no | Zero-pad the integer to this width. Default 1 (no padding). 3 \u2192 \'001\', \'012\', \'123\', \'1234\' (overflow uses the actual width). Ignored when `template` is set. |\n| `template` | text | no | Format template with placeholder tokens evaluated at insert time. Tokens: {N} (raw integer), {N:W} (zero-padded to width W, e.g. {N:3} \u2192 001), {YEAR} (4-digit year), {YEAR:2} (2-digit year), {MONTH} (2-digit month), {DAY} (2-digit day). Date tokens use the workspace timezone. Example: \'HM-{YEAR}-{N:3}\' yields \'HM-2026-001\'. Stored as the composed string; subsequent template edits do NOT re-format existing rows (date tokens would lose the original creation date). |\n\n<!-- generated:end field-autonumber -->\n\n<!-- generated:start rules-field -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `field.default` | A default names options its select declares \u2014 one on a single select \u2014 and a date stamped by `derive_from` states none. |\n| `field.default-from` | A field\'s `default_from` reads `<link>.<field>` off the row a one-row link of its entity names \u2014 a link no copy fills \u2014 into a field of the same type, date format and notation that `derive_from` does not stamp: a lookup only through a one-row link, a link only into one to the same entity, a select\'s option as this field\'s of the same alias (one it lacks is not copied), several values only into a field holding several. The server copies it on every add that fills the link and leaves the field empty, so an add sure to fill the link \u2014 a required one, or the record it files the row under \u2014 does not ask it by default. |\n| `field.writes` | A stored field\'s `writes: false` says no person keys it in an app \u2014 a workflow or an integration writes it: every app draws it read, no add (`create`) or act asks it and no paper fills it, and a required one takes a `default` or a `default_from` where an app adds its rows; never on a date `derive_from` stamps, which is read already. |\n| `field.option-mark` | An option\'s `mark` is one the kit draws, and a select\'s options mark every one or none. |\n| `field.unit-select` | A notation\'s `per_row` names a single select of the same row, or a lookup of one through a one-link, whose every option label is a unit, or an ISO 4217 code. |\n| `field.link` | A link targets a declared entity: its `display_field_alias` a field of it, its `paired_field_alias` a link on it naming this one back \u2014 and of two paired links at most one reads one row. |\n| `field.formula` | A formula parses, reads fields of its own entity by alias, names an option as `{field:option}` of one a select declares, and compares a select to its options\' keys, never their words. |\n| `field.formula-type` | A formula yields what it states \u2014 its `output_type`, else a figure where it states a `notation` and text where it states `link` \u2014 as the platform infers it from the expression when the field is created. |\n| `field.rollup` | A rollup aggregates, through a link of its entity, a field of the linked entity by an operation a model declares and that field\'s type takes \u2014 never a figure read in each row\'s own unit or currency \u2014 filtered on fields of the linked entity. |\n| `field.lookup` | A lookup reads, through a link of its entity, a field of the linked entity \u2014 never one read in each row\'s own unit or currency \u2014 ordered by a field of it. |\n| `field.computed-cycle` | Computed fields never wait on each other in a loop: each is computed after what it reads. |\n\n<!-- generated:end rules-field -->\n\n## Views\n\nSaved views live under the entity they belong to. Every field reference is a\nfield ALIAS on that entity.\n\n<!-- generated:start views -->\n\n#### View\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | yes | Stable view alias, unique within the entity |\n| `label` | text | yes | Display name of the view |\n| `description` | text | no | The view\'s description, written onto the view in the workspace |\n| `columns` | list of [View column](#view-column) (at least one) | no | The columns the view shows, in this order and no others; absent, every field |\n| `filters` | [filter](#views) | no | The rows the view keeps |\n| `sort` | [sort](#views) | no | The order the view reads its rows in |\n| `summary` | map of text \u2192 text | no | Field alias \u2192 the operation its footer cell states |\n| `frozen_columns` | integer \\| `null` | no | How many leading columns stay in place while the rest scroll |\n\n#### View column\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field_alias` | alias | yes | A field of this entity |\n| `visibility` | `"visible"` \\| `"hidden"` | yes | Field visibility state: \'visible\' = shown to everyone, \'hidden\' = not shown by default but members can toggle |\n| `width` | number | no | The column\'s width, in pixels |\n\n<!-- generated:end views -->\n\nA filter is a group \u2014 `{ "node_type": "group", "logic": "and" | "or",\n"children": [ \u2026 ] }` \u2014 or one condition on its own, `{ "node_type":\n"condition", "type": "select", "field_key": "tier", "operator": "has_any_of",\n"value": ["gold"] }`. A sort is a list of `{ "field_key": \u2026, "order": "asc" |\n"desc" | null }`. A condition\'s `type` is the field\'s type and its `operator` is\none that type admits \u2014 `has_any_of` / `has_none_of` / `has_all_of` / `is_empty` /\n`is_not_empty` for a select, `equals` / `greater_than` / `less_than` for a\nnumber, `on` / `before` / `after` / `between` for a date, `contains` /\n`is_any_of` for text. A select condition\'s `value` names option ALIASES.\n\n<!-- generated:start rules-view -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `view.fields` | A view\'s columns, summary, sort and filters name fields of its entity. |\n\n<!-- generated:end rules-view -->\n\n## Roles\n\nA role becomes a workspace group.\n\n<!-- generated:start roles -->\n\n#### Role\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | yes | Stable role alias, bound to a workspace group when the model is applied |\n| `label` | text | yes | The group\'s name in the workspace |\n\n<!-- generated:end roles -->\n\n## Templates\n\nAn `html` or `email` template carries its content inline, and `{{name}}` in it is filled\nfrom the workflow\'s data; an `excel` template names an uploaded workbook by its `file_id`,\nfilled with the register\'s report by its `export` alone.\n\nInline content is refused where it holds a script, a frame, a `<link>`, an inline event handler or a\n`javascript:` URL; an `html` one may be a fragment, kept as written and printed as a whole document. An apply brings a\ntemplate it made before to the content the model states, and leaves one it adopted by its label as\nits owner wrote it.\n\n<!-- generated:start templates -->\n\n#### Template\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `type` | `"html"` \\| `"email"` \\| `"excel"` | yes | html is a page a workflow renders to a PDF; email is a message a workflow sends; excel is a workbook a register\'s export fills |\n| `alias` | alias | yes | Stable template alias, unique within the contract |\n| `label` | text | yes | The template\'s name in the workspace |\n\n<!-- generated:end templates -->\n\n### `html` and `email`\n\n<!-- generated:start template-inline -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `content` | text | yes | Inline template content; placeholders reference field aliases |\n| `content_sha256` | text | no | sha256 (64-char lowercase hex) of the utf-8 content; derived where the template is written when absent |\n| `locale` | `"vi"` \\| `"en"` | no | The language its figures, dates and amounts in words print in; absent prints in the organization\'s |\n\n<!-- generated:end template-inline -->\n\n### `excel`\n\n<!-- generated:start template-excel -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `file_id` | text | yes | The uploaded .xlsx (`fil_\u2026`) the template is made from; its markers read what the export fills it with |\n\n<!-- generated:end template-excel -->\n\nA paper that has to look like a counterparty produced it \u2014 an official letter,\nan acceptance minute, a supplier\'s bill \u2014 is the same `html` template with a\nshell around the body: a letterhead, a reference line, a seal and a signature\nblock, and paper grain over everything. One shell, many bodies; the data is the\nonly thing that changes, so a workflow can re-issue it over any record.\n\n```jsonc\n{ "alias": "cong_van", "label": "C\xF4ng v\u0103n", "type": "html",\n  "content": "\u2026the page below, as one JSON string\u2026" }\n```\n\n```html\n<style>\n    .sheet{position:relative;width:718px;padding:44px 58px 30px;background:#fbfaf6;color:#111;font:14.2px/1.5 \'Liberation Serif\',serif}\n    .grain{position:absolute;inset:0;opacity:.34;mix-blend-mode:multiply;background:url("data:image/svg+xml;utf8,<svg xmlns=\'http://www.w3.org/2000/svg\' width=\'140\' height=\'140\'><filter id=\'f\'><feTurbulence baseFrequency=\'.9\' numOctaves=\'2\'/><feColorMatrix values=\'0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .35 0\'/></filter><rect width=\'140\' height=\'140\' filter=\'url(%23f)\'/></svg>")}\n    .top{display:flex;text-align:center;font-size:13.4px} .top>div{flex:1} .u{display:inline-block;border-bottom:1px solid #111;font-weight:700}\n    .ref{display:flex;text-align:center;font-size:13.4px;margin-top:6px} .ref>div{flex:1} .ref .r{font-style:italic}\n    h1{text-align:center;font-size:15.6px;margin:26px 0 18px} p{text-align:justify;text-indent:26px;margin:0 0 9px}\n    .sig{display:flex;margin-top:20px} .sig .l{flex:1} .sig .r{width:290px;text-align:center;position:relative}\n    .sig .nm{font-weight:700;margin-top:96px} .seal{position:absolute;left:4px;top:8px;width:166px;height:166px;opacity:.66;mix-blend-mode:multiply;transform:rotate(-17deg)}\n  </style>\n  <div class=\'sheet\'><div class=\'grain\'></div>\n    <div class=\'top\'><div><b>{{issuer_parent}}</b><br><span class=\'u\'>{{issuer}}</span></div>\n      <div><b>C\u1ED8NG H\xD2A X\xC3 H\u1ED8I CH\u1EE6 NGH\u0128A VI\u1EC6T NAM</b><br><span class=\'u\'>\u0110\u1ED9c l\u1EADp - T\u1EF1 do - H\u1EA1nh ph\xFAc</span></div></div>\n    <div class=\'ref\'><div>S\u1ED1: {{number}}</div><div class=\'r\'>{{place}}, ng\xE0y {{day}} th\xE1ng {{month}} n\u0103m {{year}}</div></div>\n    <h1>{{title}}</h1>\n    <p>K\xEDnh g\u1EEDi: {{recipient}}.</p>\n    {{{body}}}\n    <div class=\'sig\'><div class=\'l\'><b>N\u01A1i nh\u1EADn:</b><br>- Nh\u01B0 tr\xEAn;<br>- L\u01B0u VT.</div>\n      <div class=\'r\'><img class=\'seal\' src=\'{{seal_url}}\'><b>{{signer_title}}</b><div class=\'nm\'>{{signer}}</div></div></div>\n  </div>\n```\n\n**What an act\'s template is handed** is its record\'s own fields by alias: a\nselect, a member and a link as their words (a link as the linked row\'s title), a\nnumber, a date and a computed value that declares its kind raw (`2800000`,\n`2026-09-14`) \u2014 never a files field or a computed select. On one record it is\nhanded, too, the rows of each child the record draws as `rows` whose alias the\ntemplate names, listed under that alias for `{{#each <alias>}}` in place of the\nrecord\'s own link to them: every row filed under the record, oldest first, each\nby its own fields as the record\'s are, less its link back to the record. Over\nseveral rows the rows are listed under the entity\'s alias, for\n`{{#each <alias>}}`, without their child rows.\n\nHelpers print a raw value in the template\'s `locale` \u2014 `vi` or `en`, the organization\'s language where it states\nnone; each prints `""` for an empty value:\n\n| Helper | Prints (`vi` / `en`) |\n|---|---|\n| `{{money total "USD"}}` | `1.250,50 US$` / `$1,250.50`, in the currency\'s minor units; no code, a number |\n| `{{number qty}}` | `1.234,5` / `1,234.5`: grouped, up to 2 decimals |\n| `{{date issued_on}}` | `14/09/2026`; a date-fns pattern as the second argument, `{{date at "dd/MM/yyyy HH:mm"}}`, literal text quoted (`"\'Ng\xE0y\' dd"`). A moment prints on the workspace\'s timezone |\n| `{{words total "USD"}}` | `M\u1ED9t ngh\xECn hai tr\u0103m n\u0103m m\u01B0\u01A1i \u0111\xF4 la M\u1EF9 n\u0103m m\u01B0\u01A1i xu` / `One thousand two hundred fifty US dollars and fifty cents`; no code, VND (`\u0111\u1ED3ng`) |\n\nA value it cannot read (`{{money "abc"}}`, `{{date "14/09/2026"}}`) fails the render. A field named like a\nhelper and written alone (`{{number}}`) prints its own value.\n\n## Rows\n\nFirst records, keyed by entity alias. Up to 200 rows per entity and 2000 across\nthe model, attaching at most 2000 documents between them \u2014 a real data set\nbelongs in an import, not a model.\n\n```jsonc\n"rows": {\n  "customer": [\n    { "ref": "acme", "fields": { "name": "Acme Trading", "tier": "gold" } }\n  ]\n}\n```\n\n<!-- generated:start rows -->\n\n#### Row\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `ref` | text | yes | Local handle for this row, referenced by other rows\' link fields |\n| `fields` | map of text \u2192 any value | yes | Field alias \u2192 the value, read against the field\'s declared type |\n\n<!-- generated:end rows -->\n\n<!-- generated:start rules-rows -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `rows.ref` | A row\'s `ref` is unique within its entity. |\n| `rows.required` | A row states every field its entity requires: it is created with what it states, its fields\' defaults and copies unapplied. |\n| `rows.distinct` | Open rows of an entity a register lists read apart: no two state the same title and the same line under it, and an autonumber on the line reads every row apart. |\n| `rows.value` | A row\'s value fits its field: an option alias for a select, `"<entity>:<ref>"` of a row of the linked entity in this file for a link, `"self"` for a member, a relative path beside the file or a `fil_` id for files, a date in the date grammar (an hour only on a datetime), a text, number, yes/no or null otherwise \u2014 and none on a computed field. |\n\n<!-- generated:end rules-rows -->\n\nA `ref` is lowercase letters, digits and underscores, and is never persisted.\n\nA `files` cell attaches documents: paths relative to this file (no `..`, never\nabsolute), which the check proves exist and `apply` uploads into the workspace\nbefore any row is written \u2014 a paperwork business seeds its papers with its\nrows. The server accepts only `fil_` ids of files this workspace owns, which is\nwhat the upload leaves behind. After a run that wrote rows, the WORKSPACE holds\nwhich record each row became, under the row\'s own `<entity>:<ref>`:\n`delete_records` over them is how a seeded set is reset, and applying again\nre-dates it.\n\n`fields` is keyed by field alias, and every value is read against the field\'s\nDECLARED type:\n\n| Field type | Value |\n|---|---|\n| `text` / `number` / `boolean` | the value itself |\n| `date` | `"2026-03-14"`, or a relative expression (below) |\n| `select` | the option ALIAS \u2014 `"gold"`, or `["gold","vip"]` for a multi-select |\n| `select_record_link` | `"<entity-alias>:<ref>"` naming another row in this file \u2014 `"customer:acme"`, or an array for several; a paired link is stated on ONE side (the child\'s link to its parent) and its partner fills itself |\n| `select_member` | `"self"` only \u2014 the person applying the model |\n| `files` | paths beside this file \u2014 `["scans/pccc_letter.png"]` \u2014 uploaded by `model apply`/`setup` before the model is sent; or `fil_` ids of files already in this workspace |\n| `formula`, `rollup`, `lookup`, `autonumber` | not allowed \u2014 the platform writes these |\n\n### Relative dates\n\nA date cell holds a literal `YYYY-MM-DD`, or an expression relative to the day\nthe model is applied, so a screen that opens on "this month" is not empty a month\nlater:\n\n- `@today` \u2014 the day of the run, in the workspace\'s timezone\n- `@month-start` \u2014 the 1st of that month\n- either with a whole-day offset: `@today-14`, `@month-start+9`\n- on a date that holds its hour (`format: "datetime"`), that hour after the day, and always stated:\n  `@today 14:30`, `@today+1 06:00`\n\n`@month-start` exists because `@today-N` cannot promise a month: applied on the\n2nd, `@today-3` lands in the previous one.\n\n## Records\n\n`records` says how a row of each entity is RECOGNISED \u2014 once per entity, keyed by\nentity alias \u2014 and every surface that draws one of its rows reads the same\nstatement: the register\'s row, a picker\'s option, a link\'s chip, a child table\'s\nrow and the record\'s header. Every entity an app lists, opens or picks has one.\n\n```jsonc\n"records": {\n  "visit": {\n    "title": "container_no",\n    "subtitle": ["customer", "arrived_on"],\n    "image": "photos",\n    "status": { "field": "stage", "closed": ["gone"], "history": "visit_history" },\n    "figure": "total_fees",\n    "due": ["free_until"]\n  },\n  // A release order read against what it allows: a meter wherever it shows.\n  "release": { "title": "release_no", "figure": "issued", "limits": { "issued": "units" } },\n  // A dossier\'s stage is the last date it reached \u2014 no stored select.\n  "dossier": { "title": "applicant", "status": { "milestones": ["received_on", { "field": "appraised_on", "when": { "kind": ["loan"] } }, "signed_on"], "closed": ["signed_on"] } },\n  // A site owes a diary page each day it works, from breaking ground through handover.\n  "site": { "title": "name", "cadence": [{ "entity": "diary_page", "on": ["mon", "tue", "wed", "thu", "fri", "sat"], "from": "started", "until": "handed_over" }] }\n}\n```\n\n<!-- generated:start records -->\n\n#### Record\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `title` | alias | yes | The field that names a row \u2014 the first thing every surface shows: who or what it is, a link naming it by the linked row (a job read by its customer). An autonumber is refused; a typed number is the subtitle |\n| `subtitle` | list of alias (1\u20132) | no | Up to two fields read under the title wherever a row is drawn (a code, a date, a party): one line at a desk, wrapping to a second on a phone |\n| `image` | alias | no | A files field that pictures the row \u2014 never one an act keeps the document it makes in |\n| `mark` | alias | no | A single select whose option leads the row wherever a mark leads it \u2014 a list\'s row, the record\'s head, a link naming the row: the option\'s brand, else its colour dot, on a tile. The field stays a field: a subtitle run, a column, a section\'s control. Never beside `image` or `party`, and never the status field |\n| `description` | alias | no | A text field saying what the row is about \u2014 a plan\'s brief, a customer\'s note: read in its record\'s head under the title\'s line, its first lines at rest and whole on a press, and written from the head\'s \u270E. Never on a row\'s line |\n| `party` | `"person"` \\| `"organization"` | no | What each row is where the rows are people (a contact, a patient) or organisations (a customer, a supplier, a carrier); absent, the rows are things (an order, an item, a paper) |\n| `status` | [Status](#status) | no | The stage a row moves through \u2014 a single select or its milestone dates \u2014 drawn as a badge beside its title |\n| `figure` | alias | no | The one number the row stands for, read at its right (a total, a quantity left) |\n| `limits` | map of alias \u2192 (alias \\| number) | no | A number read against a bound \u2014 a field of the same row or a constant \u2014 drawn as a meter wherever it shows |\n| `gates` | map of alias \u2192 (alias \\| number) | no | A pass mark on a meter `limits` bounds \u2014 a field of the same row or a constant; a percent field is its share of the bound, any other number an amount. The meter marks it and fills complete once past it |\n| `tolerance` | map of alias \u2192 number | no | How far past its `limits` bound a meter may stand, in percent of the bound: the bound is an amount expected (received against ordered), not a cap. Without one the bound is a cap, and past it is an overrun |\n| `due` | list of alias (at least one) | no | Dates that are deadlines (stored, or computed as a date): each counts down and turns overdue |\n| `frees` | alias | no | A date ending the row\'s span of days on which what the row holds is free again (a check-out, a hire\'s return): a stay from the 3rd to the 5th holds the 3rd and the 4th, and another may start on the 5th \u2014 on a lanes board, a calendar, a roster and in `no_overlap` alike. Absent, a span of days holds its last day; a span of moments always frees its end |\n| `settled` | alias | no | A yes/no of the row (stored, or a formula: an invoice paid in full) that ends its deadlines: while it is true, no `due` of the row counts down or turns overdue \u2014 in a cell, on its line, in its head, on a calendar or gantt, or in the overdue count. A dashboard\'s or reading\'s `where` reads it as any other yes/no |\n| `task` | `true` | no | A row is work someone finishes: wherever rows of it stand in a table \u2014 a register, a record\'s rows, the rows filed under one \u2014 each is led by a ring ticking it done and unticking it by the one write of the app making that move. Its status is a stored select with `closed` |\n| `cadence` | list of [Cadence](#cadence) (at least one) | no | The rows of a child each row owes one of a day, on the days of the week listed (a site\'s diary page, Monday to Saturday) \u2014 one entry a child, never owed on a day still to come. A roster of these rows over days marks a past day owed with none missing in the danger tone, counted in the legend; today\'s is due, offered to add and never marked; each row\'s total reads the days it holds of those owed |\n| `applies` | map of alias \u2192 map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Fields that apply only while their conditions hold (a length only on a line whose tariff charges by the metre): where one does not apply no add asks it and no surface shows it. Never the title; a required one starts at its `default` |\n| `starts` | map of alias \u2192 `"today"` \\| `"me"` | no | What a field of a row being added starts at, where that start is certain: `today` a date (a moment starts now), `me` a member, the reader adding it; every other field starts empty unless the reader narrowed the register to a value or the field declares a `default` |\n| `scan` | `"text"` \\| `"iso6346"` | no | Its title, a text field, is painted or printed on the thing a row is (a container\'s number, a seal\'s) and read off one photo on a phone, beside each search matching it and each field holding or picking it: `iso6346` a container number, refused unless its check digit holds; `text` as it stands |\n| `place` | [Place](#place) | no | Where a row stands, as plain fields of it, drawn as one place where its record draws the address: how sure it is, a press opening it in the device\'s maps, and one taking it from where the device stands |\n| `plan_place` | [Plan place](#plan-place) | no | Each row is a place on the plan a `plan` register draws: its title the place\'s code, its subtitle a note. A flat list, no tree |\n| `on_site` | [On site](#on-site) | no | Photos taken where a place stands (a site diary\'s): a photo taken through a phone\'s camera here keeps where the device stood, marked at the place, away from it or unknown, and a record holding one taken away says so among its checks \u2014 one with no place (picked on a computer, or kept before places were) is marked and warns nothing; a place reaches only members of the organization, through the apps drawing these photos |\n| `pin` | [Pin](#pin) | no | Each row is a place on a picture (a spot on a container\'s drawing, a room on a plan): a record listing rows that link to these by a single link draws that picture over them, a numbered pin at each listed row\'s place, each row led by its number, the row opened lit on it and a pin pressed opening its row |\n\n#### Cadence\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `entity` | alias | yes | The child entity owed: each of its rows stands on one row of this entity by its single link to it, and on the first date of its line (`records` title or subtitle) |\n| `on` | list of `"mon"` \\| `"tue"` \\| `"wed"` \\| `"thu"` \\| `"fri"` \\| `"sat"` \\| `"sun"` (at least one) | yes | The days of the week one is owed on, each listed \u2014 `mon` to `sun` |\n| `from` | alias | no | A date of this row: the first day one is owed (a site breaking ground, a contract\'s start); absent, no first day |\n| `until` | alias | no | A date of this row: the last day one is owed (a site\'s handover, a contract\'s end); empty or absent, through today |\n\n#### Place\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `address` | alias | yes | A text field: the address, as people write it |\n| `latitude` | alias | yes | A number field: degrees north, negative south |\n| `longitude` | alias | yes | A number field: degrees east, negative west |\n| `accuracy` | alias | no | A number field: how many metres off the device that gave the place said it may be |\n\n#### On site\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `photos` | list of alias (at least one) | yes | Files fields of this row holding photos taken on site |\n| `place` | alias | no | A single link of this row to the row whose `place` its photos are taken at (a diary page\'s site); absent, this row\'s own `place` |\n| `radius` | number | yes | How many metres from the place a photo still counts as taken there |\n\n#### Pin\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `on` | alias | yes | A single link of this row to the row whose picture (its `records` `image`) the place is on \u2014 a container\'s drawing, a floor\'s plan |\n| `x` | alias | yes | A number field of this row: how far across that picture the place stands, in percent from its left edge |\n| `y` | alias | yes | A number field of this row: how far down that picture the place stands, in percent from its top edge |\n\n<!-- generated:end records -->\n\n<!-- generated:start rules-records -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `records.title` | A title names the row by what it is \u2014 never an autonumber; a code is its subtitle, and the subtitle never names the title\'s own field. |\n| `records.image` | `image` is a files field, never one an act keeps the documents it makes in (`into`). |\n| `records.mark` | `mark` is a single select, never the status field, and never beside `image` or `party` \u2014 a list keeps one lead slot \u2014 nor on the folder an app works inside (`scope`), which its switcher names by a picture or its initials. |\n| `records.description` | `description` is a text field, read in the record\'s head \u2014 never a section\'s too. |\n| `records.figure` | A figure is a number. |\n| `records.applies` | `applies` holds a field of the row other than its title to conditions of the same row \u2014 a yes/no (stored or a formula) by `true` or `false`, a single select by its options, its own or looked up through a one-row link \u2014 never to itself; a required field it holds starts at a `default`. |\n| `records.limits` | `limits` bounds a number by a number field of the row, in its unit or one of the same dimension \u2014 or by a constant, where every row reads the figure in one unit. |\n| `records.gates` | `gates` marks a pass on a meter `limits` bounds: a percent field (its share of the bound), another number in the bound\'s unit, or a constant. |\n| `records.tolerance` | `tolerance` stands on a meter `limits` bounds. |\n| `records.starts` | `starts` starts a field a person writes \u2014 `today` a date or a moment (never a span), `me` a member \u2014 and an add that does not ask a field it starts writes that start. |\n| `records.due` | A deadline (`due`) is a date. |\n| `records.frees` | `frees` names a stored day, never a moment: a span of moments already frees its end. |\n| `records.settled` | `settled` names a yes/no of the row (stored, or a formula) beside a `due`: while it holds, the row\'s deadlines neither count down nor turn overdue. |\n| `records.task` | A task entity (`task`) states a `status` of a stored single select with `closed` options \u2014 its ring ticks a row done by moving it to one. |\n| `records.cadence` | A `cadence` names each child once \u2014 its rows standing on one row of this entity by their single link and on the first date of their line \u2014 lists each day of the week once, and `from` and `until` are two different days of this entity. |\n| `records.scan` | A title read off a photo (`scan`) is a text field the row stores. |\n| `records.place` | A `place` names four different fields of the row: its address a text field, its latitude, longitude and accuracy number fields it stores. |\n| `records.on_site` | `on_site` lists files fields of the row, each once, taken at the `place` of the row itself or of the one row a single link of it names (`place`), which states one. |\n| `records.plan_place` | A `plan_place` names `kind`, `sheet` and `reach_from` as single selects, `stacked` as a boolean and the rest as numbers, each a different field; `kind`, `x`, `y` required. `size` names three numbers (`across`, `along`, `up`) stating one cell in one length `unit` alike. |\n| `records.pin` | A `pin` names a single link of the row (`on`) to an entity whose `records` states its `image`, and two different number fields of the row, how far across (`x`) and down (`y`) that picture in percent. |\n| `records.picture` | *Refused until adopted or declined:* Rows an app draws that each hold one files field no act makes, no call is filed into, no files block keeps and no list compares as a pair (`compare`) \u2014 and no figure \u2014 are pictured by it (`image`); where the workspace\'s files are known, the field holding images is the picture, a figure or not. |\n\n<!-- generated:end rules-records -->\n\n- **The title names the row** by who or what it is \u2014 a link by the linked row (a job\n  read by its customer). An autonumber is refused as a title; a typed number is the\n  subtitle.\n- **One lead per row.** A row leads with its picture (`image`), a face (`party`) or the\n  option of a single select it holds (`mark`) \u2014 never two. A `mark` draws that option\n  on a tile: the brand it is, else its colour dot; a row holding none, a ring saying\n  none is picked. The same tile heads the row\'s record and leads it where a link\n  names it; the select stays a field \u2014 a subtitle run, a column, a section\'s control.\n- **A limit** reads a number against a bound \u2014 another field of the row, or a constant.\n  A `gates` entry marks a pass on that meter: a percent field is its share of the\n  bound, any other number an amount.\n- **A deadline** (`due`) counts down wherever it is drawn and is overdue once past while\n  the work is open. A register over the entity says how many rows in view are overdue on\n  its summary line, and pressing that count narrows to them \u2014 no reading to state.\n- **A span\'s free day** (`frees`) is the end date on which what the row held is free\n  again \u2014 a check-out, a hire\'s return. A stay from the 3rd to the 5th holds two nights:\n  a lanes board, a calendar and a roster draw it through the 4th, and `no_overlap` lets\n  the next stay start on the 5th. Without it a span of days holds its last day; a span of\n  moments always ends as the next may begin.\n- **`starts`** is where an add\'s field begins, stated only where that is certain \u2014 a\n  log\'s own day at `today`, a request\'s requester at `me`. Nothing else starts a field\n  but its declared `default` and what the reader narrowed the register to.\n\n## Status\n\nA record\'s `status` is the stage a row moves through \u2014 a stored single select, or the\nmilestone dates it reaches \u2014 drawn as a badge beside its title wherever the row is.\n\n<!-- generated:start status -->\n\n#### Status\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field` | alias | no | The single select that is the row\'s state \u2014 or `milestones` instead |\n| `milestones` | list of (alias \\| [Milestone](#milestone)) (at least 2) | no | Dates in the order the work reaches them, instead of a stored select: the stage is the last one filled, ticking one stamps today, and clearing one clears every later one |\n| `closed` | list of alias (at least one) | no | Options (or milestones) that end the work: a register opens on the rows not at them, and the badge reads muted |\n| `history` | alias | no | A child entity every status change appends one row to (its link to this entity, the new status, the moment and who) \u2014 written by the app\'s own writes, never a table automation; a row the model seeds opens it at its status, the day the rows land, unless the model states its rows; with `field` only |\n| `stages` | map of alias \u2192 [Stage](#stage) | no | Option alias \u2192 who owns that stage and how long it should take: the owner alone presses the acts offered there, refused on the server for anyone else. The status then moves only by acts that `set` one of its options \u2014 no save writes it and no act asks it; with `field` only |\n\n#### Milestone\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field` | alias | yes | A date field: the stage is reached on the day it holds |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | yes | The stage applies only while each named select holds one of these options, and each named stored yes/no is this value; otherwise the row skips it |\n\n#### Stage\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `owner` | text \\| [Stage role](#stage-role) | yes | Who owns the stage: a member field of the row, `link.field` read through a one-row link, or `{ role }` \u2014 a group |\n| `within` | integer | no | Whole days the stage should take from the moment the row entered it |\n\n#### Stage role\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `role` | alias | yes | A role of the model\'s `roles`: every member of the group it binds to owns the stage |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `records.status` | A status is one single select, `closed` naming options of it \u2014 or its `milestones`. |\n| `records.history` | A declared status `history` has exactly one link to the row it records, one single select holding every option of the status (or a text), exactly one date and at most one member. |\n| `records.history-derived` | A `history` the model does not declare is derived and keeps one entity\'s moves, labelled by that entity ("L\u1ECBch s\u1EED <entity label>", or "<entity label> history"): no declared table holds that label, and the entity has no other field under the link it adds. |\n| `records.history-scope` | A status history reads by its record\'s `read_scope`, answered through its one-row link to the record within the links a row rule reaches \u2014 or it states its own. |\n| `records.milestones` | Milestones are dates a person ticks, each named once; `closed` names some of them, and a deadline (`due`) is never one. |\n| `records.milestone-add` | An add asks the first milestone at most \u2014 each after it is ticked in order. |\n| `records.stages` | A stage\'s owner (`status.stages`) is a single member field of the row, one read through a one-row link, or a declared role, on an option that does not end the work; a role\'s stage needs the status `history` with who moved the row. A status with stages moves only by acts that `set` one of its options \u2014 no save writes it, and no act asks it, sets it otherwise or writes it from a workflow \u2014 and the moment its row entered its stage is kept in `<status>_since`, derived beside it, which nothing else writes. |\n| `records.history-note` | *Noted, never refused:* A record, never a task, whose stored status an act of its app moves, with no `history`: when a row entered each status and who moved it is kept nowhere. |\n| `records.detour-note` | *Noted, never refused:* A stage the work only steps aside into \u2014 not where a row starts, entered from one step alone that also moves the work on without it, and left by its own moves only back to that step (a pause, a repair) \u2014 is a detour: its option and the section staged at it stand before that step\'s, else the work reads it as its next step, and the act moving the work into it leads that section \u2014 never a correction waiting in a \u22EF. |\n\n<!-- generated:end status -->\n\n- **The status** is one single select. `closed` options end the work: a register opens\n  on the rows not in them. A `history` entity gets one row per move \u2014 its link to this\n  entity, the new status (a select holding the same option aliases, or text), the\n  moment and who \u2014 appended by the app\'s own writes that move the status, never by a\n  table automation. A `history` the model does not declare is derived, and needs no\n  `records` entry of its own.\n- **Milestones** are the alternative to a stored select: dates in the order the work\n  reaches them, the stage being the last one filled (never stored). A milestone with a\n  `when` applies only while its select holds those options and its stored yes/no that\n  value; otherwise the row skips it.\n  The record draws them as one block where ticking stamps today and clearing one clears\n  every later one; every save and act re-checks that a date comes after each earlier one\n  that applies. `closed` names the milestones that end the work. A register\'s add may ask\n  the first milestone, never a later one; an act may stamp one, never clear it.\n\n## Write rules\n\n`write_rules` is what a WRITE meets, keyed by entity alias; each entity\'s is held\nby its table. Every generated write of an\napp (`create_<entity>`, `update_<entity>`, each act) re-checks these on the\nserver; the screen only mirrors them.\n\n```jsonc\n"write_rules": {\n  // A customer is RECOGNISED by their address. An add that names one \u2014 from the\n  // customers register or from a picker\'s "new" \u2014 reuses the row it matches and\n  // opens one only where nothing does, so the book never grows a second Acme.\n  "customer": { "natural_key": ["email"] },\n  "order_line": {\n    "fields": {\n      // A line of nothing is not a line. Refused on create and on update.\n      "quantity": { "min": 1, "max": 9999 },\n      // Shipped inside its order\'s window: a bound read off the row a link names\n      // is held from both sides \u2014 moving the order\'s dates never strands a line.\n      "ships_on": { "min": "order.placed_on", "max": "order.due_on" },\n      // Nothing is sold off an empty shelf. The picker reads only the rows that\n      // answer this, and the write refuses the same rows again.\n      "product": {\n        "options_where": {\n          "node_type": "group", "logic": "and",\n          "children": [{ "node_type": "condition", "type": "number",\n                         "field_key": "in_stock", "operator": "greater_than", "value": 0 }]\n        }\n      }\n    }\n  },\n  // One booking per room at a time, while it is held: a create or a save whose\n  // span overlaps another held booking of the same room is refused.\n  "booking": {\n    "fields": { "ends_on": { "min": "starts_on" } },\n    "no_overlap": { "from": "starts_on", "to": "ends_on", "by": ["room"], "while": { "state": ["held"] } }\n  }\n}\n```\n\n<!-- generated:start write-rules -->\n\n#### Entity write rules\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `natural_key` | list of alias (at least one) | no | The field aliases a row of this entity is RECOGNISED by. A write that names a row of this entity by these values reuses the row it finds, minting one only where nothing matches. |\n| `fields` | map of alias \u2192 [Field write rule](#field-write-rule) | no | Field alias \u2192 what that field\'s value is bounded by or picked among |\n| `no_overlap` | [No overlap](#no-overlap) | no | No two rows hold overlapping spans \u2014 a create or update that would is refused |\n\n#### Field write rule\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `min` | number \\| text | no | Refuse a create or update whose value is below this: a constant for a number, or a field \u2014 `<field alias>` of the same row, or `<link alias>.<field alias>` of the one row a link names \u2014 of the same type (a return date after the departure, a line\'s day inside its trip). On a figure whose unit or currency is per row (its notation\'s `per_row`) a constant bound is only 0; bound it by a field of the row |\n| `max` | number \\| text | no | Refuse a create or update whose value is above this: a constant for a number, or a field of the same row or of the one row a link names |\n| `options_where` | [filter](#views) | no | Which rows of the target this link may point at \u2014 an `and` group of plain conditions over the TARGET entity\'s own fields, each `field_key` a field alias. It narrows the picker\'s read and is refused again where the write lands. |\n| `same` | list of alias (at least one) | no | One-row links this row and each row this link points at must name alike \u2014 a fee\'s invoice is one of its own visit\'s, a box\'s seal one of its own shipping line\'s: each a one-row link of both entities to the same entity. It narrows the picker\'s read to the rows naming what this row names, a row made from the picker names it too (set, never asked), and a write is refused wherever it lands \u2014 on the link, or on what the two rows compare. |\n| `suggest` | text | no | A text field whose control offers, as the reader types, the distinct values a text field of a catalog holds \u2014 `<entity alias>.<field alias>` (a damage position\'s code among the codes on file); any text is still written |\n\n#### No overlap\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `from` | alias | yes | The stored date (or datetime) a row\'s span starts on |\n| `to` | alias | yes | The stored date (or datetime) a row\'s span ends on \u2014 a day it holds, unless `records` names it the day the row `frees`; a moment another row may start at |\n| `by` | list of alias (at least one) | no | Fields two rows share to compete for a span (the same employee, the same room); absent, every row |\n| `while` | map of alias \u2192 list of alias (at least one) | no | Only rows at these options of these selects hold their span (running, not closed); absent, every row |\n\n<!-- generated:end write-rules -->\n\n<!-- generated:start rules-write -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `write.natural-key` | A `natural_key` is text or a number a person types back, or a one-row link; a text key is unique \u2014 `unique: true`, or the key\'s fields as a set in the entity\'s `unique`. |\n| `write.bounds` | `min` and `max` bound a number or a date \u2014 by a constant a number, by a field of this row or of the one row a one-row link names either, of the same type and unit, never by itself \u2014 and `min` is never above `max`. |\n| `write.bound-per-row-unit` | On a figure whose unit or currency is the row\'s own (its notation\'s `per_row`) a constant bound is only 0 \u2014 bound it by a field of the row. |\n| `write.suggest` | `suggest` stands on a stored text field and names `<entity>.<field>`, a stored text field of a declared entity; the app reads that entity, so it has a `records` entry. |\n| `write.same` | `same` stands on a link and names one-row links this entity and the link\'s target both hold to one entity. |\n| `write.options-where` | `options_where` narrows a link by an `and` group of plain conditions over the target\'s own fields \u2014 a number compared in one unit on every row, a select by options it declares. |\n| `write.no-overlap` | `no_overlap` spans two date fields; `by` names values rows share \u2014 a link, a person, one option, a text or a number; `while` names single selects by their options. |\n\n<!-- generated:end rules-write -->\n\n- A `natural_key` is `text` or `number`, because a person types it back, or a\n  one-row link, because a row is also recognised by the one row it belongs with (a\n  fee by its visit and its kind). A key holding a `text` field is unique: `unique:\n  true` on that field, or the key\'s fields as a set in the entity\'s `unique` (a\n  site by its customer and its name) \u2014 two rows sharing it would make\n  find-or-create pick whichever the read answered first. An add asks the key by\n  default.\n- A `min` or `max` naming a field is read off the row as the save would leave it,\n  and one naming `<link>.<field>` off the row the link names \u2014 the link\'s side\n  re-checks its own rows when that bound moves.\n- A `same` link names only rows that name what this row names \u2014 a fee\'s invoice\n  is one of its own visit\'s \u2014 through a one-row link both entities hold to one\n  entity; its picker offers nothing until the row names one. A row added under a\n  record names what it copies off it (`default_from`) from the start, so a block\n  expecting one line per row of the link lists that record\'s rows alone. A save\n  moving what the two compare, on either row, is refused while they would name apart.\n- An `options_where` link may be left empty; a row it names is refused again\n  where the write lands unless it holds the narrowing. A link naming one kind of\n  a book\'s rows (a "Shipping line" among the parties) narrows to that kind, or\n  its picker offers every row.\n\nA field\'s own `required` is not here: the contract carries it, and every write\npath refuses the row by field name from it. `unique` is the text field\'s own\nclause (\xA7 `text`) \u2014 an add says so at the control before the column does. A\nfield the workspace writes (a formula, a rollup, a lookup, an autonumber, a date\nwith `derive_from`) is never asked, written or edited.\n\n## Apps\n\nAn app is ONE working register over one entity and the record each row opens, with the\nlogs that stand beside it (`logs`) \u2014 or a dashboard of readings. The author states COMPOSITION \u2014 which fields go where; the runtime owns\nhow each thing looks, one treatment per concept. Nothing is drawn that the app does not\nname, and each fact appears once on a record. What the vocabulary has no word for is an\nact\'s own `workflow`, or a workflow the app declares beside its acts (`workflows`).\n\n```jsonc\n"apps": [{\n  "alias": "gate", "name": "Gate in and out", "entity": "visit",\n  "register": { "columns": ["service"], "filters": ["customer", "service"] },\n  "record": {\n    "sections": [\n      { "title": "In", "fields": ["customer", "service"], "blocks": [{ "rows": "fee", "columns": ["amount"] }] },\n      { "title": "Out", "at": ["in_yard"], "fields": ["release", "seal"], "blocks": [{ "files": ["photos"] }], "acts": ["gate_out"] }\n    ]\n  },\n  "acts": [{ "alias": "gate_out", "label": "Gate out", "when": { "stage": ["in_yard"] },\n             "requires": ["release", "seal"], "set": { "stage": "gone", "left_on": "now" }, "confirm": true }],\n  "checks": [{ "field": "unpaid", "blocks": ["gate_out"] }]\n}]\n```\n\nThe keys below are the app\'s own. Each part it composes is a page of its own: `model/logs`, `model/workflows`, `model/queries`, `model/register`,\n`model/layouts`, `model/tabs`, `model/export`, `model/readings`, `model/averages-and-bands`, `model/dashboards`, `model/record-page`,\n`model/blocks`, `model/composed-page`, `model/publish-desk`, `model/timeline-and-agenda`, `model/statements`, `model/reading-blocks`, `model/list-block`, `model/tasks`, `model/acts`,\n`model/papers-and-recordings`, `model/checks`.\n\n<!-- generated:start apps -->\n\n#### App\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | yes | The app\'s name within the model \u2014 what `--from model.json#<alias>` picks |\n| `name` | text | yes | The job, in the words of the people who do it |\n| `description` | text | no | What the job is for, in a sentence |\n| `icon` | text | no | A lucide icon name the launcher tile draws |\n| `theme` | [Theme](#theme) | no | The launcher tile\'s colour |\n| `entity` | alias | yes | The entity whose rows this job works \u2014 the register\'s rows |\n| `books` | list of [Book](#book) (at least one) | no | Other entities the register reads as one list with `entity`\'s rows, each opened, edited and acted on in its own table: the same app over each, its fields lined up with `entity`\'s. Only a table, cards or a plan |\n| `scope` | alias | no | A required one-row link of the entity: the app works inside one row of the linked entity at a time (a project, a branch), picked from a list of them, and every row it reads, counts and adds is that row\'s |\n| `reads` | `"shared"` | no | Every member reads every row, whatever the entity\'s read scope |\n| `writes` | `"children"` \\| `false` | no | `children`: the reader adds and edits the record\'s child rows but not the record\'s own fields. `false`: the reader adds, edits and deletes nothing in the app \u2014 no add, no save, no Delete. Either way the app\'s acts still move a record |\n| `row` | [Row display](#row-display) | no | How this job reads the entity\'s rows where it reads them otherwise than `records` (a cashier\'s figure is what is owed): the subtitle, figure and image stated replace the entity\'s wherever this app draws its rows \u2014 the register, a card, the record\'s header, a calendar, lane or roster entry. The title stays the entity\'s |\n| `register` | [Register](#register) | no | The rows: which columns and filters, the order, how a row is added |\n| `record` | [Record page](#record-page) | no | What a row opens: the door, its sections, and the Activity its head opens \u2014 its saves, and its comments where stated |\n| `acts` | list of [Act](#act) | no | What the reader does to a record \u2014 each a press with its conditions and its write |\n| `checks` | list of [Check](#check) | no | Formulas that warn while they stand, or refuse the acts and saves they name |\n| `logs` | list of [Log](#log) (1\u20133) | no | The lists that stand beside the app\'s register, at most 3: each over another entity, read as a log of what was brought into the register\'s rows or done to them (the files imported, the runs of a batch), with the page a row of it opens. Each is one more entry among the app\'s lists, picked on the line under the title beside the register\'s own rows and counting its rows at an open option of its stored status, and opens as a register of its own inside this app \u2014 its reads, acts and workflows the app\'s. Only the organization\'s own members are shown a log and may read or act on it: a visitor through a public link, and a member of another organization, is not. `reads: "shared"` lifts no row rule of an entity only a log reads. Each list keeps its own records\' activity (`record.activity`). No other app\'s link and no dashboard list opens a row in a log. Never over an entity whose status states owned `stages`; never in an app that states `scope` |\n| `workflows` | map of alias \u2192 [Workflow](#workflow) | no | Workflows of the app no act runs, by alias \u2014 called through the app (`run_app_workflow`, its API) by an agent or a service: each states what it takes and hands back, and its body is set on the app (`set_app_workflow`) and kept by every apply. The screen draws nothing for one |\n| `queries` | map of alias \u2192 [Query](#query) | no | Reads of the app no screen draws, by alias \u2014 called through the app (`run_app_query`, its API) by an agent or a service: each states the rows it reads, what narrows them and what a call may state. The screen draws nothing for one |\n| `declines` | map of text \u2192 text | no | Decided rules this app stays outside of, each with why in a line: by id, and `records.picture:<entity>` and `model.template-act:<template>` with what they fire on. Read by the apply\'s check alone, never by the app |\n\n#### Theme\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `color` | [colour](#select) | yes | The tile\'s colour |\n\n#### Row display\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `subtitle` | list of alias (1\u20132) | no | Up to two fields read under the title in this app, in place of the entity\'s |\n| `figure` | alias | no | The one number a row stands for in this app, in place of the entity\'s; a `limits` bound on it reads as its meter |\n| `image` | alias | no | A files field that pictures a row in this app, in place of the entity\'s |\n\n#### Book\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `entity` | alias | yes | Another entity whose rows the register reads beside its own \u2014 the same job over another table (a legacy ledger, a second branch\'s book) |\n| `fields` | map of alias \u2192 alias | no | A field of the app\'s entity \u2192 the field of this entity holding the same fact, where their aliases differ; a field the app reads lines up by its own alias otherwise, and one this entity lacks is blank on its rows and drops from what they open \u2014 an act, check or add needing it is not offered on them. Options line up by alias |\n\n<!-- generated:end apps -->\n\n<!-- generated:start rules-app -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `app.alias-unique` | An app\'s alias is unique among the model\'s apps, and an act\'s among its app\'s acts. |\n| `app.icon` | An app\'s `icon` is a Lucide icon name in kebab-case, as `receipt` or `trending-up` are. |\n| `app.records-entry` | Every entity an app lists, opens or picks \u2014 its own, a block\'s, a linked row\'s, a document\'s \u2014 has a `records` entry. |\n| `app.reads-shared` | `reads: "shared"` stands only where a table the app\'s register or its record reads states a `read_scope` \u2014 a table only a log reads keeps its rule. |\n| `app.writes-children` | An app that writes only the record\'s children (`writes: "children"`) adds no row of its own entity. |\n| `app.writes-none` | An app that writes nothing (`writes: false`) adds no row, so neither its register nor a block states a `create` list, and no block stands its lines `under` a document a person makes. |\n| `app.scope` | `scope` is a required one-row link of the app\'s entity, the same on every row the app lists \u2014 never a column, filter, search field, group, `where`, `opens`, section field or add question. |\n| `app.when` | A `when` holds single selects to options and yes/nos to `true` or `false`, stored or a formula of one (a formula with `options` is a select) \u2014 a milestone\'s `when` only a stored select or yes/no, read before any formula over it is computed. |\n| `app.asked-written` | What an add, an act or `starts` fills is a field a person writes \u2014 never a formula, rollup, lookup, autonumber or a date the workspace stamps. |\n| `app.own-rows` | A many-link to rows that each belong to one row of this entity is never a section\'s field, an add\'s question or an act\'s ask: those rows are the record\'s own, read as a `rows` block. |\n| `app.create-asks` | An add asks fields of a table people write \u2014 never the link or the folder it files the row under, which the add sets itself. |\n| `app.create-required` | An add (`create`) asks every field its entity requires that nothing else fills \u2014 a `default`, `starts`, the record or folder it files the row under, or a `default_from` over a link it fills \u2014 or the server refuses every add. |\n| `app.books` | A register app\'s `books` each name another entity once \u2014 never the app\'s own \u2014 whose fields line up with the app\'s by alias, else by `fields` (a field the app reads, or one a report prints \u2192 one of the book\'s): read as one column type (a day apart from a moment), one value or several alike, a link to the same entity. Each book holds the title, the status, the folder (`scope`), what `where` keeps and every check locking the rows; the register is a table, cards or a plan, whose `at`, `across` and `up` line up like any field. Two books holding a field of their own under one alias hold it as one kind of value. A report\'s `books` each name the app\'s entity or one of its books, once, and one of them holds each field its `where` and `per` narrow by. `register.book` reads a register that has books. |\n| `app.book-option-kin` | *Noted, never refused:* A book\'s option labelled as one of the app\'s, under another alias, reads apart from it: the register lists both and counts each on its own. |\n| `app.book-lacks` | *Noted, never refused:* A book lacking a field the app\'s record, an act or an add reads: what reads it drops from the book\'s rows \u2014 an act, a block, a section, the add. A field only a report prints, held by a book as another kind of value, prints blank on its rows. |\n| `app.rates-in-passing` | *Noted, never refused:* An app with no act of its own whose rows another app\'s lines copy a number off (`default_from` through a link) \u2014 the rates a quote is priced from \u2014 is worked only while that record is written: a block, a section or an act of that app, never an app of its own. |\n| `app.row` | An app\'s `row` states only what differs from `records`: a line that is not the title, a number for its figure, a files picture no act makes documents into. |\n| `app.files-shown` | Every files field is drawn by some app over its entity \u2014 a section\'s `fields`, a `files` block, a column, the `image`, or where an act making its papers into it (`into`) stands, a section naming the act: the made paper reads under the act, one per template. A files field no app should draw is left out of the model: the apply takes it off its table where no row holds a file in it and nothing reads it. |\n| `app.tasks` | *Noted, never refused:* A task entity an app lists whose rows no write of the app moves to a closed option (its ring stands disabled), or that an act ticks done and none moves back. |\n| `app.declines` | `declines` names decided rules that fire on the app, each with why the app stays as it is: by id, and `records.picture:<entity>` and `model.template-act:<template>`, said once per entity and per template, with what they fire on. |\n\n<!-- generated:end rules-app -->\n\n`writes: "children"` is a desk that adds and edits a record\'s child rows and never\nthe record itself; `writes: false` is a desk that reads \u2014 it adds, edits and deletes\nno row, its logs\' included, and only its acts write. `reads: "shared"` lifts every read scope the app\'s tables state \u2014\nrefused where none of them states one.\n\n`scope` names a required one-row link of the entity: the app works inside ONE row of\nthe linked entity at a time \u2014 a project, a branch, a season. With no folder remembered\nit opens on the list of them, each with how many of the app\'s rows it holds; inside,\nevery read, count and reading narrows to that one, an add files its row under it,\nand the record states its folder in the header. A scope narrows\nthe view; who may read what stays the entity\'s `read_scope`. The folder link is never a\ncolumn, a filter, a search field, a fact or an add\'s question.\n\nAn app whose job reads its rows otherwise than the entity\'s `records` restates them in\nits own `row` \u2014 the cashier\'s figure is what is still owed, its line the service and the\nday. The subtitle, figure and image it states replace the entity\'s wherever that app\ndraws a row of it; every other app reads `records`, and the title is the entity\'s.\n\n### Declines\n\nA rule the check marks *Refused until adopted or declined* is a treatment the apply requires unless the app\ndeclines it. The apply refuses an app missing one and hands it a patch stating it: merge the patch, or state in the app\'s `declines`\nwhy the app stays as it is, under the key the finding names \u2014 the rule\'s id, or `records.picture:<entity>` and\n`model.template-act:<template>` with what they fire on. A decline naming a rule that is not decided, or one no\nrows of the model could fire, is refused. Only the apply\'s check reads `declines`; the app never does. Which\ntreatment each rule stands for: the `design` reference.\n\n```jsonc\n"declines": { "register.span": "The yard plans by the day each hire is due back, never by its run of days" }\n```\n\n## Logs\n\n`logs` are the lists that stand beside the app\'s register: each over another entity, read as a log\nof what was brought into the register\'s rows or done to them \u2014 a supplier\'s price lists imported\ninto a catalogue of parts, the runs of a nightly batch \u2014 with the page a row of it opens. Here a\nline names its part by an optional one-row link, so a held line\'s part is picked where the line\nstands, and its old price is read against its new one.\n\n```jsonc\n"apps": [{\n  "alias": "catalogue", "name": "Catalogue", "entity": "part",\n  "register": { "columns": ["price"], "search": ["name", "code"] },\n  "logs": [{\n    "alias": "price_lists", "name": "Price lists", "entity": "price_list",\n    "register": { "columns": ["read", "changed", "held"], "create": false, "remove": false },\n    "record": { "door": "page", "sections": [\n      { "title": "Held", "blocks": [{ "rows": "list_line", "where": { "outcome": ["held"] }, "columns": ["part", "why"],\n          "compare": { "before": "old_price", "after": "new_price" }, "edits": ["part", "new_price"], "create": false }] },\n      { "title": "Written", "blocks": [{ "rows": "list_line", "where": { "outcome": ["changed", "applied"] },\n          "columns": ["part"], "compare": { "before": "old_price", "after": "new_price" }, "create": false }] }\n    ] },\n    "acts": [{ "alias": "apply_line", "label": "Apply", "of": "list_line", "when": { "outcome": ["held"] },\n               "requires": ["part", "new_price"], "set": { "outcome": "applied" } }]\n  }]\n}]\n```\n\nEach log is one more entry among the app\'s lists, picked on the line under the title (folding into one picker where its line cannot seat it), after one entry for the working register\'s own\nrows under the entity\'s label \u2014 counting the log\'s rows at an open option of its stored status; a log\nwhose entity states no status with `closed` options says no number, and a row holding no\nstatus is not counted. Picking the entry opens the log as a register of its own inside the\napp: its own columns, filters, search, order, add and pages, each row opening its own\nrecord with its sections, blocks and acts. Its reads, acts and workflows are the app\'s \u2014\none launcher tile, one roster.\n\n**Who reads a log.** The organization\'s own members, alone. A visitor through the app\'s\npublic link, and a member of another organization, is shown no entry for it, no address\nof it and no way into its rows, and its reads and acts are refused them. `reads: "shared"`\nis the app\'s statement of what its register and its record read: an entity only a log\nreads keeps its `read_scope`. Each list keeps its own records\' activity (`record.activity`)\n\u2014 a register stating `activity: false` shows none though a log keeps its own. A row of a\nlog opens from its own app: no other app\'s link, and no dashboard `list`, opens one there.\nThe designer\'s notes and decisions judge the app\'s register, never a log.\n\n**A log, or another app.** Decide it from the job. A list is a log of this register where\nits rows are what happened TO the register\'s rows \u2014 a file brought in, a batch run, a sync \u2014\nand are read by the same people in passing, to see what changed and to settle what could\nnot be placed. A list people work every day as a desk of their own \u2014 its own queue, its own\ndeadlines, its own people \u2014 is another app\'s register: a second working register is always\nanother app. The limits keep the difference:\n\n- at most three logs to an app, and none beside `scope`: a log reads every row of its entity;\n- a log is one list \u2014 a table or cards, no `tabs`, no `book` column, no `compose` \u2014 and\n  states only its `alias`, `name`, `entity`, `register`, `record`, `acts` and `checks`;\n- its entity is never the app\'s own, one of its `books`\' or another log\'s, and never one\n  whose status states owned `stages`: the rows waiting on a member are read off registers;\n- an act\'s alias is its own among the app\'s acts and its logs\';\n- no record of the app lists the rows of an entity another of its lists is over: a link to\n  one of them opens it on its own list.\n\nA log\'s own rows are usually a claim of what the system did: state `writes: false` on the\nfields a workflow fills, `"create": false` and `"remove": false` on its register, and let\nits lines \u2014 which people do settle \u2014 be written in place (`edits`) and by their acts. An\napp stating `writes: false` writes none of its logs\' rows either: there, only acts write.\n\n<!-- generated:start apps-logs -->\n\n#### Log\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | yes | The log\'s name within the app \u2014 its place in the app\'s address, and unique among the app\'s logs |\n| `name` | text | yes | What the people who read the log call it, as its entry among the app\'s lists reads |\n| `entity` | alias | yes | The entity whose rows the log lists \u2014 never the app\'s own, one of its `books`\' or another log\'s |\n| `register` | [Register](#register) | no | The log\'s rows: which columns and filters, the order, how a row is added \u2014 a table or cards, with no `tabs` |\n| `record` | [Record page](#record-page) | no | What a row of the log opens: the door, its sections, and the Activity its head opens |\n| `acts` | list of [Act](#act) | no | What the reader does to a row of the log or to a child row its record lists \u2014 each alias unique among the app\'s acts and its logs\' |\n| `checks` | list of [Check](#check) | no | Formulas of the log\'s rows that warn while they stand, or refuse the acts and saves they name |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `app.logs` | A register app\'s `logs` \u2014 at most 3 \u2014 each list another entity under an alias of its own: never the app\'s own entity, one of its `books`\' or another log\'s. A log is one list \u2014 a table or cards, with no `tabs`, no `book` column and no composed record \u2014 over an entity whose status states no owned `stages`, and stands in an app that states no `scope`. An act\'s alias is its own among the app\'s acts and its logs\'. No record of the app or of a log lists the rows of an entity another of the app\'s lists is over: a link to one opens it on its own list. A list people work as a desk of its own is another app. |\n\n<!-- generated:end apps-logs -->\n\n## Workflows\n\nA job no press of the screen starts \u2014 an agent or a service handing the app a file, or a list of\nrows to reconcile a table against \u2014 is a workflow the app declares in `workflows`, by alias. The\nmodel states what it takes and what it hands back; a table is named by its entity and a select by\n`<entity>.<field>`, bound to this workspace\'s own at apply. The screen draws nothing for one: it is\ncalled through the app, by `run_app_workflow` or the app\'s API. On an app shared by a public link it\nruns only for someone who holds the app \u2014 a member it is shared with, or a key that reaches it \u2014 and a\nvisitor\'s call is refused as an alias the app does not have.\n\n```jsonc\n"workflows": {\n  "reconcile_fees": {\n    "description": "Reconciles a visit\'s fees against the lines of the carrier\'s statement.",\n    "inputs": {\n      "visit": { "type": "record_link", "entity": "visit" },\n      "statement": { "type": "file", "required": false },\n      "lines": { "type": "array", "items": { "type": "object", "fields": {\n        "service": { "type": "select", "field": "fee.service" },\n        "amount": { "type": "number" }\n      } } }\n    },\n    "outputs": { "added": { "type": "number" }, "changed": { "type": "number" } }\n  }\n}\n```\n\nIts body is set on the app, never stated in the model: `set_app_workflow` with the app, the alias\nand the `source`, leaving `inputs` and `outputs` out \u2014 the body is checked against what the model\ndeclares. Every apply keeps that body and holds what it takes, what it hands back and its\ndescription to the model. To change what a workflow takes or hands back, change the model first:\nthe apply keeps the body where it still meets the change, and where it does not the workflow\nstands on no body again until `set_app_workflow` sets one that does.\nWith no body it refuses every call, and each apply says so. A workflow the model stops declaring is\narchived with its alias, as one bound on the app by hand that the model never declared is.\n\n<!-- generated:start apps-workflows -->\n\n#### Workflow\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `description` | text | yes | What the workflow does, read by whoever calls it by its alias \u2014 at most 300 characters |\n| `inputs` | map of text \u2192 [Workflow value](#workflow-value) | no | What a call hands it, by name \u2014 checked before its body runs |\n| `outputs` | map of text \u2192 [Workflow value](#workflow-value) | no | What its body returns as `data`, by name \u2014 checked as it returns; absent, read off the body |\n\n#### Workflow value\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `type` | `"text"` \\| `"number"` \\| `"boolean"` \\| `"date"` \\| `"datetime"` \\| `"email"` \\| `"json"` \\| `"record_link"` \\| `"select"` \\| `"member"` \\| `"file"` \\| `"object"` \\| `"array"` | yes | What the value is |\n| `description` | text | no | What the value is for, read by whoever calls the workflow |\n| `required` | `false` | no | false: the value may be left out; absent, it is always there |\n| `multi` | `true` | no | A `record_link`, `select`, `member` or `file` holding several |\n| `entity` | alias | no | The entity a `record_link` names a row of |\n| `field` | text | no | `<entity>.<field>`: the select field whose options a `select` takes, as the field holds them when the workflow runs |\n| `options` | list of alias (at least one) | no | The values a `select` takes, where no field holds them |\n| `fields` | map of text \u2192 [Workflow value](#workflow-value) | no | An `object`\'s values, by name |\n| `items` | [Workflow value](#workflow-value) | no | What each item of an `array` is |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `app.workflow-value` | A value a declared workflow (`workflows`) takes or hands back states what its type needs and nothing another type does: a `record_link` its `entity`, a `select` its `options` or the `field` holding them \u2014 never both \u2014 an `object` its `fields`, an `array` its `items`; `multi` stands on a `record_link`, `select`, `member` or `file`; an output is never a `member` or a `file`; and a value nests at most 8 deep. |\n| `app.generated-name` | A name the app generates is taken by nothing its model states. No declared workflow and no act\'s `workflow` is `record_activity` or `record_activity_undo`, unless the record states `activity: false`. No declared query, no reading\'s `alias` \u2014 a log\'s as it is read, `<entity>_<alias>` \u2014 and no tab\'s read (`<entity>_list_<tab>`) is the name of a read the app generates, of a declared query or of a reading. |\n\n<!-- generated:end apps-workflows -->\n\n## Queries\n\nAn app generates a query for everything its screen reads (`lotics docs agent_surface` lists them). A question\nthe screen never asks \u2014 one a caller asks the app through `run_app_query` or its API \u2014 is declared in\n`queries`, by alias, in the model\'s own aliases: the entity whose rows it reads, the fields each row\nreturns or the figure they add up to, and what narrows them.\n\n```jsonc\n"queries": {\n  "fees_unbilled": {\n    "description": "A customer\'s fees no invoice covers yet, oldest first.",\n    "params": {\n      "customer": { "type": "record_link", "entity": "customer", "description": "The customer whose fees are read." },\n      "since": { "type": "date", "required": false, "description": "Only fees charged on or after this day." }\n    },\n    "rows": "fee",\n    "fields": ["visit", "service", "amount", "charged_on"],\n    "where": { "billed": false, "customer": { "param": "customer" }, "charged_on": { "from": { "param": "since" } } },\n    "sort": { "field": "charged_on" },\n    "limit": 200\n  },\n  "fees_by_service": {\n    "description": "What was charged per service: how many fees and their amount.",\n    "rows": "fee",\n    "reading": { "value": "amount", "by": "service" }\n  }\n}\n```\n\nAn entry of `where` holds what a reading\'s `where` holds \u2014 a select\'s options, a yes/no\'s value, `"me"` on a\nmember field \u2014 or a value the call states: `{ "param": "<name>" }`, an object, which none of those is. A\nrequired param is always stated; one stating `required: false` may be left out, and the condition reading it\nthen narrows nothing. A query reads under its entity\'s read scope, as every read of the app does, and its\nown entity as its list reads it: kept by the register\'s `where`, and inside the row `scope` names \u2014 a param\nthe app adds to the query, `<linked entity>_id`. A `reading` returns one row for all the rows it reads, or\none per value of `by` or per day of `over`. The screen draws nothing for a query, and an apply compiles it\nwith the rest of the app: no body is set. An apply writes the queries the model compiles and no other:\na query set on the app outside the model (`set_app_queries`, on the CLI or in chat) is removed by the next apply, whose plan and\nanswer note it; declared under its alias in `queries`, it is the model\'s.\n\nA query reads one table: on an app that states `books`, whose list reads several, it names a book\'s own\nentity, never the app\'s. A param compares a field holding one value \u2014 or, as a range, a date or a number\n\u2014 and never a number read in each row\'s own unit or currency, where one figure is a different amount on\neach row, nor a date holding a span.\n\nEvery reading of the app \u2014 a dashboard\'s, a register\'s band\'s, a record\'s block \u2014 is a query too, returning\nits groups. It is called by its place, `dashboard_reading_<n>`, `register_reading_<n>` or\n`block_reading_<n>`, counted from 0, so a reading moved is called by another name. One that states `alias`\nis called by it wherever it stands. A log\'s reading is called by the log\'s entity before either name:\n`<entity>_register_reading_<n>`, or `<entity>_<alias>`. A register\'s reading placed in time (`over`) takes `from` and `to`,\neach left out at will; one above a register with tabs reads its `tab`\'s rows, or every tab\'s where it\nstates none:\n\n```jsonc\n{ "metric": "visit", "value": "fees", "where": { "paid": false }, "label": "Unpaid", "alias": "fees_unpaid" }\n```\n\n<!-- generated:start apps-queries -->\n\n#### Query\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `description` | text | yes | What the query answers, read by whoever calls it by its alias \u2014 at most 300 characters |\n| `params` | map of alias \u2192 [Workflow value](#workflow-value) | no | What a call states, by name, each read by an entry of `where` \u2014 a `number`, `boolean`, `date`, `select`, `record_link`, `member`, holding one. `required: false`: the call may leave it out, and the condition reading it narrows nothing |\n| `rows` | alias | yes | The entity whose rows it reads, under that entity\'s read scope unless the app reads `shared`. The app\'s own entity is read as its list reads it: kept by the register\'s `where`, and inside the row the app\'s `scope` names, which the call states |\n| `fields` | list of alias (at least one) | no | The fields each row returns, by alias. A query states `fields` or `reading`, one of the two |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"` \\| [Query param](#query-param) \\| [Query range](#query-range)) | no | Only the rows meeting every entry, by field: a select holding one of these options, a yes/no this value, a member field holding the reader (`"me"`) \u2014 or what the call states: `{ "param": "<name>" }` on a select, a yes/no, a one-row link, a member or a number, and `{ "from": { "param" }, "to": { "param" } }` on a date or a number, either end alone |\n| `sort` | [Sort key](#sort-key) \\| list of [Sort key](#sort-key) (at least one) | no | The order the rows return in; absent, the order the entity\'s list reads in. Only with `fields` |\n| `limit` | integer | no | The most rows returned. Only with `fields` |\n| `reading` | [Query reading](#query-reading) | no | The rows counted or summed instead of returned: one row for all of them, or one per value of `by` or per day of `over`, each carrying its `by` field or `__day`, `__count`, and `__sum` where `value` is stated |\n\n#### Query reading\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `average` | `true` | no | The `value` is averaged: summed over the rows holding one, beside how many hold one. Never with `by` or `over` |\n| `by` | alias | no | The single select, one-row link, member or yes/no each row is counted under \u2014 one row returned per value |\n| `over` | alias | no | A date: one row returned per day of it. Never with `by` |\n\n#### Query param\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `param` | text | yes | A param of this query: the condition holds what the call states for it, and is left out where the call states none |\n\n#### Query range\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `from` | [Query param](#query-param) | no | The param the field is on or after \u2014 a date\'s first day, a number\'s least |\n| `to` | [Query param](#query-param) | no | The param the field is on or before \u2014 a date\'s last day, a number\'s most |\n\n#### A reading\'s name\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | no | On any reading \u2014 a dashboard\'s, a register\'s band\'s, a record\'s block: the name its query is called by (`run_app_query`), its own among the app\'s readings and queries; absent, its place names it \u2014 `dashboard_reading_<n>`, `register_reading_<n>`, `block_reading_<n>`, counted from 0 \u2014 so a reading moved is called by another name |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `app.query` | A declared query (`queries`) reads one entity\'s rows as `fields` or as a `reading`, one of the two \u2014 never the app\'s own entity where the app states `books`, whose list reads several tables; `sort` and `limit` stand with `fields`; a `reading` splits by `by` or by the day of `over`, never both, and averages only with neither; each param is a number, a yes/no, a date, a select, a one-row link or a member holding one, read by an entry of `where` on a field of its type \u2014 a date by a range, a number by either, and never a number read in each row\'s own unit or currency or a date holding a span. |\n| `app.surface-described` | *Noted, never refused:* A value a declared workflow takes, and a param a declared query takes, that states no `description`: the one line a caller reads to fill it. |\n| `reading.alias` | A reading\'s `alias` is its own among the app\'s readings and declared queries, a log\'s read by its entity before it (`<entity>_<alias>`); the work against its plan above a register states none \u2014 it reads the register\'s own rows. |\n\n<!-- generated:end apps-queries -->\n\n## Register\n\n```jsonc\n"register": { "columns": ["service", "release"], "filters": ["customer", "service"], "create": ["container_no", "customer"] }\n```\n\nEach of `filters` is also an optional param of the register\'s list query, `<entity>_list`, typed as its\nfield: `customer_is` and `service_is` here, a date as `<field>_from` and `<field>_to`, a number as\n`<field>_min` and `<field>_max`. A call stating none of them reads every row the list reads. A filter on\na looked-up link or member, on a number read in each row\'s own unit or currency, on a date holding a span,\nand every filter of an app that states `books` is no param: a call narrows by those with `filters`.\n\n<!-- generated:start apps-register -->\n\n#### Register\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `columns` | list of alias | no | Fields read as columns after the row\'s title \u2014 on a calendar\'s entry or a lane\'s block, its facts after its title; never what the row draws itself (its subtitle, image, status, figure, or the bound its figure\'s meter reads against), which the runtime places. At most 5 besides the row\'s name, status, deadlines and figure: a table draws every column and folds the last stated onto the name\'s line as it narrows, so more is refused |\n| `filters` | list of (alias \\| [Tiered filter](#tiered-filter)) (at most 3) | no | The fields the reader narrows the rows by every day, in that order \u2014 each earns its place by that daily use, so none to 3 is normal and 3 is a cap, never a quota (a select, a member, a link, a date, a yes/no, a number as a range, or its `tiers` where the business narrows by those bands daily) \u2014 each on a desk\'s line; a phone\'s one Filters sheet holds them. Never the status (its chips); each a field the rows show \u2014 a column, or a part of the row \u2014 or a formula whose every field of its row it reads they show. A threshold the business names ("large orders") is a formula yes/no here; a column\'s header sorts by a day or an amount |\n| `book` | `true` | no | With `books`: a column naming the table each row is of, and a filter by it |\n| `search` | list of alias (at least one) | no | The fields the search box matches (a link by its row\'s title); a pasted list searches each line and names the lines no row matched. Absent, every word of the row |\n| `group` | alias | no | The field the rows open grouped by, the reader\'s grouping starting there \u2014 a period\'s rows read under each period, one per person; absent, ungrouped |\n| `sort` | [Sort key](#sort-key) \\| list of [Sort key](#sort-key) (at least one) | no | The order rows open in: one key, or a list of keys most significant first, each breaking the ties of the ones before it (a select orders by its options\' order); absent, the first deadline soonest first, else the newest first |\n| `layout` | `"table"` \\| `"cards"` \\| `"calendar"` \\| `"roster"` \\| `"lanes"` \\| `"gantt"` \\| `"plan"` | no | `cards` for rows read by their picture; `calendar` for rows read by their day \u2014 a month, a week, a day or a list, an entry at its hour where its date holds one and over its span where its line holds a second date; `roster` for what each row did on each day of a week or a month (who worked which shift, which vehicle ran), or with `expect` which of a set each row holds; `lanes` for rows booked on a resource over time (an appointment in its chair, a hire on its machine); `gantt` for rows each planned over a run of days, one bar a row on one axis of time (a shipment from its sailing to its arrival, a hire from its start to its return, a task of a project) \u2014 its dates in `gantt`, its lanes the register\'s `group`; `plan` for things that stand at a place (boxes in a yard) \u2014 drawn on a plan of the places, a bay enlarged to its rows and tiers, and in 3D \u2014 the place each stands at in `plan`; absent, a table |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Only the rows whose select holds one of these options and whose yes/no (stored, or a formula) is this value \u2014 read so on the server and never offered as a chip: the rows this app works of an entity other apps read whole (the purchases, of orders both ways). A row added here holds a select\'s one option and a stored yes/no\'s value |\n| `opens` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | The view the register opens on: each entry a narrowing on a field the rows show (or a formula of fields they show) that stands as a chip the reader may take away (the rows still owed), `"me"` a member field holding the reader (the rows mine). One on the status replaces the chips\' opening on the open work \u2014 `"me"` on a status whose `stages` have owners opens on the rows waiting on the reader |\n| `remove` | `false` | no | The app edits its records and offers no Delete on them (a row\'s \u22EF, its record\'s \u22EF) \u2014 a desk correcting a date of records another app makes and closes; absent, a record the app writes is deleted where it stands |\n| `create` | list of alias (at least one) \\| `false` | no | The fields asked when a row is added; absent, the title, the subtitle and figure no default fills, the natural key and every required field \u2014 each a person writes; false, rows are not added here |\n| `readings` | list of ([Metric](#metric) \\| [Breakdown](#breakdown) \\| [Trend](#trend) \\| [Pivot](#pivot) \\| [Progress](#progress)) (at least one) | no | Readings of the register\'s own entity above its rows, over the rows in view \u2014 the search, the status and the filters narrow them, but a picture\'s own field, read as the register opens on it. A press on a breakdown\'s part, a pivot\'s cell or a figure with `where` narrows the rows by its field, as a filter does |\n| `attention` | `false` | no | false: a table\'s or cards\' rows keep the register\'s own order (a first-come queue), and no column names whose step each row stands at; absent, those needing attention open first \u2014 those at a step the reader owns, then overdue, then due within 3 days, then those whose line states a warning \u2014 each part in that order, until the reader picks another |\n\n#### Tiered filter\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field` | alias | yes | A number \u2014 stored, or a formula or rollup reading one \u2014 in one unit for every row |\n| `tiers` | list of number (at least one) | yes | The breakpoints between its bands, ascending, in the field\'s stored unit: under the first, from each to the next, from the last up \u2014 each band worded in the field\'s notation; a filter picks several at once |\n\n#### Sort key\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field` | alias | yes | The field rows are ordered by |\n| `desc` | `true` | no | Latest or largest first; absent, soonest or smallest first |\n\n<!-- generated:end apps-register -->\n\n<!-- generated:start rules-register -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `register.column-drawn` | A column never names what the row draws itself \u2014 its title, subtitle, image, status, figure, or the bound its figure\'s meter reads against \u2014 and names a field once. |\n| `register.columns-budget` | A register spends at most 3 columns, what a desk draws whole; a deadline costs two. |\n| `register.filter` | A filter names a select, a member, a link, a date, a yes/no or a number of the register\'s own rows \u2014 a lookup through one-row links as the field it reads \u2014 never the status (its chips), nor one `where` fixes. |\n| `register.filter-split` | *Noted, never refused:* A filter on a field a breakdown or pivot in the band splits the rows by \u2014 a press on its part narrows by it too; a member\'s filter, which narrows to the reader\'s own rows, is never noted. |\n| `register.filter-unshown` | A filter, a narrowing the register `opens` on, and a press in its band (a breakdown\'s part, a pivot\'s cell, a figure\'s `where`) name a field its rows show \u2014 a column; the row\'s title, the line under it, its picture, status or figure, a meter\'s bound, or the unit or currency a drawn figure is read in; a deadline; a warning its line says; the group or lane it stands under \u2014 or a formula, drawn where every field of its own row it reads is (through other formulas too; one reading no field is drawn nowhere). A narrowing to the reader (`"me"`) needs none. |\n| `register.tiers` | `tiers` band a number read in one unit on every row; a figure read in each row\'s own unit or currency is named bare. |\n| `register.search` | `search` names text, a code, or a link \u2014 matched by its row\'s title. |\n| `register.sort` | Each `sort` key names a field of the register\'s rows that holds an order \u2014 never files \u2014 and no field twice. |\n| `register.group` | `group` names one value per row \u2014 a single select, a one-row link, one member, a date, a yes/no or a text, a lookup through one-row links as the field it reads \u2014 never the status (its chips); only a table groups, and a gantt into its lanes; grouping by the title needs a subtitle to lead each row. |\n| `register.readings-own` | A register\'s `readings` read its own entity; another entity\'s stand on a dashboard. |\n| `register.readings-bands` | A register reading that bands a number by `tiers` has that field with the same tiers among the register\'s `filters`: a press on a band narrows the rows by that filter. |\n| `register.readings-restate` | A register\'s metric never sums the row\'s figure or counts the rows without a `where`: the summary line totals the figure and the status chips count the rows. |\n| `register.where-opens` | `where` and `opens` hold the register\'s own selects and yes/nos, and `opens` a member field holding the reader (`"me"`) \u2014 or, on a status whose `stages` have owners, the rows waiting on the reader; a field `where` fixes is never a filter nor opened otherwise, and `opens` stays among the options `where` keeps. |\n| `register.band-pivot` | *Noted, never refused:* A pivot in a register\'s band: its grid reads on a dashboard, and the band leads with a `metric`. |\n| `register.headline` | *Refused until adopted or declined:* A register over rows that move (a status, a deadline) or carry money, laid out as a table, cards or a gantt, states `readings` \u2014 the patch splits the rows by a field they show and reads them over a date. |\n| `register.span` | *Refused until adopted or declined:* Rows that each span a run of days or hours \u2014 two dates on their line, a `frees`, or a `no_overlap` booking them on what its `by` links to \u2014 are drawn in time by some register over them (a calendar, lanes, a gantt or a roster) \u2014 the patch adds an app over them laid out as lanes on what each one books, else as a gantt. |\n| `register.remove` | A register\'s `remove: false` hides the Delete its records would offer, so it stands only where the app writes its records. |\n| `register.attention` | `attention: false` keeps a table\'s or cards\' rows in the register\'s own order \u2014 a first-come queue; a calendar, lanes, a gantt and a roster stand their rows in time and lift none. |\n\n<!-- generated:end rules-register -->\n\nThe status is always the chips, with\ncounts, opening on the rows not closed (every row on a calendar or a lanes board, whose\nwindow of time narrows them) \u2014 never one of `filters`. `filters` are the ones a reader\nnarrows by every day \u2014 none to three, never a quota \u2014 in order of use, each a field the\nrows show (a column, a part of the row) or a formula yes/no, drawn where every field of\nits own row it reads is drawn, at that width \u2014 each on the line\nwith the search and the chips, the grouping one\nchip at its end; a member filter offers "mine". A date filters by a range of days \u2014 of\nminutes on a `datetime` field, its end not held, so back-to-back shifts read each row\nonce \u2014 and can keep the rows holding no date too (in the yard at a moment: in before it,\nout after it or not yet). A number filters by a range typed in its\nunit or currency \u2014 a figure read in each row\'s own, in the one picked beside it \u2014 with a\nslider over a percent or a figure against a constant `limits`; `{ "field", "tiers" }`\noffers the bands its breakpoints cut in place of a range (`[1000, 5000]` on a weight in\nkg: under 1.000 kg, 1.000\u20135.000 kg, 5.000 kg and over), refused on a figure read in each\nrow\'s own unit. A threshold with a name is a formula yes/no, never a range. A\ncolumn the row already draws is refused. `sort` is one key or a list of keys, most\nsignificant first, each breaking the ties of the ones before it \u2014 a shipping line in its\nselect\'s option order, then the arrival day soonest first:\n`[{ "field": "shipping_line" }, { "field": "arrived_on" }]`; a header\'s press leads them.\nAbsent `sort`, rows open soonest deadline first where the row has a `due`, else newest first. `search` names the fields\nthe search box matches \u2014 a link by its row\'s title \u2014 and a pasted list searches each\nline, naming the lines no row matched; absent, it matches every word of the row.\n\n`where` keeps the rows the app works, read so on the server and never a chip: a\npurchase desk over orders of both directions states `"where": { "direction":\n["purchase"] }`, and a row added there is written holding the one option (a select kept\nat several is asked among them). `opens` is the view the register opens on, each entry a\nchip the reader may take away: a cashier opens on `"opens": { "owes": true }`. Both take\na select\'s options or a yes/no\'s value, stored or a formula; `opens` on the status is\nthe chips\' opening choice. `opens` also takes `"me"` on a member field \u2014 `"opens": {\n"assignee": "me" }` opens on the rows assigned to whoever reads, the server reading the\nreader, never the page; `where` refuses it, since it fixes the rows for every reader\n(who may read a row at all is the entity\'s `read_scope`).\n\nHow the rows are laid out is \xA7 Layouts, tabs over a period \xA7 Tabs, the report \xA7 Export, and the band above\nthe rows \xA7 Readings.\n\n## Layouts\n\n`layout` is how the register draws its rows \u2014 one of the pages below; absent, a table. Each reads what the\nrows already state (their `records` line, status and dates), and the keys a layout adds stand on its page.\nWhich one a job needs: the `design` reference.\n\n### Table\n\nAbsent `layout`, each row is one line: the entity\'s `records` entry \u2014 its picture or mark, title and the line under it\n\u2014 then the status, the `columns`, and the figure at the right; the title, the status and a column of days or\namounts sort the rows by their header. A table groups its rows by `group` (a gantt draws it as its lanes); a\ntable or cards reads `tabs` and `books`.\n\n### Cards\n\n`layout: "cards"` draws each row as a card led by its picture \u2014 the `records` `image`, or the app\'s\n`row.image`: its title and the line under it, its status and what needs the reader (a deadline, a warning),\nthen its figure and the register\'s `columns` at its foot. Cards are for rows found by their picture (a\nproduct, a vehicle, a damage photo); rows with no picture read better as a table.\n\n### Calendar\n\n`layout: "calendar"` places each row on its day \u2014 a month, a week, a day or a list (a\nphone reads the list or a day): at its hour where the date holds one, over its span\nwhere the row\'s line holds a second date after it, its line\'s other words and the\nregister\'s `columns` after its title. The calendar reads the window in view, and its\ncount and the status chips count that window, opening on every row.\n\n### Lanes\n\n`layout: "lanes"` with `lanes` naming a one-link draws each row of the linked entity as\na lane (a chair, a machine, a room), empty ones too, and each register row as a block\nfrom the first date on its line to the second: over the hours of one day where the first\nholds its hour, else over the days of one day, a week or a month. A block reads the row\'s\nname and the first of its `columns`; a free stretch between blocks adds a row there, its\nlane and its start set, and its end where the next block bounds it. A phone lists each\nlane\'s blocks and free stretches in clock order. Rows naming no lane stand first, in a lane\nof their own; where the app writes the link, each block moves to another lane from its menu.\nInside a folder (`scope`), the lanes are the ones whose own one-link names that folder \u2014 a\nbranch\'s rooms, never every branch\'s. A span\'s end holds its day unless `records` names it\nthe day the row `frees`.\n\n`loads` names what a lane carries: `{ "weight": "payload", "volume": "box" }` sums each\nblock\'s number and reads it against the lane row\'s own, at most two. A lane holds its\nblocks while they stand, so it reads the most they add up to at one time in the window \u2014\na day\'s rows together \u2014 named, past its bound, by how much and on which day or at which\nhour. The two are in one unit, or two of one dimension (kg against t); a block then reads\nwhat it adds, and the move menu reads each lane as it would stand with the block on it.\nA bound a single row must keep (no parcel heavier than its van) is a `write_rules` `max`\nthrough the link, which refuses the move.\n\n<!-- generated:start apps-lanes -->\n\n#### Lanes keys\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `lanes` | alias | no | With `layout: "lanes"`: a one-link of this entity whose target\'s rows are the lanes (a chair, a machine, a room), each drawn even when empty. A row is a block from the first date on its line to the second \u2014 within one day by the hour where the first holds one, else by the day over one day, a week or a month; a free stretch between blocks adds a row there, its lane, its start and the end the stretch reaches filled |\n| `loads` | map of alias \u2192 alias | no | With `lanes`: what a lane carries against what it holds, at most 2 \u2014 a number of this entity each block adds (a weight) to a number of the lane\'s row it is held within (a payload), in one unit or two of one dimension. Each lane reads the most its blocks add up to at one time in the window \u2014 a day\'s rows together \u2014 and names by how much and when a lane runs over |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `register.lanes` | `layout: "lanes"` and `lanes` go together: `lanes` is a one-row link to an entity with a `records` entry, the rows name a date on their line, a block\'s two ends are read alike (two days or two moments), and `loads` needs `lanes`. |\n| `register.loads` | `loads` names one to 2 numbers a block adds \u2014 never a percent \u2014 each against a number of the lane\'s row, in one unit or two of one dimension. |\n\n<!-- generated:end apps-lanes -->\n\n### Gantt\n\n`layout: "gantt"` with `gantt` draws each register row as one bar on one axis of time:\n`{ "start": "etd", "end": "eta", "milestones": ["cut_off"], "planned": { "end": "booked_eta" },\n"progress": "done", "after": "waits_on" }`. `end` defaults to the entity\'s first `due`, and an\nentity with neither is refused; `start` and `end` are two dates of the row, both days or both\nmoments, and each planned date is read as `start` is. `progress` is a percent (0\u2013100) \u2014 absent, a\nrow whose record lists its tasks fills to how many are done;\n`after` is a link to rows of the same entity, one or several, each ending before the row\nstarts. The bars stand in the lanes of the register\'s `group`. Where the app writes the\nrow and a person writes a bar\'s date, the bar is dragged through the row\'s save, which then\nwrites those two dates though no section places them; a computed date, one an act sets, or\nan app with `writes: "children"` drags nothing.\n\n<!-- generated:start apps-gantt -->\n\n#### Gantt keys\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `gantt` | [Gantt bar](#gantt-bar) | no | With `layout: "gantt"`: the dates and facts each row\'s bar is drawn from |\n\n#### Gantt bar\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `start` | alias | yes | A date of this entity each row\'s bar starts at (a sailing, a hire\'s start, a task\'s start) |\n| `end` | alias | no | The date each row\'s bar ends at, read as `start` is \u2014 two days or two moments; absent, the entity\'s first `due` |\n| `milestones` | list of alias (at least one) | no | Dates of the row marked on its bar\'s line as diamonds, each named by its label (a cut-off, a delivery, the end of free time) \u2014 never `start` or `end` |\n| `planned` | [Gantt plan](#gantt-plan) | no | The plan each row is read against, drawn as a thin bar under its own \u2014 each date read as `start` is; a missing one is the bar\'s own |\n| `progress` | alias | no | A percent of this entity (0\u2013100) filling each row\'s bar as far as the work is done; absent, how many of the row\'s tasks are done fills it where its record lists them, else the bar wears its status\'s tone |\n| `after` | alias | no | A link of this entity to its own rows each row waits on \u2014 it starts once they end (finish-to-start), an arrow from each; a row starting before one ends is drawn in the danger tone |\n\n#### Gantt plan\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `start` | alias | no | The date the row was planned to start at |\n| `end` | alias | no | The date the row was planned to end at (a booked arrival) |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `register.gantt` | `layout: "gantt"` and `gantt` go together: `start` and `end` (absent, the entity\'s first `due`) are two different dates of the row, both days or both moments; each milestone another date of it, each planned date read as `start` is, `progress` a percent and `after` a link to rows of the same entity. |\n\n<!-- generated:end apps-gantt -->\n\n### Plan\n\n`layout: "plan"` draws things that stand at a place \u2014 containers in a yard, pallets in a\nwarehouse \u2014 on a plan of the places. The places are the rows of an entity whose `records`\nstates a `plan_place` (a bay, an open area or a landmark, each at its spot on a sheet of the\nplan); `plan` names the one-link of the register\'s rows to a place and, for an item in a bay,\nthe row (`across`) and the tier (`up`) it stands in, counted from 1. A bay is drawn as its rows\nand tiers, an area with a count, a landmark as a labelled frame; the reader sees a plan, one\nbay enlarged, and the same yard in 3D. The register may read other tables as `books`: one plan\nof every table\'s items. Each item carries `__reach` \u2014 how many items stand in the way of taking\nit out (those above it where the place is `stacked`, and those in the rows between it and the side\n`reach_from` says the bay is taken from) \u2014 counted over every present row whatever the reader narrows by, so the list,\nits export and an agent\'s read all carry it; `<entity>_plan_load` counts the rows each place holds.\nA write that sets the place, row or tier is refused on the server unless it clears all three,\nor places the item at a free cell of a bay \u2014 resting on a present item where the place is\n`stacked`, a boolean of the place: racks, shelves, platforms and building floors state none and\nhold an item at any tier \u2014 or at an area. A plan opens on every row its `where` keeps, with no\nstatus chip narrowing it. `mark` names a single select and one of its options: a row holding it\nwears a dot on its box in the option\'s colour, and the legend names it by the option\'s label.\n\n```jsonc\n"records": { "bay": { "title": "code", "plan_place": { "kind": "kind", "x": "x", "y": "y", "across": "rows", "up": "tiers", "reach_from": "taken_from", "stacked": "is_stack" } } }\n"register": { "layout": "plan", "plan": { "at": "bay", "across": "row", "up": "tier" }, "filters": ["line"] }\n```\n\n<!-- generated:start apps-plan -->\n\n#### Plan keys\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `plan` | [Plan](#plan) | no | With `layout: "plan"`: the place each row stands at, and in a bay its row and tier |\n\n#### Plan\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `at` | alias | yes | A one-link of this entity to an entity whose `records` states a `plan_place`: where each row stands |\n| `across` | alias | yes | A number field: the row of a bay a row stands in, counted from 1; empty at an area |\n| `up` | alias | yes | A number field: the tier of a bay a row stands at, counted from 1 at the ground; empty at an area |\n| `fill` | alias | no | A single select the items are coloured by; absent, the first single select among the register\'s filters |\n| `mark` | [Plan mark](#plan-mark) | no | A row holding the option wears a dot on its box, in the option\'s own colour, and the legend names it by the option\'s label; in books, the select is matched by option alias |\n\n#### Plan mark\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field` | alias | yes | A single select of this entity |\n| `option` | alias | yes | An option alias of that select |\n\n#### Plan place\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `kind` | alias | yes | A single select, options aliased exactly `bay`, `area`, `landmark`: a bay holds rows and tiers, an area neither, a landmark nothing |\n| `sheet` | alias | no | A single select: the plan sheet it is on |\n| `x` | alias | yes | A number field: left edge, in cells |\n| `y` | alias | yes | A number field: top edge, in cells |\n| `width` | alias | no | A number field: an area\'s frame width, in cells |\n| `depth` | alias | no | A number field: an area\'s frame depth, in cells |\n| `across` | alias | yes | A number field: a bay\'s rows |\n| `up` | alias | yes | A number field: a bay\'s most tiers |\n| `reach_from` | alias | no | A single select, options aliased exactly `first`, `last`, `both`: the side boxes leave a bay from; a bay that names none has no reach and no arrow |\n| `stacked` | alias | no | A boolean field: true where items at this place rest on the one below (a stack), so a tier above the first needs a present item under it, shows floating without one, and an item\'s reach counts the items above it; false or empty, items sit at any tier and only the rows between a bay\'s reach side and the item are in the way |\n| `size` | [Plan place size](#plan-place-size) | no | The real size of ONE cell of the place, for 3D: three number fields stating one length `unit` alike. Absent, a cell is drawn as a unit cube |\n\n#### Plan place size\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `across` | alias | yes | A number field: the width of one cell across the rows |\n| `along` | alias | yes | A number field: the depth of one cell along the place |\n| `up` | alias | yes | A number field: the height of one cell, one level |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `register.plan` | `layout: "plan"` and `plan` go together: `at` is a one-row link to an entity whose `records` states a `plan_place`, `across` and `up` two different numbers of the row, `fill` a single select; a plan has no `tabs`, `group` or `attention`. A write that sets `at`, `across` or `up` is refused unless it clears all three, or places the row at a free cell of a bay (a row from 1 to the bay\'s `across`, a tier from 1 to its `up`, resting on a present item), or at an area with neither. |\n| `register.plan-mark` | A plan\'s `mark` names a single select of the row, in every book too, and an option of it by alias: a row holding that option wears a dot in the option\'s colour, which the legend names by its label. |\n\n<!-- generated:end apps-plan -->\n\n### Roster\n\n`layout: "roster"` draws the register\'s rows down the side and the days of a week or a\nmonth across; `roster` names the entity whose rows fill the days \u2014 each stands on one\nregister row by its single link to it, and on the first date of its line (a shift on a\nperson\'s day, a run on a vehicle\'s), on every day through the second date where its line\nholds one. A cell reads its row\'s status, else the first single select on its line (a\nshift\'s kind), several rows their count; a week\'s cells say their words and one more\nfact of the line, a month\'s keep their marks. A day holding none stays empty: nothing\nwas due, which is never an absence. A filled cell opens its row; an empty one adds a row\nthere, the register row and the day set, asking what any add of it asks \u2014 unless no\napp writes those rows (`writes: false`). With `expect` (a single select of those\nrows) the columns are its options in place of days \u2014 a checklist of papers \u2014 and `of`\n(this entity\'s multi-select) names the ones each row expects: a gap among them reads as\none and adds its row, the others stand blank, and each row reads what it holds of them,\n`2/3`. Over days, a roster reads the `cadence` its entity\'s `records` states for its\nrows (a site\'s diary page, Monday to Saturday from breaking ground to handover): a past\nday owed with none is marked missing in the danger tone and counted, today\'s is still\ndue and offered to add, each row reads the days it holds of those owed, and the days\nthe cadence lists none on are quiet. A roster states no `columns` and needs no\n`readings`: its legend counts each state in view.\n\n```jsonc\n"register": { "layout": "roster", "roster": "run", "filters": ["operator"] }\n"register": { "layout": "roster", "roster": "diary_page" }\n```\n\n<!-- generated:start apps-roster -->\n\n#### Roster keys\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `roster` | alias | no | With `layout: "roster"`: the entity whose rows fill the days \u2014 one single link to this entity, and a date on its row line (`records` title or subtitle). A cell reads its row\'s status, else the first single select on its line, several rows a mark each, the cell read by the one latest in that select\'s options; a row whose line holds a second date after the first fills every day to it; a day with none stays empty, never an absence \u2014 unless this entity\'s `records` `cadence` owes one of them there |\n| `expect` | alias | no | With `roster`: a single select of the roster\'s rows whose options are the columns in place of days \u2014 each cell the row holding that option, read by its status, an empty one added there (a checklist of papers per case); the roster then has no period |\n| `of` | alias | no | With `expect`: this entity\'s own multi-select holding the options each row expects \u2014 its other columns stand blank on that row, never added. Its options are among `expect`\'s |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `register.roster` | `layout: "roster"` and `roster` go together: the roster\'s entity has one single link to this one and a date on its line, a roster draws no `columns`, `expect` needs `roster` and `of` needs `expect`. |\n| `register.roster-expect` | A roster\'s `expect` is a single select of its rows, and `of` this entity\'s multi-select whose every option is one of `expect`\'s. |\n\n<!-- generated:end apps-roster -->\n\n## Tabs\n\nA register reporting a period \u2014 what stands at its end beside what came and went during it (the stock, the\nhires out, the tickets open) \u2014 reads its rows as `tabs` over one `period` the reader picks above them: an\n`open` tab holds the rows open at the period\'s end, an `in` tab the rows dated within it, each with its count\nand each a sheet of the report. Never date chips set by hand, and never a tab per status, which the chips split.\n\n```jsonc\n"register": { "period": "month", "tabs": [\n  { "tab": "in_yard", "label": "In the yard", "open": { "from": "arrived_on", "to": "left_on" } },\n  { "tab": "arrived", "label": "Arrived", "in": "arrived_on" },\n  { "tab": "left", "label": "Left", "in": "left_on" }\n] }\n```\n\n<!-- generated:start apps-tabs -->\n\n#### Tabs keys\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `tabs` | list of [Register tab](#register-tab) (2\u20135) | no | The lists the register reads its rows as, each a tab with its count over one period the reader picks above them \u2014 the stock at its end beside the arrivals and departures during it, a report\'s sheets; each keeps the register\'s filters and search. Absent, one list. Not with a calendar, roster or lanes, which read their own window |\n| `period` | `"today"` \\| `"week"` \\| `"month"` \\| `"quarter"` \\| `"year"` \\| [Period days](#period-days) | no | With `tabs`: the period they open on \u2014 `today`, `week`, `month`, `quarter` or `year` so far, or `{ days }`, the last that many days through now (a night shift running past midnight reads two); absent, this month so far |\n\n#### Register tab\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `tab` | alias | yes | The tab\'s name: its address, and the key its rows stand under in a report |\n| `label` | text | yes | What the tab holds, in the reader\'s words |\n| `in` | alias | no | A date (stored, or a formula): the tab holds the rows dated within the register\'s period, from its start through its last day, or up to its last minute \u2014 the arrivals of a period |\n| `open` | [Tab open](#tab-open) | no | The tab holds the rows open at the period\'s end: begun before it, and not ended by then \u2014 what is in stock, out on hire or still owed at that moment |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no is this value, or whose member field holds the reader (`"me"`) \u2014 every entry ANDed |\n| `sort` | [Sort key](#sort-key) \\| list of [Sort key](#sort-key) (at least one) | no | The order this tab\'s rows read in, as the register\'s `sort`; absent, the register\'s |\n\n#### Tab open\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `from` | alias | yes | The date a row begins on (stored, or a formula) |\n| `to` | alias | yes | The date a row ends on (stored, or a formula), empty while it is open |\n\n#### Period days\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `days` | integer | yes | How many days through today, at most 366 |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `register.tabs` | A register\'s `tabs` each name a tab of their own, never a key a report already holds; a tab\'s `in` and `open` dates are dates of its rows, `open`\'s two different; its `where` and `sort` hold as the register\'s do, and never narrow by the status, which its chips split. Only a table or cards reads tabs, and a band reading\'s `tab` names one of them. |\n\n<!-- generated:end apps-tabs -->\n\n## Export\n\n`export` saves the register as its report \u2014 the title, a line per chip, the search and\nthe moment it was exported, the readings, and every row in view, at most 20,000 of them.\n`export: true` saves it as a workbook, the readings on a sheet before the rows. A list\nstates the reports the business sends \u2014 one a button, several one menu \u2014 each a `label`,\na `description`, and a `template` filled with `title`, `lines`, `readings`, `at` (the\nmoment it was made), `dates` (each date filter\'s `from` and `to` by field, a day or a\nmoment as the filter bounds the rows) and the rows under the entity\'s alias (an html one\nmade a PDF, an `excel` one a workbook; absent, the workbook). A report\'s `filename` names\nits file in the template grammar over the same keys but the rows \u2014\n`"Stock {{dates.arrived.to | format:\\"dd.MM.yyyy\\"}}"`; absent, the template\'s name, or\nthe label. A report of some rows (`where`), or of one value the reader picks (`per`: one\nline\'s file), first narrows the register as its chips \u2014 over the reader\'s own narrowing, the\nchips an earlier report set taken back \u2014 so the screen shows what the file holds.\n\n<!-- generated:start apps-export -->\n\n#### Export keys\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `export` | `true` \\| list of [Register report](#register-report) (at least one) | no | The rows in view saved as the register\'s report \u2014 its title, a line per thing narrowing the rows, the readings and every row: `true`, one workbook of the register\'s columns; a list, the reports a reader picks from one export menu |\n\n#### Register report\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `label` | text | yes | The report\'s name, in the reader\'s words \u2014 its entry in the export menu and its file\'s title |\n| `description` | text | no | What the report holds, under its name in the menu |\n| `template` | alias | no | A template filled with the report \u2014 `title`, `lines`, `readings`, `at` (when it was made), `dates` (each date filter\'s `from` and `to`, by field), `period` (the tabs\' `from` and `to`), `per` (the value picked), every row in view (at most 20,000) under the entity\'s alias, and each tab\'s under its name: an html one made a PDF, an excel one a workbook; absent, the workbook of the register\'s columns, a sheet per tab |\n| `filename` | text | no | The file\'s name, in the template grammar over one value each \u2014 `title`, `at`, `dates.<field>.from` or `.to` of a date filter, `period.from` or `.to` with tabs, `per` with a `per`, `lines \\| lookup:<n>` \u2014 `Stock {{per}} {{period.to \\| format:"dd.MM.yyyy"}}`; absent, the template\'s name, or the report\'s title |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | The rows the report is of, set on the register as the chips they are before its file is made \u2014 the screen shows what the file holds |\n| `per` | alias | no | A select, a member or a one-link the reader picks one value of from the menu \u2014 the rows narrowed to it, as its chip, and one file of that value |\n| `books` | list of alias (at least one) | no | The rows of these books only \u2014 each the app\'s `entity` or one of its `books`; absent, every book\'s |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `register.export-report` | A register\'s reports each have their own label; `per` picks one option, person or one-link row \u2014 never of the status, the folder or a field its `where` fixes. |\n| `register.export-template` | A template an export fills reads at its root only `title`, `lines`, `readings`, `at`, `dates` and its rows under the register entity\'s alias \u2014 an entity named none of those \u2014 and is the document of no act. |\n\n<!-- generated:end apps-export -->\n\n## Readings\n\nA reading is one number, or one picture of numbers, over rows. Where it stands decides\nwhich rows: a dashboard reads every row, a register\'s `readings` the rows in view, a\nrecord\'s reading block the child rows under the record. The picture is the runtime\'s,\nchosen from what the reading means \u2014 no key picks a chart.\n\n```jsonc\n{ "metric": "visit", "value": "fees", "where": { "paid": false }, "over": "arrived_on", "label": "Unpaid" }\n{ "metric": "payment", "value": "days_to_pay", "average": true, "over": "paid_on", "better": "down", "label": "Average days to pay" }\n{ "metric": "payment", "value": "late_share", "average": true, "label": "Share paid late" }\n{ "breakdown": "visit", "by": "line" }\n{ "trend": "visit", "over": "arrived_on", "value": "fees" }\n{ "pivot": "visit", "rows": "size", "columns": "line" }\n{ "breakdown": "invoice", "by": { "field": "days_late", "tiers": [1, 31, 61] }, "value": "owed" }\n{ "pivot": "invoice", "rows": "supplier", "columns": { "field": "days_late", "tiers": [1, 31, 61] }, "value": "owed" }\n{ "list": "visit", "where": { "stage": ["in_yard"] }, "columns": ["line"], "app": "gate", "label": "In the yard" }\n{ "list": "task", "where": { "assignee": "me" }, "label": "My tasks" }\n{ "progress": "work_item", "planned": { "start": "plan_start", "end": "plan_end" }, "done": "complete",\n  "finished": "accepted_on", "measured": { "rows": "logged_qty", "on": "day", "share": "share_of_item" },\n  "weight": "value", "label": "Progress against plan" }\n```\n\nA reading\'s `alias` names the query it is read by (`model/queries`).\n\nA reading\'s `where` keeps rows by a select\'s options, a yes/no\'s value, or `"me"` on a\nmember field \u2014 the rows that name whoever reads, read so on the server.\n\nA metric averaging its `value` (`average: true`) and a split by a number\'s `tiers` are\n`model/averages-and-bands`.\n\n`progress` reads one parent\'s work against its plan \u2014 a register\'s band over a folder, or a record\'s\nblock \u2014 never a dashboard\'s every row: the share of the work planned and the share done, cumulative day by\nday, today\'s two at its foot. Each row is a part of the work, its plan spread evenly over its planned days\nand weighing its `weight` (its value) or, absent, its planned days. Its share done today is `done`, a\npercent the server computes; on an earlier day, its `done` from its `finished` day on, before it what its\n`measured` rows add up to by then \u2014 each row\'s own share of it, a percent the server computes.\n\n<!-- generated:start apps-readings -->\n\n#### Metric\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `metric` | alias | yes | The entity whose rows are counted, or summed, into one number |\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `average` | `true` | no | The `value` is averaged, not summed: its sum over the rows holding one, divided by how many hold one \u2014 a row holding none is no part of it. Under a period each period reads its own average, and its change compares two averages; where no row holds one it reads no figure, never 0, and no change. A share is an average too: a number formula that is 100 on the rows that count and 0 on the others, in percent notation, reads as the share of rows that count |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `over` | alias | no | The date that places a row in time \u2014 its own (stored, or a formula), or its parent\'s through a lookup over a one-link: a dashboard\'s period windows the rows by it (a reading without one reads the rows as they stand now), and a metric reads its recent periods beside the number |\n| `target` | number | no | The number it is read against, where no `limits` bounds its value (a bounded value is read against the sum of its bound) |\n| `better` | `"up"` \\| `"down"` | no | Which way its change over the recent periods `over` reads is good; absent, a sum\'s rise and a count kept by `where` falling |\n| `label` | text | yes | What the reading is, in the reader\'s words |\n\n#### Breakdown\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `breakdown` | alias | yes | The entity whose rows are split into parts |\n| `by` | alias \\| [Tiered filter](#tiered-filter) | yes | The single select, one link, member or yes/no (stored, a formula, or a lookup of one through one-row links) each row is counted under \u2014 or `{ "field", "tiers" }`, a number in the bands its tiers cut (days late: not due, 1\u201330, 31\u201360, over 60), every band drawn in its own order and a row holding no number apart |\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `over` | alias | no | The date that places a row in time \u2014 its own (stored, or a formula), or its parent\'s through a lookup over a one-link: a dashboard\'s period windows the rows by it (a reading without one reads the rows as they stand now), and a metric reads its recent periods beside the number |\n| `label` | text | no | What the reading is, in the reader\'s words; absent, the `by` field\'s label |\n\n#### Trend\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `trend` | alias | yes | The entity whose rows are counted, or summed, per period |\n| `over` | alias | yes | The date each row falls on \u2014 its own (stored, or a formula), or its parent\'s through a lookup over a one-link |\n| `ahead` | `true` | no | Counts forward: the current period first, then the ones after it, over the rows dated today or later (arrivals by their ETA); absent, the periods up to today |\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `label` | text | no | What the reading is, in the reader\'s words; absent, the value\'s label, else the entity\'s |\n\n#### Pivot\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `pivot` | alias | yes | The entity whose rows are counted, or summed, in a grid |\n| `rows` | alias \\| [Tiered filter](#tiered-filter) | yes | The single select, one link, member or yes/no (stored, a formula, or a lookup of one through one-row links) down the side \u2014 or `{ "field", "tiers" }`, a number in the bands its tiers cut (days late: not due, 1\u201330, 31\u201360, over 60), every band drawn in its own order and a row holding no number apart |\n| `columns` | alias \\| [Tiered filter](#tiered-filter) | yes | The single select, one link, member or yes/no (stored, a formula, or a lookup of one through one-row links) across the top \u2014 or `{ "field", "tiers" }`, a number in the bands its tiers cut (days late: not due, 1\u201330, 31\u201360, over 60), every band drawn in its own order and a row holding no number apart |\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `over` | alias | no | The date that places a row in time \u2014 its own (stored, or a formula), or its parent\'s through a lookup over a one-link: a dashboard\'s period windows the rows by it (a reading without one reads the rows as they stand now), and a metric reads its recent periods beside the number |\n| `label` | text | no | What the reading is, in the reader\'s words; absent, the two fields\' labels |\n\n#### Progress\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `progress` | alias | yes | The entity whose rows are the parts of the work, read as the share of it planned and the share done, day by day |\n| `planned` | [Progress planned](#progress-planned) | yes | The days each row\'s work is planned over, its share planned spread evenly across them \u2014 a row missing either is no part of the plan, and neither line counts it |\n| `done` | alias | yes | A number of the row the server computes: its share done today, in percent (0\u2013100) |\n| `finished` | alias | no | A date of the row: the day its work was finished, from which it stands at its `done` |\n| `measured` | [Progress measured](#progress-measured) | no | Before a row is finished, its share done on a day is what these add up to by then, never past its `done`; absent, a row stands at nothing until it is finished, and at its `done` today |\n| `weight` | alias | no | A number of the row: what it weighs in the whole \u2014 its value, its share of the contract; a row holding none weighs nothing. Absent, each row weighs its planned days |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `label` | text | yes | What the reading is, in the reader\'s words |\n\n#### Progress planned\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `start` | alias | yes | A date of the row: the first day of its planned work |\n| `end` | alias | yes | A date of the row: the last day of its planned work |\n\n#### Progress measured\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `rows` | alias | yes | The entity whose rows record the work as it is done, each through its one-row link to a row of the reading |\n| `on` | alias | yes | A date of those rows (their own, or a lookup): the day each records its work |\n| `share` | alias | yes | A number of those rows the server computes: the share of its row each adds, in percent |\n\n#### List\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `list` | alias | yes | The entity whose rows are listed, each in its `records` anatomy |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `columns` | list of alias | no | Fields read after each row\'s title |\n| `app` | alias | no | An app of this model over the same entity that works its rows: a dashboard row opens there, a record\'s list row has "Open in" to it |\n| `label` | text | yes | What the reading is, in the reader\'s words |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n\n<!-- generated:end apps-readings -->\n\n<!-- generated:start rules-reading -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `reading.value` | A reading sums a number, never a percent \u2014 percents do not add up; a metric\'s `average` reads one. |\n| `reading.average` | `average` averages a metric\'s `value` over the rows holding one, read against a plain `target` \u2014 never a value `limits` bounds, whose bound is a sum. |\n| `reading.split` | `by`, `rows` and `columns` split by one value each row holds \u2014 a single select, a one-row link, one member or a yes/no, stored or a formula, a lookup through one-row links as the field it reads \u2014 or by the bands `tiers` cut a number read in one unit on every row; a pivot crosses two different fields. |\n| `reading.over` | `over` is a date: the row\'s own, stored or a formula, or its parent\'s through a lookup over a one-row link. |\n| `reading.where` | A reading\'s `where` keeps rows by a select\'s options, a yes/no\'s `true` or `false`, or a member field holding the reader (`"me"`). |\n| `reading.target` | `target` reads a value nothing bounds \u2014 a value `limits` bounds reads against the sum of its bound. |\n| `reading.better` | `better` needs `over`: a change is read over the periods its date places the rows in. |\n| `reading.list-app` | A list\'s `app` is a register app of this model over the list\'s own entity. |\n| `reading.progress` | The work against its plan reads dates of its rows for `planned` and `finished`, a number for `done` and `weight`, and rows `measured` through a one-row link to them, by a date of theirs and a number of theirs. |\n\n<!-- generated:end rules-reading -->\n\nA reading counts its rows, or sums the number `value` names \u2014 never a percent. `by`,\n`rows` and `columns` split the rows by one value each: a single select, a one-row link,\none member, or a yes/no \u2014 stored or a formula, its parts read as its label and the\nothers. `over` is a date, the row\'s own (stored or a formula) or its parent\'s through a\nlookup over a one-link: a trend\'s periods, a metric\'s recent periods beside its number,\nand what a dashboard\'s period windows. `ahead: true` reads a trend forward from the\ncurrent period over the rows still to come. `where` keeps rows whose select holds one\nof the options, or whose yes/no is the value, every entry ANDed \u2014 a band leads with the\njob\'s exception as a formula\'s yes/no (what is late, what is short; drawn by the fields it reads), never a stage the\nstatus chips already count. A metric summing a value `limits` bounds reads against the\nsum of its bound (`10 / 14`); `target` reads one against a number nothing bounds. A\nmetric\'s change is green where it moves the good way: a sum\'s rise, a count kept by\n`where` falling; `better` states the other way where that reads wrong \u2014 money going out\n(`"better": "down"`). A register reads only its own entity; a `list` stands on a\ndashboard, or in a record\'s `blocks` (\xA7 List block).\n\n`readings` read the register\'s own rows above them: the rows in view, so the search,\nthe status and the filters narrow each one, but a picture\'s own field, which it reads as\nthe register opens on it. A table, cards or a gantt over rows that move or carry money states\nthem (`register.headline`); elsewhere they stand where a picture answers something the rows\ncannot. They stand under the title in one compact\nband: lead with the job\'s headline number (a `metric`), then at most the mix (a\n`breakdown`) and the movement (a `trend`) \u2014 a `pivot` stands under the band as a whole table, every line and its totals, and a\n`breakdown` by a number\'s `tiers` of three breakpoints or more under it too, every band a bar. A picture\nstands only where it splits the rows in view into two parts or more, one of them\nholding two rows or more; a split whose rows\nall fall in one part, and a lone figure with no picture beside it, are said on the\nsummary line instead, so a band stands only holding a picture or two figures. The summary line already totals the\nfigure over the rows in view and the status chips count them, so a `metric` summing the\nfigure, or counting the rows of an entity with a status, is refused unless its `where`\nnarrows it.\n\n## Averages and bands\n\nWhat a [reading](#readings) averages, and how it splits its rows by a number.\n\nA metric\'s `value` is summed; with `average: true` it is averaged \u2014 its sum over the rows the reading\nkeeps, divided by how many of them hold a value, so a row holding none is no part of it. It reads in the\nvalue field\'s own notation, and a figure each row reads in its own unit averages per unit as it sums per\nunit. Under a dashboard\'s period it is the average over the period so far, its shape each recent period\'s\nown average, and its change this period\'s average against the one before\'s \u2014 never a sum of averages.\nWhere no row holds a value there is nothing to average: it reads a dash, never 0, with no change against\nthe period before, and a period holding no row is no point of its shape. A\nplain `target` is the number it is read against; a value `limits` bounds is refused, since its bound is a\nsum.\n\nA share is an average too, so it takes no key of its own: a number formula that is `100` on the rows\nthat count and `0` on the others (`if({paid_on} > {due_on}, 100, 0)`), in percent notation, averaged, is\nthe share of rows that count \u2014 "share paid late". A percent is averaged, never summed. Only a `metric`\naverages: a `breakdown`, a `trend` and a `pivot` count their rows or sum `value`.\n\nA breakdown\'s `by` and a pivot\'s `rows` and `columns` each take, in place of a field, a number by its\n`tiers` \u2014 `{ "field", "tiers" }`, the shape a register\'s [tiered filter](#tiered-filter) takes \u2014 and\nsplit the rows by the bands those breakpoints cut: under the first, from each up to the next, from the\nlast up, a figure on a breakpoint in the band above it. `[1, 31, 61]` over days late reads not due,\n1\u201330, 31\u201360 and over 60 \u2014 the aged report, parties down the side and the bands across. Every band is\ndrawn in the bands\' own order, one holding no row at zero, never ranked by size; each is worded in the\nfield\'s own notation, as the filter\'s chip words it, and rows holding no number stand apart. A band of a\nfigure whose definition makes every value whole \u2014 a rollup that counts, a formula that is\n`differenceInCalendarDays(later, earlier)` \u2014 cut at whole breakpoints reads to the last one it holds, so\nno figure stands in two bands\' words; every other figure, a stored number of days or of a counted noun\ntoo, reads between its breakpoints, since it may hold 14.5. The number is stored, a formula or a rollup, or a lookup of one through\none-row links, read in one unit on every row. On a register a band is a door: a press\nnarrows the rows to it through the filter of the same field and tiers, which the register\'s `filters`\nstate too \u2014 the rows holding no number are no band, so no door; on a dashboard and in a record\'s block\nit opens nothing. A register\'s band seats four bars:\na split by one or two breakpoints stands in it, and one by three or more stands whole under it, as a\npivot does, so every band keeps its bar and its name.\n\n## Dashboards\n\nA dashboard is `{ "alias", "name", "dashboard": [readings] }` with no entity, register\nor record: each reading reads every row of its entity, and one period the reader picks\nat the title \u2014 this month, last month, this or last quarter or year, or any days \u2014 windows\neach reading placed in time: one still running so far, one that closed whole, its change\nread against the period before it. A reading placed in no time reads the rows as they\nstand now, and its head says so. `period` is the one it opens on; absent, the month. A\ntrend holding few periods so far is led in by the ones just before it, so no period opens\non one bar.\n`tabs` (2 to 5, each `{ "tab", "label" }`) split a long dashboard into sheets: every\nreading then states the `tab` it stands under, a strip under the title picks one (the first\nopen), and only its readings are drawn. A reading is called by the same name with or without\ntabs. A `list` reading lists rows, each opening in its `app`. The readings answer the one\nquestion the dashboard\'s owner asks, in the order they ask it \u2014 rows to act on lead where\nthe answer is rows; no order of kinds is the rule.\n\n```jsonc\n// The depot owner\'s morning question: which boxes are past their free days, whose are they, is it growing?\n{ "alias": "overview", "name": "Depot overview", "dashboard": [\n  { "list": "visit", "where": { "overdue": true }, "columns": ["line"], "app": "gate", "label": "Past free days" },\n  { "breakdown": "visit", "by": "line", "where": { "overdue": true }, "label": "Past free days by line" },\n  { "trend": "visit", "over": "arrived_on", "where": { "overdue": true }, "label": "Past free days, by arrival" }\n] }\n```\n\n<!-- generated:start apps-dashboard -->\n\n#### Dashboard app\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | yes | The app\'s name within the model \u2014 what `--from model.json#<alias>` picks |\n| `name` | text | yes | The job, in the words of the people who do it |\n| `description` | text | no | What the job is for, in a sentence |\n| `icon` | text | no | A lucide icon name the launcher tile draws |\n| `theme` | [Theme](#theme) | no | The launcher tile\'s colour |\n| `reads` | `"shared"` | no | Every member reads every row, whatever the entity\'s read scope |\n| `dashboard` | list of ([Metric](#metric) \\| [Breakdown](#breakdown) \\| [Trend](#trend) \\| [Pivot](#pivot) \\| [List](#list)) (at least one) | yes | The readings, in order \u2014 each over every row of its entity, windowed by the one period the reader picks |\n| `tabs` | list of [Dashboard tab](#dashboard-tab) (2\u20135) | no | The sheets the readings stand on, a strip under the title, the first open: each reading of `dashboard` then states the `tab` it stands under, and only the open tab\'s readings are drawn and read. Absent, every reading stands in one grid |\n| `period` | `"month"` \\| `"quarter"` \\| `"year"` \\| [Dashboard period days](#dashboard-period-days) | no | The period the dashboard opens on, before the reader picks another \u2014 `month`, `quarter` or `year` so far, or `{ days: 30 }`, the last 30 days through today; absent, this month so far. Needs a reading placed in time by `over` |\n| `workflows` | map of alias \u2192 [Workflow](#workflow) | no | Workflows of the app no act runs, by alias \u2014 called through the app (`run_app_workflow`, its API) by an agent or a service: each states what it takes and hands back, and its body is set on the app (`set_app_workflow`) and kept by every apply. The screen draws nothing for one |\n| `queries` | map of alias \u2192 [Query](#query) | no | Reads of the app no screen draws, by alias \u2014 called through the app (`run_app_query`, its API) by an agent or a service: each states the rows it reads, what narrows them and what a call may state. The screen draws nothing for one |\n\n#### Dashboard tab\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `tab` | alias | yes | The tab\'s name: its address (`?tab=`), and what each reading\'s `tab` names |\n| `label` | text | yes | What the tab holds, in the reader\'s words |\n\n#### Dashboard period days\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `days` | `30` | yes | The last 30 days through today \u2014 the one span of days a dashboard opens on |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `reading.period` | A dashboard\'s `period` is the one it opens on, and its period stands only over a reading placed in time by `over`. |\n| `reading.tabs` | A dashboard\'s `tabs` each name a tab of their own, and every reading of its `dashboard` states the `tab` it stands under: a tab no reading names, a reading naming a tab not declared, or one naming none is refused; without `tabs`, no reading states a `tab`. |\n\n<!-- generated:end apps-dashboard -->\n\n## Record page\n\n```jsonc\n"record": {\n  "door": "page",\n  "sections": [\n    { "title": "Details", "fields": ["size", "line", "built_on"] },\n    { "title": "Gate in", "at": ["arriving", "in_yard"], "fields": ["arrived_on", "truck"],\n      "blocks": [{ "rows": "fee", "where": { "leg": ["in"] }, "expect": "kind", "columns": ["amount", "paid_by"] }],\n      "acts": ["gate_in_paper"] },\n    { "title": "Sell to a buyer", "description": "Moves the container to the buyer\'s stock once it has left.", "acts": ["sell"] }\n  ]\n}\n```\n\n<!-- generated:start apps-record -->\n\n#### Record page\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `door` | `"page"` \\| `"drawer"` \\| `"beside"` | no | A page for work read at length; a drawer for rows worked one after another from the register; `beside` for rows worked one after another while the list stays in view \u2014 the register\'s list and the open record side by side, over a table register alone. Each stacks its sections, and from three sections on navigates them \u2014 a page by a rail, a drawer by a strip pinned over its scroll; absent, a page where a section has `at` or is a `page`, the record has more than three sections or one stands beside the rest (`side`), else a drawer |\n| `sections` | list of [Section](#section) (at least one) | no | The record in the order its work reaches it \u2014 each section its fields, then its blocks, then its acts. Absent, one section of every field a person writes that no other place shows |\n| `comments` | `true` | no | People comment on the record: its comments \u2014 who wrote what and when, with a composer \u2014 stand in its Activity, opened from its head; stated only where the job\'s people discuss a record or the owner asks for one. Absent, no one comments |\n| `history` | `true` | no | Draws nothing of its own: the record\'s Activity shows every move of the status as a change, when and who \u2014 refused beside `activity: false`, which shows the moves nowhere; noted beside Activity, and refused there in a later release. The entity\'s `status.history` is written either way |\n| `activity` | `false` | no | false: the app\'s records show no activity \u2014 the door in each record\'s head and the panel of its saves and comments beside it; where `comments` is stated, the door opens the comments alone. Absent, every record shows it |\n| `compose` | [piece](#composed-page) | no | The record\'s page stated as a tree of finished pieces instead of `sections`, on a page door \u2014 for a page that is its own arrangement of what the app already states: each node names a piece of the catalog (`use`) and binds by name to a field of the entity, an act of the app or a child entity; it holds no condition and no computed value |\n\n#### Section\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `title` | text | yes | What the section is, in the reader\'s words \u2014 its heading, and its name on the record\'s rail or tab |\n| `description` | text | no | One sentence under the title: what the section is for, or what its act does |\n| `at` | list of alias (at least one) | no | Options of the record\'s status (or its milestones) during which this section is the work now \u2014 a step of the path the record moves through: its rail item reads now while the status holds one and this app has work there, done once the record\'s history says it went through one \u2014 or it is a step of the path before where that history opens (with none, where the record stands) that no act moves the work past \u2014 and it stands before the section that is the work now, and waiting otherwise; a section every option of which ends the work, past the path\'s end or entered by its own act, is an exit: no item and nothing drawn until the record stands in it, then set apart after the steps and never one; A page opened from the register opens at it. It never locks what the section holds: its fields are written as the write rules and checks allow at any stage. An act it names is offered during these alone: its `when` holds the status to them, or on milestones it stamps the step after one of them \u2014 a detour and an exit are sections of their own, a detour stated before the step it returns to |\n| `fields` | list of alias (at least one) | no | The record\'s own fields in this section, in the order they are read \u2014 never one the header draws: the row\'s title, subtitle, image, status or figure |\n| `blocks` | list of [block](#blocks) (at least one) | no | What the section holds besides its own fields, under them, in order |\n| `acts` | list of alias (at least one) | no | Acts of this app drawn under the section\'s fields, their asks as more of them and what each lacks said above its button; the header draws no act, so every act of the record itself is named by one section \u2014 an act of a child (`of`) stands on the child\'s row and is never named here. An act moving the status, offered at ONE step (the stage its `when` holds), stands at that step\'s foot when it moves the work forward \u2014 to a later option, an exit too \u2014 or back to a step the work passes anyway; one offered at several steps, or moving back into a detour, stands in the section it enters, which draws it while the work waits \u2014 an exit\'s in the header\'s \u22EF, since an exit stands only once the record is in it. A correction \u2014 `danger` and not one of its step\'s outcomes (no other status move offered at the same moment) \u2014 waits in the section heading\'s \u22EF, and one no section names in the header\'s \u22EF; every other act is named by a section |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n| `side` | `true` | no | The section the rest are worked from, drawn in a pane beside them rather than in their scroll \u2014 the photos looked at, the pool picked from, the paper typed off; at most one on a record, which opens on a page door. It holds what any section holds |\n| `page` | `true` | no | A page of its own, off the record\'s scroll: its own heading and a way back, reached from the record\'s rail after the scroll\'s sections, or from a link at its place where the record has no rail \u2014 for what makes the record worse stacked in it: a long list of related rows, a workspace of its own. Only on a page door, never a step (`at`). Holding only one `text` block over a markdown field, it reads as a document: a 680px column, saved as it is written \u2014 whether it is saved said at its foot |\n\n<!-- generated:end apps-record -->\n\n<!-- generated:start rules-record -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `record.placed-once` | A field, a block and an act each stand once on a record: the header draws the title, subtitle, image, status (or milestones), figure and folder, and a field\'s one other place is a section\'s `fields`, a files, text or statement block \u2014 save the image, which one files block may draw again, whole, the figure, which a statement draws as what it comes to, and rows one list prices and another compares (`compare`); two places whose `when`s never hold together (a select at options the other\'s lacks) each draw it. |\n| `record.foot-total` | A rows block\'s foot totals the child\'s figure and each summed column over the rows it lists; the record\'s rollup summing that field over those rows (the same `where`) is that foot, never also one of a section\'s `fields`. |\n| `record.fact-restates` | A section\'s field never looks up what its link already reads where it stands: the linked row\'s title and line beside the link, the figure or bound its meter reads on the header\'s line. |\n| `record.section-holds` | A section holds fields, blocks or acts. |\n| `record.sections` | *Refused until adopted or declined:* A register laid out as a table, cards or a gantt states its record\'s `sections` \u2014 the patch holds the fields people write, a files block per paper, a block per child and the record\'s acts. |\n| `record.children` | *Refused until adopted or declined:* An entity some app records, whose rows other rows each belong to (a one-row link to it, never its status history), draws some of them under its row \u2014 a block on its record, a roster of them, lanes of them by that link, or an app over them working in one of its rows at a time (`scope`) \u2014 the patch lists each under the record. |\n| `record.at` | `at` names options of the record\'s stored status, or its milestones; a record with no status has no steps. |\n| `record.at-once` | A stage is the work of one section: two sections naming one option of the status, or one milestone, in `at` hold some field to values apart in their `when` \u2014 a `when` holding the status keeps its section off the options it leaves out. |\n| `record.section-page` | A section is a `page` only on a page door \u2014 never a drawer\'s or one beside the list \u2014 and never a step (`at`), its title naming an address no other page shares (a letter or a digit at least), and never every section. |\n| `record.side` | At most one section stands beside the rest (`side`), on a page door, and never also a page of its own. |\n| `record.beside` | A `door: "beside"` record opens beside a table register \u2014 never a board, cards or a calendar, which draw no list to stand beside. |\n| `record.history` | `record.history` names a status history the entity records (`status.history`), on a record whose Activity is on \u2014 its Activity shows each move, so beside `activity: false` the key draws nothing; no block reads that history. |\n| `record.history-activity` | *Noted, never refused:* `record.history: true` beside a record whose Activity is on: Activity shows every status move as a change already, so the key adds nothing \u2014 a later release refuses it. |\n| `record.section-acts` | A section\'s `acts` name acts of the record itself: an act of a child (`of`) stands on the child\'s row, and one over the register\'s rows (`on`) on the register. |\n| `record.act-in-section` | Every act of the record stands in the `acts` of the section whose work it is; only a correction no section owns \u2014 `danger`, and no other status move offered at the same moment \u2014 or an act an agent runs for the person (a `workflow` or an `intake` moving no status), left off every section, waits in the header\'s \u22EF. |\n| `record.move-home` | A status move offered at one step stands at that step\'s foot when it moves the work forward, to an exit, or back to a step it passes anyway; one offered at several steps, or moving back into a detour, stands in the section `at` the status it enters. |\n| `record.act-staged` | An act at a staged section\'s foot is offered only during that section\'s steps: its `when` holds the status to options the section names \u2014 on milestones, it stamps the step after one of them. |\n| `record.act-hidden` | An act is never offered only while its section\'s `when` hides the section. |\n| `record.field-edit` | An act that only writes one field of its record, not the status, from the one input it asks is that field\'s edit: the field rests in the section\'s `fields` as a control. |\n\n<!-- generated:end rules-record -->\n\nThe record is its `sections`, stacked in the order the work reaches them. A section is\nits fields, the acts under them, then its blocks \u2014 the acts at its foot instead where one\nreads what a block holds or none of its fields \u2014 and holds at least one of them. From\nthree sections on, the record is navigated by their titles: a page by a rail that jumps\nto each (a strip of the same names on a phone), a drawer by the same strip pinned over its scroll;\nwith fewer, the sections just stack. `description` is one sentence under the title.\n`at` names the status options (or the milestones) during which the section is the work\nnow \u2014 only on a record that truly moves through those stages: the rail marks it done,\nnow or waiting (an item of no `at` is its title alone), and the section stands even holding\nnothing yet \u2014 it never hides a field, locks it or gates an act, and a record opens at its\nhead. `page: true` makes a section a page of its own under the\nrecord\'s, off its scroll, with a way back \u2014 rarely, for a long related list or a workspace\nof its own that would make the record worse stacked; never on a drawer or a step. The\nheader draws no act: every act on the record is named by the section whose work it is, and one no section names is refused, naming its likely\nsection \u2014 only a correction no section owns waits in the header\'s \u22EF beside Delete. An act\nmoving the status and offered at ONE step (its `when`) stands at that step\'s foot when it\nmoves the work forward \u2014 to the next step, or to an exit later in the status\'s options\n(Reject beside Approve) \u2014 or back to a step the work passes anyway. One offered at SEVERAL\nsteps, or moving back into a detour, is named by the section it enters: a detour draws it and its\ngaps alone while it waits. A detour \u2014 a stage the work only steps aside into from one step and\nleaves only back to it (a pause, a repair) \u2014 stands before that step, its option and its section\nalike; listed after, the work reads it as its next step, and the check notes it with the move\nlisting it before. A `danger` act is a correction \u2014 waiting in the \u22EF of what it acts\non: its section\'s heading, its row, the header\'s where no section names it \u2014 unless it moves\nthe status while another status move is offered at the same moment; then it is one of that\nstep\'s outcomes, a button. Cancel offered at Held and at Confirmed, beside Confirm, is an\noutcome into an exit: state `{ "title": "Cancelled", "at": ["cancelled"], "fields": ["reason"],\n"acts": ["cancel"] }`. An exit stands only once the record is in it, its reason there and its\nrail item apart from the path; until then Cancel waits in the header\'s \u22EF. Every record\nopens its activity from its head \u2014 each save field by field, each move among them, and each\ncomment, with one composer \u2014 unless `activity: false`. `comments: true` lets people comment\n\u2014 opt-in: state it only where the job\'s people discuss a record; with `activity: false` the\ndoor opens the comments alone, and with neither no door stands. An edit in the activity \u2014 never\nthe record\'s making or an undo \u2014 carries Undo for a member who may write the\nrecord: each field goes back where the record still holds what the edit wrote, the rest named\nwith why. Unless `activity: false`, the app has two workflows nobody authors, for its\norganization\'s members: `record_activity` (`record_id`, `after?`) hands back `entries` \u2014 each with\n`undoable` and `undone` \u2014 and `next?`; `record_activity_undo` (`record_id`, `entry_id`) hands back\n`reverted` and `kept`. No other workflow of the app takes either alias. `history: true` draws\nnothing of its own \u2014 each move is already in the activity: noted, refused beside\n`activity: false` (the moves would show nowhere), and refused everywhere in a later release.\n\nA field, a block and an act is each placed ONCE on a record \u2014 the header, one section;\na second place is refused. The header draws the entity\'s `records` title, subtitle,\nimage, status (or milestones) and figure, so none of them is named again in a section\'s\n`fields` or the register\'s `columns` \u2014 save the image, which one `files` block may draw\nagain, whole at reading size (an incident\'s photo, a scan), the header keeping its mark. Refused too: a section holding nothing, an `at`\non a record with no status, and a section\'s act that is a child\'s or runs over the\nregister\'s rows.\nA table, cards or a gantt states its record\'s `sections` (`record.sections`); absent them \u2014 a register laid\nout in time, or one declining the rule \u2014 one section holds every field a person writes that the header does\nnot show. An editable field rests as its control and saves as it changes; everything\nelse is plain text. A section or a block with `when` is shown only while each named\nselect of the record holds one of its options. The one layout serves every entity: a\ncustomer or a product is sections without `at`.\n\n## Blocks\n\n```jsonc\n"blocks": [\n  { "rows": "fee", "columns": ["kind", "amount"] },\n  { "rows": "fee", "where": { "leg": ["out"] }, "columns": ["kind", "amount"], "under": "invoice" },\n  { "rows": "cost", "via": "bill", "create": false, "remove": false, "pick": true },\n  { "files": ["photos", "papers"] },\n  { "text": "remarks", "when": { "stage": ["held"] } },\n  { "statement": [{ "field": "subtotal" }, { "field": "vat", "op": "plus" }, { "field": "total", "op": "equals" }] }\n]\n```\n\n<!-- generated:start apps-blocks -->\n\n#### Rows block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `rows` | alias | yes | A child entity whose rows belong to this record |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `title` | text | no | The block\'s heading; absent, the child entity\'s or the field\'s own label |\n| `columns` | list of alias | no | The child\'s fields read as columns after its title \u2014 never what its row draws (subtitle, image, status, figure, or the bound its figure\'s meter reads against), though an `expect` block\'s figure is a column, filled in place. |\n| `create` | list of alias (at least one) \\| `false` | no | The child\'s fields asked when a row is added here; absent, its title, its picture, the subtitle and figure no default fills, the block\'s columns, its natural key and every required field \u2014 each a person writes; false, rows are not added here |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Only the child rows whose single select holds one of these options, or whose yes/no (stored, or a formula) is this value \u2014 every entry ANDed, read so on the server; a row added here holds the selects\' (one leg\'s fees, of a record holding both legs\'). Each select is one the child requires, so no row stands in no block |\n| `expect` | alias | no | The child\'s title when the record holds one row per value of it \u2014 a single select (one per option, in order) or a one-row link to a catalog (one per row the link may point at): a value not yet filled reads as its own empty line, and no value holds two rows. The block\'s `columns` name at least one field a person fills in place, unless it states `post`, whose lines are ticked |\n| `of` | alias | no | With `expect` on a select: the record\'s own multi-select holding the options this record expects a line for \u2014 the options it holds, in order, rather than every option. Its options are among the title\'s |\n| `under` | alias | no | The child\'s one-link to a document that covers its rows (an invoice over its fee lines), whose many-link points back and which links to this record: each document stands as a heading over the lines it covers; a filled line no document covers says so on its own row with a make for one document over it, and two or more waiting take a combined make in the block\'s heading. Never also a rows block of the document |\n| `filters` | list of (alias \\| [Tiered filter](#tiered-filter)) (at most 3) | no | The child\'s fields the reader narrows the block\'s rows by, as a register\'s `filters` \u2014 none to 3, each a field its rows show (a column, or a part of the row) or a formula of fields they show, its status among them where the business narrows by it \u2014 never on a task list, whose status chips narrow it |\n| `search` | list of alias (at least one) | no | The child\'s fields the block\'s search box matches (a link by its row\'s title), a pasted list line by line; absent, the block has no search box |\n| `group` | alias | no | The child\'s field the block\'s rows open grouped by, as a register\'s `group` \u2014 the reader\'s grouping starting there; absent, ungrouped |\n| `sort` | [Sort key](#sort-key) \\| list of [Sort key](#sort-key) (at least one) | no | The order the block\'s rows open in, as a register\'s `sort` \u2014 within each group where the block groups them; absent, the child\'s first deadline soonest first, else the newest first |\n| `edits` | list of alias (1\u20132) | no | The child\'s fields each line holds as its control, written where the line stands (a quote line\'s sell price, the customer a line is matched to) \u2014 a number, a date, words, one option or a one-row link the row\'s save writes, each a column or the figure, at most 2; a link\'s control is its picker, offering the rows the field\'s own rules admit; every other value reads, and the row opens to write it |\n| `remove` | `false` | no | This list offers no Delete on its rows (its open row and \u22EF); they are deleted where another list of them or their own record offers it \u2014 e.g. lines that are a selection of rows kept elsewhere |\n| `pick` | `true` | no | The block also picks rows of the child that no record holds through `via` yet \u2014 those naming what this record names in each link `via`\'s `same` compares, and holding the block\'s `where` \u2014 and links them here; a row picked leaves the block from its \u22EF, unlinked and kept. `via` is an optional one-row link a person writes, and the record holds the many-link paired with it |\n| `checklist` | [Checklist](#checklist) | no | The child\'s rows, which are tasks, read as a checklist of checks: each one\'s mark \u2014 passed at a `closed` option, failed at a `failed` one, else still to check \u2014 its title, its columns as its words (a text column its note, on its own line), and on a line under its title its photo and its clause; never grouped nor written in place |\n| `compare` | [Compare](#compare) | no | This list reads each row\'s before against its after. Two files fields (a repair\'s damage and its repair, a check failed and redone): once the before holds a photo, the two stand side by side at one size, each row read in full as a card \u2014 on a checklist, whose `photo` is the before, the after beside it on its line \u2014 and an after not taken yet is the camera\'s tile adding it while the row\'s work is open; a list of the same rows without it stays a table. Two value fields of one type \u2014 text, a number, a date or a single select (a price before a sheet and after it): the list stays a table and the pair is one column under the after\'s label \u2014 the before struck, an arrow, the after \u2014 an empty before read as added and an empty after as removed; the after is its control where `edits` names it, and neither is also a column. Never with `expect` |\n| `post` | [Post](#post) | no | This list is a publish desk: with `expect` on a one-row link to a catalog of destinations, every destination the link admits is a line a person ticks \u2014 a tick makes its row from its key alone, an untick deletes it until its status is `closed` \u2014 and the line chosen reads beside the list as the post that destination\'s feed will show, with its words to copy, the block\'s `columns` as its facts and the row\'s acts. Never with `under`, `pick`, `checklist`, `compare` or a `create` list |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Checklist\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `photo` | alias | no | The child\'s files field holding the photo each row is checked by |\n| `clause` | alias | no | The child\'s one-row link to what each row is checked against \u2014 a standard\'s clause, a rule |\n| `failed` | list of alias (at least one) | no | Options of the child\'s status a row stands failed at \u2014 none of them `closed` |\n\n#### Compare\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `before` | alias | yes | A field of the block\'s rows holding what stood before: a files field (the photo of the place before the work \u2014 the damage surveyed, the check failed), or a value \u2014 text, a number, a date or a single select (the price a row held before a sheet changed it) |\n| `after` | alias | yes | Another field of the block\'s rows, of the same type as `before`, holding what stands after: the photo of the same place once the work is done, or the value the row holds now |\n\n#### Files block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `files` | list of alias (at least one) | yes | Files fields of this record, read as pictures and documents |\n| `title` | text | no | The block\'s heading; absent, the child entity\'s or the field\'s own label |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Text block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `text` | alias | yes | A long text field read as prose |\n| `title` | text | no | The block\'s heading; absent, the child entity\'s or the field\'s own label |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n<!-- generated:end apps-blocks -->\n\n<!-- generated:start rules-block -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `block.child-link` | A block reads a child linked to the record; `via` names the link where the child links more than once. |\n| `block.column-drawn` | A child block\'s column never names what the child\'s row draws \u2014 its title, subtitle, image, status, figure, or the bound its figure\'s meter reads against \u2014 nor its link back to the record, and names a field once; an `expect` block\'s figure is its filled-in-place column. |\n| `block.columns-budget` | A child block spends at most 3 columns, what a desk draws whole; a deadline costs two. |\n| `block.title-back` | Where a child\'s title is its link back to the record a block lists it under, its first other subtitle names it there \u2014 a text, a code, a select, a link or a member, never a number or a date. |\n| `block.where` | A rows block\'s `where` names single selects the child requires, by options they hold \u2014 one held at a single option is never also a column \u2014 and the child\'s yes/nos by value. A yes/no is never held: a block adds rows only at a stored one\'s start, and never picks, expects or stands lines under documents. |\n| `block.under` | `under` names the child\'s one-row link to a document entity that pairs a many-link back and is read under this record by its one link; the lines\' columns never read the document (its heading does) nor hold long text. |\n| `block.under-once` | Documents drawn over their lines (`under`) are never listed again as a block of their own. |\n| `block.edits` | A rows block\'s `edits` name at most two of the child\'s columns or its figure that the row\'s own save writes \u2014 a number, a date, a few words, one option or a one-row link, never the block\'s `via` nor a link its `via` must name alike (`write_rules`\' `same`) \u2014 never on an `expect` block, whose lines are filled in place already. |\n| `block.remove` | A rows block\'s `remove: false` hides the Delete its rows would offer, so it stands only where the app writes those rows. |\n| `block.compare` | A rows block\'s `compare` names two different fields of the child, its `before` and its `after`: two files fields, or two values of one type \u2014 text that is no long text, a number, a date or a single select. Never on a block with `expect`. Over files on a `checklist`, its `before` is the check\'s `photo`. Over values: neither side is also a column or a part the row draws already (its title, line, figure, status, deadline), two numbers read in one notation, no column of the block is long text, and never on a `checklist`. |\n| `block.checklist` | A rows block\'s `checklist` reads a task entity\'s rows as checks, one under another \u2014 never expected, under documents, grouped, written in place or picked together by an act over several, its columns no files; its `photo` names a files field of the child, its `clause` a one-row link of the child, and its `failed` options of the child\'s status none of which is `closed`. |\n| `block.pick` | A rows block\'s `pick` links rows of the child through `via` \u2014 an optional one-row link a person writes, no act writes, no other rule compares rows by and no `under` block stands lines under \u2014 paired with a many-link of the record its own save writes; the child\'s `read_scope` reads a row naming no record through `via`; never on an `expect` or `under` block, nor in an app writing only the record\'s children or nothing. |\n| `block.narrow` | A rows block\'s `filters`, `search`, `group` and `sort` follow the register\'s rules over the child\'s rows, its status among them but on a task list (its chips); never on the link back to the record or a select its `where` holds at one option, never on an `expect` block, and an `under` block is grouped by its documents. |\n| `block.expect` | `expect` names the child\'s title \u2014 a single select or a one-row link a person writes, never the link back \u2014 on a child added in the block; the block\'s `columns` name at least one field a person fills in place \u2014 unless it states `post`, whose lines are ticked \u2014 and its `create` takes the file where the child is pictured by one. |\n| `block.expect-fills` | An expected line is made from its key and its first filled column \u2014 a `post` block\'s from its key alone, by its tick \u2014 so every other field the child requires has a default, a start or a `default_from`, or is read first. |\n| `block.expect-of` | A block\'s `of` needs `expect` on a select, and names the record\'s multi-select whose every option is one of the title\'s. |\n| `block.field-kind` | A files block names files fields of the record, and a text block a text field. |\n| `block.read-scope` | A child read under a record whose rows a `read_scope` narrows states its own \u2014 a row rule is not inherited, save the status history\'s, which takes its record\'s. |\n| `block.under-note` | *Noted, never refused:* Rows holding a paper that cover another block\'s lines, listed apart with no add of their own stated: `under` draws them over the lines they cover. |\n| `block.expect-note` | *Noted, never refused:* Rows each a kind of paper \u2014 a single select their title, a files field holding it \u2014 listed with no `expect` and no `where` on the kind, that no act of the app files a call into or `fills`: the papers a record needs read as the lines still missing. |\n\n<!-- generated:end rules-block -->\n\nAn add in a block fills the link to this record, never asking it, and a rows block opens each row in a drawer.\nUnder `under` the uncovered lines come first; a document made over\none line starts its figure at the line\'s amount, the heading\'s make covering those ticked in its dialog. `pick` (a\nsupplier bill picking the job\'s cost lines) offers none until the record names each link `via`\'s `same` compares,\nlinks at most 200 ticked, and saves the record: a check locking it refuses, and one refusing a row\'s edits refuses\nthat row. Where the child is pictured by a file a person brings (its `records` `image`), an `expect` line not yet\nfilled is a placeholder naming the paper whose upload makes the row; a catalog link\'s values are the rows its\n`options_where` admits, and the add offers only values not yet held. A field starting from the catalog row\n(`default_from`) shows that value as its hint, taken with one press. A block narrowed by a select\'s `where` expects\nits lines once per value among them (one leg\'s fees beside the other\'s), its foot totalled by the record\'s sum\nnarrowed alike. An `agenda` and a `timeline` are set out under \xA7 Timeline and agenda, a `statement` under\n\xA7 Statements.\n\nA rows block whose `create` asks only numbers, single selects, texts with `suggest` and one-row links (one link at\nleast; no `expect`, `under`, `pick`, checklist or `post`) is also added to by one typed line, its words searching\nthe link\'s rows by title and `records` subtitle \u2014 state there the code people type \u2014 and what it does not ask\ncoming off the row picked (`default_from`).\n\n## Composed page\n\nA record whose page is its own arrangement of what the app already states \u2014 a piece of writing under its title, a\nbrief beside its figures \u2014 states `compose` instead of `sections`: a tree of finished pieces, each named by `use`.\n\n```jsonc\n"record": { "door": "page", "compose": {\n  "use": "Column", "children": [\n    { "use": "Bar", "children": [\n      { "use": "Status" },\n      { "use": "Field", "field": "audience" },\n      { "use": "Act", "act": "send_for_review" },\n      { "use": "Copy", "field": "body", "as": "plain" } ] },\n    { "use": "Title" },\n    { "use": "Document", "field": "body" },\n    { "use": "Group", "title": "Reviews", "children": [\n      { "use": "Rows", "child": "review", "create": false },\n      { "use": "Act", "act": "ask_reviewer" } ] } ] } }\n```\n\nA node binds by name: a `field` is a field of the record\'s entity, an `act` an act of the app, a `child` an entity\nlinking to the record. What a name binds is read and written exactly as a section naming it would be \u2014 a `Field` and\na `Document` are saved through the record\'s own save, an `Act` runs its workflow, a `Rows` reads the child\'s rows \u2014\nso a tree adds no write of its own. It holds no condition and no computed value: a piece that does not apply on a\nrow (a field its entity\'s `applies` leaves out, an act its `when` does not offer, rows with nothing in them and no\nadd) draws nothing, by the rule that leaves it out of a section, and anything that must depend on the row is an act\'s\n`when` or a field\'s formula, never the tree.\n\nThe first `Act` the page itself draws is its primary and every other one secondary; a `danger` act reads so wherever it\nstands. A `Copy` and a `Document` naming one field copy what is on screen \u2014 the words typed and not yet saved among\nthem. The record\'s chrome stays the runtime\'s: the way back, its Activity and its \u22EF with Delete share the row over\nthe tree, and the head draws no title and no status of its own \u2014 the tree\'s `Title` and `Status` do.\n\n<!-- generated:start apps-compose -->\n\n#### Column piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Column"` | yes | The page\'s reading column, 680px: its pieces stacked in order from one left edge |\n| `children` | list of [piece](#composed-page) (at least one) | yes | The pieces stacked in it, in the order they are read |\n\n#### Bar piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Bar"` | yes | One row of small things on one control height, in two zones: what the record is \u2014 a status, a field\'s control \u2014 from its left edge, what is done to it \u2014 an act, a copy \u2014 ending on its right edge, taking a row of their own under it where the row runs out of room |\n| `children` | list of [piece](#composed-page) (at least one) | yes | Its pieces, each zone\'s in order; a `Field` directly in it is its control alone on one line, named by its label where it holds nothing; an `Act` that destroys or corrects is not drawn here \u2014 it stands in the record\'s \u22EF |\n\n#### Group piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Group"` | yes | A titled stack, headed once by `title` |\n| `title` | text | yes | Its heading, in the reader\'s words; holding one `Rows`, it carries their count and their add, and the group\'s `Act`s end its line |\n| `children` | list of [piece](#composed-page) (at least one) | yes | The pieces under the heading, in order |\n\n#### Panel piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Panel"` | yes | What a reader does not need while writing: nothing in the page, one entry of the record\'s \u22EF named by `title` that opens its pieces in a panel beside the page \u2014 a sheet on a phone; directly in the root `Column` alone |\n| `title` | text | yes | Its entry in the \u22EF and the panel\'s name, in the reader\'s words; an `Act` directly in it ends that name\'s row |\n| `children` | list of [piece](#composed-page) (at least one) | yes | The pieces in the panel, in order: `Rows`, `Field`, `Act`, `Group`, `Document` \u2014 never `Title`, `Status`, `Bar`, `Copy` or another `Panel` |\n\n#### Title piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Title"` | yes | The record\'s title (`records.<entity>.title`) as the page\'s heading, written in place where a person writes it; one a page |\n\n#### Status piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Status"` | yes | The record\'s status (`records.<entity>.status`) as a record\'s head draws it: moved by hand, by its acts\' moves, or read |\n\n#### Field piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Field"` | yes | A field of the record under its label, as a section\'s `fields` draws it |\n| `field` | alias | yes | The field drawn \u2014 never the title or the status, which `Title` and `Status` draw; once a page |\n\n#### Document piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Document"` | yes | A markdown text field written in place with no box, saved as it is written \u2014 whether it is saved said at its foot |\n| `field` | alias | yes | A text field with `format: "markdown"`; once a page |\n\n#### Act piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Act"` | yes | An act of the app on the record as its button: its `when`, what it lacks, its asks and its confirmation as everywhere; the first `Act` the page itself draws is its primary |\n| `act` | alias | yes | An act of this app on the record \u2014 never one `of` a child\'s rows, which stands on its row; once a page |\n\n#### Rows piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Rows"` | yes | A child entity\'s rows under the record, as a rows block lists them, each row\'s own acts on it |\n| `child` | alias | yes | A child entity linking to the record; once a page |\n| `create` | `false` | no | false, rows are not added here \u2014 an act of the page makes them |\n\n#### Copy piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Copy"` | yes | A button copying a field\'s words as the page holds them now \u2014 what is typed in its `Document` and not yet saved among them |\n| `field` | alias | yes | The text field copied |\n| `as` | `"plain"` \\| `"raw"` | yes | `plain`, its markdown marks gone; `raw`, as stored |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `record.compose` | A record\'s `compose` is stated instead of `sections`, on a page door, by an app of one book whose records have no steps (`status.milestones`, `status.stages`) and no picture (`image`) \u2014 a composed page draws neither. Each name is a field of the entity, an act of the app on the record or a child entity linked to it; one `Title`, and each field, act and child drawn once \u2014 a field by `Field` or `Document`, never the title or the status, which `Title` and `Status` draw. The first `Act` the page itself draws is its next step and every other one secondary; an `Act` is a button alone, never one making a set of papers. A `Bar` is one row on one control height, in two zones \u2014 its `Status` and `Field`s from its left edge, its `Act`s and `Copy`s ending on its right edge \u2014 and holds no `Rows` and no `Document`; a `Field` directly in it is its control alone on one line, named by its label where it holds nothing; an `Act` in it that destroys or corrects what is done (`danger`, or a move back) is not drawn there \u2014 it stands in the record\'s \u22EF. A `Panel` draws nothing in the page: it is one entry of the record\'s \u22EF, named by its `title`, opening its pieces in a panel beside the page; it stands directly in the root `Column`, holds `Rows`, `Field`, `Act`, `Group` and `Document` \u2014 never `Title`, `Status`, `Bar`, `Copy` or another `Panel` \u2014 and an `Act` directly in it ends the panel\'s name, secondary. A `Group` is headed once, by its `title`: holding one `Rows`, that heading carries the rows\' count and their add in place of the rows\' own, and the `Act`s the group holds end its line. A `Copy` takes a text field\'s words as the page holds them now, a `Document`\'s words not yet saved among them; a field a `Copy` alone names is read, never written. |\n\n<!-- generated:end apps-compose -->\n\n## Publish desk\n\nRows that are each a place the record is sent \u2014 a notice\'s boards, a listing\'s\nportals \u2014 are a rows block that `expect`s the child\'s one-row link to the catalog of those places and states `post`:\n\n```jsonc\n{ "rows": "posting", "expect": "board", "columns": ["posted_link", "refusal"],\n  "post": { "bodies": ["wording", "wording_abroad"], "text": "goes_out_as", "media": "pictures", "link": "page",\n            "group": "reach", "network": "kind", "networks": { "company_page": "linkedin" } } }\n```\n\nThe desk is where the post is written. `bodies` are the record\'s plain text fields it is written in (one per\nlanguage, say), each its editor between the list and the preview, saved as any field of the record is and drawn\nnowhere else on it. The preview is `text` read over what is on screen: where `text` is a formula of the child, the\ndesk computes that same formula over what is typed \u2014 a body before it is saved, the line\'s own column \u2014 so the post\nmoves as it is written, and a place not ticked previews the words its row would hold. For that the formula reads only\nwhat a screen holds whole: stored values of its row, the record through lookups over the link back to it, the place\nthrough lookups over `expect`, and formulas of the row over those \u2014 a rollup, a lookup through another link or the\nclock is refused, naming the field.\n\nEvery place the link admits is a line with a tick and that place\'s face: its picture (its `records` `image`), else\nthe mark of the network it is on where `networks` names one, else none. `group`, another single select of the place,\nstands the lines under its options in their order: a kind holding a ticked line is open, one holding none folded to\nits heading and its count \u2014 the first open where nothing is ticked \u2014 and a place of no kind comes last. A tick makes\nthe line\'s row from its key alone \u2014 so nothing else the child requires is left without a default \u2014 and an untick\ndeletes it until the row\'s status is `closed`: what went out is not taken back. It asks first only where a person\nwrote on the row \u2014 its status moved off its first option, or one of the block\'s `columns` a person writes filled. One line is worked beside the list \u2014 the one\npressed, else the first ticked \u2014 and read as the post that place\'s feed shows: `text` is the child\'s words for that\nplace, `media` and `link` the record\'s, and `network` the place\'s single select whose options `networks` names to a\nfeed. A place on an option not named reads its words on a plain card. Under the bodies stand the block\'s `columns` a\nperson writes of the line\'s row (words for that place alone); under the post, the press copying its words beside\nthe acts `of` the child \u2014 never a second primary: the section\'s own act is that \u2014 then what the row\'s line and the\nblock\'s `columns` hold that nobody writes there (the link it went out at, why it was refused), each drawn only once\nit holds a value. A value an act or a workflow fills is stated as that act\'s, so the desk never offers it as an\nempty box. Where the block\'s box seats three columns they are the list, what is written and\nthe post; narrower, what is written stands over the post; narrower still the list stands alone and a line opens in\nplace. Sending is an\nordinary act of the record, named in the section\'s `acts`.\n\n<!-- generated:start apps-post -->\n\n#### Post\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `bodies` | list of alias (1\u20133) | no | The record\'s plain text fields the post is written in, in order \u2014 one per language, say \u2014 at most 3: each its editor on the desk, between the list and the preview, and drawn nowhere else on the record |\n| `text` | alias | yes | A text of the block\'s rows \u2014 stored, or a formula yielding text \u2014 holding the words that go out on that row\'s destination. A formula is computed on the desk too, over what is typed: it reads stored values of its row, the record through lookups over the link back to it, the destination through lookups over `expect`, and formulas of the row over those \u2014 never a rollup, another link or the clock |\n| `media` | alias | yes | A files field of the record: the pictures or the video the post carries |\n| `link` | alias | no | A text field of the record holding a link (`format: "link"`), carried as the post\'s card |\n| `network` | alias | yes | A single select of the entity `expect` links to, saying which network each destination is on |\n| `group` | alias | no | Another single select of the entity `expect` links to \u2014 the destination\'s kind \u2014 the lines stand grouped by: each option a heading in the select\'s order, a group holding no ticked line folded to its heading and its count, destinations holding no option last |\n| `networks` | map of alias \u2192 `"facebook"` \\| `"instagram"` \\| `"threads"` \\| `"x"` \\| `"linkedin"` | yes | That select\'s options, each by its alias, to the network whose feed the post is previewed in \u2014 facebook, instagram, threads, x, linkedin. An option not named has no feed to imitate: its words read as a plain card |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `block.post` | A rows block\'s `post` needs `expect` on a one-row link \u2014 never a select, nor with `under`, `pick`, `checklist`, `compare` or a `create` list, its line made by a tick from its key alone: its `bodies` are plain text fields of the record a person writes, drawn nowhere else on it; its `text` is a text of the child, stored or a formula yielding text \u2014 a formula reading only stored values of its row, lookups through the link back to the record or through `expect`, and formulas of the row over those, never the clock; its `media` a files field of the record and its `link` a text field of the record; its `network` a single select of the entity the link names, and `networks` holds options of that select, by alias, each to one of facebook, instagram, threads, x, linkedin; its `group` is another single select of that entity. |\n\n<!-- generated:end apps-post -->\n\n## Timeline and agenda\n\nTwo blocks read a child\'s rows by their day: a `timeline` logs what happened, newest first; an `agenda` plans\nwhat is to come on a time axis.\n\n```jsonc\n"blocks": [\n  { "timeline": "note" },\n  { "agenda": "booking", "columns": ["guide"], "start": "arrival" }\n]\n```\n\n<!-- generated:start apps-timeline-agenda -->\n\n#### Timeline block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `timeline` | alias | yes | A child entity read as a log of dated entries, newest first, with a composer where the app adds entries, each corrected and removed where it stands as a rows block\'s row (entries planned ahead are an `agenda`) \u2014 never the record\'s status history: its Activity shows each move |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `title` | text | no | The block\'s heading; absent, the child entity\'s or the field\'s own label |\n| `create` | list of alias (at least one) \\| `false` | no | The child\'s fields asked when a row is added here; absent, its title, the subtitle and figure no default fills, its natural key and every required field \u2014 each a person writes; false, rows are not added here |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Agenda block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `agenda` | alias | yes | A child entity read as planned entries on a time axis: by day, soonest first, each entry with its picture and the day that is today marked. The day is the first date on the child\'s row line (its `records` title or subtitle); within a day entries follow a datetime there, else the first single select after the date \u2014 its options in the day\'s order |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `title` | text | no | The block\'s heading; absent, the child entity\'s or the field\'s own label |\n| `columns` | list of alias | no | The child\'s facts read on an entry\'s line after its title \u2014 never what its line already draws (subtitle, image, status, figure) |\n| `create` | list of alias (at least one) \\| `false` | no | The child\'s fields asked when a row is added here; absent, its title, its picture, the subtitle and figure no default fills, the block\'s columns, its natural key and every required field \u2014 each a person writes; false, rows are not added here |\n| `start` | alias | no | The record\'s date that is the first day: each day\'s heading counts from it (Day 1, Day 2); absent, the weekday and the date alone |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `block.timeline` | A timeline\'s child holds a date to place its entries by. |\n| `block.agenda` | An agenda\'s child names a date on its row line (`records` title or subtitle); `start` is a date of the record. |\n| `block.timeline-note` | *Noted, never refused:* Rows each what happened on a day and who \u2014 a date on their line, a member, no status and no figure \u2014 listed as a table: a `timeline` draws them as a log, newest first. |\n| `block.agenda-note` | *Noted, never refused:* Rows each on a day and within it (at an hour, in a part of the day) listed as a table: an `agenda` draws them by day. |\n\n<!-- generated:end apps-timeline-agenda -->\n\nAn entry with no day yet is a plan, listed first and dated in place; a timeline\'s moment is its child\'s first date,\nand who its member field.\n\n## Statements\n\nA `statement` block draws a figure the record works out from its own figures \u2014 a claim\'s payable, an invoice\'s\ntotal, a payslip\'s net \u2014 line by line in the order the arithmetic runs: each line a number of the record, the first\nstating no `op`, the last an `equals`. Every figure is a field the server computes or a person writes; the screen adds\nnothing up. A line\'s `parts` lists the rows its figure carries, each read from its own row, and that figure is what\nthey add up to \u2014 a formula, rollup or lookup, or the server\'s copy when the record is made (`default_from`), which\nnothing writes after. A claim\'s "certified before" is the contract\'s certified total copied when the claim is made\n(`made_at`, a moment the record `starts` at `today`), over the claims certified (`certified_at`, an act\'s `now`)\nbefore that moment, each at the figure its certifying act froze (`certified_value`, set to\n`{ "formula": "{claim_value}" }`, which the contract\'s total sums) \u2014 so they always add up to it, as a signed\ncertificate does, after a percent is edited or the contract varied.\n\n```jsonc\n{ "statement": [\n    { "field": "contract_value" },\n    { "field": "done_to_date", "op": "times" },\n    { "field": "value_to_date", "op": "equals" },\n    { "field": "certified_before", "op": "minus",\n      "parts": { "rows": "claim", "same": "contract", "at": "certified_at", "before": "made_at", "where": { "kind": ["work"] },\n                 "columns": ["claimed_on", "done_to_date"], "figure": "certified_value" } },\n    { "field": "claim_value", "op": "equals" },\n    { "field": "retention", "op": "minus", "rate": "retention_rate" },\n    { "field": "payable", "op": "equals" }\n  ],\n  "when": { "kind": ["work"] } }\n```\n\n<!-- generated:start apps-statement -->\n\n#### Statement block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `statement` | list of [Statement line](#statement-line) (at least 3) | yes | A figure built from figures of the record, read as a statement: each line its operator, its label and its figure, the figures on one right edge, in the order stated \u2014 the last an `equals`, what it all comes to, drawn heaviest (a claim\'s payable, an invoice\'s total, a payslip\'s net). A line\'s figure is a control where the app writes it |\n| `title` | text | no | The block\'s heading; absent, the label of what the statement comes to |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Statement line\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field` | alias | yes | A number of the record \u2014 stored, a formula, a rollup or a lookup \u2014 read on the line after its label |\n| `op` | `"plus"` \\| `"minus"` \\| `"times"` \\| `"equals"` | no | How the line works on the lines above it \u2014 `plus`, `minus`, `times`, or `equals` for what they come to, a formula, rollup or lookup the server computes; absent on the first line, which the rest work from |\n| `rate` | alias | no | A percent of the record read after the line\'s label: the rate its figure is taken at (retention at 5 %) |\n| `parts` | [Statement parts](#statement-parts) | no | The rows the line\'s figure carries, each listed under it with its words and its own figure \u2014 read from those rows, never a copy of them. The line\'s figure is what they add up to, drawn read: a formula, rollup or lookup, or a value the server copies when the record is made (`default_from`) that nothing writes after |\n\n#### Statement parts\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `rows` | alias | yes | The entity whose rows the line\'s figure carries \u2014 the record\'s own for the earlier rows of the same thing |\n| `same` | alias | yes | A one-link the record and those rows both hold: the rows naming what the record names in it |\n| `at` | alias | no | A moment (a datetime) of those rows no person keys \u2014 when each was certified: with `before`, only the rows whose moment stands before the record\'s, earliest first; absent with it, every row so named, in their own order |\n| `before` | alias | no | A moment (a datetime) of the record no person keys \u2014 when it was made: the moment the rows\' `at` stands before; stated with `at` |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Only the rows whose single select holds one of these options, or whose yes/no (stored, or a formula) is this value \u2014 read so on the server |\n| `columns` | list of alias (1\u20132) | yes | The rows\' fields read as each one\'s words, in order (its date, its percent) |\n| `figure` | alias | yes | The rows\' number each one reads at the figures\' edge, frozen when the row was certified: a stored number an act fills (`{ "formula": \u2026 }` as it runs) or the server copies when the row is made (`default_from`) \u2014 never one a person keys, nor a formula, rollup or lookup the server recomputes |\n\n<!-- generated:end apps-statement -->\n\n<!-- generated:start rules-statement -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `statement.lines` | A statement\'s lines are numbers of the record, each once \u2014 the first stating no `op`, every other one, the last an `equals` \u2014 each `equals` a formula, rollup or lookup, and a `rate` a number of the record. |\n| `statement.rows` | A line\'s `parts` read rows of an entity holding `same`, a one-link of the record\'s to the same entity; `at`, a moment of those rows, and `before`, a moment of the record (datetimes, never days), stated together; their `columns` and `figure` are those rows\' fields, the figure a number. |\n| `statement.parts-keyed` | A line\'s `parts` add up to its figure, so no person keys it: a formula, rollup or lookup, a value the server copies when the record is made (`default_from`) that no add asks and no save or act writes, or a stored number stating `writes: false` \u2014 the line draws it read; each part\'s `figure` is frozen when its row was certified \u2014 a stored number an act fills, the server copies or the model states no person keys (`writes: false`), never one a person keys or the server recomputes \u2014 and no person keys the moments `at` and `before` either. |\n\n<!-- generated:end rules-statement -->\n\n## Reading blocks\n\nA `metric`, `breakdown`, `trend`, `pivot` or `progress` block on a record is a reading (\xA7 Readings) of a child\nentity\'s rows under it, read only \u2014 `via` names the link where the child has more than one.\n\nA `figures` block reads the record\'s own numbers instead, each a tile under its field\'s label: two to eight\nnumbers of the record no person keys \u2014 a formula, a rollup, a lookup through links to one row, or a stored number\nstating `writes: false` (what a workflow or an integration writes). A number a person keys is a field of the\nsection, where it is written. A tile holding nothing reads as not measured, never 0 \u2014 a sum or a count of\nnothing yet reads 0; a stored 0 reads 0.\n\nMetric blocks and a `figures` block standing one straight after another in a section draw as one strip: four\ntiles to a line on a desk, two on a phone.\n\nA `funnel` block reads the same rows as steps people drop out of between: each of its `steps` a number column\nof the child, summed over the rows under the record, drawn in order with the share each keeps of the one before.\nFunnel blocks standing one straight after another in a section draw on one grid \u2014 one name column, one bar origin\nand one value column \u2014 each under its own `label`, its bars over its own first step.\n\n```jsonc\n"blocks": [\n  { "metric": "fee", "value": "amount", "label": "Fees" },\n  { "breakdown": "fee", "by": "kind" },\n  { "trend": "fee", "over": "charged_on", "value": "amount" },\n  { "pivot": "fee", "rows": "kind", "columns": "method" },\n  { "progress": "task", "planned": { "start": "plan_start", "end": "plan_end" }, "done": "complete", "label": "Progress" },\n  { "funnel": "channel_week", "steps": ["impressions", "clicks", "bookings"], "label": "Reach to booking" },\n  { "figures": ["sessions", "bookings", "calls", "ad_spend"] }\n]\n```\n\n<!-- generated:start apps-reading-blocks -->\n\n#### Metric block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `metric` | alias | yes | The entity whose rows are counted, or summed, into one number |\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `average` | `true` | no | The `value` is averaged, not summed: its sum over the rows holding one, divided by how many hold one \u2014 a row holding none is no part of it. Under a period each period reads its own average, and its change compares two averages; where no row holds one it reads no figure, never 0, and no change. A share is an average too: a number formula that is 100 on the rows that count and 0 on the others, in percent notation, reads as the share of rows that count |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `over` | alias | no | The date that places a row in time \u2014 its own (stored, or a formula), or its parent\'s through a lookup over a one-link: a dashboard\'s period windows the rows by it (a reading without one reads the rows as they stand now), and a metric reads its recent periods beside the number |\n| `target` | number | no | The number it is read against, where no `limits` bounds its value (a bounded value is read against the sum of its bound) |\n| `better` | `"up"` \\| `"down"` | no | Which way its change over the recent periods `over` reads is good; absent, a sum\'s rise and a count kept by `where` falling |\n| `label` | text | yes | What the reading is, in the reader\'s words |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Breakdown block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `breakdown` | alias | yes | The entity whose rows are split into parts |\n| `by` | alias \\| [Tiered filter](#tiered-filter) | yes | The single select, one link, member or yes/no (stored, a formula, or a lookup of one through one-row links) each row is counted under \u2014 or `{ "field", "tiers" }`, a number in the bands its tiers cut (days late: not due, 1\u201330, 31\u201360, over 60), every band drawn in its own order and a row holding no number apart |\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `over` | alias | no | The date that places a row in time \u2014 its own (stored, or a formula), or its parent\'s through a lookup over a one-link: a dashboard\'s period windows the rows by it (a reading without one reads the rows as they stand now), and a metric reads its recent periods beside the number |\n| `label` | text | no | What the reading is, in the reader\'s words; absent, the `by` field\'s label |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Trend block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `trend` | alias | yes | The entity whose rows are counted, or summed, per period |\n| `over` | alias | yes | The date each row falls on \u2014 its own (stored, or a formula), or its parent\'s through a lookup over a one-link |\n| `ahead` | `true` | no | Counts forward: the current period first, then the ones after it, over the rows dated today or later (arrivals by their ETA); absent, the periods up to today |\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `label` | text | no | What the reading is, in the reader\'s words; absent, the value\'s label, else the entity\'s |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Pivot block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `pivot` | alias | yes | The entity whose rows are counted, or summed, in a grid |\n| `rows` | alias \\| [Tiered filter](#tiered-filter) | yes | The single select, one link, member or yes/no (stored, a formula, or a lookup of one through one-row links) down the side \u2014 or `{ "field", "tiers" }`, a number in the bands its tiers cut (days late: not due, 1\u201330, 31\u201360, over 60), every band drawn in its own order and a row holding no number apart |\n| `columns` | alias \\| [Tiered filter](#tiered-filter) | yes | The single select, one link, member or yes/no (stored, a formula, or a lookup of one through one-row links) across the top \u2014 or `{ "field", "tiers" }`, a number in the bands its tiers cut (days late: not due, 1\u201330, 31\u201360, over 60), every band drawn in its own order and a row holding no number apart |\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `over` | alias | no | The date that places a row in time \u2014 its own (stored, or a formula), or its parent\'s through a lookup over a one-link: a dashboard\'s period windows the rows by it (a reading without one reads the rows as they stand now), and a metric reads its recent periods beside the number |\n| `label` | text | no | What the reading is, in the reader\'s words; absent, the two fields\' labels |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Progress block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `progress` | alias | yes | The entity whose rows are the parts of the work, read as the share of it planned and the share done, day by day |\n| `planned` | [Progress planned](#progress-planned) | yes | The days each row\'s work is planned over, its share planned spread evenly across them \u2014 a row missing either is no part of the plan, and neither line counts it |\n| `done` | alias | yes | A number of the row the server computes: its share done today, in percent (0\u2013100) |\n| `finished` | alias | no | A date of the row: the day its work was finished, from which it stands at its `done` |\n| `measured` | [Progress measured](#progress-measured) | no | Before a row is finished, its share done on a day is what these add up to by then, never past its `done`; absent, a row stands at nothing until it is finished, and at its `done` today |\n| `weight` | alias | no | A number of the row: what it weighs in the whole \u2014 its value, its share of the contract; a row holding none weighs nothing. Absent, each row weighs its planned days |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `label` | text | yes | What the reading is, in the reader\'s words |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Funnel block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `funnel` | alias | yes | A child entity whose rows each count the same steps, a column a step (a week\'s channels, each with its impressions, clicks and bookings): one funnel over the rows under the record \u2014 each step its column summed, its bar over the first step, the share kept between two steps and from the first to the last. A step no row holds a number in reads as not measured, never as zero |\n| `steps` | list of alias (2\u20138) | yes | The child\'s numbers summed, in order, first step to last \u2014 2 to 8, each stored, a formula or a rollup, all in one notation, never a percent |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `label` | text | yes | What the reading is, in the reader\'s words |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Figures block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `figures` | list of alias (2\u20138) | yes | Numbers of this record no person keys, in order, each a tile under its field\'s label \u2014 2 to 8: a formula, a rollup, a lookup, or a stored number stating `writes: false`. A tile holding nothing reads as not measured, never 0 \u2014 a sum or a count of nothing yet reads 0 |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `block.funnel` | A funnel\'s `steps` are 2 to 8 numbers of its child, each named once \u2014 stored, a formula or a rollup \u2014 all in one notation, never a percent nor a unit read on each row. |\n| `block.figures` | A `figures` block\'s tiles are 2 to 8 numbers of the record no person keys \u2014 a formula, a rollup, a lookup through links to one row, or a stored number stating `writes: false` \u2014 each placed once on the record. |\n\n<!-- generated:end apps-reading-blocks -->\n\n## List block\n\nA `list` block puts rows of an entity beside the record, read only \u2014 nothing in it is added, edited or removed, and\nno workflow is made for it (a `rows` block lists and edits a child\'s rows). It reads the rows linked to the\nrecord through the list entity\'s one link to it (`via` where it has several). With `same`, a one-row link of the\nrecord\'s entity, it reads the rows sharing that link\'s row with the record, the record left out \u2014 a credit\nnote\'s other notes of its party; the list entity holds one link to that row\'s entity (`via` where it has several).\nA record whose `same` link is empty lists nothing and says so. `where`, `columns`, `label` and `app` read as\non a dashboard\'s list; the heading counts every row, and the first ten are drawn. A row of this app\'s own\nentity opens its record here, a row of another entity opens in its peek, and `app` opens it in the app it names.\n`same` stands in a record\'s `blocks` only.\n\n```jsonc\n"blocks": [\n  { "list": "visit", "label": "Service visits", "columns": ["engineer"], "app": "visits" },\n  { "list": "order", "same": "customer", "label": "Customer\'s other open orders", "where": { "stage": ["draft", "confirmed"] } }\n]\n```\n\n<!-- generated:start apps-list-block -->\n\n#### List block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `list` | alias | yes | The entity whose rows are listed, each in its `records` anatomy |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `columns` | list of alias | no | Fields read after each row\'s title |\n| `app` | alias | no | An app of this model over the same entity that works its rows: a dashboard row opens there, a record\'s list row has "Open in" to it |\n| `same` | alias | no | In a record\'s `blocks` only, read-only: a one-row link of the record \u2014 the rows sharing its row with this record, the record left out, by the list entity\'s one link to that row\'s entity (`via` where several). Absent, the rows linked to this record |\n| `label` | text | yes | What the reading is, in the reader\'s words |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `via` | alias | no | The list entity\'s link to this record \u2014 with `same`, to the entity that link points at \u2014 where it has more than one |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `block.list` | A `list` block, read-only, lists the rows of an entity that link to the record by its one link to it (`via` where it has several); with `same`, a one-row link of the record, it lists the rows sharing that link\'s row with the record \u2014 the record left out \u2014 by the list entity\'s one link to that row\'s entity (`via` where it has several). `same` stands in a record\'s `blocks`, never on a dashboard. |\n\n<!-- generated:end apps-list-block -->\n\n## Tasks\n\nAn entity whose `records` states `"task": true` \u2014 its status a stored select with `closed` \u2014 is\nwork someone finishes. Every table of its rows draws it alike \u2014 a rows block of the record it\nbelongs to, its own register, the rows filed under one of its rows (its steps) \u2014 each row led by a\nring. Ticking the ring moves the row to a closed option by the one write the app already has for\nthat move \u2014 the act of that entity setting a closed option (its first preferred), offered on an\nopen row and asking nothing, else its own save where people write the status \u2014 stamping what\nthat act stamps and appending the status history. Unticking runs the act moving a closed row\nback (its `when` holding a closed option), else the save back to the status\'s default. A move no\nwrite reaches leaves the ring disabled, never hidden, and the check notes it. The status is moved\nin place on the row by the same moves; every other field is edited where the row opens. A\nfiles column reads on a task\'s line as how many files it holds. An act `of` the child with\n`on: "rows"` completes several at once: the list\'s heading offers to select rows, and the act\nruns on those picked. A block with `expect` or `under` draws its own lines, never rings. A record listing rows of a\ntask entity filed under it by a link holding one row says how much of that work is done \u2014 those rows at a closed\noption of all, every one the reader may read, every such block\'s rows counted as one \u2014 wherever its row is drawn: a\nmeter on its head, a column of its register\'s rows, a card\'s foot, a calendar entry, a gantt\'s or a lane\'s bar; a\ngantt of task rows grouped by the row they are filed under says that row\'s on each group\'s head. No rollup is stated\nfor it.\n\n```json\n{\n  "entities": [\n    {\n      "alias": "project",\n      "label": "Projects",\n      "singular": "Project",\n      "fields": [\n        { "alias": "name", "label": "Name", "type": "text", "required": true },\n        { "alias": "lead", "label": "Lead", "type": "select_member" }\n      ]\n    },\n    {\n      "alias": "task",\n      "label": "Tasks",\n      "singular": "Task",\n      "fields": [\n        { "alias": "title", "label": "Title", "type": "text", "required": true },\n        {\n          "alias": "project",\n          "label": "Project",\n          "type": "select_record_link",\n          "target_entity": "project",\n          "cardinality": "one",\n          "required": true\n        },\n        { "alias": "assignee", "label": "Assignee", "type": "select_member" },\n        {\n          "alias": "status",\n          "label": "Status",\n          "type": "select",\n          "required": true,\n          "options": [\n            { "alias": "todo", "label": "To do", "color": "slate" },\n            { "alias": "done", "label": "Done", "color": "green" }\n          ],\n          "default": ["todo"]\n        },\n        { "alias": "due", "label": "Due", "type": "date", "format": "date" },\n        { "alias": "done_on", "label": "Done on", "type": "date", "format": "date" }\n      ]\n    }\n  ],\n  "records": {\n    "project": { "title": "name" },\n    "task": {\n      "title": "title",\n      "subtitle": ["assignee"],\n      "status": { "field": "status", "closed": ["done"] },\n      "due": ["due"],\n      "task": true,\n      "starts": { "assignee": "me" }\n    }\n  },\n  "apps": [\n    {\n      "alias": "projects",\n      "name": "Projects",\n      "entity": "project",\n      "record": {\n        "sections": [{ "title": "Work", "fields": ["lead"], "blocks": [{ "rows": "task", "columns": ["due"] }] }]\n      },\n      "acts": [\n        { "alias": "complete", "label": "Complete", "of": "task", "when": { "status": ["todo"] }, "set": { "status": "done", "done_on": "now" } },\n        { "alias": "reopen", "label": "Reopen", "of": "task", "when": { "status": ["done"] }, "set": { "status": "todo", "done_on": null } },\n        { "alias": "complete_all", "label": "Complete", "of": "task", "on": "rows", "when": { "status": ["todo"] }, "set": { "status": "done", "done_on": "now" } }\n      ]\n    },\n    {\n      "alias": "my_tasks",\n      "name": "My tasks",\n      "entity": "task",\n      "register": {\n        "opens": { "assignee": "me" },\n        "readings": [{ "metric": "task", "where": { "status": ["todo"] }, "label": "Open" }]\n      },\n      "record": {\n        "door": "drawer",\n        "sections": [{ "title": "Task", "fields": ["project", "due"], "acts": ["finish", "undo"] }]\n      },\n      "acts": [\n        { "alias": "finish", "label": "Finish", "when": { "status": ["todo"] }, "set": { "status": "done", "done_on": "now" } },\n        { "alias": "undo", "label": "Undo", "when": { "status": ["done"] }, "set": { "status": "todo", "done_on": null } }\n      ]\n    }\n  ]\n}\n```\n\n## Acts\n\n```jsonc\n"acts": [{\n  "alias": "gate_out", "label": "Gate out",\n  "when": { "stage": ["in_yard"] }, "requires": ["release", "seal"],\n  "asks": ["seal", { "input": "note", "label": "Note", "type": "long_text" }],\n  "set": { "stage": "gone", "left_on": "now", "left_by": "me", "remark": "input:note" },\n  "confirm": true\n}]\n```\n\n<!-- generated:start apps-acts -->\n\n#### Act\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | yes | The act\'s name within its app \u2014 its workflow is `act_<alias>` |\n| `label` | text | yes | The verb, as the reader says it |\n| `on` | `"record"` \\| `"rows"` \\| `"view"` | no | `rows` runs on the rows ticked in the register \u2014 with `of`, on the child rows ticked together in a rows block of the record; `view` on every row the register shows (offered while the view is narrowed to its `when`; it states no `requires`); absent, on one record (its page and its row\'s menu) |\n| `of` | alias | no | A rows block\'s child entity the act works on: offered on each child row \u2014 or, `on: "rows"`, on the rows ticked together in the block \u2014 its conditions and its write that row\'s |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | The act works only while each named select holds one of these options, and each named yes/no (stored, or a formula) is this value |\n| `requires` | list of alias (at least one) | no | Fields that must be filled first, each drawn where the act stands (its section\'s fields, a block\'s, or the act\'s asks \u2014 never the header alone); a blocked act names each one missing |\n| `recommends` | list of alias (at least one) | no | Fields the act runs without and reads when filled: while one is empty, the act says what it will leave blank |\n| `asks` | list of (alias \\| [Asked input](#asked-input)) (at least one) | no | What the reader states when pressing it \u2014 fields of the record (written by the act) or inputs |\n| `set` | map of alias \u2192 (text \\| number \\| boolean \\| `null` \\| [Set formula](#set-formula)) | no | What the act writes: an option alias, a value, `"now"`, `"me"` or `"input:<name>"` \u2014 each the act\'s outcome, read-only elsewhere; or `{ "formula": \u2026 }`, computed over each acted row as it stands when the act runs and written then (a sell price at cost and markup): a starting value, which a person may change after and the act never recomputes |\n| `workflow` | alias | no | An authored workflow (src/workflows/<alias>.ts) the act runs after its checks, for what `set` cannot say |\n| `writes` | list of alias (at least one) | no | With `workflow`, fields of the acted row its body writes (an id kept from a service\'s answer) \u2014 the act\'s, as what `set` states is |\n| `template` | alias | no | A document template the act makes a file from \u2014 an html one made a PDF, an excel one a workbook; over several rows, one file of them all, the rows listed under the entity\'s alias |\n| `templates` | list of [Act template](#act-template) (at least 2) | no | Several papers the act makes into `into` (a case\'s forms), instead of one `template`: listed where the act stands \u2014 each made one as its file, each not yet made as a placeholder \u2014 the reader ticks which to make, one press making those, each replacing its own last paper |\n| `into` | alias | no | The record\'s files field the made document is kept in \u2014 remade, it replaces its own last paper, never a person\'s file |\n| `paper` | text | no | Its paper, `<child>.<kind>`: the line of the record\'s papers it stands on |\n| `intake` | alias | no | A child the record lists in a rows block whose rows are its papers: the press takes papers, an agent reads them, and each is filed as a row of this child \u2014 its kind the child\'s title, its file in the child\'s files field |\n| `record` | [Recording](#recording) | no | The press records a call, visit or meeting through the host \u2014 Stop ends it \u2014 and files it as a new row of a child the record lists: its audio, its screen where captured, its transcript |\n| `sign` | [Signature](#signature) | no | The press opens a pad the signer signs on, beside what the act asks, and the act keeps the signature as a picture with who signed, when and the witness \u2014 read on the record as one signature, and handed to the paper the act makes |\n| `fills` | list of text (at least one) | no | With `intake`, what the papers read may fill: a field of the record, `<link>.<field>` on the row a required one-row link names, or a child whose rows the papers add \u2014 shown before and after, saved where it differs; a single link is filled with a row the app reads. With `record`, fields of the new row an agent fills from the transcript, saved as they come |\n| `review` | `true` | no | With `workflow`: the workflow only proposes \u2014 its body reads and returns a changeset of the act\'s table in `data.review` \u2014 and the platform writes the rows of it the reader ticks in the act\'s dialog (`approved`). Over every row in view it is handed no rows |\n| `confirm` | `true` | no | The press asks first; the question lists every active warning |\n| `danger` | `true` | no | The act destroys or cannot be undone |\n\n#### Asked input\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `input` | alias | yes | A value the act asks for that is not a field of the record |\n| `label` | text | yes | What the reader is asked, in their words |\n| `type` | `"text"` \\| `"long_text"` \\| `"number"` \\| `"date"` \\| `"select"` \\| `"link"` \\| `"member"` \\| `"file"` | yes | What the reader states. A `file` is one uploaded file, handed to the act\'s authored `workflow` as its file id and read by nothing else |\n| `options` | list of [Select option](#select-option) (at least one) | no | The choices a `select` input offers, one picked \u2014 written into a select holding the same option aliases |\n| `entity` | alias | no | The entity a `link` input picks one row of |\n| `accepts` | list of `"sheet"` \\| `"pdf"` \\| `"document"` \\| `"photo"` (at least one) | no | The kinds of file a `file` input takes; absent, a sheet, a PDF or a document \u2014 a phone offers its camera only where `photo` is among them |\n| `required` | `true` | no | The act is refused without it |\n| `default` | alias | no | A field of the row whose value the input starts from, still changed at will |\n\n#### Set formula\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `formula` | text | yes | A formula over the acted row\'s fields, `{alias}` each, read as the entity\'s own formulas read them |\n\n<!-- generated:end apps-acts -->\n\n<!-- generated:start rules-act -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `act.paper-note` | *Noted, never refused:* A made paper kept in a field of a record that lists its papers by kind: it is one of those lines. |\n| `act.moves` | *Refused until adopted or declined:* Rows a stored status stages towards `closed` options are moved by an act of some app over them, or by its authored `workflow` \u2014 the patch moves each open option to the next, the last to the first closed one. |\n| `act.set-not-asked` | A field an act `set`s \u2014 an option, a value, `now`, `me`, an input \u2014 or its workflow `writes` is the act\'s outcome: read-only everywhere else and never asked by an add (`create`); a required one takes a `default`. A field an act computes by a `formula` is a starting value, which a person may change after. |\n| `act.writes` | `writes` stands beside `workflow` and names stored fields of the acted row, each once, that no `set` of the act and no other act over the rows states. |\n| `act.set-formula` | `set: { <field>: { formula } }` reads fields of the acted row and computes what the field holds \u2014 a number, a date, text, a yes/no or a single select\'s option (`{field:option}`), typed as the entity\'s own formulas are \u2014 never the status or a milestone; a bound a write rule holds the field to is checked on the computed value as the act runs. |\n| `act.of` | An act\'s `of` names a child the record lists in a rows block; it works on the one child row it is pressed on \u2014 or, `on: "rows"`, on the rows ticked together where the record lists that child as tasks \u2014 never on the rows in view. |\n| `act.writes-line-key` | An act never writes the link or the key naming an expected line under its record \u2014 a line\'s key is stated by filling it. |\n| `act.makes-or-runs` | An act makes a document (`template`, `templates`) or runs an authored `workflow`, never both \u2014 the workflow makes what it needs. |\n| `act.view` | An act over every row in view (`on: "view"`) writes (`set`), makes a document or runs a workflow, and states no `requires`. |\n| `act.requires-drawn` | Every field an act `requires` is drawn where the act stands \u2014 its section\'s fields, a block\'s, its asks, or an unstaged section\'s where its own is unstaged \u2014 never the header alone. |\n| `act.requires-written` | A field an act requires that only an act writes is written by an act offered together with it, or asked by the act itself. |\n| `act.recommends` | A field an act `recommends` is not also in its `requires`. |\n| `act.set` | `set` writes each field a value it holds \u2014 an option alias, a number, a yes/no, a text, `"now"` on a date, `"me"` on a member, `"input:<name>"` of an input the act asks of the same kind \u2014 or clears an optional one with `null`. |\n| `act.set-milestone` | An act stamps a milestone, never clears one \u2014 unticking clears it and every later one. |\n| `act.paper` | `paper` is a kind the record lists its papers by, on one record \u2014 never beside `into` or `templates`; one maker per kind. |\n| `act.history-copy` | What a status move asks is copied onto the history\'s field of the same name, which holds the same kind of value. |\n| `act.input` | An input has a name of its own \u2014 never another ask\'s, a field\'s, or the record input its workflow takes (nor `approved` beside `review`) \u2014 `options` exactly when it is a select, `entity` exactly when it is a link, and a `default` field holding what it states. A `file` input is read by the act\'s authored `workflow` alone, starts empty, and is never written into a field by `set`. |\n| `act.review` | `review: true` stands beside an authored `workflow` on an act over the record, the ticked rows or every row in view, in an app over one entity \u2014 never beside `books`, `set`, `template`, `templates`, `intake`, `record`, `sign`, `confirm` or `of`, and it asks inputs only, none named `approved`. Its workflow is that act\'s alone, run by no other act. The workflow calls only steps that read \u2014 no agent \u2014 and returns a changeset of the entity\'s table in `data.review`, the same for the same inputs and rows; the platform writes the rows `approved` names, each only while the run proposes it as the caller read it. Over every row in view (`on: "view"`) it is handed no rows and states no `when`: its workflow reads the rows it may change, whatever the view is narrowed to, and no bound on a run\'s rows applies. |\n\n<!-- generated:end rules-act -->\n\nAn act whose `when` does not hold is not offered \u2014 each select named holding one of its\noptions, each yes/no named (stored, or a formula: a period that has ended) its `true` or\n`false`; every one that holds stands at the\nfoot of the section naming it in `acts` \u2014 a correction in that section heading\'s \u22EF, one\nof a child row on its row (a correction in the row\'s \u22EF). An act\'s `requires` are fields\nits section draws \u2014 its `fields`, a block\'s, the act\'s `asks`, or those of another section\nwith no `at` where its own has none; one shown only in the header or a staged section\nelsewhere is refused. One whose `requires` are\nempty is offered disabled, naming each; one whose `recommends` are empty names what\nit will leave blank and still presses; one a standing check blocks is offered\ndisabled in the check\'s words. The generated `act_<alias>` workflow re-checks all three on the\nserver, writes `set` and what was asked, and appends the status history where the\nact moves the status. A field an act asks is read-only everywhere else. A `select` input\noffers its own options and is written into a select holding the same option aliases; a `link` input picks one row of its `entity`\nand a `member` input one person, each written into a field of its kind. A field an act\nboth `requires` and `asks` never disables the press \u2014 the act asks it, required.\n\nA `file` input is one uploaded file, handed to the act\'s authored `workflow` as its file id (a sheet is read\nfrom it by `excel_get_rows` in a workflow); nothing else reads it, so `set` never writes it into a field, and it starts empty.\n\n`review: true`, beside an authored `workflow`, makes the workflow one that only proposes, and the platform the one\nthat writes. Its body calls only steps that read, and proposes the same for the same inputs and rows \u2014 one that writes,\nany agent, an app agent or a wait is refused where it is saved, applied and run \u2014 and returns in `data.review` a\nchangeset of the act\'s table: `{ "version": 1, "table_id", "creates": [{ "key", "data" }], "updates": [{ "record_id",\n"data" }] }`, `data` holding only the fields that change, by field key, as `update_records` takes them \u2014 no computed\nfield, no file \u2014 each row with an optional `note` and `ticked`, and `unplaced: [{ "title", "note"? }]` for what matched\nnothing. A create\'s `key` is the body\'s own text naming the same line on every run, unique among the creates; so a\nrepeated confirm adds no second row, the body also writes it into a `unique` field. A record is updated once; at most\n2000 rows. Anything else is refused with what is wrong, and nothing is written.\n\nA call without `approved` answers the proposal, a `sha` on each row, and writes nothing, whoever makes it. A call with\n`approved: { "updates": [{ "record_id", "sha" }], "creates": [{ "key", "sha" }] }` \u2014 the `sha` copied from the proposal \u2014\nruns the body again, and the platform writes the named rows of THAT call\'s proposal, with its values,\nnever the caller\'s, each only where it proposes what was read \u2014 an update only of a record the act ran on \u2014 through\nthe ordinary record writes, as steps of the run, every row checked first and all written in one transaction or none:\neach record\'s Activity shows it and, in a workflow, `undo_record_changes` with the run\'s id puts it back. A row no\nlonger proposed, proposed otherwise (`changed`), changing nothing, gone, locked or holding a unique value another row\nholds is left and named; the status each written row moved to, or a made row holds, is recorded in its history by the\nsame run. What is proposed stays the body\'s: match against what the rows hold now, so a row written is proposed no\nmore.\n\nThe dialog asks what the act asks, lists the proposal to tick as one table \u2014 what matched nothing first, then a column\nfor each field any row changes, its value now against proposed, a linked row or a member by name \u2014 and confirms the\nrows left ticked; a row changed since it was read is listed again. Over every row in view the act\nis handed no rows: its body reads the rows it may change, whatever the view, bound by no count of rows; it states no\n`when`, over an entity no row rule keeps to some readers. `review` is refused beside `books`, `set`, `template`,\n`templates`, `intake`, `record`, `sign`, `confirm`, `of`, an ask of a field, and an input named `approved`. A body:\n`lotics docs workflows`.\n\n`on: "view"` runs on every row the register shows \u2014 its search, status and filters \u2014\neach row checked before any is written. `of` names a rows block\'s child entity: the\nact is offered on each child row (its menu and its drawer), its `when`, `requires`,\n`set` and checks are the child\'s, it runs on that row, and a check of the record that\nlocks the child rows locks it too. With `on: "rows"` it runs on the child rows ticked\ntogether in the record\'s task list (\xA7 Tasks) \u2014 every row checked before any is written;\nit is refused where the record lists no tasks of that child.\n\nWhat an act makes, reads, records or has signed is set out under \xA7 Papers and recordings.\n\n## Papers and recordings\n\nBeside what it writes, an act makes papers from templates (`template`, `templates`), reads papers brought into the\nrecord (`intake`), records a call or a visit (`record`) and takes a signature on the device (`sign`).\n\n<!-- generated:start apps-papers -->\n\n#### Act template\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `template` | alias | yes | A document template the act makes a paper of, kept in `into` \u2014 an html one made a PDF, an excel one a workbook |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | The paper starts ticked while each named select of the record holds one of these options and each named yes/no (stored, or a formula \u2014 how a multi-select is tested: `includes({needs}, {needs:x})`) is this value \u2014 a suggestion the reader changes, never a refusal; absent, it starts ticked |\n\n#### Recording\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `into` | alias | yes | A child the record lists in a timeline or rows block, linking back to it by a single link: each recording is filed as a new row of it |\n| `audio` | alias | yes | The child\'s files field the recording\'s audio is kept in |\n| `transcript` | alias | yes | The child\'s text field the transcript is kept in, a speaker\'s turn per line |\n| `video` | alias | no | The child\'s files field the screen is kept in, where the recording captured it |\n| `at` | alias | no | The child\'s date field stamped with the moment the recording started |\n| `by` | alias | no | The child\'s member field set to the person who recorded |\n\n#### Signature\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `into` | alias | yes | The record\'s files field the signature is kept in, as a picture \u2014 each signing replaces the one before |\n| `by` | alias | yes | Who signed: a text field the signer types their name into (someone with no seat in the workspace \u2014 a driver, the owner\'s supervisor), or a member field set to the person pressing, who signs as themselves |\n| `at` | alias | yes | The record\'s date field stamped with the server\'s time as the act runs |\n| `witness` | alias | no | Beside a text `by`, the member field set to the person pressing, who saw the signer sign |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `act.into` | `into` is a files field of the one record the act is pressed on, beside its `template` or `templates`. |\n| `act.files-written` | An act\'s `writes` never names a files field of the record: a file an act makes is a paper \u2014 the record states its papers (an `expect` block over a child pictured by its files field) and the act names its slot with `paper`. |\n| `act.templates` | `templates` names each template once, kept in `into`, on one record pressed alone \u2014 never beside `template`, `asks`, `of` or an `on` over several rows. |\n| `act.intake` | `intake` names a child the record lists in a rows block that expects its title \u2014 a single select, the paper\'s kind \u2014 and is narrowed by no `where`, holding exactly one files field and needing nothing an added line does not fill; the act runs on one record, states `fills`, and states nothing but its `label`, `when` and `requires` beside them. |\n| `act.record` | `record` names a child the record draws in a timeline or a rows block with no `expect`, `under` or `where`, linking back by one single link, its row needing nothing the recording does not write: `audio` and `video` files fields, `transcript` text, `at` a date, `by` a member, each its own field; on one record, stating only `label`, `when`, `requires` and `fills` beside it. |\n| `act.fills` | `fills` names each once, only beside `intake` or `record`. Beside `record`: a field of the recording\'s row the recording does not write, never a link. Beside `intake`: a field of the record, `<link>.<field>` on the row a required one-row link names (never beside that link), or a child the record adds rows of in a rows block with no `expect`, `under` or `where`, filled in the fields that block adds \u2014 every one a new row needs among them. Each field filled is one a person writes \u2014 text, a number, a date, a yes/no, options or a single link\'s row \u2014 never a status, a milestone, a field an act writes or a link `same` narrows; a link\'s row is one the app reads of its entity. |\n| `act.fills-drawn` | *Noted, never refused:* A field `fills` writes that the record draws nowhere: the review shows the change, the record does not. |\n| `act.fills-new` | *Noted, never refused:* A child `fills` adds rows of, whose natural key the papers cannot state: every row read is added, so the same papers read twice list them twice. |\n| `act.sign` | `sign` runs on one record, never a child\'s row: `into` a files field, `by` a text field the signer types or a member field set to the person pressing, `at` a date, `witness` a member field \u2014 stated exactly beside a text `by` \u2014 each a field of its own that the act does not also ask, set or `writes`, and no other act signs into `into`. |\n\n<!-- generated:end apps-papers -->\n\n`template` makes a document from the row as the act left it and\nkeeps it in `into`; over several rows it makes one document of them all, the rows\nlisted under the entity\'s alias, and hands it back. `templates` instead names a set of\npapers kept in `into`, listed where the act stands \u2014 each made one as its file, each\nnot made yet as a placeholder \u2014 those whose `when` holds ticked to start; the press\nmakes the ticked ones (sent in `templates`), each replacing the file its template made\nbefore (the file whose `document_template_id` is that template \u2014 never a file a person\nput there), and the set downloads as one archive (`archive_<alias>`).\n\n`intake` reads papers: the press takes files, an agent (`act_<alias>` among the app\'s\nagents) reads them, and each is filed as the record\'s line of its kind in the named\nchild \u2014 that child\'s title \u2014 or a new line, its file in the child\'s one files field.\nWhat they state of each field `fills` names is shown beside what the row holds; the save\nwrites only what differs \u2014 the record\'s fields, `<link>.<field>` on the row a required\none-row link names, a child\'s rows (one found by the child\'s `natural_key` changed, else\nadded) \u2014 each refused as its own save is, and nothing written while one refuses. A single\nlink among them is filled with a row the agent finds through the app\'s read of the rows\nit may name \u2014 narrowed as its picker is \u2014 and an id naming no row of its entity is refused\nbefore the run ends; a link `same` narrows is not filled.\n\n```jsonc\n{ "alias": "read_papers", "label": "Read papers", "intake": "customer_paper", "fills": ["phone", "contact.email", "branch"] }\n```\n\n`sign` takes a signature on the device in front of the signer: the press opens a pad in a\nsheet with what the act asks \u2014 the signer\'s name, where `by` is a text field they type it\ninto \u2014 and the act keeps the picture in `into` in place of any before it, `at` stamped with\nthe server\'s time and the person pressing in `witness` (a member `by` is the person\npressing, signing as themselves). The record reads `into` as one signature \u2014 the stroke,\nwho signed, as what, when and before whom \u2014 and the act\'s paper is handed the picture under\n`into`\'s name, an html template printing it by its url (`{{#each signature}}<img src="{{url}}">{{/each}}`).\n\n```jsonc\n{ "alias": "gate_in", "label": "Make the gate-in EIR", "template": "eir_in", "into": "eir",\n  "sign": { "into": "driver_signature", "by": "driver_name", "at": "signed_at", "witness": "signed_before" } }\n```\n\n## Checks\n\n```jsonc\n"checks": [{ "field": "release_warning" }, { "field": "unpaid", "blocks": ["gate_out"] }, { "field": "locked", "blocks": ["edit"] }]\n```\n\n<!-- generated:start apps-checks -->\n\n#### Check\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field` | alias | yes | A yes/no or text formula of the record (or of the child `of` names): true or non-empty means the check stands; its label is its short name on a row\'s line, and a text formula\'s words are the sentence the record and a tooltip say |\n| `of` | alias | no | A rows block\'s child entity this check is a formula of: standing on a child row, it refuses what it blocks of that row |\n| `blocks` | `"all"` \\| list of (alias \\| `"edit"` \\| `"delete"`) (at least one) | no | Acts, "edit" (the saves and the Delete), "delete" (the Delete alone) or "all" that the standing check refuses; absent, it only warns |\n| `resolve` | alias | no | An act of this app, on the rows the check stands on, that clears it: the check\'s line links to the act where it stands, and the act keeps its own conditions |\n\n<!-- generated:end apps-checks -->\n\n<!-- generated:start rules-check -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `check.field` | A check\'s `field` is a yes/no or text formula of the record, or of the child `of` names. |\n| `check.of` | A check\'s `of` names a child the record lists in a rows block. |\n| `check.not-placed` | A check\'s field is never also placed on the record \u2014 the line under the header says it. |\n| `check.blocks` | A check of the record blocks its acts, `"edit"`, `"delete"` or `"all"`; a check of a child blocks that row\'s saves, its Delete, the acts `of` that child, or all \u2014 never the record\'s acts. |\n| `check.resolve` | `resolve` names an act of this app on the rows the check stands on, pressed on one row, not refused by the check, and drawn as a button \u2014 never a correction. |\n| `check.restates-meter` | A warning reading a gated meter\'s figure against its bound or pass mark is refused \u2014 the meter draws it. |\n\n<!-- generated:end rules-check -->\n\nA check is a yes/no or text formula of the record: it stands while true or\nnon-empty, and a text formula\'s words are what the reader sees. Without `blocks`\nit warns; with them it refuses the acts named, `"edit"` the record\'s own saves (and\nits Delete), `"delete"` its Delete alone, or `"all"` \u2014 on the server, in every write it\nnames. A check `of` a rows block\'s child stands on each child row: it refuses that\nrow\'s saves (`edit`), its Delete (`delete`), the acts `of` that child it names, or\n`all` of them \u2014 never the record\'s acts. A warning reading the figure of a meter that\n`gates` marks against its bound or its pass mark is refused: the meter already draws it.\n\nThe check field\'s `label` is its short name \u2014 "Over budget", "Release expired": a row\'s\nline says it in the check\'s tone (the most severe of several, and how many more), while\nits words whole are the row\'s tooltip and stand under the record\'s header. So label it\nas the reader names the problem, in a few words, and let a text formula say the\nsentence. The compiler records the fields a formula reads: a row drawing each of them\nas a control says nothing of the check on its line (the empty control says it), and a\ncheck with no `resolve` links to the first of them the record draws.\n\n## What a run remembers\n\nThe WORKSPACE remembers what each entity, field, select option, role and\ntemplate alias became here, plus which record each first row landed on and the\nfile each document path was uploaded as. The model file itself holds no live id\n\u2014 it is the portable half, and the same file applies to a demo workspace and to\na customer\'s \u2014 so the join lives where the things it names live, and one model\napplied to two workspaces holds two bindings that know nothing of each other.\n\nIt is the workspace\'s and not the file\'s because a model file is never\ncommitted: memory kept beside it is one author\'s disk, absent for a teammate, on\na second machine or after a delete \u2014 and every one of those goes quietly back to\nbinding by label, which is what grows the second table.\n\nEvery later apply binds through it: it takes the remembered id first and falls\nback to a label only for an alias nothing has bound \u2014 a field you have just\nadded, or a workspace nothing has applied this model to. That is what makes a\nrelabel on EITHER side a rename rather than one thing the workspace lacks and\none the model lacks: `apply` binds the thing it has always meant, gives a field\nor a select\'s option the label the file states, and reports the move of a table,\na template or a role \u2014 which side is right there is yours to decide, not a reason\nto refuse the run.\n\nA bound target the workspace no longer holds IS a refusal, by name: re-binding\nto whatever carries that label today is how the model comes to point at\nsomebody else\'s table. On the CLI, `lotics run restore_table` puts a deleted table back.\n\n`lotics model pull` writes a workspace that already works as a model file \u2014 the\nstarting point for another business\'s model, never a source of truth: it carries\none business\'s words and stops describing that workspace the moment either\nchanges.\n\n## A complete model\n\n```json\n{\n  "entities": [\n    {\n      "alias": "customer",\n      "label": "Customers",\n      "singular": "Customer",\n      "fields": [\n        { "alias": "name", "label": "Name", "type": "text", "required": true },\n        { "alias": "logo", "label": "Logo", "type": "files" },\n        {\n          "alias": "tier",\n          "label": "Tier",\n          "type": "select",\n          "options": [\n            { "alias": "standard", "label": "Standard", "color": "slate" },\n            { "alias": "gold", "label": "Gold", "color": "amber" }\n          ],\n          "default": ["standard"]\n        },\n        {\n          "alias": "orders",\n          "label": "Orders",\n          "type": "select_record_link",\n          "target_entity": "order",\n          "cardinality": "many",\n          "sync_both_ways": true,\n          "paired_field_alias": "customer",\n          "display_field_aliases": ["code"]\n        },\n        {\n          "alias": "total_ordered",\n          "label": "Total ordered",\n          "type": "rollup",\n          "source_field_alias": "orders",\n          "aggregate_option": { "operation": "sum", "field_key": "amount" }\n        }\n      ],\n      "views": [\n        {\n          "alias": "gold",\n          "label": "Gold customers",\n          "filters": {\n            "node_type": "condition",\n            "type": "select",\n            "field_key": "tier",\n            "operator": "has_any_of",\n            "value": ["gold"]\n          },\n          "sort": [{ "field_key": "name", "order": "asc" }]\n        }\n      ]\n    },\n    {\n      "alias": "order",\n      "label": "Orders",\n      "singular": "Order",\n      "fields": [\n        { "alias": "code", "label": "Order no.", "type": "text", "unique": true },\n        { "alias": "placed_on", "label": "Placed on", "type": "date", "format": "date" },\n        {\n          "alias": "amount",\n          "label": "Amount",\n          "type": "number",\n          "notation": { "style": "currency", "currency": "VND" }\n        },\n        {\n          "alias": "total",\n          "label": "Total with VAT",\n          "type": "formula",\n          "formula": { "expression": "{amount} * 1.1", "notation": { "style": "currency", "currency": "VND" } }\n        },\n        {\n          "alias": "customer",\n          "label": "Customer",\n          "type": "select_record_link",\n          "target_entity": "customer",\n          "cardinality": "one",\n          "sync_both_ways": true,\n          "paired_field_alias": "orders",\n          "display_field_aliases": ["name"]\n        },\n        { "alias": "note", "label": "Note", "type": "text" }\n      ]\n    }\n  ],\n  "roles": [{ "alias": "sales", "label": "Sales" }],\n  "records": {\n    "customer": { "title": "name", "image": "logo", "party": "organization", "figure": "total_ordered" },\n    "order": { "title": "customer", "subtitle": ["code", "placed_on"], "figure": "amount", "starts": { "placed_on": "today" } }\n  },\n  "apps": [\n    {\n      "alias": "customers",\n      "name": "Customers",\n      "entity": "customer",\n      "register": {\n        "columns": ["tier"],\n        "readings": [{ "breakdown": "customer", "by": "tier", "value": "total_ordered" }]\n      },\n      "record": {\n        "sections": [\n          { "title": "Account", "fields": ["tier"] },\n          { "title": "Orders", "blocks": [{ "rows": "order", "columns": ["total"], "create": ["code", "amount"] }] }\n        ]\n      }\n    },\n    {\n      "alias": "orders",\n      "name": "Orders",\n      "entity": "order",\n      "register": {\n        "filters": ["customer"],\n        "create": ["code", "customer", "placed_on"],\n        "readings": [{ "trend": "order", "over": "placed_on", "value": "amount" }]\n      },\n      "record": { "door": "drawer", "sections": [{ "title": "Order", "fields": ["note"] }] }\n    }\n  ],\n  "rows": {\n    "customer": [\n      { "ref": "acme", "fields": { "name": "Acme Trading", "tier": "gold" } },\n      { "ref": "bluebird", "fields": { "name": "Bluebird Foods", "tier": "standard" } }\n    ],\n    "order": [\n      {\n        "ref": "so_1001",\n        "fields": {\n          "code": "SO-1001",\n          "placed_on": "@month-start+2",\n          "amount": 4200000,\n          "customer": "customer:acme"\n        }\n      },\n      {\n        "ref": "so_1002",\n        "fields": {\n          "code": "SO-1002",\n          "placed_on": "@today-3",\n          "amount": 1150000,\n          "customer": "customer:bluebird"\n        }\n      }\n    ]\n  }\n}\n```\n\nEach app of this file, as its reader will see it:\n\n```\nApp customers \u2014 "Customers" over Customers (customer)\n  Register \u2014 table (default), newest first (default)\n    row      [Logo] \xB7 Name \xB7 figure Total ordered\n    columns  Tier\n    filters  \u2014\n    readings "Tier" \u2014 Total ordered summed per Tier, over the rows in view (default)\n    add      Name (default)\n  Record \u2014 a drawer (default)\n    header   image Logo \xB7 title Name \xB7 figure Total ordered\n    checks   \u2014\n    header \u22EF Delete\n    sections 1. "Account"\n                fields Tier\n             2. "Orders"\n                block  Orders (default) \u2014 rows of Orders through Customer; columns Total with VAT; add asks Order no., Amount\n    thread   \u2014\n    history  \u2014\n    acts     \u2014\n  Reads Customers, Orders\n\nApp orders \u2014 "Orders" over Orders (order)\n  Register \u2014 table (default), newest first (default)\n    row      Customer \xB7 under it Order no., Placed on \xB7 figure Amount\n    columns  \u2014\n    filters  Customer\n    readings "Amount" \u2014 Amount summed per period by Placed on, over the rows in view (default)\n    add      Order no., Customer, Placed on \u2014 starting Placed on at today\n  Record \u2014 a drawer\n    header   title Customer \xB7 subtitle Order no., Placed on \xB7 figure Amount\n    checks   \u2014\n    header \u22EF Delete\n    sections 1. "Order"\n                fields Note\n    thread   \u2014\n    history  \u2014\n    acts     \u2014\n  Reads Orders, Customers\n\n```\n\nEach `(default)` is a value the model left to the system: the door a record opens\nthrough \u2014 a drawer, since neither record has a stage or more than three sections \u2014 the\norder rows open in, and what an add asks. The order\'s one section holds every field a\nperson writes that the header does not already show. The customer\'s orders\nare a block in its "Orders" section, never its own `Orders` link as a field as well:\none fact, one place. An order is titled by its customer and read by its number under\nit; the block names what its add asks, since a subtitle or a figure is never asked by\ndefault. `Total ordered` is a rollup, so it is read and never asked; the\norders app\'s record opens in a drawer, because its rows are worked one after another.\n';
+var model_reference_default = '# The Lotics workspace model (`model.json`)\n\nOne JSON file describing a workspace: its tables, fields, options, views, roles,\nfirst rows, how a row of each table is recognised, and the apps over them. Each \xA7\nis its own page at `model/<section>` \u2014 `lotics docs`, or the `docs` tool. Which treatment each job\'s\nscreen needs: the `design` reference. Each treatment worked through in an app of a complete model: the\n`examples` reference.\n\n**What a model composes with**\n\n- **Entities and fields** (\xA7 Entity, \xA7 Field) \u2014 the tables, their columns, options and links.\n- **Records** (\xA7 Records, then \xA7 Status) \u2014 how a row of each entity is RECOGNISED: its title, the line\n  under it, its picture, its status, the one number it stands for. Stated once per entity\n  and read by every surface that draws one of its rows.\n- **Write rules** (\xA7 Write rules) \u2014 what a write finds, bounds and picks among.\n- **Apps** (\xA7 Apps, then a page each: \xA7 Logs, \xA7 Workflows, \xA7 Queries, \xA7 Register, \xA7 Layouts, \xA7 Tabs, \xA7 Export, \xA7 Readings,\n  \xA7 Averages and bands, \xA7 Dashboards, \xA7 Record page, \xA7 Blocks, \xA7 Composed page, \xA7 Publish desk, \xA7 Timeline and agenda, \xA7 Statements, \xA7 Reading blocks, \xA7 List block, \xA7 Tasks, \xA7 Acts,\n  \xA7 Papers and recordings, \xA7 Checks) \u2014 one\n  working register over one entity and the record each row opens, with the logs beside it:\n  which fields go where, the acts, and the checks that guard them \u2014 or a dashboard of readings.\n  How each thing LOOKS is the runtime\'s, one treatment per concept; no key here changes it.\n  A screen the job needs and no key states is a `lotics report` \u2014 the job, what the model\n  drew, the word wanted \u2014 never keys bent to approximate it.\n\n**The working order**\n\n1. Name the people and each one\'s JOB \u2014 the work they alone decide or write.\n2. The entities and fields those jobs touch, and a `records` entry for every entity an\n   app lists, opens or picks.\n3. One app per job in `apps[]` \u2014 the record a person moves and the rhythm they move it at, its own list; what that record owns is its sections, blocks and acts, and work over another record or at another rhythm is another app, even for the same person \u2014 each one working register over one entity; a list worked only in passing is a section of the app it serves, and the log of what was brought into the register\'s rows is a log beside it (`logs`).\n4. `lotics model apply model.json` \u2014 the file is checked first, every problem in one run;\n   then the tables, then a new version of every app, live\n   (`lotics setup model.json --email you@company.com` where no account exists yet).\n5. Change the file and apply it again; `lotics model pull -o model.json` writes what the\n   workspace holds, and each apply of that file sends only what it changes. `apply_model` takes\n   a `patch` in place of `model`: a JSON merge patch (RFC 7396) over the workspace\'s model, each\n   list whose items carry an `alias` written as an object keyed by it \u2014\n   `{ "apps": { "desk": { "acts": { "close": null } } } }` removes one act. Where an aliased item\n   stands is a move beside the patch, `"moves": [{ "at": "apps.desk.acts.close", "after": "hold" }]`\n   (or `"first": true`), placed once the patch merged \u2014 built into an app\'s acts, and a select\'s\n   options (`entities.<entity>.fields.<field>.options.<option>`) reordered on its table, the plan\n   saying each order it writes; a table\'s\n   fields and views and the apps themselves keep the workspace\'s order. A patch whose every key and\n   move lies inside one app\'s body leaves the tables as they stand and builds that app, beside any\n   other app whose build reads what it changed. A `null` removes only\n   what an apply writes as the model states it \u2014 anything inside an app, a `records` entry\n   (`"records": { "<entity>": null }`), a write rule, an entity\'s `singular` and `writes`, a\n   field\'s `default`, `required` and `writes`, a text field\'s `format`, a number\'s `notation`, a field itself, which leaves its table where no row holds a value in it and nothing reads it \u2014 and is refused\n   anywhere else, a table, view, role, template or app among them; one naming\n   nothing the model holds changes nothing. A `null` on a select\'s option is taken, as\n   leaving it out of a whole model is: the model stops stating it, so each app is built without it, its\n   table keeps it and its rows still read, and the apply notes it \u2014 `update_table` removes one, refused\n   while an app still names it. `get_model` with `app` reads one app and the\n   entities it reads.\n   Rolling an app back (`lotics run rollback_app`) restores its earlier version \u2014 table\n   changes and data writes stay.\n\n## The rules\n\n- **At least one entity, at most 50.** More tables than that is a data model\n  being designed, not applied \u2014 apply the rest in a second call.\n- **An existing table is adopted.** `lotics model apply` binds an entity whose `label`\n  already names a table in the workspace, and adds the fields, options and\n  views it is missing. No stored value is ever changed or deleted: a field it\n  adopts takes the model\'s `default` and `required`, a text field\'s `format`, and\n  the `notation` it reads in, where that only relabels \u2014 a date\'s format and a unit\n  converting its figures are left. A computed field\'s definition follows the model: a formula\'s expression,\n  notation and options, a rollup\'s link, aggregation and filter, a\n  lookup\'s link, field and order, and an autonumber\'s `template` (new rows only \u2014\n  existing numbers keep theirs). A check and the apply name each one that changes.\n  Applying the same model twice changes nothing the second time.\n- **A field the file stops stating leaves its table** \u2014 one an earlier apply stated,\n  or one the pulled file stated \u2014 where that loses nothing: no row holds a value in\n  it, and nothing outside the model\'s own apps reads it (a formula, rollup or\n  lookup, a figure\'s unit, a `default_from` copy, a unique set, a query, an agent,\n  a table check or a workflow body of the workspace). Otherwise nothing is applied,\n  and the refusal names the field, how many rows hold a value and what reads it:\n  state the field again to keep it, or clear those rows and stop those readers. A\n  field of the table no model ever stated stays as it is, and so does one a read\n  of the workspace\'s model leaves out \u2014 `get_model` and `lotics model pull` name\n  each in their findings \u2014 since no file made from that read could state it.\n  `lotics model check` names each field the apply would take off.\n- **A label the file changes is a rename.** A field\'s `label`, a select option\'s\n  `label` and a table\'s `description` are written onto the table as the file states\n  them, each named by a check and by the apply. A table\'s own name, a template\'s and\n  a role\'s are reported where they differ and left; a table is deleted on the CLI by\n  `lotics run delete_table`, or by a member in Lotics (\xA7 What a run remembers).\n- **An app\'s labels decide its language.** A model names no locale \u2014 the words an\n  app draws itself (its buttons, empty states, refusals) are in the language its\n  own labels are written in, so a Vietnamese desk beside English ones answers in\n  Vietnamese, and `model apply` notes a label written the other way from the rest\n  of its app\'s. The generated screens read the kit\'s\n  pack, and a generated WRITE cannot: its refusals run on the server, so they are\n  worded in that same language. Mix the two within one app and it answers in two.\n- **Rows land only where every bound table is empty.** One table already holding\n  records and no rows are written anywhere: sample rows landing among a\n  customer\'s real ones cannot be told apart from them.\n- **`lotics model apply` checks all of it before anything is written**, and\n  reports every problem in one run rather than the first. Each section of this\n  page ends its keys with the rules the check enforces there, one sentence each\n  under an id; a finding names its rule\'s id (`[register.filter]`), and\n  `model/<rule id>` is that one rule\'s page.\n\n<!-- generated:start rules-model -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `model.schema` | Every key is one its table lists, holding the type its row gives, and every required key is stated. |\n| `model.retired` | `field_roles`, `table_workflows` and `connections` are no longer part of a model: `records` states how a row is recognised, and an app\'s own writes do what a table automation did. |\n| `model.names-declared` | Every alias a key names is declared: an entity of this model, a field of the entity the key reads, an option of the select it names, an act of the app, a template or an app of this model. |\n| `model.tables` | A model declares at least one table and at most 50; apply the rest as a second model. |\n| `model.rows-cap` | Rows are a sample: at most 200 per entity, 2000 per model and 2000 documents attached \u2014 a real data set belongs in an import. |\n| `model.language` | *Noted, never refused:* A label or description written in the other language than the rest of its app\'s labels \u2014 with or without diacritics. |\n| `model.alias-unique` | An alias is unique where it is named: entities, roles and templates in the model, fields and views in their entity, options in their select. |\n| `model.label-unique` | A label is unique where apply finds it by label: entities, roles and templates in the model, fields and views in their entity, options in their select \u2014 and no view takes its entity\'s own label, which names the whole-table grid apply makes. |\n| `model.template-sha` | A template\'s `content_sha256`, where stated, is the 64-character lowercase hex sha256 of its content. |\n| `model.template-kind` | An act\'s paper and a register\'s `export` are made from an html or an excel template, never an email one. |\n| `model.template-act` | *Refused until adopted or declined:* In a model stating apps none of whose acts runs an authored `workflow`, every html or excel template is made by an act (`template`, `templates`) or filled by a register\'s `export` \u2014 the patch adds the act to the app over the entity whose fields it prints most. |\n| `model.filter` | A filter \u2014 a view\'s, a rollup\'s \u2014 tests fields of the entity it reads, through links as `entity.field` hops each standing on the entity the last lands on, by options its select declares. |\n\n<!-- generated:end rules-model -->\n\n## Top level\n\nEvery table of keys on this page is generated from the schema `model apply`\nparses the file with, so it is the whole of what a key may hold.\n\n<!-- generated:start top-level -->\n\n#### Model file\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `entities` | list of [Entity](#entity) | yes | The tables this model creates, with their fields, options and views |\n| `roles` | list of [Role](#role) | no | Workspace groups to create; members are added to them afterwards |\n| `templates` | list of [Template](#template) | no | Document templates: html and email inline, excel made from an uploaded workbook |\n| `rows` | map of alias \u2192 list of [Row](#row) | no | First records, keyed by entity alias \u2014 written only where every table they land in is empty |\n| `records` | map of alias \u2192 [Record](#record) \\| `null` | no | How a row of each entity is recognised, keyed by entity alias. Every entity an app lists, opens or picks has one; `null` removes the entry its table holds |\n| `write_rules` | map of alias \u2192 [Entity write rules](#entity-write-rules) | no | Entity alias \u2192 what a write of that entity finds, bounds and picks among |\n| `apps` | list of ([App](#app) \\| [Dashboard app](#dashboard-app)) | no | The apps this workspace will have \u2014 each one working register over an entity, with the logs that stand beside it, or a dashboard of readings |\n\n<!-- generated:end top-level -->\n\n**A model carries no** `fixtures`, `knowledge` or `knowledge_expects`, and no\n`word` / `pdf-form` template: file content is uploaded to the workspace, never\nstated in a model \u2014 an `excel` template names its uploaded workbook by `file_id`. `apps` here is what an agent states to make an app,\nnever built code. An unknown top-level key is an error, never ignored.\n\n### Aliases\n\nEvery `alias` is a lowercase slug \u2014 a letter, then letters, digits and\nunderscores (`unit_price`, `so_1001`). Aliases are how the file cross-references\nitself; they are never shown to anyone. `label` is what a person sees.\n\nLabels must be unique within their namespace \u2014 two entities, two fields on one\nentity, two options on one field, two views on one entity, two roles or two\ntemplates cannot share a label, because `apply` matches by label.\n\n## Entity\n\n<!-- generated:start entity -->\n\n#### Entity\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | yes | Stable entity alias, unique within the contract |\n| `label` | text | yes | The table\'s name in the workspace, which apply names it |\n| `singular` | text | no | One row of this table, in the business\'s own words \u2014 what a create\'s button and panel name |\n| `description` | text | no | The table\'s description, written onto the table in the workspace, where a caller of an app\'s queries and workflows reads it beside them |\n| `writes` | `false` | no | false: no app opens or edits this table\'s rows. Direct writes follow the table\'s access, as on any table |\n| `fields` | list of [Field](#field) (at least one) | yes | The table\'s columns |\n| `read_scope` | [Read scope](#read-scope) | no | Which rows a member reads. Absent, every member with access to the table reads every row. |\n| `unique` | list of list of alias (at least one) (at least one) | no | Sets of fields whose values no two live rows share \u2014 each a list of field aliases (text, number, date, a single select, or a link of cardinality "one"). A create or update landing a second row with the same values is refused. |\n| `views` | list of [View](#view) | no | Saved views, in the order they are listed; with none, the table still opens on its default grid |\n\n#### Read scope\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `any` | list of ([Read scope by role](#read-scope-by-role) \\| [Read scope by member](#read-scope-by-member) \\| [Read scope by option](#read-scope-by-option)) (at least one) | yes | A row is readable when ANY of these holds |\n\n#### Read scope by role\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `member_of` | alias | yes | A role alias: whoever is in the group it binds to reads the row |\n\n#### Read scope by member\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `through` | list of alias (1\u20133) | no | select_record_link aliases from this entity outward, each of cardinality "one" \u2014 the clause\'s field is on the entity the last hop lands on |\n| `field` | alias | yes | A select_member field alias on this entity, or on the entity `through` lands on |\n| `is` | `"self"` | yes | The members this column names on a row read that row |\n\n#### Read scope by option\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `through` | list of alias (1\u20133) | no | select_record_link aliases from this entity outward, each of cardinality "one" \u2014 the clause\'s field is on the entity the last hop lands on |\n| `field` | alias | yes | A single-select field alias on this entity, or on the entity `through` lands on |\n| `is` | list of alias (at least one) | yes | Its option aliases whose rows are readable \u2014 naming none would hide every row |\n\n<!-- generated:end entity -->\n\n<!-- generated:start rules-entity -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `entity.singular` | An entity a create is mounted over \u2014 a register that adds, a rows block \u2014 states its `singular`: one row of it, in the business\'s words. |\n| `entity.required-cycle` | Required links never wait on each other in a loop: no row of the loop could be created first. |\n| `entity.link-format` | A text field of `format: "link"` holds web addresses; one whose rows hold a phone or a mail address states no format. |\n| `entity.read-scope` | A `read_scope` clause names a declared role (`member_of`) or a field of its entity reached through one-row links: `"self"` a member field, options a single select declares. |\n| `entity.unique` | A `unique` set names two fields or more of its entity once each, each holding one value to compare \u2014 text, a number, a date, a single select, a one-row link \u2014 and is stated once; one field alone is `unique: true` on it. |\n\n<!-- generated:end rules-entity -->\n\n**`unique` is a set of values no two live rows share.** Each entry names fields\nof this entity holding ONE value \u2014 text, number, date, a single select, a link\nof cardinality `"one"` \u2014 and a create or update landing a second row with the\nsame values is refused. A set of one text field is that field\'s own `unique:\ntrue`, so it is refused here. A create carries each set in the names its panel\nsends, so the panel can name the duplicate before the write does.\n\n**`singular` is what a create says** \u2014 `New Order`, `Add Claim line`, `H\u1ED3 s\u01A1\nm\u1EDBi` \u2014 while `label` names the table, so without it the button reads `New\nOrders`. Nothing derives it: English plurals are irregular, and no language is\nexempt. In a language without plural forms it is usually the label itself,\nless any word for the collection. `model apply` REFUSES a model where a table\nsome create opens \u2014 a register\'s own, or a record section\'s add \u2014 states none.\n\n**`writes: false` says no app opens, edits or files these rows** \u2014 a log of what\nthe system sent, a copy of what another system holds. A record listing them\nkeeps the section and opens each row at rest, with no Add; a screen over the\nentity operates at most the rows its record owns; a party of it is picked, never\nfound or minted; and the generator writes no create and no update for it, and\nnever notes it as created nowhere. It shapes the apps, not who may write: a\ndirect write \u2014 the records API, the chat agent, an import \u2014 follows the table\'s\naccess, as on any table. A `lifecycle` on it is refused \u2014 a row walked\nthrough stages is worked by a person \u2014 and so is a publish desk over it (a rows\nblock\'s `post`), whose ticks make its rows. Absent,\napps open and edit the rows; `true` is not a value.\n\n**`read_scope` is a ROW rule, enforced by the platform.** It is resolved at\napply into the table\'s own row filters, so an app, a workflow reading for a\nviewer, and the API all answer the same rows \u2014 a per-record visibility field the\napp merely honours is a convention, not a gate. A `"self"` clause reads a column\nof one member or several, and every role alias and option alias a clause names\nmust be one this model declares. `apply` writes the rule onto a table it\nCREATES; a table it adopted that ALREADY CARRIES a rule keeps that one, because\nthe rule is the workspace\'s own statement about its rows \u2014 and a run whose model\nstates a different rule reports the entity rather than leaving the claim silent.\n\n**An app may state that its sharing is its read gate: `"reads": "shared"`.** An\napp reads as its owner, so the rule reaches a viewer only as the predicate every\nquery and editor guard of every app over the entity carries \u2014 right for a desk of\none\'s own rows, wrong for a desk whose audience its sharing already decides, where\nwidening the rule meant a role group nobody remembers to fill. Stated on an APP,\nits queries, pickers and guards carry no entity\'s rule and whoever the app is\nshared with reads and writes every row it draws; every other app and the table\'s\nown filters keep the rule. Share it deliberately. Refused on an app none of whose\ntables states a `read_scope`.\n\n**A row rule is never inherited.** A child read under a private record states\nits own: the record\'s `member_of` clauses as they are, and its column clauses\n`through` the one-row link the child hangs by \u2014 over one hop or several, each a\nlink of `"cardinality": "one"`, since over several rows the rule would admit a\nreader any one of them admits while the editor\'s guard reads the first. Only the\nstatus history takes its record\'s rule.\n\n## Field\n\nEvery field carries the keys below, and its `type`\'s section adds the rest; a\ntype whose section names no `default` takes none. `label` may not contain `{` or\n`}` (formulas reference fields by label at the platform level). Every row in `rows` states each\n`required` field it carries (neither a default nor a `default_from` copy is applied to them), and a required\nLINK is written with its row: the entity it names is created first, and entities\nwhose required links name each other are refused, since none of their rows could\never be created.\n\n**A stored field\'s `writes: false` says no person keys it in an app** \u2014 a post\'s\nid a publishing workflow brings back, a count a sync fills. Every app draws it\nread wherever it is placed, no add or act asks it, no paper fills it, and the\ngenerator writes it in no create and no update; a statement line reads it as a\nfigure no person keys, and beside `default_from` it is copied when the row is\nmade and never keyed. It shapes the apps, not who may write: a workflow, the\nrecords API, the chat agent and an import write it as the table\'s access allows.\nA formula, a rollup, a lookup, an autonumber and a date `derive_from` stamps take\nno such key \u2014 no one keys them already. Absent, a person keys the field; `true`\nis not a value.\n\n<!-- generated:start field -->\n\n#### Field\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `type` | `"text"` \\| `"number"` \\| `"date"` \\| `"boolean"` \\| `"select"` \\| `"select_member"` \\| `"select_record_link"` \\| `"files"` \\| `"formula"` \\| `"rollup"` \\| `"lookup"` \\| `"autonumber"` | yes | What the field holds \u2014 each type takes the further keys its own section lists |\n| `alias` | alias | yes | Stable local alias, unique within the entity |\n| `label` | text | yes | The field\'s name in the workspace, which apply names it |\n| `description` | text | no | The field\'s description, written onto the field in the workspace |\n| `required` | boolean | no | Refuse a record whose cell for this field is empty. Apply writes it onto the field, and every write path \u2014 create, update, an agent\'s tool call, a workflow\'s set \u2014 refuses the row by field name. |\n\n<!-- generated:end field -->\n\n### `text`\n\n<!-- generated:start field-text -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `default` | text | no | Value pre-filled into a new record when none is supplied for this field. Applied on create only \u2014 existing records are never backfilled. |\n| `writes` | `false` | no | false: no person keys this field in an app \u2014 a workflow or an integration writes it. Every app draws it read, no add or act asks it and no paper fills it. Direct writes follow the table\'s access, as on any field |\n| `unique` | boolean | no | Unique values required |\n| `format` | `"text"` \\| `"link"` \\| `"markdown"` | no | How the words are drawn \u2014 plain, as a link that opens, or as markdown |\n| `default_from` | text | no | Copied when a record is made off the row a one-row link of this entity names \u2014 `<link alias>.<field alias>` \u2014 and never re-read, so the source changing later leaves the row alone. A value the add states wins; a select copies each option as this field\'s option of the same alias. |\n\n<!-- generated:end field-text -->\n\n### `number`\n\n<!-- generated:start field-number -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `default` | number | no | Value pre-filled into a new record when none is supplied for this field. Applied on create only \u2014 existing records are never backfilled. |\n| `writes` | `false` | no | false: no person keys this field in an app \u2014 a workflow or an integration writes it. Every app draws it read, no add or act asks it and no paper fills it. Direct writes follow the table\'s access, as on any field |\n| `notation` | [notation](#number) | no | How the figure reads: { "style": "decimal" }; money, { "style": "currency", "currency": an ISO 4217 code (USD, VND) }; or a quantity, { "style": "unit", "unit": "percent" (10 reads "10%"), or a measured code (g, kg, t, l, m3, cbm, mm, cm, m, km, m2, min, h, day), which converts and scales within its dimension, or any other noun of at most 12 characters (ki\u1EC7n, pallet, TEU), which never does }. A currency or unit read on each row from a single select of that row is { "per_row": that select }. Omitted, a decimal. |\n| `default_from` | text | no | Copied when a record is made off the row a one-row link of this entity names \u2014 `<link alias>.<field alias>` \u2014 and never re-read, so the source changing later leaves the row alone. A value the add states wins; a select copies each option as this field\'s option of the same alias. |\n\n<!-- generated:end field-number -->\n\n`notation` is how the number reads, and every surface reads it:\n`{ "style": "currency", "currency": "USD" }` prints as money in its code,\n`{ "style": "unit", "unit": "kg" }` as a quantity with its unit after it,\n`{ "style": "unit", "unit": "percent" }` as a percent \u2014 10 is "10%", never\nmultiplied \u2014 and `{ "style": "decimal" }`, or no notation, as a plain number. One\nkey, so a figure reads one way.\n\nThe keys `notation` replaced \u2014 `format`, `currency`, `unit`, `unit_field` and\n`currency_field`, on a number or in a formula, and a formula\'s `format: "link"`\nfor `link: true` \u2014 are no longer read. A field stating them naming another\nreading than its `notation` (a decimal, where it states none) is refused, and the\nfinding names the `notation` to write in their place: `"format": "currency",\n"currency": "USD"` becomes `"notation": { "style": "currency", "currency": "USD" }`.\nWrite `notation`.\n\nAn ABSENT number is drawn absent \u2014 the one exception is a\n`sum` or count rollup the plan reads as a **`measure`**: that is the thing\naccumulated toward a bound, so nothing accumulated yet is zero and the meter\ndraws it. The same rollup read as an `amount` keeps its blank, and so does every\nother role: nothing added to what a row is WORTH means unpriced, not free. A\nformula reading only such sums and counts, and reading zero where each does\n(`{received} - {refunded}`), is one too. A `min`, an `avg`, a percentage of\nnothing and every other formula stay blank in any role, because none of them has\nan answer to give. This is why the pair on one\nscreen reads two ways \u2014 what has come in against what is owed \u2014 and why a\nmeasure\'s own LIMIT, an amount, leaves an unquoted row out of the count rather\nthan reporting it as nothing collected. **AND WHERE THAT LIMIT IS ABSENT \u2014 OR\nZERO \u2014 THERE IS NO LEVEL AT ALL**: a level is a reading AGAINST a bound, so a row\nthat states no bound, or a bound of nothing, draws nothing \u2014 cell, fact and all \u2014\nrather than a numerator whose whole meaning was the comparison. "Collected 0"\nbeside a blank total reads as money against a job worth nothing, and "0 of 0"\nagainst a count of nothing owed claims a comparison nobody can make. A measure the model gives no limit is a plain figure\nand is unaffected. A share is stored in percent units \u2014 68.1 is 68.1 % \u2014 and the\ncolumn, the fact behind it, the meter it is judged by and the figure over the\nregister all say so.\n\nA unit \u2014 `{ "style": "unit", "unit": "kg" }` \u2014 is what a figure counts or\nmeasures; `percent` aside, it is measured or counted. A **measured** unit is a code of one catalog \u2014 mass `g`\n`kg` `t`, volume `l` `m3` `cbm` (a cubic metre under freight\'s name), length\n`mm` `cm` `m` `km`, area `m2`, duration `min` `h` `day` \u2014 so a figure typed in\nanother unit of its dimension converts (`12,5 t` into a `kg` field is 12 500),\nand a tile or a chart reads it in the largest unit it reaches (12 500 kg as\n12,5 t\u1EA5n; CBM never scales) while a cell, a fact and a column always read in the\nfield\'s own. Any other noun of at most 12 characters (`ki\u1EC7n`, `pallet`, `TEU`) is a\n**counted** unit: a word after the figure that never converts. A measured unit is\nwritten as its code \u2014 `t\u1EA5n`, `KG` or `m\xB3` is refused, naming the code. A formula\nstates its own in `formula.notation`; a rollup that keeps the value (`sum`, `avg`,\n`median`, `min`, `max`, `range`) and a lookup carry the unit of the figure they\nread, exactly as they carry a currency, and a count carries none. A quantity is a\nnumber with its unit, never words (`3 cartons` in a text field): only a number\nsums, converts and reads down a column.\n\nA field\'s cells always hold figures in its own unit, so moving it between two\nunits of one dimension (`kg` to `t`) converts every stored figure \u2014 a change made\nin the workspace, in the field\'s settings (which say how many first) or through\n`lotics run update_table`. `model apply` never makes it: the model states the\nworkspace\'s unit until then. Any other change of unit\nrelabels.\n\nA figure whose unit or currency varies by row names a single select of its own\nrow as `per_row` \u2014 `{ "style": "unit", "unit": { "per_row": "uom" } }`,\n`{ "style": "currency", "currency": { "per_row": "currency" } }` \u2014 or a lookup of\none through a one-link, a line reading its shipment\'s currency. That select\'s\noptions are the vocabulary: each label a unit (`chi\u1EBFc`, `kg`), or an ISO 4217 code\n(`USD`). A label outside it is refused when the figure is written and when the\nselect is \u2014 its options, its type or its deletion while a figure names it. A row\nwhose select is empty reads its figure bare. Every app reads each row\'s figure in\nits own row\'s unit, and a sum never mixes units: totals are one per unit, a\nchart draws one at a time. A rollup that keeps the value (`sum`, `avg`, `min`\u2026)\nover such a figure stands only where the child\'s select is a lookup, through\nthe rollup\'s own link, of a select on this entity \u2014 the rollup reads that\nselect\'s unit; otherwise it is refused, as is any lookup of such a figure (its\nunit lives on the other row). A count is unaffected. Moving a field between a\nfixed and a per-row unit relabels.\n\n### `date`\n\n<!-- generated:start field-date -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `default` | text | no | Value pre-filled into a new record when none is supplied for this field. Applied on create only \u2014 existing records are never backfilled. A date string in the field\'s format. |\n| `writes` | `false` | no | false: no person keys this field in an app \u2014 a workflow or an integration writes it. Every app draws it read, no add or act asks it and no paper fills it. Direct writes follow the table\'s access, as on any field |\n| `format` | `"date"` \\| `"datetime"` \\| `"date_range"` \\| `"datetime_range"` | no | Whether the field holds a day or a moment, alone or as a span |\n| `timezone` | text | no | IANA timezone |\n| `derive_from` | `"created_at"` \\| `"updated_at"` | no | Auto-populate from the row\'s system timestamp; the field becomes read-only. |\n| `default_from` | text | no | Copied when a record is made off the row a one-row link of this entity names \u2014 `<link alias>.<field alias>` \u2014 and never re-read, so the source changing later leaves the row alone. A value the add states wins; a select copies each option as this field\'s option of the same alias. |\n\n<!-- generated:end field-date -->\n\nA `default` is refused beside `derive_from`: the platform stamps that date.\n\n### `boolean`\n\n<!-- generated:start field-boolean -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `default` | boolean | no | Value pre-filled into a new record when none is supplied for this field. Applied on create only \u2014 existing records are never backfilled. |\n| `writes` | `false` | no | false: no person keys this field in an app \u2014 a workflow or an integration writes it. Every app draws it read, no add or act asks it and no paper fills it. Direct writes follow the table\'s access, as on any field |\n| `default_from` | text | no | Copied when a record is made off the row a one-row link of this entity names \u2014 `<link alias>.<field alias>` \u2014 and never re-read, so the source changing later leaves the row alone. A value the add states wins; a select copies each option as this field\'s option of the same alias. |\n\n<!-- generated:end field-boolean -->\n\n### `select`\n\n<!-- generated:start field-select -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `default` | list of alias | no | Value pre-filled into a new record when none is supplied for this field. Applied on create only \u2014 existing records are never backfilled. Option alias(es) this field declares \u2014 one for single-select. |\n| `writes` | `false` | no | false: no person keys this field in an app \u2014 a workflow or an integration writes it. Every app draws it read, no add or act asks it and no paper fills it. Direct writes follow the table\'s access, as on any field |\n| `options` | list of [Select option](#select-option) (at least one) | yes | The choices, in the order every picker and every ladder lists them |\n| `multi` | boolean | no | Allow multiple selections |\n| `default_from` | text | no | Copied when a record is made off the row a one-row link of this entity names \u2014 `<link alias>.<field alias>` \u2014 and never re-read, so the source changing later leaves the row alone. A value the add states wins; a select copies each option as this field\'s option of the same alias. |\n\n#### Select option\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | yes | Stable local alias, unique within the field |\n| `label` | text | yes | Display label for the option |\n| `color` | [colour](#select) | yes | The colour the option\'s badge is drawn in |\n| `mark` | [mark](#select) | no | The option\'s own mark, drawn in place of its colour dot wherever the option is shown: the brand it is ({kind: "brand", name: one of facebook, instagram, threads, meta, tiktok, google-ads, zalo, linkedin, x, google-meet, youtube, telegram, whatsapp, gmail, google-drive, outlook, kiotviet, misa, lark, payos}) a kit glyph ({kind: "icon", name: "wrench"}) or the face of who it is, drawn from its label ({kind: "avatar", name: "person" or "organization"}). Every option of a field has one, or none does. A mark a reader does not draw falls back to the dot |\n\n<!-- generated:end field-select -->\n\n`color` is one of: `red`, `orange`, `amber`, `yellow`, `lime`, `green`,\n`emerald`, `teal`, `cyan`, `sky`, `blue`, `indigo`, `violet`, `purple`,\n`fuchsia`, `pink`, `rose`, `slate`, `gray`, `zinc`, `neutral`, `stone`.\nEvery option is drawn in its colour wherever it shows \u2014 a cell, a row\'s line,\na record, a picker, the bar a reading splits the rows by.\n\nAn option may carry its own `mark`, drawn in place of its colour dot wherever\nthe option is shown \u2014 a stage, a chip, a filter, a fact, an entry of a log, a\nreading\'s part, a lookup of the select on another entity. Where the select is its\nrows\' `records` `mark`, a brand stands on the row\'s lead tile and any other option\nleads with its colour dot there. A select a reader scans\ndown a column \u2014 how a payment was made, the channel, the mode \u2014 states one on every\noption, since a glyph reads before its word: the brand it IS\n(`{"kind": "brand", "name": "tiktok"}` \u2014 one of `facebook`, `instagram`,\n`threads`, `meta`, `tiktok`, `google-ads`, `zalo`, `linkedin`, `x`,\n`google-meet`, `youtube`, `telegram`, `whatsapp`, `gmail`, `google-drive`,\n`outlook`, `kiotviet`, `misa`, `lark`, `payos`), a glyph the kit draws\n(`{"kind": "icon", "name": "wrench"}`; any other name is refused), or \u2014 where the\noptions name people or organisations who are no member and no row \u2014 the face of who\nit is, drawn from its label (`{"kind": "avatar", "name": "person"}` or\n`"organization"`). Every option of a select has one, or none does: a run of chips\nwhere one carries no mark reads as the one missing something. `apply` writes the\nmarks onto the table, sets one an adopted option lacks, and reports one it wears\ndifferently rather than overwrite it. The glyphs:\n\n<!-- generated:start field-select-glyphs -->\n\nactivity, align-center, align-left, align-right, align-vertical-justify-center, align-vertical-justify-end, align-vertical-justify-start, arrow-down, arrow-down-a-z, arrow-down-up, arrow-down-wide-narrow, arrow-left, arrow-left-from-line, arrow-right, arrow-right-from-line, arrow-right-left, arrow-up, arrow-up-down, arrow-up-wide-narrow, arrow-up-z-a, ban, banknote, bed, bell, between-horizontal-start, between-vertical-start, bold, bolt, book-marked, book-open, book-text, bot, box, brackets, brain, briefcase, building-2, calculator, calendar, calendar-clock, calendar-off, camera, car, chart-column, check, chevron-down, chevron-left, chevron-right, chevron-up, chevrons-down-up, chevrons-up-down, circle-alert, circle-check, circle-x, clipboard-list, clipboard-paste, clock, code, code-xml, columns-3, columns-3-cog, combine, construction, container, copy, credit-card, database, decimals-arrow-left, decimals-arrow-right, dollar-sign, download, ellipsis, eraser, expand, external-link, eye, eye-off, facebook, file, file-csv, file-down, file-question, file-spreadsheet, file-stack, file-text, file-up, folder, folder-closed, folder-open, folder-pen, form, funnel-plus, funnel-x, gauge, globe, gpu, grid-2x2, grip-vertical, group, hand-coins, hash, heading, heading-1, heading-2, heading-3, history, house, image, inbox, info, instagram, italic, keyboard, languages, layout-dashboard, layout-grid, library-big, link-2, link-2-off, linkedin, list, list-checks, list-collapse, list-filter, list-filter-plus, list-ordered, loader, lock, lock-keyhole, lock-keyhole-open, lock-open, log-in, log-out, mail, map-pin, maximize-2, megaphone, menu, message-circle, message-circle-question-mark, message-square, messages-square, mic, minimize-2, minus, monitor, mouse, mouse-pointer-click, music, newspaper, notepad-text-dashed, package, paint-bucket, paintbrush-vertical, palette, panel-left, panel-left-close, panel-left-open, panel-right, panel-right-close, panel-right-open, paperclip, pause, pencil, percent, phone, pin, pin-off, plane, play, plug, plus, receipt, rectangle-ellipsis, redo, refresh-cw, repeat, rotate-ccw, rotate-cw, rows-3, scan, scan-line, scissors, search, send, settings, share, share-2, shield, shield-alert, shield-check, shopping-cart, sigma, sliders-horizontal, smile, smile-plus, snowflake, sparkles, split, square, square-check, square-pen, square-sigma, stethoscope, sticky-note, strikethrough, table, table-2, tag, target, text-quote, text-wrap, thumbs-down, thumbs-up, ticket, trash, trending-down, trending-up, triangle-alert, truck, tv-minimal, twitter, type, underline, undo, upload, user, user-check, user-pen, users, utensils, waypoints, workflow, wrench, x, zap, zoom-in, zoom-out\n\n<!-- generated:end field-select-glyphs -->\n\n```jsonc\n"options": [\n  { "alias": "short_video", "label": "Short video", "color": "zinc", "mark": { "kind": "brand", "name": "tiktok" } },\n  { "alias": "print",       "label": "Print",       "color": "amber", "mark": { "kind": "icon", "name": "newspaper" } }\n]\n```\n\n### `select_member`\n\nA person picker over the workspace\'s members. No default: a model cannot name\nmembers of a workspace that does not exist yet. With no role it is still drawn \u2014\nface and name, ranked as a `party` \u2014 in a screen\'s `columns` and in the register\na record draws of these rows.\n\n<!-- generated:start field-select_member -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `writes` | `false` | no | false: no person keys this field in an app \u2014 a workflow or an integration writes it. Every app draws it read, no add or act asks it and no paper fills it. Direct writes follow the table\'s access, as on any field |\n| `multi` | boolean | no | Allow multiple selections |\n| `default_from` | text | no | Copied when a record is made off the row a one-row link of this entity names \u2014 `<link alias>.<field alias>` \u2014 and never re-read, so the source changing later leaves the row alone. A value the add states wins; a select copies each option as this field\'s option of the same alias. |\n\n<!-- generated:end field-select_member -->\n\n### `select_record_link`\n\n<!-- generated:start field-select_record_link -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `writes` | `false` | no | false: no person keys this field in an app \u2014 a workflow or an integration writes it. Every app draws it read, no add or act asks it and no paper fills it. Direct writes follow the table\'s access, as on any field |\n| `target_entity` | alias | yes | Alias of the entity this field links to |\n| `sync_both_ways` | boolean | no | Create a paired link field on the target entity for bidirectional sync |\n| `paired_field_alias` | alias | no | The pair edge of a bidirectional link: the field alias ON THE TARGET ENTITY that is this link\'s sync partner. Both sides of a pair carry it, each naming the other. Apply creates whichever side it reaches first WITH the pairing (the platform auto-creates the partner) and binds the partner alias to the auto-created field \u2014 without this edge the two contract fields would be created independently and collide with the auto-created partner. |\n| `cardinality` | `"one"` \\| `"many"` | no | How many linked records this field holds. Default \'many\'. \'one\' holds a single row and needs no partner; where the link IS paired, the partner side holds many. |\n| `display_field_aliases` | list of alias | no | Field aliases on the target entity shown as the link\'s display text / picker columns |\n| `default_from` | text | no | Copied when a record is made off the row a one-row link of this entity names \u2014 `<link alias>.<field alias>` \u2014 and never re-read, so the source changing later leaves the row alone. A value the add states wins; a select copies each option as this field\'s option of the same alias. |\n\n<!-- generated:end field-select_record_link -->\n\nA two-way link is declared on BOTH sides, each naming the other as its\n`paired_field_alias`; the pair must be symmetric or the model is refused.\n\n**A single-valued link needs no partner.** `"cardinality": "one"` on its own is a\nlink that holds one row \u2014 one customer on an invoice, one project on a device \u2014\nand nothing is created on the target. The mirror invariant belongs to a PAIRED\nlink: pair a link when the target\'s own record should list what points at it, and\nleave it unpaired when it should not. Either way the record plan draws the\nrelation as a section on the side it points at, so an unpaired link costs the\ntarget nothing.\n\n### `files`\n\nA row attaches documents to it (\xA7 Rows). Each file\nis drawn by its kind, with no key to choose: a picture (an image, a video) as its\nthumbnail, a document (a PDF, a sheet) as its type\'s badge and its filename.\n\n<!-- generated:start field-files -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `writes` | `false` | no | false: no person keys this field in an app \u2014 a workflow or an integration writes it. Every app draws it read, no add or act asks it and no paper fills it. Direct writes follow the table\'s access, as on any field |\n\n<!-- generated:end field-files -->\n\n### `formula`\n\n<!-- generated:start field-formula -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `formula` | [Formula](#formula) | yes | Formula config. The expression references other fields on the SAME entity by alias in braces, e.g. `{quantity} * {unit_price}`. |\n\n#### Formula\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `expression` | text | yes | The expression, over fields of THIS entity by alias in braces \u2014 `{quantity} * {unit_price}` |\n| `notation` | [notation](#number) | no | How the figure reads: { "style": "decimal" }; money, { "style": "currency", "currency": an ISO 4217 code (USD, VND) }; or a quantity, { "style": "unit", "unit": "percent" (10 reads "10%"), or a measured code (g, kg, t, l, m3, cbm, mm, cm, m, km, m2, min, h, day), which converts and scales within its dimension, or any other noun of at most 12 characters (ki\u1EC7n, pallet, TEU), which never does }. A currency or unit read on each row from a single select of that row is { "per_row": that select }. For a formula yielding a number. |\n| `link` | `true` | no | The formula yields a URL as text, drawn as a link that opens. |\n| `options` | list of [Select option](#select-option) (at least one) | no | The categories the formula yields, drawn as a single select\'s options are (read-only). The expression yields one of them as `{this_field:option}`, or null \u2014 `{days_idle} > 30 ? {warmth:cold} : {warmth:hot}`. Omit for a formula yielding a plain value. |\n| `output_type` | `"number"` \\| `"text"` \\| `"date"` \\| `"datetime"` \\| `"boolean"` \\| `"select"` | no | What the expression YIELDS \u2014 the kind the platform infers at write time, declared here so the offline checks can read it. `notation` beside it is how a number result reads, not what it is. Ignored on the wire (the platform re-infers it); `lotics model pull` writes the inferred value. |\n\n<!-- generated:end field-formula -->\n\n`output_type` is what lets a role or a screen clause accept a computed value: a\ncaption over a derived name (`output_type: "text"`), a period over a settled date\n(`"date"`). A formula declaring no `output_type`, `notation` or `link` says nothing\nabout its result, and every rule that needs one refuses it by name. A formula stating\n`options` is a computed category: read-only, and read as a single select\nwherever it is drawn \u2014 a column, a filter, a reading\'s `by` or `where`.\n\n**A select reaches a formula as the KEYS of its chosen options**, a list \u2014\nnever their labels, and never their aliases \u2014 and a model has no keys: the\nworkspace mints them when the table is made. So an option is named in a formula\nas `{field:option}`, both aliases, and the copy writes that option\'s key in its\nplace: `includes({kind}, {kind:crate})` for a select holding one or several,\n`{kind}[0] == {kind:crate}` for a single one. A select compared to its own words\n(`{kind} != "Crate"`) matches no row and computes the other branch everywhere,\nso the check refuses it and names the token. A select looked up from another\nentity is tested there, in a formula of its own, and that result looked up.\n\n**The language.** The offline check and the platform compute a formula with one\nengine, and the check refuses a call or a name it cannot run, naming what to write:\n\n<!-- generated:start field-formula-language -->\n\n- Operators: `+ - * / %`, `== != > < >= <=`, `&& || !`; `+` also joins text\n- Numbers: arithmetic is exact decimal (`0.1 * 3` is `0.3`), a division that does not end the nearest double; a comparison between two numbers reads both at 15 significant digits; `round` rounds a half away from zero (`round(-2.5)` is `-3`)\n- Conditionals: a ternary only \u2014 `{amount} > 100 ? "High" : "Low"`\n- Not supported: optional chaining (`?.`), nullish coalescing (`??`), template literals, arrow functions \u2014 use `get(obj, "path", default)`, `coalesce(v1, v2)`\n- Helpers are these names, spelled exactly; a spreadsheet function (`IF`, `SUM`, `LEN`, `DATEDIF`) is none of them, and a formula calling one is refused\n- Math: round(n,decimals?), ceil(n), floor(n), abs(n), min(a,b), max(a,b), sum(arr), mean(arr), clamp(n,min,max), percentage(part,total,decimals?), pow(base,exp), sqrt(n), mod(n,divisor)\n- Strings: upper(s), lower(s), trim(s), capitalize(s), length(s), contains(s,search), join(arr,sep), split(s,sep), replace(s,search,rep), replaceAll(s,search,rep), startsWith(s,prefix), endsWith(s,suffix), substring(s,start,end?), padStart(s,len,char), padEnd(s,len,char), numberToWords(n, lang?) (lang \'vi\' default, or \'en\')\n- Lists: includes(list,value), first(list), last(list), unique(list), compact(list) \u2014 length(list) counts one\n- Dates: now(), formatDate(d,fmt), addDays(d,n), subDays(d,n), addHours(d,n), subHours(d,n), addMinutes(d,n), subMinutes(d,n), startOfDay(d), endOfDay(d), differenceInCalendarDays(later,earlier), differenceInHours(later,earlier), differenceInMinutes(later,earlier), isBefore(d1,d2), isAfter(d1,d2), isSameDay(d1,d2), isToday(d), isWithinRange(d,start,end), parseDate(d)\n- Null/type: isNull(v), isEmpty(v) (also true for "" and []), coalesce(v1,v2,...), isString(v), isNumber(v), isBoolean(v), isArray(v), toNumber(v), toString(v)\n- Other: formatCurrency(amount,locale,currency), formatDecimal(value,decimals,locale) (grouped quantity, no symbol), get(obj,"path",default?)\n- Empty cells: a cell nobody filled is null inside a formula, whatever its type; one holding 0, false or "0" is not empty. Test it with `isEmpty({note})` \u2014 `{note} == ""` and `{done} == false` are false on an unset cell\n- Arithmetic over an empty cell: `+` and `-` read it as 0 beside a value (`{fee} + {surcharge}` is `{fee}` when the surcharge is empty, null when both are); `*`, `/`, `%` and a unary `-` yield null (`{price} * {qty}` is null, not 0, when the quantity is empty)\n- No helper throws on an empty cell: the math helpers and toNumber return null, the string helpers "". A value of the wrong type still errors. When EVERY field a formula reads is empty it is null \u2014 unless it reads each only as the argument of isEmpty, isNull or isNotNull (`!isEmpty({file})` is false there, not null)\n\n<!-- generated:end field-formula-language -->\n\n### `rollup`\n\nAggregates the records reached through a link on this entity.\n\n<!-- generated:start field-rollup -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `source_field_alias` | alias | yes | Alias of a select_record_link field on this entity to roll up from |\n| `aggregate_option` | [aggregation](#rollup) | yes | Aggregation operation. Its `field_key` names a field alias on the linked entity. |\n| `filter` | [filter](#views) group | no | Only linked records matching this filter are aggregated; one condition on its own is a group of one. Every `field_key` in it names a field alias on the linked entity, and a select condition\'s value names an option alias there. A traversal node reaches past that entity, so its `path` hops and inner `field_key` are fully-qualified `entity.field` aliases. |\n\n<!-- generated:end field-rollup -->\n\n`aggregate_option` is `{ "operation": \u2026, "field_key": \u2026 }` \u2014 `field_key` a field\nalias on the linked entity (`count` may omit it), and `operation` one of `count`,\n`sum`, `avg`, `median`, `min`, `max`, `range`, `empty`, `filled`,\n`percent_empty`, `percent_filled`, `unique`, `percent_unique`, `earliest`,\n`latest`, `date_range`, `checked`, `unchecked`, `percent_checked`,\n`percent_unchecked`. The operation must be one the aggregated field\'s type\nallows \u2014 `sum` over a number, `earliest` over a date, `filled` over any stored or\nformula field. A lookup is never rolled up: roll up the child\'s own field, or a formula\nover it. A rollup states no `notation`: `sum`, `avg`, `median`, `min`, `max` and `range`\nread in the aggregated figure\'s, a count as a plain number, and a `percent_*` as a\npercent (0\u2013100), in the app as in the table.\n\n### `lookup`\n\nDisplays a field from the linked records.\n\n<!-- generated:start field-lookup -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `source_field_alias` | alias | yes | Alias of a select_record_link field on this entity to look up through |\n| `lookup_field_alias` | alias | yes | Alias of the field on the linked entity to display |\n| `order_by` | [Lookup order](#lookup-order) | no | Show ONE linked row\'s value \u2014 the first in this order \u2014 rather than every linked row\'s |\n\n#### Lookup order\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field_key` | text | yes | A field alias on the linked entity the rows are ordered by |\n| `direction` | `"asc"` \\| `"desc"` | yes | Which end of that order the one row is taken from |\n\n<!-- generated:end field-lookup -->\n\nInside a formula, a lookup holding one value is that value (`{due_soon}` is\n`true`, not `[true]`); several values are a list.\n\n### `autonumber`\n\n<!-- generated:start field-autonumber -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `prefix` | text | no | Literal prefix prepended to every display value (e.g. \'KH-\' \u2192 \'KH-001\'). Ignored when `template` is set. |\n| `padding` | integer | no | Zero-pad the integer to this width. Default 1 (no padding). 3 \u2192 \'001\', \'012\', \'123\', \'1234\' (overflow uses the actual width). Ignored when `template` is set. |\n| `template` | text | no | Format template with placeholder tokens evaluated at insert time. Tokens: {N} (raw integer), {N:W} (zero-padded to width W, e.g. {N:3} \u2192 001), {YEAR} (4-digit year), {YEAR:2} (2-digit year), {MONTH} (2-digit month), {DAY} (2-digit day). Date tokens use the workspace timezone. Example: \'HM-{YEAR}-{N:3}\' yields \'HM-2026-001\'. Stored as the composed string; subsequent template edits do NOT re-format existing rows (date tokens would lose the original creation date). |\n\n<!-- generated:end field-autonumber -->\n\n<!-- generated:start rules-field -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `field.default` | A default names options its select declares \u2014 one on a single select \u2014 and a date stamped by `derive_from` states none. |\n| `field.default-from` | A field\'s `default_from` reads `<link>.<field>` off the row a one-row link of its entity names \u2014 a link no copy fills \u2014 into a field of the same type, date format and notation that `derive_from` does not stamp: a lookup only through a one-row link, a link only into one to the same entity, a select\'s option as this field\'s of the same alias (one it lacks is not copied), several values only into a field holding several. The server copies it on every add that fills the link and leaves the field empty, so an add sure to fill the link \u2014 a required one, or the record it files the row under \u2014 does not ask it by default. |\n| `field.writes` | A stored field\'s `writes: false` says no person keys it in an app \u2014 a workflow or an integration writes it: every app draws it read, no add (`create`) or act asks it and no paper fills it, and a required one takes a `default` or a `default_from` where an app adds its rows; never on a date `derive_from` stamps, which is read already. |\n| `field.option-mark` | An option\'s `mark` is one the kit draws, and a select\'s options mark every one or none. |\n| `field.unit-select` | A notation\'s `per_row` names a single select of the same row, or a lookup of one through a one-link, whose every option label is a unit, or an ISO 4217 code. |\n| `field.link` | A link targets a declared entity: its `display_field_alias` a field of it, its `paired_field_alias` a link on it naming this one back \u2014 and of two paired links at most one reads one row. |\n| `field.formula` | A formula parses, reads fields of its own entity by alias, names an option as `{field:option}` of one a select declares, and compares a select to its options\' keys, never their words. |\n| `field.formula-type` | A formula yields what it states \u2014 its `output_type`, else a figure where it states a `notation` and text where it states `link` \u2014 as the platform infers it from the expression when the field is created. |\n| `field.rollup` | A rollup aggregates, through a link of its entity, a field of the linked entity by an operation a model declares and that field\'s type takes \u2014 never a figure read in each row\'s own unit or currency \u2014 filtered on fields of the linked entity. |\n| `field.lookup` | A lookup reads, through a link of its entity, a field of the linked entity \u2014 never one read in each row\'s own unit or currency \u2014 ordered by a field of it. |\n| `field.computed-cycle` | Computed fields never wait on each other in a loop: each is computed after what it reads. |\n\n<!-- generated:end rules-field -->\n\n## Views\n\nSaved views live under the entity they belong to. Every field reference is a\nfield ALIAS on that entity.\n\n<!-- generated:start views -->\n\n#### View\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | yes | Stable view alias, unique within the entity |\n| `label` | text | yes | Display name of the view |\n| `description` | text | no | The view\'s description, written onto the view in the workspace |\n| `columns` | list of [View column](#view-column) (at least one) | no | The columns the view shows, in this order and no others; absent, every field |\n| `filters` | [filter](#views) | no | The rows the view keeps |\n| `sort` | [sort](#views) | no | The order the view reads its rows in |\n| `summary` | map of text \u2192 text | no | Field alias \u2192 the operation its footer cell states |\n| `frozen_columns` | integer \\| `null` | no | How many leading columns stay in place while the rest scroll |\n\n#### View column\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field_alias` | alias | yes | A field of this entity |\n| `visibility` | `"visible"` \\| `"hidden"` | yes | Field visibility state: \'visible\' = shown to everyone, \'hidden\' = not shown by default but members can toggle |\n| `width` | number | no | The column\'s width, in pixels |\n\n<!-- generated:end views -->\n\nA filter is a group \u2014 `{ "node_type": "group", "logic": "and" | "or",\n"children": [ \u2026 ] }` \u2014 or one condition on its own, `{ "node_type":\n"condition", "type": "select", "field_key": "tier", "operator": "has_any_of",\n"value": ["gold"] }`. A sort is a list of `{ "field_key": \u2026, "order": "asc" |\n"desc" | null }`. A condition\'s `type` is the field\'s type and its `operator` is\none that type admits \u2014 `has_any_of` / `has_none_of` / `has_all_of` / `is_empty` /\n`is_not_empty` for a select, `equals` / `greater_than` / `less_than` for a\nnumber, `on` / `before` / `after` / `between` for a date, `contains` /\n`is_any_of` for text. A select condition\'s `value` names option ALIASES.\n\n<!-- generated:start rules-view -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `view.fields` | A view\'s columns, summary, sort and filters name fields of its entity. |\n\n<!-- generated:end rules-view -->\n\n## Roles\n\nA role becomes a workspace group.\n\n<!-- generated:start roles -->\n\n#### Role\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | yes | Stable role alias, bound to a workspace group when the model is applied |\n| `label` | text | yes | The group\'s name in the workspace |\n\n<!-- generated:end roles -->\n\n## Templates\n\nAn `html` or `email` template carries its content inline, and `{{name}}` in it is filled\nfrom the workflow\'s data; an `excel` template names an uploaded workbook by its `file_id`,\nfilled with the register\'s report by its `export` alone.\n\nInline content is refused where it holds a script, a frame, a `<link>`, an inline event handler or a\n`javascript:` URL; an `html` one may be a fragment, kept as written and printed as a whole document. An apply brings a\ntemplate it made before to the content the model states, and leaves one it adopted by its label as\nits owner wrote it.\n\n<!-- generated:start templates -->\n\n#### Template\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `type` | `"html"` \\| `"email"` \\| `"excel"` | yes | html is a page a workflow renders to a PDF; email is a message a workflow sends; excel is a workbook a register\'s export fills |\n| `alias` | alias | yes | Stable template alias, unique within the contract |\n| `label` | text | yes | The template\'s name in the workspace |\n\n<!-- generated:end templates -->\n\n### `html` and `email`\n\n<!-- generated:start template-inline -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `content` | text | yes | Inline template content; placeholders reference field aliases |\n| `content_sha256` | text | no | sha256 (64-char lowercase hex) of the utf-8 content; derived where the template is written when absent |\n| `locale` | `"vi"` \\| `"en"` | no | The language its figures, dates and amounts in words print in; absent prints in the organization\'s |\n\n<!-- generated:end template-inline -->\n\n### `excel`\n\n<!-- generated:start template-excel -->\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `file_id` | text | yes | The uploaded .xlsx (`fil_\u2026`) the template is made from; its markers read what the export fills it with |\n\n<!-- generated:end template-excel -->\n\nA paper that has to look like a counterparty produced it \u2014 an official letter,\nan acceptance minute, a supplier\'s bill \u2014 is the same `html` template with a\nshell around the body: a letterhead, a reference line, a seal and a signature\nblock, and paper grain over everything. One shell, many bodies; the data is the\nonly thing that changes, so a workflow can re-issue it over any record.\n\n```jsonc\n{ "alias": "cong_van", "label": "C\xF4ng v\u0103n", "type": "html",\n  "content": "\u2026the page below, as one JSON string\u2026" }\n```\n\n```html\n<style>\n    .sheet{position:relative;width:718px;padding:44px 58px 30px;background:#fbfaf6;color:#111;font:14.2px/1.5 \'Liberation Serif\',serif}\n    .grain{position:absolute;inset:0;opacity:.34;mix-blend-mode:multiply;background:url("data:image/svg+xml;utf8,<svg xmlns=\'http://www.w3.org/2000/svg\' width=\'140\' height=\'140\'><filter id=\'f\'><feTurbulence baseFrequency=\'.9\' numOctaves=\'2\'/><feColorMatrix values=\'0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .35 0\'/></filter><rect width=\'140\' height=\'140\' filter=\'url(%23f)\'/></svg>")}\n    .top{display:flex;text-align:center;font-size:13.4px} .top>div{flex:1} .u{display:inline-block;border-bottom:1px solid #111;font-weight:700}\n    .ref{display:flex;text-align:center;font-size:13.4px;margin-top:6px} .ref>div{flex:1} .ref .r{font-style:italic}\n    h1{text-align:center;font-size:15.6px;margin:26px 0 18px} p{text-align:justify;text-indent:26px;margin:0 0 9px}\n    .sig{display:flex;margin-top:20px} .sig .l{flex:1} .sig .r{width:290px;text-align:center;position:relative}\n    .sig .nm{font-weight:700;margin-top:96px} .seal{position:absolute;left:4px;top:8px;width:166px;height:166px;opacity:.66;mix-blend-mode:multiply;transform:rotate(-17deg)}\n  </style>\n  <div class=\'sheet\'><div class=\'grain\'></div>\n    <div class=\'top\'><div><b>{{issuer_parent}}</b><br><span class=\'u\'>{{issuer}}</span></div>\n      <div><b>C\u1ED8NG H\xD2A X\xC3 H\u1ED8I CH\u1EE6 NGH\u0128A VI\u1EC6T NAM</b><br><span class=\'u\'>\u0110\u1ED9c l\u1EADp - T\u1EF1 do - H\u1EA1nh ph\xFAc</span></div></div>\n    <div class=\'ref\'><div>S\u1ED1: {{number}}</div><div class=\'r\'>{{place}}, ng\xE0y {{day}} th\xE1ng {{month}} n\u0103m {{year}}</div></div>\n    <h1>{{title}}</h1>\n    <p>K\xEDnh g\u1EEDi: {{recipient}}.</p>\n    {{{body}}}\n    <div class=\'sig\'><div class=\'l\'><b>N\u01A1i nh\u1EADn:</b><br>- Nh\u01B0 tr\xEAn;<br>- L\u01B0u VT.</div>\n      <div class=\'r\'><img class=\'seal\' src=\'{{seal_url}}\'><b>{{signer_title}}</b><div class=\'nm\'>{{signer}}</div></div></div>\n  </div>\n```\n\n**What an act\'s template is handed** is its record\'s own fields by alias: a\nselect, a member and a link as their words (a link as the linked row\'s title), a\nnumber, a date and a computed value that declares its kind raw (`2800000`,\n`2026-09-14`) \u2014 never a files field or a computed select. On one record it is\nhanded, too, the rows of each child the record draws as `rows` whose alias the\ntemplate names, listed under that alias for `{{#each <alias>}}` in place of the\nrecord\'s own link to them: every row filed under the record, oldest first, each\nby its own fields as the record\'s are, less its link back to the record. Over\nseveral rows the rows are listed under the entity\'s alias, for\n`{{#each <alias>}}`, without their child rows.\n\nHelpers print a raw value in the template\'s `locale` \u2014 `vi` or `en`, the organization\'s language where it states\nnone; each prints `""` for an empty value:\n\n| Helper | Prints (`vi` / `en`) |\n|---|---|\n| `{{money total "USD"}}` | `1.250,50 US$` / `$1,250.50`, in the currency\'s minor units; no code, a number |\n| `{{number qty}}` | `1.234,5` / `1,234.5`: grouped, up to 2 decimals |\n| `{{date issued_on}}` | `14/09/2026`; a date-fns pattern as the second argument, `{{date at "dd/MM/yyyy HH:mm"}}`, literal text quoted (`"\'Ng\xE0y\' dd"`). A moment prints on the workspace\'s timezone |\n| `{{words total "USD"}}` | `M\u1ED9t ngh\xECn hai tr\u0103m n\u0103m m\u01B0\u01A1i \u0111\xF4 la M\u1EF9 n\u0103m m\u01B0\u01A1i xu` / `One thousand two hundred fifty US dollars and fifty cents`; no code, VND (`\u0111\u1ED3ng`) |\n\nA value it cannot read (`{{money "abc"}}`, `{{date "14/09/2026"}}`) fails the render. A field named like a\nhelper and written alone (`{{number}}`) prints its own value.\n\n## Rows\n\nFirst records, keyed by entity alias. Up to 200 rows per entity and 2000 across\nthe model, attaching at most 2000 documents between them \u2014 a real data set\nbelongs in an import, not a model.\n\n```jsonc\n"rows": {\n  "customer": [\n    { "ref": "acme", "fields": { "name": "Acme Trading", "tier": "gold" } }\n  ]\n}\n```\n\n<!-- generated:start rows -->\n\n#### Row\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `ref` | text | yes | Local handle for this row, referenced by other rows\' link fields |\n| `fields` | map of text \u2192 any value | yes | Field alias \u2192 the value, read against the field\'s declared type |\n\n<!-- generated:end rows -->\n\n<!-- generated:start rules-rows -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `rows.ref` | A row\'s `ref` is unique within its entity. |\n| `rows.required` | A row states every field its entity requires: it is created with what it states, its fields\' defaults and copies unapplied. |\n| `rows.distinct` | Open rows of an entity a register lists read apart: no two state the same title and the same line under it, and an autonumber on the line reads every row apart. |\n| `rows.value` | A row\'s value fits its field: an option alias for a select, `"<entity>:<ref>"` of a row of the linked entity in this file for a link, `"self"` for a member, a relative path beside the file or a `fil_` id for files, a date in the date grammar (an hour only on a datetime), a text, number, yes/no or null otherwise \u2014 and none on a computed field. |\n\n<!-- generated:end rules-rows -->\n\nA `ref` is lowercase letters, digits and underscores, and is never persisted.\n\nA `files` cell attaches documents: paths relative to this file (no `..`, never\nabsolute), which the check proves exist and `apply` uploads into the workspace\nbefore any row is written \u2014 a paperwork business seeds its papers with its\nrows. The server accepts only `fil_` ids of files this workspace owns, which is\nwhat the upload leaves behind. After a run that wrote rows, the WORKSPACE holds\nwhich record each row became, under the row\'s own `<entity>:<ref>`:\n`delete_records` over them is how a seeded set is reset, and applying again\nre-dates it.\n\n`fields` is keyed by field alias, and every value is read against the field\'s\nDECLARED type:\n\n| Field type | Value |\n|---|---|\n| `text` / `number` / `boolean` | the value itself |\n| `date` | `"2026-03-14"`, or a relative expression (below) |\n| `select` | the option ALIAS \u2014 `"gold"`, or `["gold","vip"]` for a multi-select |\n| `select_record_link` | `"<entity-alias>:<ref>"` naming another row in this file \u2014 `"customer:acme"`, or an array for several; a paired link is stated on ONE side (the child\'s link to its parent) and its partner fills itself |\n| `select_member` | `"self"` only \u2014 the person applying the model |\n| `files` | paths beside this file \u2014 `["scans/pccc_letter.png"]` \u2014 uploaded by `model apply`/`setup` before the model is sent; or `fil_` ids of files already in this workspace |\n| `formula`, `rollup`, `lookup`, `autonumber` | not allowed \u2014 the platform writes these |\n\n### Relative dates\n\nA date cell holds a literal `YYYY-MM-DD`, or an expression relative to the day\nthe model is applied, so a screen that opens on "this month" is not empty a month\nlater:\n\n- `@today` \u2014 the day of the run, in the workspace\'s timezone\n- `@month-start` \u2014 the 1st of that month\n- either with a whole-day offset: `@today-14`, `@month-start+9`\n- on a date that holds its hour (`format: "datetime"`), that hour after the day, and always stated:\n  `@today 14:30`, `@today+1 06:00`\n\n`@month-start` exists because `@today-N` cannot promise a month: applied on the\n2nd, `@today-3` lands in the previous one.\n\n## Records\n\n`records` says how a row of each entity is RECOGNISED \u2014 once per entity, keyed by\nentity alias \u2014 and every surface that draws one of its rows reads the same\nstatement: the register\'s row, a picker\'s option, a link\'s chip, a child table\'s\nrow and the record\'s header. Every entity an app lists, opens or picks has one.\n\n```jsonc\n"records": {\n  "visit": {\n    "title": "container_no",\n    "subtitle": ["customer", "arrived_on"],\n    "image": "photos",\n    "status": { "field": "stage", "closed": ["gone"], "history": "visit_history" },\n    "figure": "total_fees",\n    "due": ["free_until"]\n  },\n  // A release order read against what it allows: a meter wherever it shows.\n  "release": { "title": "release_no", "figure": "issued", "limits": { "issued": "units" } },\n  // A dossier\'s stage is the last date it reached \u2014 no stored select.\n  "dossier": { "title": "applicant", "status": { "milestones": ["received_on", { "field": "appraised_on", "when": { "kind": ["loan"] } }, "signed_on"], "closed": ["signed_on"] } },\n  // A site owes a diary page each day it works, from breaking ground through handover.\n  "site": { "title": "name", "cadence": [{ "entity": "diary_page", "on": ["mon", "tue", "wed", "thu", "fri", "sat"], "from": "started", "until": "handed_over" }] }\n}\n```\n\n<!-- generated:start records -->\n\n#### Record\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `title` | alias | yes | The field that names a row \u2014 the first thing every surface shows: who or what it is, a link naming it by the linked row (a job read by its customer). An autonumber is refused; a typed number is the subtitle |\n| `subtitle` | list of alias (1\u20132) | no | Up to two fields read under the title wherever a row is drawn (a code, a date, a party): one line at a desk, wrapping to a second on a phone |\n| `image` | alias | no | A files field that pictures the row \u2014 never one an act keeps the document it makes in |\n| `mark` | alias | no | A single select whose option leads the row wherever a mark leads it \u2014 a list\'s row, the record\'s head, a link naming the row: the option\'s brand, else its colour dot, on a tile. The field stays a field: a subtitle run, a column, a section\'s control. Never beside `image` or `party`, and never the status field |\n| `description` | alias | no | A text field saying what the row is about \u2014 a plan\'s brief, a customer\'s note: read in its record\'s head under the title\'s line, its first lines at rest and whole on a press, and written from the head\'s \u270E. Never on a row\'s line |\n| `party` | `"person"` \\| `"organization"` | no | What each row is where the rows are people (a contact, a patient) or organisations (a customer, a supplier, a carrier); absent, the rows are things (an order, an item, a paper) |\n| `status` | [Status](#status) | no | The stage a row moves through \u2014 a single select or its milestone dates \u2014 drawn as a badge beside its title |\n| `figure` | alias | no | The one number the row stands for, read at its right (a total, a quantity left) |\n| `limits` | map of alias \u2192 (alias \\| number) | no | A number read against a bound \u2014 a field of the same row or a constant \u2014 drawn as a meter wherever it shows |\n| `gates` | map of alias \u2192 (alias \\| number) | no | A pass mark on a meter `limits` bounds \u2014 a field of the same row or a constant; a percent field is its share of the bound, any other number an amount. The meter marks it and fills complete once past it |\n| `tolerance` | map of alias \u2192 number | no | How far past its `limits` bound a meter may stand, in percent of the bound: the bound is an amount expected (received against ordered), not a cap. Without one the bound is a cap, and past it is an overrun |\n| `due` | list of alias (at least one) | no | Dates that are deadlines (stored, or computed as a date): each counts down and turns overdue |\n| `frees` | alias | no | A date ending the row\'s span of days on which what the row holds is free again (a check-out, a hire\'s return): a stay from the 3rd to the 5th holds the 3rd and the 4th, and another may start on the 5th \u2014 on a lanes board, a calendar, a roster and in `no_overlap` alike. Absent, a span of days holds its last day; a span of moments always frees its end |\n| `settled` | alias | no | A yes/no of the row (stored, or a formula: an invoice paid in full) that ends its deadlines: while it is true, no `due` of the row counts down or turns overdue \u2014 in a cell, on its line, in its head, on a calendar or gantt, or in the overdue count. A dashboard\'s or reading\'s `where` reads it as any other yes/no |\n| `task` | `true` | no | A row is work someone finishes: wherever rows of it stand in a table \u2014 a register, a record\'s rows, the rows filed under one \u2014 each is led by a ring ticking it done and unticking it by the one write of the app making that move. Its status is a stored select with `closed` |\n| `cadence` | list of [Cadence](#cadence) (at least one) | no | The rows of a child each row owes one of a day, on the days of the week listed (a site\'s diary page, Monday to Saturday) \u2014 one entry a child, never owed on a day still to come. A roster of these rows over days marks a past day owed with none missing in the danger tone, counted in the legend; today\'s is due, offered to add and never marked; each row\'s total reads the days it holds of those owed |\n| `applies` | map of alias \u2192 map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Fields that apply only while their conditions hold (a length only on a line whose tariff charges by the metre): where one does not apply no add asks it and no surface shows it. Never the title; a required one starts at its `default` |\n| `starts` | map of alias \u2192 `"today"` \\| `"me"` | no | What a field of a row being added starts at, where that start is certain: `today` a date (a moment starts now), `me` a member, the reader adding it; every other field starts empty unless the reader narrowed the register to a value or the field declares a `default` |\n| `scan` | `"text"` \\| `"iso6346"` | no | Its title, a text field, is painted or printed on the thing a row is (a container\'s number, a seal\'s) and read off one photo on a phone, beside each search matching it and each field holding or picking it: `iso6346` a container number, refused unless its check digit holds; `text` as it stands |\n| `place` | [Place](#place) | no | Where a row stands, as plain fields of it, drawn as one place where its record draws the address: how sure it is, a press opening it in the device\'s maps, and one taking it from where the device stands |\n| `plan_place` | [Plan place](#plan-place) | no | Each row is a place on the plan a `plan` register draws: its title the place\'s code, its subtitle a note. A flat list, no tree |\n| `on_site` | [On site](#on-site) | no | Photos taken where a place stands (a site diary\'s): a photo taken through a phone\'s camera here keeps where the device stood, marked at the place, away from it or unknown, and a record holding one taken away says so among its checks \u2014 one with no place (picked on a computer, or kept before places were) is marked and warns nothing; a place reaches only members of the organization, through the apps drawing these photos |\n| `pin` | [Pin](#pin) | no | Each row is a place on a picture (a spot on a container\'s drawing, a room on a plan): a record listing rows that link to these by a single link draws that picture over them, a numbered pin at each listed row\'s place, each row led by its number, the row opened lit on it and a pin pressed opening its row |\n\n#### Cadence\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `entity` | alias | yes | The child entity owed: each of its rows stands on one row of this entity by its single link to it, and on the first date of its line (`records` title or subtitle) |\n| `on` | list of `"mon"` \\| `"tue"` \\| `"wed"` \\| `"thu"` \\| `"fri"` \\| `"sat"` \\| `"sun"` (at least one) | yes | The days of the week one is owed on, each listed \u2014 `mon` to `sun` |\n| `from` | alias | no | A date of this row: the first day one is owed (a site breaking ground, a contract\'s start); absent, no first day |\n| `until` | alias | no | A date of this row: the last day one is owed (a site\'s handover, a contract\'s end); empty or absent, through today |\n\n#### Place\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `address` | alias | yes | A text field: the address, as people write it |\n| `latitude` | alias | yes | A number field: degrees north, negative south |\n| `longitude` | alias | yes | A number field: degrees east, negative west |\n| `accuracy` | alias | no | A number field: how many metres off the device that gave the place said it may be |\n\n#### On site\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `photos` | list of alias (at least one) | yes | Files fields of this row holding photos taken on site |\n| `place` | alias | no | A single link of this row to the row whose `place` its photos are taken at (a diary page\'s site); absent, this row\'s own `place` |\n| `radius` | number | yes | How many metres from the place a photo still counts as taken there |\n\n#### Pin\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `on` | alias | yes | A single link of this row to the row whose picture (its `records` `image`) the place is on \u2014 a container\'s drawing, a floor\'s plan |\n| `x` | alias | yes | A number field of this row: how far across that picture the place stands, in percent from its left edge |\n| `y` | alias | yes | A number field of this row: how far down that picture the place stands, in percent from its top edge |\n\n<!-- generated:end records -->\n\n<!-- generated:start rules-records -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `records.title` | A title names the row by what it is \u2014 never an autonumber; a code is its subtitle, and the subtitle never names the title\'s own field. |\n| `records.image` | `image` is a files field, never one an act keeps the documents it makes in (`into`). |\n| `records.mark` | `mark` is a single select, never the status field, and never beside `image` or `party` \u2014 a list keeps one lead slot \u2014 nor on the folder an app works inside (`scope`), which its switcher names by a picture or its initials. |\n| `records.description` | `description` is a text field, read in the record\'s head \u2014 never a section\'s too. |\n| `records.figure` | A figure is a number. |\n| `records.applies` | `applies` holds a field of the row other than its title to conditions of the same row \u2014 a yes/no (stored or a formula) by `true` or `false`, a single select by its options, its own or looked up through a one-row link \u2014 never to itself; a required field it holds starts at a `default`. |\n| `records.limits` | `limits` bounds a number by a number field of the row, in its unit or one of the same dimension \u2014 or by a constant, where every row reads the figure in one unit. |\n| `records.gates` | `gates` marks a pass on a meter `limits` bounds: a percent field (its share of the bound), another number in the bound\'s unit, or a constant. |\n| `records.tolerance` | `tolerance` stands on a meter `limits` bounds. |\n| `records.starts` | `starts` starts a field a person writes \u2014 `today` a date or a moment (never a span), `me` a member \u2014 and an add that does not ask a field it starts writes that start. |\n| `records.due` | A deadline (`due`) is a date. |\n| `records.frees` | `frees` names a stored day, never a moment: a span of moments already frees its end. |\n| `records.settled` | `settled` names a yes/no of the row (stored, or a formula) beside a `due`: while it holds, the row\'s deadlines neither count down nor turn overdue. |\n| `records.task` | A task entity (`task`) states a `status` of a stored single select with `closed` options \u2014 its ring ticks a row done by moving it to one. |\n| `records.cadence` | A `cadence` names each child once \u2014 its rows standing on one row of this entity by their single link and on the first date of their line \u2014 lists each day of the week once, and `from` and `until` are two different days of this entity. |\n| `records.scan` | A title read off a photo (`scan`) is a text field the row stores. |\n| `records.place` | A `place` names four different fields of the row: its address a text field, its latitude, longitude and accuracy number fields it stores. |\n| `records.on_site` | `on_site` lists files fields of the row, each once, taken at the `place` of the row itself or of the one row a single link of it names (`place`), which states one. |\n| `records.plan_place` | A `plan_place` names `kind`, `sheet` and `reach_from` as single selects, `stacked` as a boolean and the rest as numbers, each a different field; `kind`, `x`, `y` required. `size` names three numbers (`across`, `along`, `up`) stating one cell in one length `unit` alike. |\n| `records.pin` | A `pin` names a single link of the row (`on`) to an entity whose `records` states its `image`, and two different number fields of the row, how far across (`x`) and down (`y`) that picture in percent. |\n| `records.picture` | *Refused until adopted or declined:* Rows an app draws that each hold one files field no act makes, no call is filed into, no files block keeps and no list compares as a pair (`compare`) \u2014 and no figure \u2014 are pictured by it (`image`); where the workspace\'s files are known, the field holding images is the picture, a figure or not. |\n\n<!-- generated:end rules-records -->\n\n- **The title names the row** by who or what it is \u2014 a link by the linked row (a job\n  read by its customer). An autonumber is refused as a title; a typed number is the\n  subtitle.\n- **One lead per row.** A row leads with its picture (`image`), a face (`party`) or the\n  option of a single select it holds (`mark`) \u2014 never two. A `mark` draws that option\n  on a tile: the brand it is, else its colour dot; a row holding none, a ring saying\n  none is picked. The same tile heads the row\'s record and leads it where a link\n  names it; the select stays a field \u2014 a subtitle run, a column, a section\'s control.\n- **A limit** reads a number against a bound \u2014 another field of the row, or a constant.\n  A `gates` entry marks a pass on that meter: a percent field is its share of the\n  bound, any other number an amount.\n- **A deadline** (`due`) counts down wherever it is drawn and is overdue once past while\n  the work is open. A register over the entity says how many rows in view are overdue on\n  its summary line, and pressing that count narrows to them \u2014 no reading to state.\n- **A span\'s free day** (`frees`) is the end date on which what the row held is free\n  again \u2014 a check-out, a hire\'s return. A stay from the 3rd to the 5th holds two nights:\n  a lanes board, a calendar and a roster draw it through the 4th, and `no_overlap` lets\n  the next stay start on the 5th. Without it a span of days holds its last day; a span of\n  moments always ends as the next may begin.\n- **`starts`** is where an add\'s field begins, stated only where that is certain \u2014 a\n  log\'s own day at `today`, a request\'s requester at `me`. Nothing else starts a field\n  but its declared `default` and what the reader narrowed the register to.\n\n## Status\n\nA record\'s `status` is the stage a row moves through \u2014 a stored single select, or the\nmilestone dates it reaches \u2014 drawn as a badge beside its title wherever the row is.\n\n<!-- generated:start status -->\n\n#### Status\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field` | alias | no | The single select that is the row\'s state \u2014 or `milestones` instead |\n| `milestones` | list of (alias \\| [Milestone](#milestone)) (at least 2) | no | Dates in the order the work reaches them, instead of a stored select: the stage is the last one filled, ticking one stamps today, and clearing one clears every later one |\n| `closed` | list of alias (at least one) | no | Options (or milestones) that end the work: a register opens on the rows not at them, and the badge reads muted |\n| `history` | alias | no | A child entity every status change appends one row to (its link to this entity, the new status, the moment and who) \u2014 written by the app\'s own writes, never a table automation; a row the model seeds opens it at its status, the day the rows land, unless the model states its rows; with `field` only |\n| `stages` | map of alias \u2192 [Stage](#stage) | no | Option alias \u2192 who owns that stage and how long it should take: the owner alone presses the acts offered there, refused on the server for anyone else. The status then moves only by acts that `set` one of its options \u2014 no save writes it and no act asks it; with `field` only |\n\n#### Milestone\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field` | alias | yes | A date field: the stage is reached on the day it holds |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | yes | The stage applies only while each named select holds one of these options, and each named stored yes/no is this value; otherwise the row skips it |\n\n#### Stage\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `owner` | text \\| [Stage role](#stage-role) | yes | Who owns the stage: a member field of the row, `link.field` read through a one-row link, or `{ role }` \u2014 a group |\n| `within` | integer | no | Whole days the stage should take from the moment the row entered it |\n\n#### Stage role\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `role` | alias | yes | A role of the model\'s `roles`: every member of the group it binds to owns the stage |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `records.status` | A status is one single select, `closed` naming options of it \u2014 or its `milestones`. |\n| `records.history` | A declared status `history` has exactly one link to the row it records, one single select holding every option of the status (or a text), exactly one date and at most one member. |\n| `records.history-derived` | A `history` the model does not declare is derived and keeps one entity\'s moves, labelled by that entity ("L\u1ECBch s\u1EED <entity label>", or "<entity label> history"): no declared table holds that label, and the entity has no other field under the link it adds. |\n| `records.history-scope` | A status history reads by its record\'s `read_scope`, answered through its one-row link to the record within the links a row rule reaches \u2014 or it states its own. |\n| `records.milestones` | Milestones are dates a person ticks, each named once; `closed` names some of them, and a deadline (`due`) is never one. |\n| `records.milestone-add` | An add asks the first milestone at most \u2014 each after it is ticked in order. |\n| `records.stages` | A stage\'s owner (`status.stages`) is a single member field of the row, one read through a one-row link, or a declared role, on an option that does not end the work; a role\'s stage needs the status `history` with who moved the row. A status with stages moves only by acts that `set` one of its options \u2014 no save writes it, and no act asks it, sets it otherwise or writes it from a workflow \u2014 and the moment its row entered its stage is kept in `<status>_since`, derived beside it, which nothing else writes. |\n| `records.history-note` | *Noted, never refused:* A record, never a task, whose stored status an act of its app moves, with no `history`: when a row entered each status and who moved it is kept nowhere. |\n| `records.detour-note` | *Noted, never refused:* A stage the work only steps aside into \u2014 not where a row starts, entered from one step alone that also moves the work on without it, and left by its own moves only back to that step (a pause, a repair) \u2014 is a detour: its option and the section staged at it stand before that step\'s, else the work reads it as its next step, and the act moving the work into it leads that section \u2014 never a correction waiting in a \u22EF. |\n\n<!-- generated:end status -->\n\n- **The status** is one single select. `closed` options end the work: a register opens\n  on the rows not in them. A `history` entity gets one row per move \u2014 its link to this\n  entity, the new status (a select holding the same option aliases, or text), the\n  moment and who \u2014 appended by the app\'s own writes that move the status, never by a\n  table automation. A `history` the model does not declare is derived, and needs no\n  `records` entry of its own.\n- **Milestones** are the alternative to a stored select: dates in the order the work\n  reaches them, the stage being the last one filled (never stored). A milestone with a\n  `when` applies only while its select holds those options and its stored yes/no that\n  value; otherwise the row skips it.\n  The record draws them as one block where ticking stamps today and clearing one clears\n  every later one; every save and act re-checks that a date comes after each earlier one\n  that applies. `closed` names the milestones that end the work. A register\'s add may ask\n  the first milestone, never a later one; an act may stamp one, never clear it.\n\n## Write rules\n\n`write_rules` is what a WRITE meets, keyed by entity alias; each entity\'s is held\nby its table. Every generated write of an\napp (`create_<entity>`, `update_<entity>`, each act) re-checks these on the\nserver; the screen only mirrors them.\n\n```jsonc\n"write_rules": {\n  // A customer is RECOGNISED by their address. An add that names one \u2014 from the\n  // customers register or from a picker\'s "new" \u2014 reuses the row it matches and\n  // opens one only where nothing does, so the book never grows a second Acme.\n  "customer": { "natural_key": ["email"] },\n  "order_line": {\n    "fields": {\n      // A line of nothing is not a line. Refused on create and on update.\n      "quantity": { "min": 1, "max": 9999 },\n      // Shipped inside its order\'s window: a bound read off the row a link names\n      // is held from both sides \u2014 moving the order\'s dates never strands a line.\n      "ships_on": { "min": "order.placed_on", "max": "order.due_on" },\n      // Nothing is sold off an empty shelf. The picker reads only the rows that\n      // answer this, and the write refuses the same rows again.\n      "product": {\n        "options_where": {\n          "node_type": "group", "logic": "and",\n          "children": [{ "node_type": "condition", "type": "number",\n                         "field_key": "in_stock", "operator": "greater_than", "value": 0 }]\n        }\n      }\n    }\n  },\n  // One booking per room at a time, while it is held: a create or a save whose\n  // span overlaps another held booking of the same room is refused.\n  "booking": {\n    "fields": { "ends_on": { "min": "starts_on" } },\n    "no_overlap": { "from": "starts_on", "to": "ends_on", "by": ["room"], "while": { "state": ["held"] } }\n  }\n}\n```\n\n<!-- generated:start write-rules -->\n\n#### Entity write rules\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `natural_key` | list of alias (at least one) | no | The field aliases a row of this entity is RECOGNISED by. A write that names a row of this entity by these values reuses the row it finds, minting one only where nothing matches. |\n| `fields` | map of alias \u2192 [Field write rule](#field-write-rule) | no | Field alias \u2192 what that field\'s value is bounded by or picked among |\n| `no_overlap` | [No overlap](#no-overlap) | no | No two rows hold overlapping spans \u2014 a create or update that would is refused |\n\n#### Field write rule\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `min` | number \\| text | no | Refuse a create or update whose value is below this: a constant for a number, or a field \u2014 `<field alias>` of the same row, or `<link alias>.<field alias>` of the one row a link names \u2014 of the same type (a return date after the departure, a line\'s day inside its trip). On a figure whose unit or currency is per row (its notation\'s `per_row`) a constant bound is only 0; bound it by a field of the row |\n| `max` | number \\| text | no | Refuse a create or update whose value is above this: a constant for a number, or a field of the same row or of the one row a link names |\n| `options_where` | [filter](#views) | no | Which rows of the target this link may point at \u2014 an `and` group of plain conditions over the TARGET entity\'s own fields, each `field_key` a field alias. It narrows the picker\'s read and is refused again where the write lands. |\n| `same` | list of alias (at least one) | no | One-row links this row and each row this link points at must name alike \u2014 a fee\'s invoice is one of its own visit\'s, a box\'s seal one of its own shipping line\'s: each a one-row link of both entities to the same entity. It narrows the picker\'s read to the rows naming what this row names, a row made from the picker names it too (set, never asked), and a write is refused wherever it lands \u2014 on the link, or on what the two rows compare. |\n| `suggest` | text | no | A text field whose control offers, as the reader types, the distinct values a text field of a catalog holds \u2014 `<entity alias>.<field alias>` (a damage position\'s code among the codes on file); any text is still written |\n\n#### No overlap\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `from` | alias | yes | The stored date (or datetime) a row\'s span starts on |\n| `to` | alias | yes | The stored date (or datetime) a row\'s span ends on \u2014 a day it holds, unless `records` names it the day the row `frees`; a moment another row may start at |\n| `by` | list of alias (at least one) | no | Fields two rows share to compete for a span (the same employee, the same room); absent, every row |\n| `while` | map of alias \u2192 list of alias (at least one) | no | Only rows at these options of these selects hold their span (running, not closed); absent, every row |\n\n<!-- generated:end write-rules -->\n\n<!-- generated:start rules-write -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `write.natural-key` | A `natural_key` is text or a number a person types back, or a one-row link; a text key is unique \u2014 `unique: true`, or the key\'s fields as a set in the entity\'s `unique`. |\n| `write.bounds` | `min` and `max` bound a number or a date \u2014 by a constant a number, by a field of this row or of the one row a one-row link names either, of the same type and unit, never by itself \u2014 and `min` is never above `max`. |\n| `write.bound-per-row-unit` | On a figure whose unit or currency is the row\'s own (its notation\'s `per_row`) a constant bound is only 0 \u2014 bound it by a field of the row. |\n| `write.suggest` | `suggest` stands on a stored text field and names `<entity>.<field>`, a stored text field of a declared entity; the app reads that entity, so it has a `records` entry. |\n| `write.same` | `same` stands on a link and names one-row links this entity and the link\'s target both hold to one entity. |\n| `write.options-where` | `options_where` narrows a link by an `and` group of plain conditions over the target\'s own fields \u2014 a number compared in one unit on every row, a select by options it declares. |\n| `write.no-overlap` | `no_overlap` spans two date fields; `by` names values rows share \u2014 a link, a person, one option, a text or a number; `while` names single selects by their options. |\n\n<!-- generated:end rules-write -->\n\n- A `natural_key` is `text` or `number`, because a person types it back, or a\n  one-row link, because a row is also recognised by the one row it belongs with (a\n  fee by its visit and its kind). A key holding a `text` field is unique: `unique:\n  true` on that field, or the key\'s fields as a set in the entity\'s `unique` (a\n  site by its customer and its name) \u2014 two rows sharing it would make\n  find-or-create pick whichever the read answered first. An add asks the key by\n  default.\n- A `min` or `max` naming a field is read off the row as the save would leave it,\n  and one naming `<link>.<field>` off the row the link names \u2014 the link\'s side\n  re-checks its own rows when that bound moves.\n- A `same` link names only rows that name what this row names \u2014 a fee\'s invoice\n  is one of its own visit\'s \u2014 through a one-row link both entities hold to one\n  entity; its picker offers nothing until the row names one. A row added under a\n  record names what it copies off it (`default_from`) from the start, so a block\n  expecting one line per row of the link lists that record\'s rows alone. A save\n  moving what the two compare, on either row, is refused while they would name apart.\n- An `options_where` link may be left empty; a row it names is refused again\n  where the write lands unless it holds the narrowing. A link naming one kind of\n  a book\'s rows (a "Shipping line" among the parties) narrows to that kind, or\n  its picker offers every row.\n\nA field\'s own `required` is not here: the contract carries it, and every write\npath refuses the row by field name from it. `unique` is the text field\'s own\nclause (\xA7 `text`) \u2014 an add says so at the control before the column does. A\nfield the workspace writes (a formula, a rollup, a lookup, an autonumber, a date\nwith `derive_from`) is never asked, written or edited.\n\n## Apps\n\nAn app is ONE working register over one entity and the record each row opens, with the\nlogs that stand beside it (`logs`) \u2014 or a dashboard of readings. The author states COMPOSITION \u2014 which fields go where; the runtime owns\nhow each thing looks, one treatment per concept. Nothing is drawn that the app does not\nname, and each fact appears once on a record. What the vocabulary has no word for is an\nact\'s own `workflow`, or a workflow the app declares beside its acts (`workflows`).\n\n```jsonc\n"apps": [{\n  "alias": "gate", "name": "Gate in and out", "entity": "visit",\n  "register": { "columns": ["service"], "filters": ["customer", "service"] },\n  "record": {\n    "sections": [\n      { "title": "In", "fields": ["customer", "service"], "blocks": [{ "rows": "fee", "columns": ["amount"] }] },\n      { "title": "Out", "at": ["in_yard"], "fields": ["release", "seal"], "blocks": [{ "files": ["photos"] }], "acts": ["gate_out"] }\n    ]\n  },\n  "acts": [{ "alias": "gate_out", "label": "Gate out", "when": { "stage": ["in_yard"] },\n             "requires": ["release", "seal"], "set": { "stage": "gone", "left_on": "now" }, "confirm": true }],\n  "checks": [{ "field": "unpaid", "blocks": ["gate_out"] }]\n}]\n```\n\nThe keys below are the app\'s own. Each part it composes is a page of its own: `model/logs`, `model/workflows`, `model/queries`, `model/register`,\n`model/layouts`, `model/tabs`, `model/export`, `model/readings`, `model/averages-and-bands`, `model/dashboards`, `model/record-page`,\n`model/blocks`, `model/composed-page`, `model/publish-desk`, `model/timeline-and-agenda`, `model/statements`, `model/reading-blocks`, `model/list-block`, `model/tasks`, `model/acts`,\n`model/papers-and-recordings`, `model/checks`.\n\n<!-- generated:start apps -->\n\n#### App\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | yes | The app\'s name within the model \u2014 what `--from model.json#<alias>` picks |\n| `name` | text | yes | The job, in the words of the people who do it |\n| `description` | text | no | What the job is for, in a sentence |\n| `icon` | text | no | A lucide icon name the launcher tile draws |\n| `theme` | [Theme](#theme) | no | The launcher tile\'s colour |\n| `entity` | alias | yes | The entity whose rows this job works \u2014 the register\'s rows |\n| `books` | list of [Book](#book) (at least one) | no | Other entities the register reads as one list with `entity`\'s rows, each opened, edited and acted on in its own table: the same app over each, its fields lined up with `entity`\'s. Only a table, cards or a plan |\n| `scope` | alias | no | A required one-row link of the entity: the app works inside one row of the linked entity at a time (a project, a branch), picked from a list of them, and every row it reads, counts and adds is that row\'s |\n| `reads` | `"shared"` | no | Every member reads every row, whatever the entity\'s read scope |\n| `writes` | `"children"` \\| `false` | no | `children`: the reader adds and edits the record\'s child rows but not the record\'s own fields. `false`: the reader adds, edits and deletes nothing in the app \u2014 no add, no save, no Delete. Either way the app\'s acts still move a record |\n| `row` | [Row display](#row-display) | no | How this job reads the entity\'s rows where it reads them otherwise than `records` (a cashier\'s figure is what is owed): the subtitle, figure and image stated replace the entity\'s wherever this app draws its rows \u2014 the register, a card, the record\'s header, a calendar, lane or roster entry. The title stays the entity\'s |\n| `register` | [Register](#register) | no | The rows: which columns and filters, the order, how a row is added |\n| `record` | [Record page](#record-page) | no | What a row opens: the door, its sections, and the Activity its head opens \u2014 its saves, and its comments where stated |\n| `acts` | list of [Act](#act) | no | What the reader does to a record \u2014 each a press with its conditions and its write |\n| `checks` | list of [Check](#check) | no | Formulas that warn while they stand, or refuse the acts and saves they name |\n| `logs` | list of [Log](#log) (1\u20133) | no | The lists that stand beside the app\'s register, at most 3: each over another entity, read as a log of what was brought into the register\'s rows or done to them (the files imported, the runs of a batch), with the page a row of it opens. Each is one more entry among the app\'s lists, picked on the line under the title beside the register\'s own rows and counting its rows at an open option of its stored status, and opens as a register of its own inside this app \u2014 its reads, acts and workflows the app\'s. Only the organization\'s own members are shown a log and may read or act on it: a visitor through a public link, and a member of another organization, is not. `reads: "shared"` lifts no row rule of an entity only a log reads. Each list keeps its own records\' activity (`record.activity`). No other app\'s link and no dashboard list opens a row in a log. Never over an entity whose status states owned `stages`; never in an app that states `scope` |\n| `workflows` | map of alias \u2192 [Workflow](#workflow) | no | Workflows of the app no act runs, by alias \u2014 called through the app (`run_app_workflow`, its API) by an agent or a service: each states what it takes and hands back, and its body is set on the app (`set_app_workflow`) and kept by every apply. The screen draws nothing for one |\n| `queries` | map of alias \u2192 [Query](#query) | no | Reads of the app no screen draws, by alias \u2014 called through the app (`run_app_query`, its API) by an agent or a service: each states the rows it reads, what narrows them and what a call may state. The screen draws nothing for one |\n| `declines` | map of text \u2192 text | no | Decided rules this app stays outside of, each with why in a line: by id, and `records.picture:<entity>` and `model.template-act:<template>` with what they fire on. Read by the apply\'s check alone, never by the app |\n\n#### Theme\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `color` | [colour](#select) | yes | The tile\'s colour |\n\n#### Row display\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `subtitle` | list of alias (1\u20132) | no | Up to two fields read under the title in this app, in place of the entity\'s |\n| `figure` | alias | no | The one number a row stands for in this app, in place of the entity\'s; a `limits` bound on it reads as its meter |\n| `image` | alias | no | A files field that pictures a row in this app, in place of the entity\'s |\n\n#### Book\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `entity` | alias | yes | Another entity whose rows the register reads beside its own \u2014 the same job over another table (a legacy ledger, a second branch\'s book) |\n| `fields` | map of alias \u2192 alias | no | A field of the app\'s entity \u2192 the field of this entity holding the same fact, where their aliases differ; a field the app reads lines up by its own alias otherwise, and one this entity lacks is blank on its rows and drops from what they open \u2014 an act, check or add needing it is not offered on them. Options line up by alias |\n\n<!-- generated:end apps -->\n\n<!-- generated:start rules-app -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `app.alias-unique` | An app\'s alias is unique among the model\'s apps, and an act\'s among its app\'s acts. |\n| `app.icon` | An app\'s `icon` is a Lucide icon name in kebab-case, as `receipt` or `trending-up` are. |\n| `app.records-entry` | Every entity an app lists, opens or picks \u2014 its own, a block\'s, a linked row\'s, a document\'s \u2014 has a `records` entry. |\n| `app.reads-shared` | `reads: "shared"` stands only where a table the app\'s register or its record reads states a `read_scope` \u2014 a table only a log reads keeps its rule. |\n| `app.writes-children` | An app that writes only the record\'s children (`writes: "children"`) adds no row of its own entity. |\n| `app.writes-none` | An app that writes nothing (`writes: false`) adds no row, so neither its register nor a block states a `create` list, and no block stands its lines `under` a document a person makes. |\n| `app.scope` | `scope` is a required one-row link of the app\'s entity, the same on every row the app lists \u2014 never a column, filter, search field, group, `where`, `opens`, section field or add question. |\n| `app.when` | A `when` holds single selects to options and yes/nos to `true` or `false`, stored or a formula of one (a formula with `options` is a select) \u2014 a milestone\'s `when` only a stored select or yes/no, read before any formula over it is computed. |\n| `app.asked-written` | What an add, an act or `starts` fills is a field a person writes \u2014 never a formula, rollup, lookup, autonumber or a date the workspace stamps. |\n| `app.own-rows` | A many-link to rows that each belong to one row of this entity is never a section\'s field, an add\'s question or an act\'s ask: those rows are the record\'s own, read as a `rows` block. |\n| `app.create-asks` | An add asks fields of a table people write \u2014 never the link or the folder it files the row under, which the add sets itself. |\n| `app.create-required` | An add (`create`) asks every field its entity requires that nothing else fills \u2014 a `default`, `starts`, the record or folder it files the row under, or a `default_from` over a link it fills \u2014 or the server refuses every add. |\n| `app.books` | A register app\'s `books` each name another entity once \u2014 never the app\'s own \u2014 whose fields line up with the app\'s by alias, else by `fields` (a field the app reads, or one a report prints \u2192 one of the book\'s): read as one column type (a day apart from a moment), one value or several alike, a link to the same entity. Each book holds the title, the status, the folder (`scope`), what `where` keeps and every check locking the rows; the register is a table, cards or a plan, whose `at`, `across` and `up` line up like any field. Two books holding a field of their own under one alias hold it as one kind of value. A report\'s `books` each name the app\'s entity or one of its books, once, and one of them holds each field its `where` and `per` narrow by. `register.book` reads a register that has books. |\n| `app.book-option-kin` | *Noted, never refused:* A book\'s option labelled as one of the app\'s, under another alias, reads apart from it: the register lists both and counts each on its own. |\n| `app.book-lacks` | *Noted, never refused:* A book lacking a field the app\'s record, an act or an add reads: what reads it drops from the book\'s rows \u2014 an act, a block, a section, the add. A field only a report prints, held by a book as another kind of value, prints blank on its rows. |\n| `app.rates-in-passing` | *Noted, never refused:* An app with no act of its own whose rows another app\'s lines copy a number off (`default_from` through a link) \u2014 the rates a quote is priced from \u2014 is worked only while that record is written: a block, a section or an act of that app, never an app of its own. |\n| `app.row` | An app\'s `row` states only what differs from `records`: a line that is not the title, a number for its figure, a files picture no act makes documents into. |\n| `app.files-shown` | Every files field is drawn by some app over its entity \u2014 a section\'s `fields`, a `files` block, a column, the `image`, or where an act making its papers into it (`into`) stands, a section naming the act: the made paper reads under the act, one per template. A files field no app should draw is left out of the model: the apply takes it off its table where no row holds a file in it and nothing reads it. |\n| `app.tasks` | *Noted, never refused:* A task entity an app lists whose rows no write of the app moves to a closed option (its ring stands disabled), or that an act ticks done and none moves back. |\n| `app.declines` | `declines` names decided rules that fire on the app, each with why the app stays as it is: by id, and `records.picture:<entity>` and `model.template-act:<template>`, said once per entity and per template, with what they fire on. |\n\n<!-- generated:end rules-app -->\n\n`writes: "children"` is a desk that adds and edits a record\'s child rows and never\nthe record itself; `writes: false` is a desk that reads \u2014 it adds, edits and deletes\nno row, its logs\' included, and only its acts write. `reads: "shared"` lifts every read scope the app\'s tables state \u2014\nrefused where none of them states one.\n\n`scope` names a required one-row link of the entity: the app works inside ONE row of\nthe linked entity at a time \u2014 a project, a branch, a season. With no folder remembered\nit opens on the list of them, each with how many of the app\'s rows it holds; inside,\nevery read, count and reading narrows to that one, an add files its row under it,\nand the record states its folder in the header. A scope narrows\nthe view; who may read what stays the entity\'s `read_scope`. The folder link is never a\ncolumn, a filter, a search field, a fact or an add\'s question.\n\nAn app whose job reads its rows otherwise than the entity\'s `records` restates them in\nits own `row` \u2014 the cashier\'s figure is what is still owed, its line the service and the\nday. The subtitle, figure and image it states replace the entity\'s wherever that app\ndraws a row of it; every other app reads `records`, and the title is the entity\'s.\n\n### Declines\n\nA rule the check marks *Refused until adopted or declined* is a treatment the apply requires unless the app\ndeclines it. The apply refuses an app missing one and hands it a patch stating it: merge the patch, or state in the app\'s `declines`\nwhy the app stays as it is, under the key the finding names \u2014 the rule\'s id, or `records.picture:<entity>` and\n`model.template-act:<template>` with what they fire on. A decline naming a rule that is not decided, or one no\nrows of the model could fire, is refused. Only the apply\'s check reads `declines`; the app never does. Which\ntreatment each rule stands for: the `design` reference.\n\n```jsonc\n"declines": { "register.span": "The yard plans by the day each hire is due back, never by its run of days" }\n```\n\n## Logs\n\n`logs` are the lists that stand beside the app\'s register: each over another entity, read as a log\nof what was brought into the register\'s rows or done to them \u2014 a supplier\'s price lists imported\ninto a catalogue of parts, the runs of a nightly batch \u2014 with the page a row of it opens. Here a\nline names its part by an optional one-row link, so a held line\'s part is picked where the line\nstands, and its old price is read against its new one.\n\n```jsonc\n"apps": [{\n  "alias": "catalogue", "name": "Catalogue", "entity": "part",\n  "register": { "columns": ["price"], "search": ["name", "code"] },\n  "logs": [{\n    "alias": "price_lists", "name": "Price lists", "entity": "price_list",\n    "register": { "columns": ["read", "changed", "held"], "create": false, "remove": false },\n    "record": { "door": "page", "sections": [\n      { "title": "Held", "blocks": [{ "rows": "list_line", "where": { "outcome": ["held"] }, "columns": ["part", "why"],\n          "compare": { "before": "old_price", "after": "new_price" }, "edits": ["part", "new_price"], "create": false }] },\n      { "title": "Written", "blocks": [{ "rows": "list_line", "where": { "outcome": ["changed", "applied"] },\n          "columns": ["part"], "compare": { "before": "old_price", "after": "new_price" }, "create": false }] }\n    ] },\n    "acts": [{ "alias": "apply_line", "label": "Apply", "of": "list_line", "when": { "outcome": ["held"] },\n               "requires": ["part", "new_price"], "set": { "outcome": "applied" } }]\n  }]\n}]\n```\n\nEach log is one more entry among the app\'s lists, picked on the line under the title (folding into one picker where its line cannot seat it), after one entry for the working register\'s own\nrows under the entity\'s label \u2014 counting the log\'s rows at an open option of its stored status; a log\nwhose entity states no status with `closed` options says no number, and a row holding no\nstatus is not counted. Picking the entry opens the log as a register of its own inside the\napp: its own columns, filters, search, order, add and pages, each row opening its own\nrecord with its sections, blocks and acts. Its reads, acts and workflows are the app\'s \u2014\none launcher tile, one roster.\n\n**Who reads a log.** The organization\'s own members, alone. A visitor through the app\'s\npublic link, and a member of another organization, is shown no entry for it, no address\nof it and no way into its rows, and its reads and acts are refused them. `reads: "shared"`\nis the app\'s statement of what its register and its record read: an entity only a log\nreads keeps its `read_scope`. Each list keeps its own records\' activity (`record.activity`)\n\u2014 a register stating `activity: false` shows none though a log keeps its own. A row of a\nlog opens from its own app: no other app\'s link, and no dashboard `list`, opens one there.\nThe designer\'s notes and decisions judge the app\'s register, never a log.\n\n**A log, or another app.** Decide it from the job. A list is a log of this register where\nits rows are what happened TO the register\'s rows \u2014 a file brought in, a batch run, a sync \u2014\nand are read by the same people in passing, to see what changed and to settle what could\nnot be placed. A list people work every day as a desk of their own \u2014 its own queue, its own\ndeadlines, its own people \u2014 is another app\'s register: a second working register is always\nanother app. The limits keep the difference:\n\n- at most three logs to an app, and none beside `scope`: a log reads every row of its entity;\n- a log is one list \u2014 a table or cards, no `tabs`, no `book` column, no `compose` \u2014 and\n  states only its `alias`, `name`, `entity`, `register`, `record`, `acts` and `checks`;\n- its entity is never the app\'s own, one of its `books`\' or another log\'s, and never one\n  whose status states owned `stages`: the rows waiting on a member are read off registers;\n- an act\'s alias is its own among the app\'s acts and its logs\';\n- no record of the app lists the rows of an entity another of its lists is over: a link to\n  one of them opens it on its own list.\n\nA log\'s own rows are usually a claim of what the system did: state `writes: false` on the\nfields a workflow fills, `"create": false` and `"remove": false` on its register, and let\nits lines \u2014 which people do settle \u2014 be written in place (`edits`) and by their acts. An\napp stating `writes: false` writes none of its logs\' rows either: there, only acts write.\n\n<!-- generated:start apps-logs -->\n\n#### Log\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | yes | The log\'s name within the app \u2014 its place in the app\'s address, and unique among the app\'s logs |\n| `name` | text | yes | What the people who read the log call it, as its entry among the app\'s lists reads |\n| `entity` | alias | yes | The entity whose rows the log lists \u2014 never the app\'s own, one of its `books`\' or another log\'s |\n| `register` | [Register](#register) | no | The log\'s rows: which columns and filters, the order, how a row is added \u2014 a table or cards, with no `tabs` |\n| `record` | [Record page](#record-page) | no | What a row of the log opens: the door, its sections, and the Activity its head opens |\n| `acts` | list of [Act](#act) | no | What the reader does to a row of the log or to a child row its record lists \u2014 each alias unique among the app\'s acts and its logs\' |\n| `checks` | list of [Check](#check) | no | Formulas of the log\'s rows that warn while they stand, or refuse the acts and saves they name |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `app.logs` | A register app\'s `logs` \u2014 at most 3 \u2014 each list another entity under an alias of its own: never the app\'s own entity, one of its `books`\' or another log\'s. A log is one list \u2014 a table or cards, with no `tabs`, no `book` column and no composed record \u2014 over an entity whose status states no owned `stages`, and stands in an app that states no `scope`. An act\'s alias is its own among the app\'s acts and its logs\'. No record of the app or of a log lists the rows of an entity another of the app\'s lists is over: a link to one opens it on its own list. A list people work as a desk of its own is another app. |\n\n<!-- generated:end apps-logs -->\n\n## Workflows\n\nA job no press of the screen starts \u2014 an agent or a service handing the app a file, or a list of\nrows to reconcile a table against \u2014 is a workflow the app declares in `workflows`, by alias. The\nmodel states what it takes and what it hands back; a table is named by its entity and a select by\n`<entity>.<field>`, bound to this workspace\'s own at apply. The screen draws nothing for one: it is\ncalled through the app, by `run_app_workflow` or the app\'s API. On an app shared by a public link it\nruns only for someone who holds the app \u2014 a member it is shared with, or a key that reaches it \u2014 and a\nvisitor\'s call is refused as an alias the app does not have.\n\n```jsonc\n"workflows": {\n  "reconcile_fees": {\n    "description": "Reconciles a visit\'s fees against the lines of the carrier\'s statement.",\n    "inputs": {\n      "visit": { "type": "record_link", "entity": "visit" },\n      "statement": { "type": "file", "required": false },\n      "lines": { "type": "array", "items": { "type": "object", "fields": {\n        "service": { "type": "select", "field": "fee.service" },\n        "amount": { "type": "number" }\n      } } }\n    },\n    "outputs": { "added": { "type": "number" }, "changed": { "type": "number" } }\n  }\n}\n```\n\nIts body is set on the app, never stated in the model: `set_app_workflow` with the app, the alias\nand the `source`, leaving `inputs` and `outputs` out \u2014 the body is checked against what the model\ndeclares. Every apply keeps that body and holds what it takes, what it hands back and its\ndescription to the model. To change what a workflow takes or hands back, change the model first:\nthe apply keeps the body where it still meets the change, and where it does not the workflow\nstands on no body again until `set_app_workflow` sets one that does.\nWith no body it refuses every call, and each apply says so. A workflow the model stops declaring is\narchived with its alias, as one bound on the app by hand that the model never declared is.\n\n<!-- generated:start apps-workflows -->\n\n#### Workflow\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `description` | text | yes | What the workflow does, read by whoever calls it by its alias \u2014 at most 300 characters |\n| `inputs` | map of text \u2192 [Workflow value](#workflow-value) | no | What a call hands it, by name \u2014 checked before its body runs |\n| `outputs` | map of text \u2192 [Workflow value](#workflow-value) | no | What its body returns as `data`, by name \u2014 checked as it returns; absent, read off the body |\n\n#### Workflow value\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `type` | `"text"` \\| `"number"` \\| `"boolean"` \\| `"date"` \\| `"datetime"` \\| `"email"` \\| `"json"` \\| `"record_link"` \\| `"select"` \\| `"member"` \\| `"file"` \\| `"object"` \\| `"array"` | yes | What the value is |\n| `description` | text | no | What the value is for, read by whoever calls the workflow |\n| `required` | `false` | no | false: the value may be left out; absent, it is always there |\n| `multi` | `true` | no | A `record_link`, `select`, `member` or `file` holding several |\n| `entity` | alias | no | The entity a `record_link` names a row of |\n| `field` | text | no | `<entity>.<field>`: the select field whose options a `select` takes, as the field holds them when the workflow runs |\n| `options` | list of alias (at least one) | no | The values a `select` takes, where no field holds them |\n| `fields` | map of text \u2192 [Workflow value](#workflow-value) | no | An `object`\'s values, by name |\n| `items` | [Workflow value](#workflow-value) | no | What each item of an `array` is |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `app.workflow-value` | A value a declared workflow (`workflows`) takes or hands back states what its type needs and nothing another type does: a `record_link` its `entity`, a `select` its `options` or the `field` holding them \u2014 never both \u2014 an `object` its `fields`, an `array` its `items`; `multi` stands on a `record_link`, `select`, `member` or `file`; an output is never a `member` or a `file`; and a value nests at most 8 deep. |\n| `app.generated-name` | A name the app generates is taken by nothing its model states. No declared workflow and no act\'s `workflow` is `record_activity` or `record_activity_undo`, unless the record states `activity: false`. No declared query, no reading\'s `alias` \u2014 a log\'s as it is read, `<entity>_<alias>` \u2014 and no tab\'s read (`<entity>_list_<tab>`) is the name of a read the app generates, of a declared query or of a reading. |\n\n<!-- generated:end apps-workflows -->\n\n## Queries\n\nAn app generates a query for everything its screen reads (`lotics docs agent_surface` lists them). A question\nthe screen never asks \u2014 one a caller asks the app through `run_app_query` or its API \u2014 is declared in\n`queries`, by alias, in the model\'s own aliases: the entity whose rows it reads, the fields each row\nreturns or the figure they add up to, and what narrows them.\n\n```jsonc\n"queries": {\n  "fees_unbilled": {\n    "description": "A customer\'s fees no invoice covers yet, oldest first.",\n    "params": {\n      "customer": { "type": "record_link", "entity": "customer", "description": "The customer whose fees are read." },\n      "since": { "type": "date", "required": false, "description": "Only fees charged on or after this day." }\n    },\n    "rows": "fee",\n    "fields": ["visit", "service", "amount", "charged_on"],\n    "where": { "billed": false, "customer": { "param": "customer" }, "charged_on": { "from": { "param": "since" } } },\n    "sort": { "field": "charged_on" },\n    "limit": 200\n  },\n  "fees_by_service": {\n    "description": "What was charged per service: how many fees and their amount.",\n    "rows": "fee",\n    "reading": { "value": "amount", "by": "service" }\n  }\n}\n```\n\nAn entry of `where` holds what a reading\'s `where` holds \u2014 a select\'s options, a yes/no\'s value, `"me"` on a\nmember field \u2014 or a value the call states: `{ "param": "<name>" }`, an object, which none of those is. A\nrequired param is always stated; one stating `required: false` may be left out, and the condition reading it\nthen narrows nothing. A query reads under its entity\'s read scope, as every read of the app does, and its\nown entity as its list reads it: kept by the register\'s `where`, and inside the row `scope` names \u2014 a param\nthe app adds to the query, `<linked entity>_id`. A `reading` returns one row for all the rows it reads, or\none per value of `by` or per day of `over`. The screen draws nothing for a query, and an apply compiles it\nwith the rest of the app: no body is set. An apply writes the queries the model compiles and no other:\na query set on the app outside the model (`set_app_queries`, on the CLI or in chat) is removed by the next apply, whose plan and\nanswer note it; declared under its alias in `queries`, it is the model\'s.\n\nA query reads one table: on an app that states `books`, whose list reads several, it names a book\'s own\nentity, never the app\'s. A param compares a field holding one value \u2014 or, as a range, a date or a number\n\u2014 and never a number read in each row\'s own unit or currency, where one figure is a different amount on\neach row, nor a date holding a span.\n\nEvery reading of the app \u2014 a dashboard\'s, a register\'s band\'s, a record\'s block \u2014 is a query too, returning\nits groups. It is called by its place, `dashboard_reading_<n>`, `register_reading_<n>` or\n`block_reading_<n>`, counted from 0, so a reading moved is called by another name. One that states `alias`\nis called by it wherever it stands. A log\'s reading is called by the log\'s entity before either name:\n`<entity>_register_reading_<n>`, or `<entity>_<alias>`. A register\'s reading placed in time (`over`) takes `from` and `to`,\neach left out at will; one above a register with tabs reads its `tab`\'s rows, or every tab\'s where it\nstates none:\n\n```jsonc\n{ "metric": "visit", "value": "fees", "where": { "paid": false }, "label": "Unpaid", "alias": "fees_unpaid" }\n```\n\n<!-- generated:start apps-queries -->\n\n#### Query\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `description` | text | yes | What the query answers, read by whoever calls it by its alias \u2014 at most 300 characters |\n| `params` | map of alias \u2192 [Workflow value](#workflow-value) | no | What a call states, by name, each read by an entry of `where` \u2014 a `number`, `boolean`, `date`, `select`, `record_link`, `member`, holding one. `required: false`: the call may leave it out, and the condition reading it narrows nothing |\n| `rows` | alias | yes | The entity whose rows it reads, under that entity\'s read scope unless the app reads `shared`. The app\'s own entity is read as its list reads it: kept by the register\'s `where`, and inside the row the app\'s `scope` names, which the call states |\n| `fields` | list of alias (at least one) | no | The fields each row returns, by alias. A query states `fields` or `reading`, one of the two |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"` \\| [Query param](#query-param) \\| [Query range](#query-range)) | no | Only the rows meeting every entry, by field: a select holding one of these options, a yes/no this value, a member field holding the reader (`"me"`) \u2014 or what the call states: `{ "param": "<name>" }` on a select, a yes/no, a one-row link, a member or a number, and `{ "from": { "param" }, "to": { "param" } }` on a date or a number, either end alone |\n| `sort` | [Sort key](#sort-key) \\| list of [Sort key](#sort-key) (at least one) | no | The order the rows return in; absent, the order the entity\'s list reads in. Only with `fields` |\n| `limit` | integer | no | The most rows returned. Only with `fields` |\n| `reading` | [Query reading](#query-reading) | no | The rows counted or summed instead of returned: one row for all of them, or one per value of `by` or per day of `over`, each carrying its `by` field or `__day`, `__count`, and `__sum` where `value` is stated |\n\n#### Query reading\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `average` | `true` | no | The `value` is averaged: summed over the rows holding one, beside how many hold one. Never with `by` or `over` |\n| `by` | alias | no | The single select, one-row link, member or yes/no each row is counted under \u2014 one row returned per value |\n| `over` | alias | no | A date: one row returned per day of it. Never with `by` |\n\n#### Query param\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `param` | text | yes | A param of this query: the condition holds what the call states for it, and is left out where the call states none |\n\n#### Query range\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `from` | [Query param](#query-param) | no | The param the field is on or after \u2014 a date\'s first day, a number\'s least |\n| `to` | [Query param](#query-param) | no | The param the field is on or before \u2014 a date\'s last day, a number\'s most |\n\n#### A reading\'s name\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | no | On any reading \u2014 a dashboard\'s, a register\'s band\'s, a record\'s block: the name its query is called by (`run_app_query`), its own among the app\'s readings and queries; absent, its place names it \u2014 `dashboard_reading_<n>`, `register_reading_<n>`, `block_reading_<n>`, counted from 0 \u2014 so a reading moved is called by another name |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `app.query` | A declared query (`queries`) reads one entity\'s rows as `fields` or as a `reading`, one of the two \u2014 never the app\'s own entity where the app states `books`, whose list reads several tables; `sort` and `limit` stand with `fields`; a `reading` splits by `by` or by the day of `over`, never both, and averages only with neither; each param is a number, a yes/no, a date, a select, a one-row link or a member holding one, read by an entry of `where` on a field of its type \u2014 a date by a range, a number by either, and never a number read in each row\'s own unit or currency or a date holding a span. |\n| `app.surface-described` | *Noted, never refused:* A value a declared workflow takes, and a param a declared query takes, that states no `description`: the one line a caller reads to fill it. |\n| `reading.alias` | A reading\'s `alias` is its own among the app\'s readings and declared queries, a log\'s read by its entity before it (`<entity>_<alias>`); the work against its plan above a register states none \u2014 it reads the register\'s own rows. |\n\n<!-- generated:end apps-queries -->\n\n## Register\n\n```jsonc\n"register": { "columns": ["service", "release"], "filters": ["customer", "service"], "create": ["container_no", "customer"] }\n```\n\nEach of `filters` is also an optional param of the register\'s list query, `<entity>_list`, typed as its\nfield: `customer_is` and `service_is` here, a date as `<field>_from` and `<field>_to`, a number as\n`<field>_min` and `<field>_max`. A call stating none of them reads every row the list reads. A filter on\na looked-up link or member, on a number read in each row\'s own unit or currency, on a date holding a span,\nand every filter of an app that states `books` is no param: a call narrows by those with `filters`.\n\n<!-- generated:start apps-register -->\n\n#### Register\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `columns` | list of alias | no | Fields read as columns after the row\'s title \u2014 on a calendar\'s entry or a lane\'s block, its facts after its title; never what the row draws itself (its subtitle, image, status, figure, or the bound its figure\'s meter reads against), which the runtime places. At most 5 besides the row\'s name, status, deadlines and figure: a table draws every column and folds the last stated onto the name\'s line as it narrows, so more is refused |\n| `filters` | list of (alias \\| [Tiered filter](#tiered-filter)) (at most 3) | no | The fields the reader narrows the rows by every day, in that order \u2014 each earns its place by that daily use, so none to 3 is normal and 3 is a cap, never a quota (a select, a member, a link, a date, a yes/no, a number as a range, or its `tiers` where the business narrows by those bands daily) \u2014 each on a desk\'s line; a phone\'s one Filters sheet holds them. Never the status (its chips); each a field the rows show \u2014 a column, or a part of the row \u2014 or a formula whose every field of its row it reads they show. A threshold the business names ("large orders") is a formula yes/no here; a column\'s header sorts by a day or an amount |\n| `book` | `true` | no | With `books`: a column naming the table each row is of, and a filter by it |\n| `search` | list of alias (at least one) | no | The fields the search box matches (a link by its row\'s title); a pasted list searches each line and names the lines no row matched. Absent, every word of the row |\n| `group` | alias | no | The field the rows open grouped by, the reader\'s grouping starting there \u2014 a period\'s rows read under each period, one per person; absent, ungrouped |\n| `sort` | [Sort key](#sort-key) \\| list of [Sort key](#sort-key) (at least one) | no | The order rows open in: one key, or a list of keys most significant first, each breaking the ties of the ones before it (a select orders by its options\' order); absent, the first deadline soonest first, else the newest first |\n| `layout` | `"table"` \\| `"cards"` \\| `"calendar"` \\| `"roster"` \\| `"lanes"` \\| `"gantt"` \\| `"plan"` | no | `cards` for rows read by their picture; `calendar` for rows read by their day \u2014 a month, a week, a day or a list, an entry at its hour where its date holds one and over its span where its line holds a second date; `roster` for what each row did on each day of a week or a month (who worked which shift, which vehicle ran), or with `expect` which of a set each row holds; `lanes` for rows booked on a resource over time (an appointment in its chair, a hire on its machine); `gantt` for rows each planned over a run of days, one bar a row on one axis of time (a shipment from its sailing to its arrival, a hire from its start to its return, a task of a project) \u2014 its dates in `gantt`, its lanes the register\'s `group`; `plan` for things that stand at a place (boxes in a yard) \u2014 drawn on a plan of the places, a bay enlarged to its rows and tiers, and in 3D \u2014 the place each stands at in `plan`; absent, a table |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Only the rows whose select holds one of these options and whose yes/no (stored, or a formula) is this value \u2014 read so on the server and never offered as a chip: the rows this app works of an entity other apps read whole (the purchases, of orders both ways). A row added here holds a select\'s one option and a stored yes/no\'s value |\n| `opens` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | The view the register opens on: each entry a narrowing on a field the rows show (or a formula of fields they show) that stands as a chip the reader may take away (the rows still owed), `"me"` a member field holding the reader (the rows mine). One on the status replaces the chips\' opening on the open work \u2014 `"me"` on a status whose `stages` have owners opens on the rows waiting on the reader |\n| `remove` | `false` | no | The app edits its records and offers no Delete on them (a row\'s \u22EF, its record\'s \u22EF) \u2014 a desk correcting a date of records another app makes and closes; absent, a record the app writes is deleted where it stands |\n| `create` | list of alias (at least one) \\| `false` | no | The fields asked when a row is added; absent, the title, the subtitle and figure no default fills, the natural key and every required field \u2014 each a person writes; false, rows are not added here |\n| `readings` | list of ([Metric](#metric) \\| [Breakdown](#breakdown) \\| [Trend](#trend) \\| [Pivot](#pivot) \\| [Progress](#progress)) (at least one) | no | Readings of the register\'s own entity above its rows, over the rows in view \u2014 the search, the status and the filters narrow them, but a picture\'s own field, read as the register opens on it. A press on a breakdown\'s part, a pivot\'s cell or a figure with `where` narrows the rows by its field, as a filter does |\n| `attention` | `false` | no | false: a table\'s or cards\' rows keep the register\'s own order (a first-come queue), and no column names whose step each row stands at; absent, those needing attention open first \u2014 those at a step the reader owns, then overdue, then due within 3 days, then those whose line states a warning \u2014 each part in that order, until the reader picks another |\n\n#### Tiered filter\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field` | alias | yes | A number \u2014 stored, or a formula or rollup reading one \u2014 in one unit for every row |\n| `tiers` | list of number (at least one) | yes | The breakpoints between its bands, ascending, in the field\'s stored unit: under the first, from each to the next, from the last up \u2014 each band worded in the field\'s notation; a filter picks several at once |\n\n#### Sort key\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field` | alias | yes | The field rows are ordered by |\n| `desc` | `true` | no | Latest or largest first; absent, soonest or smallest first |\n\n<!-- generated:end apps-register -->\n\n<!-- generated:start rules-register -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `register.column-drawn` | A column never names what the row draws itself \u2014 its title, subtitle, image, status, figure, or the bound its figure\'s meter reads against \u2014 and names a field once. |\n| `register.columns-budget` | A register spends at most 3 columns, what a desk draws whole; a deadline costs two. |\n| `register.filter` | A filter names a select, a member, a link, a date, a yes/no or a number of the register\'s own rows \u2014 a lookup through one-row links as the field it reads \u2014 never the status (its chips), nor one `where` fixes. |\n| `register.filter-split` | *Noted, never refused:* A filter on a field a breakdown or pivot in the band splits the rows by \u2014 a press on its part narrows by it too; a member\'s filter, which narrows to the reader\'s own rows, is never noted. |\n| `register.filter-unshown` | A filter, a narrowing the register `opens` on, and a press in its band (a breakdown\'s part, a pivot\'s cell, a figure\'s `where`) name a field its rows show \u2014 a column; the row\'s title, the line under it, its picture, status or figure, a meter\'s bound, or the unit or currency a drawn figure is read in; a deadline; a warning its line says; the group or lane it stands under \u2014 or a formula, drawn where every field of its own row it reads is (through other formulas too; one reading no field is drawn nowhere). A narrowing to the reader (`"me"`) needs none. |\n| `register.tiers` | `tiers` band a number read in one unit on every row; a figure read in each row\'s own unit or currency is named bare. |\n| `register.search` | `search` names text, a code, or a link \u2014 matched by its row\'s title. |\n| `register.sort` | Each `sort` key names a field of the register\'s rows that holds an order \u2014 never files \u2014 and no field twice. |\n| `register.group` | `group` names one value per row \u2014 a single select, a one-row link, one member, a date, a yes/no or a text, a lookup through one-row links as the field it reads \u2014 never the status (its chips); only a table groups, and a gantt into its lanes; grouping by the title needs a subtitle to lead each row. |\n| `register.readings-own` | A register\'s `readings` read its own entity; another entity\'s stand on a dashboard. |\n| `register.readings-bands` | A register reading that bands a number by `tiers` has that field with the same tiers among the register\'s `filters`: a press on a band narrows the rows by that filter. |\n| `register.readings-restate` | A register\'s metric never sums the row\'s figure or counts the rows without a `where`: the summary line totals the figure and the status chips count the rows. |\n| `register.where-opens` | `where` and `opens` hold the register\'s own selects and yes/nos, and `opens` a member field holding the reader (`"me"`) \u2014 or, on a status whose `stages` have owners, the rows waiting on the reader; a field `where` fixes is never a filter nor opened otherwise, and `opens` stays among the options `where` keeps. |\n| `register.band-pivot` | *Noted, never refused:* A pivot in a register\'s band: its grid reads on a dashboard, and the band leads with a `metric`. |\n| `register.headline` | *Refused until adopted or declined:* A register over rows that move (a status, a deadline) or carry money, laid out as a table, cards or a gantt, states `readings` \u2014 the patch splits the rows by a field they show and reads them over a date. |\n| `register.span` | *Refused until adopted or declined:* Rows that each span a run of days or hours \u2014 two dates on their line, a `frees`, or a `no_overlap` booking them on what its `by` links to \u2014 are drawn in time by some register over them (a calendar, lanes, a gantt or a roster) \u2014 the patch adds an app over them laid out as lanes on what each one books, else as a gantt. |\n| `register.remove` | A register\'s `remove: false` hides the Delete its records would offer, so it stands only where the app writes its records. |\n| `register.attention` | `attention: false` keeps a table\'s or cards\' rows in the register\'s own order \u2014 a first-come queue; a calendar, lanes, a gantt and a roster stand their rows in time and lift none. |\n\n<!-- generated:end rules-register -->\n\nThe status is always the chips, with\ncounts, opening on the rows not closed (every row on a calendar or a lanes board, whose\nwindow of time narrows them) \u2014 never one of `filters`. `filters` are the ones a reader\nnarrows by every day \u2014 none to three, never a quota \u2014 in order of use, each a field the\nrows show (a column, a part of the row) or a formula yes/no, drawn where every field of\nits own row it reads is drawn, at that width \u2014 each on the line\nwith the search and the chips, the grouping one\nchip at its end; a member filter offers "mine". A date filters by a range of days \u2014 of\nminutes on a `datetime` field, its end not held, so back-to-back shifts read each row\nonce \u2014 and can keep the rows holding no date too (in the yard at a moment: in before it,\nout after it or not yet). A number filters by a range typed in its\nunit or currency \u2014 a figure read in each row\'s own, in the one picked beside it \u2014 with a\nslider over a percent or a figure against a constant `limits`; `{ "field", "tiers" }`\noffers the bands its breakpoints cut in place of a range (`[1000, 5000]` on a weight in\nkg: under 1.000 kg, 1.000\u20135.000 kg, 5.000 kg and over), refused on a figure read in each\nrow\'s own unit. A threshold with a name is a formula yes/no, never a range. A\ncolumn the row already draws is refused. `sort` is one key or a list of keys, most\nsignificant first, each breaking the ties of the ones before it \u2014 a shipping line in its\nselect\'s option order, then the arrival day soonest first:\n`[{ "field": "shipping_line" }, { "field": "arrived_on" }]`; a header\'s press leads them.\nAbsent `sort`, rows open soonest deadline first where the row has a `due`, else newest first. `search` names the fields\nthe search box matches \u2014 a link by its row\'s title \u2014 and a pasted list searches each\nline, naming the lines no row matched; absent, it matches every word of the row.\n\n`where` keeps the rows the app works, read so on the server and never a chip: a\npurchase desk over orders of both directions states `"where": { "direction":\n["purchase"] }`, and a row added there is written holding the one option (a select kept\nat several is asked among them). `opens` is the view the register opens on, each entry a\nchip the reader may take away: a cashier opens on `"opens": { "owes": true }`. Both take\na select\'s options or a yes/no\'s value, stored or a formula; `opens` on the status is\nthe chips\' opening choice. `opens` also takes `"me"` on a member field \u2014 `"opens": {\n"assignee": "me" }` opens on the rows assigned to whoever reads, the server reading the\nreader, never the page; `where` refuses it, since it fixes the rows for every reader\n(who may read a row at all is the entity\'s `read_scope`).\n\nHow the rows are laid out is \xA7 Layouts, tabs over a period \xA7 Tabs, the report \xA7 Export, and the band above\nthe rows \xA7 Readings.\n\n## Layouts\n\n`layout` is how the register draws its rows \u2014 one of the pages below; absent, a table. Each reads what the\nrows already state (their `records` line, status and dates), and the keys a layout adds stand on its page.\nWhich one a job needs: the `design` reference.\n\n### Table\n\nAbsent `layout`, each row is one line: the entity\'s `records` entry \u2014 its picture or mark, title and the line under it\n\u2014 then the status, the `columns`, and the figure at the right; the title, the status and a column of days or\namounts sort the rows by their header. A table groups its rows by `group` (a gantt draws it as its lanes); a\ntable or cards reads `tabs` and `books`.\n\n### Cards\n\n`layout: "cards"` draws each row as a card led by its picture \u2014 the `records` `image`, or the app\'s\n`row.image`: its title and the line under it, its status and what needs the reader (a deadline, a warning),\nthen its figure and the register\'s `columns` at its foot. Cards are for rows found by their picture (a\nproduct, a vehicle, a damage photo); rows with no picture read better as a table.\n\n### Calendar\n\n`layout: "calendar"` places each row on its day \u2014 a month, a week, a day or a list (a\nphone reads the list or a day): at its hour where the date holds one, over its span\nwhere the row\'s line holds a second date after it, its line\'s other words and the\nregister\'s `columns` after its title. The calendar reads the window in view, and its\ncount and the status chips count that window, opening on every row.\n\n### Lanes\n\n`layout: "lanes"` with `lanes` naming a one-link draws each row of the linked entity as\na lane (a chair, a machine, a room), empty ones too, and each register row as a block\nfrom the first date on its line to the second: over the hours of one day where the first\nholds its hour, else over the days of one day, a week or a month. A block reads the row\'s\nname and the first of its `columns`; a free stretch between blocks adds a row there, its\nlane and its start set, and its end where the next block bounds it. A phone lists each\nlane\'s blocks and free stretches in clock order. Rows naming no lane stand first, in a lane\nof their own; where the app writes the link, each block moves to another lane from its menu.\nInside a folder (`scope`), the lanes are the ones whose own one-link names that folder \u2014 a\nbranch\'s rooms, never every branch\'s. A span\'s end holds its day unless `records` names it\nthe day the row `frees`.\n\n`loads` names what a lane carries: `{ "weight": "payload", "volume": "box" }` sums each\nblock\'s number and reads it against the lane row\'s own, at most two. A lane holds its\nblocks while they stand, so it reads the most they add up to at one time in the window \u2014\na day\'s rows together \u2014 named, past its bound, by how much and on which day or at which\nhour. The two are in one unit, or two of one dimension (kg against t); a block then reads\nwhat it adds, and the move menu reads each lane as it would stand with the block on it.\nA bound a single row must keep (no parcel heavier than its van) is a `write_rules` `max`\nthrough the link, which refuses the move.\n\n<!-- generated:start apps-lanes -->\n\n#### Lanes keys\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `lanes` | alias | no | With `layout: "lanes"`: a one-link of this entity whose target\'s rows are the lanes (a chair, a machine, a room), each drawn even when empty. A row is a block from the first date on its line to the second \u2014 within one day by the hour where the first holds one, else by the day over one day, a week or a month; a free stretch between blocks adds a row there, its lane, its start and the end the stretch reaches filled |\n| `loads` | map of alias \u2192 alias | no | With `lanes`: what a lane carries against what it holds, at most 2 \u2014 a number of this entity each block adds (a weight) to a number of the lane\'s row it is held within (a payload), in one unit or two of one dimension. Each lane reads the most its blocks add up to at one time in the window \u2014 a day\'s rows together \u2014 and names by how much and when a lane runs over |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `register.lanes` | `layout: "lanes"` and `lanes` go together: `lanes` is a one-row link to an entity with a `records` entry, the rows name a date on their line, a block\'s two ends are read alike (two days or two moments), and `loads` needs `lanes`. |\n| `register.loads` | `loads` names one to 2 numbers a block adds \u2014 never a percent \u2014 each against a number of the lane\'s row, in one unit or two of one dimension. |\n\n<!-- generated:end apps-lanes -->\n\n### Gantt\n\n`layout: "gantt"` with `gantt` draws each register row as one bar on one axis of time:\n`{ "start": "etd", "end": "eta", "milestones": ["cut_off"], "planned": { "end": "booked_eta" },\n"progress": "done", "after": "waits_on" }`. `end` defaults to the entity\'s first `due`, and an\nentity with neither is refused; `start` and `end` are two dates of the row, both days or both\nmoments, and each planned date is read as `start` is. `progress` is a percent (0\u2013100) \u2014 absent, a\nrow whose record lists its tasks fills to how many are done;\n`after` is a link to rows of the same entity, one or several, each ending before the row\nstarts. The bars stand in the lanes of the register\'s `group`. Where the app writes the\nrow and a person writes a bar\'s date, the bar is dragged through the row\'s save, which then\nwrites those two dates though no section places them; a computed date, one an act sets, or\nan app with `writes: "children"` drags nothing.\n\n<!-- generated:start apps-gantt -->\n\n#### Gantt keys\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `gantt` | [Gantt bar](#gantt-bar) | no | With `layout: "gantt"`: the dates and facts each row\'s bar is drawn from |\n\n#### Gantt bar\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `start` | alias | yes | A date of this entity each row\'s bar starts at (a sailing, a hire\'s start, a task\'s start) |\n| `end` | alias | no | The date each row\'s bar ends at, read as `start` is \u2014 two days or two moments; absent, the entity\'s first `due` |\n| `milestones` | list of alias (at least one) | no | Dates of the row marked on its bar\'s line as diamonds, each named by its label (a cut-off, a delivery, the end of free time) \u2014 never `start` or `end` |\n| `planned` | [Gantt plan](#gantt-plan) | no | The plan each row is read against, drawn as a thin bar under its own \u2014 each date read as `start` is; a missing one is the bar\'s own |\n| `progress` | alias | no | A percent of this entity (0\u2013100) filling each row\'s bar as far as the work is done; absent, how many of the row\'s tasks are done fills it where its record lists them, else the bar wears its status\'s tone |\n| `after` | alias | no | A link of this entity to its own rows each row waits on \u2014 it starts once they end (finish-to-start), an arrow from each; a row starting before one ends is drawn in the danger tone |\n\n#### Gantt plan\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `start` | alias | no | The date the row was planned to start at |\n| `end` | alias | no | The date the row was planned to end at (a booked arrival) |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `register.gantt` | `layout: "gantt"` and `gantt` go together: `start` and `end` (absent, the entity\'s first `due`) are two different dates of the row, both days or both moments; each milestone another date of it, each planned date read as `start` is, `progress` a percent and `after` a link to rows of the same entity. |\n\n<!-- generated:end apps-gantt -->\n\n### Plan\n\n`layout: "plan"` draws things that stand at a place \u2014 containers in a yard, pallets in a\nwarehouse \u2014 on a plan of the places. The places are the rows of an entity whose `records`\nstates a `plan_place` (a bay, an open area or a landmark, each at its spot on a sheet of the\nplan); `plan` names the one-link of the register\'s rows to a place and, for an item in a bay,\nthe row (`across`) and the tier (`up`) it stands in, counted from 1. A bay is drawn as its rows\nand tiers, an area with a count, a landmark as a labelled frame; the reader sees a plan, one\nbay enlarged, and the same yard in 3D. The register may read other tables as `books`: one plan\nof every table\'s items. Each item carries `__reach` \u2014 how many items stand in the way of taking\nit out (those above it where the place is `stacked`, and those in the rows between it and the side\n`reach_from` says the bay is taken from) \u2014 counted over every present row whatever the reader narrows by, so the list,\nits export and an agent\'s read all carry it; `<entity>_plan_load` counts the rows each place holds.\nA write that sets the place, row or tier is refused on the server unless it clears all three,\nor places the item at a free cell of a bay \u2014 resting on a present item where the place is\n`stacked`, a boolean of the place: racks, shelves, platforms and building floors state none and\nhold an item at any tier \u2014 or at an area. A plan opens on every row its `where` keeps, with no\nstatus chip narrowing it. `mark` names a single select and one of its options: a row holding it\nwears a dot on its box in the option\'s colour, and the legend names it by the option\'s label.\n\n```jsonc\n"records": { "bay": { "title": "code", "plan_place": { "kind": "kind", "x": "x", "y": "y", "across": "rows", "up": "tiers", "reach_from": "taken_from", "stacked": "is_stack" } } }\n"register": { "layout": "plan", "plan": { "at": "bay", "across": "row", "up": "tier" }, "filters": ["line"] }\n```\n\n<!-- generated:start apps-plan -->\n\n#### Plan keys\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `plan` | [Plan](#plan) | no | With `layout: "plan"`: the place each row stands at, and in a bay its row and tier |\n\n#### Plan\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `at` | alias | yes | A one-link of this entity to an entity whose `records` states a `plan_place`: where each row stands |\n| `across` | alias | yes | A number field: the row of a bay a row stands in, counted from 1; empty at an area |\n| `up` | alias | yes | A number field: the tier of a bay a row stands at, counted from 1 at the ground; empty at an area |\n| `fill` | alias | no | A single select the items are coloured by; absent, the first single select among the register\'s filters |\n| `mark` | [Plan mark](#plan-mark) | no | A row holding the option wears a dot on its box, in the option\'s own colour, and the legend names it by the option\'s label; in books, the select is matched by option alias, and a book lacking the select never marks its rows |\n\n#### Plan mark\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field` | alias | yes | A single select of this entity |\n| `option` | alias | yes | An option alias of that select |\n\n#### Plan place\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `kind` | alias | yes | A single select, options aliased exactly `bay`, `area`, `landmark`: a bay holds rows and tiers, an area neither, a landmark nothing |\n| `sheet` | alias | no | A single select: the plan sheet it is on |\n| `x` | alias | yes | A number field: left edge, in cells |\n| `y` | alias | yes | A number field: top edge, in cells |\n| `width` | alias | no | A number field: an area\'s frame width, in cells |\n| `depth` | alias | no | A number field: an area\'s frame depth, in cells |\n| `across` | alias | yes | A number field: a bay\'s rows |\n| `up` | alias | yes | A number field: a bay\'s most tiers |\n| `reach_from` | alias | no | A single select, options aliased exactly `first`, `last`, `both`: the side boxes leave a bay from; a bay that names none has no reach and no arrow |\n| `stacked` | alias | no | A boolean field: true where items at this place rest on the one below (a stack), so a tier above the first needs a present item under it, shows floating without one, and an item\'s reach counts the items above it; false or empty, items sit at any tier and only the rows between a bay\'s reach side and the item are in the way |\n| `size` | [Plan place size](#plan-place-size) | no | The real size of ONE cell of the place, for 3D: three number fields stating one length `unit` alike. Absent, a cell is drawn as a unit cube |\n\n#### Plan place size\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `across` | alias | yes | A number field: the width of one cell across the rows |\n| `along` | alias | yes | A number field: the depth of one cell along the place |\n| `up` | alias | yes | A number field: the height of one cell, one level |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `register.plan` | `layout: "plan"` and `plan` go together: `at` is a one-row link to an entity whose `records` states a `plan_place`, `across` and `up` two different numbers of the row, `fill` a single select; a plan has no `tabs`, `group` or `attention`. A write that sets `at`, `across` or `up` is refused unless it clears all three, or places the row at a free cell of a bay (a row from 1 to the bay\'s `across`, a tier from 1 to its `up`, resting on a present item), or at an area with neither. |\n| `register.plan-mark` | A plan\'s `mark` names a single select of the row and an option of it by alias: a row holding that option wears a dot in the option\'s colour, which the legend names by its label. A book that holds the select must hold it as a single select with that option; a book lacking it never marks its rows (`app.book-lacks`). |\n\n<!-- generated:end apps-plan -->\n\n### Roster\n\n`layout: "roster"` draws the register\'s rows down the side and the days of a week or a\nmonth across; `roster` names the entity whose rows fill the days \u2014 each stands on one\nregister row by its single link to it, and on the first date of its line (a shift on a\nperson\'s day, a run on a vehicle\'s), on every day through the second date where its line\nholds one. A cell reads its row\'s status, else the first single select on its line (a\nshift\'s kind), several rows their count; a week\'s cells say their words and one more\nfact of the line, a month\'s keep their marks. A day holding none stays empty: nothing\nwas due, which is never an absence. A filled cell opens its row; an empty one adds a row\nthere, the register row and the day set, asking what any add of it asks \u2014 unless no\napp writes those rows (`writes: false`). With `expect` (a single select of those\nrows) the columns are its options in place of days \u2014 a checklist of papers \u2014 and `of`\n(this entity\'s multi-select) names the ones each row expects: a gap among them reads as\none and adds its row, the others stand blank, and each row reads what it holds of them,\n`2/3`. Over days, a roster reads the `cadence` its entity\'s `records` states for its\nrows (a site\'s diary page, Monday to Saturday from breaking ground to handover): a past\nday owed with none is marked missing in the danger tone and counted, today\'s is still\ndue and offered to add, each row reads the days it holds of those owed, and the days\nthe cadence lists none on are quiet. A roster states no `columns` and needs no\n`readings`: its legend counts each state in view.\n\n```jsonc\n"register": { "layout": "roster", "roster": "run", "filters": ["operator"] }\n"register": { "layout": "roster", "roster": "diary_page" }\n```\n\n<!-- generated:start apps-roster -->\n\n#### Roster keys\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `roster` | alias | no | With `layout: "roster"`: the entity whose rows fill the days \u2014 one single link to this entity, and a date on its row line (`records` title or subtitle). A cell reads its row\'s status, else the first single select on its line, several rows a mark each, the cell read by the one latest in that select\'s options; a row whose line holds a second date after the first fills every day to it; a day with none stays empty, never an absence \u2014 unless this entity\'s `records` `cadence` owes one of them there |\n| `expect` | alias | no | With `roster`: a single select of the roster\'s rows whose options are the columns in place of days \u2014 each cell the row holding that option, read by its status, an empty one added there (a checklist of papers per case); the roster then has no period |\n| `of` | alias | no | With `expect`: this entity\'s own multi-select holding the options each row expects \u2014 its other columns stand blank on that row, never added. Its options are among `expect`\'s |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `register.roster` | `layout: "roster"` and `roster` go together: the roster\'s entity has one single link to this one and a date on its line, a roster draws no `columns`, `expect` needs `roster` and `of` needs `expect`. |\n| `register.roster-expect` | A roster\'s `expect` is a single select of its rows, and `of` this entity\'s multi-select whose every option is one of `expect`\'s. |\n\n<!-- generated:end apps-roster -->\n\n## Tabs\n\nA register reporting a period \u2014 what stands at its end beside what came and went during it (the stock, the\nhires out, the tickets open) \u2014 reads its rows as `tabs` over one `period` the reader picks above them: an\n`open` tab holds the rows open at the period\'s end, an `in` tab the rows dated within it, each with its count\nand each a sheet of the report. Never date chips set by hand, and never a tab per status, which the chips split.\n\n```jsonc\n"register": { "period": "month", "tabs": [\n  { "tab": "in_yard", "label": "In the yard", "open": { "from": "arrived_on", "to": "left_on" } },\n  { "tab": "arrived", "label": "Arrived", "in": "arrived_on" },\n  { "tab": "left", "label": "Left", "in": "left_on" }\n] }\n```\n\n<!-- generated:start apps-tabs -->\n\n#### Tabs keys\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `tabs` | list of [Register tab](#register-tab) (2\u20135) | no | The lists the register reads its rows as, each a tab with its count over one period the reader picks above them \u2014 the stock at its end beside the arrivals and departures during it, a report\'s sheets; each keeps the register\'s filters and search. Absent, one list. Not with a calendar, roster or lanes, which read their own window |\n| `period` | `"today"` \\| `"week"` \\| `"month"` \\| `"quarter"` \\| `"year"` \\| [Period days](#period-days) | no | With `tabs`: the period they open on \u2014 `today`, `week`, `month`, `quarter` or `year` so far, or `{ days }`, the last that many days through now (a night shift running past midnight reads two); absent, this month so far |\n\n#### Register tab\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `tab` | alias | yes | The tab\'s name: its address, and the key its rows stand under in a report |\n| `label` | text | yes | What the tab holds, in the reader\'s words |\n| `in` | alias | no | A date (stored, or a formula): the tab holds the rows dated within the register\'s period, from its start through its last day, or up to its last minute \u2014 the arrivals of a period |\n| `open` | [Tab open](#tab-open) | no | The tab holds the rows open at the period\'s end: begun before it, and not ended by then \u2014 what is in stock, out on hire or still owed at that moment |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no is this value, or whose member field holds the reader (`"me"`) \u2014 every entry ANDed |\n| `sort` | [Sort key](#sort-key) \\| list of [Sort key](#sort-key) (at least one) | no | The order this tab\'s rows read in, as the register\'s `sort`; absent, the register\'s |\n\n#### Tab open\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `from` | alias | yes | The date a row begins on (stored, or a formula) |\n| `to` | alias | yes | The date a row ends on (stored, or a formula), empty while it is open |\n\n#### Period days\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `days` | integer | yes | How many days through today, at most 366 |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `register.tabs` | A register\'s `tabs` each name a tab of their own, never a key a report already holds; a tab\'s `in` and `open` dates are dates of its rows, `open`\'s two different; its `where` and `sort` hold as the register\'s do, and never narrow by the status, which its chips split. Only a table or cards reads tabs, and a band reading\'s `tab` names one of them. |\n\n<!-- generated:end apps-tabs -->\n\n## Export\n\n`export` saves the register as its report \u2014 the title, a line per chip, the search and\nthe moment it was exported, the readings, and every row in view, at most 20,000 of them.\n`export: true` saves it as a workbook, the readings on a sheet before the rows. A list\nstates the reports the business sends \u2014 one a button, several one menu \u2014 each a `label`,\na `description`, and a `template` filled with `title`, `lines`, `readings`, `at` (the\nmoment it was made), `dates` (each date filter\'s `from` and `to` by field, a day or a\nmoment as the filter bounds the rows) and the rows under the entity\'s alias (an html one\nmade a PDF, an `excel` one a workbook; absent, the workbook). A report\'s `filename` names\nits file in the template grammar over the same keys but the rows \u2014\n`"Stock {{dates.arrived.to | format:\\"dd.MM.yyyy\\"}}"`; absent, the template\'s name, or\nthe label. A report of some rows (`where`), or of one value the reader picks (`per`: one\nline\'s file), first narrows the register as its chips \u2014 over the reader\'s own narrowing, the\nchips an earlier report set taken back \u2014 so the screen shows what the file holds.\n\n<!-- generated:start apps-export -->\n\n#### Export keys\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `export` | `true` \\| list of [Register report](#register-report) (at least one) | no | The rows in view saved as the register\'s report \u2014 its title, a line per thing narrowing the rows, the readings and every row: `true`, one workbook of the register\'s columns; a list, the reports a reader picks from one export menu |\n\n#### Register report\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `label` | text | yes | The report\'s name, in the reader\'s words \u2014 its entry in the export menu and its file\'s title |\n| `description` | text | no | What the report holds, under its name in the menu |\n| `template` | alias | no | A template filled with the report \u2014 `title`, `lines`, `readings`, `at` (when it was made), `dates` (each date filter\'s `from` and `to`, by field), `period` (the tabs\' `from` and `to`), `per` (the value picked), every row in view (at most 20,000) under the entity\'s alias, and each tab\'s under its name: an html one made a PDF, an excel one a workbook; absent, the workbook of the register\'s columns, a sheet per tab |\n| `filename` | text | no | The file\'s name, in the template grammar over one value each \u2014 `title`, `at`, `dates.<field>.from` or `.to` of a date filter, `period.from` or `.to` with tabs, `per` with a `per`, `lines \\| lookup:<n>` \u2014 `Stock {{per}} {{period.to \\| format:"dd.MM.yyyy"}}`; absent, the template\'s name, or the report\'s title |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | The rows the report is of, set on the register as the chips they are before its file is made \u2014 the screen shows what the file holds |\n| `per` | alias | no | A select, a member or a one-link the reader picks one value of from the menu \u2014 the rows narrowed to it, as its chip, and one file of that value |\n| `books` | list of alias (at least one) | no | The rows of these books only \u2014 each the app\'s `entity` or one of its `books`; absent, every book\'s |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `register.export-report` | A register\'s reports each have their own label; `per` picks one option, person or one-link row \u2014 never of the status, the folder or a field its `where` fixes. |\n| `register.export-template` | A template an export fills reads at its root only `title`, `lines`, `readings`, `at`, `dates` and its rows under the register entity\'s alias \u2014 an entity named none of those \u2014 and is the document of no act. |\n\n<!-- generated:end apps-export -->\n\n## Readings\n\nA reading is one number, or one picture of numbers, over rows. Where it stands decides\nwhich rows: a dashboard reads every row, a register\'s `readings` the rows in view, a\nrecord\'s reading block the child rows under the record. The picture is the runtime\'s,\nchosen from what the reading means \u2014 no key picks a chart.\n\n```jsonc\n{ "metric": "visit", "value": "fees", "where": { "paid": false }, "over": "arrived_on", "label": "Unpaid" }\n{ "metric": "payment", "value": "days_to_pay", "average": true, "over": "paid_on", "better": "down", "label": "Average days to pay" }\n{ "metric": "payment", "value": "late_share", "average": true, "label": "Share paid late" }\n{ "breakdown": "visit", "by": "line" }\n{ "trend": "visit", "over": "arrived_on", "value": "fees" }\n{ "pivot": "visit", "rows": "size", "columns": "line" }\n{ "breakdown": "invoice", "by": { "field": "days_late", "tiers": [1, 31, 61] }, "value": "owed" }\n{ "pivot": "invoice", "rows": "supplier", "columns": { "field": "days_late", "tiers": [1, 31, 61] }, "value": "owed" }\n{ "list": "visit", "where": { "stage": ["in_yard"] }, "columns": ["line"], "app": "gate", "label": "In the yard" }\n{ "list": "task", "where": { "assignee": "me" }, "label": "My tasks" }\n{ "progress": "work_item", "planned": { "start": "plan_start", "end": "plan_end" }, "done": "complete",\n  "finished": "accepted_on", "measured": { "rows": "logged_qty", "on": "day", "share": "share_of_item" },\n  "weight": "value", "label": "Progress against plan" }\n```\n\nA reading\'s `alias` names the query it is read by (`model/queries`).\n\nA reading\'s `where` keeps rows by a select\'s options, a yes/no\'s value, or `"me"` on a\nmember field \u2014 the rows that name whoever reads, read so on the server.\n\nA metric averaging its `value` (`average: true`) and a split by a number\'s `tiers` are\n`model/averages-and-bands`.\n\n`progress` reads one parent\'s work against its plan \u2014 a register\'s band over a folder, or a record\'s\nblock \u2014 never a dashboard\'s every row: the share of the work planned and the share done, cumulative day by\nday, today\'s two at its foot. Each row is a part of the work, its plan spread evenly over its planned days\nand weighing its `weight` (its value) or, absent, its planned days. Its share done today is `done`, a\npercent the server computes; on an earlier day, its `done` from its `finished` day on, before it what its\n`measured` rows add up to by then \u2014 each row\'s own share of it, a percent the server computes.\n\n<!-- generated:start apps-readings -->\n\n#### Metric\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `metric` | alias | yes | The entity whose rows are counted, or summed, into one number |\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `average` | `true` | no | The `value` is averaged, not summed: its sum over the rows holding one, divided by how many hold one \u2014 a row holding none is no part of it. Under a period each period reads its own average, and its change compares two averages; where no row holds one it reads no figure, never 0, and no change. A share is an average too: a number formula that is 100 on the rows that count and 0 on the others, in percent notation, reads as the share of rows that count |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `over` | alias | no | The date that places a row in time \u2014 its own (stored, or a formula), or its parent\'s through a lookup over a one-link: a dashboard\'s period windows the rows by it (a reading without one reads the rows as they stand now), and a metric reads its recent periods beside the number |\n| `target` | number | no | The number it is read against, where no `limits` bounds its value (a bounded value is read against the sum of its bound) |\n| `better` | `"up"` \\| `"down"` | no | Which way its change over the recent periods `over` reads is good; absent, a sum\'s rise and a count kept by `where` falling |\n| `label` | text | yes | What the reading is, in the reader\'s words |\n\n#### Breakdown\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `breakdown` | alias | yes | The entity whose rows are split into parts |\n| `by` | alias \\| [Tiered filter](#tiered-filter) | yes | The single select, one link, member or yes/no (stored, a formula, or a lookup of one through one-row links) each row is counted under \u2014 or `{ "field", "tiers" }`, a number in the bands its tiers cut (days late: not due, 1\u201330, 31\u201360, over 60), every band drawn in its own order and a row holding no number apart |\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `over` | alias | no | The date that places a row in time \u2014 its own (stored, or a formula), or its parent\'s through a lookup over a one-link: a dashboard\'s period windows the rows by it (a reading without one reads the rows as they stand now), and a metric reads its recent periods beside the number |\n| `label` | text | no | What the reading is, in the reader\'s words; absent, the `by` field\'s label |\n\n#### Trend\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `trend` | alias | yes | The entity whose rows are counted, or summed, per period |\n| `over` | alias | yes | The date each row falls on \u2014 its own (stored, or a formula), or its parent\'s through a lookup over a one-link |\n| `ahead` | `true` | no | Counts forward: the current period first, then the ones after it, over the rows dated today or later (arrivals by their ETA); absent, the periods up to today |\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `label` | text | no | What the reading is, in the reader\'s words; absent, the value\'s label, else the entity\'s |\n\n#### Pivot\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `pivot` | alias | yes | The entity whose rows are counted, or summed, in a grid |\n| `rows` | alias \\| [Tiered filter](#tiered-filter) | yes | The single select, one link, member or yes/no (stored, a formula, or a lookup of one through one-row links) down the side \u2014 or `{ "field", "tiers" }`, a number in the bands its tiers cut (days late: not due, 1\u201330, 31\u201360, over 60), every band drawn in its own order and a row holding no number apart |\n| `columns` | alias \\| [Tiered filter](#tiered-filter) | yes | The single select, one link, member or yes/no (stored, a formula, or a lookup of one through one-row links) across the top \u2014 or `{ "field", "tiers" }`, a number in the bands its tiers cut (days late: not due, 1\u201330, 31\u201360, over 60), every band drawn in its own order and a row holding no number apart |\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `over` | alias | no | The date that places a row in time \u2014 its own (stored, or a formula), or its parent\'s through a lookup over a one-link: a dashboard\'s period windows the rows by it (a reading without one reads the rows as they stand now), and a metric reads its recent periods beside the number |\n| `label` | text | no | What the reading is, in the reader\'s words; absent, the two fields\' labels |\n\n#### Progress\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `progress` | alias | yes | The entity whose rows are the parts of the work, read as the share of it planned and the share done, day by day |\n| `planned` | [Progress planned](#progress-planned) | yes | The days each row\'s work is planned over, its share planned spread evenly across them \u2014 a row missing either is no part of the plan, and neither line counts it |\n| `done` | alias | yes | A number of the row the server computes: its share done today, in percent (0\u2013100) |\n| `finished` | alias | no | A date of the row: the day its work was finished, from which it stands at its `done` |\n| `measured` | [Progress measured](#progress-measured) | no | Before a row is finished, its share done on a day is what these add up to by then, never past its `done`; absent, a row stands at nothing until it is finished, and at its `done` today |\n| `weight` | alias | no | A number of the row: what it weighs in the whole \u2014 its value, its share of the contract; a row holding none weighs nothing. Absent, each row weighs its planned days |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `label` | text | yes | What the reading is, in the reader\'s words |\n\n#### Progress planned\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `start` | alias | yes | A date of the row: the first day of its planned work |\n| `end` | alias | yes | A date of the row: the last day of its planned work |\n\n#### Progress measured\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `rows` | alias | yes | The entity whose rows record the work as it is done, each through its one-row link to a row of the reading |\n| `on` | alias | yes | A date of those rows (their own, or a lookup): the day each records its work |\n| `share` | alias | yes | A number of those rows the server computes: the share of its row each adds, in percent |\n\n#### List\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `list` | alias | yes | The entity whose rows are listed, each in its `records` anatomy |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `columns` | list of alias | no | Fields read after each row\'s title |\n| `app` | alias | no | An app of this model over the same entity that works its rows: a dashboard row opens there, a record\'s list row has "Open in" to it |\n| `label` | text | yes | What the reading is, in the reader\'s words |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n\n<!-- generated:end apps-readings -->\n\n<!-- generated:start rules-reading -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `reading.value` | A reading sums a number, never a percent \u2014 percents do not add up; a metric\'s `average` reads one. |\n| `reading.average` | `average` averages a metric\'s `value` over the rows holding one, read against a plain `target` \u2014 never a value `limits` bounds, whose bound is a sum. |\n| `reading.split` | `by`, `rows` and `columns` split by one value each row holds \u2014 a single select, a one-row link, one member or a yes/no, stored or a formula, a lookup through one-row links as the field it reads \u2014 or by the bands `tiers` cut a number read in one unit on every row; a pivot crosses two different fields. |\n| `reading.over` | `over` is a date: the row\'s own, stored or a formula, or its parent\'s through a lookup over a one-row link. |\n| `reading.where` | A reading\'s `where` keeps rows by a select\'s options, a yes/no\'s `true` or `false`, or a member field holding the reader (`"me"`). |\n| `reading.target` | `target` reads a value nothing bounds \u2014 a value `limits` bounds reads against the sum of its bound. |\n| `reading.better` | `better` needs `over`: a change is read over the periods its date places the rows in. |\n| `reading.list-app` | A list\'s `app` is a register app of this model over the list\'s own entity. |\n| `reading.progress` | The work against its plan reads dates of its rows for `planned` and `finished`, a number for `done` and `weight`, and rows `measured` through a one-row link to them, by a date of theirs and a number of theirs. |\n\n<!-- generated:end rules-reading -->\n\nA reading counts its rows, or sums the number `value` names \u2014 never a percent. `by`,\n`rows` and `columns` split the rows by one value each: a single select, a one-row link,\none member, or a yes/no \u2014 stored or a formula, its parts read as its label and the\nothers. `over` is a date, the row\'s own (stored or a formula) or its parent\'s through a\nlookup over a one-link: a trend\'s periods, a metric\'s recent periods beside its number,\nand what a dashboard\'s period windows. `ahead: true` reads a trend forward from the\ncurrent period over the rows still to come. `where` keeps rows whose select holds one\nof the options, or whose yes/no is the value, every entry ANDed \u2014 a band leads with the\njob\'s exception as a formula\'s yes/no (what is late, what is short; drawn by the fields it reads), never a stage the\nstatus chips already count. A metric summing a value `limits` bounds reads against the\nsum of its bound (`10 / 14`); `target` reads one against a number nothing bounds. A\nmetric\'s change is green where it moves the good way: a sum\'s rise, a count kept by\n`where` falling; `better` states the other way where that reads wrong \u2014 money going out\n(`"better": "down"`). A register reads only its own entity; a `list` stands on a\ndashboard, or in a record\'s `blocks` (\xA7 List block).\n\n`readings` read the register\'s own rows above them: the rows in view, so the search,\nthe status and the filters narrow each one, but a picture\'s own field, which it reads as\nthe register opens on it. A table, cards or a gantt over rows that move or carry money states\nthem (`register.headline`); elsewhere they stand where a picture answers something the rows\ncannot. They stand under the title in one compact\nband: lead with the job\'s headline number (a `metric`), then at most the mix (a\n`breakdown`) and the movement (a `trend`) \u2014 a `pivot` stands under the band as a whole table, every line and its totals, and a\n`breakdown` by a number\'s `tiers` of three breakpoints or more under it too, every band a bar. A picture\nstands only where it splits the rows in view into two parts or more, one of them\nholding two rows or more; a split whose rows\nall fall in one part, and a lone figure with no picture beside it, are said on the\nsummary line instead, so a band stands only holding a picture or two figures. The summary line already totals the\nfigure over the rows in view and the status chips count them, so a `metric` summing the\nfigure, or counting the rows of an entity with a status, is refused unless its `where`\nnarrows it.\n\n## Averages and bands\n\nWhat a [reading](#readings) averages, and how it splits its rows by a number.\n\nA metric\'s `value` is summed; with `average: true` it is averaged \u2014 its sum over the rows the reading\nkeeps, divided by how many of them hold a value, so a row holding none is no part of it. It reads in the\nvalue field\'s own notation, and a figure each row reads in its own unit averages per unit as it sums per\nunit. Under a dashboard\'s period it is the average over the period so far, its shape each recent period\'s\nown average, and its change this period\'s average against the one before\'s \u2014 never a sum of averages.\nWhere no row holds a value there is nothing to average: it reads a dash, never 0, with no change against\nthe period before, and a period holding no row is no point of its shape. A\nplain `target` is the number it is read against; a value `limits` bounds is refused, since its bound is a\nsum.\n\nA share is an average too, so it takes no key of its own: a number formula that is `100` on the rows\nthat count and `0` on the others (`if({paid_on} > {due_on}, 100, 0)`), in percent notation, averaged, is\nthe share of rows that count \u2014 "share paid late". A percent is averaged, never summed. Only a `metric`\naverages: a `breakdown`, a `trend` and a `pivot` count their rows or sum `value`.\n\nA breakdown\'s `by` and a pivot\'s `rows` and `columns` each take, in place of a field, a number by its\n`tiers` \u2014 `{ "field", "tiers" }`, the shape a register\'s [tiered filter](#tiered-filter) takes \u2014 and\nsplit the rows by the bands those breakpoints cut: under the first, from each up to the next, from the\nlast up, a figure on a breakpoint in the band above it. `[1, 31, 61]` over days late reads not due,\n1\u201330, 31\u201360 and over 60 \u2014 the aged report, parties down the side and the bands across. Every band is\ndrawn in the bands\' own order, one holding no row at zero, never ranked by size; each is worded in the\nfield\'s own notation, as the filter\'s chip words it, and rows holding no number stand apart. A band of a\nfigure whose definition makes every value whole \u2014 a rollup that counts, a formula that is\n`differenceInCalendarDays(later, earlier)` \u2014 cut at whole breakpoints reads to the last one it holds, so\nno figure stands in two bands\' words; every other figure, a stored number of days or of a counted noun\ntoo, reads between its breakpoints, since it may hold 14.5. The number is stored, a formula or a rollup, or a lookup of one through\none-row links, read in one unit on every row. On a register a band is a door: a press\nnarrows the rows to it through the filter of the same field and tiers, which the register\'s `filters`\nstate too \u2014 the rows holding no number are no band, so no door; on a dashboard and in a record\'s block\nit opens nothing. A register\'s band seats four bars:\na split by one or two breakpoints stands in it, and one by three or more stands whole under it, as a\npivot does, so every band keeps its bar and its name.\n\n## Dashboards\n\nA dashboard is `{ "alias", "name", "dashboard": [readings] }` with no entity, register\nor record: each reading reads every row of its entity, and one period the reader picks\nat the title \u2014 this month, last month, this or last quarter or year, or any days \u2014 windows\neach reading placed in time: one still running so far, one that closed whole, its change\nread against the period before it. A reading placed in no time reads the rows as they\nstand now, and its head says so. `period` is the one it opens on; absent, the month. A\ntrend holding few periods so far is led in by the ones just before it, so no period opens\non one bar.\n`tabs` (2 to 5, each `{ "tab", "label" }`) split a long dashboard into sheets: every\nreading then states the `tab` it stands under, a strip under the title picks one (the first\nopen), and only its readings are drawn. A reading is called by the same name with or without\ntabs. A `list` reading lists rows, each opening in its `app`. The readings answer the one\nquestion the dashboard\'s owner asks, in the order they ask it \u2014 rows to act on lead where\nthe answer is rows; no order of kinds is the rule.\n\n```jsonc\n// The depot owner\'s morning question: which boxes are past their free days, whose are they, is it growing?\n{ "alias": "overview", "name": "Depot overview", "dashboard": [\n  { "list": "visit", "where": { "overdue": true }, "columns": ["line"], "app": "gate", "label": "Past free days" },\n  { "breakdown": "visit", "by": "line", "where": { "overdue": true }, "label": "Past free days by line" },\n  { "trend": "visit", "over": "arrived_on", "where": { "overdue": true }, "label": "Past free days, by arrival" }\n] }\n```\n\n<!-- generated:start apps-dashboard -->\n\n#### Dashboard app\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | yes | The app\'s name within the model \u2014 what `--from model.json#<alias>` picks |\n| `name` | text | yes | The job, in the words of the people who do it |\n| `description` | text | no | What the job is for, in a sentence |\n| `icon` | text | no | A lucide icon name the launcher tile draws |\n| `theme` | [Theme](#theme) | no | The launcher tile\'s colour |\n| `reads` | `"shared"` | no | Every member reads every row, whatever the entity\'s read scope |\n| `dashboard` | list of ([Metric](#metric) \\| [Breakdown](#breakdown) \\| [Trend](#trend) \\| [Pivot](#pivot) \\| [List](#list)) (at least one) | yes | The readings, in order \u2014 each over every row of its entity, windowed by the one period the reader picks |\n| `tabs` | list of [Dashboard tab](#dashboard-tab) (2\u20135) | no | The sheets the readings stand on, a strip under the title, the first open: each reading of `dashboard` then states the `tab` it stands under, and only the open tab\'s readings are drawn and read. Absent, every reading stands in one grid |\n| `period` | `"month"` \\| `"quarter"` \\| `"year"` \\| [Dashboard period days](#dashboard-period-days) | no | The period the dashboard opens on, before the reader picks another \u2014 `month`, `quarter` or `year` so far, or `{ days: 30 }`, the last 30 days through today; absent, this month so far. Needs a reading placed in time by `over` |\n| `workflows` | map of alias \u2192 [Workflow](#workflow) | no | Workflows of the app no act runs, by alias \u2014 called through the app (`run_app_workflow`, its API) by an agent or a service: each states what it takes and hands back, and its body is set on the app (`set_app_workflow`) and kept by every apply. The screen draws nothing for one |\n| `queries` | map of alias \u2192 [Query](#query) | no | Reads of the app no screen draws, by alias \u2014 called through the app (`run_app_query`, its API) by an agent or a service: each states the rows it reads, what narrows them and what a call may state. The screen draws nothing for one |\n\n#### Dashboard tab\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `tab` | alias | yes | The tab\'s name: its address (`?tab=`), and what each reading\'s `tab` names |\n| `label` | text | yes | What the tab holds, in the reader\'s words |\n\n#### Dashboard period days\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `days` | `30` | yes | The last 30 days through today \u2014 the one span of days a dashboard opens on |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `reading.period` | A dashboard\'s `period` is the one it opens on, and its period stands only over a reading placed in time by `over`. |\n| `reading.tabs` | A dashboard\'s `tabs` each name a tab of their own, and every reading of its `dashboard` states the `tab` it stands under: a tab no reading names, a reading naming a tab not declared, or one naming none is refused; without `tabs`, no reading states a `tab`. |\n\n<!-- generated:end apps-dashboard -->\n\n## Record page\n\n```jsonc\n"record": {\n  "door": "page",\n  "sections": [\n    { "title": "Details", "fields": ["size", "line", "built_on"] },\n    { "title": "Gate in", "at": ["arriving", "in_yard"], "fields": ["arrived_on", "truck"],\n      "blocks": [{ "rows": "fee", "where": { "leg": ["in"] }, "expect": "kind", "columns": ["amount", "paid_by"] }],\n      "acts": ["gate_in_paper"] },\n    { "title": "Sell to a buyer", "description": "Moves the container to the buyer\'s stock once it has left.", "acts": ["sell"] }\n  ]\n}\n```\n\n<!-- generated:start apps-record -->\n\n#### Record page\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `door` | `"page"` \\| `"drawer"` \\| `"beside"` | no | A page for work read at length; a drawer for rows worked one after another from the register; `beside` for rows worked one after another while the list stays in view \u2014 the register\'s list and the open record side by side, over a table register alone. Each stacks its sections, and from three sections on navigates them \u2014 a page by a rail, a drawer by a strip pinned over its scroll; absent, a page where a section has `at` or is a `page`, the record has more than three sections or one stands beside the rest (`side`), else a drawer |\n| `sections` | list of [Section](#section) (at least one) | no | The record in the order its work reaches it \u2014 each section its fields, then its blocks, then its acts. Absent, one section of every field a person writes that no other place shows |\n| `comments` | `true` | no | People comment on the record: its comments \u2014 who wrote what and when, with a composer \u2014 stand in its Activity, opened from its head; stated only where the job\'s people discuss a record or the owner asks for one. Absent, no one comments |\n| `history` | `true` | no | Draws nothing of its own: the record\'s Activity shows every move of the status as a change, when and who \u2014 refused beside `activity: false`, which shows the moves nowhere; noted beside Activity, and refused there in a later release. The entity\'s `status.history` is written either way |\n| `activity` | `false` | no | false: the app\'s records show no activity \u2014 the door in each record\'s head and the panel of its saves and comments beside it; where `comments` is stated, the door opens the comments alone. Absent, every record shows it |\n| `compose` | [piece](#composed-page) | no | The record\'s page stated as a tree of finished pieces instead of `sections`, on a page door \u2014 for a page that is its own arrangement of what the app already states: each node names a piece of the catalog (`use`) and binds by name to a field of the entity, an act of the app or a child entity; it holds no condition and no computed value |\n\n#### Section\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `title` | text | yes | What the section is, in the reader\'s words \u2014 its heading, and its name on the record\'s rail or tab |\n| `description` | text | no | One sentence under the title: what the section is for, or what its act does |\n| `at` | list of alias (at least one) | no | Options of the record\'s status (or its milestones) during which this section is the work now \u2014 a step of the path the record moves through: its rail item reads now while the status holds one and this app has work there, done once the record\'s history says it went through one \u2014 or it is a step of the path before where that history opens (with none, where the record stands) that no act moves the work past \u2014 and it stands before the section that is the work now, and waiting otherwise; a section every option of which ends the work, past the path\'s end or entered by its own act, is an exit: no item and nothing drawn until the record stands in it, then set apart after the steps and never one; A page opened from the register opens at it. It never locks what the section holds: its fields are written as the write rules and checks allow at any stage. An act it names is offered during these alone: its `when` holds the status to them, or on milestones it stamps the step after one of them \u2014 a detour and an exit are sections of their own, a detour stated before the step it returns to |\n| `fields` | list of alias (at least one) | no | The record\'s own fields in this section, in the order they are read \u2014 never one the header draws: the row\'s title, subtitle, image, status or figure |\n| `blocks` | list of [block](#blocks) (at least one) | no | What the section holds besides its own fields, under them, in order |\n| `acts` | list of alias (at least one) | no | Acts of this app drawn under the section\'s fields, their asks as more of them and what each lacks said above its button; the header draws no act, so every act of the record itself is named by one section \u2014 an act of a child (`of`) stands on the child\'s row and is never named here. An act moving the status, offered at ONE step (the stage its `when` holds), stands at that step\'s foot when it moves the work forward \u2014 to a later option, an exit too \u2014 or back to a step the work passes anyway; one offered at several steps, or moving back into a detour, stands in the section it enters, which draws it while the work waits \u2014 an exit\'s in the header\'s \u22EF, since an exit stands only once the record is in it. A correction \u2014 `danger` and not one of its step\'s outcomes (no other status move offered at the same moment) \u2014 waits in the section heading\'s \u22EF, and one no section names in the header\'s \u22EF; every other act is named by a section |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n| `side` | `true` | no | The section the rest are worked from, drawn in a pane beside them rather than in their scroll \u2014 the photos looked at, the pool picked from, the paper typed off; at most one on a record, which opens on a page door. It holds what any section holds |\n| `page` | `true` | no | A page of its own, off the record\'s scroll: its own heading and a way back, reached from the record\'s rail after the scroll\'s sections, or from a link at its place where the record has no rail \u2014 for what makes the record worse stacked in it: a long list of related rows, a workspace of its own. Only on a page door, never a step (`at`). Holding only one `text` block over a markdown field, it reads as a document: a 680px column, saved as it is written \u2014 whether it is saved said at its foot |\n\n<!-- generated:end apps-record -->\n\n<!-- generated:start rules-record -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `record.placed-once` | A field, a block and an act each stand once on a record: the header draws the title, subtitle, image, status (or milestones), figure and folder, and a field\'s one other place is a section\'s `fields`, a files, text or statement block \u2014 save the image, which one files block may draw again, whole, the figure, which a statement draws as what it comes to, and rows one list prices and another compares (`compare`); two places whose `when`s never hold together (a select at options the other\'s lacks) each draw it. |\n| `record.foot-total` | A rows block\'s foot totals the child\'s figure and each summed column over the rows it lists; the record\'s rollup summing that field over those rows (the same `where`) is that foot, never also one of a section\'s `fields`. |\n| `record.fact-restates` | A section\'s field never looks up what its link already reads where it stands: the linked row\'s title and line beside the link, the figure or bound its meter reads on the header\'s line. |\n| `record.section-holds` | A section holds fields, blocks or acts. |\n| `record.sections` | *Refused until adopted or declined:* A register laid out as a table, cards or a gantt states its record\'s `sections` \u2014 the patch holds the fields people write, a files block per paper, a block per child and the record\'s acts. |\n| `record.children` | *Refused until adopted or declined:* An entity some app records, whose rows other rows each belong to (a one-row link to it, never its status history), draws some of them under its row \u2014 a block on its record, a roster of them, lanes of them by that link, or an app over them working in one of its rows at a time (`scope`) \u2014 the patch lists each under the record. |\n| `record.at` | `at` names options of the record\'s stored status, or its milestones; a record with no status has no steps. |\n| `record.at-once` | A stage is the work of one section: two sections naming one option of the status, or one milestone, in `at` hold some field to values apart in their `when` \u2014 a `when` holding the status keeps its section off the options it leaves out. |\n| `record.section-page` | A section is a `page` only on a page door \u2014 never a drawer\'s or one beside the list \u2014 and never a step (`at`), its title naming an address no other page shares (a letter or a digit at least), and never every section. |\n| `record.side` | At most one section stands beside the rest (`side`), on a page door, and never also a page of its own. |\n| `record.beside` | A `door: "beside"` record opens beside a table register \u2014 never a board, cards or a calendar, which draw no list to stand beside. |\n| `record.history` | `record.history` names a status history the entity records (`status.history`), on a record whose Activity is on \u2014 its Activity shows each move, so beside `activity: false` the key draws nothing; no block reads that history. |\n| `record.history-activity` | *Noted, never refused:* `record.history: true` beside a record whose Activity is on: Activity shows every status move as a change already, so the key adds nothing \u2014 a later release refuses it. |\n| `record.section-acts` | A section\'s `acts` name acts of the record itself: an act of a child (`of`) stands on the child\'s row, and one over the register\'s rows (`on`) on the register. |\n| `record.act-in-section` | Every act of the record stands in the `acts` of the section whose work it is; only a correction no section owns \u2014 `danger`, and no other status move offered at the same moment \u2014 or an act an agent runs for the person (a `workflow` or an `intake` moving no status), left off every section, waits in the header\'s \u22EF. |\n| `record.move-home` | A status move offered at one step stands at that step\'s foot when it moves the work forward, to an exit, or back to a step it passes anyway; one offered at several steps, or moving back into a detour, stands in the section `at` the status it enters. |\n| `record.act-staged` | An act at a staged section\'s foot is offered only during that section\'s steps: its `when` holds the status to options the section names \u2014 on milestones, it stamps the step after one of them. |\n| `record.act-hidden` | An act is never offered only while its section\'s `when` hides the section. |\n| `record.field-edit` | An act that only writes one field of its record, not the status, from the one input it asks is that field\'s edit: the field rests in the section\'s `fields` as a control. |\n\n<!-- generated:end rules-record -->\n\nThe record is its `sections`, stacked in the order the work reaches them. A section is\nits fields, the acts under them, then its blocks \u2014 the acts at its foot instead where one\nreads what a block holds or none of its fields \u2014 and holds at least one of them. From\nthree sections on, the record is navigated by their titles: a page by a rail that jumps\nto each (a strip of the same names on a phone), a drawer by the same strip pinned over its scroll;\nwith fewer, the sections just stack. `description` is one sentence under the title.\n`at` names the status options (or the milestones) during which the section is the work\nnow \u2014 only on a record that truly moves through those stages: the rail marks it done,\nnow or waiting (an item of no `at` is its title alone), and the section stands even holding\nnothing yet \u2014 it never hides a field, locks it or gates an act, and a record opens at its\nhead. `page: true` makes a section a page of its own under the\nrecord\'s, off its scroll, with a way back \u2014 rarely, for a long related list or a workspace\nof its own that would make the record worse stacked; never on a drawer or a step. The\nheader draws no act: every act on the record is named by the section whose work it is, and one no section names is refused, naming its likely\nsection \u2014 only a correction no section owns waits in the header\'s \u22EF beside Delete. An act\nmoving the status and offered at ONE step (its `when`) stands at that step\'s foot when it\nmoves the work forward \u2014 to the next step, or to an exit later in the status\'s options\n(Reject beside Approve) \u2014 or back to a step the work passes anyway. One offered at SEVERAL\nsteps, or moving back into a detour, is named by the section it enters: a detour draws it and its\ngaps alone while it waits. A detour \u2014 a stage the work only steps aside into from one step and\nleaves only back to it (a pause, a repair) \u2014 stands before that step, its option and its section\nalike; listed after, the work reads it as its next step, and the check notes it with the move\nlisting it before. A `danger` act is a correction \u2014 waiting in the \u22EF of what it acts\non: its section\'s heading, its row, the header\'s where no section names it \u2014 unless it moves\nthe status while another status move is offered at the same moment; then it is one of that\nstep\'s outcomes, a button. Cancel offered at Held and at Confirmed, beside Confirm, is an\noutcome into an exit: state `{ "title": "Cancelled", "at": ["cancelled"], "fields": ["reason"],\n"acts": ["cancel"] }`. An exit stands only once the record is in it, its reason there and its\nrail item apart from the path; until then Cancel waits in the header\'s \u22EF. Every record\nopens its activity from its head \u2014 each save field by field, each move among them, and each\ncomment, with one composer \u2014 unless `activity: false`. `comments: true` lets people comment\n\u2014 opt-in: state it only where the job\'s people discuss a record; with `activity: false` the\ndoor opens the comments alone, and with neither no door stands. An edit in the activity \u2014 never\nthe record\'s making or an undo \u2014 carries Undo for a member who may write the\nrecord: each field goes back where the record still holds what the edit wrote, the rest named\nwith why. Unless `activity: false`, the app has two workflows nobody authors, for its\norganization\'s members: `record_activity` (`record_id`, `after?`) hands back `entries` \u2014 each with\n`undoable` and `undone` \u2014 and `next?`; `record_activity_undo` (`record_id`, `entry_id`) hands back\n`reverted` and `kept`. No other workflow of the app takes either alias. `history: true` draws\nnothing of its own \u2014 each move is already in the activity: noted, refused beside\n`activity: false` (the moves would show nowhere), and refused everywhere in a later release.\n\nA field, a block and an act is each placed ONCE on a record \u2014 the header, one section;\na second place is refused. The header draws the entity\'s `records` title, subtitle,\nimage, status (or milestones) and figure, so none of them is named again in a section\'s\n`fields` or the register\'s `columns` \u2014 save the image, which one `files` block may draw\nagain, whole at reading size (an incident\'s photo, a scan), the header keeping its mark. Refused too: a section holding nothing, an `at`\non a record with no status, and a section\'s act that is a child\'s or runs over the\nregister\'s rows.\nA table, cards or a gantt states its record\'s `sections` (`record.sections`); absent them \u2014 a register laid\nout in time, or one declining the rule \u2014 one section holds every field a person writes that the header does\nnot show. An editable field rests as its control and saves as it changes; everything\nelse is plain text. A section or a block with `when` is shown only while each named\nselect of the record holds one of its options. The one layout serves every entity: a\ncustomer or a product is sections without `at`.\n\n## Blocks\n\n```jsonc\n"blocks": [\n  { "rows": "fee", "columns": ["kind", "amount"] },\n  { "rows": "fee", "where": { "leg": ["out"] }, "columns": ["kind", "amount"], "under": "invoice" },\n  { "rows": "cost", "via": "bill", "create": false, "remove": false, "pick": true },\n  { "files": ["photos", "papers"] },\n  { "text": "remarks", "when": { "stage": ["held"] } },\n  { "statement": [{ "field": "subtotal" }, { "field": "vat", "op": "plus" }, { "field": "total", "op": "equals" }] }\n]\n```\n\n<!-- generated:start apps-blocks -->\n\n#### Rows block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `rows` | alias | yes | A child entity whose rows belong to this record |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `title` | text | no | The block\'s heading; absent, the child entity\'s or the field\'s own label |\n| `columns` | list of alias | no | The child\'s fields read as columns after its title \u2014 never what its row draws (subtitle, image, status, figure, or the bound its figure\'s meter reads against), though an `expect` block\'s figure is a column, filled in place. |\n| `create` | list of alias (at least one) \\| `false` | no | The child\'s fields asked when a row is added here; absent, its title, its picture, the subtitle and figure no default fills, the block\'s columns, its natural key and every required field \u2014 each a person writes; false, rows are not added here |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Only the child rows whose single select holds one of these options, or whose yes/no (stored, or a formula) is this value \u2014 every entry ANDed, read so on the server; a row added here holds the selects\' (one leg\'s fees, of a record holding both legs\'). Each select is one the child requires, so no row stands in no block |\n| `expect` | alias | no | The child\'s title when the record holds one row per value of it \u2014 a single select (one per option, in order) or a one-row link to a catalog (one per row the link may point at): a value not yet filled reads as its own empty line, and no value holds two rows. The block\'s `columns` name at least one field a person fills in place, unless it states `post`, whose lines are ticked |\n| `of` | alias | no | With `expect` on a select: the record\'s own multi-select holding the options this record expects a line for \u2014 the options it holds, in order, rather than every option. Its options are among the title\'s |\n| `under` | alias | no | The child\'s one-link to a document that covers its rows (an invoice over its fee lines), whose many-link points back and which links to this record: each document stands as a heading over the lines it covers; a filled line no document covers says so on its own row with a make for one document over it, and two or more waiting take a combined make in the block\'s heading. Never also a rows block of the document |\n| `filters` | list of (alias \\| [Tiered filter](#tiered-filter)) (at most 3) | no | The child\'s fields the reader narrows the block\'s rows by, as a register\'s `filters` \u2014 none to 3, each a field its rows show (a column, or a part of the row) or a formula of fields they show, its status among them where the business narrows by it \u2014 never on a task list, whose status chips narrow it |\n| `search` | list of alias (at least one) | no | The child\'s fields the block\'s search box matches (a link by its row\'s title), a pasted list line by line; absent, the block has no search box |\n| `group` | alias | no | The child\'s field the block\'s rows open grouped by, as a register\'s `group` \u2014 the reader\'s grouping starting there; absent, ungrouped |\n| `sort` | [Sort key](#sort-key) \\| list of [Sort key](#sort-key) (at least one) | no | The order the block\'s rows open in, as a register\'s `sort` \u2014 within each group where the block groups them; absent, the child\'s first deadline soonest first, else the newest first |\n| `edits` | list of alias (1\u20132) | no | The child\'s fields each line holds as its control, written where the line stands (a quote line\'s sell price, the customer a line is matched to) \u2014 a number, a date, words, one option or a one-row link the row\'s save writes, each a column or the figure, at most 2; a link\'s control is its picker, offering the rows the field\'s own rules admit; every other value reads, and the row opens to write it |\n| `remove` | `false` | no | This list offers no Delete on its rows (its open row and \u22EF); they are deleted where another list of them or their own record offers it \u2014 e.g. lines that are a selection of rows kept elsewhere |\n| `pick` | `true` | no | The block also picks rows of the child that no record holds through `via` yet \u2014 those naming what this record names in each link `via`\'s `same` compares, and holding the block\'s `where` \u2014 and links them here; a row picked leaves the block from its \u22EF, unlinked and kept. `via` is an optional one-row link a person writes, and the record holds the many-link paired with it |\n| `checklist` | [Checklist](#checklist) | no | The child\'s rows, which are tasks, read as a checklist of checks: each one\'s mark \u2014 passed at a `closed` option, failed at a `failed` one, else still to check \u2014 its title, its columns as its words (a text column its note, on its own line), and on a line under its title its photo and its clause; never grouped nor written in place |\n| `compare` | [Compare](#compare) | no | This list reads each row\'s before against its after. Two files fields (a repair\'s damage and its repair, a check failed and redone): once the before holds a photo, the two stand side by side at one size, each row read in full as a card \u2014 on a checklist, whose `photo` is the before, the after beside it on its line \u2014 and an after not taken yet is the camera\'s tile adding it while the row\'s work is open; a list of the same rows without it stays a table. Two value fields of one type \u2014 text, a number, a date or a single select (a price before a sheet and after it): the list stays a table and the pair is one column under the after\'s label \u2014 the before struck, an arrow, the after \u2014 an empty before read as added and an empty after as removed; the after is its control where `edits` names it, and neither is also a column. Never with `expect` |\n| `post` | [Post](#post) | no | This list is a publish desk: with `expect` on a one-row link to a catalog of destinations, every destination the link admits is a line a person ticks \u2014 a tick makes its row from its key alone, an untick deletes it until its status is `closed` \u2014 and the line chosen reads beside the list as the post that destination\'s feed will show, with its words to copy, the block\'s `columns` as its facts and the row\'s acts. Never with `under`, `pick`, `checklist`, `compare` or a `create` list |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Checklist\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `photo` | alias | no | The child\'s files field holding the photo each row is checked by |\n| `clause` | alias | no | The child\'s one-row link to what each row is checked against \u2014 a standard\'s clause, a rule |\n| `failed` | list of alias (at least one) | no | Options of the child\'s status a row stands failed at \u2014 none of them `closed` |\n\n#### Compare\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `before` | alias | yes | A field of the block\'s rows holding what stood before: a files field (the photo of the place before the work \u2014 the damage surveyed, the check failed), or a value \u2014 text, a number, a date or a single select (the price a row held before a sheet changed it) |\n| `after` | alias | yes | Another field of the block\'s rows, of the same type as `before`, holding what stands after: the photo of the same place once the work is done, or the value the row holds now |\n\n#### Files block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `files` | list of alias (at least one) | yes | Files fields of this record, read as pictures and documents |\n| `title` | text | no | The block\'s heading; absent, the child entity\'s or the field\'s own label |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Text block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `text` | alias | yes | A long text field read as prose |\n| `title` | text | no | The block\'s heading; absent, the child entity\'s or the field\'s own label |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n<!-- generated:end apps-blocks -->\n\n<!-- generated:start rules-block -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `block.child-link` | A block reads a child linked to the record; `via` names the link where the child links more than once. |\n| `block.column-drawn` | A child block\'s column never names what the child\'s row draws \u2014 its title, subtitle, image, status, figure, or the bound its figure\'s meter reads against \u2014 nor its link back to the record, and names a field once; an `expect` block\'s figure is its filled-in-place column. |\n| `block.columns-budget` | A child block spends at most 3 columns, what a desk draws whole; a deadline costs two. |\n| `block.title-back` | Where a child\'s title is its link back to the record a block lists it under, its first other subtitle names it there \u2014 a text, a code, a select, a link or a member, never a number or a date. |\n| `block.where` | A rows block\'s `where` names single selects the child requires, by options they hold \u2014 one held at a single option is never also a column \u2014 and the child\'s yes/nos by value. A yes/no is never held: a block adds rows only at a stored one\'s start, and never picks, expects or stands lines under documents. |\n| `block.under` | `under` names the child\'s one-row link to a document entity that pairs a many-link back and is read under this record by its one link; the lines\' columns never read the document (its heading does) nor hold long text. |\n| `block.under-once` | Documents drawn over their lines (`under`) are never listed again as a block of their own. |\n| `block.edits` | A rows block\'s `edits` name at most two of the child\'s columns or its figure that the row\'s own save writes \u2014 a number, a date, a few words, one option or a one-row link, never the block\'s `via` nor a link its `via` must name alike (`write_rules`\' `same`) \u2014 never on an `expect` block, whose lines are filled in place already. |\n| `block.remove` | A rows block\'s `remove: false` hides the Delete its rows would offer, so it stands only where the app writes those rows. |\n| `block.compare` | A rows block\'s `compare` names two different fields of the child, its `before` and its `after`: two files fields, or two values of one type \u2014 text that is no long text, a number, a date or a single select. Never on a block with `expect`. Over files on a `checklist`, its `before` is the check\'s `photo`. Over values: neither side is also a column or a part the row draws already (its title, line, figure, status, deadline), two numbers read in one notation, no column of the block is long text, and never on a `checklist`. |\n| `block.checklist` | A rows block\'s `checklist` reads a task entity\'s rows as checks, one under another \u2014 never expected, under documents, grouped, written in place or picked together by an act over several, its columns no files; its `photo` names a files field of the child, its `clause` a one-row link of the child, and its `failed` options of the child\'s status none of which is `closed`. |\n| `block.pick` | A rows block\'s `pick` links rows of the child through `via` \u2014 an optional one-row link a person writes, no act writes, no other rule compares rows by and no `under` block stands lines under \u2014 paired with a many-link of the record its own save writes; the child\'s `read_scope` reads a row naming no record through `via`; never on an `expect` or `under` block, nor in an app writing only the record\'s children or nothing. |\n| `block.narrow` | A rows block\'s `filters`, `search`, `group` and `sort` follow the register\'s rules over the child\'s rows, its status among them but on a task list (its chips); never on the link back to the record or a select its `where` holds at one option, never on an `expect` block, and an `under` block is grouped by its documents. |\n| `block.expect` | `expect` names the child\'s title \u2014 a single select or a one-row link a person writes, never the link back \u2014 on a child added in the block; the block\'s `columns` name at least one field a person fills in place \u2014 unless it states `post`, whose lines are ticked \u2014 and its `create` takes the file where the child is pictured by one. |\n| `block.expect-fills` | An expected line is made from its key and its first filled column \u2014 a `post` block\'s from its key alone, by its tick \u2014 so every other field the child requires has a default, a start or a `default_from`, or is read first. |\n| `block.expect-of` | A block\'s `of` needs `expect` on a select, and names the record\'s multi-select whose every option is one of the title\'s. |\n| `block.field-kind` | A files block names files fields of the record, and a text block a text field. |\n| `block.read-scope` | A child read under a record whose rows a `read_scope` narrows states its own \u2014 a row rule is not inherited, save the status history\'s, which takes its record\'s. |\n| `block.under-note` | *Noted, never refused:* Rows holding a paper that cover another block\'s lines, listed apart with no add of their own stated: `under` draws them over the lines they cover. |\n| `block.expect-note` | *Noted, never refused:* Rows each a kind of paper \u2014 a single select their title, a files field holding it \u2014 listed with no `expect` and no `where` on the kind, that no act of the app files a call into or `fills`: the papers a record needs read as the lines still missing. |\n\n<!-- generated:end rules-block -->\n\nAn add in a block fills the link to this record, never asking it, and a rows block opens each row in a drawer.\nUnder `under` the uncovered lines come first; a document made over\none line starts its figure at the line\'s amount, the heading\'s make covering those ticked in its dialog. `pick` (a\nsupplier bill picking the job\'s cost lines) offers none until the record names each link `via`\'s `same` compares,\nlinks at most 200 ticked, and saves the record: a check locking it refuses, and one refusing a row\'s edits refuses\nthat row. Where the child is pictured by a file a person brings (its `records` `image`), an `expect` line not yet\nfilled is a placeholder naming the paper whose upload makes the row; a catalog link\'s values are the rows its\n`options_where` admits, and the add offers only values not yet held. A field starting from the catalog row\n(`default_from`) shows that value as its hint, taken with one press. A block narrowed by a select\'s `where` expects\nits lines once per value among them (one leg\'s fees beside the other\'s), its foot totalled by the record\'s sum\nnarrowed alike. An `agenda` and a `timeline` are set out under \xA7 Timeline and agenda, a `statement` under\n\xA7 Statements.\n\nA rows block whose `create` asks only numbers, single selects, texts with `suggest` and one-row links (one link at\nleast; no `expect`, `under`, `pick`, checklist or `post`) is also added to by one typed line, its words searching\nthe link\'s rows by title and `records` subtitle \u2014 state there the code people type \u2014 and what it does not ask\ncoming off the row picked (`default_from`).\n\n## Composed page\n\nA record whose page is its own arrangement of what the app already states \u2014 a piece of writing under its title, a\nbrief beside its figures \u2014 states `compose` instead of `sections`: a tree of finished pieces, each named by `use`.\n\n```jsonc\n"record": { "door": "page", "compose": {\n  "use": "Column", "children": [\n    { "use": "Bar", "children": [\n      { "use": "Status" },\n      { "use": "Field", "field": "audience" },\n      { "use": "Act", "act": "send_for_review" },\n      { "use": "Copy", "field": "body", "as": "plain" } ] },\n    { "use": "Title" },\n    { "use": "Document", "field": "body" },\n    { "use": "Group", "title": "Reviews", "children": [\n      { "use": "Rows", "child": "review", "create": false },\n      { "use": "Act", "act": "ask_reviewer" } ] } ] } }\n```\n\nA node binds by name: a `field` is a field of the record\'s entity, an `act` an act of the app, a `child` an entity\nlinking to the record. What a name binds is read and written exactly as a section naming it would be \u2014 a `Field` and\na `Document` are saved through the record\'s own save, an `Act` runs its workflow, a `Rows` reads the child\'s rows \u2014\nso a tree adds no write of its own. It holds no condition and no computed value: a piece that does not apply on a\nrow (a field its entity\'s `applies` leaves out, an act its `when` does not offer, rows with nothing in them and no\nadd) draws nothing, by the rule that leaves it out of a section, and anything that must depend on the row is an act\'s\n`when` or a field\'s formula, never the tree.\n\nThe first `Act` the page itself draws is its primary and every other one secondary; a `danger` act reads so wherever it\nstands. A `Copy` and a `Document` naming one field copy what is on screen \u2014 the words typed and not yet saved among\nthem. The record\'s chrome stays the runtime\'s: the way back, its Activity and its \u22EF with Delete share the row over\nthe tree, and the head draws no title and no status of its own \u2014 the tree\'s `Title` and `Status` do.\n\n<!-- generated:start apps-compose -->\n\n#### Column piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Column"` | yes | The page\'s reading column, 680px: its pieces stacked in order from one left edge |\n| `children` | list of [piece](#composed-page) (at least one) | yes | The pieces stacked in it, in the order they are read |\n\n#### Bar piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Bar"` | yes | One row of small things on one control height, in two zones: what the record is \u2014 a status, a field\'s control \u2014 from its left edge, what is done to it \u2014 an act, a copy \u2014 ending on its right edge, taking a row of their own under it where the row runs out of room |\n| `children` | list of [piece](#composed-page) (at least one) | yes | Its pieces, each zone\'s in order; a `Field` directly in it is its control alone on one line, named by its label where it holds nothing; an `Act` that destroys or corrects is not drawn here \u2014 it stands in the record\'s \u22EF |\n\n#### Group piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Group"` | yes | A titled stack, headed once by `title` |\n| `title` | text | yes | Its heading, in the reader\'s words; holding one `Rows`, it carries their count and their add, and the group\'s `Act`s end its line |\n| `children` | list of [piece](#composed-page) (at least one) | yes | The pieces under the heading, in order |\n\n#### Panel piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Panel"` | yes | What a reader does not need while writing: nothing in the page, one entry of the record\'s \u22EF named by `title` that opens its pieces in a panel beside the page \u2014 a sheet on a phone; directly in the root `Column` alone |\n| `title` | text | yes | Its entry in the \u22EF and the panel\'s name, in the reader\'s words; an `Act` directly in it ends that name\'s row |\n| `children` | list of [piece](#composed-page) (at least one) | yes | The pieces in the panel, in order: `Rows`, `Field`, `Act`, `Group`, `Document` \u2014 never `Title`, `Status`, `Bar`, `Copy` or another `Panel` |\n\n#### Title piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Title"` | yes | The record\'s title (`records.<entity>.title`) as the page\'s heading, written in place where a person writes it; one a page |\n\n#### Status piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Status"` | yes | The record\'s status (`records.<entity>.status`) as a record\'s head draws it: moved by hand, by its acts\' moves, or read |\n\n#### Field piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Field"` | yes | A field of the record under its label, as a section\'s `fields` draws it |\n| `field` | alias | yes | The field drawn \u2014 never the title or the status, which `Title` and `Status` draw; once a page |\n\n#### Document piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Document"` | yes | A markdown text field written in place with no box, saved as it is written \u2014 whether it is saved said at its foot |\n| `field` | alias | yes | A text field with `format: "markdown"`; once a page |\n\n#### Act piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Act"` | yes | An act of the app on the record as its button: its `when`, what it lacks, its asks and its confirmation as everywhere; the first `Act` the page itself draws is its primary |\n| `act` | alias | yes | An act of this app on the record \u2014 never one `of` a child\'s rows, which stands on its row; once a page |\n\n#### Rows piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Rows"` | yes | A child entity\'s rows under the record, as a rows block lists them, each row\'s own acts on it |\n| `child` | alias | yes | A child entity linking to the record; once a page |\n| `create` | `false` | no | false, rows are not added here \u2014 an act of the page makes them |\n\n#### Copy piece\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `use` | `"Copy"` | yes | A button copying a field\'s words as the page holds them now \u2014 what is typed in its `Document` and not yet saved among them |\n| `field` | alias | yes | The text field copied |\n| `as` | `"plain"` \\| `"raw"` | yes | `plain`, its markdown marks gone; `raw`, as stored |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `record.compose` | A record\'s `compose` is stated instead of `sections`, on a page door, by an app of one book whose records have no steps (`status.milestones`, `status.stages`) and no picture (`image`) \u2014 a composed page draws neither. Each name is a field of the entity, an act of the app on the record or a child entity linked to it; one `Title`, and each field, act and child drawn once \u2014 a field by `Field` or `Document`, never the title or the status, which `Title` and `Status` draw. The first `Act` the page itself draws is its next step and every other one secondary; an `Act` is a button alone, never one making a set of papers. A `Bar` is one row on one control height, in two zones \u2014 its `Status` and `Field`s from its left edge, its `Act`s and `Copy`s ending on its right edge \u2014 and holds no `Rows` and no `Document`; a `Field` directly in it is its control alone on one line, named by its label where it holds nothing; an `Act` in it that destroys or corrects what is done (`danger`, or a move back) is not drawn there \u2014 it stands in the record\'s \u22EF. A `Panel` draws nothing in the page: it is one entry of the record\'s \u22EF, named by its `title`, opening its pieces in a panel beside the page; it stands directly in the root `Column`, holds `Rows`, `Field`, `Act`, `Group` and `Document` \u2014 never `Title`, `Status`, `Bar`, `Copy` or another `Panel` \u2014 and an `Act` directly in it ends the panel\'s name, secondary. A `Group` is headed once, by its `title`: holding one `Rows`, that heading carries the rows\' count and their add in place of the rows\' own, and the `Act`s the group holds end its line. A `Copy` takes a text field\'s words as the page holds them now, a `Document`\'s words not yet saved among them; a field a `Copy` alone names is read, never written. |\n\n<!-- generated:end apps-compose -->\n\n## Publish desk\n\nRows that are each a place the record is sent \u2014 a notice\'s boards, a listing\'s\nportals \u2014 are a rows block that `expect`s the child\'s one-row link to the catalog of those places and states `post`:\n\n```jsonc\n{ "rows": "posting", "expect": "board", "columns": ["posted_link", "refusal"],\n  "post": { "bodies": ["wording", "wording_abroad"], "text": "goes_out_as", "media": "pictures", "link": "page",\n            "group": "reach", "network": "kind", "networks": { "company_page": "linkedin" } } }\n```\n\nThe desk is where the post is written. `bodies` are the record\'s plain text fields it is written in (one per\nlanguage, say), each its editor between the list and the preview, saved as any field of the record is and drawn\nnowhere else on it. The preview is `text` read over what is on screen: where `text` is a formula of the child, the\ndesk computes that same formula over what is typed \u2014 a body before it is saved, the line\'s own column \u2014 so the post\nmoves as it is written, and a place not ticked previews the words its row would hold. For that the formula reads only\nwhat a screen holds whole: stored values of its row, the record through lookups over the link back to it, the place\nthrough lookups over `expect`, and formulas of the row over those \u2014 a rollup, a lookup through another link or the\nclock is refused, naming the field.\n\nEvery place the link admits is a line with a tick and that place\'s face: its picture (its `records` `image`), else\nthe mark of the network it is on where `networks` names one, else none. `group`, another single select of the place,\nstands the lines under its options in their order: a kind holding a ticked line is open, one holding none folded to\nits heading and its count \u2014 the first open where nothing is ticked \u2014 and a place of no kind comes last. A tick makes\nthe line\'s row from its key alone \u2014 so nothing else the child requires is left without a default \u2014 and an untick\ndeletes it until the row\'s status is `closed`: what went out is not taken back. It asks first only where a person\nwrote on the row \u2014 its status moved off its first option, or one of the block\'s `columns` a person writes filled. One line is worked beside the list \u2014 the one\npressed, else the first ticked \u2014 and read as the post that place\'s feed shows: `text` is the child\'s words for that\nplace, `media` and `link` the record\'s, and `network` the place\'s single select whose options `networks` names to a\nfeed. A place on an option not named reads its words on a plain card. Under the bodies stand the block\'s `columns` a\nperson writes of the line\'s row (words for that place alone); under the post, the press copying its words beside\nthe acts `of` the child \u2014 never a second primary: the section\'s own act is that \u2014 then what the row\'s line and the\nblock\'s `columns` hold that nobody writes there (the link it went out at, why it was refused), each drawn only once\nit holds a value. A value an act or a workflow fills is stated as that act\'s, so the desk never offers it as an\nempty box. Where the block\'s box seats three columns they are the list, what is written and\nthe post; narrower, what is written stands over the post; narrower still the list stands alone and a line opens in\nplace. Sending is an\nordinary act of the record, named in the section\'s `acts`.\n\n<!-- generated:start apps-post -->\n\n#### Post\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `bodies` | list of alias (1\u20133) | no | The record\'s plain text fields the post is written in, in order \u2014 one per language, say \u2014 at most 3: each its editor on the desk, between the list and the preview, and drawn nowhere else on the record |\n| `text` | alias | yes | A text of the block\'s rows \u2014 stored, or a formula yielding text \u2014 holding the words that go out on that row\'s destination. A formula is computed on the desk too, over what is typed: it reads stored values of its row, the record through lookups over the link back to it, the destination through lookups over `expect`, and formulas of the row over those \u2014 never a rollup, another link or the clock |\n| `media` | alias | yes | A files field of the record: the pictures or the video the post carries |\n| `link` | alias | no | A text field of the record holding a link (`format: "link"`), carried as the post\'s card |\n| `network` | alias | yes | A single select of the entity `expect` links to, saying which network each destination is on |\n| `group` | alias | no | Another single select of the entity `expect` links to \u2014 the destination\'s kind \u2014 the lines stand grouped by: each option a heading in the select\'s order, a group holding no ticked line folded to its heading and its count, destinations holding no option last |\n| `networks` | map of alias \u2192 `"facebook"` \\| `"instagram"` \\| `"threads"` \\| `"x"` \\| `"linkedin"` | yes | That select\'s options, each by its alias, to the network whose feed the post is previewed in \u2014 facebook, instagram, threads, x, linkedin. An option not named has no feed to imitate: its words read as a plain card |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `block.post` | A rows block\'s `post` needs `expect` on a one-row link \u2014 never a select, nor with `under`, `pick`, `checklist`, `compare` or a `create` list, its line made by a tick from its key alone: its `bodies` are plain text fields of the record a person writes, drawn nowhere else on it; its `text` is a text of the child, stored or a formula yielding text \u2014 a formula reading only stored values of its row, lookups through the link back to the record or through `expect`, and formulas of the row over those, never the clock; its `media` a files field of the record and its `link` a text field of the record; its `network` a single select of the entity the link names, and `networks` holds options of that select, by alias, each to one of facebook, instagram, threads, x, linkedin; its `group` is another single select of that entity. |\n\n<!-- generated:end apps-post -->\n\n## Timeline and agenda\n\nTwo blocks read a child\'s rows by their day: a `timeline` logs what happened, newest first; an `agenda` plans\nwhat is to come on a time axis.\n\n```jsonc\n"blocks": [\n  { "timeline": "note" },\n  { "agenda": "booking", "columns": ["guide"], "start": "arrival" }\n]\n```\n\n<!-- generated:start apps-timeline-agenda -->\n\n#### Timeline block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `timeline` | alias | yes | A child entity read as a log of dated entries, newest first, with a composer where the app adds entries, each corrected and removed where it stands as a rows block\'s row (entries planned ahead are an `agenda`) \u2014 never the record\'s status history: its Activity shows each move |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `title` | text | no | The block\'s heading; absent, the child entity\'s or the field\'s own label |\n| `create` | list of alias (at least one) \\| `false` | no | The child\'s fields asked when a row is added here; absent, its title, the subtitle and figure no default fills, its natural key and every required field \u2014 each a person writes; false, rows are not added here |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Agenda block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `agenda` | alias | yes | A child entity read as planned entries on a time axis: by day, soonest first, each entry with its picture and the day that is today marked. The day is the first date on the child\'s row line (its `records` title or subtitle); within a day entries follow a datetime there, else the first single select after the date \u2014 its options in the day\'s order |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `title` | text | no | The block\'s heading; absent, the child entity\'s or the field\'s own label |\n| `columns` | list of alias | no | The child\'s facts read on an entry\'s line after its title \u2014 never what its line already draws (subtitle, image, status, figure) |\n| `create` | list of alias (at least one) \\| `false` | no | The child\'s fields asked when a row is added here; absent, its title, its picture, the subtitle and figure no default fills, the block\'s columns, its natural key and every required field \u2014 each a person writes; false, rows are not added here |\n| `start` | alias | no | The record\'s date that is the first day: each day\'s heading counts from it (Day 1, Day 2); absent, the weekday and the date alone |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `block.timeline` | A timeline\'s child holds a date to place its entries by. |\n| `block.agenda` | An agenda\'s child names a date on its row line (`records` title or subtitle); `start` is a date of the record. |\n| `block.timeline-note` | *Noted, never refused:* Rows each what happened on a day and who \u2014 a date on their line, a member, no status and no figure \u2014 listed as a table: a `timeline` draws them as a log, newest first. |\n| `block.agenda-note` | *Noted, never refused:* Rows each on a day and within it (at an hour, in a part of the day) listed as a table: an `agenda` draws them by day. |\n\n<!-- generated:end apps-timeline-agenda -->\n\nAn entry with no day yet is a plan, listed first and dated in place; a timeline\'s moment is its child\'s first date,\nand who its member field.\n\n## Statements\n\nA `statement` block draws a figure the record works out from its own figures \u2014 a claim\'s payable, an invoice\'s\ntotal, a payslip\'s net \u2014 line by line in the order the arithmetic runs: each line a number of the record, the first\nstating no `op`, the last an `equals`. Every figure is a field the server computes or a person writes; the screen adds\nnothing up. A line\'s `parts` lists the rows its figure carries, each read from its own row, and that figure is what\nthey add up to \u2014 a formula, rollup or lookup, or the server\'s copy when the record is made (`default_from`), which\nnothing writes after. A claim\'s "certified before" is the contract\'s certified total copied when the claim is made\n(`made_at`, a moment the record `starts` at `today`), over the claims certified (`certified_at`, an act\'s `now`)\nbefore that moment, each at the figure its certifying act froze (`certified_value`, set to\n`{ "formula": "{claim_value}" }`, which the contract\'s total sums) \u2014 so they always add up to it, as a signed\ncertificate does, after a percent is edited or the contract varied.\n\n```jsonc\n{ "statement": [\n    { "field": "contract_value" },\n    { "field": "done_to_date", "op": "times" },\n    { "field": "value_to_date", "op": "equals" },\n    { "field": "certified_before", "op": "minus",\n      "parts": { "rows": "claim", "same": "contract", "at": "certified_at", "before": "made_at", "where": { "kind": ["work"] },\n                 "columns": ["claimed_on", "done_to_date"], "figure": "certified_value" } },\n    { "field": "claim_value", "op": "equals" },\n    { "field": "retention", "op": "minus", "rate": "retention_rate" },\n    { "field": "payable", "op": "equals" }\n  ],\n  "when": { "kind": ["work"] } }\n```\n\n<!-- generated:start apps-statement -->\n\n#### Statement block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `statement` | list of [Statement line](#statement-line) (at least 3) | yes | A figure built from figures of the record, read as a statement: each line its operator, its label and its figure, the figures on one right edge, in the order stated \u2014 the last an `equals`, what it all comes to, drawn heaviest (a claim\'s payable, an invoice\'s total, a payslip\'s net). A line\'s figure is a control where the app writes it |\n| `title` | text | no | The block\'s heading; absent, the label of what the statement comes to |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Statement line\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field` | alias | yes | A number of the record \u2014 stored, a formula, a rollup or a lookup \u2014 read on the line after its label |\n| `op` | `"plus"` \\| `"minus"` \\| `"times"` \\| `"equals"` | no | How the line works on the lines above it \u2014 `plus`, `minus`, `times`, or `equals` for what they come to, a formula, rollup or lookup the server computes; absent on the first line, which the rest work from |\n| `rate` | alias | no | A percent of the record read after the line\'s label: the rate its figure is taken at (retention at 5 %) |\n| `parts` | [Statement parts](#statement-parts) | no | The rows the line\'s figure carries, each listed under it with its words and its own figure \u2014 read from those rows, never a copy of them. The line\'s figure is what they add up to, drawn read: a formula, rollup or lookup, or a value the server copies when the record is made (`default_from`) that nothing writes after |\n\n#### Statement parts\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `rows` | alias | yes | The entity whose rows the line\'s figure carries \u2014 the record\'s own for the earlier rows of the same thing |\n| `same` | alias | yes | A one-link the record and those rows both hold: the rows naming what the record names in it |\n| `at` | alias | no | A moment (a datetime) of those rows no person keys \u2014 when each was certified: with `before`, only the rows whose moment stands before the record\'s, earliest first; absent with it, every row so named, in their own order |\n| `before` | alias | no | A moment (a datetime) of the record no person keys \u2014 when it was made: the moment the rows\' `at` stands before; stated with `at` |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Only the rows whose single select holds one of these options, or whose yes/no (stored, or a formula) is this value \u2014 read so on the server |\n| `columns` | list of alias (1\u20132) | yes | The rows\' fields read as each one\'s words, in order (its date, its percent) |\n| `figure` | alias | yes | The rows\' number each one reads at the figures\' edge, frozen when the row was certified: a stored number an act fills (`{ "formula": \u2026 }` as it runs) or the server copies when the row is made (`default_from`) \u2014 never one a person keys, nor a formula, rollup or lookup the server recomputes |\n\n<!-- generated:end apps-statement -->\n\n<!-- generated:start rules-statement -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `statement.lines` | A statement\'s lines are numbers of the record, each once \u2014 the first stating no `op`, every other one, the last an `equals` \u2014 each `equals` a formula, rollup or lookup, and a `rate` a number of the record. |\n| `statement.rows` | A line\'s `parts` read rows of an entity holding `same`, a one-link of the record\'s to the same entity; `at`, a moment of those rows, and `before`, a moment of the record (datetimes, never days), stated together; their `columns` and `figure` are those rows\' fields, the figure a number. |\n| `statement.parts-keyed` | A line\'s `parts` add up to its figure, so no person keys it: a formula, rollup or lookup, a value the server copies when the record is made (`default_from`) that no add asks and no save or act writes, or a stored number stating `writes: false` \u2014 the line draws it read; each part\'s `figure` is frozen when its row was certified \u2014 a stored number an act fills, the server copies or the model states no person keys (`writes: false`), never one a person keys or the server recomputes \u2014 and no person keys the moments `at` and `before` either. |\n\n<!-- generated:end rules-statement -->\n\n## Reading blocks\n\nA `metric`, `breakdown`, `trend`, `pivot` or `progress` block on a record is a reading (\xA7 Readings) of a child\nentity\'s rows under it, read only \u2014 `via` names the link where the child has more than one.\n\nA `figures` block reads the record\'s own numbers instead, each a tile under its field\'s label: two to eight\nnumbers of the record no person keys \u2014 a formula, a rollup, a lookup through links to one row, or a stored number\nstating `writes: false` (what a workflow or an integration writes). A number a person keys is a field of the\nsection, where it is written. A tile holding nothing reads as not measured, never 0 \u2014 a sum or a count of\nnothing yet reads 0; a stored 0 reads 0.\n\nMetric blocks and a `figures` block standing one straight after another in a section draw as one strip: four\ntiles to a line on a desk, two on a phone.\n\nA `funnel` block reads the same rows as steps people drop out of between: each of its `steps` a number column\nof the child, summed over the rows under the record, drawn in order with the share each keeps of the one before.\nFunnel blocks standing one straight after another in a section draw on one grid \u2014 one name column, one bar origin\nand one value column \u2014 each under its own `label`, its bars over its own first step.\n\n```jsonc\n"blocks": [\n  { "metric": "fee", "value": "amount", "label": "Fees" },\n  { "breakdown": "fee", "by": "kind" },\n  { "trend": "fee", "over": "charged_on", "value": "amount" },\n  { "pivot": "fee", "rows": "kind", "columns": "method" },\n  { "progress": "task", "planned": { "start": "plan_start", "end": "plan_end" }, "done": "complete", "label": "Progress" },\n  { "funnel": "channel_week", "steps": ["impressions", "clicks", "bookings"], "label": "Reach to booking" },\n  { "figures": ["sessions", "bookings", "calls", "ad_spend"] }\n]\n```\n\n<!-- generated:start apps-reading-blocks -->\n\n#### Metric block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `metric` | alias | yes | The entity whose rows are counted, or summed, into one number |\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `average` | `true` | no | The `value` is averaged, not summed: its sum over the rows holding one, divided by how many hold one \u2014 a row holding none is no part of it. Under a period each period reads its own average, and its change compares two averages; where no row holds one it reads no figure, never 0, and no change. A share is an average too: a number formula that is 100 on the rows that count and 0 on the others, in percent notation, reads as the share of rows that count |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `over` | alias | no | The date that places a row in time \u2014 its own (stored, or a formula), or its parent\'s through a lookup over a one-link: a dashboard\'s period windows the rows by it (a reading without one reads the rows as they stand now), and a metric reads its recent periods beside the number |\n| `target` | number | no | The number it is read against, where no `limits` bounds its value (a bounded value is read against the sum of its bound) |\n| `better` | `"up"` \\| `"down"` | no | Which way its change over the recent periods `over` reads is good; absent, a sum\'s rise and a count kept by `where` falling |\n| `label` | text | yes | What the reading is, in the reader\'s words |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Breakdown block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `breakdown` | alias | yes | The entity whose rows are split into parts |\n| `by` | alias \\| [Tiered filter](#tiered-filter) | yes | The single select, one link, member or yes/no (stored, a formula, or a lookup of one through one-row links) each row is counted under \u2014 or `{ "field", "tiers" }`, a number in the bands its tiers cut (days late: not due, 1\u201330, 31\u201360, over 60), every band drawn in its own order and a row holding no number apart |\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `over` | alias | no | The date that places a row in time \u2014 its own (stored, or a formula), or its parent\'s through a lookup over a one-link: a dashboard\'s period windows the rows by it (a reading without one reads the rows as they stand now), and a metric reads its recent periods beside the number |\n| `label` | text | no | What the reading is, in the reader\'s words; absent, the `by` field\'s label |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Trend block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `trend` | alias | yes | The entity whose rows are counted, or summed, per period |\n| `over` | alias | yes | The date each row falls on \u2014 its own (stored, or a formula), or its parent\'s through a lookup over a one-link |\n| `ahead` | `true` | no | Counts forward: the current period first, then the ones after it, over the rows dated today or later (arrivals by their ETA); absent, the periods up to today |\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `label` | text | no | What the reading is, in the reader\'s words; absent, the value\'s label, else the entity\'s |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Pivot block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `pivot` | alias | yes | The entity whose rows are counted, or summed, in a grid |\n| `rows` | alias \\| [Tiered filter](#tiered-filter) | yes | The single select, one link, member or yes/no (stored, a formula, or a lookup of one through one-row links) down the side \u2014 or `{ "field", "tiers" }`, a number in the bands its tiers cut (days late: not due, 1\u201330, 31\u201360, over 60), every band drawn in its own order and a row holding no number apart |\n| `columns` | alias \\| [Tiered filter](#tiered-filter) | yes | The single select, one link, member or yes/no (stored, a formula, or a lookup of one through one-row links) across the top \u2014 or `{ "field", "tiers" }`, a number in the bands its tiers cut (days late: not due, 1\u201330, 31\u201360, over 60), every band drawn in its own order and a row holding no number apart |\n| `value` | alias | no | A number field summed over the rows; absent, the rows are counted |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `over` | alias | no | The date that places a row in time \u2014 its own (stored, or a formula), or its parent\'s through a lookup over a one-link: a dashboard\'s period windows the rows by it (a reading without one reads the rows as they stand now), and a metric reads its recent periods beside the number |\n| `label` | text | no | What the reading is, in the reader\'s words; absent, the two fields\' labels |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Progress block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `progress` | alias | yes | The entity whose rows are the parts of the work, read as the share of it planned and the share done, day by day |\n| `planned` | [Progress planned](#progress-planned) | yes | The days each row\'s work is planned over, its share planned spread evenly across them \u2014 a row missing either is no part of the plan, and neither line counts it |\n| `done` | alias | yes | A number of the row the server computes: its share done today, in percent (0\u2013100) |\n| `finished` | alias | no | A date of the row: the day its work was finished, from which it stands at its `done` |\n| `measured` | [Progress measured](#progress-measured) | no | Before a row is finished, its share done on a day is what these add up to by then, never past its `done`; absent, a row stands at nothing until it is finished, and at its `done` today |\n| `weight` | alias | no | A number of the row: what it weighs in the whole \u2014 its value, its share of the contract; a row holding none weighs nothing. Absent, each row weighs its planned days |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `label` | text | yes | What the reading is, in the reader\'s words |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Funnel block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `funnel` | alias | yes | A child entity whose rows each count the same steps, a column a step (a week\'s channels, each with its impressions, clicks and bookings): one funnel over the rows under the record \u2014 each step its column summed, its bar over the first step, the share kept between two steps and from the first to the last. A step no row holds a number in reads as not measured, never as zero |\n| `steps` | list of alias (2\u20138) | yes | The child\'s numbers summed, in order, first step to last \u2014 2 to 8, each stored, a formula or a rollup, all in one notation, never a percent |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `label` | text | yes | What the reading is, in the reader\'s words |\n| `via` | alias | no | The child\'s link to this record, where it has more than one |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Figures block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `figures` | list of alias (2\u20138) | yes | Numbers of this record no person keys, in order, each a tile under its field\'s label \u2014 2 to 8: a formula, a rollup, a lookup, or a stored number stating `writes: false`. A tile holding nothing reads as not measured, never 0 \u2014 a sum or a count of nothing yet reads 0 |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `block.funnel` | A funnel\'s `steps` are 2 to 8 numbers of its child, each named once \u2014 stored, a formula or a rollup \u2014 all in one notation, never a percent nor a unit read on each row. |\n| `block.figures` | A `figures` block\'s tiles are 2 to 8 numbers of the record no person keys \u2014 a formula, a rollup, a lookup through links to one row, or a stored number stating `writes: false` \u2014 each placed once on the record. |\n\n<!-- generated:end apps-reading-blocks -->\n\n## List block\n\nA `list` block puts rows of an entity beside the record, read only \u2014 nothing in it is added, edited or removed, and\nno workflow is made for it (a `rows` block lists and edits a child\'s rows). It reads the rows linked to the\nrecord through the list entity\'s one link to it (`via` where it has several). With `same`, a one-row link of the\nrecord\'s entity, it reads the rows sharing that link\'s row with the record, the record left out \u2014 a credit\nnote\'s other notes of its party; the list entity holds one link to that row\'s entity (`via` where it has several).\nA record whose `same` link is empty lists nothing and says so. `where`, `columns`, `label` and `app` read as\non a dashboard\'s list; the heading counts every row, and the first ten are drawn. A row of this app\'s own\nentity opens its record here, a row of another entity opens in its peek, and `app` opens it in the app it names.\n`same` stands in a record\'s `blocks` only.\n\n```jsonc\n"blocks": [\n  { "list": "visit", "label": "Service visits", "columns": ["engineer"], "app": "visits" },\n  { "list": "order", "same": "customer", "label": "Customer\'s other open orders", "where": { "stage": ["draft", "confirmed"] } }\n]\n```\n\n<!-- generated:start apps-list-block -->\n\n#### List block\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `list` | alias | yes | The entity whose rows are listed, each in its `records` anatomy |\n| `where` | map of alias \u2192 (list of alias (at least one) \\| boolean \\| `"me"`) | no | Only the rows whose select holds one of these options, whose yes/no (stored or formula) is this value, or whose member field holds the reader (`"me"`) \u2014 each its own or through one-row links; entries ANDed |\n| `columns` | list of alias | no | Fields read after each row\'s title |\n| `app` | alias | no | An app of this model over the same entity that works its rows: a dashboard row opens there, a record\'s list row has "Open in" to it |\n| `same` | alias | no | In a record\'s `blocks` only, read-only: a one-row link of the record \u2014 the rows sharing its row with this record, the record left out, by the list entity\'s one link to that row\'s entity (`via` where several). Absent, the rows linked to this record |\n| `label` | text | yes | What the reading is, in the reader\'s words |\n| `tab` | alias | no | The register tab it reads, else the open one; or its dashboard tab |\n| `via` | alias | no | The list entity\'s link to this record \u2014 with `same`, to the entity that link points at \u2014 where it has more than one |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | Shown only while each named select of the record holds one of these options, and each named yes/no (stored, or a formula) is this value |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `block.list` | A `list` block, read-only, lists the rows of an entity that link to the record by its one link to it (`via` where it has several); with `same`, a one-row link of the record, it lists the rows sharing that link\'s row with the record \u2014 the record left out \u2014 by the list entity\'s one link to that row\'s entity (`via` where it has several). `same` stands in a record\'s `blocks`, never on a dashboard. |\n\n<!-- generated:end apps-list-block -->\n\n## Tasks\n\nAn entity whose `records` states `"task": true` \u2014 its status a stored select with `closed` \u2014 is\nwork someone finishes. Every table of its rows draws it alike \u2014 a rows block of the record it\nbelongs to, its own register, the rows filed under one of its rows (its steps) \u2014 each row led by a\nring. Ticking the ring moves the row to a closed option by the one write the app already has for\nthat move \u2014 the act of that entity setting a closed option (its first preferred), offered on an\nopen row and asking nothing, else its own save where people write the status \u2014 stamping what\nthat act stamps and appending the status history. Unticking runs the act moving a closed row\nback (its `when` holding a closed option), else the save back to the status\'s default. A move no\nwrite reaches leaves the ring disabled, never hidden, and the check notes it. The status is moved\nin place on the row by the same moves; every other field is edited where the row opens. A\nfiles column reads on a task\'s line as how many files it holds. An act `of` the child with\n`on: "rows"` completes several at once: the list\'s heading offers to select rows, and the act\nruns on those picked. A block with `expect` or `under` draws its own lines, never rings. A record listing rows of a\ntask entity filed under it by a link holding one row says how much of that work is done \u2014 those rows at a closed\noption of all, every one the reader may read, every such block\'s rows counted as one \u2014 wherever its row is drawn: a\nmeter on its head, a column of its register\'s rows, a card\'s foot, a calendar entry, a gantt\'s or a lane\'s bar; a\ngantt of task rows grouped by the row they are filed under says that row\'s on each group\'s head. No rollup is stated\nfor it.\n\n```json\n{\n  "entities": [\n    {\n      "alias": "project",\n      "label": "Projects",\n      "singular": "Project",\n      "fields": [\n        { "alias": "name", "label": "Name", "type": "text", "required": true },\n        { "alias": "lead", "label": "Lead", "type": "select_member" }\n      ]\n    },\n    {\n      "alias": "task",\n      "label": "Tasks",\n      "singular": "Task",\n      "fields": [\n        { "alias": "title", "label": "Title", "type": "text", "required": true },\n        {\n          "alias": "project",\n          "label": "Project",\n          "type": "select_record_link",\n          "target_entity": "project",\n          "cardinality": "one",\n          "required": true\n        },\n        { "alias": "assignee", "label": "Assignee", "type": "select_member" },\n        {\n          "alias": "status",\n          "label": "Status",\n          "type": "select",\n          "required": true,\n          "options": [\n            { "alias": "todo", "label": "To do", "color": "slate" },\n            { "alias": "done", "label": "Done", "color": "green" }\n          ],\n          "default": ["todo"]\n        },\n        { "alias": "due", "label": "Due", "type": "date", "format": "date" },\n        { "alias": "done_on", "label": "Done on", "type": "date", "format": "date" }\n      ]\n    }\n  ],\n  "records": {\n    "project": { "title": "name" },\n    "task": {\n      "title": "title",\n      "subtitle": ["assignee"],\n      "status": { "field": "status", "closed": ["done"] },\n      "due": ["due"],\n      "task": true,\n      "starts": { "assignee": "me" }\n    }\n  },\n  "apps": [\n    {\n      "alias": "projects",\n      "name": "Projects",\n      "entity": "project",\n      "record": {\n        "sections": [{ "title": "Work", "fields": ["lead"], "blocks": [{ "rows": "task", "columns": ["due"] }] }]\n      },\n      "acts": [\n        { "alias": "complete", "label": "Complete", "of": "task", "when": { "status": ["todo"] }, "set": { "status": "done", "done_on": "now" } },\n        { "alias": "reopen", "label": "Reopen", "of": "task", "when": { "status": ["done"] }, "set": { "status": "todo", "done_on": null } },\n        { "alias": "complete_all", "label": "Complete", "of": "task", "on": "rows", "when": { "status": ["todo"] }, "set": { "status": "done", "done_on": "now" } }\n      ]\n    },\n    {\n      "alias": "my_tasks",\n      "name": "My tasks",\n      "entity": "task",\n      "register": {\n        "opens": { "assignee": "me" },\n        "readings": [{ "metric": "task", "where": { "status": ["todo"] }, "label": "Open" }]\n      },\n      "record": {\n        "door": "drawer",\n        "sections": [{ "title": "Task", "fields": ["project", "due"], "acts": ["finish", "undo"] }]\n      },\n      "acts": [\n        { "alias": "finish", "label": "Finish", "when": { "status": ["todo"] }, "set": { "status": "done", "done_on": "now" } },\n        { "alias": "undo", "label": "Undo", "when": { "status": ["done"] }, "set": { "status": "todo", "done_on": null } }\n      ]\n    }\n  ]\n}\n```\n\n## Acts\n\n```jsonc\n"acts": [{\n  "alias": "gate_out", "label": "Gate out",\n  "when": { "stage": ["in_yard"] }, "requires": ["release", "seal"],\n  "asks": ["seal", { "input": "note", "label": "Note", "type": "long_text" }],\n  "set": { "stage": "gone", "left_on": "now", "left_by": "me", "remark": "input:note" },\n  "confirm": true\n}]\n```\n\n<!-- generated:start apps-acts -->\n\n#### Act\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `alias` | alias | yes | The act\'s name within its app \u2014 its workflow is `act_<alias>` |\n| `label` | text | yes | The verb, as the reader says it |\n| `on` | `"record"` \\| `"rows"` \\| `"view"` | no | `rows` runs on the rows ticked in the register \u2014 with `of`, on the child rows ticked together in a rows block of the record; `view` on every row the register shows (offered while the view is narrowed to its `when`; it states no `requires`); absent, on one record (its page and its row\'s menu) |\n| `of` | alias | no | A rows block\'s child entity the act works on: offered on each child row \u2014 or, `on: "rows"`, on the rows ticked together in the block \u2014 its conditions and its write that row\'s |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | The act works only while each named select holds one of these options, and each named yes/no (stored, or a formula) is this value |\n| `requires` | list of alias (at least one) | no | Fields that must be filled first, each drawn where the act stands (its section\'s fields, a block\'s, or the act\'s asks \u2014 never the header alone); a blocked act names each one missing |\n| `recommends` | list of alias (at least one) | no | Fields the act runs without and reads when filled: while one is empty, the act says what it will leave blank |\n| `asks` | list of (alias \\| [Asked input](#asked-input)) (at least one) | no | What the reader states when pressing it \u2014 fields of the record (written by the act) or inputs |\n| `set` | map of alias \u2192 (text \\| number \\| boolean \\| `null` \\| [Set formula](#set-formula)) | no | What the act writes: an option alias, a value, `"now"`, `"me"` or `"input:<name>"` \u2014 each the act\'s outcome, read-only elsewhere; or `{ "formula": \u2026 }`, computed over each acted row as it stands when the act runs and written then (a sell price at cost and markup): a starting value, which a person may change after and the act never recomputes |\n| `workflow` | alias | no | An authored workflow (src/workflows/<alias>.ts) the act runs after its checks, for what `set` cannot say |\n| `writes` | list of alias (at least one) | no | With `workflow`, fields of the acted row its body writes (an id kept from a service\'s answer) \u2014 the act\'s, as what `set` states is |\n| `template` | alias | no | A document template the act makes a file from \u2014 an html one made a PDF, an excel one a workbook; over several rows, one file of them all, the rows listed under the entity\'s alias |\n| `templates` | list of [Act template](#act-template) (at least 2) | no | Several papers the act makes into `into` (a case\'s forms), instead of one `template`: listed where the act stands \u2014 each made one as its file, each not yet made as a placeholder \u2014 the reader ticks which to make, one press making those, each replacing its own last paper |\n| `into` | alias | no | The record\'s files field the made document is kept in \u2014 remade, it replaces its own last paper, never a person\'s file |\n| `paper` | text | no | Its paper, `<child>.<kind>`: the line of the record\'s papers it stands on |\n| `intake` | alias | no | A child the record lists in a rows block whose rows are its papers: the press takes papers, an agent reads them, and each is filed as a row of this child \u2014 its kind the child\'s title, its file in the child\'s files field |\n| `record` | [Recording](#recording) | no | The press records a call, visit or meeting through the host \u2014 Stop ends it \u2014 and files it as a new row of a child the record lists: its audio, its screen where captured, its transcript |\n| `sign` | [Signature](#signature) | no | The press opens a pad the signer signs on, beside what the act asks, and the act keeps the signature as a picture with who signed, when and the witness \u2014 read on the record as one signature, and handed to the paper the act makes |\n| `fills` | list of text (at least one) | no | With `intake`, what the papers read may fill: a field of the record, `<link>.<field>` on the row a required one-row link names, or a child whose rows the papers add \u2014 shown before and after, saved where it differs; a single link is filled with a row the app reads. With `record`, fields of the new row an agent fills from the transcript, saved as they come |\n| `review` | `true` | no | With `workflow`: the workflow only proposes \u2014 its body reads and returns a changeset of the act\'s table in `data.review` \u2014 and the platform writes the rows of it the reader ticks in the act\'s dialog (`approved`). Over every row in view it is handed no rows |\n| `confirm` | `true` | no | The press asks first; the question lists every active warning |\n| `danger` | `true` | no | The act destroys or cannot be undone |\n\n#### Asked input\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `input` | alias | yes | A value the act asks for that is not a field of the record |\n| `label` | text | yes | What the reader is asked, in their words |\n| `type` | `"text"` \\| `"long_text"` \\| `"number"` \\| `"date"` \\| `"select"` \\| `"link"` \\| `"member"` \\| `"file"` | yes | What the reader states. A `file` is one uploaded file, handed to the act\'s authored `workflow` as its file id and read by nothing else |\n| `options` | list of [Select option](#select-option) (at least one) | no | The choices a `select` input offers, one picked \u2014 written into a select holding the same option aliases |\n| `entity` | alias | no | The entity a `link` input picks one row of |\n| `accepts` | list of `"sheet"` \\| `"pdf"` \\| `"document"` \\| `"photo"` (at least one) | no | The kinds of file a `file` input takes; absent, a sheet, a PDF or a document \u2014 a phone offers its camera only where `photo` is among them |\n| `required` | `true` | no | The act is refused without it |\n| `default` | alias | no | A field of the row whose value the input starts from, still changed at will |\n\n#### Set formula\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `formula` | text | yes | A formula over the acted row\'s fields, `{alias}` each, read as the entity\'s own formulas read them |\n\n<!-- generated:end apps-acts -->\n\n<!-- generated:start rules-act -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `act.paper-note` | *Noted, never refused:* A made paper kept in a field of a record that lists its papers by kind: it is one of those lines. |\n| `act.moves` | *Refused until adopted or declined:* Rows a stored status stages towards `closed` options are moved by an act of some app over them, or by its authored `workflow` \u2014 the patch moves each open option to the next, the last to the first closed one. |\n| `act.set-not-asked` | A field an act `set`s \u2014 an option, a value, `now`, `me`, an input \u2014 or its workflow `writes` is the act\'s outcome: read-only everywhere else and never asked by an add (`create`); a required one takes a `default`. A field an act computes by a `formula` is a starting value, which a person may change after. |\n| `act.writes` | `writes` stands beside `workflow` and names stored fields of the acted row, each once, that no `set` of the act and no other act over the rows states. |\n| `act.set-formula` | `set: { <field>: { formula } }` reads fields of the acted row and computes what the field holds \u2014 a number, a date, text, a yes/no or a single select\'s option (`{field:option}`), typed as the entity\'s own formulas are \u2014 never the status or a milestone; a bound a write rule holds the field to is checked on the computed value as the act runs. |\n| `act.of` | An act\'s `of` names a child the record lists in a rows block; it works on the one child row it is pressed on \u2014 or, `on: "rows"`, on the rows ticked together where the record lists that child as tasks \u2014 never on the rows in view. |\n| `act.writes-line-key` | An act never writes the link or the key naming an expected line under its record \u2014 a line\'s key is stated by filling it. |\n| `act.makes-or-runs` | An act makes a document (`template`, `templates`) or runs an authored `workflow`, never both \u2014 the workflow makes what it needs. |\n| `act.view` | An act over every row in view (`on: "view"`) writes (`set`), makes a document or runs a workflow, and states no `requires`. |\n| `act.requires-drawn` | Every field an act `requires` is drawn where the act stands \u2014 its section\'s fields, a block\'s, its asks, or an unstaged section\'s where its own is unstaged \u2014 never the header alone. |\n| `act.requires-written` | A field an act requires that only an act writes is written by an act offered together with it, or asked by the act itself. |\n| `act.recommends` | A field an act `recommends` is not also in its `requires`. |\n| `act.set` | `set` writes each field a value it holds \u2014 an option alias, a number, a yes/no, a text, `"now"` on a date, `"me"` on a member, `"input:<name>"` of an input the act asks of the same kind \u2014 or clears an optional one with `null`. |\n| `act.set-milestone` | An act stamps a milestone, never clears one \u2014 unticking clears it and every later one. |\n| `act.paper` | `paper` is a kind the record lists its papers by, on one record \u2014 never beside `into` or `templates`; one maker per kind. |\n| `act.history-copy` | What a status move asks is copied onto the history\'s field of the same name, which holds the same kind of value. |\n| `act.input` | An input has a name of its own \u2014 never another ask\'s, a field\'s, or the record input its workflow takes (nor `approved` beside `review`) \u2014 `options` exactly when it is a select, `entity` exactly when it is a link, and a `default` field holding what it states. A `file` input is read by the act\'s authored `workflow` alone, starts empty, and is never written into a field by `set`. |\n| `act.review` | `review: true` stands beside an authored `workflow` on an act over the record, the ticked rows or every row in view, in an app over one entity \u2014 never beside `books`, `set`, `template`, `templates`, `intake`, `record`, `sign`, `confirm` or `of`, and it asks inputs only, none named `approved`. Its workflow is that act\'s alone, run by no other act. The workflow calls only steps that read \u2014 no agent \u2014 and returns a changeset of the entity\'s table in `data.review`, the same for the same inputs and rows; the platform writes the rows `approved` names, each only while the run proposes it as the caller read it. Over every row in view (`on: "view"`) it is handed no rows and states no `when`: its workflow reads the rows it may change, whatever the view is narrowed to, and no bound on a run\'s rows applies. |\n\n<!-- generated:end rules-act -->\n\nAn act whose `when` does not hold is not offered \u2014 each select named holding one of its\noptions, each yes/no named (stored, or a formula: a period that has ended) its `true` or\n`false`; every one that holds stands at the\nfoot of the section naming it in `acts` \u2014 a correction in that section heading\'s \u22EF, one\nof a child row on its row (a correction in the row\'s \u22EF). An act\'s `requires` are fields\nits section draws \u2014 its `fields`, a block\'s, the act\'s `asks`, or those of another section\nwith no `at` where its own has none; one shown only in the header or a staged section\nelsewhere is refused. One whose `requires` are\nempty is offered disabled, naming each; one whose `recommends` are empty names what\nit will leave blank and still presses; one a standing check blocks is offered\ndisabled in the check\'s words. The generated `act_<alias>` workflow re-checks all three on the\nserver, writes `set` and what was asked, and appends the status history where the\nact moves the status. A field an act asks is read-only everywhere else. A `select` input\noffers its own options and is written into a select holding the same option aliases; a `link` input picks one row of its `entity`\nand a `member` input one person, each written into a field of its kind. A field an act\nboth `requires` and `asks` never disables the press \u2014 the act asks it, required.\n\nA `file` input is one uploaded file, handed to the act\'s authored `workflow` as its file id (a sheet is read\nfrom it by `excel_get_rows` in a workflow); nothing else reads it, so `set` never writes it into a field, and it starts empty.\n\n`review: true`, beside an authored `workflow`, makes the workflow one that only proposes, and the platform the one\nthat writes. Its body calls only steps that read, and proposes the same for the same inputs and rows \u2014 one that writes,\nany agent, an app agent or a wait is refused where it is saved, applied and run \u2014 and returns in `data.review` a\nchangeset of the act\'s table: `{ "version": 1, "table_id", "creates": [{ "key", "data" }], "updates": [{ "record_id",\n"data" }] }`, `data` holding only the fields that change, by field key, as `update_records` takes them \u2014 no computed\nfield, no file \u2014 each row with an optional `note` and `ticked`, and `unplaced: [{ "title", "note"? }]` for what matched\nnothing. A create\'s `key` is the body\'s own text naming the same line on every run, unique among the creates; so a\nrepeated confirm adds no second row, the body also writes it into a `unique` field. A record is updated once; at most\n2000 rows. Anything else is refused with what is wrong, and nothing is written.\n\nA call without `approved` answers the proposal, a `sha` on each row, and writes nothing, whoever makes it. A call with\n`approved: { "updates": [{ "record_id", "sha" }], "creates": [{ "key", "sha" }] }` \u2014 the `sha` copied from the proposal \u2014\nruns the body again, and the platform writes the named rows of THAT call\'s proposal, with its values,\nnever the caller\'s, each only where it proposes what was read \u2014 an update only of a record the act ran on \u2014 through\nthe ordinary record writes, as steps of the run, every row checked first and all written in one transaction or none:\neach record\'s Activity shows it and, in a workflow, `undo_record_changes` with the run\'s id puts it back. A row no\nlonger proposed, proposed otherwise (`changed`), changing nothing, gone, locked or holding a unique value another row\nholds is left and named; the status each written row moved to, or a made row holds, is recorded in its history by the\nsame run. What is proposed stays the body\'s: match against what the rows hold now, so a row written is proposed no\nmore.\n\nThe dialog asks what the act asks, lists the proposal to tick as one table \u2014 what matched nothing first, then a column\nfor each field any row changes, its value now against proposed, a linked row or a member by name \u2014 and confirms the\nrows left ticked; a row changed since it was read is listed again. Over every row in view the act\nis handed no rows: its body reads the rows it may change, whatever the view, bound by no count of rows; it states no\n`when`, over an entity no row rule keeps to some readers. `review` is refused beside `books`, `set`, `template`,\n`templates`, `intake`, `record`, `sign`, `confirm`, `of`, an ask of a field, and an input named `approved`. A body:\n`lotics docs workflows`.\n\n`on: "view"` runs on every row the register shows \u2014 its search, status and filters \u2014\neach row checked before any is written. `of` names a rows block\'s child entity: the\nact is offered on each child row (its menu and its drawer), its `when`, `requires`,\n`set` and checks are the child\'s, it runs on that row, and a check of the record that\nlocks the child rows locks it too. With `on: "rows"` it runs on the child rows ticked\ntogether in the record\'s task list (\xA7 Tasks) \u2014 every row checked before any is written;\nit is refused where the record lists no tasks of that child.\n\nWhat an act makes, reads, records or has signed is set out under \xA7 Papers and recordings.\n\n## Papers and recordings\n\nBeside what it writes, an act makes papers from templates (`template`, `templates`), reads papers brought into the\nrecord (`intake`), records a call or a visit (`record`) and takes a signature on the device (`sign`).\n\n<!-- generated:start apps-papers -->\n\n#### Act template\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `template` | alias | yes | A document template the act makes a paper of, kept in `into` \u2014 an html one made a PDF, an excel one a workbook |\n| `when` | map of alias \u2192 (list of alias (at least one) \\| boolean) | no | The paper starts ticked while each named select of the record holds one of these options and each named yes/no (stored, or a formula \u2014 how a multi-select is tested: `includes({needs}, {needs:x})`) is this value \u2014 a suggestion the reader changes, never a refusal; absent, it starts ticked |\n\n#### Recording\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `into` | alias | yes | A child the record lists in a timeline or rows block, linking back to it by a single link: each recording is filed as a new row of it |\n| `audio` | alias | yes | The child\'s files field the recording\'s audio is kept in |\n| `transcript` | alias | yes | The child\'s text field the transcript is kept in, a speaker\'s turn per line |\n| `video` | alias | no | The child\'s files field the screen is kept in, where the recording captured it |\n| `at` | alias | no | The child\'s date field stamped with the moment the recording started |\n| `by` | alias | no | The child\'s member field set to the person who recorded |\n\n#### Signature\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `into` | alias | yes | The record\'s files field the signature is kept in, as a picture \u2014 each signing replaces the one before |\n| `by` | alias | yes | Who signed: a text field the signer types their name into (someone with no seat in the workspace \u2014 a driver, the owner\'s supervisor), or a member field set to the person pressing, who signs as themselves |\n| `at` | alias | yes | The record\'s date field stamped with the server\'s time as the act runs |\n| `witness` | alias | no | Beside a text `by`, the member field set to the person pressing, who saw the signer sign |\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `act.into` | `into` is a files field of the one record the act is pressed on, beside its `template` or `templates`. |\n| `act.files-written` | An act\'s `writes` never names a files field of the record: a file an act makes is a paper \u2014 the record states its papers (an `expect` block over a child pictured by its files field) and the act names its slot with `paper`. |\n| `act.templates` | `templates` names each template once, kept in `into`, on one record pressed alone \u2014 never beside `template`, `asks`, `of` or an `on` over several rows. |\n| `act.intake` | `intake` names a child the record lists in a rows block that expects its title \u2014 a single select, the paper\'s kind \u2014 and is narrowed by no `where`, holding exactly one files field and needing nothing an added line does not fill; the act runs on one record, states `fills`, and states nothing but its `label`, `when` and `requires` beside them. |\n| `act.record` | `record` names a child the record draws in a timeline or a rows block with no `expect`, `under` or `where`, linking back by one single link, its row needing nothing the recording does not write: `audio` and `video` files fields, `transcript` text, `at` a date, `by` a member, each its own field; on one record, stating only `label`, `when`, `requires` and `fills` beside it. |\n| `act.fills` | `fills` names each once, only beside `intake` or `record`. Beside `record`: a field of the recording\'s row the recording does not write, never a link. Beside `intake`: a field of the record, `<link>.<field>` on the row a required one-row link names (never beside that link), or a child the record adds rows of in a rows block with no `expect`, `under` or `where`, filled in the fields that block adds \u2014 every one a new row needs among them. Each field filled is one a person writes \u2014 text, a number, a date, a yes/no, options or a single link\'s row \u2014 never a status, a milestone, a field an act writes or a link `same` narrows; a link\'s row is one the app reads of its entity. |\n| `act.fills-drawn` | *Noted, never refused:* A field `fills` writes that the record draws nowhere: the review shows the change, the record does not. |\n| `act.fills-new` | *Noted, never refused:* A child `fills` adds rows of, whose natural key the papers cannot state: every row read is added, so the same papers read twice list them twice. |\n| `act.sign` | `sign` runs on one record, never a child\'s row: `into` a files field, `by` a text field the signer types or a member field set to the person pressing, `at` a date, `witness` a member field \u2014 stated exactly beside a text `by` \u2014 each a field of its own that the act does not also ask, set or `writes`, and no other act signs into `into`. |\n\n<!-- generated:end apps-papers -->\n\n`template` makes a document from the row as the act left it and\nkeeps it in `into`; over several rows it makes one document of them all, the rows\nlisted under the entity\'s alias, and hands it back. `templates` instead names a set of\npapers kept in `into`, listed where the act stands \u2014 each made one as its file, each\nnot made yet as a placeholder \u2014 those whose `when` holds ticked to start; the press\nmakes the ticked ones (sent in `templates`), each replacing the file its template made\nbefore (the file whose `document_template_id` is that template \u2014 never a file a person\nput there), and the set downloads as one archive (`archive_<alias>`).\n\n`intake` reads papers: the press takes files, an agent (`act_<alias>` among the app\'s\nagents) reads them, and each is filed as the record\'s line of its kind in the named\nchild \u2014 that child\'s title \u2014 or a new line, its file in the child\'s one files field.\nWhat they state of each field `fills` names is shown beside what the row holds; the save\nwrites only what differs \u2014 the record\'s fields, `<link>.<field>` on the row a required\none-row link names, a child\'s rows (one found by the child\'s `natural_key` changed, else\nadded) \u2014 each refused as its own save is, and nothing written while one refuses. A single\nlink among them is filled with a row the agent finds through the app\'s read of the rows\nit may name \u2014 narrowed as its picker is \u2014 and an id naming no row of its entity is refused\nbefore the run ends; a link `same` narrows is not filled.\n\n```jsonc\n{ "alias": "read_papers", "label": "Read papers", "intake": "customer_paper", "fills": ["phone", "contact.email", "branch"] }\n```\n\n`sign` takes a signature on the device in front of the signer: the press opens a pad in a\nsheet with what the act asks \u2014 the signer\'s name, where `by` is a text field they type it\ninto \u2014 and the act keeps the picture in `into` in place of any before it, `at` stamped with\nthe server\'s time and the person pressing in `witness` (a member `by` is the person\npressing, signing as themselves). The record reads `into` as one signature \u2014 the stroke,\nwho signed, as what, when and before whom \u2014 and the act\'s paper is handed the picture under\n`into`\'s name, an html template printing it by its url (`{{#each signature}}<img src="{{url}}">{{/each}}`).\n\n```jsonc\n{ "alias": "gate_in", "label": "Make the gate-in EIR", "template": "eir_in", "into": "eir",\n  "sign": { "into": "driver_signature", "by": "driver_name", "at": "signed_at", "witness": "signed_before" } }\n```\n\n## Checks\n\n```jsonc\n"checks": [{ "field": "release_warning" }, { "field": "unpaid", "blocks": ["gate_out"] }, { "field": "locked", "blocks": ["edit"] }]\n```\n\n<!-- generated:start apps-checks -->\n\n#### Check\n\n| Key | Type | Required | Meaning |\n|---|---|---|---|\n| `field` | alias | yes | A yes/no or text formula of the record (or of the child `of` names): true or non-empty means the check stands; its label is its short name on a row\'s line, and a text formula\'s words are the sentence the record and a tooltip say |\n| `of` | alias | no | A rows block\'s child entity this check is a formula of: standing on a child row, it refuses what it blocks of that row |\n| `blocks` | `"all"` \\| list of (alias \\| `"edit"` \\| `"delete"`) (at least one) | no | Acts, "edit" (the saves and the Delete), "delete" (the Delete alone) or "all" that the standing check refuses; absent, it only warns |\n| `resolve` | alias | no | An act of this app, on the rows the check stands on, that clears it: the check\'s line links to the act where it stands, and the act keeps its own conditions |\n\n<!-- generated:end apps-checks -->\n\n<!-- generated:start rules-check -->\n\n#### Rules the check enforces\n\n| Rule | |\n|---|---|\n| `check.field` | A check\'s `field` is a yes/no or text formula of the record, or of the child `of` names. |\n| `check.of` | A check\'s `of` names a child the record lists in a rows block. |\n| `check.not-placed` | A check\'s field is never also placed on the record \u2014 the line under the header says it. |\n| `check.blocks` | A check of the record blocks its acts, `"edit"`, `"delete"` or `"all"`; a check of a child blocks that row\'s saves, its Delete, the acts `of` that child, or all \u2014 never the record\'s acts. |\n| `check.resolve` | `resolve` names an act of this app on the rows the check stands on, pressed on one row, not refused by the check, and drawn as a button \u2014 never a correction. |\n| `check.restates-meter` | A warning reading a gated meter\'s figure against its bound or pass mark is refused \u2014 the meter draws it. |\n\n<!-- generated:end rules-check -->\n\nA check is a yes/no or text formula of the record: it stands while true or\nnon-empty, and a text formula\'s words are what the reader sees. Without `blocks`\nit warns; with them it refuses the acts named, `"edit"` the record\'s own saves (and\nits Delete), `"delete"` its Delete alone, or `"all"` \u2014 on the server, in every write it\nnames. A check `of` a rows block\'s child stands on each child row: it refuses that\nrow\'s saves (`edit`), its Delete (`delete`), the acts `of` that child it names, or\n`all` of them \u2014 never the record\'s acts. A warning reading the figure of a meter that\n`gates` marks against its bound or its pass mark is refused: the meter already draws it.\n\nThe check field\'s `label` is its short name \u2014 "Over budget", "Release expired": a row\'s\nline says it in the check\'s tone (the most severe of several, and how many more), while\nits words whole are the row\'s tooltip and stand under the record\'s header. So label it\nas the reader names the problem, in a few words, and let a text formula say the\nsentence. The compiler records the fields a formula reads: a row drawing each of them\nas a control says nothing of the check on its line (the empty control says it), and a\ncheck with no `resolve` links to the first of them the record draws.\n\n## What a run remembers\n\nThe WORKSPACE remembers what each entity, field, select option, role and\ntemplate alias became here, plus which record each first row landed on and the\nfile each document path was uploaded as. The model file itself holds no live id\n\u2014 it is the portable half, and the same file applies to a demo workspace and to\na customer\'s \u2014 so the join lives where the things it names live, and one model\napplied to two workspaces holds two bindings that know nothing of each other.\n\nIt is the workspace\'s and not the file\'s because a model file is never\ncommitted: memory kept beside it is one author\'s disk, absent for a teammate, on\na second machine or after a delete \u2014 and every one of those goes quietly back to\nbinding by label, which is what grows the second table.\n\nEvery later apply binds through it: it takes the remembered id first and falls\nback to a label only for an alias nothing has bound \u2014 a field you have just\nadded, or a workspace nothing has applied this model to. That is what makes a\nrelabel on EITHER side a rename rather than one thing the workspace lacks and\none the model lacks: `apply` binds the thing it has always meant, gives a field\nor a select\'s option the label the file states, and reports the move of a table,\na template or a role \u2014 which side is right there is yours to decide, not a reason\nto refuse the run.\n\nA bound target the workspace no longer holds IS a refusal, by name: re-binding\nto whatever carries that label today is how the model comes to point at\nsomebody else\'s table. On the CLI, `lotics run restore_table` puts a deleted table back.\n\n`lotics model pull` writes a workspace that already works as a model file \u2014 the\nstarting point for another business\'s model, never a source of truth: it carries\none business\'s words and stops describing that workspace the moment either\nchanges.\n\n## A complete model\n\n```json\n{\n  "entities": [\n    {\n      "alias": "customer",\n      "label": "Customers",\n      "singular": "Customer",\n      "fields": [\n        { "alias": "name", "label": "Name", "type": "text", "required": true },\n        { "alias": "logo", "label": "Logo", "type": "files" },\n        {\n          "alias": "tier",\n          "label": "Tier",\n          "type": "select",\n          "options": [\n            { "alias": "standard", "label": "Standard", "color": "slate" },\n            { "alias": "gold", "label": "Gold", "color": "amber" }\n          ],\n          "default": ["standard"]\n        },\n        {\n          "alias": "orders",\n          "label": "Orders",\n          "type": "select_record_link",\n          "target_entity": "order",\n          "cardinality": "many",\n          "sync_both_ways": true,\n          "paired_field_alias": "customer",\n          "display_field_aliases": ["code"]\n        },\n        {\n          "alias": "total_ordered",\n          "label": "Total ordered",\n          "type": "rollup",\n          "source_field_alias": "orders",\n          "aggregate_option": { "operation": "sum", "field_key": "amount" }\n        }\n      ],\n      "views": [\n        {\n          "alias": "gold",\n          "label": "Gold customers",\n          "filters": {\n            "node_type": "condition",\n            "type": "select",\n            "field_key": "tier",\n            "operator": "has_any_of",\n            "value": ["gold"]\n          },\n          "sort": [{ "field_key": "name", "order": "asc" }]\n        }\n      ]\n    },\n    {\n      "alias": "order",\n      "label": "Orders",\n      "singular": "Order",\n      "fields": [\n        { "alias": "code", "label": "Order no.", "type": "text", "unique": true },\n        { "alias": "placed_on", "label": "Placed on", "type": "date", "format": "date" },\n        {\n          "alias": "amount",\n          "label": "Amount",\n          "type": "number",\n          "notation": { "style": "currency", "currency": "VND" }\n        },\n        {\n          "alias": "total",\n          "label": "Total with VAT",\n          "type": "formula",\n          "formula": { "expression": "{amount} * 1.1", "notation": { "style": "currency", "currency": "VND" } }\n        },\n        {\n          "alias": "customer",\n          "label": "Customer",\n          "type": "select_record_link",\n          "target_entity": "customer",\n          "cardinality": "one",\n          "sync_both_ways": true,\n          "paired_field_alias": "orders",\n          "display_field_aliases": ["name"]\n        },\n        { "alias": "note", "label": "Note", "type": "text" }\n      ]\n    }\n  ],\n  "roles": [{ "alias": "sales", "label": "Sales" }],\n  "records": {\n    "customer": { "title": "name", "image": "logo", "party": "organization", "figure": "total_ordered" },\n    "order": { "title": "customer", "subtitle": ["code", "placed_on"], "figure": "amount", "starts": { "placed_on": "today" } }\n  },\n  "apps": [\n    {\n      "alias": "customers",\n      "name": "Customers",\n      "entity": "customer",\n      "register": {\n        "columns": ["tier"],\n        "readings": [{ "breakdown": "customer", "by": "tier", "value": "total_ordered" }]\n      },\n      "record": {\n        "sections": [\n          { "title": "Account", "fields": ["tier"] },\n          { "title": "Orders", "blocks": [{ "rows": "order", "columns": ["total"], "create": ["code", "amount"] }] }\n        ]\n      }\n    },\n    {\n      "alias": "orders",\n      "name": "Orders",\n      "entity": "order",\n      "register": {\n        "filters": ["customer"],\n        "create": ["code", "customer", "placed_on"],\n        "readings": [{ "trend": "order", "over": "placed_on", "value": "amount" }]\n      },\n      "record": { "door": "drawer", "sections": [{ "title": "Order", "fields": ["note"] }] }\n    }\n  ],\n  "rows": {\n    "customer": [\n      { "ref": "acme", "fields": { "name": "Acme Trading", "tier": "gold" } },\n      { "ref": "bluebird", "fields": { "name": "Bluebird Foods", "tier": "standard" } }\n    ],\n    "order": [\n      {\n        "ref": "so_1001",\n        "fields": {\n          "code": "SO-1001",\n          "placed_on": "@month-start+2",\n          "amount": 4200000,\n          "customer": "customer:acme"\n        }\n      },\n      {\n        "ref": "so_1002",\n        "fields": {\n          "code": "SO-1002",\n          "placed_on": "@today-3",\n          "amount": 1150000,\n          "customer": "customer:bluebird"\n        }\n      }\n    ]\n  }\n}\n```\n\nEach app of this file, as its reader will see it:\n\n```\nApp customers \u2014 "Customers" over Customers (customer)\n  Register \u2014 table (default), newest first (default)\n    row      [Logo] \xB7 Name \xB7 figure Total ordered\n    columns  Tier\n    filters  \u2014\n    readings "Tier" \u2014 Total ordered summed per Tier, over the rows in view (default)\n    add      Name (default)\n  Record \u2014 a drawer (default)\n    header   image Logo \xB7 title Name \xB7 figure Total ordered\n    checks   \u2014\n    header \u22EF Delete\n    sections 1. "Account"\n                fields Tier\n             2. "Orders"\n                block  Orders (default) \u2014 rows of Orders through Customer; columns Total with VAT; add asks Order no., Amount\n    thread   \u2014\n    history  \u2014\n    acts     \u2014\n  Reads Customers, Orders\n\nApp orders \u2014 "Orders" over Orders (order)\n  Register \u2014 table (default), newest first (default)\n    row      Customer \xB7 under it Order no., Placed on \xB7 figure Amount\n    columns  \u2014\n    filters  Customer\n    readings "Amount" \u2014 Amount summed per period by Placed on, over the rows in view (default)\n    add      Order no., Customer, Placed on \u2014 starting Placed on at today\n  Record \u2014 a drawer\n    header   title Customer \xB7 subtitle Order no., Placed on \xB7 figure Amount\n    checks   \u2014\n    header \u22EF Delete\n    sections 1. "Order"\n                fields Note\n    thread   \u2014\n    history  \u2014\n    acts     \u2014\n  Reads Orders, Customers\n\n```\n\nEach `(default)` is a value the model left to the system: the door a record opens\nthrough \u2014 a drawer, since neither record has a stage or more than three sections \u2014 the\norder rows open in, and what an add asks. The order\'s one section holds every field a\nperson writes that the header does not already show. The customer\'s orders\nare a block in its "Orders" section, never its own `Orders` link as a field as well:\none fact, one place. An order is titled by its customer and read by its number under\nit; the block names what its add asks, since a subtitle or a figure is never asked by\ndefault. `Total ordered` is a rollup, so it is read and never asked; the\norders app\'s record opens in a drawer, because its rows are worked one after another.\n';
 
 // docs/examples.md
 var examples_default = '# Worked examples\n\nEach section is one treatment, cut from a complete model of an invented business: the job, the keys to\nread, where the treatment is wrong, and the excerpt \u2014 an app the check passes with no finding, as stated;\nthe `records` of every entity it draws; those entities\' fields it names, by what each holds and how it is\ndrawn; and the templates it makes. Left out: labels, descriptions, `required`, `unique`, `default`, a link\'s\npairing, how a computed field computes, and template contents. Choosing among them: the `design` reference.\nEvery key: the `model` reference, at the pages each section names under **Keys**.\n\n## Calendar\n\n**The job.** Book visits on the days they happen, and see a week\'s work at a glance.\n\n**Read.** `register.layout: "calendar"`; each visit stands over its span because its `records` line holds two dates (`scheduled_for`, `ends_at`).\n\n**Keys.** `model/calendar`\n\n**Not when.** Rows booked on a resource that two may not share at once \u2014 that is `lanes`. Rows with a date nobody plans by (an invoice\'s date) stay a table.\n\n```json\n{\n  "entities": [\n    {\n      "alias": "service_visit",\n      "fields": [\n        {"alias": "customer", "type": "select_record_link", "target_entity": "customer", "cardinality": "one"},\n        {"alias": "scheduled_for", "type": "date", "format": "datetime"},\n        {"alias": "ends_at", "type": "date", "format": "datetime"},\n        {"alias": "engineer", "type": "select_record_link", "target_entity": "engineer", "cardinality": "one"},\n        {\n          "alias": "job",\n          "type": "select",\n          "options": [{"alias": "inspection", "color": "sky"}, {"alias": "repair", "color": "orange"}]\n        },\n        {"alias": "booked_on", "type": "date"},\n        {"alias": "parts_ready_on", "type": "date"},\n        {"alias": "arrived_on", "type": "date"},\n        {"alias": "hours", "type": "number", "notation": {"style": "unit", "unit": "h"}},\n        {"alias": "report", "type": "text", "format": "markdown"},\n        {"alias": "completed_on", "type": "date"}\n      ]\n    }\n  ],\n  "records": {\n    "service_visit": {\n      "title": "customer",\n      "subtitle": ["scheduled_for", "ends_at"],\n      "status": {\n        "milestones": ["booked_on", {"field": "parts_ready_on", "when": {"job": ["repair"]}}, "arrived_on", "completed_on"],\n        "closed": ["completed_on"]\n      },\n      "figure": "hours",\n      "due": ["scheduled_for"]\n    }\n  },\n  "apps": [\n    {\n      "alias": "visits",\n      "name": "Service visits",\n      "description": "Engineers\' visits to customers on site, booked and completed by the day.",\n      "icon": "calendar",\n      "entity": "service_visit",\n      "register": {\n        "columns": ["engineer", "job"],\n        "filters": ["customer"],\n        "sort": {"field": "scheduled_for"},\n        "layout": "calendar",\n        "create": ["customer", "job", "scheduled_for", "ends_at", "engineer"],\n        "readings": [\n          {"metric": "service_visit", "where": {"job": ["repair"]}, "label": "Repairs"},\n          {"breakdown": "service_visit", "by": "engineer", "value": "hours"}\n        ]\n      },\n      "record": {\n        "sections": [\n          {"title": "Visit", "at": ["booked_on", "parts_ready_on"], "fields": ["job"], "acts": ["reschedule"]},\n          {"title": "Report", "at": ["arrived_on"], "fields": ["engineer", "report"], "acts": ["complete"]}\n        ]\n      },\n      "acts": [\n        {\n          "alias": "complete",\n          "label": "Complete visit",\n          "requires": ["engineer"],\n          "asks": ["hours", {"input": "summary", "label": "What was done", "type": "long_text", "required": true}],\n          "set": {"report": "input:summary", "completed_on": "now"}\n        },\n        {"alias": "reschedule", "label": "Reschedule", "asks": ["scheduled_for", "ends_at"]}\n      ]\n    }\n  ]\n}\n```\n\n## Lanes\n\n**The job.** Put each service visit on an engineer\'s day by the hour, and see at once who is free between visits.\n\n**Read.** `register.layout: "lanes"` with `lanes` naming the one-row link to the resource (the engineer); every engineer stands as a lane, empty or not.\n\n**Keys.** `model/lanes`\n\n**Not when.** The resource is not a row of the model (a free-text room name), or rows never compete for one \u2014 a `calendar` reads them by day.\n\n```json\n{\n  "entities": [\n    {\n      "alias": "service_visit",\n      "fields": [\n        {"alias": "customer", "type": "select_record_link", "target_entity": "customer", "cardinality": "one"},\n        {"alias": "scheduled_for", "type": "date", "format": "datetime"},\n        {"alias": "ends_at", "type": "date", "format": "datetime"},\n        {"alias": "engineer", "type": "select_record_link", "target_entity": "engineer", "cardinality": "one"},\n        {\n          "alias": "job",\n          "type": "select",\n          "options": [{"alias": "inspection", "color": "sky"}, {"alias": "repair", "color": "orange"}]\n        },\n        {"alias": "booked_on", "type": "date"},\n        {"alias": "parts_ready_on", "type": "date"},\n        {"alias": "arrived_on", "type": "date"},\n        {"alias": "hours", "type": "number", "notation": {"style": "unit", "unit": "h"}},\n        {"alias": "completed_on", "type": "date"}\n      ]\n    },\n    {\n      "alias": "engineer",\n      "fields": [\n        {"alias": "name", "type": "text"},\n        {"alias": "base", "type": "select_record_link", "target_entity": "warehouse", "cardinality": "one"}\n      ]\n    }\n  ],\n  "records": {\n    "service_visit": {\n      "title": "customer",\n      "subtitle": ["scheduled_for", "ends_at"],\n      "status": {\n        "milestones": ["booked_on", {"field": "parts_ready_on", "when": {"job": ["repair"]}}, "arrived_on", "completed_on"],\n        "closed": ["completed_on"]\n      },\n      "figure": "hours",\n      "due": ["scheduled_for"]\n    },\n    "engineer": {"title": "name", "subtitle": ["base"], "party": "person"}\n  },\n  "apps": [\n    {\n      "alias": "dispatch",\n      "name": "Dispatch",\n      "description": "Each engineer\'s visits across the day, and the free time between them to book into.",\n      "icon": "wrench",\n      "entity": "service_visit",\n      "register": {\n        "columns": ["job"],\n        "search": ["customer"],\n        "layout": "lanes",\n        "lanes": "engineer",\n        "create": ["customer", "job"]\n      },\n      "record": {"door": "drawer", "sections": [{"title": "Booking", "fields": ["engineer", "job"]}]}\n    }\n  ]\n}\n```\n\n## Gantt\n\n**The job.** Read every hire as a bar from the day the machine goes out to the day it is due back, against today.\n\n**Read.** `register.layout: "gantt"` and `register.gantt.start`; with no end stated, the bar ends at the entity\'s first `due`.\n\n**Keys.** `model/gantt`\n\n**Not when.** Rows that last a day or less (a visit, a shift) \u2014 `calendar` or `lanes`; a plan with no dates set yet.\n\n```json\n{\n  "entities": [\n    {\n      "alias": "phieu_thue",\n      "fields": [\n        {\n          "alias": "khach_hang",\n          "type": "select_record_link",\n          "target_entity": "khach_hang",\n          "cardinality": "one"\n        },\n        {"alias": "so_phieu", "type": "text"},\n        {\n          "alias": "trang_thai",\n          "type": "select",\n          "options": [\n            {"alias": "moi", "color": "slate"},\n            {"alias": "dang_thue", "color": "blue"},\n            {"alias": "da_tra", "color": "green"},\n            {"alias": "huy", "color": "gray"}\n          ]\n        },\n        {"alias": "phu_trach", "type": "select_member"},\n        {"alias": "ngay_giao", "type": "date"},\n        {"alias": "han_tra", "type": "date"},\n        {"alias": "ngay_tra", "type": "date"},\n        {\n          "alias": "tinh_trang_tra",\n          "type": "select",\n          "options": [\n            {"alias": "tot", "color": "green"},\n            {"alias": "tray_xuoc", "color": "amber"},\n            {"alias": "hu_hong", "color": "red"}\n          ]\n        },\n        {"alias": "so_ngay", "type": "formula"},\n        {"alias": "tong_tien", "type": "rollup"}\n      ]\n    }\n  ],\n  "records": {\n    "phieu_thue": {\n      "title": "khach_hang",\n      "subtitle": ["so_phieu"],\n      "status": {"field": "trang_thai", "closed": ["da_tra", "huy"], "history": "lich_su_phieu"},\n      "figure": "tong_tien",\n      "due": ["han_tra"]\n    }\n  },\n  "apps": [\n    {\n      "alias": "tien_do_thue",\n      "name": "Ti\u1EBFn \u0111\u1ED9 cho thu\xEA",\n      "description": "M\u1ED7i phi\u1EBFu thu\xEA m\u1ED9t thanh t\u1EEB ng\xE0y giao m\xE1y \u0111\u1EBFn h\u1EA1n tr\u1EA3, \u0111\u1ECDc theo h\xF4m nay: phi\u1EBFu n\xE0o s\u1EAFp \u0111\u1EBFn h\u1EA1n, phi\u1EBFu n\xE0o qu\xE1 h\u1EA1n; k\xE9o thanh \u0111\u1EC3 d\u1EDDi ng\xE0y giao ho\u1EB7c gia h\u1EA1n tr\u1EA3, v\xE0 nh\u1EADn m\xE1y v\u1EC1 khi kh\xE1ch tr\u1EA3.",\n      "icon": "calendar-range",\n      "theme": {"color": "teal"},\n      "entity": "phieu_thue",\n      "register": {\n        "columns": ["phu_trach"],\n        "filters": ["phu_trach", "khach_hang"],\n        "layout": "gantt",\n        "gantt": {"start": "ngay_giao"},\n        "remove": false,\n        "create": false,\n        "readings": [\n          {"metric": "phieu_thue", "where": {"trang_thai": ["dang_thue"]}, "label": "Phi\u1EBFu \u0111ang cho thu\xEA"},\n          {\n            "metric": "phieu_thue",\n            "value": "tong_tien",\n            "where": {"trang_thai": ["dang_thue"]},\n            "label": "Ti\u1EC1n thu\xEA \u0111ang ch\u1EA1y"\n          }\n        ]\n      },\n      "record": {\n        "sections": [\n          {"title": "Phi\u1EBFu thu\xEA", "fields": ["ngay_giao", "han_tra"]},\n          {"title": "\u0110ang thu\xEA", "at": ["dang_thue"], "fields": ["so_ngay", "ngay_tra"], "acts": ["nhan_tra"]}\n        ]\n      },\n      "acts": [\n        {\n          "alias": "nhan_tra",\n          "label": "Nh\u1EADn m\xE1y tr\u1EA3",\n          "when": {"trang_thai": ["dang_thue"]},\n          "asks": ["tinh_trang_tra"],\n          "set": {"trang_thai": "da_tra", "ngay_tra": "now"},\n          "confirm": true\n        }\n      ]\n    }\n  ]\n}\n```\n\n## Roster\n\n**The job.** See who works which shift on each day of the week or the month.\n\n**Read.** `register.layout: "roster"` over the people; `register.roster` names the child whose rows fill the days \u2014 one link back and a date on its line.\n\n**Keys.** `model/roster`\n\n**Not when.** Rows that are themselves the bookings (a stay over several days) \u2014 a `calendar` or `lanes` draws them; a roster\'s row is what the days are filled for.\n\n```json\n{\n  "entities": [\n    {\n      "alias": "nha_si",\n      "fields": [\n        {"alias": "ho_ten", "type": "text"},\n        {\n          "alias": "chuyen_mon",\n          "type": "select",\n          "options": [\n            {"alias": "tong_quat", "color": "blue"},\n            {"alias": "chinh_nha", "color": "purple"},\n            {"alias": "nha_chu", "color": "green"},\n            {"alias": "phuc_hinh", "color": "orange"}\n          ]\n        },\n        {"alias": "dien_thoai", "type": "text"}\n      ]\n    },\n    {\n      "alias": "lich_truc",\n      "fields": [\n        {"alias": "nha_si", "type": "select_record_link", "target_entity": "nha_si", "cardinality": "one"},\n        {\n          "alias": "ca",\n          "type": "select",\n          "options": [\n            {"alias": "sang", "color": "blue"},\n            {"alias": "chieu", "color": "purple"},\n            {"alias": "ca_ngay", "color": "green"},\n            {"alias": "nghi", "color": "gray"}\n          ]\n        },\n        {"alias": "ngay", "type": "date"},\n        {"alias": "ghe", "type": "select_record_link", "target_entity": "ghe", "cardinality": "one"}\n      ]\n    }\n  ],\n  "records": {\n    "nha_si": {"title": "ho_ten", "subtitle": ["chuyen_mon"], "party": "person"},\n    "lich_truc": {"title": "ca", "subtitle": ["ngay", "ghe"]}\n  },\n  "apps": [\n    {\n      "alias": "lich_truc",\n      "name": "L\u1ECBch tr\u1EF1c",\n      "description": "Ai tr\u1EF1c ca n\xE0o, \u1EDF gh\u1EBF n\xE0o, trong tu\u1EA7n v\xE0 trong th\xE1ng.",\n      "icon": "users",\n      "entity": "nha_si",\n      "register": {\n        "filters": ["chuyen_mon"],\n        "layout": "roster",\n        "roster": "lich_truc",\n        "create": ["ho_ten", "chuyen_mon", "dien_thoai"]\n      }\n    }\n  ]\n}\n```\n\n## Cards\n\n**The job.** Find an item by its picture, and count what the shelf holds.\n\n**Read.** `register.layout: "cards"` over rows whose `records.image` is a photo; `scope` keeps the app inside one warehouse at a time.\n\n**Keys.** `model/cards`, `model/records`, `model/apps`\n\n**Not when.** Rows with no picture \u2014 cards of words are a table drawn worse.\n\n```json\n{\n  "entities": [\n    {\n      "alias": "stock_item",\n      "fields": [\n        {"alias": "name", "type": "text"},\n        {\n          "alias": "warehouse",\n          "type": "select_record_link",\n          "target_entity": "warehouse",\n          "cardinality": "one"\n        },\n        {"alias": "photo", "type": "files"},\n        {"alias": "sku", "type": "text"},\n        {\n          "alias": "category",\n          "type": "select",\n          "options": [\n            {"alias": "pumps", "color": "blue"},\n            {"alias": "valves", "color": "teal"},\n            {"alias": "seals", "color": "amber"},\n            {"alias": "motors", "color": "violet"}\n          ]\n        },\n        {"alias": "on_hand", "type": "number"},\n        {"alias": "minimum", "type": "number"},\n        {"alias": "price", "type": "number", "notation": {"style": "currency", "currency": "USD"}},\n        {"alias": "supplier_page", "type": "text", "format": "link"},\n        {"alias": "last_counted", "type": "date"},\n        {"alias": "counted_by", "type": "select_member"},\n        {"alias": "count_note", "type": "text"}\n      ]\n    },\n    {\n      "alias": "order_line",\n      "fields": [\n        {"alias": "item", "type": "select_record_link", "target_entity": "stock_item", "cardinality": "one"},\n        {"alias": "order", "type": "select_record_link", "target_entity": "order", "cardinality": "one"},\n        {"alias": "quantity", "type": "number"},\n        {"alias": "shipped", "type": "number"},\n        {"alias": "picked", "type": "number"},\n        {"alias": "unit_price", "type": "number", "notation": {"style": "currency", "currency": "USD"}},\n        {"alias": "amount", "type": "formula"},\n        {"alias": "category", "type": "lookup"}\n      ]\n    }\n  ],\n  "records": {\n    "stock_item": {\n      "title": "name",\n      "subtitle": ["sku", "category"],\n      "image": "photo",\n      "figure": "on_hand",\n      "limits": {"on_hand": 400},\n      "gates": {"on_hand": "minimum"}\n    },\n    "order_line": {\n      "title": "item",\n      "subtitle": ["order", "unit_price"],\n      "figure": "amount",\n      "limits": {"shipped": "quantity", "picked": "quantity"}\n    }\n  },\n  "apps": [\n    {\n      "alias": "stock",\n      "name": "Stock",\n      "description": "What the store holds of each item, against its shelf and its minimum.",\n      "icon": "boxes",\n      "theme": {"color": "teal"},\n      "entity": "stock_item",\n      "scope": "warehouse",\n      "register": {\n        "columns": ["price"],\n        "filters": ["on_hand"],\n        "search": ["name", "sku"],\n        "layout": "cards",\n        "create": false,\n        "export": true,\n        "readings": [{"breakdown": "stock_item", "by": "category", "value": "on_hand"}]\n      },\n      "record": {\n        "sections": [\n          {"title": "Item", "fields": ["price", "minimum", "supplier_page"]},\n          {"title": "Last count", "fields": ["last_counted", "counted_by", "count_note"], "acts": ["count"]},\n          {"title": "On order", "blocks": [{"rows": "order_line", "columns": ["quantity"]}]}\n        ]\n      },\n      "acts": [\n        {\n          "alias": "count",\n          "label": "Count stock",\n          "asks": [\n            {"input": "counted", "label": "Units on the shelf", "type": "number", "required": true},\n            {"input": "remark", "label": "Remark", "type": "long_text"}\n          ],\n          "set": {\n            "on_hand": "input:counted",\n            "last_counted": "now",\n            "counted_by": "me",\n            "count_note": "input:remark"\n          }\n        }\n      ]\n    }\n  ]\n}\n```\n\n## Party\n\n**The job.** Keep each customer account \u2014 who they are, what they ordered, what was said to them.\n\n**Read.** `records.customer.party: "organization"` and its `image` (the logo); a `timeline` of touches, a `trend` of its orders, and its papers `expect`ed by kind.\n\n**Keys.** `model/records`, `model/timeline-and-agenda`, `model/blocks`, `model/reading-blocks`\n\n**Not when.** A list of customers is not a job by itself: the customer is a link on the desk whose rows name it, unless the job is the account itself.\n\n```json\n{\n  "entities": [\n    {\n      "alias": "customer",\n      "fields": [\n        {"alias": "name", "type": "text"},\n        {"alias": "logo", "type": "files"},\n        {"alias": "code", "type": "text"},\n        {\n          "alias": "tier",\n          "type": "select",\n          "options": [\n            {"alias": "key", "color": "violet"},\n            {"alias": "standard", "color": "sky"},\n            {"alias": "lapsed", "color": "gray"}\n          ]\n        },\n        {"alias": "phone", "type": "text"},\n        {"alias": "website", "type": "text", "format": "link"},\n        {"alias": "account_manager", "type": "select_member"},\n        {"alias": "credit_limit", "type": "number", "notation": {"style": "currency", "currency": "USD"}},\n        {"alias": "outstanding", "type": "rollup"},\n        {"alias": "over_limit", "type": "formula"},\n        {\n          "alias": "papers_needed",\n          "type": "select",\n          "options": [\n            {"alias": "credit_application", "color": "blue"},\n            {"alias": "trade_reference", "color": "violet"},\n            {"alias": "vat_certificate", "color": "teal"}\n          ],\n          "multi": true\n        },\n        {"alias": "notes", "type": "text", "format": "markdown"}\n      ]\n    },\n    {\n      "alias": "order",\n      "fields": [\n        {"alias": "customer", "type": "select_record_link", "target_entity": "customer", "cardinality": "one"},\n        {"alias": "reference", "type": "text"},\n        {\n          "alias": "stage",\n          "type": "select",\n          "options": [\n            {"alias": "draft", "color": "slate"},\n            {"alias": "confirmed", "color": "blue"},\n            {"alias": "picking", "color": "amber"},\n            {"alias": "shipped", "color": "indigo"},\n            {"alias": "delivered", "color": "green"},\n            {"alias": "cancelled", "color": "rose"}\n          ]\n        },\n        {"alias": "placed", "type": "date"},\n        {"alias": "due_date", "type": "date"},\n        {"alias": "total", "type": "rollup"},\n        {"alias": "balance", "type": "formula"},\n        {"alias": "units_ordered", "type": "rollup"},\n        {"alias": "units_shipped", "type": "rollup"},\n        {"alias": "units_picked", "type": "rollup"},\n        {"alias": "notes", "type": "text", "format": "markdown"},\n        {"alias": "paid_in_full", "type": "formula"}\n      ]\n    },\n    {\n      "alias": "customer_paper",\n      "fields": [\n        {\n          "alias": "kind",\n          "type": "select",\n          "options": [\n            {"alias": "credit_application", "color": "blue"},\n            {"alias": "trade_reference", "color": "violet"},\n            {"alias": "vat_certificate", "color": "teal"}\n          ]\n        },\n        {"alias": "customer", "type": "select_record_link", "target_entity": "customer", "cardinality": "one"},\n        {"alias": "received_on", "type": "date"},\n        {"alias": "file", "type": "files"}\n      ]\n    },\n    {\n      "alias": "touch",\n      "fields": [\n        {"alias": "said", "type": "text"},\n        {"alias": "customer", "type": "select_record_link", "target_entity": "customer", "cardinality": "one"},\n        {"alias": "by", "type": "select_member"}\n      ]\n    }\n  ],\n  "records": {\n    "customer": {\n      "title": "name",\n      "subtitle": ["tier"],\n      "image": "logo",\n      "party": "organization",\n      "figure": "outstanding",\n      "limits": {"outstanding": "credit_limit"}\n    },\n    "order": {\n      "title": "reference",\n      "subtitle": ["customer", "placed"],\n      "status": {"field": "stage", "closed": ["delivered", "cancelled"], "history": "order_stage"},\n      "figure": "total",\n      "limits": {"units_shipped": "units_ordered", "units_picked": "units_ordered"},\n      "due": ["due_date"]\n    },\n    "customer_paper": {"title": "kind", "image": "file"},\n    "touch": {"title": "said"}\n  },\n  "apps": [\n    {\n      "alias": "customers",\n      "name": "Customers",\n      "description": "Who we sell to, what they owe, and what was said.",\n      "icon": "users",\n      "theme": {"color": "violet"},\n      "entity": "customer",\n      "reads": "shared",\n      "register": {\n        "columns": ["phone", "account_manager"],\n        "filters": ["account_manager"],\n        "sort": {"field": "name"},\n        "opens": {"tier": ["key", "standard"]},\n        "create": ["name", "code", "credit_limit"],\n        "readings": [\n          {"breakdown": "customer", "by": "tier", "value": "outstanding"},\n          {"breakdown": "customer", "by": "account_manager", "value": "outstanding"}\n        ]\n      },\n      "record": {\n        "door": "drawer",\n        "sections": [\n          {"title": "Contact", "fields": ["phone", "website"]},\n          {\n            "title": "Account",\n            "fields": ["code", "account_manager", "credit_limit"],\n            "acts": ["reassign", "lapse", "reinstate"]\n          },\n          {\n            "title": "Orders",\n            "blocks": [\n              {\n                "trend": "order",\n                "over": "placed",\n                "value": "total",\n                "where": {"stage": ["confirmed", "picking", "shipped", "delivered"]},\n                "label": "Order value"\n              },\n              {\n                "rows": "order",\n                "via": "customer",\n                "title": "Open orders",\n                "columns": ["due_date"],\n                "create": false,\n                "where": {"stage": ["draft", "confirmed", "picking", "shipped"]}\n              },\n              {\n                "rows": "order",\n                "via": "customer",\n                "title": "Shipped, still owed",\n                "columns": ["balance"],\n                "create": false,\n                "where": {"stage": ["shipped", "delivered"], "paid_in_full": false}\n              },\n              {\n                "list": "service_visit",\n                "columns": ["engineer", "job"],\n                "app": "visits",\n                "label": "Service visits"\n              }\n            ]\n          },\n          {\n            "title": "Account papers",\n            "blocks": [\n              {\n                "rows": "customer_paper",\n                "via": "customer",\n                "columns": ["received_on"],\n                "expect": "kind",\n                "of": "papers_needed"\n              }\n            ]\n          },\n          {"title": "Contact log", "blocks": [{"timeline": "touch", "via": "customer"}]},\n          {"title": "Notes", "blocks": [{"text": "notes"}]}\n        ]\n      },\n      "acts": [\n        {\n          "alias": "lapse",\n          "label": "Mark lapsed",\n          "when": {"tier": ["key", "standard"]},\n          "set": {"tier": "lapsed"},\n          "confirm": true\n        },\n        {\n          "alias": "reinstate",\n          "label": "Reinstate",\n          "when": {"tier": ["lapsed"]},\n          "asks": [\n            {\n              "input": "back_to",\n              "label": "Back to",\n              "type": "select",\n              "options": [\n                {"alias": "key", "label": "Key account", "color": "violet"},\n                {"alias": "standard", "label": "Standard", "color": "sky"}\n              ],\n              "required": true\n            }\n          ],\n          "set": {"tier": "input:back_to"}\n        },\n        {\n          "alias": "reassign",\n          "label": "Reassign",\n          "asks": [{"input": "to", "label": "Account manager", "type": "member", "required": true}],\n          "set": {"account_manager": "input:to"}\n        }\n      ],\n      "checks": [{"field": "over_limit"}]\n    }\n  ]\n}\n```\n\n## Case\n\n**The job.** Gather an applicant\'s papers into one case, make the forms it needs, and file it on time.\n\n**Read.** `expect` blocks for the papers brought (one line per kind, the missing ones empty), an act\'s `templates` for the forms made (ticked and made at once, kept in `into`), and `intake` reading the papers brought.\n\n**Keys.** `model/blocks`, `model/papers-and-recordings`\n\n**Not when.** A record that needs no papers, or one paper made once \u2014 a single `template` act.\n\n```json\n{\n  "entities": [\n    {\n      "alias": "ho_so",\n      "fields": [\n        {\n          "alias": "khach_hang",\n          "type": "select_record_link",\n          "target_entity": "khach_hang",\n          "cardinality": "one"\n        },\n        {"alias": "du_an", "type": "select_record_link", "target_entity": "du_an", "cardinality": "one"},\n        {"alias": "ma_ho_so", "type": "autonumber"},\n        {\n          "alias": "dich_vu",\n          "type": "select",\n          "options": [{"alias": "tron_goi", "color": "blue"}, {"alias": "lam_ho_so", "color": "violet"}]\n        },\n        {\n          "alias": "doi_tuong",\n          "type": "select",\n          "options": [\n            {"alias": "thu_nhap_thap", "color": "sky"},\n            {"alias": "cong_nhan", "color": "teal"},\n            {"alias": "can_bo", "color": "indigo"},\n            {"alias": "luc_luong", "color": "green"},\n            {"alias": "ho_ngheo", "color": "amber"},\n            {"alias": "nguoi_co_cong", "color": "rose"}\n          ]\n        },\n        {\n          "alias": "tinh_trang_nha_o",\n          "type": "select",\n          "options": [{"alias": "chua_co_nha", "color": "gray"}, {"alias": "nha_chat", "color": "orange"}]\n        },\n        {"alias": "giay_chung_nhan_so", "type": "text"},\n        {"alias": "dien_tich_nha", "type": "number"},\n        {"alias": "sale", "type": "select_member"},\n        {"alias": "xu_ly", "type": "select_member"},\n        {"alias": "can_bo_sung", "type": "boolean"},\n        {"alias": "phi_dich_vu", "type": "number", "notation": {"style": "currency", "currency": "VND"}},\n        {\n          "alias": "loai_can",\n          "type": "select",\n          "options": [\n            {"alias": "studio", "color": "sky"},\n            {"alias": "mot_pn", "color": "blue"},\n            {"alias": "hai_pn", "color": "indigo"},\n            {"alias": "ba_pn", "color": "violet"}\n          ]\n        },\n        {"alias": "khoi", "type": "select_record_link", "target_entity": "khoi_nha", "cardinality": "one"},\n        {"alias": "can_so", "type": "number"},\n        {"alias": "tang", "type": "number"},\n        {"alias": "hoa_hong_sale", "type": "number", "notation": {"style": "currency", "currency": "VND"}},\n        {"alias": "ngay_thu_phi", "type": "date"},\n        {"alias": "ngay_nhan_giay_to", "type": "date"},\n        {"alias": "ngay_lap_ho_so", "type": "date"},\n        {"alias": "ngay_nop_cdt", "type": "date"},\n        {"alias": "ngay_cdt_duyet", "type": "date"},\n        {"alias": "ngay_so_xd_duyet", "type": "date"},\n        {"alias": "ngay_boc_tham", "type": "date"},\n        {"alias": "ngay_ky_hdmb", "type": "date"},\n        {"alias": "ngay_ban_giao", "type": "date"},\n        {"alias": "bo_ho_so", "type": "files"},\n        {"alias": "hop_dong_mua_ban", "type": "files"},\n        {"alias": "giay_to", "type": "select_record_link", "target_entity": "giay_to", "cardinality": "many"},\n        {\n          "alias": "thanh_vien",\n          "type": "select_record_link",\n          "target_entity": "thanh_vien",\n          "cardinality": "many"\n        },\n        {\n          "alias": "phieu_thu",\n          "type": "select_record_link",\n          "target_entity": "phieu_thu",\n          "cardinality": "many"\n        },\n        {"alias": "dien_thoai", "type": "lookup"},\n        {"alias": "cccd", "type": "lookup"},\n        {"alias": "ngay_sinh", "type": "lookup"},\n        {"alias": "dia_chi", "type": "lookup"},\n        {"alias": "da_thu", "type": "rollup"},\n        {"alias": "chua_thu_phi", "type": "formula"},\n        {"alias": "con_no_phi", "type": "formula"},\n        {"alias": "vuot_thu_nhap", "type": "formula"},\n        {"alias": "da_hoan_tat", "type": "formula"}\n      ]\n    },\n    {\n      "alias": "thanh_vien",\n      "fields": [\n        {"alias": "ho_ten", "type": "text"},\n        {"alias": "ho_so", "type": "select_record_link", "target_entity": "ho_so", "cardinality": "one"},\n        {\n          "alias": "quan_he",\n          "type": "select",\n          "options": [\n            {"alias": "nguoi_dung_don", "color": "blue"},\n            {"alias": "vo_chong", "color": "violet"},\n            {"alias": "con", "color": "teal"},\n            {"alias": "bo_me", "color": "amber"},\n            {"alias": "khac", "color": "gray"}\n          ]\n        },\n        {"alias": "ngay_sinh", "type": "date"},\n        {"alias": "cccd", "type": "text"},\n        {"alias": "thu_nhap", "type": "number", "notation": {"style": "currency", "currency": "VND"}}\n      ]\n    },\n    {\n      "alias": "phieu_thu",\n      "fields": [\n        {\n          "alias": "khoan",\n          "type": "select",\n          "options": [\n            {"alias": "dat_coc", "color": "blue"},\n            {"alias": "tat_toan", "color": "indigo"},\n            {"alias": "phi_ho_so", "color": "violet"}\n          ]\n        },\n        {"alias": "ho_so", "type": "select_record_link", "target_entity": "ho_so", "cardinality": "one"},\n        {"alias": "so_tien", "type": "number", "notation": {"style": "currency", "currency": "VND"}},\n        {\n          "alias": "hinh_thuc",\n          "type": "select",\n          "options": [\n            {"alias": "tien_mat", "color": "green", "mark": {"kind": "icon", "name": "banknote"}},\n            {"alias": "chuyen_khoan", "color": "blue", "mark": {"kind": "icon", "name": "arrow-right-left"}}\n          ]\n        },\n        {\n          "alias": "trang_thai",\n          "type": "select",\n          "options": [\n            {"alias": "cho_thu", "color": "amber"},\n            {"alias": "da_thu", "color": "green"},\n            {"alias": "huy", "color": "gray"}\n          ]\n        },\n        {"alias": "ngay_thu", "type": "date"},\n        {"alias": "nguoi_thu", "type": "select_member"},\n        {"alias": "da_chot", "type": "formula"}\n      ]\n    },\n    {\n      "alias": "giay_to",\n      "fields": [\n        {\n          "alias": "loai",\n          "type": "select",\n          "options": [\n            {"alias": "don_dang_ky", "color": "blue"},\n            {"alias": "can_cuoc", "color": "sky"},\n            {"alias": "giay_doi_tuong", "color": "violet"},\n            {"alias": "xac_nhan_nha_o", "color": "teal"},\n            {"alias": "xac_nhan_thu_nhap", "color": "amber"},\n            {"alias": "hon_nhan", "color": "indigo"}\n          ]\n        },\n        {"alias": "ho_so", "type": "select_record_link", "target_entity": "ho_so", "cardinality": "one"},\n        {"alias": "ngay_nhan", "type": "date"},\n        {"alias": "can_sua", "type": "text"},\n        {"alias": "tep", "type": "files"},\n        {"alias": "phai_sua", "type": "formula"}\n      ]\n    }\n  ],\n  "records": {\n    "ho_so": {\n      "title": "khach_hang",\n      "subtitle": ["dich_vu"],\n      "status": {\n        "milestones": [\n          {"field": "ngay_thu_phi", "when": {"dich_vu": ["lam_ho_so"]}},\n          "ngay_nhan_giay_to",\n          {"field": "ngay_lap_ho_so", "when": {"dich_vu": ["tron_goi"]}},\n          {"field": "ngay_nop_cdt", "when": {"dich_vu": ["tron_goi"]}},\n          {"field": "ngay_cdt_duyet", "when": {"dich_vu": ["tron_goi"]}},\n          {"field": "ngay_so_xd_duyet", "when": {"dich_vu": ["tron_goi"]}},\n          {"field": "ngay_boc_tham", "when": {"dich_vu": ["tron_goi"]}},\n          {"field": "ngay_ky_hdmb", "when": {"dich_vu": ["tron_goi"]}},\n          {"field": "ngay_ban_giao", "when": {"dich_vu": ["lam_ho_so"]}}\n        ],\n        "closed": ["ngay_ky_hdmb", "ngay_ban_giao"]\n      },\n      "figure": "phi_dich_vu"\n    },\n    "thanh_vien": {"title": "ho_ten", "subtitle": ["quan_he", "cccd"], "party": "person", "figure": "thu_nhap"},\n    "phieu_thu": {\n      "title": "khoan",\n      "subtitle": ["hinh_thuc", "ngay_thu"],\n      "status": {"field": "trang_thai", "closed": ["da_thu", "huy"]},\n      "figure": "so_tien"\n    },\n    "giay_to": {"title": "loai", "image": "tep", "starts": {"ngay_nhan": "today"}}\n  },\n  "templates": [\n    {"alias": "don_dang_ky", "type": "html", "label": "\u0110\u01A1n \u0111\u0103ng k\xFD mua nh\xE0 \u1EDF x\xE3 h\u1ED9i"},\n    {"alias": "mau_02_chua_co_nha", "type": "html", "label": "M\u1EABu 02 \u2014 X\xE1c nh\u1EADn ch\u01B0a c\xF3 nh\xE0 \u1EDF"},\n    {"alias": "mau_03_nha_chat", "type": "html", "label": "M\u1EABu 03 \u2014 X\xE1c nh\u1EADn nh\xE0 \u1EDF d\u01B0\u1EDBi 15 m\xB2/ng\u01B0\u1EDDi"},\n    {"alias": "mau_05_thu_nhap", "type": "html", "label": "M\u1EABu 05 \u2014 X\xE1c nh\u1EADn thu nh\u1EADp"},\n    {"alias": "danh_sach_nop", "type": "html", "label": "Danh s\xE1ch h\u1ED3 s\u01A1 n\u1ED9p ch\u1EE7 \u0111\u1EA7u t\u01B0"}\n  ],\n  "apps": [\n    {\n      "alias": "ho_so",\n      "name": "H\u1ED3 s\u01A1 nh\xE0 \u1EDF x\xE3 h\u1ED9i",\n      "description": "B\xE0n l\xE0m h\u1ED3 s\u01A1 c\u1EE7a t\u1EEBng d\u1EF1 \xE1n: nh\u1EADn gi\u1EA5y t\u1EDD, l\u1EADp v\xE0 n\u1ED9p h\u1ED3 s\u01A1 cho ch\u1EE7 \u0111\u1EA7u t\u01B0, theo t\u1EEBng kh\xE2u duy\u1EC7t t\u1EDBi b\u1ED1c th\u0103m v\xE0 k\xFD h\u1EE3p \u0111\u1ED3ng \u2014 ho\u1EB7c l\xE0m h\u1ED3 s\u01A1 r\u1ED3i b\xE0n giao cho kh\xE1ch t\u1EF1 n\u1ED9p.",\n      "icon": "folder-open",\n      "theme": {"color": "blue"},\n      "entity": "ho_so",\n      "scope": "du_an",\n      "register": {\n        "columns": ["xu_ly", "can_bo_sung", "doi_tuong"],\n        "filters": ["xu_ly", "can_bo_sung"],\n        "search": ["khach_hang", "ma_ho_so", "dien_thoai"],\n        "create": ["khach_hang", "dich_vu", "doi_tuong", "tinh_trang_nha_o", "loai_can", "phi_dich_vu", "sale"],\n        "export": true,\n        "readings": [\n          {"metric": "ho_so", "where": {"can_bo_sung": true}, "label": "Ch\u1EDD kh\xE1ch b\u1ED5 sung"},\n          {"metric": "ho_so", "value": "da_thu", "over": "ngay_nhan_giay_to", "label": "Ph\xED \u0111\xE3 thu"},\n          {"breakdown": "ho_so", "by": "doi_tuong"}\n        ]\n      },\n      "record": {\n        "sections": [\n          {\n            "title": "Ng\u01B0\u1EDDi \u0111\u1EE9ng \u0111\u01A1n",\n            "fields": [\n              "ma_ho_so",\n              "dien_thoai",\n              "cccd",\n              "ngay_sinh",\n              "dia_chi",\n              "doi_tuong",\n              "tinh_trang_nha_o",\n              "sale",\n              "xu_ly",\n              "can_bo_sung"\n            ],\n            "blocks": [\n              {\n                "rows": "thanh_vien",\n                "title": "H\u1ED9 gia \u0111\xECnh",\n                "columns": ["ngay_sinh"],\n                "create": ["ho_ten", "quan_he", "ngay_sinh", "cccd", "thu_nhap"]\n              }\n            ],\n            "acts": ["doc_giay_to", "giao_xu_ly", "chuyen_du_an"]\n          },\n          {\n            "title": "Nh\xE0 hi\u1EC7n c\xF3",\n            "fields": ["giay_chung_nhan_so", "dien_tich_nha"],\n            "when": {"tinh_trang_nha_o": ["nha_chat"]}\n          },\n          {\n            "title": "Ph\xED d\u1ECBch v\u1EE5",\n            "blocks": [\n              {\n                "rows": "phieu_thu",\n                "title": "Phi\u1EBFu thu",\n                "columns": ["so_tien"],\n                "create": ["khoan", "so_tien", "hinh_thuc"],\n                "where": {"khoan": ["dat_coc", "tat_toan"]},\n                "expect": "khoan",\n                "when": {"dich_vu": ["tron_goi"]}\n              },\n              {\n                "rows": "phieu_thu",\n                "title": "Phi\u1EBFu thu",\n                "columns": ["so_tien"],\n                "create": ["khoan", "so_tien", "hinh_thuc"],\n                "where": {"khoan": ["phi_ho_so"]},\n                "expect": "khoan",\n                "when": {"dich_vu": ["lam_ho_so"]}\n              }\n            ]\n          },\n          {\n            "title": "Gi\u1EA5y t\u1EDD",\n            "at": ["ngay_thu_phi"],\n            "blocks": [\n              {\n                "rows": "giay_to",\n                "title": "Gi\u1EA5y t\u1EDD",\n                "columns": ["ngay_nhan"],\n                "create": ["loai", "ngay_nhan", "can_sua", "tep"],\n                "expect": "loai"\n              }\n            ]\n          },\n          {\n            "title": "B\u1ED9 h\u1ED3 s\u01A1",\n            "description": "C\xE1c m\u1EABu \u0111\u01A1n in t\u1EEB th\xF4ng tin c\u1EE7a h\u1ED3 s\u01A1.",\n            "at": ["ngay_nhan_giay_to", "ngay_lap_ho_so"],\n            "acts": ["tao_giay_to", "nop_cdt"]\n          },\n          {\n            "title": "Ch\u1EE7 \u0111\u1EA7u t\u01B0",\n            "description": "H\u1ED3 s\u01A1 tr\u1ECDn g\xF3i n\u1ED9p ch\u1EE7 \u0111\u1EA7u t\u01B0, ch\u1EDD ch\u1EE7 \u0111\u1EA7u t\u01B0 r\u1ED3i S\u1EDF X\xE2y d\u1EF1ng duy\u1EC7t tr\u01B0\u1EDBc ng\xE0y b\u1ED1c th\u0103m.",\n            "at": ["ngay_nop_cdt", "ngay_cdt_duyet", "ngay_so_xd_duyet"],\n            "fields": ["loai_can"],\n            "when": {"dich_vu": ["tron_goi"]}\n          },\n          {\n            "title": "C\u0103n h\u1ED9",\n            "at": ["ngay_boc_tham"],\n            "fields": ["khoi", "can_so", "tang", "hoa_hong_sale"],\n            "blocks": [{"files": ["hop_dong_mua_ban"]}],\n            "when": {"dich_vu": ["tron_goi"]}\n          }\n        ]\n      },\n      "acts": [\n        {\n          "alias": "doc_giay_to",\n          "label": "\u0110\u1ECDc gi\u1EA5y t\u1EDD",\n          "intake": "giay_to",\n          "fills": [\n            "doi_tuong",\n            "tinh_trang_nha_o",\n            "giay_chung_nhan_so",\n            "dien_tich_nha",\n            "khach_hang.ho_ten",\n            "khach_hang.cccd",\n            "khach_hang.ngay_sinh",\n            "khach_hang.dia_chi",\n            "thanh_vien"\n          ]\n        },\n        {\n          "alias": "tao_giay_to",\n          "label": "T\u1EA1o gi\u1EA5y t\u1EDD",\n          "templates": [\n            {"template": "don_dang_ky"},\n            {"template": "mau_02_chua_co_nha", "when": {"tinh_trang_nha_o": ["chua_co_nha"]}},\n            {"template": "mau_03_nha_chat", "when": {"tinh_trang_nha_o": ["nha_chat"]}},\n            {"template": "mau_05_thu_nhap", "when": {"doi_tuong": ["thu_nhap_thap"]}}\n          ],\n          "into": "bo_ho_so"\n        },\n        {\n          "alias": "nop_cdt",\n          "label": "N\u1ED9p ch\u1EE7 \u0111\u1EA7u t\u01B0",\n          "when": {"dich_vu": ["tron_goi"]},\n          "requires": ["bo_ho_so", "loai_can"],\n          "asks": ["loai_can"],\n          "set": {"ngay_nop_cdt": "now"},\n          "confirm": true\n        },\n        {\n          "alias": "giao_xu_ly",\n          "label": "Giao ng\u01B0\u1EDDi x\u1EED l\xFD",\n          "asks": [{"input": "nguoi", "label": "Ng\u01B0\u1EDDi x\u1EED l\xFD", "type": "member", "required": true}],\n          "set": {"xu_ly": "input:nguoi"}\n        },\n        {\n          "alias": "chuyen_du_an",\n          "label": "Chuy\u1EC3n d\u1EF1 \xE1n",\n          "asks": [{"input": "du_an_moi", "label": "Sang d\u1EF1 \xE1n", "type": "link", "entity": "du_an", "required": true}],\n          "set": {"du_an": "input:du_an_moi"},\n          "confirm": true\n        },\n        {\n          "alias": "in_danh_sach",\n          "label": "In danh s\xE1ch n\u1ED9p ch\u1EE7 \u0111\u1EA7u t\u01B0",\n          "on": "view",\n          "template": "danh_sach_nop"\n        },\n        {\n          "alias": "xac_nhan_thu",\n          "label": "X\xE1c nh\u1EADn \u0111\xE3 thu",\n          "of": "phieu_thu",\n          "when": {"trang_thai": ["cho_thu"]},\n          "asks": ["hinh_thuc"],\n          "set": {"trang_thai": "da_thu", "ngay_thu": "now", "nguoi_thu": "me"},\n          "confirm": true\n        },\n        {\n          "alias": "huy_phieu",\n          "label": "H\u1EE7y phi\u1EBFu",\n          "of": "phieu_thu",\n          "when": {"trang_thai": ["cho_thu"]},\n          "set": {"trang_thai": "huy"},\n          "danger": true\n        }\n      ],\n      "checks": [\n        {"field": "chua_thu_phi", "blocks": ["nop_cdt"]},\n        {"field": "con_no_phi"},\n        {"field": "vuot_thu_nhap"},\n        {"field": "da_hoan_tat", "blocks": ["delete", "doc_giay_to"]},\n        {"field": "da_chot", "of": "phieu_thu", "blocks": ["edit"]},\n        {"field": "phai_sua", "of": "giay_to"}\n      ]\n    }\n  ]\n}\n```\n\n## Calls\n\n**The job.** Call a lead from their record, and keep what was said as a touch on its timeline.\n\n**Read.** An act\'s `record` (into the `timeline` child: audio, transcript, when and who) and `fills` (the touch\'s fields an agent fills from the transcript).\n\n**Keys.** `model/papers-and-recordings`, `model/timeline-and-agenda`\n\n**Not when.** Calls made and logged elsewhere \u2014 a `timeline` with its own add keeps the note.\n\n```json\n{\n  "entities": [\n    {\n      "alias": "khach_tiem_nang",\n      "fields": [\n        {"alias": "ho_ten", "type": "text"},\n        {"alias": "ten_cong_ty", "type": "text"},\n        {\n          "alias": "vai_tro",\n          "type": "select",\n          "options": [\n            {"alias": "chu_doanh_nghiep", "color": "emerald"},\n            {"alias": "ke_toan_truong", "color": "blue"},\n            {"alias": "quan_ly", "color": "teal"},\n            {"alias": "nhan_vien", "color": "sky"},\n            {"alias": "chua_ro", "color": "zinc"}\n          ]\n        },\n        {\n          "alias": "loai_hinh",\n          "type": "select",\n          "options": [\n            {"alias": "thuong_mai", "color": "blue"},\n            {"alias": "san_xuat", "color": "amber"},\n            {"alias": "dich_vu", "color": "violet"},\n            {"alias": "xay_dung", "color": "orange"},\n            {"alias": "ho_kinh_doanh", "color": "teal"},\n            {"alias": "chua_ro", "color": "zinc"}\n          ]\n        },\n        {\n          "alias": "quy_mo",\n          "type": "select",\n          "options": [\n            {"alias": "q_1_10", "color": "sky"},\n            {"alias": "q_11_50", "color": "blue"},\n            {"alias": "q_51_200", "color": "indigo"},\n            {"alias": "q_200", "color": "violet"},\n            {"alias": "chua_ro", "color": "zinc"}\n          ]\n        },\n        {"alias": "so_dien_thoai", "type": "text"},\n        {"alias": "zalo", "type": "text"},\n        {"alias": "email", "type": "text"},\n        {"alias": "trang_ca_nhan", "type": "text", "format": "link"},\n        {"alias": "anh", "type": "files"},\n        {\n          "alias": "trang_thai",\n          "type": "select",\n          "options": [\n            {"alias": "moi", "color": "gray"},\n            {"alias": "du_dieu_kien", "color": "blue"},\n            {"alias": "da_lien_he", "color": "amber"},\n            {"alias": "da_chuyen_doi", "color": "emerald"},\n            {"alias": "loai", "color": "red"}\n          ]\n        },\n        {\n          "alias": "ly_do_loai",\n          "type": "select",\n          "options": [\n            {"alias": "khong_phu_hop", "color": "orange"},\n            {"alias": "qua_nho", "color": "amber"},\n            {"alias": "chua_co_ngan_sach", "color": "yellow"},\n            {"alias": "sai_nguoi", "color": "blue"},\n            {"alias": "yeu_cau_dung", "color": "red"},\n            {"alias": "trung", "color": "zinc"}\n          ]\n        },\n        {"alias": "vi_sao_du_dieu_kien", "type": "text"},\n        {"alias": "phu_trach", "type": "select_member"},\n        {"alias": "nguon", "type": "select_record_link", "target_entity": "kenh", "cardinality": "one"},\n        {"alias": "lien_he", "type": "select_record_link", "target_entity": "lien_he", "cardinality": "one"},\n        {"alias": "cong_ty", "type": "select_record_link", "target_entity": "cong_ty", "cardinality": "one"},\n        {"alias": "ngay_chuyen_doi", "type": "date", "format": "datetime", "timezone": "Asia/Ho_Chi_Minh"},\n        {"alias": "ghi_chu", "type": "text", "format": "markdown"},\n        {"alias": "tin_hieu", "type": "select_record_link", "target_entity": "tin_hieu"},\n        {"alias": "buoc_tiep", "type": "select_record_link", "target_entity": "buoc_tiep"},\n        {"alias": "tuong_tac", "type": "select_record_link", "target_entity": "tuong_tac"},\n        {"alias": "do_nong", "type": "formula"},\n        {"alias": "han_buoc_tiep", "type": "rollup"},\n        {"alias": "khong_lien_he", "type": "formula"}\n      ]\n    },\n    {\n      "alias": "tin_hieu",\n      "fields": [\n        {"alias": "tom_tat", "type": "text"},\n        {"alias": "noi_dung", "type": "text", "format": "markdown"},\n        {"alias": "anh_chup", "type": "files"},\n        {"alias": "lien_ket", "type": "text", "format": "link"},\n        {"alias": "kenh", "type": "select_record_link", "target_entity": "kenh", "cardinality": "one"},\n        {\n          "alias": "loai",\n          "type": "select",\n          "options": [\n            {"alias": "hoi_dich_vu", "color": "emerald"},\n            {"alias": "than_phien", "color": "blue"},\n            {"alias": "tuyen_ke_toan", "color": "amber"},\n            {"alias": "moi_thanh_lap", "color": "violet"},\n            {"alias": "gioi_thieu", "color": "teal"},\n            {"alias": "danh_ba", "color": "zinc"},\n            {"alias": "nhieu", "color": "stone"}\n          ]\n        },\n        {"alias": "ngay_dang", "type": "date", "timezone": "Asia/Ho_Chi_Minh"},\n        {"alias": "ngay_xay_ra", "type": "formula"}\n      ]\n    },\n    {\n      "alias": "buoc_tiep",\n      "fields": [\n        {"alias": "vi_sao_luc_nay", "type": "text"},\n        {\n          "alias": "viec",\n          "type": "select",\n          "options": [\n            {"alias": "binh_luan", "color": "blue", "mark": {"kind": "icon", "name": "message-square"}},\n            {"alias": "nhan_facebook", "color": "violet", "mark": {"kind": "brand", "name": "facebook"}},\n            {"alias": "nhan_zalo", "color": "sky", "mark": {"kind": "brand", "name": "zalo"}},\n            {"alias": "goi_dien", "color": "teal", "mark": {"kind": "icon", "name": "phone"}},\n            {"alias": "gui_email", "color": "indigo", "mark": {"kind": "icon", "name": "mail"}},\n            {"alias": "gui_bang_gia", "color": "amber", "mark": {"kind": "icon", "name": "receipt"}}\n          ]\n        },\n        {"alias": "ban_nhap", "type": "text", "format": "markdown"},\n        {"alias": "han", "type": "date", "format": "datetime", "timezone": "Asia/Ho_Chi_Minh"},\n        {\n          "alias": "tinh_trang",\n          "type": "select",\n          "options": [\n            {"alias": "cho", "color": "blue"},\n            {"alias": "xong", "color": "emerald"},\n            {"alias": "bo_qua", "color": "zinc"}\n          ]\n        }\n      ]\n    },\n    {\n      "alias": "tuong_tac",\n      "fields": [\n        {"alias": "tom_tat", "type": "text"},\n        {"alias": "thoi_diem", "type": "date", "format": "datetime", "timezone": "Asia/Ho_Chi_Minh"},\n        {\n          "alias": "qua",\n          "type": "select",\n          "options": [\n            {"alias": "goi_dien", "color": "teal", "mark": {"kind": "icon", "name": "phone"}},\n            {"alias": "zalo", "color": "sky", "mark": {"kind": "brand", "name": "zalo"}},\n            {"alias": "facebook", "color": "blue", "mark": {"kind": "brand", "name": "facebook"}},\n            {"alias": "email", "color": "indigo", "mark": {"kind": "icon", "name": "mail"}},\n            {"alias": "gap_truc_tiep", "color": "emerald", "mark": {"kind": "icon", "name": "users"}},\n            {"alias": "khac", "color": "zinc", "mark": {"kind": "icon", "name": "ellipsis"}}\n          ]\n        },\n        {\n          "alias": "phan_hoi",\n          "type": "select",\n          "options": [\n            {"alias": "dang_cho", "color": "blue"},\n            {"alias": "da_tra_loi", "color": "green"},\n            {"alias": "quan_tam", "color": "amber"},\n            {"alias": "khong_phu_hop", "color": "red"},\n            {"alias": "khong_phan_hoi", "color": "zinc"},\n            {"alias": "sai_so", "color": "stone"}\n          ]\n        },\n        {"alias": "ghi_am", "type": "files"},\n        {"alias": "nguyen_van", "type": "text", "format": "markdown"},\n        {"alias": "hen_lai", "type": "date", "timezone": "Asia/Ho_Chi_Minh"},\n        {"alias": "nguoi_thuc_hien", "type": "select_member"}\n      ]\n    }\n  ],\n  "records": {\n    "khach_tiem_nang": {\n      "title": "ho_ten",\n      "subtitle": ["ten_cong_ty"],\n      "image": "anh",\n      "party": "person",\n      "status": {"field": "trang_thai", "closed": ["da_chuyen_doi", "loai"], "history": "lich_su_trang_thai"},\n      "due": ["han_buoc_tiep"]\n    },\n    "tin_hieu": {"title": "tom_tat", "subtitle": ["kenh", "ngay_xay_ra"], "image": "anh_chup"},\n    "buoc_tiep": {\n      "title": "vi_sao_luc_nay",\n      "subtitle": ["viec"],\n      "mark": "viec",\n      "status": {"field": "tinh_trang", "closed": ["xong", "bo_qua"]},\n      "due": ["han"]\n    },\n    "tuong_tac": {"title": "tom_tat", "subtitle": ["qua", "phan_hoi"]}\n  },\n  "apps": [\n    {\n      "alias": "khach_tiem_nang",\n      "name": "Kh\xE1ch ti\u1EC1m n\u0103ng",\n      "description": "M\u1ECDi ng\u01B0\u1EDDi m\xECnh c\xF3 th\u1EC3 b\xE1n d\u1ECBch v\u1EE5, t\u1EEB t\xEDn hi\u1EC7u \u0111\u1EA7u ti\xEAn \u0111\u1EBFn khi chuy\u1EC3n v\xE0o CRM: m\u1EDF m\u1ED9t kh\xE1ch \u0111\u1EC3 \u0111\u1ECDc v\xEC sao n\xEAn g\u1ECDi l\xFAc n\xE0y, li\xEAn h\u1EC7 ngay, ghi l\u1EA1i l\u1EA7n ch\u1EA1m, x\u1EBFp b\u01B0\u1EDBc ti\u1EBFp theo, v\xE0 chuy\u1EC3n \u0111\u1ED5i khi \u0111\xE3 c\xF3 cu\u1ED9c tr\xF2 chuy\u1EC7n.",\n      "icon": "radar",\n      "theme": {"color": "violet"},\n      "entity": "khach_tiem_nang",\n      "register": {\n        "columns": ["phu_trach", "han_buoc_tiep"],\n        "filters": ["phu_trach"],\n        "create": ["ho_ten", "trang_ca_nhan", "so_dien_thoai", "ten_cong_ty", "nguon"],\n        "readings": [\n          {"breakdown": "khach_tiem_nang", "by": "phu_trach"},\n          {"trend": "khach_tiem_nang", "over": "ngay_chuyen_doi", "label": "Kh\xE1ch chuy\u1EC3n \u0111\u1ED5i"}\n        ]\n      },\n      "record": {\n        "sections": [\n          {\n            "title": "\u0110\xE1nh gi\xE1",\n            "at": ["moi"],\n            "fields": ["vai_tro", "loai_hinh", "quy_mo", "vi_sao_du_dieu_kien", "do_nong"],\n            "blocks": [\n              {\n                "rows": "tin_hieu",\n                "title": "T\xEDn hi\u1EC7u",\n                "columns": ["loai", "noi_dung"],\n                "create": ["tom_tat", "anh_chup", "loai", "noi_dung", "kenh", "lien_ket", "ngay_dang"]\n              }\n            ],\n            "acts": ["danh_gia_dat"]\n          },\n          {\n            "title": "Li\xEAn h\u1EC7",\n            "at": ["du_dieu_kien"],\n            "fields": ["so_dien_thoai", "phu_trach", "trang_ca_nhan", "zalo", "email", "ghi_chu"],\n            "blocks": [\n              {\n                "rows": "buoc_tiep",\n                "title": "B\u01B0\u1EDBc ti\u1EBFp theo",\n                "columns": ["ban_nhap"],\n                "create": ["vi_sao_luc_nay", "viec", "han", "ban_nhap"]\n              },\n              {\n                "timeline": "tuong_tac",\n                "title": "T\u01B0\u01A1ng t\xE1c",\n                "create": ["tom_tat", "qua", "phan_hoi", "thoi_diem", "hen_lai"]\n              }\n            ],\n            "acts": ["ghi_cuoc_goi", "da_lien_he"]\n          },\n          {\n            "title": "Chuy\u1EC3n \u0111\u1ED5i",\n            "description": "Kh\xE1ch \u0111\xE3 tr\u1EA3 l\u1EDDi v\xE0 mu\u1ED1n \u0111i ti\u1EBFp: chuy\u1EC3n \u0111\u1ED5i t\u1EA1o li\xEAn h\u1EC7 v\xE0 c\xF4ng ty trong s\u1ED5 kh\xE1ch h\xE0ng.",\n            "at": ["da_lien_he"],\n            "fields": ["nguon", "lien_he", "cong_ty"],\n            "acts": ["chuyen_doi"]\n          },\n          {\n            "title": "Lo\u1EA1i",\n            "description": "Kh\xE1ch kh\xF4ng \u0111i ti\u1EBFp: ghi l\xFD do \u0111\u1EC3 l\u1EA7n sau kh\xF4ng t\xECm l\u1EA1i.",\n            "at": ["loai"],\n            "fields": ["ly_do_loai"],\n            "acts": ["loai"]\n          }\n        ]\n      },\n      "acts": [\n        {\n          "alias": "danh_gia_dat",\n          "label": "\u0110\u1EE7 \u0111i\u1EC1u ki\u1EC7n",\n          "when": {"trang_thai": ["moi"]},\n          "requires": ["vi_sao_du_dieu_kien"],\n          "set": {"trang_thai": "du_dieu_kien"}\n        },\n        {\n          "alias": "ghi_cuoc_goi",\n          "label": "Ghi \xE2m cu\u1ED9c g\u1ECDi",\n          "when": {"trang_thai": ["du_dieu_kien"]},\n          "record": {\n            "into": "tuong_tac",\n            "audio": "ghi_am",\n            "transcript": "nguyen_van",\n            "at": "thoi_diem",\n            "by": "nguoi_thuc_hien"\n          },\n          "fills": ["tom_tat", "phan_hoi"]\n        },\n        {\n          "alias": "da_lien_he",\n          "label": "\u0110\xE1nh d\u1EA5u \u0111\xE3 li\xEAn h\u1EC7",\n          "when": {"trang_thai": ["du_dieu_kien"]},\n          "set": {"trang_thai": "da_lien_he"}\n        },\n        {\n          "alias": "chuyen_doi",\n          "label": "Chuy\u1EC3n \u0111\u1ED5i",\n          "when": {"trang_thai": ["da_lien_he"]},\n          "workflow": "chuyen_doi_khach",\n          "writes": ["lien_he", "cong_ty"],\n          "confirm": true\n        },\n        {\n          "alias": "loai",\n          "label": "Lo\u1EA1i",\n          "when": {"trang_thai": ["moi", "du_dieu_kien", "da_lien_he"]},\n          "asks": ["ly_do_loai"],\n          "set": {"trang_thai": "loai"},\n          "danger": true\n        },\n        {\n          "alias": "lam_xong",\n          "label": "\u0110\xE3 l\xE0m",\n          "of": "buoc_tiep",\n          "when": {"tinh_trang": ["cho"]},\n          "set": {"tinh_trang": "xong"}\n        }\n      ],\n      "checks": [{"field": "khong_lien_he", "resolve": "da_lien_he"}]\n    }\n  ]\n}\n```\n\n## Approval\n\n**The job.** Raise a payment request, see it through approval, and read what is waiting at the top of the list.\n\n**Read.** `records.de_nghi.status` with its `history` (each move: when and who), sections staged by `at`, and `register.readings` leading with the headline number.\n\n**Keys.** `model/status`, `model/record-page`, `model/readings`\n\n**Not when.** Rows that never move \u2014 a reference list (a price list, a catalog) has no status and no headline number.\n\n```json\n{\n  "entities": [\n    {\n      "alias": "de_nghi",\n      "fields": [\n        {"alias": "noi_dung", "type": "text"},\n        {"alias": "so_de_nghi", "type": "text"},\n        {\n          "alias": "loai",\n          "type": "select",\n          "options": [\n            {"alias": "thanh_toan_ncc", "color": "violet"},\n            {"alias": "nhan_cong", "color": "indigo"},\n            {"alias": "chi_phi_cong_truong", "color": "sky"},\n            {"alias": "tam_ung", "color": "amber"},\n            {"alias": "hoan_ung", "color": "teal"}\n          ]\n        },\n        {"alias": "du_an", "type": "select_record_link", "target_entity": "du_an", "cardinality": "one"},\n        {\n          "alias": "nha_cung_cap",\n          "type": "select_record_link",\n          "target_entity": "nha_cung_cap",\n          "cardinality": "one"\n        },\n        {"alias": "so_tien", "type": "number", "notation": {"style": "currency", "currency": "VND"}},\n        {"alias": "han_thanh_toan", "type": "date"},\n        {\n          "alias": "trang_thai",\n          "type": "select",\n          "options": [\n            {"alias": "nhap", "color": "slate"},\n            {"alias": "cho_duyet", "color": "amber"},\n            {"alias": "cho_chu_tich", "color": "violet"},\n            {"alias": "da_duyet", "color": "blue"},\n            {"alias": "da_chi", "color": "green"},\n            {"alias": "tu_choi", "color": "rose"}\n          ]\n        },\n        {"alias": "nguoi_de_nghi", "type": "select_member"},\n        {"alias": "chung_tu", "type": "files"},\n        {"alias": "nguoi_duyet", "type": "select_member"},\n        {"alias": "duyet_luc", "type": "date", "format": "datetime"},\n        {"alias": "ly_do_tu_choi", "type": "text"},\n        {"alias": "phieu_chi", "type": "files"},\n        {"alias": "ngan_sach_du_an", "type": "lookup"},\n        {"alias": "da_duyet_du_an", "type": "lookup"},\n        {"alias": "vuot_ngan_sach", "type": "formula"},\n        {"alias": "sat_ngan_sach", "type": "formula"},\n        {"alias": "da_gui", "type": "formula"}\n      ]\n    }\n  ],\n  "records": {\n    "de_nghi": {\n      "title": "noi_dung",\n      "subtitle": ["du_an"],\n      "status": {\n        "field": "trang_thai",\n        "closed": ["da_chi", "tu_choi"],\n        "history": "lich_su_duyet",\n        "stages": {\n          "nhap": {"owner": "nguoi_de_nghi"},\n          "cho_duyet": {"owner": {"role": "giam_doc"}, "within": 1},\n          "cho_chu_tich": {"owner": {"role": "chu_tich"}, "within": 2},\n          "da_duyet": {"owner": {"role": "ke_toan"}, "within": 2}\n        }\n      },\n      "figure": "so_tien",\n      "limits": {"da_duyet_du_an": "ngan_sach_du_an"},\n      "due": ["han_thanh_toan"],\n      "starts": {"nguoi_de_nghi": "me"}\n    }\n  },\n  "apps": [\n    {\n      "alias": "de_nghi_chi",\n      "name": "\u0110\u1EC1 ngh\u1ECB thanh to\xE1n",\n      "description": "Ch\u1EC9 huy tr\u01B0\u1EDFng l\u1EADp \u0111\u1EC1 ngh\u1ECB chi cho d\u1EF1 \xE1n c\u1EE7a m\xECnh, k\xE8m ch\u1EE9ng t\u1EEB, r\u1ED3i g\u1EEDi gi\xE1m \u0111\u1ED1c duy\u1EC7t.",\n      "icon": "hand-coins",\n      "theme": {"color": "amber"},\n      "entity": "de_nghi",\n      "register": {\n        "columns": ["nguoi_de_nghi"],\n        "filters": ["nguoi_de_nghi", "du_an"],\n        "group": "du_an",\n        "create": ["noi_dung", "loai", "du_an", "nha_cung_cap", "so_tien", "han_thanh_toan", "nguoi_de_nghi"],\n        "readings": [\n          {\n            "metric": "de_nghi",\n            "value": "so_tien",\n            "where": {"trang_thai": ["da_duyet"]},\n            "label": "\u0110\xE3 duy\u1EC7t, ch\u1EDD chi"\n          },\n          {"trend": "de_nghi", "over": "han_thanh_toan", "value": "so_tien"}\n        ]\n      },\n      "record": {\n        "door": "drawer",\n        "sections": [\n          {\n            "title": "\u0110\u1EC1 ngh\u1ECB",\n            "at": ["nhap"],\n            "fields": ["so_de_nghi", "loai", "nha_cung_cap", "han_thanh_toan", "nguoi_de_nghi"],\n            "blocks": [{"files": ["chung_tu"], "title": "Ch\u1EE9ng t\u1EEB k\xE8m"}],\n            "acts": ["gui_duyet"]\n          },\n          {\n            "title": "Duy\u1EC7t",\n            "at": ["cho_duyet", "cho_chu_tich"],\n            "fields": ["nguoi_duyet", "duyet_luc", "ly_do_tu_choi"],\n            "acts": ["rut_lai"]\n          },\n          {"title": "\u0110\xE3 chi", "at": ["da_chi"], "blocks": [{"files": ["phieu_chi"], "title": "Phi\u1EBFu chi"}]}\n        ]\n      },\n      "acts": [\n        {\n          "alias": "gui_duyet",\n          "label": "G\u1EEDi duy\u1EC7t",\n          "when": {"trang_thai": ["nhap"]},\n          "requires": ["chung_tu", "nguoi_de_nghi"],\n          "set": {"trang_thai": "cho_duyet"}\n        },\n        {\n          "alias": "rut_lai",\n          "label": "R\xFAt l\u1EA1i",\n          "when": {"trang_thai": ["cho_duyet", "cho_chu_tich"]},\n          "set": {"trang_thai": "nhap"},\n          "confirm": true\n        }\n      ],\n      "checks": [{"field": "da_gui", "blocks": ["edit"]}, {"field": "vuot_ngan_sach"}, {"field": "sat_ngan_sach"}]\n    }\n  ]\n}\n```\n\n## Dashboard\n\n**The job.** The owner\'s question \u2014 what came in, what went out, where it went, and what is still unmatched \u2014 answered over one period.\n\n**Read.** `dashboard`: `metric`s with `over` (the period windows them), a `trend`, `breakdown`s, and a `list` of rows to act on opening in their app.\n\n**Keys.** `model/dashboards`, `model/readings`\n\n**Not when.** One job\'s headline numbers \u2014 those lead that job\'s register as its `readings`.\n\n```json\n{\n  "entities": [\n    {\n      "alias": "giao_dich",\n      "fields": [\n        {"alias": "noi_dung", "type": "text"},\n        {"alias": "ngay", "type": "date"},\n        {\n          "alias": "loai",\n          "type": "select",\n          "options": [{"alias": "thu", "color": "green"}, {"alias": "chi", "color": "rose"}]\n        },\n        {"alias": "so_tien", "type": "number", "notation": {"style": "currency", "currency": "VND"}},\n        {"alias": "bien_dong", "type": "formula"},\n        {\n          "alias": "doi_tuong",\n          "type": "select_record_link",\n          "target_entity": "doi_tuong",\n          "cardinality": "one"\n        },\n        {\n          "alias": "danh_muc",\n          "type": "select",\n          "options": [\n            {"alias": "doanh_thu", "color": "green"},\n            {"alias": "hang_hoa", "color": "blue"},\n            {"alias": "van_chuyen", "color": "indigo"},\n            {"alias": "nhan_su", "color": "violet"},\n            {"alias": "van_phong", "color": "sky"},\n            {"alias": "thue_phi", "color": "slate"},\n            {"alias": "ngan_hang", "color": "teal"},\n            {"alias": "khac", "color": "gray"}\n          ]\n        },\n        {"alias": "sao_ke", "type": "select_record_link", "target_entity": "sao_ke", "cardinality": "one"},\n        {"alias": "hoa_don", "type": "select_record_link", "target_entity": "hoa_don", "cardinality": "many"},\n        {\n          "alias": "trang_thai",\n          "type": "select",\n          "options": [\n            {"alias": "chua_khop", "color": "amber"},\n            {"alias": "da_khop", "color": "green"},\n            {"alias": "khong_can_hd", "color": "slate"}\n          ]\n        }\n      ]\n    },\n    {\n      "alias": "hoa_don",\n      "fields": [\n        {\n          "alias": "doi_tuong",\n          "type": "select_record_link",\n          "target_entity": "doi_tuong",\n          "cardinality": "one"\n        },\n        {"alias": "so_hoa_don", "type": "text"},\n        {"alias": "ngay_hoa_don", "type": "date"},\n        {"alias": "so_ngay_qua_han", "type": "formula"},\n        {\n          "alias": "chieu",\n          "type": "select",\n          "options": [{"alias": "ban_ra", "color": "green"}, {"alias": "mua_vao", "color": "violet"}]\n        },\n        {"alias": "tong_cong", "type": "formula"},\n        {"alias": "thue_suat", "type": "formula"},\n        {"alias": "tep", "type": "files"},\n        {\n          "alias": "giao_dich",\n          "type": "select_record_link",\n          "target_entity": "giao_dich",\n          "cardinality": "many"\n        }\n      ]\n    }\n  ],\n  "records": {\n    "giao_dich": {\n      "title": "noi_dung",\n      "subtitle": ["ngay"],\n      "status": {"field": "trang_thai", "closed": ["da_khop", "khong_can_hd"], "history": "lich_su_khop"},\n      "figure": "bien_dong"\n    },\n    "hoa_don": {"title": "doi_tuong", "subtitle": ["so_hoa_don", "ngay_hoa_don"], "image": "tep", "figure": "tong_cong"}\n  },\n  "apps": [\n    {\n      "alias": "dong_tien",\n      "name": "D\xF2ng ti\u1EC1n",\n      "description": "Gi\xE1m \u0111\u1ED1c xem trong k\u1EF3: ti\u1EC1n v\xE0o, ti\u1EC1n ra, d\xF2ng ti\u1EC1n r\xF2ng qua c\xE1c k\u1EF3, chi v\xE0o \u0111\xE2u, thu t\u1EEB ai, v\xE0 nh\u1EEFng d\xF2ng sao k\xEA c\xF2n ch\u01B0a kh\u1EDBp.",\n      "icon": "chart-line",\n      "theme": {"color": "emerald"},\n      "dashboard": [\n        {\n          "metric": "giao_dich",\n          "value": "so_tien",\n          "where": {"loai": ["thu"]},\n          "over": "ngay",\n          "label": "Ti\u1EC1n v\xE0o"\n        },\n        {\n          "metric": "giao_dich",\n          "value": "so_tien",\n          "where": {"loai": ["chi"]},\n          "over": "ngay",\n          "better": "down",\n          "label": "Ti\u1EC1n ra"\n        },\n        {"trend": "giao_dich", "over": "ngay", "value": "bien_dong", "label": "D\xF2ng ti\u1EC1n r\xF2ng"},\n        {\n          "breakdown": "giao_dich",\n          "by": "danh_muc",\n          "value": "so_tien",\n          "where": {"loai": ["chi"]},\n          "over": "ngay",\n          "label": "Chi theo danh m\u1EE5c"\n        },\n        {\n          "breakdown": "giao_dich",\n          "by": "doi_tuong",\n          "value": "so_tien",\n          "where": {"loai": ["thu"]},\n          "over": "ngay",\n          "label": "Thu theo kh\xE1ch h\xE0ng"\n        },\n        {\n          "pivot": "hoa_don",\n          "rows": "doi_tuong",\n          "columns": {"field": "so_ngay_qua_han", "tiers": [1, 8, 16, 31]},\n          "value": "tong_cong",\n          "where": {"chieu": ["ban_ra"]},\n          "label": "C\xF4ng n\u1EE3 b\xE1n ra theo tu\u1ED5i n\u1EE3"\n        },\n        {\n          "metric": "hoa_don",\n          "value": "so_ngay_qua_han",\n          "average": true,\n          "where": {"chieu": ["ban_ra"]},\n          "label": "S\u1ED1 ng\xE0y qu\xE1 h\u1EA1n b\xECnh qu\xE2n"\n        },\n        {"metric": "hoa_don", "value": "thue_suat", "average": true, "label": "Thu\u1EBF su\u1EA5t b\xECnh qu\xE2n"},\n        {\n          "list": "giao_dich",\n          "where": {"trang_thai": ["chua_khop"]},\n          "columns": ["sao_ke"],\n          "app": "doi_chieu",\n          "label": "D\xF2ng ch\u01B0a kh\u1EDBp"\n        }\n      ]\n    }\n  ]\n}\n```\n';