Saltar al contingut
OpenDome

Especificació OSL

L’especificació OSL és el contracte normatiu (RFC 2119). Defineix cada primitiva, cada camp i cada codi d’error. La pàgina de Conceptes ensenya el model; la spec el lliga. Apache-2.0

Historial de versions

Section titled “Historial de versions”

apiVersion: osl.opendome.eu/v1 cobreix tota la línia v1.x. Les versions menors són additives i compatibles en lectura; els canvis disruptius esperen a v2.

v1.0Base

El fonament: superconjunt de MetricFlow (pla estructurat) + UnstructuredFacet (pla no estructurat) + el pont JointEntity, i els quatre nivells de conformança.

RFC 0002 · semantic_match · Accepted

v1.1Disseny

El model de relacions i resolució: estructurat↔estructurat via entitats compartides, N-N via bridges, joins honestos estructurat↔no estructurat sobre claus autoritatives, multi-hop, i resolució ràpida.

RFC 0003 · Relationships & resolution

v1.22026-06Actual · esborrany

Operativitza la RFC 0003: travessa L2, sampling de contingut governat (ACL + redacció server-side) i el domain-map unificat (tot és una Entity; els bridges col·lapsen a arestes). Els nivells de conformança Lance + Governance s'amplien.

RFC 0003 · Implemented

v1.32026-07Següent

La superfície de query única (OSL-SQL): /osl/query esdevé l'únic endpoint de consum, plegant retrieval, joins i travessa en un sol dialecte SQL semàntic — més operadors de projecció. La RFC 0002 queda substituïda per la font de relació RETRIEVE.

RFC 0005 · OSL-SQL · DraftRFC 0004 · Projection operators · Draft

v2Futur

Reservat per a canvis disruptius i treball explícitament fora del límit v1.x (p. ex. inferència / raonament contingut↔contingut).

Les nou primitives

Section titled “Les nou primitives”

SemanticModel, Metric, SavedQuery, TimeSpine, UnstructuredFacet, JointEntity, Lexicon, DataContract, PolicyBinding. Cadascuna porta apiVersion: osl.opendome.eu/v1 i un kind. Els JSON Schemas es publiquen un per primitiva més un master manifest schema.

RFCs

Section titled “RFCs”

Els canvis substancials passen pel procés RFC.

# Títol Estat
0002 predicat semantic_match / MATCHES Substituïda
0003 Relacions, resolució i consultabilitat Implementada
0004 Operadors de projecció (encoder + decoder opcional) Esborrany
0005 OSL-SQL — la superfície de query única Esborrany

Principis de disseny (vinculants)

Section titled “Principis de disseny (vinculants)”

Si una proposta trenca un d’aquests, es rebutja:

  1. El pass-through de MetricFlow és sagrat. Qualsevol projecte dbt-sl vàlid és OSL vàlid.
  2. Lance és de primera classe, no un add-on — amb les seves pròpies primitives, schema, errors i lineage.
  3. El client declara, el motor executa. La spec diu què existeix, mai com corre.
  4. Cada decisió és auditable — query, retrieval i decisió de la PDP emeten tots OpenLineage.
  5. El versionat és un contracte. …/v1 no et trencarà el YAML durant tota la línia v1; els canvis disruptius esperen a v2.

Garantia de versionat

Section titled “Garantia de versionat”

apiVersion: osl.opendome.eu/v1 és una promesa de no trencar-te el YAML durant tota la línia v1. Els endpoints poden afegir camps opcionals dins de v1.x; els clients han d’ignorar els camps no reconeguts. Qualsevol cosa desaprovada a v1.x continua funcional durant almenys dues versions menors consecutives; l’eliminació requereix v2, servida al costat de v1 durant aquesta finestra.

Relacionat

Section titled “Relacionat”