Skip to content

Research and plan: align with dbt, FHIR, and other external tools#52

Merged
ktjn merged 3 commits into
mainfrom
claude/alignment-dbt-fhir-tools-emkbtz
Jun 14, 2026
Merged

Research and plan: align with dbt, FHIR, and other external tools#52
ktjn merged 3 commits into
mainfrom
claude/alignment-dbt-fhir-tools-emkbtz

Conversation

@ktjn

@ktjn ktjn commented Jun 14, 2026

Copy link
Copy Markdown
Owner

Summary

  • Adds docs/dbt-fhir-tool-alignment.md, a research/planning document mapping Modelable's domain/model/projection/lineage/classification concepts onto:
    • dbt: sources, model contracts, model versions, meta, groups/access, exposures, and the semantic layer (MetricFlow).
    • FHIR: Resources, StructureDefinitions, Profiles, Extensions, canonical URLs/versioning, ValueSets/CodeSystems, and Implementation Guides.
    • Other tools surveyed: OpenLineage, Iceberg/Delta table-format schema evolution, Snowplow/Segment tracking plans, OMOP CDM, and GraphQL SDL/federation.
  • Proposes phased export/import emitters (dbt schema.yml/source export+import, FHIR R4 profile export+import for a small base-resource set) that slot into the existing phased plan from external-tools-data-modelling.md.
  • Updates docs/README.md to index the new document and ROADMAP.md "Next" section to reference the proposed dbt/FHIR alignment work.
  • Classifies non-goals (no dbt execution, no FHIR servers, no IDL redesign) and open decisions (plugin vs. first-party emitters, in-scope FHIR resources, dbt type-vocabulary default).

This is research/planning only — no emitter, importer, or CLI code is added. Concrete implementation requires an issue and accepted design per ROADMAP.md.

Test plan

  • Documentation-only change — reviewed Markdown diff for internal consistency with existing terminology (domain, model version, projection, lineage, @classification/@pii, additive/breaking).
  • Verified all internal links (external-tools-data-modelling.md, migration-guide.md, emitter-spec.md, distributed-lineage-spec.md, ownership-permissions-spec.md, ROADMAP.md) resolve to existing files.
  • Confirmed new doc is referenced from docs/README.md and ROADMAP.md.

https://claude.ai/code/session_011UdKKjqh8GXnoKTZyYTbbZ


Generated by Claude Code

claude added 3 commits June 14, 2026 11:27
Maps Modelable's domain/model/projection/lineage concepts onto dbt
(model contracts, versions, exposures, meta) and FHIR (StructureDefinition,
profiles, extensions, canonical URLs), proposes phased export/import
emitters, and surveys other alignment candidates (OpenLineage, Iceberg/Delta,
Snowplow/Segment, OMOP CDM, GraphQL federation).

https://claude.ai/code/session_011UdKKjqh8GXnoKTZyYTbbZ
…ions

Imports a dbt schema.yml model or FHIR R4 StructureDefinition, diffs its
fields against an existing published model version with the existing
compatibility-diff engine, and appends a new additive/breaking version plus
an .attachments.json provenance record when the source has drifted.
@ktjn
ktjn merged commit da3b534 into main Jun 14, 2026
2 of 3 checks passed
@ktjn
ktjn deleted the claude/alignment-dbt-fhir-tools-emkbtz branch June 14, 2026 12:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants