Rumatadocs
Browse documentation

Rumata, in plain language

A shared vocabulary for people building the product and developers extending it.

Step-by-step guidance.

Building blocks

TermMeaning
ProjectThe owner of application resources and collaboration state.
FactoryA workspace for building and iterating inside a project.
ApplicationThe website or product people use, built in a factory inside a project.
FrontendThe interface people use in a browser.
Backend serviceA managed API, container application, server-rendered app or background worker with its own development and deployed lifecycle.
PreviewThe product under development, running in a development environment.
Frontend SiteThe published frontend product.
Frontend DeploymentOne accepted attempt to publish or replace its version.
Development machineThe environment running development services and preview.
ActivityA reusable backend operation a workflow can invoke.
WorkflowA connected process made of triggers and steps.
TriggerThe event or request that begins a workflow.

Data and access

TermMeaning
DatabaseStructured records organized in tables.
Retained workspacePersistent source and lockfiles reattached when a development machine is recreated; separate from runtime processes and dependency caches.
Backend persistent diskOptional deployed-service filesystem storage; separate from the development workspace and managed object storage.
Table / row / columnA collection, one record, and one field of a record.
Project storagePersistent file storage owned by a project.
Object pathA file’s address within a storage.
Reserved storageCapacity committed to the storage.
Used storageFile bytes actually occupying that capacity.
SecretA protected credential or value used by an authorized integration.
GroupA way to manage access for members together.
Account-wide permissionA grant inherited by all projects under the billing account.

Usage and history

TermMeaning
Billing accountCommercial owner of subscriptions, allowances, and consumption.
AllowanceA declared amount or capacity available under the plan.
AdmissionThe check that accepts work before dispatch.
Workflow executionOne admitted top-level invocation, including its child work.
Workflow version historyRetained earlier definitions of a workflow.
Execution historyRetained evidence from workflow runs.
SuspensionStopping active compute while retaining supported recovery state.
Recovery windowThe period during which a supported recovery operation remains available.

Common technical words

TermPlain-language explanation
APIA structured interface that software uses to communicate.
JSONA text format for structured fields, lists, and values.
MCPA protocol through which agents discover and use tools and resources.
HTTP endpointAn address plus request method that software calls.
WebhookAn external service’s HTTP notification to your application.
CronA compact way to express a repeating schedule.
SynchronousWait for the operation’s result in the request.
AsynchronousAccept work now and check its result later.
DeploymentPreparing and activating a version for its target environment.