TEDY specifications
Specifications for the TEDY module (the terminology editor of the reference-editor rewrite). Authored with the process in ../../spec-authoring.md and the EMR spec rules (/Users/igor/source/emr/docs/specifications/rules.md + _templates/).
Conventions
- Prefix:
TEDY(EMR’s terminology prefix isTRM; keep these template/frontmatter-compatible so they can move upstream toemr/docs/specifications/if adopted). - Feature-family IDs (MDM pattern): each resource is a family under
TEDY.NN:TEDY.NN— overview / common spec (tool-feature): owns the shared data model, value sets, FHIR mapping, privileges, common API surface, navigation. Child specs reference it and do NOT duplicate those.TEDY.NN.1— List (resource-list)TEDY.NN.2— Add / Create (resource-create)TEDY.NN.3— View / Management (resource-management)- further children (
.4+) for tools/sub-screens.
- Each child opens with a
## Feature groupingsection linking the root + siblings. - State: start
Proposed; advance only on approval. _scans/holds Step-1 live-scan notes/screenshots from dev-tx.example.
Index
TEDY.01 — Code System family:
| ID | Spec | Template | State |
|---|---|---|---|
| TEDY.01 | Code System — overview / common (data model, FHIR, privileges, API, navigation) | tool-feature | Proposed |
| TEDY.01.1 | Code System — List | resource-list | Proposed (built) |
| TEDY.01.2 | Add Code System | resource-create | Proposed (pending write flow) |
| TEDY.01.3 | Code System — View | resource-management | Proposed (built, read-only) |
| TEDY.01.4 | Code System — Concept Presentation (configurable table + editable detail) | tool-feature | Proposed (built) |
TEDY.02 — Value Set family:
| ID | Spec | Template | State |
|---|---|---|---|
| TEDY.02 | Value Set — overview / common (compose + expansion model, full REST surface, FHIR, privileges, API, navigation) | tool-feature | Proposed (built) |
| TEDY.02.1 | Value Set — List | resource-list | Proposed (built) |
| TEDY.02.2 | Add Value Set | resource-create | Proposed (built) |
| TEDY.02.3 | Value Set — View (Summary · Metadata · Concepts/expansion · Rules/compose + editor) | resource-management | Proposed (built) |
TEDY.03 — Map Set family:
| ID | Spec | Template | State |
|---|---|---|---|
| TEDY.03 | Map Set — overview / common (scope + association model, full REST surface, ConceptMap FHIR) | tool-feature | Proposed (built) |
| TEDY.03.1 | Map Set — List | resource-list | Proposed (built) |
| TEDY.03.2 | Add Map Set | resource-create | Proposed (built) |
| TEDY.03.3 | Map Set — View (Summary · Metadata · Associations grid + editor) | resource-management | Proposed (built) |
New-module families (research + first-slice implementation; open questions in TEDY-new-modules-open-questions.md):
| ID | Spec | State |
|---|---|---|
| TEDY.06 | Implementation Guides | Proposed (list built; deeper screens phased) |
| TEDY.07 | Spaces | Built (list · Metadata Core+GitHub · linked CS/VS/MS add-as-link · Comparison · Repository) |
| TEDY.08 | Servers (terminology/FHIR registry) | Proposed (built: list+filter+create, summary authoritative widgets, full metadata + check-connection, resources browser w/ viewer links, authoritative editor) |
| TEDY.09 | Ecosystems | Proposed (built: list + add/edit) |
| TEDY.10 | Defined Properties | Built (list + create/edit via ResourceList/ResourceForm) |
| TEDY.11 | Naming Systems | Built (list + lifecycle + create/edit with identifiers editor) |
| TEDY.12 | List bulk actions (CS/VS/MS + Space tabs) | Built (select → activate/retire/add-to-release/delete/unlink) |
| TEDY.13 | Releases | Built (list + TxResourceBar detail — Summary w/ Resources+Errors+Checks+Notes+Tasks · Metadata · Provenance · Comparison; add-resource autocomplete+version; server-sync phased) |
| TEDY.14 | Global Search | Built (Concepts · CS · VS · MS · SNOMED groups + space/publisher/CS filters) |
| TEDY.15 | Landing (home dashboard) | Built (Resources/Modeling/Management count cards → lists) |
| TEDY.16 | Unified resource metadata (CS/VS/CM/SD) | Proposed (comparison + unification plan; close CS dataset gap) |
TEDY.17 — File & Source Import family:
| ID | Spec | Template | State |
|---|---|---|---|
| TEDY.17 | File & Source Import — overview / common (analyze→process→job spine, transport, IA/dashboard, privileges, reuse machinery) | tool-feature | Proposed (built) |
| TEDY.17.1 | Code System file import (analyze + column mapping + options + saved/template/portable config) | tool-feature | Proposed (built) |
| TEDY.17.2 | Value Set file import (analyze + code/display mapping into a rule set) | tool-feature | Proposed (built) |
| TEDY.17.3 | Map Set file import (fixed CSV template + scope editor; no analyze) | tool-feature | Proposed (built) |
| TEDY.17.4 | External sources — WHO ICD-10 · Orphanet · LOINC | tool-feature | Proposed (built) |
Cross-cutting:
| ID | Spec | Template | State |
|---|---|---|---|
| TEDY.18 | Configuration & environment variables (VITE_/TX_/TEDY_/OAUTH_ surface, backward-compatible; migration script) | tool-feature | Built |
Next families: TEDY.04 Structure Definitions / TEDY.05 Structure Maps (built, spec pending), … (same overview + list/create/view shape). Build order follows the code — Code Systems first (spec ↔ code cross-check), then Value Sets, etc. Key ValueSet difference: members are derived by expanding the version’s compose ruleSet (or read from its snapshot), not owned like Code System concepts.