AfyaLink is an interactive healthcare platform designed to digitize hospital operations across Kenya. It replaces manual patient files with a unified electronic system accessible across hospitals countrywide.
# AfyaLink Backend
AfyaLink is an interactive healthcare platform designed to digitize hospital operations across Kenya. It replaces manual patient files with a unified electronic system accessible across hospitals countrywide.
## 🚀 Features
- Patient registration and medical record management
- Real-time data sharing between hospitals
- Secure access control for doctors, nurses, and admins
- Integration-ready FastAPI backend
- MySQL database connectivity
## 🛠️ Setup Guide
### 1️⃣ Create and activate a virtual environment
```bash
py -3 -m venv .venv
source .venv/Scripts/activate
```
### 2️⃣ Install dependencies
```bash
pip install --upgrade pip
pip install -r requirements.txt
```
### 3️⃣ Configure environment variables
```bash
cp .env.example .env
```
Edit your .env file to set:
- `DATABASE_URL` — your MySQL connection string
- `SECRET_KEY` — a unique secret key for security
### 4️⃣ Run the server
```bash
uvicorn app.main:app --reload --port 8000
```
Access the API docs at
localhost.
---
## 🧰 Tech Stack
- **FastAPI** — Backend Framework
- **MySQL** — Database
- **Uvicorn** — ASGI Server
- **Python 3.10+**
---
## 🤝 Contributing
Pull requests are welcome!
For major changes, please open an issue first to discuss what you’d like to improve.
---
## 🪪 License
MIT License © 2025 AfyaLink Project