Developer Guide

This guide is for engineers building on, extending, or contributing to the Med-SEAL Suite. It assumes familiarity with TypeScript, Docker, and REST APIs.

---

• Environment Setup
  • Prerequisites
  • Repository Clone
  • Docker Compose Stack
  • AI Service (Local Development)
  • Patient Portal Native (Mobile Dev)
  • AI Frontend (Admin Dashboard)
  • Seeding Data
  • Connecting to Services
  • Rebuilding Custom Images
• FHIR Data Model
  • Key FHIR Resources
  • Reading FHIR Data
  • Writing FHIR Data
  • Coding Systems
  • Med-SEAL Conventions
  • FHIR Subscriptions
• AI Service API Reference
  • Request Lifecycle (Sequence Diagram)
  • Base URL
  • Authentication
  • Health Check
  • Chat (Companion Agent A1)
  • Nudges (Nudge Agent A3)
  • Pre-Visit Summary (Insight Agent A5)
  • Adherence Metrics (Measurement Agent A6)
  • Error Responses
• Adding a New AI Feature
  • Overview
  • Step 1: Define Your Feature
  • Step 2: Create the Route
  • Step 3: Implement the Handler
  • Step 4: Add Guard Configuration
  • Step 5: Update the Feature Matrix
  • Step 6: Connect to the Patient App
  • Step 7: Test
• Testing
  • Overview
  • AI Service Tests
  • Patient Portal Native Tests
  • Testing FHIR Integrations
  • Smoke Testing the Full Stack
  • Continuous Integration
• Extending OpenEMR
  • Extension Philosophy
  • Project Layout
  • Adding a Custom Module
  • Using the OpenEMR EventDispatcher
  • Calling the Med-SEAL AI Service from OpenEMR
  • Database Changes
  • Updating OpenEMR
  • ACL (Access Control)