https://github.com/rawanfarakhnah/auto_fix
A Django-based web platform that helps car owners manage their vehicles, find nearby workshops, diagnose car issues using AI, set maintenance reminders, and leave service reviews.
https://github.com/rawanfarakhnah/auto_fix
ai ajax auth authintication-protocol aws csrf-protection deployment django js mysql oop orm python restfull-api
Last synced: 2 months ago
JSON representation
A Django-based web platform that helps car owners manage their vehicles, find nearby workshops, diagnose car issues using AI, set maintenance reminders, and leave service reviews.
- Host: GitHub
- URL: https://github.com/rawanfarakhnah/auto_fix
- Owner: RawanFarakhnah
- Created: 2025-04-04T12:16:31.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-04-24T12:15:03.000Z (11 months ago)
- Last Synced: 2025-06-13T17:46:15.065Z (10 months ago)
- Topics: ai, ajax, auth, authintication-protocol, aws, csrf-protection, deployment, django, js, mysql, oop, orm, python, restfull-api
- Language: HTML
- Homepage:
- Size: 29.6 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Auto Fix 🚗🔧
A Django-based web platform that helps car owners manage their vehicles, find nearby workshops, diagnose car issues using AI, set maintenance reminders, and leave service reviews.
---
## ✨ Features
- **📍 Find Nearest Workshop:** Locate workshops using geolocation or address-based proximity.
- **🧠 AI Car Diagnosis:** Chat with an AI assistant to identify potential issues based on symptoms.
- **⭐ Service Reviews:** Rate and review workshops and services.
- **⏰ Maintenance Notifications:** Get reminded about periodic car maintenance.
- **🔐 Authentication:** Secure login and user management.
- **📱 Responsive UI:** Mobile-friendly and intuitive design.
- **🔄 Dynamic Content:** AJAX-powered interactions.
- **🗂️ Relational DB:** MySQL with Django ORM.
- **🌐 REST API:** Easily integrate with mobile or third-party services.
---
## 🙌 Special Thanks
We extend our deepest gratitude to **Axsos Academy** for providing a transformative learning journey.
A heartfelt thank you to our **instructor** and **teaching assistant** for their continuous guidance, encouragement, and knowledge-sharing throughout this project.
This platform is a testament to the power of learning through collaboration.
### 👩💻 Team Members
- [Rawan Farakhna](https://www.linkedin.com/in/rawanfarakhna/)
- [Mujahed Qasem](https://www.linkedin.com/in/mujahed-qasem/)
- [Yasmeena Bassam](https://www.linkedin.com/in/yasmeena-bassam-yousef-a8b4b1346/)
---
## 🚀 Quick Start
### Prerequisites
- Python 3.8+
- MySQL 8.0+
- Git
### Installation
```bash
# Clone the repository
git clone https://github.com/RawanFarakhnah/auto-fix.git
cd auto-fix
# Set up virtual environment
python -m venv venv
source venv/bin/activate # macOS/Linux
venv\Scripts\activate # Windows
# Install dependencies
pip install -r requirements.txt
```
### Database Setup
1. Create MySQL database:
```sql
CREATE DATABASE auto_fix_db;
```
2. Update `settings.py`:
```python
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'auto_fix_db',
'USER': 'your_username',
'PASSWORD': 'your_password',
'HOST': 'localhost',
'PORT': '3306',
'OPTIONS': {
'init_command': "SET sql_mode='STRICT_TRANS_TABLES'",
}
}
}
```
### Run Application
```bash
# Apply database migrations
python manage.py migrate
# Create admin user
python manage.py createsuperuser
# Start development server
python manage.py runserver
```
Visit [http://localhost:8000](http://localhost:8000) in your browser.
---
## 📂 Project Structure
```
auto_fix/
├── accounts/
│ ├── models.py
│ ├── views.py
├── admin_dashboard/
│ ├── models.py
│ ├── views.py
├── ai_diagnosis/
│ ├── models.py
│ ├── views.py
├── auto_fix/
│ ├── settings/
│ ├── urls.py
│ └── wsgi.py
├── bookings/
│ ├── models.py
│ ├── views.py
├── cars/
│ ├── models.py
│ ├── views.py
├── landing/
│ ├── models.py
│ ├── views.py
├── locations/
│ ├── models.py
│ ├── views.py
├── media/
│ ├── workshops_images/
├── owner_dashboard/
│ ├── models.py
│ ├── views.py
├── reviews/
│ ├── models.py
│ ├── views.py
├── user_dashboard/
│ ├── models.py
│ ├── views.py
├── workshops/
│ ├── models.py
│ ├── views.py
├── templates/
│ ├── base.html
│ ├── base2.html
│ ├── accounts/
│ ├── admin_dashboard/
│ ├── landing/
│ ├── owner_dashboard/
│ └── user_dashboard/
├── static/
│ ├── css/
│ ├── js/
│ └── img/
├── manage.py
├── requirements.txt
├── README.md
```
---
## 🔒 Security Features
- ✅ CSRF protection
- ✅ Password hashing
- ✅ Secure user authentication
- ✅ Role-based access control
- ✅ Rate limiting for sensitive endpoints
---
## 🛠️ Tech Stack
- **Backend:** Django 4.0+
- **Database:** MySQL 8.0+
- **Frontend:** HTML5, CSS3, JavaScript
- **Authentication:** Django Allauth
- **AI Logic:** Custom Python AI models (extendable)
---