Skip to content

TechFix Manager is a full-stack web platform for managing multi-workshop operations. It offers secure role-based access, real-time ticket tracking, employee management, and KPI monitoring. Built with Spring Boot, Angular, Redis, and WebSocket, it ensures scalable, efficient, and intelligent workshop management with integrated AI chatbot support.

Notifications You must be signed in to change notification settings

chrifyessmine02/TechFixManager

Repository files navigation

TechFix Manager

TechFix Manager is a full-stack web application designed to streamline multi-workshop operations, including ticket management, employee coordination, KPI monitoring, and real-time communication. The system integrates modern technologies such as Spring Boot, Angular, Redis, and WebSocket, and features an AI-powered chatbot built on a Hugging Face model for interactive assistance.


Table of Contents


Overview

TechFix Manager addresses the challenges of managing multiple repair workshops by providing a centralized and secure platform. It enables real-time ticket tracking, employee management, and KPI monitoring while enforcing role-based access control.

The project follows an MVC architecture on both frontend and backend, ensuring scalability, maintainability, and clear separation of concerns.


Features

Authentication and Security

  • JWT-based authentication stored in HttpOnly cookies.
  • Role-Based Access Control (Admin, Chef, Technician).
  • CSRF and CORS protection.
  • Password encryption with BCrypt.
  • Stateless security architecture.

Ticket Management

  • Full CRUD operations with automatic workflow validation.
  • Kanban board with drag-and-drop functionality.
  • PDF invoice generation and email notifications.
  • Real-time ticket updates via WebSocket.
  • Filtering and search by company, workshop, technician, client, or status.

Employee Management

  • Hierarchical registration and access control.
  • Profile image management and live preview.
  • Automatic work session tracking and KPI integration.

KPI Monitoring

  • Hybrid system combining REST and WebSocket for real-time updates.
  • Redis caching for fast KPI retrieval.
  • Metrics tracked at company, workshop, technician, and client levels.

Chatbot Integration

  • AI-powered chatbot using Hugging Face model (Qwen2.5-VL-7B-Instruct).
  • Supports text and image messages.
  • Persistent per-user conversation history with reset functionality.

Architecture

Frontend (Angular 20)

  • Standalone components with Reactive Forms and Signals.
  • Angular Material for UI.
  • JWT and CSRF handling through HTTP interceptors.
  • WebSocket-based live updates for KPIs, tickets, and notifications.
  • SCSS styling with a responsive, modern dashboard interface.

Backend (Spring Boot 3.5.3)

  • RESTful APIs with layered MVC architecture.
  • Spring Security with JWT and CSRF protection.
  • Spring Data JPA/Hibernate for database persistence.
  • Redis for caching and pub/sub event propagation.
  • WebSocket/STOMP for real-time updates.
  • Containerized services using Docker.

Tech Stack

Layer Technology
Frontend Angular 20, RxJS, Angular Material, SCSS
Backend Spring Boot 3.5.3, Spring Security, JPA/Hibernate
Database MySQL
Real-Time WebSocket, Redis
Containerization Docker
AI Hugging Face API (Qwen2.5-VL-7B-Instruct)

Modules

  • Authentication Module: Manages login, registration, and role-based access.
  • Ticket Module: Handles tickets, invoices, notifications, and real-time updates.
  • Employee Module: Manages employees, sessions, and workshop assignments.
  • KPI Module: Monitors operational metrics through REST + WebSocket.
  • Chatbot Module: Integrates Hugging Face conversational AI for user support.
  • Client/Company/Workshop Modules: Handle CRUD operations with KPI linkage.

Installation

Prerequisites

  • Node.js (v20+)
  • Java 17+
  • MySQL Server
  • Docker

About

TechFix Manager is a full-stack web platform for managing multi-workshop operations. It offers secure role-based access, real-time ticket tracking, employee management, and KPI monitoring. Built with Spring Boot, Angular, Redis, and WebSocket, it ensures scalable, efficient, and intelligent workshop management with integrated AI chatbot support.

Topics

Resources

Stars

Watchers

Forks