Skip to content

DEG-2: Correct non-canonical @vocab patterns to canonical schema namespace strategy #196

@ravi-prakash-v

Description

@ravi-prakash-v

Context

Phase 9 — DEG Harmonization (see project plan). Depends on DEG-1.

Problem

Some DEG schemas use non-canonical @vocab base URIs (e.g., raw GitHub URLs or project-specific namespaces) instead of the canonical https://schema.beckn.io/<domain>/v2.0/ pattern used across beckn/schemas.

This prevents the federated schema registry from correctly constructing canonical term URIs for DEG schemas when served through schema.beckn.io.

Tasks

  • Identify all DEG schemas with non-canonical @vocab in their context.jsonld
  • Map each non-canonical URI to its canonical equivalent under https://schema.beckn.io/energy/v2.0/
  • Update all affected context.jsonld files
  • Update all affected vocab.jsonld @id values to match canonical pattern
  • Verify canonical URL resolution on schema.beckn.io staging environment

Acceptance criteria

  • All DEG schema term URIs resolve to https://schema.beckn.io/energy/v2.0/<Term> pattern
  • No raw GitHub or non-canonical URLs appear in @vocab or @id across DEG schemas

Dependencies

  • Blocked by SDF-1 + SDF-2 (beckn/protocol-specifications-v2): All @vocab canonical naming patterns for DEG schemas must conform to the naming authority established in docs/governance/STYLE_GUIDE.md and CONTRIBUTING_SCHEMAS.md once those governance documents are moved and updated to the draft branch. Do not begin context.jsonld / vocab.jsonld edits until SDF-1 and SDF-2 are merged.

Related

  • DEG-1 (context/vocab structure harmonization — must complete first)
  • SDF-1: Move + update STYLE_GUIDE.md to draft branch
  • SDF-2: Move + update CONTRIBUTING_SCHEMAS.md to draft branch
  • DEG-3 (validation to prevent recurrence)
  • Phase 10 exit criteria: canonical URL validation

Assigned: @ameetdesh

Metadata

Metadata

Assignees

Labels

DEGDEG energy schemacanonical-urlsCanonical URL compliancejson-ldJSON-LD context and vocabphase-9Phase 9: DEG harmonization

Type

No type

Projects

No projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions