Skip to content

EliezerKibet/AI_based_garage

Repository files navigation

πŸš— AI-Based Garage Management System

A modern, intelligent garage management platform with AI-powered features

.NET C# ASP.NET Core License

Demo β€’ Features β€’ Installation β€’ Usage β€’ API β€’ Contributing


πŸ“‹ Overview

The AI-Based Garage Management System is a comprehensive platform designed to streamline garage operations through intelligent automation and role-based access control. Built with modern web technologies, it provides seamless interactions between administrators, customers, and mechanics while leveraging AI for enhanced decision-making and customer support.

🎯 Key Benefits

  • πŸ€– AI-Powered Assistance - Intelligent chatbot for customer queries and support
  • πŸ‘₯ Role-Based Access - Secure, permission-based functionality for different user types
  • πŸ“… Smart Scheduling - Automated appointment booking with conflict detection
  • πŸ“Š Real-Time Analytics - Live dashboard with performance metrics
  • πŸ”§ Service Tracking - Complete vehicle service history and maintenance logs

✨ Features

πŸ›‘οΈ Role-Based Authentication System

  • Admin Panel - Complete system oversight with AI insights
  • Customer Portal - Self-service booking and service tracking
  • Mechanic Dashboard - Task management and repair documentation

πŸ€– AI Integration

  • Intelligent Chatbot - 24/7 customer support with natural language processing
  • Predictive Maintenance - AI-driven service recommendations
  • Smart Scheduling - Optimal appointment slot suggestions

πŸ“± Modern User Interface

  • Responsive Design - Works seamlessly across all devices
  • Interactive Calendar - Visual appointment management
  • Real-Time Updates - Live status notifications

πŸ”§ Comprehensive Management Tools

  • Service History Tracking - Complete vehicle maintenance records
  • Inventory Management - Parts and supplies monitoring
  • Customer Relationship Management - Enhanced customer interaction tracking
  • Reporting & Analytics - Detailed business insights

πŸš€ Demo

Admin Dashboard with AI Features

Comprehensive overview with AI-powered insights and management tools

Admin Dashboard with AI Integration

Secure Authentication System

Role-based login with pre-configured credentials for testing

Secure Login Interface

Smart Appointment Calendar

Intelligent scheduling system with conflict detection and optimization

Smart Calendar System

Customer Self-Service Portal

Empowering customers with booking, tracking, and communication tools

Customer Dashboard

Mechanic Workflow Management

Streamlined task management and service documentation

Mechanic Dashboard

πŸ› οΈ Technology Stack

Backend

  • Framework: ASP.NET Core 8.0
  • Language: C# 12
  • Database: Entity Framework Core with SQL Server
  • Authentication: ASP.NET Core Identity
  • API: RESTful Web API with OpenAPI/Swagger

Frontend

  • Framework: ASP.NET Core MVC with Razor Pages
  • Styling: Modern CSS3 with responsive design
  • JavaScript: Vanilla JS with modern ES6+ features
  • Icons: Font Awesome / Bootstrap Icons

AI & ML

  • Chatbot: Natural Language Processing integration
  • Analytics: Machine learning for predictive insights

Development Tools

  • IDE: Microsoft Visual Studio 2022
  • Version Control: Git with GitHub
  • Testing: xUnit for unit testing
  • Documentation: XML documentation comments

πŸ“¦ Installation

Prerequisites

Quick Start

  1. Clone the repository

    git clone https://github.com/EliezerKibet/AI_based_garage.git
    cd AI_based_garage
  2. Restore dependencies

    dotnet restore
  3. Configure database connection

    # Update appsettings.json with your SQL Server connection string
    {
      "ConnectionStrings": {
        "DefaultConnection": "Server=(localdb)\\mssqllocaldb;Database=GarageManagementDB;Trusted_Connection=true;MultipleActiveResultSets=true"
      }
    }
  4. Run database migrations

    dotnet ef database update
  5. Start the application

    dotnet run
  6. Access the application

Development Setup

For development with live reload:

dotnet watch run

πŸ”‘ Usage

Default Login Credentials

Role Username Password
Admin [email protected] Admin123!
Customer [email protected] Customer123!
Mechanic [email protected] Mechanic123!

Getting Started

  1. Admin Users: Access the admin dashboard to configure system settings, manage users, and view analytics
  2. Customers: Book appointments, track service history, and communicate with support
  3. Mechanics: View assigned tasks, update service status, and document repairs

πŸ”— API Documentation

The system provides a comprehensive RESTful API for integration with external systems.

Base URL

https://localhost:7000/api/

Key Endpoints

Method Endpoint Description
GET /api/appointments Retrieve appointments
POST /api/appointments Create new appointment
GET /api/customers/{id} Get customer details
POST /api/chatbot/ask AI chatbot interaction

API Documentation

Access the interactive API documentation at:


πŸ§ͺ Testing

Run the test suite:

# Run all tests
dotnet test

# Run with coverage
dotnet test --collect:"XPlat Code Coverage"

πŸš€ Deployment

Production Deployment

  1. Build for production

    dotnet publish -c Release -o ./publish
  2. Configure production settings

    • Update connection strings
    • Set environment variables
    • Configure HTTPS certificates
  3. Deploy to hosting platform

    • Azure App Service
    • AWS Elastic Beanstalk
    • Docker containers

🀝 Contributing

We welcome contributions! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch
    git checkout -b feature/amazing-feature
  3. Commit your changes
    git commit -m 'Add amazing feature'
  4. Push to the branch
    git push origin feature/amazing-feature
  5. Open a Pull Request

Development Guidelines

  • Follow C# coding conventions
  • Write unit tests for new features
  • Update documentation as needed
  • Ensure all tests pass before submitting

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.


πŸ“ž Support & Contact


🌟 Acknowledgments

  • Built with ❀️ using ASP.NET Core
  • Icons by Font Awesome
  • AI capabilities powered by modern NLP technologies
  • Special thanks to the open-source community

⭐ Star this repository if you find it helpful!

⬆ Back to Top