Descriptive — deployment view

The Descriptive module covers EPCCertificate, Search, Survey, Valuation, Comparable — the descriptive-record entities that surround a Property and underpin BASPI5’s energy-performance, search, and survey form fields. EPCCertificate is the one Descriptive class bound by the BASPI5 overlay today.

Source TTL(s)

File	Role	Physical-Ontology tier
`opda-descriptive.ttl`	TBox: EPCCertificate, Search, Survey, Valuation, Comparable	descriptive/classes.md
`opda-descriptive-shapes.ttl`	Identity-key + IC-breach shapes for descriptive records	descriptive/shapes.md
`opda-descriptive-annotations.ttl`	DPV baseline (EPC may carry energy + address; Survey carries valuation PII)	descriptive/annotations.md

Named graph(s)

Named graph IRI	Source TTL	Triples	`owl:versionIRI`
`https://opda.org.uk/pdtf/graph/descriptive`	`opda-descriptive.ttl`	35	`https://opda.org.uk/pdtf/harness/release/descriptive/1.0.0/`
`https://opda.org.uk/pdtf/graph/descriptive-shapes`	`opda-descriptive-shapes.ttl`	27	—
`https://opda.org.uk/pdtf/graph/descriptive-annotations`	`opda-descriptive-annotations.ttl`	14	—

Load order: TBox graph imports foundation + vocabularies. Shape graph carries per-class identity keys (e.g. opda:EPCCertificate identity by EPC certificate number + Address).

Derived-profile membership

Profile	`opda-descriptive.ttl`	`opda-descriptive-shapes.ttl`	`opda-descriptive-annotations.ttl`
opda-validation	included (classes + properties + subClassOf + labels)	included (all triples)	excluded
opda-ui	included (all triples)	included (all triples)	included (all triples)
opda-inference	included (classical-logic axioms only)	excluded	excluded

Overlay bindings

BASPI5 binds one Descriptive-module class via sh:targetClass:

BASPI5 shape	Target class	Module-shape graph counterpart
`Baspi5_EPCCertificateShape`	`opda:EPCCertificate`	`opda:EPCCertificateIdentityShape` (Cat 1)

BASPI5’s Baspi5ValidationContext also declares opda:Survey in its opda:requires list (a BASPI5 submission must reference at least one Survey artefact when the form question applies), but no Baspi5_SurveyShape exists yet — Survey is referenced by identifier, not constrained by a dedicated overlay shape.

A future home-condition-overlay or RICS-survey overlay is the expected first overlay to target opda:Survey and opda:Valuation directly.

Content-negotiation entry points

Resource path	Resolves to
`https://opda.org.uk/pdtf/graph/descriptive`	descriptive module TBox
`https://opda.org.uk/pdtf/harness/release/descriptive/1.0.0/`	descriptive versionIRI snapshot
`https://opda.org.uk/pdtf/graph/descriptive-shapes`	descriptive shape graph
`https://opda.org.uk/pdtf/graph/descriptive-annotations`	descriptive annotation graph
`https://opda.org.uk/pdtf/EPCCertificate`	per-entity dereference
`https://opda.org.uk/pdtf/Search`	per-entity dereference
`https://opda.org.uk/pdtf/Survey`	per-entity dereference
`https://opda.org.uk/pdtf/Valuation`	per-entity dereference
`https://opda.org.uk/pdtf/Comparable`	per-entity dereference

Deployment graph

--- config: layout: elk elk: mergeEdges: false nodePlacementStrategy: BRANDES_KOEPF --- %%{init: {"theme": "base", "themeVariables": {"primaryColor": "#FFF8E1", "primaryTextColor": "#E65100", "primaryBorderColor": "#F57F17", "lineColor": "#37474F"}}}%% flowchart LR accTitle: Descriptive module deployment graph accDescr: Shows how Descriptive TTLs flow through named graphs, derived profiles, BASPI5 EPC overlay binding, and HTTP entry points. classDef data fill:#FFF8E1,stroke:#F57F17,stroke-width:2px,color:#E65100 classDef process fill:#E1F5FE,stroke:#0277BD,stroke-width:2px,color:#01579B classDef service fill:#E8F5E9,stroke:#2E7D32,stroke-width:2px,color:#1B5E20 classDef user fill:#F3E5F5,stroke:#7B1FA2,stroke-width:2px,color:#4A148C classDef infra fill:#E3F2FD,stroke:#1565C0,stroke-width:2px,color:#0D47A1 subgraph SRC["Source TTLs"] T["opda-descriptive.ttl
35 triples"]:::data S["opda-descriptive-shapes.ttl
27 triples"]:::data A["opda-descriptive-annotations.ttl
14 triples"]:::data end subgraph NG["Named graphs"] NGT["opda.org.uk/pdtf/graph/descriptive
versionIRI 1.0.0/"]:::infra NGS["opda.org.uk/pdtf/graph/descriptive-shapes"]:::infra NGA["opda.org.uk/pdtf/graph/descriptive-annotations"]:::infra end subgraph CMP["Composer"] C["opda-gen compose"]:::process end subgraph DRV["Derived profiles"] DV["opda-validation.ttl"]:::data DU["opda-ui.ttl"]:::data DI["opda-inference.ttl"]:::data end subgraph OVR["Overlay bindings — BASPI5"] OB1["Baspi5_EPCCertificateShape
targets opda:EPCCertificate"]:::data end subgraph HTTP["HTTP entry points"] H1["opda.org.uk/pdtf/graph/descriptive"]:::service H2["opda.org.uk/pdtf/EPCCertificate"]:::service H3["opda.org.uk/pdtf/Survey"]:::service H4["opda.org.uk/pdtf/Valuation"]:::service end subgraph CONS["Consumers"] U1["SHACL validators"]:::user U2["DASH UI"]:::user U3["OWL reasoners"]:::user U4["BASPI5 round-trip"]:::user end T --> NGT S --> NGS A --> NGA NGT --> C NGS --> C NGA --> C C --> DV C --> DU C --> DI NGT --> OB1 NGS --> OB1 NGT --> H1 NGT --> H2 NGT --> H3 NGT --> H4 DV --> U1 DU --> U2 DI --> U3 OB1 --> U4

Cross-tier links

Logical tier: docs/manual/logical/descriptive/ — typed attributes + ER diagrams for EPC, Search, Survey, Valuation.
Physical-Ontology tier: docs/manual/physical-ontology/descriptive/ — Turtle source layout + per-class blocks + per-shape constraint bodies.
Overlay deployment: docs/manual/physical-database/overlay-deployment/baspi5.md — BASPI5 EPCCertificate binding.
Operations: round-trip CI validates EPC-bearing exemplars through the registered-freehold-house, flat-with-split-uprn, and listed-building-divergent-addresses Property exemplars.