ores.http

Table of Contents

1. Summary

ores.http is the platform's REST gateway. It terminates HTTP, authenticates the caller, and forwards each request to the owning service over NATS, so it depends on the services' wire protocols and not on their libraries. It is a composite of eight parts: three hand-written infrastructure parts, four adapters — one per domain whose routes it serves — and a client, through which the system reads outside HTTP APIs.

2. Sub-components

Sub-component Brief
ores.http.api Boost.Beast server, JWT authentication, routing and OpenAPI support.
ores.http.assets Generated route units for the assets domain.
ores.http.client Outbound HTTP client on Boost.Beast: a GET over TLS behind a replaceable interface.
ores.http.core Hand-written storage and variability routes.
ores.http.iam Generated route units for the identity-and-access domain.
ores.http.refdata Generated route units for the reference-data domain.
ores.http.server Process entry point that wires the routes and runs the event loop.
ores.http.synthetic Generated route units for the synthetic domain.

Emacs 29.3 (Org mode 9.6.15)