Clinic Referral System
Built a clinic-to-clinic referral platform for a health services group, coordinating patient referrals, supporting documents, and operational follow-up across multiple stakeholder roles.
Context
Built a clinic-to-clinic referral platform for a health services group, coordinating patient referrals, supporting documents, and operational follow-up across multiple stakeholder roles.
Challenge
The existing process relied on email, spreadsheets, and manual coordination between clinics and operations. Errors were hard to catch and visibility was poor across the lifecycle of a referral.
Approach
- Modeled the referral lifecycle explicitly — submission, triage, follow-up, completion — instead of treating it as a generic ticket.
- Built a Laravel API with strong domain boundaries and role-aware endpoints for clinics vs. operations.
- Delivered a React front-end focused on the highest-friction screens for the operations team.
- Set up an AWS deployment workflow that supports incremental improvements without disrupting in-flight cases.
Architecture
PHP and Laravel and React and MySQL form the core stack, with the application hosted on AWS and delivered through a controlled pipeline.
Outcomes
- Replaced manual handoffs with a structured workflow operations could observe end-to-end.
- Reduced coordination overhead between clinics and the back office.
- Created a foundation that future workflow automation and reporting can build on without rewriting the core system.
Reflection
The most valuable architecture was not the most elaborate one. It was the set of boundaries that let the team make local changes while preserving confidence in the whole system.