nyashahama/healthcare-access-connector-backend

Go backend for Healthcare Access Connector – REST API powering patient-provider matching, telemedicine chat, appointment scheduling, symptom checking, and SMS/USSD services for underserved South African communities. Built with JWT auth, PostgreSQL, Redis caching, NATS messaging, and HIPAA/POPIA-compliant architecture. # Healthcare Access Connector API A healthcare access platform backend under active development toward production readiness, built with Go. It connects patients with healthcare providers, manages appointments, and facilitates healthcare service delivery. ## 🏥 Features ### Core Capabilities - 👥 **Patient & Provider Management** - Comprehensive user profiles with role-based access - 📅 **Appointment Scheduling** - Smart booking system with availability management - 🏥 **Provider Discovery** - Search and filter healthcare providers by specialty, location, availability - 📧 **Automated Notifications** - Email alerts for appointments, reminders, cancellations - 💳 **Insurance Integration** - Insurance verification and coverage checking (ready to implement) - 📊 **Medical Records** - Secure storage and sharing of health records (HIPAA-ready architecture) ### Technical Features - 🔐 **JWT Authentication** - Secure token-based authentication with role-based access (patient, provider, admin) - 🚀 **High Performance** - Redis caching for optimized data access - 📨 **Event-Driven** - NATS messaging for async operations (appointment reminders, notifications) - 📊 **Observability** - Prometheus metrics, structured logging - 🛡️ **Security** - Rate limiting, CORS, input validation, HIPAA-compliant design - 🗃️ **Clean Architecture** - Separation of concerns, dependency injection - 🐳 **Docker Ready** - Full Docker Compose setup - 🛠️ **Production Readiness Program** - In progress; see `docs/superpowers/plans/` for the active hardening plan ## 🏗️ Architecture ``` cmd/api/ # Application entry point internal/ ├── app/ # Application initialization & DI ├── config/ # Configuration management ├── domain/ # Domain models (Patient, Provider, Appointment, etc.) ├── repository/ # Data access layer ├── service/ # Business logic layer │ ├── patient/ # Patient management │ ├── provider/ # Provider management │ ├── appointmen …