CommuRide

🌤️ CommuRide

A web-based weather forecasting and clothing recommendation system that helps users make smarter daily decisions.

📖 Overview

CommuRide integrates real-time weather data retrieval with a smart recommendation engine to provide users with:

🌦️ Real-time weather forecasts
📍 Location-based weather search
👕 Smart clothing suggestions based on weather conditions

By combining weather insights with practical outfit recommendations, CommuRide enhances user convenience and day-to-day planning.

✨ Key Features

🔍 Search weather by location — Look up any city or region instantly
🌡️ Current temperature and conditions — Live temperature, humidity, and sky conditions
👕 Clothing recommendations — Outfit suggestions tailored to the weather
📊 Simple, user-friendly interface — Clean layout designed for fast access
⚡ Real-time data updates — Always-fresh data pulled from live sources

🛠️ Tech Stack

Layer	Technology
Frontend	HTML, CSS, JavaScript
Backend	PHP
Database	MySQL
Local Server	XAMPP (Apache + MySQL)

⚙️ Installation

1. Clone the Repository

git clone https://github.com/CommuRide/CommuRide.git

2. Move to Server Directory

Copy the project folder into your XAMPP htdocs directory:

C:/xampp/htdocs/CommuRide

3. Setup the Database

Open phpMyAdmin (http://localhost/phpmyadmin)
Create a new database named:
```
commuride_db
```
Import the provided .sql file from /db/schema.sql

4. Configure Database Connection

Edit /config/config.php with your local credentials:

$host     = "localhost";
$user     = "root";
$password = "";
$database = "commuride_db";

5. Run the Project

Start Apache and MySQL in XAMPP Control Panel
Open your browser and navigate to:
```
http://localhost/CommuRide
```

📊 System Workflow

🔍 User enters a location
        ↓
🌐 System fetches weather data from API
   (temperature, condition, humidity, etc.)
        ↓
🌡️ Weather data is processed & categorized
   (hot / cold / rainy / humid)
        ↓
👕 Clothing recommendation is generated
   Hot     → Light clothing
   Rainy   → Jacket / Umbrella
   Cold    → Layered clothing
        ↓
📊 Results displayed to the user
        ↓
🔁 User can search again for another location

🔐 Security

Passwords are hashed using PHP’s password_hash() with PASSWORD_DEFAULT
Session-based authentication enforced across all pages
Role-based access restrictions for Admin, Manager, and User routes

📁 Project Structure

CommuRide/
│
├── admin/
│   └── dashboard.php
│
├── auth/
│   ├── signout.php
│   └── verify-email.php
│
├── manager/
│   └── dashboard.php
│
├── user/
│   ├── dashboard.php
│   └── save-history.php
│
├── users/
│   ├── dashboard.php
│   ├── history.php
│   ├── user-create.php
│   ├── user-delete.php
│   ├── user-update.php
│   └── user-view.php
│
├── assets/
│   └── css/
│       ├── style.css
│       ├── admin.css
│       ├── history.css
│       ├── index.css
│       ├── user-create.css
│       ├── user-forms.css
│       └── user.css
│
├── config/
│   ├── config.php
│   └── functions.php
│
├── db/
│   └── schema.sql
│
├── includes/
│   └── activity-logger.php
│
├── tests/
│   ├── test-access.php
│   ├── test-login.php
│   └── test-mail.php
│
└── index.php          ← Login page (entry point)

🤝 Contributing

Contributions are welcome! Follow these steps:

Fork the repository

Create a feature branch

git checkout -b feature/your-feature-name

Commit your changes

git commit -m "Add: your feature description"

Push to your branch

git push origin feature/your-feature-name

Open a Pull Request

📄 License

This project is intended for educational purposes and may be freely modified or reused.

👩‍💻 Author

CommuRide Team 🔗 GitHub: https://github.com/CommuRide