logical model: SAVVI Logical Model

Version: 1.0.2 - Baseline

Created: 8 June 2026

New introduction notes.

Registered Sex, and Gender, adjusted to use a locally agreed code list, rather than stipulating the allowed values as an enumeration.

SAVVI, standing for ‘a Scalable Approach to Vulnerability via Interoperability’, is a programme hosted by Tameside Council on behalf of the local public sector, and funded by the Ministry of Housing, Communities and Local Government (MHCLG) Local Digital Fund.

SAVVI is proposing the SAVVI Playbook, to promote how data can be used to improve early identification and smarter interventions, for vulnerable people, particularly where no single organisation has access to all the data and insight that can predict who may be at risk, and where no single organisation has all the support services.

SAVVI is proposing Data Standards towards achieving the SAVVI ambition which includes

avoid single-use databases that can only tackle one type of vulnerability in a fixed way;
encourage technology and service suppliers to innovate with modular solutions that can be interconnected and reused;
unlock access to data
reuse investments in platforms, tools, processes, trust networks etc
enable success to be repeated elsewhere without relying on the same products and partners

This Logical Model defines key entities and their attributes as the basis for data sharing.

Namespace: http://def.savviuk.org/logical#
Default Prefix: savviL

SAVVI Logical Model

Renditions

Format	Link
Graphviz DOT	dot.txt
DSD JSON	dsd.json
CSV	logicalmodel.csv
RDF Schema (Turtle)	logicalmodel.ttl
XSD	SAVVI_Logical_Model.xsd

Index

Entities

Entity	Description
Action	Implements Concepts • Action — An action that has been carried out as a part of responding to a NEED.
Assessment	Implements Concepts • Assessment — An understanding of NEEDs and circumstances.
Attribute	Implements Concepts • Risk Factor — A single fact about a Person or Household that can be combined with others to ca…
Case	Implements Concepts • Case — A container for information established to manage one or more NEEDs for a PERSON…
Contact Event	Implements Concepts • Contact Event — A record of an event in which the situation of a person or household was sought.
Household	Implements Concepts • Household — A collection of PERSONs who live together at the same RESIDENCE.
Need	Implements Concepts • Need — An unmet requirement of a Person or Household that can be addressed.
Organisation	Implements Concepts • Lead Organisation — An organisation responsible for coordinating a vulnerability initiative, and wit… • Responsible Organisation — An organisation who is made responsible for a CASE. • Delivery Organisation — A service provider who delivers actions that respond to a NEED.
Outcome	Implements Concepts • Outcome — A result that has been achieved by addressing the NEEDs of a Person or Household…
Person	Implements Concepts • Person — An Individual who may be vulnerable.
Place	Can mean a one-of polygon a street a neighbourhood an existing statistical or administrative geography Implements Concepts • Place — A geographic area.
Plan	Implements Concepts • Plan — A set of planned actions designed to respond to a NEED over a period.
Referral	Implements Concepts • Referral — A decision to direct a NEED to a support SERVICE.
Residence	Implements Concepts • Residence — A home of a PERSON
Service	Implements Concepts • Service — The ability for a Delivery Organisation to carry out one or more predetermined m…
Vulnerability	Implements Concepts • Vulnerability — The increased risk of a poor outcome.

Structures in SAVVI Dictionary

Structure	Description
Type	To tag a thing with a type.
Case Outcome
Identifier
Contact Point	Details for all kinds of technology-mediated contact points for a person or organisation, including telephone, email, etc.
Person Name
Birth Date	The date that a Person was born.
Property Address
Characteristic	To describe a feature of a thing.
Coordinate	The absolute geographic location of a Location, expressed using the WGS84 datum.

Enumerations in SAVVI Dictionary

Enumeration	Description
Case Statuses	Derived from Codesystem-episode-of-care-status - FHIR v5.0.0
Contact Directions
Contact System Types

Relationships

