MedCore

MedCore SA is a Spring Boot and React healthcare management platform for South African multi-site medical practices, pharmacies, and hospitals.

This repository currently contains the approved PRD and the development documentation generated from it. Start with docs/README.md for the documentation map.

Planned Stack

• Backend: Spring Boot 3.x, Java 17+, PostgreSQL 16, Redis 7.
• Frontend: Next.js 14, React 18, TypeScript, Tailwind CSS, shadcn/ui.
• Auth: Keycloak.
• Infrastructure: AWS af-south-1, EKS, Terraform, Helm, ArgoCD.
• Observability: Prometheus, Grafana, Loki, Tempo, OpenTelemetry.

Repository Direction

The intended structure is documented in docs/repo-structure.md. The product should be built phase-by-phase, beginning with the Phase 0 inventory MVP before any patient data is introduced.

Key Documentation

• Product Spec
• Architecture
• Frontend UI Spec
• API Spec
• Data Model
• Security and Compliance
• Roadmap
• Testing
• DevOps