Design

This is the deep end of the documentation. The design pages open Andromeda up and follow a request from the bytes on the wire to the rows in PostgreSQL. Along the way they show how a value becomes a type that can't hold anything invalid, how the build refuses code that strays across a layer boundary, how an entity is taken apart into typed rows and put back together on every read, and how the broker repacks its own tables while they stay in use.

You don't need any of it to run the broker or call its API. These pages are for anyone curious about the plumbing, whether or not they ever plan to contribute. They name crates, tables and locks, and explain the trade-offs behind each decision, including a storage layout Andromeda tried first and gave up on.

Start with Philosophy. It covers strictness, the idea the rest of the design follows from.

The design is built on crates for JSON-LD, IRIs, RDF and URNs that are published on their own, and Libraries describes them.