CharmHealth Custom API With Patient Tracking -- 2

Job Posting: Build Custom API + Middleware + Tracking Board Integration for CharmHealth EHR

Project Overview

We use CharmHealth (CharmEHR) for scheduling, encounters, and billing. While the system is robust, it does not have a built-in patient tracking board (like PracticeEHR or urgent care dashboards).

We are seeking an experienced developer (or team) to design and implement a custom integration layer that:
1. Leverages CharmHealth REST APIs and Webhooks
2. Normalizes data into a “patient flow” tracking API
3. Provides a real-time dashboard (tracking board) view of patients in various workflow stages (Checked In, Waiting, With Provider, Ready for Billing, Discharged, etc.)

⸻

Scope of Work

1. API & Webhook Integration
• Must be able to connect to and pull from the following CharmHealth API endpoints:
• Patients (demographics, identifiers)
• Visits (check-in/out status, visit history)
• Appointments (scheduling, status changes)
• Resources (providers, rooms, staff assignments)
• Encounters (SOAP notes, signed status, billing readiness)
• Implement OAuth2.0 authentication with token refresh.
• Subscribe to CharmHealth Webhooks for real-time updates (e.g., appointment.created, appointment.checkedIn, encounter.signed).

2. Middleware Development
• Build a middleware service (Node.js, Python, or similar) to:
• Consume CharmHealth API + webhook data.
• Normalize statuses into a simplified patient workflow state machine.
• Create a new RESTful API endpoint for our internal use:
• Example: GET /api/tracking-board → returns patient status JSON.
• Must include error handling, retry logic, and secure logging.

3. Tracking Board Front-End
• Develop a web-based dashboard UI (React, Angular, or Vue preferred).
• Display real-time patient statuses in a queue format:
• Patient Name / MRN
• Current Status (Waiting, With Provider, Documentation Pending, Ready to Bill, Completed)
• Room #, Assigned Provider, Check-in time, Last update time
• Provide color-coded status indicators (green = with provider, yellow = waiting, red = delayed).
• Implement auto-refresh or WebSocket updates for real-time sync.

4. Security & Compliance
• All data handling must be HIPAA compliant.
• Use TLS/SSL for data in transit.
• Ensure role-based access control for dashboard.

5. Testing & Deployment
• Work first in CharmHealth Sandbox.
• Provide unit and integration testing for all endpoints.
• Deploy on a cloud host (AWS/Azure/GCP) or on-prem server (to be decided).
• Provide documentation for handoff (API endpoints, setup instructions, maintenance guide).

⸻

Deliverables
• Middleware service (source code + documentation).
• REST API endpoint(s) for tracking board data.
• Front-end tracking board dashboard (web-based, responsive).
• Deployment scripts/configs (Docker preferred).
• Documentation & training for admin handover.

⸻

Milestone Payments (25% Each)

Milestone 1 – API & Webhook Integration (25%)
• Connect to CharmHealth Patients, Visits, Appointments, Resources, and Encounters endpoints.
• Demonstrate authentication + data pull.
• Subscribe to one webhook event and deliver sample payloads.

Milestone 2 – Middleware Development (25%)
• Middleware consumes API/webhook data.
• Exposes normalized patient workflow via /api/tracking-board.
• Error handling, logging, retry logic included.

Milestone 3 – Tracking Board Dashboard (25%)
• Front-end UI displaying live patient flow.
• Color-coded statuses, provider/room assignment, real-time updates.
• Connected to middleware in dev/test.

Milestone 4 – Testing, Deployment & Handover (25%)
• Deploy to hosting environment.
• End-to-end testing in sandbox/live.
• Documentation and final handoff.

⸻

Required Skills
• REST APIs + OAuth2.0 authentication.
• Webhook-driven workflows.
• Proficiency in Node.js/Python (backend).
• Front-end experience in React/Angular/Vue.
• Real-time dashboards (WebSocket/polling).
• HIPAA-compliant healthcare integrations.
• Familiarity with CharmHealth APIs (preferred).

Budget - $5000
Timeline: 6–8 weeks total (approx. 2 weeks per milestone