FixIT Hub

FixIT Hub is a web-based application designed to streamline and manage the service and repair operations for HP and laptop devices. It provides a centralized platform for technicians, administrators, and customers to collaborate effectively, track service requests, and ensure timely resolution of device issues.

Goals

• Efficient Service Management: Simplify the process of receiving, assigning, and completing service requests for HP and laptop devices.
• Enhanced Customer Experience: Provide customers with a user-friendly interface to submit service requests, track progress, and receive updates on device repairs.
• Improved Technician Productivity: Empower technicians with tools for efficient diagnosis, repair, and documentation of device issues.
• Data Insights: Generate reports and analytics to gain insights into service trends, technician performance, and customer satisfaction.

Features

• User Roles
  • Admin: Manages technicians, service requests, and system settings.
  • Technician: Receives, processes, and completes service requests.
  • Customer: Submits service requests, tracks progress, and communicates with technicians.
• Customer-Facing Features
  • Service Request Submission: Customers can submit service requests by providing device details, issue descriptions, and contact information.
  • Service Tracking: Real-time status updates and notifications for customers to track the progress of their service requests.
  • Communication: Integrated messaging system for customers to communicate with assigned technicians regarding their device repairs.
• Technician-Facing Features
  • Service Dashboard: Overview of assigned service requests, priorities, and pending tasks.
  • Device Diagnosis: Tools and resources for diagnosing device issues, troubleshooting, and documenting repair steps.
  • Service Completion: Marking service requests as completed, adding repair notes, and updating customer status.
• Admin Dashboard
  • User Management: Add, edit, and manage technician accounts, customer profiles, and administrative settings.
  • Service Queue: Monitor and assign service requests to available technicians based on workload and expertise.
  • Analytics and Reporting: Generate reports on service performance, customer feedback, and device repair trends.

Technical Specifications

• Framework: Ruby on Rails (Version 7.0.8)
• Database: PostgreSQL
• Frontend: HTML5, CSS3, JavaScript
• Authentication: Devise gem for user authentication

Get Started

Get the Source Code

Of course, you need to put this code on your computer first. There are two ways to do this: by downloading the project zip file or by using Git (recommended).

1. Download the Project Zip

   You can click on this link to download the zip file of this project.

2. Git Clone

   Make sure that you have installed git. Open the directory where you want to place the source code in the terminal. Then, run the following command:

   git clone git@github.com:404NotFoundIndonesia/fixit-hub.git

Install Dependencies

Run the following command to install all the dependencies (gems) required by the Rails project:

bundle install

Setup Credentials

Go to the config directory and make sure there are files named credentials.yml.enc and master.key. If they are not present, run the following command:

rails credentials:edit

The command will open the decrypted credentials.yml.enc file. Once it's open, please enter the PostgreSQL credentials in the following format:

postgre_username: ...
postgre_password: ...
postgre_hostname: ...
postgre_database: ...

Please replace the ... symbols with your actual credentials.

Setup Database

Run the following command to create the database, run migrations, and seed data:

rails db:setup

How to Run

To start the Rails server, make sure the terminal is in the root directory of the project and use the following command:

rails server

Open http://localhost:3000 in your browser to access FixIT Hub.

License

FixIT Hub is open-sourced software licensed under the MIT license.