profiles/okf-domain-profile.v1.yaml

profile_version: okf-domain-profile.v1
status: approved
observed_at: "2026-08-07"

approval:
  state: approved
  approved_by: owner:chris-page-gov
  approved_at: "2026-08-07"
  authorized_actions:
    - bounded_source_family_registration
    - implementation_of_three_vertical_slices
    - licensing_and_rights_decisions
    - exhaustive_link_only_reference_family_inventory
    - staged_leaf_reference_registration_against_approved_service_families
    - local_authority_and_regulator_denominator_research
    - staged_full_population_implementation
    - metadata_only_source_link_verification
    - governed_semantic_projection_generation
    - local_full_population_explorer_evaluation
  blocked_actions:
    - source_snapshot_acquisition
    - source_content_redistribution
    - unbounded_or_unstaged_leaf_source_acquisition
    - production_vocabulary_assertions
    - public_bundle_publication

collection:
  id: okf-uk-living
  title: A Life in the UK
  purpose: >-
    Explain public services, rights, responsibilities and life events from a
    citizen perspective while teaching how data becomes information,
    knowledge and an ontology.
  in_scope:
    - citizen needs, public services, service episodes and outcomes
    - jurisdiction, authority, evidence, time, redress and provenance
    - official, normalized, inferred and editorial-example assertion status
    - synthetic learning journeys across UK, national and local boundaries
  out_of_scope:
    - personalized eligibility, medical or legal decisions
    - real personal dossiers or production case management
    - unsupported equivalence across jurisdictions or source identities
    - unbounded or unstaged leaf acquisition outside the approved 293-family denominator and corpus policy
  denominators:
    - id: initial-vertical-slices
      target: 3
      coverage: missed rubbish collection; learning to drive and enforcement; death and bereavement
    - id: uk-nations
      target: 4
      coverage: England, Scotland, Wales and Northern Ireland
    - id: future-service-families
      target_range: 250-400
      target: 293
      status: owner_approved_named_denominator
      register: source/service-family-denominator.v1.yaml
    - id: exhaustive-reference-cells
      target: 120
      coverage: 24 domains by UK-or-England, Scotland, Wales, Northern Ireland and local reference scope
      status: 96_covered_and_24_local_partial
    - id: future-competency-questions
      target_minimum: 100
      status: deferred_until_slice_review

users:
  - id: citizen-learner
    need: Understand an everyday route and the concepts and relationships behind it.
  - id: service-navigator
    need: Find the responsible route, evidence, deadline and redress boundary.
  - id: ontology-author
    need: Add sourced concepts without erasing identity, jurisdiction or uncertainty.
  - id: reviewer
    need: Audit coverage, provenance, rights, limitations and generated assertions.

tasks:
  - id: explain-route
    description: Explain an ordinary or exception journey in plain language.
  - id: compare-jurisdictions
    description: Identify what is shared, different or unknown across UK jurisdictions.
  - id: trace-authority
    description: Trace a claim to its source identity, observation time and derivation.
  - id: find-redress
    description: Locate review, appeal, complaint or escalation routes without deciding a case.
  - id: inspect-graph
    description: Traverse services, actors, evidence, rules, outcomes and dependencies.

authority:
  boundary: >-
    The bundle is educational and navigational. It describes sourced routes and
    hands users to current authoritative services; it never becomes the
    authority for an individual decision.
  source_classes:
    - id: authoritative-primary
      examples: legislation, responsible public body, official service guidance
    - id: authoritative-devolved
      examples: national government, national health service and justice bodies
    - id: authoritative-local
      examples: the responsible council or statutory local provider
    - id: delivery-dependent-private
      examples: compulsory insurer, bank, funeral director or contracted operator
    - id: mapping-reference
      examples: standards, vocabularies and coverage catalogues
  identity_rule: Similar labels never establish that two services, actors, rules or jurisdictions are identical.

terminology:
  - id: life-event
    label: Life event
    definition: A change or occurrence that can create one or more citizen needs.
  - id: situation
    label: Situation
    definition: A circumstance that can affect routes at multiple life stages.
  - id: user-need
    label: User need
    definition: The outcome a person is trying to achieve or problem they need to resolve.
  - id: public-service
    label: Public service
    definition: A governed capability offered to achieve a public outcome.
  - id: service-episode
    label: Service episode
    definition: A bounded interaction such as applying, reporting, paying or appealing.
  - id: evidence
    label: Evidence
    definition: A document, fact or artefact requested or produced during an episode.
  - id: redress
    label: Redress
    definition: Review, appeal, complaint, tribunal or ombudsman route.
  - id: provenance
    label: Provenance
    definition: Source identity, observation time, derivation and limitations for an assertion.

