🏥 Medical Billing App

A full-stack Medical Billing system built with Flask (Python) as the backend and React.js as the frontend. This app allows users to manage patients, insurance details, and billing information via a RESTful API and a clean web interface.

---

📁 Project Structure

my-medical-billing-app/
├── backend-flask/
│   ├── app.py
│   ├── models.py
│   ├── routes/
│   ├── seed.py
│   ├── requirements.txt
│   └── ...
├── frontend-react/
│   ├── public/
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   └── App.js
│   └── package.json
└── README.md

---

🔧 Features

• Patient CRUD operations
• Insurance provider management
• Billing record creation
• RESTful APIs using Flask & Flask-RESTful
• React.js frontend with Axios integration
• PostgreSQL/SQLite database
• Dockerized development and deployment support

---

🚀 Getting Started

Prerequisites

• Python 3.9+
• Node.js & npm
• Docker (optional)
• PostgreSQL or SQLite

---

🐍 Backend Setup (Flask)

cd backend-flask
python -m venv venv
source venv/bin/activate  # Use venv\Scripts\activate on Windows

pip install -r requirements.txt

# Initialize DB
flask shell
>>> from app import db
>>> db.create_all()
>>> exit()

# Seed sample data
python seed.py

# Run the app
flask run

API will be available at: http://127.0.0.1:5000

---

⚛️ Frontend Setup (React)

cd frontend-react
npm install
npm start

App will run at: http://localhost:3000

Ensure the React frontend makes API calls to the backend at http://localhost:5000

---

📦 Environment Variables

Create .env files in both frontend-react and backend-flask if needed.

For Flask (backend-flask/.env):

FLASK_APP=run.py
FLASK_ENV=development
DATABASE_URL=sqlite:///medical.db

---

🐳 Docker (Optional)

To run the app using Docker Compose:

docker-compose up --build

---

📬 API Endpoints

Method	Endpoint	Description
GET	/patients	List all patients
POST	/patient	Add a new patient
GET	/patients/	Get patient by ID
PUT	/patients/	Update patient
DELETE	/patients/	Delete patient

More endpoints for billing and insurance coming soon.

---

🧪 Testing

• Backend: Pytest
• Frontend: React Testing Library

---

🧠 Future Features

• JWT authentication
• Admin dashboard
• Export billing reports (PDF/Excel)
• Mobile-responsive UI

---

🙋‍♂️ Author

• Your Name – @yourGitHub
• Contact: your-email@example.com

---

📝 License

MIT License