MediCose is a comprehensive, full-stack healthcare management platform designed to bridge the gap between patients, doctors, and pharmaceutical services. It provides a seamless workflow from consultation to medication delivery, powered by high-speed AI.
- Live Dashboard Summary: Real-time overview of next appointments, latest prescriptions, and order status.
- Medical Profile Lock: Ensures data integrity by requiring profile completion before unlocking features.
- Lab Report Manager: Upload and manage medical test reports (Images/PDFs) for doctor review.
- Smart Appointments: Integrated booking and history tracking in a single unified interface.
- AI Health Assistant: Groq-powered (Llama 3.3) context-aware chatbot that knows your medical history.
- Real-time Notifications: Instant alerts for appointment confirmations, doctor assignments, and order updates.
- Practice Dashboard: High-level analytics showing total patients, today's visits, and pending requests.
- Interactive Filtering: Quick-filter appointments by "Today" or "Pending" directly from the dashboard.
- Consultation Suite: View patient symptoms and Lab Reports side-by-side while writing prescriptions.
- Professional Branding: Showcase specialization, degrees, and clinic details to patients.
- Smart Triage: Match patients with doctors based on symptoms and doctor specialization.
- Medical Records Hub: Centralized access to audit all patient reports and doctor credentials.
- Pharmacy Management: Oversee all medicine orders and update delivery status (Shipped/Delivered).
- Platform Analytics: Real-time stats on the entire healthcare ecosystem.
Backend:
- Java 21 (Spring Boot 3.4.2)
- Spring Security with JWT (Stateless Authentication)
- Spring Data JPA (Hibernate)
- MySQL Database (Relational Storage)
- Spring Mail (OTP Integration)
Frontend:
- React.js (Vite)
- Axios (API Interceptors for JWT)
- CSS3 (Scoped Styles for UI Isolation)
AI Integration:
- Groq API (Llama 3.3 Model): Ultra-fast inference with RAG (Retrieval-Augmented Generation) for personalized medical advice.
- Unified Login: Automatically detects role (Patient/Doctor/Admin) and redirects.
- Profile Lock: New users are guided to complete their profile to unlock the full dashboard.
- JWT Security: Secure token-based access for all private endpoints.
- Smart Assignment: Admin matches a Patient's symptoms with a Doctor's expertise.
- Consultation: Patient books an appointment; Doctor reviews reports and writes a digital prescription.
- Pharmacy: Patient buys medicines directly from the prescription; tracks delivery in real-time.
- AI Support: Patient asks the chatbot about their specific medicines or next appointment.
- Ensure MySQL is running and create a database:
CREATE DATABASE medication_tracker; - Configure Environment Variables (Recommended) or update
application.properties:DB_PASSWORD: Your MySQL password.MAIL_USERNAME/MAIL_PASSWORD: Gmail App Password for OTPs.GROQ_API_KEY: Your Groq API key for the chatbot.
- Run the application:
./mvnw spring-boot:run
- Navigate to the frontend folder:
cd Info-MedicationTracker-main - Install dependencies:
npm install - Start the development server:
npm run dev
The system uses a robust security filter chain:
- Public Routes:
/login,/register,/password-reset/** - Private Routes: All dashboard, profile, and pharmacy actions require a valid JWT with role-based permissions.
- AI Lab Report Analyzer: Automatic OCR-based analysis of uploaded blood tests.
- Video Consultation: Integrated WebRTC for live doctor-patient calls.
- Payment Gateway: Integration with Razorpay for medicine payments.
- Mobile App: Cross-platform mobile version using React Native.