first commit

.gitattributes

@@ -0,0 +1,37 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text
+*.png filter=lfs diff=lfs merge=lfs -text
+*.webm filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,4 @@
+venv/
+__pycache__/
+*.pyc
+.env

README.md

@@ -0,0 +1,12 @@
+---
+title: ParkinsonDetection
+emoji: 🚀
+colorFrom: yellow
+colorTo: gray
+sdk: gradio
+sdk_version: 5.43.1
+app_file: app.py
+pinned: false
+---
+
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

app/__init__.py

@@ -0,0 +1,40 @@
+import os
+from flask import Flask
+from flask_sqlalchemy import SQLAlchemy
+from flask_login import LoginManager
+from flask_migrate import Migrate
+from flask_mail import Mail
+from config import Config
+
+# Initialize extensions
+db = SQLAlchemy()
+migrate = Migrate()
+login = LoginManager()
+login.login_view = 'auth.login' # Redirect to login page if user is not authenticated
+login.login_message = 'Please log in to access this page.'
+mail = Mail()
+
+def create_app(config_class=Config):
+    app = Flask(__name__)
+    app.config.from_object(config_class)
+
+    # Make sure these folders exist
+    os.makedirs('temp_uploads', exist_ok=True)
+    os.makedirs('spectrograms/temp', exist_ok=True)
+
+    db.init_app(app)
+    migrate.init_app(app, db)
+    login.init_app(app)
+    mail.init_app(app)
+
+    # Register Blueprints
+    from app.auth import bp as auth_bp
+    app.register_blueprint(auth_bp, url_prefix='/auth')
+
+    from app.routes import bp as main_bp
+    app.register_blueprint(main_bp)
+
+    with app.app_context():
+        db.create_all() # Create tables for our models
+
+    return app

app/auth.py

@@ -0,0 +1,75 @@
+from flask import Blueprint, render_template, redirect, url_for, flash
+from flask_login import login_user, logout_user, current_user
+from app import db
+from app.models import User
+from flask_wtf import FlaskForm
+from wtforms import StringField, PasswordField, BooleanField, SubmitField
+from wtforms.validators import DataRequired, Email, EqualTo, ValidationError
+
+bp = Blueprint('auth', __name__)
+
+# --- Forms ---
+class LoginForm(FlaskForm):
+    username = StringField('Username', validators=[DataRequired()])
+    password = PasswordField('Password', validators=[DataRequired()])
+    remember_me = BooleanField('Remember Me')
+    submit = SubmitField('Sign In')
+
+class RegistrationForm(FlaskForm):
+    username = StringField('Username', validators=[DataRequired()])
+    email = StringField('Email', validators=[DataRequired(), Email()])
+    password = PasswordField('Password', validators=[DataRequired()])
+    password2 = PasswordField(
+        'Repeat Password', validators=[DataRequired(), EqualTo('password')])
+    submit = SubmitField('Register')
+
+    def validate_username(self, username):
+        user = User.query.filter_by(username=username.data).first()
+        if user is not None:
+            raise ValidationError('Please use a different username.')
+
+    def validate_email(self, email):
+        user = User.query.filter_by(email=email.data).first()
+        if user is not None:
+            raise ValidationError('Please use a different email address.')
+
+
+# --- Routes ---
+@bp.route('/login', methods=['GET', 'POST'])
+def login():
+    if current_user.is_authenticated:
+        return redirect(url_for('main.dashboard'))
+    form = LoginForm()
+    if form.validate_on_submit():
+        user = User.query.filter_by(username=form.username.data).first()
+        if user is None or not user.check_password(form.password.data):
+            flash('Invalid username or password')
+            return redirect(url_for('auth.login'))
+        login_user(user, remember=form.remember_me.data)
+        if user.is_admin:
+            return redirect(url_for('main.admin_dashboard'))
+        return redirect(url_for('main.dashboard'))
+    return render_template('auth/login.html', title='Sign In', form=form)
+
+@bp.route('/logout')
+def logout():
+    logout_user()
+    return redirect(url_for('main.index'))
+
+@bp.route('/register', methods=['GET', 'POST'])
+def register():
+    if current_user.is_authenticated:
+        return redirect(url_for('main.dashboard'))
+    form = RegistrationForm()
+    if form.validate_on_submit():
+        user = User(username=form.username.data, email=form.email.data)
+        user.set_password(form.password.data)
+        # Make the first registered user an admin
+        if User.query.count() == 0:
+            user.is_admin = True
+            flash('Congratulations, you are now the admin!')
+        db.session.add(user)
+        db.session.commit()
+        flash('Congratulations, you are now a registered user!')
+        return redirect(url_for('auth.login'))
+    return render_template('auth/register.html', title='Register', form=form)

app/email.py

@@ -0,0 +1,15 @@
+from threading import Thread
+from flask import current_app
+from flask_mail import Message
+from app import mail
+
+def send_async_email(app, msg):
+    with app.app_context():
+        mail.send(msg)
+
+def send_email(subject, sender, recipients, text_body, html_body):
+    app = current_app._get_current_object()
+    msg = Message(subject, sender=sender, recipients=recipients)
+    msg.body = text_body
+    msg.html = html_body
+    Thread(target=send_async_email, args=(app, msg)).start()

app/ml_logic.py

