ServiCore — SaaS
Maintenance Center
A comprehensive web application designed specifically for managing home appliance service centers. The system acts as a digital bridge between the call center team that receives customer complaints, the employees who distribute these complaints, and the field technicians who execute maintenance work — all through a single easy-to-use interface.
Project Overview
ServiCore is a comprehensive multi-tenant web application designed specifically for managing home appliance service centers. The system acts as a digital bridge between the call center team that receives customer complaints, the employees who distribute these complaints, and the field technicians who execute maintenance work — all through a single easy-to-use interface.
What Makes It Special
How the System Works
The workflow flows through sequential and interconnected stages, creating a seamless experience from customer complaint to resolution
Complaint & Job Registration
The call center team registers complaints from customers, entering device models, client info, and problem descriptions for Samsung and Beko appliances.
Multi-Tenant DB Routing
FastAPI middleware intercepts the X-Tenant-ID header to dynamically direct request connections to isolated tenant MariaDB schemas in real-time.
Parts State Machine
Tracks spare parts states (In-Stock, Dispatched, Returned, Lost) linked to specific jobs to eliminate inventory leakages during field maintenance.
WhatsApp Dispatcher
Sends automated notifications and receipts via WhatsApp API directly to technicians and customers, simplifying communication and updating status.
Treasury Settlements
Enforces cash reconciliation workflows (settlement date checks) for visit/repair fees collected by technicians before job closure.
Audit & Security Logs
Records every employee interaction (creating jobs, modifying states, updating stock) in a central System Activity audit log to prevent internal fraud.
Powerful Capabilities
Advanced features that make ServiCore a comprehensive solution for maintenance center management
Multi-Tenant Isolation
Dynamic database tenant pooling ensuring absolute customer and data isolation
Maintenance Lifecycle
Log and monitor Beko/Samsung appliance jobs from registration to technical closure
WhatsApp Notifications
Automate status updates and technician schedules through WhatsApp integration
Parts State Machine
Enforce strict parts operations tracking (dispatched, returned, or lost)
Treasury Settlements
Verify cash-on-hand collections and compute dynamic technician commissions
Audit Trails & Security
Audit employee operations via SystemActivity logs and prevent brute force attacks
Modern Tech Stack
Built with cutting-edge technologies and best practices for scalability, performance, and maintainability
Frontend
Next.js 16
React Framework with App Router for server-rendered page loading
React 19
Building interactive, performant SPA components
Material-UI (MUI)
Polished design system with RTL Arabic layout support
TanStack Table
Advanced data grid display for customer lists and jobs
Context API
Centralized state management (Auth, Snackbar, App Data)
Axios (Central Client)
Centralized API client for secure backend communication
Framer Motion
Fluid layout transitions and hover micro-animations
Backend
FastAPI (Python)
High-performance API framework with automated OpenAPI docs
SQLAlchemy ORM
Relational database mapping and dynamic session pools
Alembic
Database migration management for continuous schema updates
MariaDB / MySQL
Robust transactional database for multi-tenant data storage
Pydantic v2
Rigorous data validation schemas
JWT Session Security
Role-based token authentication (Admin, Super Admin, Tech)
SystemActivity Logs
Audit trail logic tracking all employee actions
LoginAttempts Defender
Protective brute force account lock middleware
Infrastructure & Tools
Docker & Compose
Isolated containers for database, frontend, and backend
Nginx Reverse Proxy
SSL termination and dynamic subdomain routing
Dynamic Connection Pools
Dynamically scaling DB connection pool sizes per tenant
Scalable Architecture
Built with a clean layered architecture that ensures maintainability, scalability, and clear separation of concerns
Interested in a similar project?
Let's discuss how we can build something amazing together. I'm always excited to work on innovative solutions.