# profiles/okf-domain-profile.v1.yaml

Browser-rendered handoff of repository-authored YAML. Source identity: `profiles/okf-domain-profile.v1.yaml`. Links and original summaries are shown; external source content is not redistributed.

    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