HealthSync — Provider Intelligence Platform

AI-powered provider data validation, enrichment & directory management for healthcare payers.

---

🚀 Quick Start (Windows)

Prerequisites

• Python 3.10+ → python.org
• Node.js 18+ → nodejs.org
• Your Groq API key is already configured in backend/.env

---

Step 1 — Backend

cd healthsync_v2\backend

python -m venv venv
venv\Scripts\activate

pip install -r requirements.txt

uvicorn main:app --reload --port 8000

✅ Backend runs at: http://localhost:8000 📖 API docs at: http://localhost:8000/docs

---

Step 2 — Frontend (new terminal)

cd healthsync_v2\frontend

npm install

npm start

✅ App opens at: http://localhost:3000

---

🔐 Demo Login Accounts

Role	Email	Password
Admin	admin@healthsync.ai	Admin@123
Ops Manager	ops@healthsync.ai	Ops@123
Analyst	analyst@healthsync.ai	Analyst@123

---

🤖 AI Pipeline (4 Stages)

Input → [Validation Agent] → [Enrichment Agent] → [QA Agent] → [Directory Agent] → Output

Stage	Agent	What it does
1	Data Validation	NPI format, phone, address, license, email checks
2	Information Enrichment	Infers specialties, practice type, network adequacy
3	Quality Assurance	Fraud detection, compliance scoring, priority
4	Directory Management	Summary reports, recommended actions

---

✨ Features

• Login System — Role-based access (Admin / Ops Manager / Analyst)
• Manual Entry — Add providers one by one with guided form
• CSV Upload — Drag & drop batch upload
• Synthetic Generator — Realistic test data with intentional errors
• Live Progress — Real-time streaming job progress
• Expandable Results — Per-provider validation + enrichment + QA breakdown
• Analytics — Quality benchmarks, radar charts, throughput, fraud risk
• AI Chat — Context-aware assistant (real Groq API calls)
• Export CSV — Download all results
• Collapsible Sidebar — Clean, minimal healthcare UI

---

📁 Sample CSV

Use sample_providers.csv to test. Contains 8 providers, 2 with intentional data errors.

---

🌐 API Reference

Method	Endpoint	Auth
POST	/api/auth/login	No
POST	/api/providers/validate/batch	Yes
GET	/api/jobs/{job_id}	Yes
GET	/api/jobs/{job_id}/stream	No
POST	/api/providers/generate-synthetic	Yes
POST	/api/chat	Yes
GET	/api/dashboard/stats	Yes

---

🔧 Tech Stack

Layer	Technology
AI/LLM	Groq API (LLaMA 3.3 70B)
Backend	FastAPI + Python
Auth	JWT (PyJWT)
Frontend	React 18
Charts	Recharts
Fonts	Fraunces + DM Sans + JetBrains Mono

---

Built for Firstsource Hackathon — Challenge VI: Provider Data Validation & Directory Management