Agent — deployment view

The Agent module covers Person, Organisation, Proprietor + Proprietorship Relator, Seller / Buyer roles, NameChangeEvent. It is the second module bound by the BASPI5 overlay (Seller + Buyer participate as roles in the conveyancing form).

Source TTL(s)

File	Role	Physical-Ontology tier
`opda-agent.ttl`	TBox: Person, Organisation, Proprietor, Seller, Buyer, NameChangeEvent	agent/classes.md
`opda-agent-shapes.ttl`	Identity-key + IC-breach shapes	agent/shapes.md
`opda-agent-annotations.ttl`	DPV baseline (Person carries PII baseline categories)	agent/annotations.md

Named graph(s)

Named graph IRI	Source TTL	Triples	`owl:versionIRI`
`https://opda.org.uk/pdtf/graph/agent`	`opda-agent.ttl`	77	`https://opda.org.uk/pdtf/harness/release/agent/1.0.0/`
`https://opda.org.uk/pdtf/graph/agent-shapes`	`opda-agent-shapes.ttl`	44	—
`https://opda.org.uk/pdtf/graph/agent-annotations`	`opda-agent-annotations.ttl`	22	—

Load order: TBox graph imports foundation + vocabularies:

owl:imports <https://opda.org.uk/pdtf/harness/release/1.0.0/>, <https://opda.org.uk/pdtf/scheme/>

Shape + annotation graphs load alongside the TBox graph.

Derived-profile membership

Profile	`opda-agent.ttl`	`opda-agent-shapes.ttl`	`opda-agent-annotations.ttl`
opda-validation	included (classes + properties + subClassOf + labels)	included (all triples)	excluded
opda-ui	included (all triples)	included (all triples)	included (all triples; Person PII baseline drives consent disclosures)
opda-inference	included (classical-logic axioms only)	excluded	excluded

The DPV annotation graph is particularly load-bearing for the Agent module: Person carries the GDPR Article 9 special-category baseline (race, religion, health, etc.) per ODR-0012 §Q5, and UI consumers need this surface to render the appropriate consent affordances.

Overlay bindings

BASPI5 binds two Agent-module roles via sh:targetClass:

BASPI5 shape	Target class	Module-shape graph counterpart
`Baspi5_SellerShape`	`opda:Seller`	`opda:SellerIdentityShape` (Cat 1)
`Baspi5_BuyerShape`	`opda:Buyer`	`opda:BuyerIdentityShape` (Cat 1)
`Baspi5_SellersCapacityShape` (discriminator)	`opda:Seller` (nested `sellersCapacity` `oneOf`)	—

Baspi5_SellersCapacityShape is the discriminator shape per ODR-0010 §Q5 (oneOf → sh:xone). It does not bind a new identity key; it carries the per-form enumeration of seller capacities under the BASPI5 form-version 5.0.3.

Content-negotiation entry points

Resource path	Resolves to
`https://opda.org.uk/pdtf/graph/agent`	agent module TBox
`https://opda.org.uk/pdtf/harness/release/agent/1.0.0/`	agent versionIRI snapshot
`https://opda.org.uk/pdtf/graph/agent-shapes`	agent shape graph
`https://opda.org.uk/pdtf/graph/agent-annotations`	agent annotation graph
`https://opda.org.uk/pdtf/Person`	per-entity dereference
`https://opda.org.uk/pdtf/Organisation`	per-entity dereference
`https://opda.org.uk/pdtf/Proprietor`	per-entity dereference
`https://opda.org.uk/pdtf/Proprietorship`	per-entity dereference
`https://opda.org.uk/pdtf/Seller`	per-entity dereference
`https://opda.org.uk/pdtf/Buyer`	per-entity dereference
`https://opda.org.uk/pdtf/NameChangeEvent`	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: Agent module deployment graph accDescr: Shows how Agent TTLs flow through named graphs, derived profiles, BASPI5 overlay bindings, 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-agent.ttl
77 triples"]:::data S["opda-agent-shapes.ttl
44 triples"]:::data A["opda-agent-annotations.ttl
22 triples"]:::data end subgraph NG["Named graphs"] NGT["opda.org.uk/pdtf/graph/agent
versionIRI 1.0.0/"]:::infra NGS["opda.org.uk/pdtf/graph/agent-shapes"]:::infra NGA["opda.org.uk/pdtf/graph/agent-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
Person PII baseline"]:::data DI["opda-inference.ttl"]:::data end subgraph OVR["Overlay bindings — BASPI5"] OB1["Baspi5_SellerShape
targets opda:Seller"]:::data OB2["Baspi5_BuyerShape
targets opda:Buyer"]:::data OB3["Baspi5_SellersCapacityShape
nested xone discriminator"]:::data end subgraph HTTP["HTTP entry points"] H1["opda.org.uk/pdtf/graph/agent"]:::service H2["opda.org.uk/pdtf/Person"]:::service H3["opda.org.uk/pdtf/Seller"]:::service H4["opda.org.uk/pdtf/Buyer"]:::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 NGT --> OB2 NGT --> OB3 NGS --> OB1 NGS --> OB2 NGT --> H1 NGT --> H2 NGT --> H3 NGT --> H4 DV --> U1 DU --> U2 DI --> U3 OB1 --> U4 OB2 --> U4 OB3 --> U4

Cross-tier links

Logical tier: docs/manual/logical/agent/ — typed attributes + ER diagrams for Person, Organisation, Proprietorship Relator.
Physical-Ontology tier: docs/manual/physical-ontology/agent/ — Turtle source layout + per-class blocks + per-shape constraint bodies.
Overlay deployment: docs/manual/physical-database/overlay-deployment/baspi5.md — BASPI5 Seller / Buyer bindings.
Operations: round-trip CI validates Agent exemplars (person-with-name-change, organisation-with-merger, proprietorship-relator-multi-proprietor).