Explore the RiC model - every entity, attribute and relation, plain and navigable. Open the model navigator ↗

Part of specification v0.55.1. Earlier versions are preserved as tagged releases.

Specification · v0.55.1 · 7 normative profiles + 5 draft

The spec - base documents + profiles

OpenRiC is an open, implementation-neutral specification for serving ICA's Records in Contexts (RiC-CM / RiC-O 1.1) over HTTP. The spec is layered: the base documents define the contract, 7 normative profiles target specific implementation surfaces, and 5 draft profiles, open for comment, extend it: SPARQL Access and the v0.43 governance line.

Base documents

1 · Mapping ISAD(G) · ISAAR(CPF) · ISDIAH · ISDF → RiC-CM / RiC-O 1.1 class & property tables. Includes Systems-and-Mechanisms (§10). 2 · Viewing API REST + JSON-LD contract: endpoints, auth model, pagination policy, content-negotiation roadmap. 3 · Graph Primitives Node · Edge · Cluster · Drill · LayoutHint. Six invariants any conformant server must hold. 4 · Conformance Profile-based conformance (L1-L4 retained as legacy). JSON Schemas, SHACL shape set, fixture pack, validator CLI. 5 · API contract OpenAPI 3.1, version 0.55.1: every operation the profiles define, tagged with its profile, typed by the JSON Schemas and illustrated by the fixtures. CI validates each example against its schema. 6 · Change control Versioning, what each change bumps, deprecation, migration notes, release approval, signed tags and support. 7 · Known issues What we know is missing or wrong and have not fixed yet, with what closes each. Also the residual issue register for the external review.

Profiles

Profile Status Profile version Last revised in spec
core-discovery Normative 0.7.0 0.54.0
authority-context Normative 0.4.0 0.31.0
graph-traversal Normative 0.6.0 0.51.0
digital-object-linkage Normative 0.7.0 0.54.0
round-trip-editing Normative 0.7.0 0.34.0
provenance-event Normative 0.8.0 0.35.0
export-only Normative 0.10.0 0.54.0
sparql-access Draft 0.1.0 0.37.0
governance Draft 0.44.0 0.44.0
portability Draft 0.43.0 0.43.0
inferred-provenance Draft 0.43.0 0.43.0
graph-grounding Draft 0.43.0 0.43.0

Status

Layer Current version Status
Base documents (the seven above) v0.55.1 Active - RiC-O 1.1 namespace remediation complete (see audit)
Profiles per table above 7 normative + 5 draft
RiC-O ontology target 1.1 (2025-05-22) Tracked
Extension namespace openricx: <https://openric.org/ns/ext/v1#> Declared, ontology stub at /ns/ext/v1.html

The previous “v0.1.0 frozen” / “v0.2.0 pending” framing referenced the original four-document base spec: mapping, viewing API, graph primitives and conformance. The API contract, change control and known issues were added later, which makes the seven listed above; older pages and talks that say “four documents” mean the original set. After the v0.30.0 → v0.36.0 profile-freeze series and the v0.37.0 RiC-O 1.1 remediation, the base-spec version tracks the spec repository as a whole. Profile versions remain independent (per Q8 in core-discovery.md).

Licence

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

See also