Skip to main content

Architecture overview

For enterprise and solution architects: the whole picture in one page. Each section links to the detail an engineer needs, so you can stop reading at the level you need.

The picture​

Patternode from the outside: your client's sources feed your ingest workload, which calls the Patternode API; segments come back into your store; signed events reach your event receiver

Three parties:

PartyOwnsRuns
Your client (a utility, a fund, a fleet operator)Assets, readings, the relationship with youHistorians, SCADA, meters, market feeds
You, the partnerYour product, your brand, your data and your keysAn ingest workload, a segment store, an event receiver, your application
PatternodeThe serviceThe Patternode API: Delve today; Essence, Sentinel and Foresight on the same foundation

The architecture at a glance​

ConcernAnswer
Integration styleAPI-first. Your backend calls Patternode; Patternode answers and sends events. No agent, connector or software of Patternode's runs in your environment
DirectionOutbound only from your side. Patternode never connects into your network; events reach an endpoint or event bus you choose
InterfacesREST and JSON (OpenAPI 3.1) on every plan; gRPC on Mission Critical and Dedicated; webhooks and event-bus delivery (AsyncAPI 3.1); bulk files (CSV, JSON Lines, Parquet, Arrow) read from and written to your storage
InteractionSynchronous for a finished series and for each extension of a forming series; asynchronous for backfill jobs and events
What crossesBars (time, open, high, low, close) under a series name you make up. Segments come back. Nothing else
Where data livesEverything about your series is in your store: readings, segments, and for a forming series its edge. Patternode keeps none of it, not even between calls
ResidencyYou choose a jurisdiction (Australia and New Zealand, the EU or the US); data never leaves it
IdentityAPI keys on every plan; OAuth 2.0 client credentials with signed assertions, mutual TLS and workload identity on Mission Critical and Dedicated
ResilienceUp to 99.99% availability, active-active across two regions, 60-second regional failover, nothing acknowledged lost (Plans)
SemanticsStateless: the same edge and bars always give the same answer, so retries are exactly-once in effect; at-least-once events; deterministic results per pinned profile version
ChangeOne functional contract for every plan, product and industry; versioned in the path; changes announced in the changelog

One API, every product​

Delve is the foundation; Essence, Sentinel and Foresight are planned and run on Delve; one API, one key, one contract

Integrate once. A series sent to Delve is not sent again for the products that run on it, and your keys, client, event receiver and infrastructure serve all of them.

Architecture principles​

  1. Your data stays yours. Patternode receives the minimum (bars under opaque names) and keeps nothing, not even a forming series between calls. You store the results and the edge.
  2. Outbound only. Nothing from Patternode connects into your network, which keeps it outside operational technology perimeters and simplifies your security review.
  3. Contract first. The OpenAPI, AsyncAPI and gRPC files are the contract; this site, the mock server and the examples follow them.
  4. One contract, many plans. Moving up a plan changes capacity and service levels, never your code.
  5. Safe to retry. The same edge and bars always give the same answer, so a retry, a restart or a failover never double-counts or loses a bar.
  6. Deterministic. The same bars with the same profile version give the same segments, always, so backtests, audits and live operation agree.
  7. Your jurisdiction. Your series are processed only in the jurisdiction you choose, and support access stays there.
  8. No lock-in. Segments and edges are already in your store, and the contract is published under Apache 2.0.
You areRead
An enterprise architect checking fitSecurity and data, Deployment and resilience, the service contract
A solution architect designing the integrationIntegration architecture, Your side, the reference architectures, Decisions you make
An engineer building itDetailed flows, the Quickstart, the API reference
A project leadThe onboarding playbook