VSMS: Vehicle Service Management System

A high-performance management solution for modern automotive workshops.

Setup Guide • Features • Architecture • Security

---

🛠️ Tech Stack

Layer	Technology
Frontend	React (Vite 5+), Vanilla CSS, Lucide Icons
Backend	Node.js, Express.js
Database	MongoDB (Mongoose ODM)
Tooling	Dependabot, ESLint, Git

---

🚀 Setup Instructions

1️⃣ Clone and Prepare

git clone https://github.com/senuda-d/VSMS.git
cd VSMS

2️⃣ Backend Configuration

1. Navigate: cd backend
2. Install: npm install
3. Environment: Create a .env file:

   MONGO_URI=your_mongodb_connection_string
   PORT=5000

4. Launch: npm run dev (Runs on port 5000)

3️⃣ Frontend Configuration

1. Navigate: cd ../frontend
2. Install: npm install
3. Launch: npm run dev (Runs on port 5173)

---

💎 Key Features

• 📊 Industrial Dashboard: Real-time revenue analytics, active booking counts, and inventory status.
• 🛠️ Active Job Bay: Digital checklist for mechanics with automated billing integration.
• 📦 Smart Inventory: Quick-adjust quantity controls with automated reorder alerts.
• 📄 Professional Invoicing: One-click PDF generation with itemized labor and parts.
• 🤖 Service Assistant: Integrated chatbot for availability checks and customer queries.

---

🏛️ System Architecture

The project follows a modular MERN architecture with a focus on clean separation of concerns:

/backend
├── controllers/    # API Logic (CRUD handling)
├── models/         # Database Schemas (Customer, Vehicle, Bill, etc.)
├── routes/         # Express Router definitions
└── server.js      # Main entry point with middleware

/frontend
├── src/
│   ├── assets/    # Industrial UI assets & logos
│   ├── pages/     # Feature-specific modules
│   └── styles/    # Shared CSS variables & industrial theme
└── App.jsx        # Routing & Application Shell

---

🛡️ Security & Maintenance

• Automated Updates: Dependabot is configured to check for npm security vulnerabilities daily.
• Industrial Theme: Consistent typography and color variables used across all modules.
• Input Sanitization: Numeric inputs are sanitized on both frontend and backend.

---

Developed for the VSMS Project © 2026