Label	Entity from	Entity to	Cardinality
Responsible Organisation responsible for Case	Organisation	Case	one to many
Residence residence of Person	Residence	Person	many to many
Service referral from Referral	Service	Referral	one to many
Residence contained in Place	Residence	Place	many to many
Case contains Contact Event	Case	Contact Event	one to many
Case contains Assessment	Case	Assessment	one to many
Plan addresses Need	Plan	Need	many to many
Delivery Organisation determines Plan	Organisation	Plan	one to many
Need has referral Referral	Need	Referral	many to many
Delivery Organisation provides Service	Organisation	Service	one to many
Need addressed by Action	Need	Action	one to many
Delivery Organisation performs Action	Organisation	Action	one to many
Household composed from Person	Household	Person	many to many
Case manages Need	Case	Need	one to many
Case about Vulnerability	Case	Vulnerability	one to many
Need has Outcome	Need	Outcome	one to many
Household has need Need	Household	Need	one to many
Person has need Need	Person	Need	one to many
Household has vulnerability Vulnerability	Household	Vulnerability	one to many
Person has vulnerability Vulnerability	Person	Vulnerability	one to many
Household described by Risk Factor	Household	Attribute	one to many
Person described by Risk Factor	Person	Attribute	one to many
Residence residence of Household	Residence	Household	one to many

Entities

Action

Implements Concepts from SAVVI Concept Model

Concept	Description
Action	An action that has been carried out as a part of responding to a NEED.

Action

Attributes

Attribute	Description	Data type	Occurs
Type	The type of action - e.g. * food parcel * debt advice	Type	once
Date	The date of the Action.	date	once
Description	A description of the Action.	text	once

Relationships

Need addressed by Action ← Need
Delivery Organisation performs Action ← Organisation

Assessment

Implements Concepts from SAVVI Concept Model

Concept	Description
Assessment	An understanding of NEEDs and circumstances.

Assessment

Attributes

Attribute	Description	Data type	Occurs
Situation	A record of the situation to be assessed.	text	once
Findings	A judgement of the Needs arising from the Situation.	text	once
Date	The date of the Assessment	date	once

Relationships

Case contains Assessment ← Case

Attribute

Implements Concepts from SAVVI Concept Model

Concept	Description
Risk Factor	A single fact about a Person or Household that can be combined with others to categorise the risk of a VULNERABILITY , and predict NEEDs.

Attribute

Attributes

Attribute	Description	Data type	Occurs
Type	To describe the Attribute. e.g. In receipt of Universal Credit, Living Alone.	Type	once
Set	To indicate if the presence of the Attribute is true or false.	yes/no	once
Value	An optional value associated with an Attribute, e.g. if the Type is '% attendance', the Value may be 60.	line	once
DateFrom	The date from which the Attribute is true.	date	once
DateTo	The date from which the Attribute may no longer be true, or is expected to end.	date	once

Relationships

Household described by Risk Factor ← Household
Person described by Risk Factor ← Person

Case

Implements Concepts from SAVVI Concept Model

Concept	Description
Case	A container for information established to manage one or more NEEDs for a PERSON or HOUSEHOLD, through which events, evidence, activities, and decisions are recorded and tracked over time in order to achieve an intended OUTCOME.

Case

Attributes

Attribute	Description	Data type	Occurs
Reference	The Case Reference.	line	once
Status		Case Statuses	once
Date Raised	The date that the Case was started.	date	once
Date Closed	The date that the Case was closed.	date	once
Case Outcome		Case Outcome	once

Relationships

Responsible Organisation responsible for Case ← Organisation
Case contains Contact Event → Contact Event
Case contains Assessment → Assessment
Case manages Need → Need
Case about Vulnerability → Vulnerability

Contact Event

Implements Concepts from SAVVI Concept Model

Concept	Description
Contact Event	A record of an event in which the situation of a person or household was sought.

Contact Event

Attributes

Attribute	Description	Data type	Occurs
Date	The date of the contact.	date	once
Person	The name of the contacted person	line	once
Role	The role of the contacted person e.g. * Vulnerable Person * Friend * Relative * Public * Professional * Community Group * Elected Representative	lookup	once
Method	The method used to make the contact e.g. * phone * home visit * digital	line	once
Contact Direction	To indicate who initiated the contact.	Contact Directions	once
Notes	Notes of the Contact Event	text	once

