GroundX Dataspace — Operational Vocabulary v1.0.0

Namespace: https://vocab.groundx.ag/v1/ · Capa 2 (operativa) · Publicado 2026-05-25 · Mantenedor: did:web:provider.groundx.ag

Este vocabulario contiene los términos operativos comunes a todos los participantes del dataspace GroundX, independientemente de su sector. Aquí no hay términos de dominio (cultivos, logística, etc.); para eso existen los perfiles sectoriales.

Estratificación de vocabularios

Un asset publicado en este dataspace combina típicamente cuatro capas. Esta página describe solo la capa 2.

Capa 1 — Estándares universales
DCAT, Dublin Core, ODRL, SKOS, XSD. Mantenidos por W3C/ISO.

Capa 2 — Operativa del dataspace ← este vocabulario
Reglas de juego comunes a todo participante.

Capa 3 — Perfil sectorial (uso abierto)
Vocabulario curado por un participante (GroundX hoy) como bien común del sector. Cualquier otro provider puede referenciarlo sin pedir permiso. Actualmente disponible: /agro/v1/ (productos y conceptos agro).

Capa 4 — Vocabulario del participante
Términos propios de cada provider, alojados en su propio dominio. Ejemplos: vocab.groundx.ag/provider/v1/ (GroundX como provider), vocab.acme-logistics.com/v1/ (ACME, en su dominio), etc.

Recursos del vocabulario

Contexto JSON-LD · /v1/context.jsonld

Mapeo de términos a URIs. Se referencia desde el @context de cualquier asset del dataspace.

Ontología Turtle · /v1/ontology.ttl

Definiciones formales (RDFS/OWL).

Propiedades operativas

Término	Rango	Descripción
`groundx:accessPeriod`	xsd:string	Duración del acceso: `1h`, `1d`, `1w`, `1m`, `1y`, `forever`
`groundx:price`	xsd:decimal	Precio decimal
`groundx:currency`	xsd:string	Código ISO 4217 (EUR, USD…)
`groundx:allowlist`	set	DIDs explícitamente permitidos
`groundx:denylist`	set	DIDs explícitamente bloqueados
`groundx:requestSchema`	@id	URL del JSON Schema del body de entrada
`groundx:responseSchema`	@id	URL del JSON Schema de la respuesta (subPropertyOf `dct:conformsTo`)

Ejemplo: asset operativo común

Cualquier asset, sea del sector que sea, declara estos campos:

{
  "@context": [
    "https://w3id.org/edc/connector/management/v0.0.1",
    "https://vocab.groundx.ag/v1/context.jsonld"
  ],
  "@type": ["Asset", "dcat:Dataset"],
  "properties": {
    "dct:title":       "...",
    "dct:description": "...",
    "dct:publisher":   { "@id": "did:web:..." },
    "dct:license":     { "@id": "https://creativecommons.org/licenses/by/4.0/" },

    "groundx:accessPeriod": "1m",
    "groundx:price":         100.00,
    "groundx:currency":      "EUR"
  }
}

Para añadir términos de dominio (tipos de dataset específicos, taxonomías sectoriales) un participante incluye un tercer @context apuntando a su perfil sectorial.

Vocabularios disponibles bajo este dominio

El operador del dataspace mantiene dos vocabularios distintos bajo vocab.groundx.ag:

/agro/v1/ — Perfil sectorial agro abierto. Conceptos reutilizables por cualquier provider del sector (Agrochemical, activeIngredient, productCategory). Bien común del dataspace.
/provider/v1/ — Vocabulario propio de GroundX como provider. Términos específicos de nuestros servicios (CropAnalyticsDataset, etc.). Otros participantes NO deberían usarlo directamente; tienen su propio capa 4.

Otros participantes publican su capa 4 en su propio dominio, p.ej. https://vocab.acme-logistics.com/v1/. Si tu caso de uso es agro y encaja en el perfil sectorial /agro/v1/, te recomendamos reutilizarlo en lugar de duplicar términos.

Versionado

Cambios aditivos (nuevos términos) → versión menor dentro de /v1/. Cambios incompatibles → namespace nuevo /v2/. /v1/ se mantiene indefinidamente.