The Workforce Intelligence & Execution OS is an internal workforce operations platform built by Paramount Intelligence to capture employee work activity, govern project and task execution, and surface operational data as actionable performance and workload insights. This page covers the platform’s product vision, core modules, supported roles, technology stack, and current maturity state.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Paramount-Intelligence/HR_Monitoring_System/llms.txt
Use this file to discover all available pages before exploring further.
Product Vision
This platform is not a surveillance tool or a simple timesheet system. It is a work execution intelligence layer built on a Task-First philosophy: while raw hours are captured, productivity is measured through complexity-adjusted output and consistency. All operational exceptions — missing checkouts, overdue tasks, unapproved leaves — are surfaced via automated email alerts, minimising dashboard fatigue and keeping teams focused on execution rather than monitoring.The system operates in the Asia/Karachi (PKT) timezone by default for shift windows, roster management, and end-of-day processing. This is configurable via the
BUSINESS_TIMEZONE environment variable.Core Modules
The platform is organised into eight interconnected modules that together cover the full employee work lifecycle:| Module | Description |
|---|---|
| Attendance & Work Sessions | Structured check-in/check-out with PKT timezone support and automatic session classification (Full Day, Half Day, etc.) |
| Break Tracking | Paid break management (Dinner, Prayer, and others) integrated directly into attendance sessions |
| Project Governance | Employee-initiated project requests with manager-based approval workflows |
| Task Management | Full task lifecycle — Created → In Progress → Completed — with complexity scoring |
| Leave & WFH Management | Atomic submission and approval flow for leaves, work-from-home, and half-day requests |
| Time Tracking | Real-time timer and manual logging for task-specific duration tracking |
| Analytics Dashboards | Role-specific dashboards (Admin, Manager, Employee) with KPI cards and trend charts |
| Alerts & Audit Logs | Automated email alerts for exceptions and detailed audit trails for governance |
Supported Roles
The platform uses a six-tier role model, with each role providing a scoped view of the system:Admin
Full system control and organisation-wide visibility across all modules, users, and configuration.
HR / Operations
User management, report generation, and organisation configuration. No system-level control.
Manager
Team oversight, project and leave approvals, workload balancing, and team-level analytics.
Team Lead
A subset of Manager permissions scoped to a specific team or workstream.
Employee
Daily work execution — attendance clock-in/out, task logging, leave requests, and time tracking.
Intern / Junior Employee
Specialised roles with scoped activity, reduced permissions, and guided workflows.
Technology Stack
The platform is delivered as a monorepo with three independently deployable applications:| Layer | Technology |
|---|---|
| Frontend | Next.js 15, TypeScript, Tailwind CSS, Shadcn UI, Recharts |
| Backend API | FastAPI 0.115, Pydantic v2, Python 3.10+ |
| Database | SQLite (development) / PostgreSQL (production) |
| ORM & Migrations | SQLAlchemy 2.0, Alembic |
| Task Queue | Celery 5.4 with Redis |
| Authentication | JWT — short-lived access tokens (15 min) + refresh tokens (7 days) |
| Background Jobs | Async Celery workers for alerts and report generation |
The backend is fully compatible with PostgreSQL for production deployments. PostgreSQL databases must use UTF-8 encoding to support emoji and unicode in messages. SQLite is used by default for local development with zero setup required.
Current Maturity Level
The platform is currently in Beta / Production Pilot Ready state.Implemented
Core authentication, attendance tracking, project and task flows, leave management, basic analytics, and admin bootstrapping are complete and stable.
Evolving
Advanced reporting, predictive AI insights, and cross-module anomaly detection are actively under development.
Planned
Full mobile-responsive optimisation and deeper integration with external communication tools beyond current email-only alerts.
Online Presence
Real-time user online/offline status via configurable heartbeat TTL (
ONLINE_PRESENCE_TTL_SECONDS, default 90s).Explore the Platform
Quickstart
Get the full stack running locally in minutes — backend, frontend, and worker.
System Architecture
Understand how the FastAPI backend, Next.js frontend, and Celery workers connect.
Roles & Permissions
Deep dive into the six-tier role model and what each role can access.
API Overview
Explore the RESTful API endpoints powering every platform module.