migration-kit
Data migration and transformation utilities — the frontend counterpart to
the backend migration service. Package name: @migration-kit.
migration-system
Browse migration jobs, view status, replay failed rows.
Data mapping
Field mapping UI bridging source schemas to medOS models.
Gap reporting
Code crosswalk coverage with green/yellow/red gap reports.
What it provides
The kit packages a self-contained migration appliance ("The Box") for moving a legacy hospital system into medOS, organized as a three-phase flow: Collect (connect to a source, discover its schema, extract tables) → Map (review field mappings via a traffic-light UI) → Load (load entities, reconcile counts and referential integrity, generate a sign-off report). A separate EHR sync view covers ongoing live integration rather than one-time migration. The companion crosswalk area scores code-system coverage and produces a gap report so reviewers can see what is auto-mapped, what needs a human decision, and what is blocked.
The traffic-light model is the core idea: high-confidence mappings are auto-approved (green), ambiguous ones are clustered by pattern for human review (yellow), and unsafe ones are blocked pending co-sign (red) — so a large field set collapses into a small number of decisions.
Key exports
| Export | Kind | Purpose |
|---|---|---|
MigrationModule | component | Top-level appliance shell with its own dark-glass theme; hosts the phased views. |
CollectorView | component | Phase 1 — source connection status, schema discovery, per-table extraction progress, air-gap indicator. |
MappingStudio | component | Phase 2 — traffic-light review of field mappings (green auto / yellow review / red blocked). |
MigrationDashboard | component | Phase 3 — load progress, reconciliation checks, traffic-light summary, sign-off report. |
JobManager | component | Job list and lifecycle management across migration runs. |
EhrSyncView | component | Live EHR integration view for ongoing sync (vendor-card based). |
MappingReviewPanel | component | Crosswalk review panel over CodeMapping rows. |
crosswalkGapReport | function | Computes a GapReport (green/yellow/red coverage) from a crosswalk file. |
crosswalkSourceIndex | function | Builds a lookup set of mapped source keys for a crosswalk. |
listJobs / getJob / createJob | service fns | Job CRUD against the migration backend. |
testConnection / discoverSchema / startExtraction | service fns | Source connection, schema discovery, and extraction control. |
startCollection / startBuild / startLoad | service fns | Drive the collect → build → load phases. |
Migration types and the full service surface are re-exported from
migration.types and migration.service.
Used by
Surfaced inside the app's migration container and the data-activation admin area (mapping review and migration screens). See the Frontend overview for how kits compose, and Architecture for the market-pack and migration-adapter model on the backend side.