chore: clean up codebase and enhance documentation

Author: CypherXXXX

.gitignore

@@ -22,3 +22,5 @@ env/
 venv/
 *.egg-info/
 .cache/
+remove_comments_script.js
+remove_comments_script.cjs

README.md

@@ -1,134 +1,111 @@
-# EdCare · Hospital Management System
+# EdCare - Advanced Healthcare Management System
 
-**EdCare** is a production-grade, full-stack hospital management platform designed to bridge the gap between patients, doctors, and healthcare services. It integrates intelligent appointment scheduling, AI-powered disease diagnostics, a digital pharmacy, and comprehensive medical record management into a single, cohesive ecosystem.
+![EdCare Banner](https://img.shields.io/badge/EdCare-Healthcare_Reimagined-blue?style=for-the-badge)
+![React](https://img.shields.io/badge/React_19-20232A?style=for-the-badge&logo=react&logoColor=61DAFB)
+![Vite](https://img.shields.io/badge/Vite_6-646CFF?style=for-the-badge&logo=vite&logoColor=white)
+![TailwindCSS](https://img.shields.io/badge/Tailwind_4-38B2AC?style=for-the-badge&logo=tailwind-css&logoColor=white)
+![Supabase](https://img.shields.io/badge/Supabase-3ECF8E?style=for-the-badge&logo=supabase&logoColor=white)
+![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white)
 
-Built with performance, scalability, and user experience at its core, EdCare leverages modern web technologies to deliver a seamless healthcare experience.
+## Overview
+
+**EdCare** is a state-of-the-art healthcare management platform designed to bridge the gap between patients and medical professionals. Built with performance, security, and user experience in mind, EdCare provides a seamless interface for appointment booking, prescription management, and real-time health monitoring.
 
 ---
 
 ## 🚀 Key Features
 
-### 🏥 **Role-Based Portals**
-- **Patient Portal**: Dashboard for Appointment booking, Medical History, Prescriptions, and Lab Reports.
-- **Doctor Portal**: Dashboard for Patient Management, Prescription Writing (Rx), Schedule Management, and Digital Consultations.
-
-### 🧠 **AI & Machine Learning**
-- **Breast Cancer Risk Assessment**: Integrated Machine Learning model (Gradient Boosting Classifier) trained on the WDBC dataset.
-- **Real-time Inference**: Python/Flask backend provides instant risk analysis based on 30 clinical features from FNA biopsies.
-
-### 💊 **Digital Pharmacy**
-- **E-Commerce Experience**: Full-featured product catalog with categories (Medicines, Supplements, Devices).
-- **Cart Management**: Persistent shopping cart with real-time total calculation.
-- **Checkout Flow**: Multi-step checkout process (Shipping -> Payment -> Confirmation).
+### For Patients
+- **Smart Dashboard**: Comprehensive overview of health metrics and upcoming appointments.
+- **Instant Booking**: Real-time appointment scheduling with specialists.
+- **E-Prescriptions**: Access and manage prescriptions digitally.
+- **Secure Records**: Encrypted storage for all medical history and diagnostics.
 
-### 📅 **Smart Scheduling**
-- **Interactive Calendar**: Visual appointment management for doctors.
-- **Booking Engine**: Easy slot selection and booking for patients.
-
-### 🔐 **Security & Infrastructure**
-- **Authentication**: Secure role-based auth powered by **Supabase Auth**.
-- **Database**: Robust PostgreSQL Relational Database via **Supabase**.
-- **Edge Performance**: Optimized for speed with Vite and React Query.
+### For Doctors
+- **Practice Management**: Efficiently handle patient queues and schedules.
+- **Digital Prescribing**: Issue prescriptions instantly with built-in drug interaction checks.
+- **Patient Analytics**: Visual insights into patient health trends.
+- **Consultation Tools**: Integrated tools for better diagnosis and care delivery.
 
 ---
 
 ## 🛠️ Technology Stack
 
-### **Frontend**
-- **Framework**: [React 18](https://react.dev/)
+This project is built using a modern, robust tech stack:
+
+- **Frontend Framework**: [React 19](https://react.dev/)
 - **Build Tool**: [Vite](https://vitejs.dev/)
+- **Styling**: [TailwindCSS v4](https://tailwindcss.com/)
 - **Language**: [TypeScript](https://www.typescriptlang.org/)
-- **Styling**: [Tailwind CSS v4](https://tailwindcss.com/)
-- **State Management**: React Context + [TanStack Query](https://tanstack.com/query/latest)
-- **Forms**: [React Hook Form](https://react-hook-form.com/) + [Zod](https://zod.dev/)
-- **Icons**: [Lucide React](https://lucide.dev/)
-- **Charts**: [Recharts](https://recharts.org/)
-
-### **Backend (AI Services)**
-- **Framework**: [Flask](https://flask.palletsprojects.com/) (Python)
-- **ML Library**: [Scikit-learn](https://scikit-learn.org/)
-- **CORS**: Flask-CORS for secure cross-origin requests.
-
-### **Infrastructure**
-- **Database**: PostgreSQL (Supabase)
-- **Authentication**: Supabase Auth
-- **Storage**: Supabase Storage
+- **Backend / Database**: [Supabase](https://supabase.com/)
+- **State Management**: React Context & Hooks
+- **Icons**: Lucide React
+- **Validation**: Zod + React Hook Form
 
 ---
 
 ## 📂 Project Structure
 
-```
-_EDCARE_/
+```bash
+_EDCARE_
 ├── src/
-│   ├── components/      # Reusable UI components (Buttons, Cards, Sheets)
-│   ├── contexts/        # Global state (Auth, Cart)
-│   ├── lib/             # Utilities and Supabase client
-│   ├── pages/           # Route components
-│   │   ├── public/      # Landing, Login, Signup
-│   │   ├── patient/     # Patient dashboard pages
-│   │   ├── doctor/      # Doctor dashboard pages
-│   │   └── pharmacy/    # E-commerce pages
-│   ├── types/           # TypeScript definitions
-│   ├── App.tsx          # Main Router configuration
-│   └── main.tsx         # Entry point
-├── backend/             # Python Flask ML Service
-│   └── app.py           # AI Inference API
-├── sql/                 # Database Schema
-│   └── schema.sql       # Supabase SQL definitions
-└── README.md            # Documentation
+│   ├── components/       # Reusable UI components (Buttons, Modals, etc.)
+│   ├── contexts/         # Global state management contexts
+│   ├── lib/              # Utility functions and Supabase client
+│   ├── pages/            # Application routes (Doctor, Patient, Public)
+│   ├── types/            # TypeScript definitions
+│   ├── App.tsx           # Main application component
+│   └── main.tsx          # Entry point
+├── backend/              # Backend logic (Edge Functions)
+├── sql/                  # Database schemas and migration scripts
+├── public/               # Static assets
+└── dist/                 # Production build output
 ```
 
 ---
 
-## ⚡ Getting Started
+## 🏁 Getting Started
 
 ### Prerequisites
-- Node.js (v18+)
-- Python (v3.9+)
+- Node.js (v18 or higher)
 - npm or yarn
 
-### 1. Setup Frontend
-```bash
-# Install dependencies
-npm install
-
-# Start Development Server
-npm run dev
-```
-The application will be available at `http://localhost:5173`.
+### Installation
 
-### 2. Setup AI Backend
-```bash
-cd backend
+1.  **Clone the repository**
+    ```bash
+    git clone https://github.com/CypherXXXX/_edcare_.git
+    cd _edcare_
+    ```
 
-# Create virtual environment (optional but recommended)
-python -m venv venv
-# Windows
-venv\Scripts\activate
-# Mac/Linux
-source venv/bin/activate
+2.  **Install dependencies**
+    ```bash
+    npm install
+    ```
 
-# Install dependencies
-pip install flask flask-cors scikit-learn numpy
+3.  **Environment Setup**
+    Create a `.env` file in the root directory and add your Supabase credentials:
+    ```env
+    VITE_SUPABASE_URL=your_supabase_url
+    VITE_SUPABASE_ANON_KEY=your_supabase_anon_key
+    ```
 
-# Run Flask Server
-python app.py
-```
-The AI API will run on `http://127.0.0.1:5000`.
+4.  **Database Setup**
+    Run the SQL scripts located in the `sql/` folder or `supabase_setup.sql` in your Supabase SQL Editor to initialize the database schema.
 
-### 3. Database Setup (Supabase)
-1. Go to your [Supabase Dashboard](https://supabase.com).
-2. Open the **SQL Editor**.
-3. Copy the contents of `sql/schema.sql`.
-4. Run the query to create tables, policies, and triggers.
+5.  **Run the application**
+    ```bash
+    npm run dev
+    ```
 
 ---
 
-## 🛡️ License
+## 📄 License
 
 This project is licensed under the MIT License.
 
 ---
 
-© 2026 EdCare. Built for the future of healthcare.
+<p align="center">
+  Built with ❤️ by the EdCare Team
+</p>

sql/02_enhanced_schema.sql

@@ -0,0 +1,92 @@
+
+CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
+
+
+CREATE TABLE IF NOT EXISTS public.doctor_schedules (
+    id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    doctor_id UUID NOT NULL REFERENCES public.doctors(id) ON DELETE CASCADE,
+    date DATE NOT NULL,
+    start_time TIME NOT NULL,
+    end_time TIME NOT NULL,
+    is_available BOOLEAN DEFAULT TRUE,
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    UNIQUE(doctor_id, date, start_time)
+);
+
+
+CREATE TABLE IF NOT EXISTS public.notifications (
+    id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    user_id UUID NOT NULL REFERENCES public.profiles(id) ON DELETE CASCADE,
+    title TEXT NOT NULL,
+    message TEXT NOT NULL,
+    type TEXT CHECK (type IN ('info', 'warning', 'success', 'error')) DEFAULT 'info',
+    is_read BOOLEAN DEFAULT FALSE,
+    link TEXT,
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+
+CREATE TABLE IF NOT EXISTS public.reviews (
+    id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    doctor_id UUID NOT NULL REFERENCES public.doctors(id) ON DELETE CASCADE,
+    patient_id UUID NOT NULL REFERENCES public.profiles(id) ON DELETE CASCADE,
+    rating INTEGER CHECK (rating >= 1 AND rating <= 5),
+    comment TEXT,
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+
+CREATE TABLE IF NOT EXISTS public.medical_records (
+    id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    patient_id UUID NOT NULL REFERENCES public.profiles(id) ON DELETE CASCADE,
+    doctor_id UUID REFERENCES public.doctors(id) ON DELETE SET NULL,
+    record_type TEXT CHECK (record_type IN ('diagnosis', 'allergy', 'surgery', 'immunization', 'history', 'lab_result', 'prescription')),
+    title TEXT NOT NULL,
+    description TEXT,
+    date DATE DEFAULT CURRENT_DATE,
+    attachments TEXT[], 
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+
+CREATE TABLE IF NOT EXISTS public.payments (
+    id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    amount NUMERIC(10, 2) NOT NULL,
+    status TEXT CHECK (status IN ('pending', 'completed', 'failed', 'refunded')) DEFAULT 'pending',
+    provider TEXT NOT NULL, 
+    transaction_id TEXT,
+    order_id BIGINT REFERENCES public.orders(id) ON DELETE SET NULL,
+    appointment_id BIGINT REFERENCES public.appointments(id) ON DELETE SET NULL,
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+
+
+
+ALTER TABLE public.doctor_schedules ENABLE ROW LEVEL SECURITY;
+CREATE POLICY "Doctors can manage their own schedules" ON public.doctor_schedules FOR ALL USING (auth.uid() = doctor_id);
+CREATE POLICY "Everyone can view schedules" ON public.doctor_schedules FOR SELECT USING (true);
+
+
+ALTER TABLE public.notifications ENABLE ROW LEVEL SECURITY;
+CREATE POLICY "Users view their own notifications" ON public.notifications FOR SELECT USING (auth.uid() = user_id);
+
+
+ALTER TABLE public.reviews ENABLE ROW LEVEL SECURITY;
+CREATE POLICY "Reviews are public" ON public.reviews FOR SELECT USING (true);
+CREATE POLICY "Patients can create reviews" ON public.reviews FOR INSERT WITH CHECK (auth.uid() = patient_id);
+
+
+ALTER TABLE public.medical_records ENABLE ROW LEVEL SECURITY;
+CREATE POLICY "Patients view own records" ON public.medical_records FOR SELECT USING (auth.uid() = patient_id);
+CREATE POLICY "Doctors view assigned records" ON public.medical_records FOR SELECT USING (auth.uid() = doctor_id);
+
+
+ALTER TABLE public.payments ENABLE ROW LEVEL SECURITY;
+CREATE POLICY "Users view own payments" ON public.payments FOR SELECT USING (
+    auth.uid() IN (
+        SELECT user_id FROM public.orders WHERE id = payments.order_id
+        UNION
+        SELECT user_id FROM public.appointments WHERE id = payments.appointment_id
+    )
+);

sql/03_refinements.sql

@@ -0,0 +1,43 @@
+
+ALTER TABLE public.departments ENABLE ROW LEVEL SECURITY;
+
+
+CREATE POLICY "Publicly visible departments" ON public.departments FOR SELECT USING (true);
+
+
+
+
+
+
+CREATE TABLE IF NOT EXISTS public.messages (
+    id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    sender_id UUID NOT NULL REFERENCES public.profiles(id) ON DELETE CASCADE,
+    recipient_id UUID NOT NULL REFERENCES public.profiles(id) ON DELETE CASCADE,
+    content TEXT NOT NULL,
+    is_read BOOLEAN DEFAULT FALSE,
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+
+ALTER TABLE public.messages ENABLE ROW LEVEL SECURITY;
+CREATE POLICY "Users can view their own messages" ON public.messages 
+    FOR SELECT USING (auth.uid() = sender_id OR auth.uid() = recipient_id);
+CREATE POLICY "Users can send messages" ON public.messages 
+    FOR INSERT WITH CHECK (auth.uid() = sender_id);
+
+
+
+CREATE TABLE IF NOT EXISTS public.audit_logs (
+    id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    user_id UUID REFERENCES public.profiles(id) ON DELETE SET NULL,
+    action TEXT NOT NULL,
+    table_name TEXT NOT NULL,
+    record_id TEXT,
+    details JSONB,
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+ALTER TABLE public.audit_logs ENABLE ROW LEVEL SECURITY;
+
+
+CREATE POLICY "Admins view audit logs" ON public.audit_logs FOR SELECT USING (false); 

sql/04_fix_vitals.sql

@@ -0,0 +1,36 @@
+
+
+
+
+ALTER TABLE public.vitals 
+ADD COLUMN IF NOT EXISTS height NUMERIC;
+
+
+ALTER TABLE public.vitals 
+ADD COLUMN IF NOT EXISTS weight NUMERIC;
+
+ALTER TABLE public.vitals 
+ADD COLUMN IF NOT EXISTS temperature NUMERIC;
+
+ALTER TABLE public.vitals 
+ADD COLUMN IF NOT EXISTS oxygen_saturation INTEGER;
+
+ALTER TABLE public.vitals 
+ADD COLUMN IF NOT EXISTS heart_rate INTEGER;
+
+ALTER TABLE public.vitals 
+ADD COLUMN IF NOT EXISTS blood_pressure TEXT;
+
+
+ALTER TABLE public.vitals ENABLE ROW LEVEL SECURITY;
+
+DO $$ 
+BEGIN
+    IF NOT EXISTS (
+        SELECT 1 FROM pg_policies WHERE tablename = 'vitals' AND policyname = 'Patients can manage their own vitals'
+    ) THEN
+        CREATE POLICY "Patients can manage their own vitals" ON public.vitals
+        USING (auth.uid() = patient_id)
+        WITH CHECK (auth.uid() = patient_id);
+    END IF;
+END $$;