rivheal-docs

RivHeal Platform Documentation

Living documentation for the RivHeal EMR & patient-facing platform.
Last generated: 2026-05-30

What is RivHeal?

RivHeal is a multi-tenant Electronic Medical Records (EMR) platform built for Nigerian healthcare providers. It combines a full clinical EMR for hospital staff, a patient-facing mobile app with AI-powered health tools, and a data intelligence layer for predictive analytics.

Repository Map

Repo Stack Purpose
rivheal-api NestJS 10, TypeORM, PostgreSQL Core EMR backend + AI endpoints
rivheal-frontend React 19, Vite, TanStack Query Admin/clinical web dashboard
rivheal-mobile-app Expo 56, React Native 0.85, NativeWind Patient mobile app (iOS + Android)
rivheal-infra Docker Compose, Traefik, Keycloak Infrastructure and deployment config
rivheal-ml-service Python 3.11, FastAPI, scikit-learn ML prediction microservice
rasa-bot Rasa 3.6 NLU health chatbot (Nigerian languages)
rivheal-website Next.js 14 Public marketing website

Documentation Index

Document Description
Architecture System architecture, Mermaid diagrams, component responsibilities
Principles Design principles, coding standards, security model
Features → Patient App Mobile app screens and capabilities
Features → Admin Panel Clinical EMR features and pages
Features → AI/ML AI features, models, feature flags
Features → Integrations External services (payments, SMS, maps)
Setup → Local Dev Getting started locally
Setup → Environment Variables All env vars across services
Setup → Docker Compose Running services with Docker
Setup → Deployment Staging/production deployment guide
Flows → Appointment Booking End-to-end sequence diagram
Flows → Queue Tracking Real-time queue flow
Flows → Symptom Checker + LLM AI-assisted triage flow
Flows → Medication Adherence Prescription tracking flow
Flows → Telemedicine Video consultation flow
Flows → Rasa Deploy & Train How rasa-bot connects to Docker, how to train, full chat flow
API Overview API structure, auth, versioning
Changelog Documentation update history