🏥 SmartSelect Health Manager (Monorepo)

SmartSelect Health is a comprehensive medical diagnostic platform powered by Artificial Intelligence. It features a dual-mode AI engine (Cloud/Local LLMs + RAG) for symptom analysis and a full-featured web interface for Patients, Doctors, and Administrators.

---

🌐 Live Demo (No Installation Required)

You can explore the application immediately without setting up a local environment. The project is deployed using a hybrid cloud architecture:

• 🖥️ Frontend Application: Launch on Vercel
• 🧠 AI Backend API: View on Hugging Face Spaces

Note: The live environment is fully functional. You can log in as a patient to test the AI diagnostic interview.

🔐 Demo Credentials (Test Accounts)

You can use these pre-configured accounts to explore the platform roles instantly.

⚠️ Public Demo Notice: > This is a shared public environment.

• Data resets automatically every 6 hours.
• Do not enter real personal data or sensitive medical information.
• Please be respectful to other visitors testing the app.

Role	Username (Email)	Password	Features to Check
Patient	patient@test.com	patient123	AI Interview, Booking, History
Doctor	doctor@test.com	doctor123	Availability Manager, Reports Review
Admin	admin@test.com	admin123	Doctor Management, Statistics

---

📸 Screenshots

1. AI-Powered Patient Interview

Patients can describe symptoms in natural language, upload images, and receive a preliminary diagnosis report generated by our Hybrid RAG Engine.

2. Doctor Dashboard & Analytics

Doctors have a dedicated command center to manage availability, review AI-generated reports, and conduct consultations.

3. Administrative Control

Admins oversee the entire clinic operations, managing medical staff and viewing platform usage statistics.

---

🛠️ Local Development (Docker & Make)

This is the recommended way to run the project for development. The entire stack (Database, Backend, Frontend) is containerized and orchestrated via Docker Compose.

1. Prerequisites

Before you begin, ensure you have the following installed:

• Docker Desktop (Ensure the Docker daemon is running)
• Make (Standard on Linux/macOS; for Windows use WSL2 or Git Bash)

🐧 For Windows Users (WSL2)

If you are on Windows, we strongly recommend using WSL2 (Windows Subsystem for Linux) instead of PowerShell or Command Prompt. This allows you to run the Makefile natively without compatibility issues.

1. Install Ubuntu: Open the Microsoft Store and install "Ubuntu".
2. Open Terminal: Launch the Ubuntu terminal.
3. Navigate to Project: Windows files are mounted under /mnt/c/.

# Example: Accessing your project on the C drive
cd /mnt/c/Users/YourName/Documents/SmartSelect-Health

2. 🗄 Database Setup

To ensure the application functions correctly, you must apply the database schema to your Supabase project.

1. Locate the Schema File: Find the schema.sql file in the root directory of frontent/.
2. Open Supabase Dashboard: Navigate to your project in Supabase.
3. Go to SQL Editor: Click on the SQL Editor icon in the left sidebar.
4. Run Query:

• Create a generic "New Query".
• Copy the entire content of schema.sql.
• Paste it into the editor and click Run.

This process will create the necessary tables (profiles, appointments, reports, doctors, availability), enable Row Level Security (RLS) policies, and set up the required triggers for user registration.

3. Environment Configuration

The application requires specific API keys to function (Database connection and AI Provider).

1. Initialize the configuration file: Run the following command to create your .env file from the template.

make setup

2. Fill in the secrets: Open the newly created .env file in the root directory and populate the variables:

• Backend / AI:

To run the backend, you need a Groq API Key.

1. Go to the Groq Cloud Console.
2. Log in and click "Create API Key".
3. Copy the generated key string.

• GROQ_API_KEY: Required for the primary high-speed LLM. Get it from Groq Console.

• Frontend / Database:

You need to retrieve these keys from your Supabase Project Settings. How to find your keys:

1. Go to your Supabase Dashboard.
2. Click on Settings -> API Keys.
3. Project URL: Copy the URL from the "Project URL" section.
4. Anon Key: Copy the key labeled anon public.
5. Service Role Key: Copy the key labeled service_role secret.

• NEXT_PUBLIC_SUPABASE_URL: Your Supabase Project URL.
• NEXT_PUBLIC_SUPABASE_ANON_KEY: Your Supabase Public API Key.
• SUPABASE_SERVICE_ROLE_KEY: Your Supabase Secret Key (required for server-side operations).

4. Start the Application

We use a Makefile to simplify Docker commands. To build the images and start the services:

make start

What happens next?

1. Build: Docker builds the Python (FastAPI) and Node.js (Next.js) images.
2. Orchestration: docker-compose spins up the containers in detached mode.
3. Networking: Internal networking is established between the frontend and backend.

5. Access the App

Once the terminal says ✅ System ready!, access the services at:

• Frontend (Web App): http://localhost:3000
• Backend (API Docs): http://localhost:8000/docs

---

🕹️ Management Commands

Use these commands from the root directory to manage the lifecycle of the application.

Command	Description
make help	Show all available commands.
make setup	Creates the .env file if it doesn't exist.
make start	Builds images (if changed) and starts the containers in the background.
make stop	Stops and removes the running containers.
make restart	Full restart cycle (stop followed by start).
make logs	Tail the logs of all containers (Press Ctrl+C to exit).
make clean	Destructive: Stops containers and removes images/volumes. Use for a fresh start.

---

📂 Project Structure

This is a Monorepo containing both the AI Backend and the Web Frontend.

.
├── backend/                # Python/FastAPI application
│   ├── app/                # Core logic, LLM services, RAG implementation
│   ├── Dockerfile          # Standard Docker build
│   └── Dockerfile.hf       # Optimized build for Hugging Face Spaces
├── frontend/               # Next.js 16 application
│   ├── src/app/            # App Router (Dashboards, Auth, Chat)
│   └── components/         # UI Components (Doctor/Patient panels)
├── docker-compose.yml      # Orchestration of Backend + Frontend
├── Makefile                # Command shortcuts
└── .env.example            # Template for environment variables

For detailed documentation on specific components, please refer to:

• Backend Documentation (Architecture, RAG, API Endpoints)
• Frontend Documentation (Role-based logic, Supabase setup, UI Stack)

---

👥 Authors & Credits

SmartSelect Health was architected and built by:

Kyrylo Kapinos

• Backend: Initial project skeleton, Authentication logic.
• Frontend: Authentication flows, Admin Dashboard implementation, Logo design.
• Database: Schema and integration for Auth and Admin modules.

Vasyl Ishchuk

• Technical Lead / DevOps: Dockerization of the stack, CI/CD pipelines, Hugging Face & Vercel integrations.
• Backend: Core AI Logic (LLM/RAG), Multi-modal integration, new feature development.
• Frontend: Doctor & Patient Dashboards, Chat interfaces.
• Database: Schema and logic for Doctor/Patient interactions.