@prefix owl: . @prefix rdfs: . @prefix xsd: . @prefix dct: . @prefix skos: . @prefix xeo: . # XEO Delivery module — the container the work happens in. # # The decision tier says WHAT to do (a Recommendation closes a Gap with a Tactic) # and the norms tier says what SHOULD govern that call. Neither says for whom, # under which contract, against which goal, or with how much room left this # month. That is delivery, and until this module it lived only in the # implementations: a Project with a quota and a scope, a Campaign against a # topic with an Objective, and the targets an experiment is finally read against. # # Website hasProject Project (the contract: type, quota, scope) # Project hasCampaign Campaign (a body of work against one Topic) # Campaign hasObjective Objective hasTarget MetricTarget (the intent, as targets) # Recommendation issuedFor Campaign (a call lands in a campaign) # Experiment measures MetricTarget (and is read against its target) # # Two layers meet here and are kept apart on purpose. Project and Campaign are # ENTITIES: they exist because a contract was signed and a topic was chosen. # Objective and MetricTarget are INTERPRETATIONS: an intent set at creation, a # call about what should move. A target is named a target and never a result — # xeo:Outcome is the measured side, an observation, and the two must never share # a name or the experiment loop will conflate the goal with the reading. # # The scope gate now has two halves. xeo-decision's requiresCapability + approved # asks CAN we (is the lever available); this module's inScope + execution asks # DID THEY BUY IT and WHOSE HOURS DOES IT COST. A recommendation is deliverable # when both say yes; advisory when the capability exists but the contract or the # allowance does not cover it. # # Named Project, not Engagement, deliberately: xeo-engagement.ttl already uses # "engagement" for the conversion seam (forms, CTAs, the CRM join), and the # implementations this module is lifted from call the container a Project. # # DISCIPLINE (unchanged): classes, never values. engagementType, cadence, # metric and the rest take their values from xeo-schemes.ttl — published # reference schemes a consumer adopts or replaces. # # DEPENDENCIES, declared honestly: builds on core (Website, URL, Term, Topic), # decision (Recommendation, Experiment), and uses SKOS for its slots. xeo:delivery-module a owl:Ontology ; dct:title "XEO Delivery (projects, campaigns, objectives)" ; dct:description "The container work is delivered in: a Project (the contract — type, quota, scope), its Campaigns (a body of work against one Topic), the Objective each campaign is measured by, and the MetricTargets an Experiment is read against. Lifted from a production implementation; fills the layer the decision and norms tiers left open." ; dct:creator "Inbound Found" ; owl:versionInfo "0.5.0" . # --- Classes ---------------------------------------------------------------- xeo:Project a owl:Class ; rdfs:label "Project" ; xeo:epistemicLayer "entity" ; dct:description "The contractual container for a body of work on one Website. Declares its engagementType (retainer or one-off), an interventionQuota (a scope of work with no ceiling is not a scope), a cadence the quota resets over (retainer) or a durationDays it runs for (one-off), and the Interventions and Tactics inScope under the contract. Never destroyed: its campaigns, objectives and targets are the substrate the end-of-campaign report and the experiment loop read, so it is stamped deletedAt and filtered, not deleted." . xeo:Campaign a owl:Class ; rdfs:label "Campaign" ; xeo:epistemicLayer "entity" ; dct:description "A body of work inside a Project against one Topic: the URLs and Terms it covers, and the single Objective it is measured by. Recommendations are issuedFor a campaign, and it is the unit an operator plans a cycle around. Soft-deleted like its Project." . xeo:Objective a owl:Class ; rdfs:label "Objective" ; xeo:epistemicLayer "interpretation" ; dct:description "What a Campaign intends to move: an operator-written statement in prose (carried verbatim — the recommendation agent reads it as the goal), a resultsWindowDays every target is measured over, and one or more MetricTargets of which exactly one isPrimary. An intent set at creation. A campaign has one reporting horizon, distinct from the Project's work window: a two-month engagement can carry a six-month results window." . xeo:MetricTarget a owl:Class ; rdfs:label "Metric Target" ; xeo:epistemicLayer "interpretation" ; dct:description "One measurable target of an Objective: metric X should reach targetValue, read as absolute or as a percent lift from a captured baseline. Named a target and never a key result: xeo:Outcome is 'the measured result an experiment produced', an observation, and a goal must not share a name with a reading. Each target is its own node so the experiment loop can hang observations off it; a target dropped on edit is stamped deletedAt, never destroyed, because its id is what measured history is anchored to." . # --- Object properties ------------------------------------------------------- xeo:hasProject a owl:ObjectProperty ; rdfs:domain xeo:Website ; rdfs:range xeo:Project ; xeo:epistemicLayer "entity" ; dct:description "The projects contracted against this website. Tenancy rides on websiteId, as everywhere." . xeo:hasCampaign a owl:ObjectProperty ; rdfs:domain xeo:Project ; rdfs:range xeo:Campaign ; xeo:epistemicLayer "entity" . xeo:inScope a owl:ObjectProperty ; rdfs:domain xeo:Project ; xeo:epistemicLayer "entity" ; dct:description "What the contract covers: an Intervention (a whole category of work, including tactics added to the catalogue later) or a specific Tactic within one. Range left open across those two terms. The contractual half of the scope gate — requiresCapability + approved asks whether the lever exists; this asks whether it was bought." . xeo:aboutTopic a owl:ObjectProperty ; rdfs:domain xeo:Campaign ; rdfs:range xeo:Topic ; xeo:epistemicLayer "entity" ; dct:description "The topic cluster this campaign works. Topics are site-scoped derivations in core; a campaign binds to one." . xeo:coversUrl a owl:ObjectProperty ; rdfs:domain xeo:Campaign ; rdfs:range xeo:URL ; xeo:epistemicLayer "entity" ; dct:description "A page inside the campaign's cluster. May carry a priority flag marking the pages the campaign is really about." . xeo:coversTerm a owl:ObjectProperty ; rdfs:domain xeo:Campaign ; rdfs:range xeo:Term ; xeo:epistemicLayer "entity" ; dct:description "A term inside the campaign's cluster — the queries its objective is measured against." . xeo:hasObjective a owl:ObjectProperty ; rdfs:domain xeo:Campaign ; rdfs:range xeo:Objective ; xeo:epistemicLayer "interpretation" ; dct:description "Exactly one per campaign." . xeo:hasTarget a owl:ObjectProperty ; rdfs:domain xeo:Objective ; rdfs:range xeo:MetricTarget ; xeo:epistemicLayer "interpretation" ; dct:description "The objective's measurable targets. Non-empty; exactly one target isPrimary — what the recommendation agent optimises for. The rest are the secondary metrics an impact-radius check widens to." . xeo:issuedFor a owl:ObjectProperty ; rdfs:domain xeo:Recommendation ; rdfs:range xeo:Campaign ; xeo:epistemicLayer "interpretation" ; dct:description "The campaign a recommendation was issued into. Its execution lifecycle (xeo:status), effortEstimate and execution live here: a recommendation is a decision-tier call until it lands in a campaign, and delivery state from then on." . xeo:measures a owl:ObjectProperty ; rdfs:domain xeo:Experiment ; rdfs:range xeo:MetricTarget ; xeo:epistemicLayer "observation" ; dct:description "The target an experiment's Outcome is read against. Carries a role — primary or secondary — matching the target's standing in its objective, and a basis saying which pages were measured (the ones the recommendation applied to, the gap's evidence, or the pages actually changed)." . xeo:effortEstimate a owl:ObjectProperty ; rdfs:domain xeo:Recommendation ; rdfs:range skos:Concept ; xeo:epistemicLayer "interpretation" ; dct:description "How long executing the recommendation is expected to take, as a slotted-in concept (hours, days, weeks, a quarter — see xeo-schemes). A categorical horizon for planning a cycle, not a scored dimension: impact, risk and time-to-value belong on a TacticAssessment via onDimension." . xeo:execution a owl:ObjectProperty ; rdfs:domain xeo:Recommendation ; rdfs:range skos:Concept ; xeo:epistemicLayer "interpretation" ; dct:description "Who does the work, as a slotted-in concept: ours (spends the project's intervention allowance) or advised (the client executes; not agency capacity). The half of the scope gate that says whose hours a recommendation costs." . # --- Datatype properties ----------------------------------------------------- # xeo:status on a Recommendation is its execution lifecycle (pending, in_progress, # blocked, cancelled, completed); on an Experiment it is measuring, concluded, # cancelled, unmeasurable. Both value sets are published in xeo-schemes.ttl. The # property is declared domain-free in xeo-strategy for exactly this reason. xeo:engagementType a owl:DatatypeProperty ; rdfs:domain xeo:Project ; rdfs:range xsd:string ; xeo:epistemicLayer "entity" ; dct:description "'retainer' or 'oneoff' — the discriminator for how scope is expressed. A retainer caps interventions per cadence period; a one-off caps them over durationDays. Sending both cadence and durationDays is a contradiction and is rejected at the edge." . xeo:interventionQuota a owl:DatatypeProperty ; rdfs:domain xeo:Project ; rdfs:range xsd:integer ; xeo:epistemicLayer "entity" ; dct:description "Ceiling on interventions this project may deploy per period (retainer) or in total (one-off). Always present. Recommendations in an open status — pending, in_progress, blocked — consume it; advised work does not." . xeo:cadence a owl:DatatypeProperty ; rdfs:domain xeo:Project ; rdfs:range xsd:string ; xeo:epistemicLayer "entity" ; dct:description "'monthly' or 'quarterly' — the period a retainer's quota resets over. Set for retainer, absent for one-off." . xeo:durationDays a owl:DatatypeProperty ; rdfs:domain xeo:Project ; rdfs:range xsd:integer ; xeo:epistemicLayer "entity" ; dct:description "Fixed run length of a one-off project. Set for oneoff, absent for retainer." . xeo:resultsWindowDays a owl:DatatypeProperty ; rdfs:domain xeo:Objective ; rdfs:range xsd:integer ; xeo:epistemicLayer "interpretation" ; dct:description "The measurement window every target in this objective is read over. One horizon per campaign; per-target windows are deliberately not modelled." . xeo:metric a owl:DatatypeProperty ; rdfs:domain xeo:MetricTarget ; rdfs:range xsd:string ; xeo:epistemicLayer "interpretation" ; dct:description "Which metric the target is set on — clicks, impressions, ctr, position, rank_absolute, etv (see xeo-schemes objectiveMetric). The value vocabulary is the consumer's; the reference scheme records each metric's direction and unit." . xeo:direction a owl:DatatypeProperty ; rdfs:domain xeo:MetricTarget ; rdfs:range xsd:string ; xeo:epistemicLayer "interpretation" ; dct:description "'up' or 'down' — which way is better for this metric. DERIVED from metric, never client input: position and rank are 1-based, so a shared '+20%' would silently ask for a rank 20% worse." . xeo:targetKind a owl:DatatypeProperty ; rdfs:domain xeo:MetricTarget ; rdfs:range xsd:string ; xeo:epistemicLayer "interpretation" ; dct:description "'absolute' (targetValue is a value of the metric) or 'percent' (a relative change from baseline in the metric's better direction)." . xeo:targetValue a owl:DatatypeProperty ; rdfs:domain xeo:MetricTarget ; rdfs:range xsd:decimal ; xeo:epistemicLayer "interpretation" ; dct:description "The value the metric should reach, interpreted per targetKind. Bounded per metric and kind at the edge — a percentage, a count, a rank and a currency do not share a range." . xeo:baseline a owl:DatatypeProperty ; rdfs:domain xeo:MetricTarget ; rdfs:range xsd:decimal ; xeo:epistemicLayer "observation" ; dct:description "The metric's value when the target was set — the anchor 'how far beyond target' is measured from. An observation captured onto an interpretation; baselineCapturedAt says when, because it is not the same instant as the target's creation." . xeo:baselineCapturedAt a owl:DatatypeProperty ; rdfs:domain xeo:MetricTarget ; rdfs:range xsd:dateTime ; xeo:epistemicLayer "observation" . xeo:isPrimary a owl:DatatypeProperty ; rdfs:domain xeo:MetricTarget ; rdfs:range xsd:boolean ; xeo:epistemicLayer "interpretation" ; dct:description "Exactly one target per objective. The one the agent optimises for." . xeo:deletedAt a owl:DatatypeProperty ; rdfs:range xsd:dateTime ; xeo:epistemicLayer "entity" ; dct:description "Soft-delete stamp. XEO never destroys a node something else was derived from — xeo-strategy states the rule for a Practice (destroying it destroys the record of what it vetoed) and it holds here for a Project, a Campaign, or a MetricTarget that measured history hangs off. Absent on a live node; domain left open so any revisable term can carry it." .