semantic_model:
  central_path:
    - life-event-or-situation
    - user-need
    - public-service
    - service-episode
    - outcome
  supporting_concepts:
    - person-role
    - provider
    - jurisdiction
    - rule
    - requirement
    - evidence
    - channel
    - cost-or-transfer
    - decision-or-artefact
    - redress
    - time-constraint
    - source
  relationship_rule: Every material edge must retain assertion status and supporting evidence or be explicitly marked unsupported.

standards:
  - id: okf
    version: "0.2"
    role: core authored Markdown and bundle conventions
    applicability: selected
  - id: cpsv-ap
    version: "3.2.0"
    role: mapping reference for public service, event, evidence, rule, channel, cost and output
    applicability: planned_mapping_not_claimed_conformance
  - id: open-referral-uk
    version: observed-2026-08-07
    role: mapping reference for local service, organisation, location, schedule, cost and required document detail
    applicability: planned_mapping_not_claimed_conformance
  - id: skos
    version: w3c-recommendation
    role: controlled concepts and broader or narrower navigation
    applicability: planned
  - id: owl-rdfs
    version: owl-2
    role: governed class and relationship semantics
    applicability: planned
  - id: prov-o
    version: w3c-recommendation
    role: derivation and provenance
    applicability: planned
  - id: shacl
    version: w3c-recommendation
    role: publication shapes and validation reports
    applicability: planned

rights:
  repository_code: MIT
  repository_documentation: MIT
  repository_ontology_terms: MIT
  decision_register: source/rights-decisions.v1.yaml
  acquired_sources: source_family_decisions_recorded
  linked_references: links_and_summaries_only
  source_content_redistribution_allowed: false
  source_snapshots:
    acquired: false
    redistribution_allowed: false
  generated_projections:
    licence: MIT
    redistribution_allowed: true
    rule: >-
      Only repository-authored structure, original summaries, unprotected
      facts and links; embedded upstream expression retains upstream terms and
      requires a new compatibility decision.
  publication_allowed: false
  rule: >-
    Licensing decisions do not authorize publication; an explicit owner
    request and release validation remain required.

privacy:
  real_personal_data_allowed: false
  synthetic_personas_required: true
  production_case_management_allowed: false
  sensitive_inference_allowed: false

assertion_policy:
  statuses:
    official: Directly supported by an identified authoritative source within its stated scope.
    normalized: A documented local representation or mapping derived from identified sources.
    inferred: A generated relationship with explicit derivation that is never presented as official.
    editorial-example: Synthetic or explanatory material clearly separated from sourced claims.
  unknown_rule: Unknown, unavailable and not yet researched are never encoded as false.

jurisdictions:
  required:
    - uk-wide
    - england
    - scotland
    - wales
    - northern-ireland
    - local
  rule: GOV.UK routing does not establish uniform UK applicability; national and local variants require their own evidence.

freshness:
  observed_at_required: true
  source_identity_required: true
  review_policy_required_per_source_family: true
  stale_assertion_policy: retain_observation_and_label_limitation
  silent_refresh_allowed: false

validation:
  required_commands:
    - uv run --locked python scripts/build_okf_bundle.py
    - uv run --locked python scripts/build_okf_bundle.py --check
    - uv run --locked python scripts/check_okf.py
    - uv run --locked python scripts/check_contracts.py
    - uv run --locked python scripts/check_sources.py
    - uv run --locked python scripts/check_inventory.py
    - uv run --locked python scripts/check_service_denominator.py
    - uv run --locked python scripts/check_corpus_policy.py
    - uv run --locked python scripts/check_rights.py
    - uv run --locked python -m unittest discover -s tests
  fixture_contract: vertical-slice-fixture.v1
  release_validation_required: true
  local_only_until_publication_request: true

constraints:
  - authored Markdown and source files are the source of truth
  - generated outputs are rebuilt and never patched by hand
  - exhaustive reference-family discovery is authorized only for links, dated rights evidence and original summaries
  - snapshots, source-content redistribution and unbounded or unstaged leaf acquisition stay disabled
  - no personalized eligibility, legal or medical decisions
  - no real personal data
  - no unsupported jurisdictional or identity equivalence
  - no public bundle link before exact deployed browser verification

gaps:
  - id: licence-decisions
    status: complete_for_repository_and_registered_source_families
    blocks: none_within_link_and_summary_policy
  - id: explorer-consumer-inventory
    status: partial
    blocks: final compatibility lock
  - id: source-family-register
    status: complete_for_reference_family_denominator_three_slices_and_approved_293_family_plan
    blocks: staged_leaf_reference_implementation_and_review
  - id: exhaustive-reference-inventory
    status: complete_120_of_120_cells_with_24_local_cells_partial
    blocks: local_authority_registry_regulator_mappings_and_specialist_reviewer_appointments
  - id: ontology-predicate-registry
    status: planned
    blocks: governed semantic edge publication
  - id: shacl-shapes
    status: planned
    blocks: claimed SHACL conformance

