Build out the wiki: installation, external services, user guide
Adds the three things the wiki was missing, alongside the generated
codebase map.
Installation — prerequisites, the local stack and what each service is
for, the first-administrator bootstrap in full (nothing is seeded, and
the rules are easy to get wrong), running the tests including the
wwwroot ordering trap, the production checklist, and troubleshooting for
the failures that actually happen.
External services — the honest dependency inventory: what each of the
nine containers owns, what breaks without it, and why it is there.
Includes the parts that are load-bearing but invisible: the Flowable
callback shared secret, why NATS binds to loopback, why role creation
cannot check-then-act, and that the executor's whole job is running
untrusted code.
User guide — seven guides organised by what you are working on, plus an
index that explains the five ideas the product rests on. Records,
Workflows, Documents and Notes, Queries and Dashboards, Data Stores and
Pipelines, The Assistant, Administration.
Written against the code rather than from memory: field types from
fieldTypeDefaults.ts, AQL entities from the entity registry, the
selector grammar from SelectorParser, transformer names from
BuiltinSchemas, menu labels from the seed. Home and the sidebar now
separate the hand-maintained pages from the generated snapshot, because
readers should know which is which.
npond
committed
Sep 2, 2026