Garage Management System - Ruby

Garage Management System

Garage Management System is a full-stack web application for vehicle repair shops, body shops, service centers, and workshop operations. It combines a Ruby on Rails 8 backend with a Vue 3 and TypeScript single-page frontend, giving teams one responsive dashboard for repair jobs, appointments, inventory, costs, and profit tracking.

The project includes source code, database migrations, demo seed data, buyer documentation, Docker configuration, and a clean setup flow for local development or deployment customization.

Demo Accounts

• Admin: admin@garage.test / password
• Staff: staff@garage.test / password

Technology Stack

• Ruby on Rails 8
• Ruby 3.4.5
• Vue 3 with TypeScript
• Vite, Pinia, Vue Router, Axios, Day.js
• Tailwind CSS
• PostgreSQL
• Puma, Propshaft, Solid Cache, Solid Queue, Solid Cable
• Docker Compose configuration included

Features

• Responsive repair operations dashboard
• Repair job list with status counters, search, and filters
• End-to-end job workflow from scheduled appointment to delivered vehicle
• Vehicle appointment scheduling and check-in flow
• Detailed job page with progress timeline and status advancement
• Customer, license plate, vehicle type, repair type, notes, and timeline fields
• Parts assignment per repair job
• Parts inventory with part number, cost price, quantity, and low-stock styling
• Financial summary with approved amount, parts cost, labor cost, total cost, and profit/loss
• Admin and staff demo roles
• Activity log for job and inventory operations
• Seed data included for quick testing
• Clean Vue 3 SPA structure with stores, typed API helpers, layouts, and pages
• Docker, Kamal, and Thruster files included for deployment customization
• Buyer documentation included in the main package

Requirements

• Ruby 3.4.5
• Bundler
• Node.js and npm
• PostgreSQL
• Modern web browser
• Optional: Docker and Docker Compose

Instructions

1. Extract the main ZIP file.
2. Open the included documentation/index.html file for setup notes.
3. Install Ruby dependencies with bundle install.
4. Install JavaScript dependencies with npm install.
5. Prepare the database with bin/rails db:prepare.
6. Load demo data with bin/rails db:seed.
7. Start the app with bin/dev.
8. Open http://localhost:3000 in a browser.
9. Sign in with the included admin or staff demo account.