decisions:
  - id: three-slices-first
    assertion_status: editorial-example
    decision: Implement and review three vertical slices before broad corpus expansion.
  - id: local-assurance-default
    assertion_status: editorial-example
    decision: Run evaluation locally until the owner explicitly requests publication.
  - id: pages-manual-only
    assertion_status: editorial-example
    decision: GitHub Pages updates require an explicit owner request and frozen candidate.
  - id: linked-reference-first
    assertion_status: editorial-example
    decision: Link and summarize source content; do not redistribute it even when a source-family licence permits broader reuse.
  - id: repository-mit
    assertion_status: editorial-example
    decision: License repository-authored code, documentation, ontology terms and eligible generated projections under MIT.
  - id: owner-authorized-reference-inventory
    assertion_status: editorial-example
    decision: >-
      On 2026-08-07 the owner authorized exhaustive link-only external
      reference-family discovery and gap analysis while retaining zero
      snapshots, no source-content redistribution and no publication.
  - id: owner-approved-corpus-acquisition-policy
    assertion_status: editorial-example
    decision: >-
      On 2026-08-07 the owner approved the 293-family staged denominator,
      exhaustive-authority plus representative-and-exception local coverage,
      GSS and applicable ODS identifiers, manual link-only health acquisition,
      regulator-first private-dependency discovery, the governed redress
      taxonomy and role-based specialist review nominations.
  - id: owner-authorized-full-population-implementation
    assertion_status: editorial-example
    decision: >-
      On 2026-08-08 the owner authorized staged implementation of all 293
      approved life-course families under life-course-population-contract.v1,
      while retaining zero snapshots, link-and-summary-only source use, local
      evaluation and the separate publication gate.

evidence:
  - id: research-overview
    resource: research/overview.md
    observed_at: "2026-08-07"
    role: project scope and initial synthesis
  - id: govuk-services
    resource: https://www.gov.uk/browse
    observed_at: "2026-08-07"
    role: coverage reference, not world ontology
  - id: cpsv-ap-320
    resource: https://semiceu.github.io/CPSV-AP/releases/3.2.0/
    observed_at: "2026-08-07"
    role: semantic mapping reference
  - id: open-referral-uk
    resource: https://www.gov.uk/government/publications/open-standards-for-government/record-and-share-information-about-public-services-in-local-authorities
    observed_at: "2026-08-07"
    role: local-service mapping reference
  - id: rights-decisions
    resource: source/rights-decisions.v1.yaml
    observed_at: "2026-08-07"
    role: dated rights decisions and evidence for repository and registered source families
  - id: exhaustive-reference-inventory
    resource: source/exhaustive-reference-inventory.v1.yaml
    observed_at: "2026-08-07"
    role: 24-domain reference-family denominator, source metadata and actionable gaps
  - id: exhaustive-reference-gap-analysis
    resource: research/exhaustive-reference-gap-analysis.md
    observed_at: "2026-08-07"
    role: human review and owner follow-up handoff
  - id: service-family-denominator
    resource: source/service-family-denominator.v1.yaml
    observed_at: "2026-08-07"
    role: approved named 293-family denominator and staged acquisition waves
  - id: corpus-acquisition-policy
    resource: profiles/corpus-acquisition-policy.v1.yaml
    observed_at: "2026-08-07"
    role: approved local, identifier, health, regulator, redress, review and Explorer decisions

consumer_lock:
  consumer: OKF Explorer small bundle
  schema: okf-explorer-bundle.v0
  okf_version: "0.2"
  corpus_id: okf-uk-living
  root: index.md
  bundle: okf-bundle.json
  invariants:
    - path-based node identifiers remain stable
    - ordinary browser-compatible Markdown links remain resolvable
    - compatibility relationships retain source and target identity
    - generated output remains deterministic for the same authored source
    - relationship authority and provenance remain visible
    - node build provenance remains visible
    - source and rights handoffs remain browser-renderable
  evidence: evaluation/compatibility/okf-explorer-local.v1.yaml
  status: locked_for_okf_explorer_0_5_7_local_evaluation

dependency_graph:
  nodes:
    - domain-profile
    - rights-decisions
    - consumer-lock
    - fixture-contracts
    - source-register
    - vertical-slices
    - ontology-registry
    - evaluation
    - frozen-candidate
    - github-pages
    - browser-verification
  edges:
    - from: domain-profile
      to: fixture-contracts
      kind: governs
    - from: rights-decisions
      to: source-register
      kind: authorizes
    - from: consumer-lock
      to: vertical-slices
      kind: constrains
    - from: fixture-contracts
      to: vertical-slices
      kind: accepts
    - from: source-register
      to: vertical-slices
      kind: evidences
    - from: vertical-slices
      to: ontology-registry
      kind: exercises
    - from: vertical-slices
      to: evaluation
      kind: supplies
    - from: evaluation
      to: frozen-candidate
      kind: gates
    - from: frozen-candidate
      to: github-pages
      kind: promotes_without_rebuild
    - from: github-pages
      to: browser-verification
      kind: requires