Skip to content

README.md

Latest commit

 

History

History
106 lines (80 loc) · 3.62 KB

README.md

File metadata and controls

106 lines (80 loc) · 3.62 KB

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