@@ -0,0 +1,148 @@
+import os
+import subprocess
+import shutil
+import joblib
+import pandas as pd
+from imageio_ffmpeg import get_ffmpeg_exe
+import tensorflow as tf
+from tensorflow.keras.preprocessing import image
+import numpy as np
+import librosa
+import librosa.display
+import matplotlib
+matplotlib.use('Agg')
+import matplotlib.pyplot as plt
+import noisereduce as nr
+
+# --- Configuration ---
+AUDIO_MODEL_PATH = 'parkinson_cnn_model_stft_grayscale.h5' 
+SYMPTOM_MODEL_PATH = 'symptom_model.joblib'
+SPECTROGRAM_PATH = 'spectrograms_stft_5s_grayscale'
+TARGET_DURATION_S = 5
+
+# --- Load Both Models at Startup ---
+try:
+    audio_model = tf.keras.models.load_model(AUDIO_MODEL_PATH)
+    print(f"Successfully loaded Audio CNN model from: {AUDIO_MODEL_PATH}")
+except Exception as e:
+    print(f"FATAL: Could not load AUDIO model. Error: {e}")
+    audio_model = None
+
+try:
+    symptom_model = joblib.load(SYMPTOM_MODEL_PATH)
+    print(f"Successfully loaded Symptom model from: {SYMPTOM_MODEL_PATH}")
+except Exception as e:
+    print(f"FATAL: Could not load SYMPTOM model. Error: {e}")
+    symptom_model = None
+
+# --- Spectrogram Creation Function (Unchanged) ---
+def create_stft_spectrogram_from_audio(audio_path, save_path):
+    """
+    Loads, converts, and saves a high-quality, clean grayscale STFT spectrogram.
+    """
+    audio_path = os.path.abspath(audio_path)
+    save_path = os.path.abspath(save_path)
+    temp_dir = os.path.join(os.path.dirname(audio_path), f"temp_{os.path.basename(audio_path)}")
+    os.makedirs(temp_dir, exist_ok=True)
+    
+    try:
+        if audio_path.lower().endswith('.webm'):
+            temp_wav_path = os.path.join(temp_dir, 'converted_audio.wav')
+            try:
+                ffmpeg_executable = get_ffmpeg_exe()
+                command = [ffmpeg_executable, '-i', audio_path, '-acodec', 'pcm_s16le', '-ac', '1', '-ar', '44100', '-y', temp_wav_path]
+                subprocess.run(command, check=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
+            except Exception as e:
+                shutil.rmtree(temp_dir)
+                return False
+            processing_path = temp_wav_path
+        else:
+            processing_path = audio_path
+        
+        y, sr = librosa.load(processing_path, sr=None)
+        target_samples = TARGET_DURATION_S * sr
+        if len(y) > target_samples:
+            start_index = int((len(y) - target_samples) / 2)
+            y_segment = y[start_index : start_index + target_samples]
+        else:
+            y_segment = librosa.util.pad_center(y, size=target_samples)
+
+        y_reduced = nr.reduce_noise(y=y_segment, sr=sr)
+        N_FFT = 1024
+        HOP_LENGTH = 256
+        S_audio = librosa.stft(y_reduced, n_fft=N_FFT, hop_length=HOP_LENGTH)
+        Y_db = librosa.amplitude_to_db(np.abs(S_audio), ref=np.max)
+        plt.figure(figsize=(12, 4))
+        librosa.display.specshow(Y_db, sr=sr, hop_length=HOP_LENGTH, x_axis='time', y_axis='log', cmap='gray_r')
+        plt.axis('off')
+        plt.savefig(save_path, bbox_inches='tight', pad_inches=0)
+        plt.close()
+        shutil.rmtree(temp_dir)
+        return True
+    except Exception as e:
+        if 'temp_dir' in locals() and os.path.exists(temp_dir):
+            shutil.rmtree(temp_dir)
+        return False
+
+# --- Master Prediction Function (Corrected Version) ---
+def get_combined_prediction(symptom_data, audio_path, user_age):
+    """
+    Gets predictions from both models, combines them, and applies business logic.
+    """
+    if not audio_model or not symptom_model:
+        print("ERROR: One or both models are not loaded.")
+        return "Error: Model not loaded.", "Error", 0.5
+
+    # --- 1. Get Prediction from Symptom Model (M1) ---
+    try:
+        # Create a pandas DataFrame from the input dictionary.
+        symptom_df = pd.DataFrame([symptom_data])
+        
+        # --- THIS IS THE CORRECTION ---
+        # Define the exact feature order the model was trained on.
+        feature_order = ['tremor', 'stiffness', 'walking_issue']
+        # Reorder the DataFrame columns to match the training order.
+        symptom_df_ordered = symptom_df[feature_order]
+        
+        # Predict the probability using the correctly ordered data.
+        symptom_proba = symptom_model.predict_proba(symptom_df_ordered)[0][1]
+        print(f"Symptom Model (M1) Prediction: {symptom_proba:.4f}")
+    except Exception as e:
+        print(f"Error getting symptom prediction: {e}")
+        symptom_proba = 0.5
+
+    # --- 2. Get Prediction from Audio CNN Model (M2) ---
+    audio_proba = 0.5
+    try:
+        temp_predict_dir = os.path.join(SPECTROGRAM_PATH, 'temp')
+        os.makedirs(temp_predict_dir, exist_ok=True)
+        temp_spectrogram_path = os.path.join(temp_predict_dir, 'temp_spec.png')
+        
+        if create_stft_spectrogram_from_audio(audio_path, temp_spectrogram_path):
+            img = image.load_img(temp_spectrogram_path, target_size=(224, 224), color_mode='grayscale')
+            img_array = image.img_to_array(img)
+            img_array = np.expand_dims(img_array, axis=0)
+            img_array /= 255.0
+            audio_proba = audio_model.predict(img_array)[0][0]
+            print(f"Audio Model (M2) Prediction: {audio_proba:.4f}")
+            if os.path.exists(temp_spectrogram_path):
+                os.remove(temp_spectrogram_path)
+        else:
+            raise ValueError("Spectrogram creation failed.")
+    except Exception as e:
+        print(f"Error getting audio prediction: {e}")
+
+    # --- 3. Calculate the Final Weighted Score ---
+    weight_symptoms = 0.7
+    weight_audio = 0.3
+    final_score = (weight_symptoms * symptom_proba) + (weight_audio * audio_proba)
+    print(f"Final Combined Score: {final_score:.4f}")
+    
+    # --- 4. Make Final Decision Based on the Combined Score ---
+    cnn_result_label = "Positive" if final_score > 0.5 else "Negative"
+    
+    final_result_label = cnn_result_label
+    if cnn_result_label == "Positive" and user_age < 40:
+        final_result_label = "Negative (Age Override)"
+        
+    return final_result_label, cnn_result_label, float(final_score)

app/models.py

@@ -0,0 +1,39 @@
+from datetime import datetime
+from app import db, login
+from werkzeug.security import generate_password_hash, check_password_hash
+from flask_login import UserMixin
+
+class User(UserMixin, db.Model):
+    id = db.Column(db.Integer, primary_key=True)
+    username = db.Column(db.String(64), index=True, unique=True)
+    email = db.Column(db.String(120), index=True, unique=True)
+    password_hash = db.Column(db.String(128))
+    is_admin = db.Column(db.Boolean, default=False)
+    reports = db.relationship('Report', backref='author', lazy='dynamic')
+
+    def set_password(self, password):
+        self.password_hash = generate_password_hash(password)
+
+    def check_password(self, password):
+        return check_password_hash(self.password_hash, password)
+
+    def __repr__(self):
+        return f'<User {self.username}>'
+
+class Report(db.Model):
+    id = db.Column(db.Integer, primary_key=True)
+    age = db.Column(db.Integer, nullable=False)
+    gender = db.Column(db.String(10), nullable=False)
+    symptoms = db.Column(db.Text)
+    cnn_prediction = db.Column(db.Float)
+    cnn_result = db.Column(db.String(20)) # 'Positive' or 'Negative'
+    final_result = db.Column(db.String(20)) # Result after considering age
+    timestamp = db.Column(db.DateTime, index=True, default=datetime.utcnow)
+    user_id = db.Column(db.Integer, db.ForeignKey('user.id'))
+
+    def __repr__(self):
+        return f'<Report {self.id} - {self.final_result}>'
+
+@login.user_loader
+def load_user(id):
+    return User.query.get(int(id))

app/routes.py

@@ -0,0 +1,172 @@
+import os
+from datetime import datetime
+from functools import wraps
+from flask import Blueprint, render_template, flash, redirect, url_for, request, current_app
+from flask_login import current_user, login_required
+from werkzeug.utils import secure_filename
+from sqlalchemy import func
+from app import db
+from app.models import User, Report
+# IMPORTANT: We import the master prediction function
+from app.ml_logic import get_combined_prediction
+from app.email import send_email
+
+bp = Blueprint('main', __name__)
+
+# --- Decorator for Admin-only routes ---
+def admin_required(f):
+    @wraps(f)
+    def decorated_function(*args, **kwargs):
+        if not current_user.is_admin:
+            flash("You do not have permission to access this page.", "danger")
+            return redirect(url_for('main.dashboard'))
+        return f(*args, **kwargs)
+    return decorated_function
+
+# =============================================================================
+# === USER-FACING ROUTES
+# =============================================================================
+
+@bp.route('/')
+@bp.route('/index')
+def index():
+    """Renders the public landing page."""
+    return render_template('index.html', title='Home')
+
+@bp.route('/dashboard')
+@login_required
+def dashboard():
+    """Renders the main user dashboard, which displays past reports."""
+    reports = Report.query.filter_by(user_id=current_user.id).order_by(Report.timestamp.desc()).all()
+    return render_template('dashboard.html', title='Dashboard', reports=reports)
+
+# STAGE 1: Serves the symptom form and handles its submission.
+@bp.route('/new_test', methods=['GET', 'POST'])
+@login_required
+def new_test():
+    """On GET, displays the symptom form. On POST, validates and redirects to the audio test page."""
+    if request.method == 'POST':
+        # Now we can collect the data directly with the correct names
+        symptom_args = {
+            'tremor': request.form.get('tremor'),
+            'stiffness': request.form.get('stiffness'),
+            'walking_issue': request.form.get('walking_issue'), # <-- THIS IS THE FIX
+            'age': request.form.get('age'),
+            'gender': request.form.get('gender'),
+            'other_symptoms': request.form.get('other_symptoms', '')
+        }
+        
+        # The validation logic now works perfectly because the keys match the form names
+        if not all(symptom_args.get(key) for key in ['age', 'gender', 'tremor', 'stiffness', 'walking_issue']):
+             flash('Please complete all fields in the step before proceeding.', 'warning')
+             return render_template('new_test.html', title='New Test - Step 1')
+        
+        # Redirect to the audio test page with all data
+        return redirect(url_for('main.audio_test', **symptom_args))
+    
+    # On a GET request, just display the symptom form.
+    return render_template('new_test.html', title='New Test - Step 1')
+
+# STAGE 2: Serves the audio form and handles the final combined prediction.
+@bp.route('/audio_test', methods=['GET', 'POST'])
+@login_required
+def audio_test():
+    """On GET, displays audio form. On POST, runs both models and saves the report."""
+    if request.method == 'POST':
+        # Determine which audio file source was used.
+        if 'uploaded_audio_data' in request.files and request.files['uploaded_audio_data'].filename != '':
+            file = request.files['uploaded_audio_data']
+        elif 'recorded_audio_data' in request.files and request.files['recorded_audio_data'].filename != '':
+            file = request.files['recorded_audio_data']
+        else:
+            flash('No audio file was provided. Please record or upload a file.', 'danger')
+            return redirect(url_for('main.audio_test', **request.form))
+
+        # --- Prepare data for BOTH models ---
+        
+        # 1. Prepare data for Symptom Model (M1)
+        symptom_data_for_model = {
+            'tremor': 1 if request.form.get('tremor') != 'no' else 0,
+            'stiffness': 1 if request.form.get('stiffness') == 'yes' else 0,
+            'walking_issue': 1 if request.form.get('balance') == 'yes' else 0 # Correctly use 'balance' from form for 'walking_issue' feature
+        }
+
+        # 2. Get user age and gender
+        age = request.form.get('age', type=int)
+        gender = request.form.get('gender')
+
+        if not age or not gender:
+            flash('Required user data was lost. Please start the test over.', 'danger')
+            return redirect(url_for('main.new_test'))
+            
+        # Save the audio file temporarily
+        base_filename = secure_filename(file.filename if file.filename else "recording.webm")
+        unique_filename = f"user_{current_user.id}_{datetime.utcnow().timestamp()}_{base_filename}"
+        audio_path = os.path.join('temp_uploads', unique_filename)
+        file.save(audio_path)
+        
+        # Call the master prediction function from ml_logic
+        final_result, cnn_result, cnn_pred_value = get_combined_prediction(symptom_data_for_model, audio_path, age)
+        
+        # Create a detailed string for the database report
+        symptoms_for_report = (
+            f"Tremor: {request.form.get('tremor', 'N/A').replace('_', ' ').title()}, "
+            f"Stiffness: {request.form.get('stiffness', 'N/A').title()}, "
+            f"Balance: {request.form.get('balance', 'N/A').title()}. "
+            f"Other Notes: {request.form.get('other_symptoms', 'None')}"
+        )
+
+        # Save the final report to the database
+        report = Report(age=age, gender=gender, symptoms=symptoms_for_report, cnn_prediction=cnn_pred_value, cnn_result=cnn_result, final_result=final_result, author=current_user)
+        db.session.add(report)
+        db.session.commit()
+
+        # Prepare a dictionary for the email template for nicer formatting
+        symptoms_for_email = {
+            "Tremor": request.form.get('tremor', 'N/A').replace('_', ' ').title(),
+            "Stiffness or Slowness": request.form.get('stiffness', 'N/A').title(),
+            "Balance Issues": request.form.get('balance', 'N/A').title(),
+            "Other Notes": request.form.get('other_symptoms', 'None')
+        }
+        send_email(
+            '[Parkinson Detection System] Your Test Result',
+            sender=current_app.config['ADMINS'][0], recipients=[current_user.email],
+            text_body=render_template('email/result_notification.txt', user=current_user, report=report, symptoms=symptoms_for_email),
+            html_body=render_template('email/result_notification.html', user=current_user, report=report, symptoms=symptoms_for_email)
+        )
+        
+        flash('Your test is complete! The result has been sent to your email and is available on your dashboard.', 'success')
+        if os.path.exists(audio_path): os.remove(audio_path)
+        return redirect(url_for('main.dashboard'))
+    
+    # For a GET request, pass URL parameters to the template as hidden fields
+    symptom_data = request.args.to_dict()
+    return render_template('audio_test.html', title='New Test - Step 2', symptom_data=symptom_data)
+
+# =============================================================================
+# === ADMIN ROUTES
+# =============================================================================
+@bp.route('/admin/dashboard')
+@login_required
+@admin_required
+def admin_dashboard():
+    user_count = User.query.count()
+    report_count = Report.query.count()
+    result_stats = db.session.query(Report.final_result, func.count(Report.final_result)).group_by(Report.final_result).all()
+    chart_labels = [result for result, count in result_stats]
+    chart_data = [count for result, count in result_stats]
+    return render_template(
+        'admin/dashboard.html', 
+        title='Admin Dashboard', 
+        user_count=user_count, 
+        report_count=report_count,
+        chart_labels=chart_labels,
+        chart_data=chart_data
+    )
+
+@bp.route('/admin/users')
+@login_required
+@admin_required
+def admin_users():
+    users = User.query.order_by(User.id).all()
+    return render_template('admin/users.html', title='Manage Users', users=users)

app/static/css/new_test.css

@@ -0,0 +1,92 @@
+/* =========================================== */
+/* == Styles for the Multi-Step Test Page   == */
+/* =========================================== */
+
+/* --- Main Container --- */
+.new-test-container {
+  max-width: 700px;
+  margin: 2rem auto;
+}
+
+/* --- The Slider Mechanism --- */
+.symptom-slider-container {
+  width: 100%;
+  overflow: hidden; /* This is essential for hiding the other slides */
+}
+
+/* This is the wrapper that holds all slides in a long horizontal row */
+.symptom-slider-wrapper {
+  display: flex;
+  width: 400%; /* We have 4 slides, so 4 * 100% = 400% */
+  transition: transform 0.5s ease-in-out; /* This creates the smooth sliding animation */
+}
+
+/* --- Individual Slide Styling --- */
+.symptom-slide {
+  width: 25%; /* Each slide is 1/4 of the wrapper's width */
+  flex-shrink: 0; /* Prevents slides from shrinking to fit */
+  padding: 2.5rem;
+  box-sizing: border-box;
+}
+
+.symptom-slide h3 {
+  margin-bottom: 2rem;
+  text-align: center;
+  font-weight: 600;
+  color: #343a40;
+}
+
+/* --- Custom Radio Button Box Styling --- */
+
+/* First, we reset the default Bootstrap container for the radio buttons */
+.symptom-slide .form-check {
+  padding: 0;
+  margin-bottom: 1rem;
+}
+
+/* Then, we style the LABEL to look like a big, clickable button/card */
+.symptom-slide .form-check-label {
+  display: block; /* Makes the label take up the full width for easier clicking */
+  background-color: #f8f9fa;
+  padding: 1rem 1.25rem;
+  border: 2px solid #dee2e6;
+  border-radius: 0.375rem; /* Standard Bootstrap border-radius */
+  cursor: pointer;
+  transition: all 0.2s ease-in-out; /* Smooth transition for hover/active states */
+  font-weight: 500;
+}
+
+/* Add a hover effect for better user feedback */
+.symptom-slide .form-check-label:hover {
+  border-color: #8f94fb; /* A nice highlight color */
+  transform: translateY(-2px); /* A slight "lift" effect */
+}
+
+/* This is the key part: we completely hide the original radio button circle */
+.symptom-slide .form-check input[type="radio"] {
+  display: none;
+  opacity: 0;
+  position: fixed;
+  width: 0;
+}
+
+/* This is the magic: When the hidden radio button is checked, we style its ADJACENT label */
+.symptom-slide .form-check input[type="radio"]:checked + label {
+  background-color: #e9eafd; /* A light, pleasing primary color */
+  border-color: #4e54c8; /* Your main primary color */
+  color: #4e54c8;
+  font-weight: 600;
+  box-shadow: 0 4px 12px rgba(78, 84, 200, 0.15); /* Adds a subtle depth */
+}
+
+/* --- Button Styling --- */
+.next-btn {
+  float: right;
+  margin-top: 1.5rem;
+}
+
+.symptom-submit-btn {
+  font-weight: 600;
+  padding-top: 0.75rem;
+  padding-bottom: 0.75rem;
+}

app/static/css/style.css

@@ -0,0 +1,215 @@
+/* --- A Clean and Modern Stylesheet --- */
+
+/* 1. General & Typography */
+:root {
+  --primary-color: #4e73df; /* A nice, professional blue */
+  --primary-hover: #2e59d9;
+  --light-gray: #f8f9fa;
+  --medium-gray: #e9ecef;
+  --dark-gray: #5a5c69;
+  --text-color: #343a40;
+}
+
+body {
+  background-color: var(--light-gray);
+  color: var(--text-color);
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
+    "Helvetica Neue", Arial, sans-serif;
+}
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  font-weight: 600;
+  color: var(--dark-gray);
+}
+
+.btn-primary {
+  background-color: var(--primary-color);
+  border-color: var(--primary-color);
+}
+
+.btn-primary:hover {
+  background-color: var(--primary-hover);
+  border-color: var(--primary-hover);
+}
+
+.text-primary {
+  color: var(--primary-color) !important;
+}
+
+/* 2. Layout & Main Navigation Bar */
+
+/* This is the CRITICAL rule to prevent content from hiding behind the fixed navbar */
+body {
+  padding-top: 70px;
+}
+
+#mainNavbar .navbar-brand {
+  font-weight: 700;
+}
+
+/* 3. Authentication Pages (Login/Register) */
+.auth-wrapper {
+  /* This makes the auth card vertically centered on the page */
+  min-height: calc(100vh - 70px);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 1rem;
+}
+
+.auth-card {
+  max-width: 450px;
+  width: 100%;
+  padding: 2.5rem;
+  border: none;
+  border-radius: 0.5rem;
+  box-shadow: 0 0.5rem 1.5rem rgba(0, 0, 0, 0.08);
+  background-color: #ffffff;
+}
+
+/* 4. User Dashboard */
+.dashboard-header {
+  border-bottom: 1px solid #dee2e6;
+  padding-bottom: 1rem;
+  margin-bottom: 2rem;
+}
+
+.new-test-card .card-header {
+  background-color: var(--primary-color);
+  color: white;
+}
+
+.table thead th {
+  font-weight: 600;
+  color: var(--dark-gray);
+  text-transform: uppercase;
+  font-size: 0.8rem;
+  letter-spacing: 0.5px;
+  border-bottom-width: 2px;
+}
+
+.table tbody tr:hover {
+  background-color: #f1f3f5;
+}
+
+.table .badge {
+  padding: 0.5em 0.8em;
+  font-weight: 600;
+  font-size: 0.85rem;
+}
+
+/* 5. Admin Dashboard */
+.card.border-left-primary {
+  border-left: 0.25rem solid var(--primary-color) !important;
+}
+.card.border-left-success {
+  border-left: 0.25rem solid #1cc88a !important;
+}
+
+.chart-pie {
+  position: relative;
+  height: 15rem;
+  width: 100%;
+}
+
+.text-xs {
+  font-size: 0.7rem;
+}
+
+/* Chart Legend Color Helpers */
+.color-1 {
+  color: #4e73df !important;
+}
+.color-2 {
+  color: #1cc88a !important;
+}
+.color-3 {
+  color: #f6c23e !important;
+}
+.color-4 {
+  color: #e74a3b !important;
+}
+.color-5 {
+  color: #5a5c69 !important;
+}
+.color-6 {
+  color: #36b9cc !important;
+}
+/* =========================================== */
+/* == 5. Admin Panel Specific Styles        == */
+/* =========================================== */
+
+/* --- Admin Dashboard Cards --- */
+
+/* Base style for the stat cards */
+.stat-card {
+  border: none;
+  border-radius: 0.5rem;
+  box-shadow: 0 0.25rem 0.75rem rgba(0, 0, 0, 0.07);
+  transition: transform 0.2s ease-in-out;
+}
+
+.stat-card:hover {
+  transform: translateY(-5px); /* Lift effect on hover */
+}
+
+.stat-card .card-body {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+
+/* Specific border colors for different cards */
+.border-left-primary {
+  border-left: 0.25rem solid var(--primary-color) !important;
+}
+
+.border-left-success {
+  border-left: 0.25rem solid #1cc88a !important;
+}
+
+/* Text styling inside the cards */
+.stat-card .text-xs {
+  font-size: 0.8rem;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+}
+
+.stat-card .h5 {
+  font-weight: 700;
+  color: var(--dark-gray);
+}
+
+/* The large icon on the right side of the card */
+.stat-card .card-icon {
+  font-size: 2.5rem;
+  color: #dddfeb; /* A very light gray */
+}
+
+/* --- Admin Chart Card --- */
+.chart-card .card-header {
+  background-color: #f8f9fa; /* Lighter header for the chart card */
+  border-bottom: 1px solid #e3e6f0;
+}
+
+.chart-pie {
+  position: relative;
+  height: 15rem; /* Or adjust as needed */
+  width: 100%;
+}
+
+/* --- Manage Users Table --- */
+.users-table thead th {
+  background-color: #f8f9fa;
+}
+
+.users-table .badge {
+  font-size: 0.8rem;
+  padding: 0.4em 0.7em;
+}

app/static/js/admin-charts.js

@@ -0,0 +1,57 @@
+document.addEventListener("DOMContentLoaded", function () {
+  // Check if the chart canvas and the global data variables (created in dashboard.html) exist
+  if (
+    document.getElementById("myPieChart") &&
+    typeof chartLabels !== "undefined" &&
+    typeof chartData !== "undefined"
+  ) {
+    const ctx = document.getElementById("myPieChart")
+
+    new Chart(ctx, {
+      type: "doughnut",
+      data: {
+        labels: chartLabels, // Use the global variable
+        datasets: [
+          {
+            data: chartData, // Use the global variable
+            backgroundColor: [
+              "#4e73df",
+              "#1cc88a",
+              "#f6c23e",
+              "#e74a3b",
+              "#5a5c69",
+              "#36b9cc",
+            ],
+            hoverBackgroundColor: [
+              "#2e59d9",
+              "#17a673",
+              "#dda20a",
+              " #c73021",
+              "#404148",
+              "#2c9faf",
+            ],
+            hoverBorderColor: "rgba(234, 236, 244, 1)",
+          },
+        ],
+      },
+      options: {
+        maintainAspectRatio: false,
+        plugins: {
+          legend: {
+            display: false, // We use our own custom legend in the HTML
+          },
+          tooltip: {
+            backgroundColor: "rgb(255,255,255)",
+            bodyColor: "#858796",
+            borderColor: "#dddfeb",
+            borderWidth: 1,
+            padding: 15,
+            displayColors: false,
+            caretPadding: 10,
+          },
+        },
+        cutout: "80%", // For Chart.js v3+
+      },
+    })
+  }
+})

app/static/js/new_test.js

@@ -0,0 +1,28 @@
+document.addEventListener("DOMContentLoaded", () => {
+  const sliderWrapper = document.querySelector(".symptom-slider-wrapper")
+  if (!sliderWrapper) return // Only run if the slider exists on the page
+
+  const slides = document.querySelectorAll(".symptom-slide")
+  let currentSlide = 0
+
+  // Use event delegation for the 'Next' buttons
+  sliderWrapper.addEventListener("click", (e) => {
+    // Check if a 'next-btn' was clicked
+    if (e.target && e.target.classList.contains("next-btn")) {
+      const currentSlideElement = slides[currentSlide]
+      const radios = currentSlideElement.querySelectorAll('input[type="radio"]')
+
+      // Validate that an option was selected before proceeding
+      if (radios.length > 0 && !Array.from(radios).some((r) => r.checked)) {
+        alert("Please select an option to continue.")
+        return // Stop if nothing is selected
+      }
+
+      // Move to the next slide
+      currentSlide++
+      if (currentSlide < slides.length) {
+        sliderWrapper.style.transform = `translateX(-${currentSlide * 25}%)`
+      }
+    }
+  })
+})

app/static/js/recorder.js

@@ -0,0 +1,147 @@
+document.addEventListener("DOMContentLoaded", () => {
+  // Find the form on the current page. It could be on dashboard.html or audio_test.html
+  const form =
+    document.getElementById("audio-form") ||
+    document.getElementById("report-form")
+  if (!form) return // Exit if no form is found
+
+  const submitButton = document.getElementById("submitButton")
+  const audioUpload = document.getElementById("audioUpload")
+  const recordButton = document.getElementById("recordButton")
+  const stopButton = document.getElementById("stopButton")
+  const audioPlayback = document.getElementById("audioPlayback")
+  const recordingStatus = document.getElementById("recording-status")
+  const submitStatus = document.getElementById("submit-status")
+
+  let mediaRecorder
+  let audioChunks = []
+  let recordedBlob = null
+
+  function checkCanSubmit() {
+    const hasRecordedAudio = recordedBlob !== null
+    const hasUploadedAudio = audioUpload && audioUpload.files.length > 0
+
+    if (submitButton) {
+      submitButton.disabled = !(hasRecordedAudio || hasUploadedAudio)
+    }
+    if (submitStatus) {
+      submitStatus.textContent =
+        hasRecordedAudio || hasUploadedAudio
+          ? ""
+          : "Please record or upload an audio file to submit."
+    }
+  }
+
+  if (recordButton) {
+    recordButton.addEventListener("click", async (event) => {
+      event.preventDefault()
+      if (audioUpload) {
+        audioUpload.value = ""
+        audioUpload.disabled = true
+      }
+      recordedBlob = null
+      audioPlayback.classList.add("d-none")
+      try {
+        const constraints = {
+          audio: {
+            autoGainControl: false,
+            echoCancellation: false,
+            noiseSuppression: false,
+          },
+        }
+        const stream = await navigator.mediaDevices.getUserMedia(constraints)
+        mediaRecorder = new MediaRecorder(stream)
+        audioChunks = []
+        mediaRecorder.ondataavailable = (e) => audioChunks.push(e.data)
+        mediaRecorder.onstop = () => {
+          recordedBlob = new Blob(audioChunks, { type: "audio/webm" })
+          audioPlayback.src = URL.createObjectURL(recordedBlob)
+          audioPlayback.classList.remove("d-none")
+          recordingStatus.textContent =
+            "Recording finished. Ready for submission."
+          checkCanSubmit()
+        }
+        mediaRecorder.start()
+        recordButton.disabled = true
+        stopButton.disabled = false
+        recordingStatus.textContent = "Recording..."
+      } catch (err) {
+        recordingStatus.textContent = "Error: Could not access microphone."
+        if (audioUpload) audioUpload.disabled = false
+      }
+    })
+  }
+
+  if (stopButton) {
+    stopButton.addEventListener("click", (event) => {
+      event.preventDefault()
+      if (mediaRecorder?.state === "recording") mediaRecorder.stop()
+      recordButton.disabled = false
+      stopButton.disabled = true
+    })
+  }
+
+  if (audioUpload) {
+    audioUpload.addEventListener("change", () => {
+      if (audioUpload.files.length > 0) {
+        if (recordButton) recordButton.disabled = true
+        if (stopButton) stopButton.disabled = true
+        recordedBlob = null
+        if (audioPlayback) audioPlayback.classList.add("d-none")
+        if (recordingStatus)
+          recordingStatus.textContent = "File selected. Ready to submit."
+      } else {
+        if (recordButton) recordButton.disabled = false
+      }
+      checkCanSubmit()
+    })
+  }
+
+  form.addEventListener("submit", (event) => {
+    event.preventDefault() // ALWAYS prevent the default submission
+
+    submitButton.disabled = true
+    submitButton.textContent = "Submitting..."
+
+    // Manually build FormData to guarantee correctness
+    const formData = new FormData(form)
+
+    // This check is crucial. We must ensure only ONE audio source is in the FormData.
+    if (recordedBlob) {
+      // If a recording exists, it takes precedence.
+      formData.delete("uploaded_audio_data") // Remove any selected file
+      formData.append("recorded_audio_data", recordedBlob, "recording.webm")
+    } else if (audioUpload && audioUpload.files.length > 0) {
+      // The uploaded file is already in formData from the constructor, so we do nothing.
+    } else {
+      // This case should be prevented by the disabled submit button, but as a fallback:
+      flash("No audio file was provided.", "danger") // This is a client-side alert
+      submitButton.disabled = false
+      submitButton.textContent = "Analyze & Complete Test"
+      return
+    }
+
+    fetch(form.action, {
+      method: "POST",
+      body: formData,
+    })
+      .then((response) => {
+        if (response.redirected) {
+          window.location.href = response.url
+        } else {
+          // If not redirected, the server might have sent an error.
+          // Reloading is the simplest way to see the flash message.
+          window.location.reload()
+        }
+      })
+      .catch((error) => {
+        console.error("Submission Error:", error)
+        submitButton.disabled = false
+        submitButton.textContent = "Analyze & Complete Test"
+        if (submitStatus) submitStatus.textContent = "A network error occurred."
+      })
+  })
+
+  // Initial check when the page loads
+  checkCanSubmit()
+})

app/templates/_flash_messages.html

@@ -0,0 +1,19 @@
+{% with messages = get_flashed_messages(with_categories=true) %} {% if messages
+%}
+<div class="container-fluid px-0 mb-4">
+  {% for category, message in messages %}
+  <div
+    class="alert alert-{{ category }} alert-dismissible fade show"
+    role="alert"
+  >
+    {{ message }}
+    <button
+      type="button"
+      class="btn-close"
+      data-bs-dismiss="alert"
+      aria-label="Close"
+    ></button>
+  </div>
+  {% endfor %}
+</div>
+{% endif %} {% endwith %}

app/templates/_formhelpers.html

@@ -0,0 +1,24 @@
+{% macro render_input_field(field) %}
+<div class="mb-3">
+  {{ field.label(class="form-label") }} {# This renders the basic field with
+  validation styling #} {{ field(class="form-control" + (" is-invalid" if
+  field.errors else "")) }} {% if field.errors %}
+  <div class="invalid-feedback">
+    {% for error in field.errors %}
+    <span>{{ error }}</span>
+    {% endfor %}
+  </div>
+  {% endif %}
+</div>
+{% endmacro %} {% macro render_textarea_field(field, rows=3) %}
+<div class="mb-3">
+  {{ field.label(class="form-label") }} {{ field(class="form-control" + ("
+  is-invalid" if field.errors else ""), rows=rows) }} {% if field.errors %}
+  <div class="invalid-feedback">
+    {% for error in field.errors %}
+    <span>{{ error }}</span>
+    {% endfor %}
+  </div>
+  {% endif %}
+</div>
+{% endmacro %}

app/templates/admin/dashboard.html

@@ -0,0 +1,84 @@
+{% extends "base.html" %} {% block content %}
+<div class="container py-4">
+  <h1 class="h2 mb-4">Admin Dashboard</h1>
+
+  <!-- Stat Cards Row -->
+  <div class="row">
+    <div class="col-xl-4 col-md-6 mb-4">
+      <div class="card stat-card border-left-primary">
+        <div class="card-body">
+          <div>
+            <div class="text-xs text-primary text-uppercase">
+              Total Registered Users
+            </div>
+            <div class="h5 mb-0">{{ user_count }}</div>
+          </div>
+          <div class="card-icon"><i class="fas fa-users"></i></div>
+        </div>
+      </div>
+    </div>
+    <div class="col-xl-4 col-md-6 mb-4">
+      <div class="card stat-card border-left-success">
+        <div class="card-body">
+          <div>
+            <div class="text-xs text-success text-uppercase">
+              Total Tests Submitted
+            </div>
+            <div class="h5 mb-0">{{ report_count }}</div>
+          </div>
+          <div class="card-icon"><i class="fas fa-clipboard-list"></i></div>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <!-- Chart Row -->
+  <div class="row">
+    <div class="col-lg-8">
+      <div class="card shadow-sm chart-card mb-4">
+        <div class="card-header py-3">
+          <h6 class="m-0 fw-bold text-primary">Test Results Breakdown</h6>
+        </div>
+        <div class="card-body">
+          {% if chart_data %}
+          <div class="chart-pie pt-4"><canvas id="myPieChart"></canvas></div>
+          <div class="mt-4 text-center small">
+            {% for label in chart_labels %}
+            <span class="me-3">
+              <i class="fas fa-circle color-{{ loop.index }}"></i> {{ label }}
+            </span>
+            {% endfor %}
+          </div>
+          {% else %}
+          <p class="text-center text-muted p-5">
+            No test data available to generate a chart.
+          </p>
+          {% endif %}
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <a
+    href="{{ url_for('main.admin_users') }}"
+    class="btn btn-info"
+    >Manage Users</a
+  >
+</div>
+{% endblock %} {% block scripts %} {# Only include scripts if there is data to
+draw #} {% if chart_data %}
+<!-- 1. Load the Chart.js library FIRST -->
+<script src="https://cdn.jsdelivr.net/npm/chart.js@3.9.1/dist/chart.min.js"></script>
+
+<!-- 2. Create global JS variables with our data from Python. This avoids parsing errors. -->
+<script>
+  var chartLabels = {{ chart_labels|tojson|safe }};
+  var chartData = {{ chart_data|tojson|safe }};
+</script>
+
+<!-- 3. Load OUR script LAST, with 'defer' to ensure it runs after the page is ready -->
+<script
+  src="{{ url_for('static', filename='js/admin-charts.js') }}"
+  defer
+></script>
+{% endif %} {% endblock %}

app/templates/admin/users.html

@@ -0,0 +1,39 @@
+{% extends "base.html" %} {% block content %}
+<div class="container py-4">
+  <h1 class="h2 mb-4">Manage Users</h1>
+  <p class="text-muted">
+    Admin users cannot view individual user reports to maintain privacy.
+  </p>
+
+  <div class="card shadow-sm">
+    <div class="card-body p-0">
+      <table class="table table-hover mb-0 users-table">
+        <thead>
+          <tr>
+            <th>ID</th>
+            <th>Username</th>
+            <th>Email</th>
+            <th>Admin Status</th>
+          </tr>
+        </thead>
+        <tbody>
+          {% for user in users %}
+          <tr>
+            <td>{{ user.id }}</td>
+            <td>{{ user.username }}</td>
+            <td>{{ user.email }}</td>
+            <td>
+              {% if user.is_admin %}
+              <span class="badge bg-danger">Admin</span>
+              {% else %}
+              <span class="badge bg-secondary">User</span>
+              {% endif %}
+            </td>
+          </tr>
+          {% endfor %}
+        </tbody>
+      </table>
+    </div>
+  </div>
+</div>
+{% endblock %}

app/templates/audio_test.html

@@ -0,0 +1,126 @@
+{% extends "base.html" %} {% block title %}New Test - Step 2{% endblock %} {%
+block content %}
+<div class="container py-4">
+  {# This include is optional but good for displaying any potential errors from
+  the server #} {% include '_flash_messages.html' %}
+
+  <div class="d-flex justify-content-between align-items-center mb-4">
+    <div>
+      <h1 class="h2">New Test - Step 2: Voice Sample</h1>
+      <p class="text-muted mb-0">
+        For the final step, please provide a voice sample for analysis.
+      </p>
+    </div>
+    <a
+      href="{{ url_for('main.dashboard') }}"
+      class="btn btn-sm btn-outline-secondary"
+      >Cancel Test</a
+    >
+  </div>
+
+  <div class="card shadow-sm">
+    <div class="card-body p-4">
+      <form
+        id="audio-form"
+        action="{{ url_for('main.audio_test') }}"
+        method="post"
+        enctype="multipart/form-data"
+      >
+        <!-- 
+                    These hidden fields are crucial. They take the data passed in the URL 
+                    (from the previous step) and include it in this form's submission,
+                    so the final backend route receives ALL the data at once.
+                -->
+        {% for key, value in symptom_data.items() %}
+        <input
+          type="hidden"
+          name="{{ key }}"
+          value="{{ value }}"
+        />
+        {% endfor %}
+
+        <div class="row">
+          <div class="col-md-6 mb-4 mb-md-0">
+            <h5 class="fw-bold">
+              <i class="fas fa-microphone me-2"></i>Option 1: Record Voice
+            </h5>
+            <p class="small text-muted">
+              Click "Start Recording" and sustain a vowel sound (like 'ahhh')
+              for 5-10 seconds.
+            </p>
+            <div
+              id="recorder-ui"
+              class="mb-3"
+            >
+              <button
+                id="recordButton"
+                class="btn btn-danger w-100"
+              >
+                Start Recording
+              </button>
+              <button
+                id="stopButton"
+                class="btn btn-secondary w-100 mt-2"
+                disabled
+              >
+                Stop Recording
+              </button>
+            </div>
+            <div
+              id="recording-status"
+              class="form-text mt-2 text-center small"
+            ></div>
+            <audio
+              id="audioPlayback"
+              controls
+              class="mt-2 d-none w-100"
+            ></audio>
+          </div>
+          <div class="col-md-6">
+            <h5 class="fw-bold">
+              <i class="fas fa-upload me-2"></i>Option 2: Upload File
+            </h5>
+            <p class="small text-muted">
+              Select a .wav or .mp3 file from your device.
+            </p>
+            <input
+              class="form-control"
+              type="file"
+              id="audioUpload"
+              name="uploaded_audio_data"
+              accept="audio/*"
+            />
+          </div>
+        </div>
+
+        <hr class="my-4" />
+
+        <div class="d-grid">
+          <button
+            id="submitButton"
+            type="submit"
+            class="btn btn-primary btn-lg"
+            disabled
+          >
+            Analyze & Complete Test
+          </button>
+          <div
+            id="submit-status"
+            class="form-text text-danger text-center mt-2"
+          ></div>
+        </div>
+      </form>
+    </div>
+  </div>
+</div>
+{% endblock %} {% block scripts %}
+<!-- 
+        We link to the STABLE recorder.js from our checkpoint.
+        It is already designed to find the form and elements by their IDs ('audio-form', 'recordButton', etc.)
+        so it will work perfectly on this new page without any changes.
+    -->
+<script
+  src="{{ url_for('static', filename='js/recorder.js') }}"
+  defer
+></script>
+{% endblock %}

app/templates/auth/login.html

@@ -0,0 +1,48 @@
+{% extends "base.html" %} {# We no longer import the macro, we will just use the
+fields directly #} {% block title %}Sign In{% endblock %} {% block content %}
+<div class="auth-wrapper">
+  <div class="auth-card">
+    {% include '_flash_messages.html' %}
+    <div class="text-center mb-4">
+      <i class="fas fa-sign-in-alt fa-3x text-primary"></i>
+      <h1 class="h3 fw-bold mt-3">Sign In</h1>
+      <p class="text-muted">Welcome back! Please enter your credentials.</p>
+    </div>
+
+    <form
+      action=""
+      method="post"
+      novalidate
+      class="w-100"
+    >
+      {{ form.hidden_tag() }}
+
+      <div class="mb-3">
+        {{ form.username.label(class="form-label") }} {{
+        form.username(class="form-control", placeholder="Your Username") }}
+      </div>
+
+      <div class="mb-3">
+        {{ form.password.label(class="form-label") }} {{
+        form.password(class="form-control", placeholder="Your Password") }}
+      </div>
+
+      <div class="d-flex justify-content-between align-items-center mb-4">
+        <div class="form-check">
+          {{ form.remember_me(class="form-check-input") }} {{
+          form.remember_me.label(class="form-check-label small") }}
+        </div>
+      </div>
+
+      <div class="d-grid">
+        {{ form.submit(class="btn btn-primary btn-lg") }}
+      </div>
+    </form>
+
+    <p class="text-center small mt-4 mb-0">
+      Don't have an account?
+      <a href="{{ url_for('auth.register') }}">Register here</a>
+    </p>
+  </div>
+</div>
+{% endblock %}

app/templates/auth/register.html

@@ -0,0 +1,54 @@
+{% extends "base.html" %} {% block title %}Create Account{% endblock %} {% block
+content %}
+<div class="auth-wrapper">
+  <div class="auth-card">
+    <div class="text-center mb-4">
+      <i class="fas fa-user-plus fa-3x text-primary"></i>
+      <h1 class="h3 fw-bold mt-3">Create an Account</h1>
+      <p class="text-muted">It's free and only takes a minute.</p>
+    </div>
+
+    <form
+      action=""
+      method="post"
+      novalidate
+      class="w-100"
+    >
+      {{ form.hidden_tag() }}
+
+      <div class="mb-3">
+        {{ form.username.label(class="form-label") }} {{
+        form.username(class="form-control", placeholder="Choose a unique
+        username") }}
+      </div>
+
+      <div class="mb-3">
+        {{ form.email.label(class="form-label") }} {{
+        form.email(class="form-control", placeholder="your.email@example.com")
+        }}
+      </div>
+
+      <div class="mb-3">
+        {{ form.password.label(class="form-label") }} {{
+        form.password(class="form-control", placeholder="Create a secure
+        password") }}
+      </div>
+
+      <div class="mb-4">
+        {{ form.password2.label(class="form-label") }} {{
+        form.password2(class="form-control", placeholder="Confirm your
+        password") }}
+      </div>
+
+      <div class="d-grid">
+        {{ form.submit(class="btn btn-primary btn-lg", value="Create Account")
+        }}
+      </div>
+    </form>
+
+    <p class="text-center small mt-4 mb-0">
+      Already have an account? <a href="{{ url_for('auth.login') }}">Sign In</a>
+    </p>
+  </div>
+</div>
+{% endblock %}

app/templates/base.html

@@ -0,0 +1,131 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1.0"
+    />
+    <title>{{ title }} - Parkinson's Detector</title>
+
+    <!-- Third-Party CSS Libraries -->
+    <link
+      href="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/css/bootstrap.min.css"
+      rel="stylesheet"
+      integrity="sha384-1BmE4kWBq78iYhFldvKuhfTAU6auU8tT94WrHftjDbrCEXSU1oBoqyl2QvZ6jIW3"
+      crossorigin="anonymous"
+    />
+    <link
+      rel="stylesheet"
+      href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/5.15.4/css/all.min.css"
+      integrity="sha512-1ycn6IcaQQ40/MKBW2W4Rhis/DbILU74C1vSrLJxCq57o941Ym01SwNsOMqvEBFlcgUa6xLiPY/NS5R+E6ztJQ=="
+      crossorigin="anonymous"
+      referrerpolicy="no-referrer"
+    />
+
+    <!-- Our Custom Stylesheet (must be loaded last to override libraries) -->
+    <link
+      rel="stylesheet"
+      href="{{ url_for('static', filename='css/style.css') }}"
+    />
+  </head>
+  <body>
+    <!-- ============================================= -->
+    <!-- == Main Navigation Bar                     == -->
+    <!-- ============================================= -->
+    <nav
+      class="navbar navbar-expand-lg navbar-light bg-white fixed-top shadow-sm"
+    >
+      <div class="container">
+        <a
+          class="navbar-brand fw-bold text-primary"
+          href="{{ url_for('main.index') }}"
+        >
+          <i class="fas fa-brain me-2"></i>Parkinson's Detector
+        </a>
+        <button
+          class="navbar-toggler"
+          type="button"
+          data-bs-toggle="collapse"
+          data-bs-target="#mainNavbar"
+          aria-controls="mainNavbar"
+          aria-expanded="false"
+          aria-label="Toggle navigation"
+        >
+          <span class="navbar-toggler-icon"></span>
+        </button>
+        <div
+          class="collapse navbar-collapse"
+          id="mainNavbar"
+        >
+          <ul class="navbar-nav ms-auto mb-2 mb-lg-0">
+            <!-- Links for Anonymous (Not Logged-in) Users -->
+            {% if current_user.is_anonymous %}
+            <li class="nav-item">
+              <a
+                class="nav-link"
+                href="{{ url_for('auth.login') }}"
+                >Login</a
+              >
+            </li>
+            <li class="nav-item">
+              <a
+                class="nav-link btn btn-primary text-white btn-sm ms-2 px-3"
+                href="{{ url_for('auth.register') }}"
+                >Register</a
+              >
+            </li>
+
+            <!-- Links for Logged-in Users -->
+            {% else %}
+            <li class="nav-item">
+              <a
+                class="nav-link"
+                href="{{ url_for('main.dashboard') }}"
+                >Dashboard</a
+              >
+            </li>
+
+            <!-- Admin-only Link -->
+            {% if current_user.is_admin %}
+            <li class="nav-item">
+              <a
+                class="nav-link"
+                href="{{ url_for('main.admin_dashboard') }}"
+                >Admin</a
+              >
+            </li>
+            {% endif %}
+
+            <li class="nav-item">
+              <a
+                class="nav-link"
+                href="{{ url_for('auth.logout') }}"
+                >Logout</a
+              >
+            </li>
+            {% endif %}
+          </ul>
+        </div>
+      </div>
+    </nav>
+
+    <!-- ============================================= -->
+    <!-- == Main Content Area                       == -->
+    <!-- ============================================= -->
+    <main>
+      {# This is the main block that all other templates will extend and fill.
+      #} {% block content %}{% endblock %}
+    </main>
+
+    <!-- JavaScript Libraries -->
+    <script
+      src="https://cdn.jsdelivr.net/npm/bootstrap@5.1.3/dist/js/bootstrap.bundle.min.js"
+      integrity="sha384-ka7Sk0Gln4gmtz2MlQnikT1wXgYsOg+OMhuP+IlRH9sENBO0LRn5q+8nbTov4+1p"
+      crossorigin="anonymous"
+    ></script>
+
+    {# A block for page-specific JavaScript files #} {% block scripts %}{%
+    endblock %}
+  </body>
+</html>

app/templates/dashboard.html

@@ -0,0 +1,99 @@
+{% extends "base.html" %} {% block title %}Your Dashboard{% endblock %} {% block
+content %}
+<div class="container py-4">
+  {# This includes the reusable snippet to show flash messages like "Login
+  successful" #} {% include '_flash_messages.html' %}
+
+  <!-- Page Header -->
+  <div class="dashboard-header">
+    <h1 class="h2">Welcome, {{ current_user.username }}!</h1>
+    <p class="text-muted">
+      Here you can start a new voice analysis or review your test history.
+    </p>
+  </div>
+
+  <!-- Primary Call-to-Action (CTA) Card -->
+  <div class="card text-center border-0 shadow-sm mb-5 bg-light">
+    <div class="card-body p-5">
+      <h3 class="card-title h4">Ready for a New Analysis?</h3>
+      <p class="card-text text-secondary">
+        Begin the two-step process to get your preliminary voice analysis.
+      </p>
+
+      {# This button now points to our new '/new_test' route #}
+      <a
+        href="{{ url_for('main.new_test') }}"
+        class="btn btn-primary btn-lg mt-3"
+      >
+        <i class="fas fa-vial me-2"></i>Start New Test
+      </a>
+    </div>
+  </div>
+
+  <!-- Past Reports Section -->
+  <h3 class="h4 mb-3">Your Test History</h3>
+  <div class="card shadow-sm">
+    <div class="card-body p-0">
+      {# p-0 to make the table flush with the card edges #} {% if reports %}
+      <div class="table-responsive">
+        <table class="table table-hover align-middle mb-0">
+          <thead>
+            <tr>
+              <th
+                scope="col"
+                class="ps-4"
+              >
+                Date
+              </th>
+              <th scope="col">Age</th>
+              <th scope="col">Gender</th>
+              <th scope="col">Result</th>
+              <th
+                scope="col"
+                class="pe-4"
+              >
+                Note
+              </th>
+            </tr>
+          </thead>
+          <tbody>
+            {% for report in reports %}
+            <tr>
+              <td class="ps-4">
+                <div class="fw-bold">
+                  {{ report.timestamp.strftime('%B %d, %Y') }}
+                </div>
+                <div class="small text-muted">
+                  {{ report.timestamp.strftime('%I:%M %p') }} UTC
+                </div>
+              </td>
+              <td>{{ report.age }}</td>
+              <td>{{ report.gender }}</td>
+              <td>
+                <span
+                  class="badge fs-6 rounded-pill {% if 'Positive' in report.final_result %} bg-warning text-dark{% elif 'Negative' in report.final_result %}bg-success{% else %}bg-secondary{% endif %}"
+                >
+                  {{ report.final_result }}
+                </span>
+              </td>
+              <td class="text-muted small pe-4">
+                {% if 'Override' in report.final_result %} Initial Prediction
+                was 'Positive' Prediction overridden by age criteria. {% else %}
+                - {% endif %}
+              </td>
+            </tr>
+            {% endfor %}
+          </tbody>
+        </table>
+      </div>
+      {% else %}
+      <div class="text-center p-5">
+        <p class="text-muted">
+          You have no past reports. Click "Start New Test" to begin.
+        </p>
+      </div>
+      {% endif %}
+    </div>
+  </div>
+</div>
+{% endblock %}

app/templates/email/result_notification.html

@@ -0,0 +1,34 @@
+<p>Dear {{ user.username }},</p>
+<p>
+  Thank you for using the Parkinson's Detection System. Here is a summary of
+  your test taken on {{ report.timestamp.strftime('%Y-%m-%d %H:%M') }} UTC.
+</p>
+<hr />
+
+<h3 style="color: #333">Vocal Analysis Result</h3>
+<ul>
+  <li><b>Final Assessment:</b> <strong>{{ report.final_result }}</strong></li>
+  {% if 'Override' in report.final_result %}
+  <li>
+    <b>Note:</b> The model's prediction was positive but was overridden by the
+    age criteria provided (Age: {{report.age}}).
+  </li>
+  {% endif %}
+</ul>
+
+{# --- NEW SECTION TO DISPLAY SYMPTOMS --- #} {% if symptoms %}
+<h3 style="color: #333">Symptoms You Provided</h3>
+<ul>
+  {% for key, value in symptoms.items() %}
+  <li><b>{{ key }}:</b> {{ value }}</li>
+  {% endfor %}
+</ul>
+{% endif %}
+
+<hr />
+<p style="font-size: small; color: #777">
+  <b>Disclaimer:</b> This result is based on a machine learning model and is for
+  informational purposes only. It is not a medical diagnosis. Please consult a
+  qualified healthcare professional for accurate medical advice.
+</p>
+<p>Sincerely,<br />The Parkinson's Detector Team</p>

app/templates/email/result_notification.txt

@@ -0,0 +1,25 @@
+Dear {{ user.username }},
+
+Thank you for using the Parkinson's Disease Voice Detection System. Here is a summary of your test taken on {{ report.timestamp.strftime('%Y-%m-%d %H:%M') }} UTC.
+
+---------------------------------
+VOCAL ANALYSIS RESULT
+---------------------------------
+- Final Assessment: {{ report.final_result }}
+{% if 'Override' in report.final_result %}- Note: The model's prediction was positive but was overridden by the age criteria provided (Age: {{report.age}}).
+{% endif %}
+
+{# --- NEW SECTION TO DISPLAY SYMPTOMS --- #}
+{% if symptoms %}
+---------------------------------
+SYMPTOMS YOU PROVIDED
+---------------------------------
+{% for key, value in symptoms.items() %}- {{ key }}: {{ value }}
+{% endfor %}
+{% endif %}
+---------------------------------
+
+Disclaimer: This result is based on a machine learning model and is for informational purposes only. It is not a medical diagnosis. Please consult a qualified healthcare professional for accurate medical advice.
+
+Sincerely,
+The Parkinson's Detector Team

app/templates/index.html

@@ -0,0 +1,55 @@
+{% extends "base.html" %} {% block title %}Welcome{% endblock %} {% block
+content %}
+<div
+  class="container text-center"
+  style="padding-top: 5rem; padding-bottom: 5rem"
+>
+  <!-- Main Heading and Subtitle -->
+  <h1 class="display-4 fw-bold">Vocal Analysis for Parkinson's</h1>
+  <p class="lead text-muted col-lg-8 mx-auto mt-3">
+    Our platform utilizes advanced machine learning to provide a non-invasive,
+    preliminary analysis based on voice characteristics. Get an informational
+    result in just a few minutes.
+  </p>
+
+  <!-- Call to Action Button -->
+  <div class="my-5">
+    {% if current_user.is_anonymous %} {# If user is not logged in, button goes
+    to the login page #}
+    <a
+      href="{{ url_for('auth.login') }}"
+      class="btn btn-primary btn-lg px-5 py-3 fs-5 shadow"
+      >Get Started</a
+    >
+    {% else %} {# If user is logged in, button goes directly to their dashboard
+    #}
+    <a
+      href="{{ url_for('main.dashboard') }}"
+      class="btn btn-primary btn-lg px-5 py-3 fs-5 shadow"
+      >Go to Your Dashboard</a
+    >
+    {% endif %}
+  </div>
+
+  <!-- Medical Disclaimer Box -->
+  <div class="row justify-content-center mt-5">
+    <div class="col-lg-10">
+      <div
+        class="alert alert-warning d-flex align-items-center shadow-sm"
+        role="alert"
+      >
+        <div class="flex-shrink-0 me-3">
+          <i class="fas fa-exclamation-triangle fa-2x"></i>
+        </div>
+        <div class="text-start">
+          <h4 class="alert-heading h6">Medical Disclaimer</h4>
+          This tool is for informational and research purposes only and is not a
+          substitute for professional medical diagnosis or advice. The outcomes
+          are not fully reliable. Always consult with a qualified healthcare
+          provider for any health concerns.
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+{% endblock %}

app/templates/new_test.html

@@ -0,0 +1,239 @@
+{% extends "base.html" %} {% block content %}
+<link
+  rel="stylesheet"
+  href="{{ url_for('static', filename='css/new_test.css') }}"
+/>
+
+<div class="new-test-container">
+  <div
+    class="d-flex justify-content-between align-items-center pt-3 pb-2 mb-4 border-bottom"
+  >
+    <h1 class="h2">New Test - Step 1: Symptoms</h1>
+    <a
+      href="{{ url_for('main.dashboard') }}"
+      class="btn btn-sm btn-outline-secondary"
+      >Cancel</a
+    >
+  </div>
+  {% include '_flash_messages.html' %}
+
+  <form
+    action="{{ url_for('main.new_test') }}"
+    method="post"
+  >
+    <div class="card shadow-sm">
+      <div class="card-body p-0">
+        <div class="symptom-slider-container">
+          <div class="symptom-slider-wrapper">
+            <!-- Slide 1: Tremors -->
+            <div class="symptom-slide">
+              <h3>Do you experience tremors?</h3>
+              <div class="form-check">
+                <input
+                  type="radio"
+                  name="tremor"
+                  value="at_rest"
+                  id="tremor_rest"
+                  class="form-check-input"
+                  required
+                />
+                <label
+                  for="tremor_rest"
+                  class="form-check-label"
+                  >Yes, when my hands are resting.</label
+                >
+              </div>
+              <div class="form-check">
+                <input
+                  type="radio"
+                  name="tremor"
+                  value="action"
+                  id="tremor_action"
+                  class="form-check-input"
+                />
+                <label
+                  for="tremor_action"
+                  class="form-check-label"
+                  >Yes, when I am performing an action.</label
+                >
+              </div>
+              <div class="form-check">
+                <input
+                  type="radio"
+                  name="tremor"
+                  value="no"
+                  id="tremor_no"
+                  class="form-check-input"
+                />
+                <label
+                  for="tremor_no"
+                  class="form-check-label"
+                  >No, I do not experience tremors.</label
+                >
+              </div>
+              <button
+                type="button"
+                class="btn btn-primary next-btn"
+              >
+                Next →
+              </button>
+            </div>
+
+            <!-- Slide 2: Stiffness -->
+            <div class="symptom-slide">
+              <h3>Do you experience stiffness or slowness?</h3>
+              <div class="form-check">
+                <input
+                  type="radio"
+                  name="stiffness"
+                  value="yes"
+                  id="stiffness_yes"
+                  class="form-check-input"
+                  required
+                />
+                <label
+                  for="stiffness_yes"
+                  class="form-check-label"
+                  >Yes, my limbs feel rigid or I move slower.</label
+                >
+              </div>
+              <div class="form-check">
+                <input
+                  type="radio"
+                  name="stiffness"
+                  value="no"
+                  id="stiffness_no"
+                  class="form-check-input"
+                />
+                <label
+                  for="stiffness_no"
+                  class="form-check-label"
+                  >No, I have not noticed this.</label
+                >
+              </div>
+              <button
+                type="button"
+                class="btn btn-primary next-btn"
+              >
+                Next →
+              </button>
+            </div>
+
+            <!-- Slide 3: Balance / Walking Issue (CORRECTED) -->
+            <div class="symptom-slide">
+              <h3>Do you have balance or walking issues?</h3>
+              <div class="form-check">
+                {# The name attribute is now correctly 'walking_issue' #}
+                <input
+                  type="radio"
+                  name="walking_issue"
+                  value="yes"
+                  id="balance_yes"
+                  class="form-check-input"
+                  required
+                />
+                <label
+                  for="balance_yes"
+                  class="form-check-label"
+                  >Yes, I feel unsteady or have shuffling steps.</label
+                >
+              </div>
+              <div class="form-check">
+                {# The name attribute is now correctly 'walking_issue' #}
+                <input
+                  type="radio"
+                  name="walking_issue"
+                  value="no"
+                  id="balance_no"
+                  class="form-check-input"
+                />
+                <label
+                  for="balance_no"
+                  class="form-check-label"
+                  >No, my balance and walking feel normal.</label
+                >
+              </div>
+              <button
+                type="button"
+                class="btn btn-primary next-btn"
+              >
+                Next →
+              </button>
+            </div>
+
+            <!-- Slide 4: Final Details & Submit -->
+            <div class="symptom-slide">
+              <h3>Final Details</h3>
+              <div class="mb-3">
+                <label
+                  for="age"
+                  class="form-label fw-bold"
+                  >Your Age:</label
+                >
+                <input
+                  type="number"
+                  name="age"
+                  id="age"
+                  class="form-control"
+                  required
+                />
+              </div>
+              <div class="mb-3">
+                <label
+                  for="gender"
+                  class="form-label fw-bold"
+                  >Your Gender:</label
+                >
+                <select
+                  name="gender"
+                  id="gender"
+                  class="form-select"
+                  required
+                >
+                  <option
+                    value=""
+                    disabled
+                    selected
+                  >
+                    Select...
+                  </option>
+                  <option value="Male">Male</option>
+                  <option value="Female">Female</option>
+                  <option value="Other">Other</option>
+                </select>
+              </div>
+              <div class="mb-3">
+                <label
+                  for="other_symptoms"
+                  class="form-label fw-bold"
+                  >Other symptoms or notes:</label
+                >
+                <textarea
+                  name="other_symptoms"
+                  id="other_symptoms"
+                  rows="2"
+                  class="form-control"
+                  placeholder="(e.g., changes in handwriting)"
+                ></textarea>
+              </div>
+              <div class="d-grid mt-4">
+                <button
+                  type="submit"
+                  class="btn btn-success btn-lg"
+                >
+                  Continue to Audio Test →
+                </button>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+  </form>
+</div>
+{% endblock %} {% block scripts %}
+<script
+  src="{{ url_for('static', filename='js/new_test.js') }}"
+  defer
+></script>
+{% endblock %}

config.py

@@ -0,0 +1,23 @@
+import os
+from dotenv import load_dotenv
+
+# Find the .env file in the root directory
+basedir = os.path.abspath(os.path.dirname(__file__))
+load_dotenv(os.path.join(basedir, '.env'))
+
+# Now we can simply read the variables from the environment
+class Config:
+    # Secret key for session management
+    SECRET_KEY = os.environ.get('SECRET_KEY')
+
+    # Database configuration
+    SQLALCHEMY_DATABASE_URI = os.environ.get('DATABASE_URL')
+    SQLALCHEMY_TRACK_MODIFICATIONS = False
+
+    # Email configuration
+    MAIL_SERVER = os.environ.get('MAIL_SERVER')
+    MAIL_PORT = int(os.environ.get('MAIL_PORT') or 587)
+    MAIL_USE_TLS = os.environ.get('MAIL_USE_TLS') == '1'
+    MAIL_USERNAME = os.environ.get('MAIL_USERNAME')
+    MAIL_PASSWORD = os.environ.get('MAIL_PASSWORD')
+    ADMINS = [os.environ.get('MAIL_USERNAME')]

migrations/README

@@ -0,0 +1 @@
+Single-database configuration for Flask.

migrations/alembic.ini

@@ -0,0 +1,50 @@
+# A generic, single database configuration.
+
+[alembic]
+# template used to generate migration files
+# file_template = %%(rev)s_%%(slug)s
+
+# set to 'true' to run the environment during
+# the 'revision' command, regardless of autogenerate
+# revision_environment = false
+
+
+# Logging configuration
+[loggers]
+keys = root,sqlalchemy,alembic,flask_migrate
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+qualname =
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[logger_flask_migrate]
+level = INFO
+handlers =
+qualname = flask_migrate
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s
+datefmt = %H:%M:%S

migrations/env.py

@@ -0,0 +1,113 @@
+import logging
+from logging.config import fileConfig
+
+from flask import current_app
+
+from alembic import context
+
+# this is the Alembic Config object, which provides
+# access to the values within the .ini file in use.
+config = context.config
+
+# Interpret the config file for Python logging.
+# This line sets up loggers basically.
+fileConfig(config.config_file_name)
+logger = logging.getLogger('alembic.env')
+
+
+def get_engine():
+    try:
+        # this works with Flask-SQLAlchemy<3 and Alchemical
+        return current_app.extensions['migrate'].db.get_engine()
+    except (TypeError, AttributeError):
+        # this works with Flask-SQLAlchemy>=3
+        return current_app.extensions['migrate'].db.engine
+
+
+def get_engine_url():
+    try:
+        return get_engine().url.render_as_string(hide_password=False).replace(
+            '%', '%%')
+    except AttributeError:
+        return str(get_engine().url).replace('%', '%%')
+
+
+# add your model's MetaData object here
+# for 'autogenerate' support
+# from myapp import mymodel
+# target_metadata = mymodel.Base.metadata
+config.set_main_option('sqlalchemy.url', get_engine_url())
+target_db = current_app.extensions['migrate'].db
+
+# other values from the config, defined by the needs of env.py,
+# can be acquired:
+# my_important_option = config.get_main_option("my_important_option")
+# ... etc.
+
+
+def get_metadata():
+    if hasattr(target_db, 'metadatas'):
+        return target_db.metadatas[None]
+    return target_db.metadata
+
+
+def run_migrations_offline():
+    """Run migrations in 'offline' mode.
+
+    This configures the context with just a URL
+    and not an Engine, though an Engine is acceptable
+    here as well.  By skipping the Engine creation
+    we don't even need a DBAPI to be available.
+
+    Calls to context.execute() here emit the given string to the
+    script output.
+
+    """
+    url = config.get_main_option("sqlalchemy.url")
+    context.configure(
+        url=url, target_metadata=get_metadata(), literal_binds=True
+    )
+
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def run_migrations_online():
+    """Run migrations in 'online' mode.
+
+    In this scenario we need to create an Engine
+    and associate a connection with the context.
+
+    """
+
+    # this callback is used to prevent an auto-migration from being generated
+    # when there are no changes to the schema
+    # reference: http://alembic.zzzcomputing.com/en/latest/cookbook.html
+    def process_revision_directives(context, revision, directives):
+        if getattr(config.cmd_opts, 'autogenerate', False):
+            script = directives[0]
+            if script.upgrade_ops.is_empty():
+                directives[:] = []
+                logger.info('No changes in schema detected.')
+
+    conf_args = current_app.extensions['migrate'].configure_args
+    if conf_args.get("process_revision_directives") is None:
+        conf_args["process_revision_directives"] = process_revision_directives
+
+    connectable = get_engine()
+
+    with connectable.connect() as connection:
+        context.configure(
+            connection=connection,
+            target_metadata=get_metadata(),
+            **conf_args
+        )
+
+        with context.begin_transaction():
+            context.run_migrations()
+
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

migrations/script.py.mako

@@ -0,0 +1,24 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision = ${repr(up_revision)}
+down_revision = ${repr(down_revision)}
+branch_labels = ${repr(branch_labels)}
+depends_on = ${repr(depends_on)}
+
+
+def upgrade():
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade():
+    ${downgrades if downgrades else "pass"}

parkinson_cnn_model_stft_grayscale.h5

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:453d9ece423afe6ff1bb7d4bcf257b546eea734748da7a01b1f07d0f6f82ed7f
+size 309903528

run.py

@@ -0,0 +1,14 @@
+from app import create_app, db
+from app.models import User, Report
+
+# The create_app function now handles loading the .env file via config.py
+app = create_app()
+
+@app.shell_context_processor
+def make_shell_context():
+    return {'db': db, 'User': User, 'Report': Report}
+
+if __name__ == '__main__':
+    import os
+    port = int(os.environ.get("PORT", 5000))  # Use Render's assigned port
+    app.run(host="0.0.0.0", port=port)

start.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+# Start Flask app with Gunicorn on port 7860
+gunicorn --bind 0.0.0.0:7860 wsgi:app

symptom_model.joblib

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c592bb212bc14c00375d32e8ae61035d319de3bff193ddc46e7bffcaaf14d11f
+size 1247

train_model.py

@@ -0,0 +1,174 @@
+import os
+import numpy as np
+import librosa
+import librosa.display
+import matplotlib.pyplot as plt
+import noisereduce as nr
+import random
+import shutil
+
+from tensorflow.keras.preprocessing.image import ImageDataGenerator
+from tensorflow.keras.models import Sequential
+from tensorflow.keras.layers import Conv2D, MaxPooling2D, Flatten, Dense, Dropout, BatchNormalization
+from tensorflow.keras.callbacks import EarlyStopping, ReduceLROnPlateau, ModelCheckpoint
+from tensorflow.keras.optimizers import Adam
+
+
+DATA_SOURCE_PATH = 'data'
+SPECTROGRAM_PATH = 'spectrograms_stft_5s_grayscale' 
+MODEL_SAVE_PATH = 'parkinson_cnn_model_stft_grayscale.h5' 
+IMG_HEIGHT, IMG_WIDTH = 224, 224
+BATCH_SIZE = 32
+TARGET_DURATION_S = 5
+
+# Data Augmentation 
+def augment_audio(y, sr):
+    y_aug = y.copy()
+    pitch_steps = random.uniform(-2, 2)
+    y_aug = librosa.effects.pitch_shift(y_aug, sr=sr, n_steps=pitch_steps)
+    stretch_rate = random.uniform(0.9, 1.1)
+    y_aug = librosa.effects.time_stretch(y_aug, rate=stretch_rate)
+    noise_amp = 0.005 * np.random.uniform() * np.amax(y)
+    y_aug = y_aug + noise_amp * np.random.normal(size=len(y_aug))
+    return y_aug
+
+# Spectrogram Creation 
+def create_stft_spectrogram(audio_file, save_path, augment=False):
+    """
+    Creates a high-quality GRAYSCALE spectrogram from a standardized 5s audio segment.
+    """
+    try:
+        y, sr = librosa.load(audio_file, sr=None)
+        
+        target_samples = TARGET_DURATION_S * sr
+        
+        if len(y) > target_samples:
+            start_index = int((len(y) - target_samples) / 2)
+            y_segment = y[start_index : start_index + target_samples]
+        else:
+            y_segment = librosa.util.pad_center(y, size=target_samples)
+
+        if augment:
+            y_segment = augment_audio(y_segment, sr)
+
+        y_reduced = nr.reduce_noise(y=y_segment, sr=sr)
+        
+        N_FFT = 1024
+        HOP_LENGTH = 256
+        S_audio = librosa.stft(y_reduced, n_fft=N_FFT, hop_length=HOP_LENGTH)
+        Y_db = librosa.amplitude_to_db(np.abs(S_audio), ref=np.max)
+
+        plt.figure(figsize=(12, 4))
+        
+        librosa.display.specshow(Y_db, sr=sr, hop_length=HOP_LENGTH, x_axis='time', y_axis='log', cmap='gray_r')
+        plt.axis('off')
+        plt.savefig(save_path, bbox_inches='tight', pad_inches=0)
+        plt.close()
+        return True
+        
+    except Exception as e:
+        print(f"      - Error processing {audio_file}: {e}")
+        return False
+
+#Data Preparation 
+def process_all_audio_files():
+    if os.path.exists(SPECTROGRAM_PATH):
+        shutil.rmtree(SPECTROGRAM_PATH)
+    print(f"Starting audio to Grayscale STFT Spectrogram conversion ({TARGET_DURATION_S}s)...")
+    for split in ['train', 'validation']:
+        for category in ['parkinson', 'healthy']:
+            os.makedirs(os.path.join(SPECTROGRAM_PATH, split, category), exist_ok=True)
+    for category in ['parkinson', 'healthy']:
+        source_dir = os.path.join(DATA_SOURCE_PATH, category)
+        all_files = [f for f in os.listdir(source_dir) if f.lower().endswith(('.wav', '.mp3'))]
+        if not all_files: continue
+        random.shuffle(all_files)
+        split_index = int(len(all_files) * 0.8)
+        train_files, validation_files = all_files[:split_index], all_files[split_index:]
+        print(f"--- Processing Category: {category} ---")
+        for filename in train_files:
+            file_path = os.path.join(source_dir, filename)
+            base_name = os.path.splitext(filename)[0]
+            for i in range(3):
+                save_path = os.path.join(SPECTROGRAM_PATH, 'train', category, f"{base_name}_aug_{i}.png")
+                create_stft_spectrogram(file_path, save_path, augment=(i > 0))
+        for filename in validation_files:
+            file_path = os.path.join(source_dir, filename)
+            base_name = os.path.splitext(filename)[0]
+            save_path = os.path.join(SPECTROGRAM_PATH, 'validation', category, f"{base_name}.png")
+            create_stft_spectrogram(file_path, save_path, augment=False)
+    print("Spectrogram generation complete.")
+
+
+def train_cnn_model():
+    """
+    Trains a CNN model optimized for grayscale spectrograms.
+    """
+    if not os.path.exists(SPECTROGRAM_PATH):
+        print("Spectrograms not found.")
+        return
+
+    train_datagen = ImageDataGenerator(rescale=1./255)
+    validation_datagen = ImageDataGenerator(rescale=1./255)
+
+   
+    train_generator = train_datagen.flow_from_directory(
+        os.path.join(SPECTROGRAM_PATH, 'train'),
+        target_size=(IMG_HEIGHT, IMG_WIDTH),
+        batch_size=BATCH_SIZE,
+        class_mode='binary',
+        color_mode='grayscale' # Tells Keras to load images with 1 channel
+    )
+    validation_generator = validation_datagen.flow_from_directory(
+        os.path.join(SPECTROGRAM_PATH, 'validation'),
+        target_size=(IMG_HEIGHT, IMG_WIDTH),
+        batch_size=BATCH_SIZE,
+        class_mode='binary',
+        color_mode='grayscale'
+    )
+
+    if not train_generator.samples > 0:
+        print("Error: No training images were generated.")
+        return
+        
+
+    model = Sequential([
+        Conv2D(32, (3, 3), activation='relu', input_shape=(IMG_HEIGHT, IMG_WIDTH, 1), padding='same'),
+        BatchNormalization(),
+        MaxPooling2D((2, 2)),
+        Conv2D(64, (3, 3), activation='relu', padding='same'),
+        BatchNormalization(),
+        MaxPooling2D((2, 2)),
+        Conv2D(128, (3, 3), activation='relu', padding='same'),
+        BatchNormalization(),
+        MaxPooling2D((2, 2)),
+        Flatten(),
+        Dense(256, activation='relu'),
+        BatchNormalization(),
+        Dropout(0.5),
+        Dense(128, activation='relu'),
+        Dropout(0.4),
+        Dense(1, activation='sigmoid')
+    ])
+
+    model.compile(optimizer=Adam(learning_rate=0.001), loss='binary_crossentropy', metrics=['accuracy'])
+    model.summary() 
+
+    callbacks_list = [
+        EarlyStopping(monitor='val_loss', patience=15, restore_best_weights=True),
+        ReduceLROnPlateau(monitor='val_loss', factor=0.2, patience=7),
+        ModelCheckpoint(MODEL_SAVE_PATH, monitor='val_accuracy', save_best_only=True, mode='max')
+    ]
+    
+    model.fit(
+        train_generator,
+        epochs=100,
+        validation_data=validation_generator,
+        callbacks=callbacks_list
+    )
+    print(f"Grayscale model training complete. Best model saved to {MODEL_SAVE_PATH}")
+
+
+if __name__ == '__main__':
+    process_all_audio_files()
+    train_cnn_model()

train_symptom_model.py

@@ -0,0 +1,67 @@
+import pandas as pd
+from sklearn.model_selection import train_test_split
+from sklearn.linear_model import LogisticRegression
+from sklearn.metrics import accuracy_score, classification_report
+import joblib
+import os
+
+# --- Configuration ---
+# Ensure your Excel file is in the project root and named this, or change the path.
+DATASET_PATH = 'symptoms_dataset.xlsx' 
+MODEL_SAVE_PATH = 'symptom_model.joblib'
+
+def train_symptom_model():
+    """
+    Loads symptom data from an Excel file, trains a Logistic Regression model,
+    and saves it to disk.
+    """
+    # 1. Load the dataset
+    try:
+        df = pd.read_excel(DATASET_PATH)
+        print(f"Dataset '{DATASET_PATH}' loaded successfully. Shape: {df.shape}")
+    except FileNotFoundError:
+        print(f"Error: The file '{DATASET_PATH}' was not found. Please create it and add your data.")
+        return
+
+    # 2. Define Features (X) and Target (y)
+    # These are the columns the model will use to learn.
+    features = ['tremor', 'stiffness', 'walking_issue'] 
+    # This is the column the model will try to predict.
+    target = 'label' 
+
+    # Validate that all required columns exist in the Excel file
+    required_columns = features + [target]
+    if not all(col in df.columns for col in required_columns):
+        print(f"Error: Your Excel file is missing one or more required columns.")
+        print(f"Please ensure it contains: {required_columns}")
+        return
+        
+    X = df[features]
+    y = df[target]
+
+    # 3. Split data into training and testing sets
+    # We use 'stratify=y' to ensure both train and test sets have a similar proportion of 0s and 1s.
+    X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2, random_state=42, stratify=y)
+    print(f"Data split into {len(X_train)} training samples and {len(X_test)} testing samples.")
+
+    # 4. Initialize and Train the Model
+    print("\nTraining Logistic Regression model...")
+    # We use class_weight='balanced' to handle cases where there might be more 0s than 1s or vice-versa.
+    model = LogisticRegression(random_state=42, class_weight='balanced')
+    model.fit(X_train, y_train)
+    print("Model training complete.")
+
+    # 5. Evaluate the Model (optional but good practice)
+    print("\nEvaluating model performance...")
+    y_pred = model.predict(X_test)
+    accuracy = accuracy_score(y_test, y_pred)
+    print(f"Model Accuracy on Test Set: {accuracy:.4f}")
+    print("\nClassification Report:")
+    print(classification_report(y_test, y_pred))
+
+    # 6. Save the Trained Model
+    joblib.dump(model, MODEL_SAVE_PATH)
+    print(f"\nSymptom model successfully saved to: {MODEL_SAVE_PATH}")
+
+if __name__ == '__main__':
+    train_symptom_model()

wsgi.py

@@ -0,0 +1,23 @@
+# wsgi.py
+import os
+
+# Use non-GUI backend for Matplotlib
+import matplotlib
+matplotlib.use("Agg")
+
+# Import Flask app factory
+from app import create_app
+
+# Create Flask app
+app = create_app()
+
+# Optional: Pre-import heavy ML libraries to catch issues early
+try:
+    import tensorflow as tf
+except Exception as e:
+    print(f"TensorFlow import warning: {e}")
+
+# Gunicorn will look for 'app' by default
+if __name__ == "__main__":
+    port = int(os.environ.get("PORT", 5000))
+    app.run(host="0.0.0.0", port=port)