Specification · v0.2.0

The spec, in four documents

OpenRiC is an open, implementation-neutral specification for serving ICA's Records in Contexts (RiC-CM / RiC-O) over HTTP. It's made of four short documents — a mapping table, an HTTP API, a graph-render model, and a conformance test suite.

1 · Mapping ISAD(G) · ISAAR(CPF) · ISDIAH → RiC-CM / RiC-O class & property tables. 2 · Viewing API REST + JSON-LD contract. 21 read endpoints, 9 write endpoints, auth model. 3 · Graph Primitives Node · Edge · Cluster · Drill · LayoutHint. Six invariants any conformant server must hold. 4 · Conformance Four levels (L1–L4), 12 JSON Schemas, SHACL shape set, fixture pack, validator CLI.

Status

v0.1.0 is frozen — implementations can claim conformance against that tag. The Unreleased section of the CHANGELOG captures progress since (capture app, split, 10 new read endpoints, write surface) — these will be rolled into v0.2.0 once a second implementation is in sight.

Licence

Creative Commons Attribution 4.0 (CC-BY 4.0). Fork it, adapt it, build implementations against it.

See also