ADHD Screening Assessment Web App

A modern web application for behavioral and emotional analysis based on childhood experiences. This tool provides an ADHD screening questionnaire with personalized results and a dashboard to track assessments.

Live link: https://adhd-screening-assessment.vercel.app/

Features

• Interactive Questionnaire: 15 research-based questions with step-by-step navigation
• ADHD Screening Criteria: Results based on clinical interpretation levels
• User Dashboard: View, search, and filter all assessment results
• Modern UI: Clean, responsive design with smooth animations
• Data Persistence: SQLite database stores all assessments

Result Categories

Score Range	Interpretation Level	Recommended Action
0-10	Minimal Traits	No concern
11-20	Mild ADHD Traits	Self-monitoring recommended
21-30	Moderate ADHD Indicators	Consider professional screening
31-45	High ADHD Risk	Clinical evaluation advised
46-60	Very High Likelihood	Formal diagnostic assessment recommended

Tech Stack

• Backend: Python Flask
• Database: SQLite with SQLAlchemy ORM
• Frontend: HTML5, CSS3, Vanilla JavaScript
• Styling: Custom CSS with CSS Variables

Project Structure

Behaviour analysis/
├── app.py                 # Flask application & API routes
├── requirements.txt       # Python dependencies
├── README.md             # Project documentation
├── assessments.db        # SQLite database (auto-created)
├── templates/
│   ├── index.html        # Home page
│   ├── questionnaire.html # Assessment questions
│   ├── result.html       # Individual result page
│   └── dashboard.html    # Results dashboard
└── static/
    └── css/
        └── style.css     # Application styles

Installation & Setup

Prerequisites

• Python 3.8 or higher
• pip (Python package manager)

Step 1: Clone or Navigate to Project

cd "/Users/vishalsarmah/Desktop/Behaviour analysis"

Step 2: Create Virtual Environment (Recommended)

python3 -m venv .venv
source .venv/bin/activate  # On macOS/Linux
# or
.venv\Scripts\activate     # On Windows

Step 3: Install Dependencies

pip install -r requirements.txt

Step 4: Run the Application

python app.py

Step 5: Open in Browser

Navigate to: http://127.0.0.1:5000

Usage

1. Start Assessment: Enter your name on the home page and click "Start Assessment"
2. Answer Questions: Rate each question from 0-4 based on your childhood experiences
3. View Results: See your score, interpretation level, and recommended action
4. Dashboard: Access all past assessments via the Dashboard link

API Endpoints

Endpoint	Method	Description
/	GET	Home page
/questionnaire	GET	Assessment questions
/submit	POST	Submit assessment responses
/result/<id>	GET	View specific result
/dashboard	GET	View all assessments
/api/assessments	GET	Get all assessments (JSON)
/api/assessment/<id>	GET	Get specific assessment (JSON)
/api/delete/<id>	DELETE	Delete an assessment

Disclaimer

This assessment is for informational and research purposes only. It is not a diagnostic tool and does not replace a professional evaluation by a qualified clinician. If you have concerns about your mental health, please consult with a qualified healthcare professional.

License

This project is for educational and personal use.