Commit b6803106 authored by Dimitrios Gogos's avatar Dimitrios Gogos
Browse files

feat: Update Data Lab documentation and decisions

parent eec72fab
Loading
Loading
Loading
Loading
+1 −3
Changes for README.md: 1 added line, 3 removed lines.
Original line number Diff line number Diff line
@@ -15,7 +15,6 @@ This repository is an [Open Knowledge Format (OKF) v0.1](https://github.com/Goog
| **Link graph** | Cross-references in the body use bundle-absolute paths (e.g. `/srm/persistence-model.md`). Companion lists at the top of each doc form the navigable graph. |
| **Records** | [decisions/](decisions/) holds numbered ADRs (reasoning); [external-specs/](external-specs/) holds vendored API snapshots with commit pinning. |

Release 2 specs are pinned at `version: "2.0"` in frontmatter until the next release cut ([ADR-0021](decisions/0021-pinned-release-version-2-0.md)).

## How to use this bundle

@@ -36,7 +35,6 @@ Release 2 specs are pinned at `version: "2.0"` in frontmatter until the next rel

- **Search by metadata** — filter documents by `component`, `type`, `tags`, or `version` in frontmatter.
- **Traverse the graph** — follow bundle-absolute links and companion lists to pull related specs into context (IDE, doc site, or agent).
- **Validate release pinning** — run `scripts/check-spec-versions.sh` to confirm all in-scope specs remain at version `2.0`.

## Layout

@@ -47,7 +45,7 @@ Release 2 specs are pinned at `version: "2.0"` in frontmatter until the next rel
| [srm/](srm/) | Service Resource Manager — orchestration and inventory |
| [fm/](fm/) | Federation Manager — cross-operator EWBI federation |
| [tf-sdk/](tf-sdk/) | Transformation Function SDK — vendor adapters inside SRM |
| [data-lab/](data-lab/) | Data Lab — dataspace metadata catalogue (draft, ADR-0050) |
| [data-lab/](data-lab/) | Data Lab — dataspace metadata catalogue |
| [decisions/](decisions/) | Architecture Decision Records |
| [external-specs/](external-specs/) | Vendored third-party API definitions |
| [archive/](archive/) | Superseded working documents |

data-lab/architecture.md

deleted100644 → 0
+0 −533

File deleted.

Preview size limit exceeded, changes collapsed.

+495 −0

File added.

Preview size limit exceeded, changes collapsed.

+8 −8
Changes for data-lab/index.md: 8 added lines, 8 removed lines.
Original line number Diff line number Diff line
# Data Lab (DL)

Draft component (`version: "0.1 (Draft)"`, ADR-0050). Read the architecture first; the vendored
metadata profile is the normative description model.
Released catalogue specification (`version: "0.1.0"`, [ADR-0071](/decisions/0071-data-lab-own-version-outside-release-pin.md)).
Four-part spec; read in order. Requirement status is in Requirements & Design §H.1;
open questions in Overview §F; implementation gaps in Implementation & Delivery §T.

# Normative metadata reference
* [Overview & Architecture](overview-and-architecture.md) - what the Data Lab is, scope and ownership, who sees what, terms, features, boundaries, assumptions, open questions
* [Requirements & Design](requirements-and-design.md) - requirements, components and interfaces, access control, flows, metadata model, lifecycle, errors
* [Implementation & Delivery](implementation-and-delivery.md) - code layout, configuration, deployment, observability, testing, known gaps, later releases, common changes
* [Interface Contract](interface-contract.md) - Data Lab API details, the dataset record, piveau API usage, worked examples

* [6G-DALI Metadata Application Profile (vendored snapshot)](/external-specs/6gdali-metadata-application-profile/VERSION.md) - DCAT-AP 3.0 + `dali:` testbed context + PROV-O + DQV, with layered SHACL shapes and the `dali:` ontology (ADR-0026, ADR-0048)

# Core specs

* [Architecture](architecture.md) - the dataspace metadata catalogue (piveau-hub with the Data Lab UI and API): mental model, use cases, scope, interfaces, deployment behind the platform Nginx/Keycloak, and the evolution path to connector, storage and pipelines
Normative metadata reference: [6G-DALI Metadata Application Profile (vendored snapshot)](/external-specs/6gdali-metadata-application-profile/VERSION.md) - DCAT-AP 3.0 + `dali:` testbed context + PROV-O + DQV, with layered SHACL shapes and the `dali:` ontology (ADR-0026, ADR-0070)
+472 −0

File added.

Preview size limit exceeded, changes collapsed.

Loading