Relationships

Case contains Contact Event ← Case

Household

Implements Concepts from SAVVI Concept Model

Concept	Description
Household	A collection of PERSONs who live together at the same RESIDENCE.

Household

Attributes

Attribute	Description	Data type	Occurs
Identifier		Identifier	many
FromDate	A date from which the Household is known to be formed.	date	once
ToDate	A date after which the Household may not be formed.	date	once

Relationships

Household composed from Person → Person
Household has need Need → Need
Household has vulnerability Vulnerability → Vulnerability
Household described by Risk Factor → Attribute
Residence residence of Household ← Residence

Need

Implements Concepts from SAVVI Concept Model

Concept	Description
Need	An unmet requirement of a Person or Household that can be addressed.

Need

Attributes

Attribute	Description	Data type	Occurs
Type		Type	once
Rationale	The reasoning for the Need.	text	once
Date	The date that the Need is established.	date	once
End Date	The date that the Need was resolved.	date	once
Target Date	The date that the Need should be resolved by, for it to be effective.	date	once

Organisation

Implements Concepts from SAVVI Concept Model

Concept	Description
Lead Organisation	An organisation responsible for coordinating a vulnerability initiative, and with remit for the PURPOSE.
Responsible Organisation	An organisation who is made responsible for a CASE.
Delivery Organisation	A service provider who delivers actions that respond to a NEED.

Organisation

Attributes

Attribute	Description	Data type	Occurs
Name		line	once
Department		line	once
Contact Person		line	once
Contact Point		Contact Point	many
Identifier	Reference by which the organisation is known, e.g. * GDS Register of Local Authorities * Companies House Number * Charity Number	Identifier	many

Relationships

Responsible Organisation responsible for Case → Case
Delivery Organisation determines Plan → Plan
Delivery Organisation provides Service → Service
Delivery Organisation performs Action → Action

Outcome

Implements Concepts from SAVVI Concept Model

Concept	Description
Outcome	A result that has been achieved by addressing the NEEDs of a Person or Household.

Outcome

Attributes

Attribute	Description	Data type	Occurs
Type		Type	once
Description	A description of the Outcome.	text	once
Date	The date that the Outcome was achieved.	date	once

Relationships

Need has Outcome ← Need

Person

Implements Concepts from SAVVI Concept Model

Concept	Description
Person	An Individual who may be vulnerable.

Person

Attributes

Attribute	Description	Data type	Occurs
Name	The official name of a person.	Person Name	once
BirthDate	The date that a person was born.	Birth Date	once
RegisteredSex	The sex recorded for a person in an official civil registration or legal record, such as the sex recorded at birth. Use an agreed code list such as Codesystem-administrative-gender - FHIR v5.0.0	lookup	once
Gender	A social category for the sex that a person self-presents as. Use an agreed code list such as Codesystem-administrative-gender - FHIR v5.0.0	lookup	once
Identifier	References by which a person is known, in various schemes. e.g. NiNo, Health Number, a local reference.	Identifier	many
PreviousName	Names that a person has previously been known as.	Person Name	many
Alias	An assumed or additional name that a Person sometimes uses, or a shortened diminutive version of a name, e.g. Betty, Smithy, by which a Person is generally known by family and friends, or to a Service.	line	many

Relationships

Residence residence of Person ← Residence
Household composed from Person ← Household
Person has need Need → Need
Person has vulnerability Vulnerability → Vulnerability
Person described by Risk Factor → Attribute

Place

Can mean

a one-of polygon
a street
a neighbourhood
an existing statistical or administrative geography

Implements Concepts from SAVVI Concept Model

Concept	Description
Place	A geographic area.

Place

Attributes

Attribute	Description	Data type	Occurs
Name	The name of the Place	line	once
Extent	A geographic shape expressed using an established data standard such as * the OGC Well-Known Text (WKT) geometry format (`POLYGON`). * GeoJSON	line	once
Identifier		Identifier	once

Relationships

Residence contained in Place ← Residence

Plan

Implements Concepts from SAVVI Concept Model

