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