🏢 OmniFlow SmartHR — Enterprise Multi-Tenant SaaS

A flagship Enterprise-Grade HR platform showcasing 5+ years of Senior Full-Stack Engineering.

Live Demo · Backend API Docs · Architecture

---

🎯 Project Overview

SmartHR Enterprise is a production-grade, Multi-Tenant SaaS Human Resource management system demonstrating advanced architectural patterns that separate Senior Engineers from mid-level developers:

Feature	Technology	Complexity
Multi-Tenancy	EF Core Global Query Filters	🔴 Expert
Real-time Sync	ASP.NET Core SignalR	🔴 Expert
Background Jobs	Hangfire + PostgreSQL	🟠 Advanced
JWT Authentication	Role-Based Access Control	🟠 Advanced
Cloud Database	Neon PostgreSQL	🟡 Intermediate
Enterprise Frontend	Angular 17 + RxJS Subjects	🟠 Advanced

---

🏗 System Architecture

┌─────────────────────────────────────────────────────────┐
│                    FRONTEND (Angular 17)                 │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
│  │  AuthService │  │SignalRService│  │  Dashboard   │  │
│  │  (JWT/Tenant)│  │  (WebSocket) │  │  Component   │  │
│  └──────────────┘  └──────────────┘  └──────────────┘  │
└─────────────────────────┬───────────────────────────────┘
                          │ HTTP / WebSocket
┌─────────────────────────▼───────────────────────────────┐
│                 BACKEND (ASP.NET Core 9)                 │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
│  │  JWT Auth    │  │  SignalR Hub │  │   Hangfire   │  │
│  │  + RBAC      │  │ /attendance  │  │   Workers    │  │
│  └──────────────┘  └──────────────┘  └──────────────┘  │
│  ┌──────────────────────────────────────────────────┐   │
│  │         EF Core + Multi-Tenant DbContext         │   │
│  │     Global Query Filter → TenantId Isolation     │   │
│  └──────────────────────────────────────────────────┘   │
└─────────────────────────┬───────────────────────────────┘
                          │
┌─────────────────────────▼───────────────────────────────┐
│              Neon PostgreSQL (Cloud)                      │
│  Tables: Tenants | Users | Employees | AttendanceRecords │
└──────────────────────────────────────────────────────────┘

---

✨ Key Engineering Highlights

🔐 Multi-Tenant Architecture

Every database query automatically scopes data to the current tenant using EF Core Global Query Filters — data leakage between organizations is impossible at the ORM layer.

// SmartHRDbContext.cs — Multi-Tenant Global Query Filters
modelBuilder.Entity<Employee>().HasQueryFilter(e => e.TenantId == CurrentTenantId);
modelBuilder.Entity<AttendanceRecord>().HasQueryFilter(e => e.TenantId == CurrentTenantId);

⚡ Real-Time Sync via SignalR

When an employee checks in, ALL connected manager dashboards update instantly via WebSockets — no page refresh, no polling.

// AttendanceHub.cs — Broadcasting real-time events
public async Task CheckInPulse(int employeeId, string time)
{
    await Clients.All.SendAsync("ReceiveCheckIn", employeeId, time);
}

// Angular SignalR subscription
this.signalR.attendanceUpdates.subscribe(update => {
  const emp = this.employees.find(e => e.id === update.employeeId);
  emp.status = 'Online'; // UI instantly reflects check-in
});

🔄 Background Processing via Hangfire

Heavy operations like Mass Payroll Export are queued via Hangfire so the API never blocks:

// Hangfire processes jobs asynchronously in the background
builder.Services.AddHangfire(config => config
    .UsePostgreSqlStorage(c => c.UseNpgsqlConnection(connectionString)));

---

🛠 Tech Stack

Backend

ASP.NET Core 9.0       → REST API Framework
Entity Framework Core  → ORM + Migrations
Npgsql                 → PostgreSQL Provider
SignalR                → Real-time WebSockets
Hangfire               → Background Job Processing
JWT Bearer             → Authentication

Frontend

Angular 17             → UI Framework
@microsoft/signalr     → WebSocket Client
RxJS Subject           → Live Event Stream
Glassmorphism CSS      → Premium UI Design
Inter (Google Fonts)   → Typography

Infrastructure

Neon PostgreSQL        → Cloud Database
XAMPP / localhost      → Local Development
Vercel                 → Frontend Deployment (planned)
Render.com             → Backend Deployment (planned)

---

🚀 Getting Started

Prerequisites

• .NET 9 SDK
• Node.js 18+
• Angular CLI (npm install -g @angular/cli)

1. Clone the Repository

git clone https://github.com/Mo14745646/SmartHR.git
cd SmartHR

2. Start the Backend API

cd backend
# Update connection string in appsettings.json with your PostgreSQL credentials
dotnet run
# API runs on: http://localhost:5086
# Swagger UI: http://localhost:5086/swagger
# Hangfire Dashboard: http://localhost:5086/hangfire

3. Start the Frontend

cd ..  # back to SmartHR root
npm install
npx ng serve --port 4400
# App runs on: http://localhost:4400

4. Login

Username: muath
Password: muath123

---

📁 Project Structure

SmartHR/
├── src/
│   └── app/
│       ├── services/
│       │   ├── auth.service.ts       ← JWT + Tenant management
│       │   └── signalr.service.ts    ← Real-time WebSocket client
│       ├── app.component.ts          ← Main dashboard logic
│       ├── app.component.html        ← Enterprise UI template
│       └── app.component.css         ← Glassmorphism styling
└── backend/
    ├── Program.cs                    ← API startup + DI configuration
    ├── appsettings.json              ← JWT + DB configuration
    ├── Data/
    │   └── SmartHRDbContext.cs       ← Multi-tenant EF Core context
    ├── Models/
    │   ├── Tenant.cs
    │   ├── User.cs
    │   ├── Employee.cs
    │   └── AttendanceRecord.cs
    ├── Hubs/
    │   └── AttendanceHub.cs          ← SignalR WebSocket hub
    └── Migrations/                   ← EF Core database migrations

---

🔒 Security Features

• JWT Bearer Authentication — All protected endpoints require valid tokens
• Role-Based Access Control — Tenant Admins vs Managers vs Employees
• CORS with Credentials — Properly configured for WebSocket connections
• Tenant Data Isolation — Global Query Filters prevent cross-tenant access

---

👤 Author

Muath Salem — Senior Full Stack Engineer
5+ Years building enterprise SaaS solutions with .NET, Angular, and PostgreSQL.

---

_{Built with ❤️ to demonstrate Enterprise-Grade Engineering Excellence}