Case Study | Healthcare Technology | Legacy Modernization
450K Lines of Code. Zero Downtime.
Healthcare Platform Resurrection: Rails 3 to 7
Context
A top-10 US telehealth and EHR provider was running their entire clinical platform on Rails 3.2, four major versions behind, with 320 ActiveRecord models, 2.5 million patient records, and 15,000 daily clinical users. Security patches had stopped. Gem compatibility was breaking. Recruiting was impossible because nobody wanted to write Rails 3 in 2022. The system processed lab orders, prescription routing, and clinical documentation. It could not go down, not even for a maintenance window. HIPAA and SOC 2 compliance had to be maintained throughout every phase of the migration. The client had attempted the migration twice internally and abandoned both attempts.
Approach
- •Testing-first strategy: spent the first 3 months building test coverage from 35% to 85% before touching a single line of migration code
- •Dual-boot execution using the bootboot gem to run Rails 3 and Rails 7 simultaneously in the same codebase, migrating one subsystem at a time
- •HIPAA-compliant migration protocol: every code change went through security review, and PHI handling was verified at each Rails version boundary
- •Zero-downtime deployment with progressive rollout: 5% of traffic, then 25%, then 50%, then full cutover per subsystem