Bundle
composition
Who forms the unit
Layers
householdUnit`: the dwelling-sharing unit itself · `membership`: member ties, roles and tenure of belonging
World Models · legacy example
Household & Family
This meta-model describes households as dwelling-sharing units and families as webs of registered and lived relations: membership, kinship, dependency and care, and the residence linkage that ties a household to a dwelling. It is its own model because the household is simultaneously a social unit (who lives together), an administrative unit (registered relations, dependency) and a statistical unit (the census household), and these three readings must be kept coherent on one shared structure.
IDworld.h2-household-and-family
Version history0.2.0-legacy
CategoryReference example
IndustryCross-industry
Domainpeople-groups
Tagshousehold, family
Bundles and layers
Bundle
kinship
How members are related
Layers
familyRelation`: registered and lived kinship ties · `dependencyAndCare`: dependants, caregiving and maintenance arrangements
Bundle
residence
Where the unit lives
Layers
domicile`: declared and registered residence linkage to dwellings
Findings
Catalogue-native findings must describe the information grouped by each layer. This legacy version does not declare them separately.
Questions & artifacts
Questions, artifact requirements and serial naming rules are required by Vercy vNext; they remain unassigned in this reference version.
How this specification operates
Dimension & namespace
- REFERENCE `world.person` (H1): every member, relative, dependant and caregiver is a natural person referenced by identity, never copied
- REFERENCE `world.buildingAndFacility` (U): residence records point to dwellings governed by the built-environment model
- REFERENCE `world.populationGroup` (H3): households feed statistical cohorts as counting units
- imports: schema.org (ALIGN): public typing for household and family concepts
- imports: UN census recommendations (ALIGN): household and family definitions used for the statistical reading of the unit
Canon, patches & standards
- REFERENCE `world.person` (H1): every member, relative, dependant and caregiver is a natural person referenced by identity, never copied
- REFERENCE `world.buildingAndFacility` (U): residence records point to dwellings governed by the built-environment model
- REFERENCE `world.populationGroup` (H3): households feed statistical cohorts as counting units
- imports: schema.org (ALIGN): public typing for household and family concepts
- imports: UN census recommendations (ALIGN): household and family definitions used for the statistical reading of the unit
Artifact formats & serial data
Format-independent core. Concrete artifact formats and naming prefixes are not declared in this legacy version.
Policies & accepted processes
- `householdSelfManagement`: the members' joint mandate to maintain their own unit record
- `registeredRelationExtract`: registrar-certified extracts of registered relations for administrative use
- `censusAggregation`: release of household data to the statistics office in anonymized, aggregated form only
Read / add / edit / delete
CRUD procedures and interface bindings are not declared in this legacy version.
Ownership, roles & access
The household members jointly own the unit's record; the civil registrar owns registered relations within it. Access to any household or kinship data is granted by the respective owner through the catalogue's S1/S2 ownership and access models, with audit via S4.
Objects, relationships, events and projections
Objects
- `household`: a dwelling-sharing unit; key attributes: identifier, formation date, type (single, family, collective), status
- `householdMembership`: a person's belonging to a household; key attributes: person reference, role, start, end
- `householdRole`: a role within the unit; key attributes: role type (head or reference member, dependant, other), basis
- `familyRelation`: a typed kinship tie between persons; key attributes: relation type, registration status, effective period
- `dependency`: a recognized dependency of one person on another or on the unit; key attributes: dependant reference, basis, degree, period
- `careArrangement`: a caregiving arrangement; key attributes: caregiver reference, cared-for reference, scope, formality
- `residenceRecord`: the household's residence at a dwelling; key attributes: dwelling reference, kind (registered, actual), period
Relationships
- `householdMembership` -> joins -> `person` (n..1): each membership ties one person, resolved via H1, into one household
- `household` -> comprises -> `householdMembership` (1..n): the unit exists through its memberships
- `familyRelation` -> relates -> `person` (n..m): kinship ties connect persons pairwise, inside or across households
- `dependency` -> supports -> `person` (n..1): a dependency names its dependant and its supporting party
- `residenceRecord` -> locates -> `household` (n..1): residence records place the unit at a dwelling in the built-environment model (U)
- `household` -> countedIn -> `cohortDefinition` (n..m): households enter statistical cohorts defined in H3 without exposing members
Events
- `householdFormed`: a new household unit came into existence
- `memberJoined`: a person entered a household
- `memberLeft`: a person left a household
- `relationRegistered`: a family relation (marriage, partnership, adoption, parentage) was registered
- `relationDissolved`: a registered relation was dissolved or annulled
- `residenceChanged`: the household's registered or actual residence changed
- `householdDissolved`: the unit ceased to exist
Projections
- `administrativeHouseholdView`: registered relations, roles and residence for administrative consumers; omits informal care detail
- `censusUnitView`: household size, type and composition shape for statistics; contains no identities
- `memberSelfView`: a member's own view of the unit and every relation concerning them