Concept	Description
Plan	A set of planned actions designed to respond to a NEED over a period.

Plan

Attributes

Attribute	Description	Data type	Occurs
Start Date	The date that the plan starts from.	date	once
End Date	The date when the plan has ended, or is expected to end.	date	once
Description	A description of the plan.	text	once
Activity Type	The Activities that the Plan includes.	Type	many

Relationships

Plan addresses Need → Need
Delivery Organisation determines Plan ← Organisation

Referral

Implements Concepts from SAVVI Concept Model

Concept	Description
Referral	A decision to direct a NEED to a support SERVICE.

Referral

Attributes

Attribute	Description	Data type	Occurs
Date	The date that a decision was made to make the referral.	date	once
End Date	The date that the referral ended.	date	once
Type	* direct * recommended * signposted	lookup	once
Service Reference	The reference assigned by the Service	line	once

Relationships

Service referral from Referral ← Service
Need has referral Referral ← Need

Residence

Implements Concepts from SAVVI Concept Model

Concept	Description
Residence	A home of a PERSON

Residence

Attributes

Attribute	Description	Data type	Occurs
Address		Property Address	once
Characteristic	Information about the residence such as the number or bedrooms, condition.	Characteristic	many
Identifier	Properties are known by Identifiers such as the UPRN from GeoPlace.	Identifier	many
Map Pin		Coordinate	once

Relationships

Residence residence of Person → Person
Residence contained in Place → Place
Residence residence of Household → Household

Service

Implements Concepts from SAVVI Concept Model

Concept	Description
Service	The ability for a Delivery Organisation to carry out one or more predetermined methods designed to deliver an OUTCOME.

Service

Attributes

Attribute	Description	Data type	Occurs
Name	The name of the Service.	line	once
Identifier	An Identifier that can be looked up, to provide more information about the Service, such as contact information, eligibility, opening times and so on.	Identifier	once
Type	A categorisation of the type of Service	Type	many
URL	A URL to a web page to give more information about a Service	line	once

Relationships

Service referral from Referral → Referral
Delivery Organisation provides Service ← Organisation

Vulnerability

Implements Concepts from SAVVI Concept Model

Concept	Description
Vulnerability	The increased risk of a poor outcome.

Vulnerability

Attributes

Attribute	Description	Data type	Occurs
Type		Type	once
Risk Category		Type	many

Relationships

Case about Vulnerability ← Case
Household has vulnerability Vulnerability ← Household
Person has vulnerability Vulnerability ← Person

Structures in SAVVI Dictionary

Type

To tag a thing with a type.

Type

Attributes

Attribute	Description	Data type	Occurs
Scheme	To define the scheme that that the type is taken from. e.g. 'LG Inform Circumstance List'	lookup	once
Term	A term that represents a type. e.g. 'unemployed'. Where a scheme has been defined, this should be a term from that scheme.	line	once
URI	A persistent identifier for the Term. This should be an HTTP Resolvable Identifier - see Persistent resolvable identifiers - GOV.UK (www.gov.uk)	line	once

Used by Entities

Action
Attribute
Need
Outcome
Plan
Service
Vulnerability

Used by Structures

Characteristic

Case Outcome

Attributes

Attribute	Description	Data type	Occurs
Code		lookup	once
Description		text	once

Used by Entities

Case

Identifier

Attributes

Attribute	Description	Data type	Occurs
Scheme	The name of a controlled set of identifiers.	lookup	once
Reference	A reference to uniquely identify a thing	line	once
Pseudonymised?	To indicate that the reference is pseudonymised	yes/no	once

Used by Entities

Household
Organisation
Person
Place
Residence
Service

Contact Point

Details for all kinds of technology-mediated contact points for a person or organisation, including telephone, email, etc.

Contact Point

Attributes

Attribute	Description	Data type	Occurs
System	Telecommunications form for contact point	Contact System Types	once
value		line

Used by Entities

Organisation

Person Name

Attributes

Attribute	Description	Data type	Occurs
Title		line	once
Family Name		line	once
Given Name		line	many
Unstructured Name	A rendition of the name that does not attempt to indicate meaning of the parts in the name. e.g. Mr Bert Smith.	line	once

