Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/site/public/images/solmara-lab-topology.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
11 changes: 9 additions & 2 deletions docs/site/src/content/docs/explanation/architecture.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -52,8 +52,15 @@ At runtime, Registry Stack exposes source data through two patterns:
The two patterns are independent. Evidence Gateway contacts its configured authoritative HTTP
sources directly. It does not require Registry Relay or inherit Relay authorization. A deployment
can configure a Relay-protected API as a fixed HTTP source, but Relay remains an ordinary source
rather than part of the Evidence Gateway product boundary. The retired Solmara workflow is not a
current integration path.
rather than part of the Evidence Gateway product boundary. The separate Solmara Lab demo makes that
choice for some of its requirements: an authority's Evidence Gateway cell reads a named Relay
lookup as one of its sources, and inherits no Relay authorization from it.
Comment thread
jeremi marked this conversation as resolved.

{/* TODO[evidence]: which Solmara Lab requirements read a Relay lookup cannot be anchored from
this repository. That mapping lives with the deployment configuration in the separate
registrystack/solmara-lab project, described in the README pinned from src/data/projects.yaml.
The claim above is weakened to match: some requirements, not a named set. Restore the enumeration
once that configuration is citable from here. */}

This split matters because it separates the obligation to describe (what a registry declares it can expose
and under what policy) from the obligation to enforce (what a running service will actually return to an
Expand Down
2 changes: 1 addition & 1 deletion docs/site/src/content/docs/map/boundaries-and-map.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ For how the products connect at runtime and how Solmara Lab demonstrates them, s
| How is `metadata.yaml` validated or rendered into standards-facing artifacts? | [Registry Manifest](https://github.com/registrystack/registry-stack) |
| How is one bounded question about one subject answered with a signed assertion that carries the answer and not the record? | [Evidence Gateway](../../products/registry-evidence/) |
| How does a deployment with callers and no identity provider issue access tokens? | [Registry Mint](../../reference/mint/) |
| How do the services run together in a local demo? | [Solmara Lab](https://github.com/registrystack/solmara-lab/blob/00cd51a2be4a405ef75d337ddcede0f9de134b1f/README.md) |
| How do the services run together in a local demo? | [Solmara Lab](https://github.com/registrystack/solmara-lab/blob/3d5c492ea50c6fdcefd5978df6f036422096421c/README.md) |

Cross-project explanation, standards evidence, and contract indexes live in these docs (not in any one project repo).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ standards_referenced:
import QuickstartMeta from '../../../components/QuickstartMeta.astro';
import { Steps } from '@astrojs/starlight/components';

This unpublished page records a retired demo topology. Evidence Gateway no longer uses Registry
This unpublished page records a retired demo topology. Evidence Gateway does not require Registry
Relay as a source. Use the [Evidence Gateway quickstart](../../start/evidence-quickstart/) for the
current architecture and workflow.

Expand Down
28 changes: 24 additions & 4 deletions docs/site/src/data/generated/projects.json
Original file line number Diff line number Diff line change
Expand Up @@ -157,22 +157,42 @@
"name": "Solmara Lab",
"repo_path": "../solmara-lab",
"target_repo_path": "../solmara-lab",
"role": "Standalone Registry Stack adopter demo for the fictional Republic of Solmara. Runs a whole country's worth of registry services over generated synthetic data, with purpose-limited Relay APIs per authority, a citizen portal, and a public Visitor's Center.",
"role": "Standalone Registry Stack adopter demo for the fictional Republic of Solmara. Runs a whole country's worth of registry services over generated synthetic data, with six authority-owned Evidence Gateway cells that have their own providers, issuers, signing keys, JWKS, and audit sinks, five purpose-limited Relay projects, one lab Mint, a programme portal, and a public Visitor's Center. Some requirements read checkpointed immutable SQLite extracts and others read named Relay lookups, and the programme application composes the signed answers so that no authority decides for another.",
"owns": [
"End-to-end local and hosted demo topologies for Relay, workload identity agents, Postgres, static metadata, scenario services, the citizen portal, and the Visitor's Center.",
"End-to-end local and hosted demo topologies for the authority Evidence Gateway cells, their Relay projects, Mint, static metadata, scenario services, the programme portal, and the Visitor's Center.",
"Deterministic synthetic data, authority-owned demo configuration, purpose catalogues, and fictional country stories.",
"The demo publisher lifecycle that mutates a Relay-backed source live and republishes a named immutable extract that only a rebound cell serves.",
"Demo orchestration, smoke checks, browser journeys, hosted deployment wrappers, and release-pin checks."
],
"does_not_own": [
"Production deployment guidance.",
"Normative API or metadata contracts.",
"Evidence Gateway deployment or integration.",
"Real product integrations for OpenCRVS, OpenSPP, DHIS2, OpenIMIS, MOSIP, or other systems."
],
"source_docs": [
{
"label": "README",
"url": "https://github.com/registrystack/solmara-lab/blob/00cd51a2be4a405ef75d337ddcede0f9de134b1f/README.md"
"url": "https://github.com/registrystack/solmara-lab/blob/3d5c492ea50c6fdcefd5978df6f036422096421c/README.md"
},
{
"label": "Local topology",
"url": "https://github.com/registrystack/solmara-lab/blob/3d5c492ea50c6fdcefd5978df6f036422096421c/compose.yaml"
},
{
"label": "Evidence cells",
"url": "https://github.com/registrystack/solmara-lab/tree/3d5c492ea50c6fdcefd5978df6f036422096421c/evidence/cells"
},
{
"label": "Relay projects",
"url": "https://github.com/registrystack/solmara-lab/tree/3d5c492ea50c6fdcefd5978df6f036422096421c/relays"
},
{
"label": "Relay source publisher",
"url": "https://github.com/registrystack/solmara-lab/blob/3d5c492ea50c6fdcefd5978df6f036422096421c/scripts/local-relay-source-publisher.py"
},
{
"label": "Extract publisher",
"url": "https://github.com/registrystack/solmara-lab/blob/3d5c492ea50c6fdcefd5978df6f036422096421c/scripts/publish-runtime-extracts.py"
}
],
"rename_status": "Standalone replacement for the historical Registry Lab; not part of the Registry Stack monorepo."
Expand Down
18 changes: 14 additions & 4 deletions docs/site/src/data/projects.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -110,17 +110,27 @@
name: Solmara Lab
repo_path: ../solmara-lab
target_repo_path: ../solmara-lab
role: Standalone Registry Stack adopter demo for the fictional Republic of Solmara. Runs a whole country's worth of registry services over generated synthetic data, with purpose-limited Relay APIs per authority, a citizen portal, and a public Visitor's Center.
role: Standalone Registry Stack adopter demo for the fictional Republic of Solmara. Runs a whole country's worth of registry services over generated synthetic data, with six authority-owned Evidence Gateway cells that have their own providers, issuers, signing keys, JWKS, and audit sinks, five purpose-limited Relay projects, one lab Mint, a programme portal, and a public Visitor's Center. Some requirements read checkpointed immutable SQLite extracts and others read named Relay lookups, and the programme application composes the signed answers so that no authority decides for another.
Comment thread
jeremi marked this conversation as resolved.
owns:
- End-to-end local and hosted demo topologies for Relay, workload identity agents, Postgres, static metadata, scenario services, the citizen portal, and the Visitor's Center.
- End-to-end local and hosted demo topologies for the authority Evidence Gateway cells, their Relay projects, Mint, static metadata, scenario services, the programme portal, and the Visitor's Center.
- Deterministic synthetic data, authority-owned demo configuration, purpose catalogues, and fictional country stories.
- The demo publisher lifecycle that mutates a Relay-backed source live and republishes a named immutable extract that only a rebound cell serves.
- Demo orchestration, smoke checks, browser journeys, hosted deployment wrappers, and release-pin checks.
does_not_own:
- Production deployment guidance.
- Normative API or metadata contracts.
- Evidence Gateway deployment or integration.
- Real product integrations for OpenCRVS, OpenSPP, DHIS2, OpenIMIS, MOSIP, or other systems.
source_docs:
- label: README
url: https://github.com/registrystack/solmara-lab/blob/00cd51a2be4a405ef75d337ddcede0f9de134b1f/README.md
url: https://github.com/registrystack/solmara-lab/blob/3d5c492ea50c6fdcefd5978df6f036422096421c/README.md
- label: Local topology
url: https://github.com/registrystack/solmara-lab/blob/3d5c492ea50c6fdcefd5978df6f036422096421c/compose.yaml
- label: Evidence cells
url: https://github.com/registrystack/solmara-lab/tree/3d5c492ea50c6fdcefd5978df6f036422096421c/evidence/cells
- label: Relay projects
url: https://github.com/registrystack/solmara-lab/tree/3d5c492ea50c6fdcefd5978df6f036422096421c/relays
- label: Relay source publisher
url: https://github.com/registrystack/solmara-lab/blob/3d5c492ea50c6fdcefd5978df6f036422096421c/scripts/local-relay-source-publisher.py
- label: Extract publisher
url: https://github.com/registrystack/solmara-lab/blob/3d5c492ea50c6fdcefd5978df6f036422096421c/scripts/publish-runtime-extracts.py
rename_status: Standalone replacement for the historical Registry Lab; not part of the Registry Stack monorepo.