1. Introduction

About WorkPulse

WorkPulse is an employee activity monitoring software designed to help organizations track and understand how their employees spend their working hours. It provides real-time insights into application usage, website visits, idle time, and overall productivity patterns.

Unlike cloud-based solutions that require monthly subscriptions and store data on external servers, WorkPulse operates entirely on your local network. All employee data stays within your organization, ensuring complete privacy and compliance with data protection regulations.

Key Objectives

1. Increase workplace productivity by providing visibility into how time is spent
2. Help managers identify bottlenecks and inefficiencies in work processes
3. Detect unusual work patterns that may indicate security risks or employee burnout
4. Generate automated reports to track productivity trends over time
5. Maintain employee privacy while collecting necessary productivity metrics

Target Users

WorkPulse is designed for:

2. Problem Statement

Organizations face several challenges when it comes to understanding and improving employee productivity:

WorkPulse addresses all these challenges with on-premise solution that provides comprehensive monitoring without data privacy concerns.

3. System Requirements

Server Computer Requirements

The server runs the central database and dashboard. One computer in your office acts as the server.

Note: The server computer can be any existing desktop or laptop. It does not need to be a dedicated machine.

Employee Computer Requirements

These are the computers where employees work. The monitoring software runs invisibly in the background.

Important: Employees do NOT need to install Python or any additional software. The deployment process is completely invisible to them.

Dashboard Computer Requirements

The dashboard is where managers view reports and analytics. This can be the same computer as the server.

PYTHON DEPENDENCIES LIST

For Server (Main System)

flask — Web server framework for REST API

flask-cors — Enables cross-origin requests for dashboard

flask-sqlalchemy — Database ORM (Object Relational Mapper)

sqlalchemy — Database toolkit and ORM

requests — HTTP library for API communication

reportlab — PDF report generation

pandas — Data analysis and Excel export

openpyxl — Excel file (.xlsx) creation and editing

pillow — Image processing for screenshots

apscheduler — Scheduled tasks (weekly reports, ML detection)

scikit-learn — Machine learning (Isolation Forest anomaly detection)

numpy — Numerical computing (required by scikit-learn)

For Dashboard (PyQt5 GUI)

PyQt5 — Desktop GUI framework for the dashboard application

matplotlib — Charts and graphs (embedded in Qt widgets)

For Client Agent (Staff PC Monitoring)

psutil — System monitoring (processes, CPU, RAM, network bandwidth)

pynput — Keyboard and mouse activity detection (counts only, no content)

pillow — Screenshot capture and compression

watchdog — File system event monitoring (create/modify/delete/rename)

cryptography — Encryption for offline buffer files

requests — HTTP client to send data to server

SYSTEM-LEVEL REQUIREMENTS

Python Version:

Minimum: Python 3.9

Recommended: Python 3.11 or 3.12

Not compatible with Python 2.x

Operating System:

Windows 10 or Windows 11 (64-bit)

Linux support: Partial (server only, client agent is Windows-specific)

macOS support: Server and dashboard only (client agent requires Windows)

Storage for Dependencies:

Approximately 500 MB total for all packages and their dependencies

Server requires ~300 MB

Client requires ~150 MB

Dashboard requires ~200 MB (overlaps with server if on same machine)

4. Key Features of Application

Real-Time Activity Monitoring

WorkPulse continuously tracks what applications employees use, which websites they visit, and when they are idle or active.

1. Captures the active window title every 5 seconds
2. Records which programs are being used (Excel, Chrome, Tally, etc.)
3. Extracts browsing history from Chrome, Edge, and Firefox browsers
4. Detects when keyboard and mouse are inactive for more than 3 minutes

Productivity Scoring

The system automatically categorizes applications and websites as Productive, Unproductive, or Neutral, then calculates a productivity score for each employee.

1. Productive: Work applications like Excel, Tally, Word, SAP
2. Unproductive: Social media, games, streaming websites
3. Neutral: Email, file browsers, communication tools
4. Score = (Productive Time ÷ Total Active Time) × 100

Detailed Analytics Dashboard

A visual dashboard with 8 tabs provides complete visibility into employee activity:

Machine Learning Anomaly Detection

WorkPulse uses artificial intelligence to learn each employee's normal work patterns and automatically flag unusual behavior:

1. Logging in at unusual hours (e.g., 3 AM when they normally work 9-6)
2. Using applications they've never used before
3. Downloading 10 times more data than their usual pattern
4. Sudden changes in keyboard activity or idle time

These alerts help managers spot potential security issues, employee burnout, or urgent situations requiring attention.

Automated Weekly Reports

Every Monday morning, WorkPulse automatically generates a professional PDF report containing:

1. Executive summary with overall productivity trends
2. Top 10 applications and websites by time spent
3. Employee ranking by productivity score
4. All alerts and anomalies flagged during the week
5. Charts and graphs showing activity patterns

These reports can be saved, printed, or emailed to management automatically.

File Access Auditing

Track every file that employees create, modify, delete, or rename on both local computers and network shared drives:

1. See who deleted an important client file and when
2. Track document modifications with timestamps
3. Monitor access to sensitive folders on the network
4. Get alerts when files are moved or renamed

This feature is particularly valuable for detecting accidental deletions or unauthorized access to confidential files.

Offline Data Collection

Even if the server is turned off or the network is down, employee computers continue collecting data. When connection is restored, all buffered data is automatically sent to the server. No data is lost due to temporary network issues.

Privacy-Safe Design

WorkPulse is designed with employee privacy in mind:

1. Counts keystrokes but NEVER records what was typed (passwords stay private)
2. Screenshots can be disabled or limited to work hours only
3. Monitors only work-owned computers during work hours
4. All data stays on your local network (never sent to cloud servers)
5. Employees are informed about monitoring through a signed IT policy

5. Benefits

For Employers and Managers

For Employees

For Organizations

6. Conclusion

WorkPulse represents a modern, affordable solution to the age-old challenge of understanding workforce productivity. By combining real-time monitoring, machine learning intelligence, and comprehensive reporting, it gives organizations the insights they need to improve efficiency while respecting employee privacy.

Key Takeaways:

1. Complete visibility into how employees spend their working hours
2. All data stays on your local network for maximum privacy and security
3. Easy deployment requiring no technical expertise
4. Typical return on investment achieved within 6 months
5. Suitable for organizations of all sizes from 5 to 500 employees

For businesses concerned about transparency and ethics, WorkPulse includes a template IT Usage Policy that can be signed by employees, ensuring full legal compliance with India's Digital Personal Data Protection Act 2023. The system is designed to balance employer oversight needs with employee privacy rights.