Used by Entities

Person

Birth Date

The date that a Person was born.

Birth Date

Attributes

Attribute	Description	Data type	Occurs
Date		date	once
Estimated	To indicate that the date is an estimate. If false, or absent, then the date is not at estimate.	yes/no	once

Used by Entities

Person

Property Address

Attributes

Attribute	Description	Data type	Occurs
Line		line	many
Postcode		line	once

Used by Entities

Residence

Characteristic

To describe a feature of a thing.

Characteristic

Attributes

Attribute	Description	Data type	Occurs
Type	The Type of the Characteristic.	Type	once
Value	An optional value that quantifies the Characteristic. e.g. if the Type is 'number of bedrooms', the Value may be 3. Many Types will not need a value.	line	once
Date From	The date from which the Characteristic is true.	date	once
Date To	The date from which the Characteristic may no longer be true, or is expected to end.	date	once

Used by Entities

Residence

Coordinate

The absolute geographic location of a Location, expressed using the WGS84 datum.

Coordinate

Attributes

Attribute	Description	Data type	Occurs
Latitude	The latitude of a position expressed using the WGS84 datum.	number	once
Longitude	The longitude of a position expressed using the WGS84 datum.	number	once

Used by Entities

Residence

Enumerations in SAVVI Dictionary

Case Statuses

Derived from Codesystem-episode-of-care-status - FHIR v5.0.0

Term	Description
planned	The case is planned to start at the date specified.
waitlist	The episode has been placed on a waitlist.
active	The case is current.
onhold	The case is on hold.
finished	The case is finished.
cancelled	The case was cancelled.
Entered in Error	The case should not have been entered.

Used by Entities

Case

Contact Directions

Term	Description
inbound
outbound

Used by Entities

Contact Event

Contact System Types

Term	Description
phone
email
sms
other

Used by Structures

Contact Point

Relationships

Responsible Organisation responsible for Case

Entity from: Organisation
Entity to: Case
Cardinality: one to many

Residence residence of Person

Entity from: Residence
Entity to: Person
Cardinality: many to many

Service referral from Referral

Entity from: Service
Entity to: Referral
Cardinality: one to many

Residence contained in Place

Entity from: Residence
Entity to: Place
Cardinality: many to many

Case contains Contact Event

Entity from: Case
Entity to: Contact Event
Cardinality: one to many

Case contains Assessment

Entity from: Case
Entity to: Assessment
Cardinality: one to many

Plan addresses Need

Entity from: Plan
Entity to: Need
Cardinality: many to many

Delivery Organisation determines Plan

Entity from: Organisation
Entity to: Plan
Cardinality: one to many

Need has referral Referral

Entity from: Need
Entity to: Referral
Cardinality: many to many

Delivery Organisation provides Service

Entity from: Organisation
Entity to: Service
Cardinality: one to many

Need addressed by Action

Entity from: Need
Entity to: Action
Cardinality: one to many

Delivery Organisation performs Action

Entity from: Organisation
Entity to: Action
Cardinality: one to many

Household composed from Person

Entity from: Household
Entity to: Person
Cardinality: many to many

Case manages Need

Entity from: Case
Entity to: Need
Cardinality: one to many

Case about Vulnerability

Entity from: Case
Entity to: Vulnerability
Cardinality: one to many

Need has Outcome

Entity from: Need
Entity to: Outcome
Cardinality: one to many

Household has need Need

Entity from: Household
Entity to: Need
Cardinality: one to many

Person has need Need

Entity from: Person
Entity to: Need
Cardinality: one to many

Household has vulnerability Vulnerability

Entity from: Household
Entity to: Vulnerability
Cardinality: one to many

Person has vulnerability Vulnerability

Entity from: Person
Entity to: Vulnerability
Cardinality: one to many

Household described by Risk Factor

Entity from: Household
Entity to: Attribute
Cardinality: one to many

Person described by Risk Factor

Entity from: Person
Entity to: Attribute
Cardinality: one to many

Residence residence of Household

Entity from: Residence
Entity to: Household
Cardinality: one to many