Secure Kill ERP System

Home Contact

[Project]

ByVidhura Neethika

CategoryWeb

Secure Kill ERP System is an enterprise resource planning and human resource management platform designed for pest control, field service, safety, and security organizations. The ecosystem integrates five dedicated web and backend applications: an Admin Operations Frontend for central enterprise administration, an Admin Backend API Gateway for core business logic and database management, an Employee Field Application tailored for mobile ground technicians, an Employee Backend API Gateway optimizing field mobile data synchronization, and an HRM Suite dedicated to workforce management and statutory payroll. Together, these applications streamline lead acquisition, site inspections, quotation generation, job execution, warranty claims, multi-warehouse inventory, employee rostering, and statutory payroll.

Problem Statement

Field service and security enterprises face significant operational hurdles due to fragmented systems and manual processes. Paper-based site inspection forms cause delayed client reporting, field technicians lack real-time visibility into assigned job pools, proof of work photos are lost or unorganized, inventory usage during field tasks is difficult to reconcile against stock levels, and manual payroll calculations involving complex local labor laws, shift allowances, and statutory contributions often lead to financial errors and administrative burden.

Admin Operations Frontend Application

The Admin Operations Frontend Application is built with NextJS and Tailwind CSS to serve as the control center for operational managers and executive leadership. It provides real-time dashboards for monitoring field job statuses, lead pipelines, client relationships, and inventory movement across multiple warehouses. Operations managers use this web application to create technical service packages, construct detailed client quotations with embedded image templates, dispatch field technicians to site inspection pools, track real-time travel timelines, issue warranties, handle rework claims, and generate digital invoices.

Admin Backend API Gateway

The Admin Backend API Gateway is a scalable Express server built with TypeScript, Prisma ORM, and PostgreSQL. It acts as the backbone for central administrative workflows, handling multi-tenant data isolation, role-based access control, security middleware, JWT authentication, and structured validation using Zod. The gateway exposes RESTful APIs documented through TSOA and Swagger, handles automated PDF generation for invoices and reports, and manages asynchronous operations for email notifications and accounting synchronizations.

Employee Field Application

The Employee Field Application is a responsive mobile-first web interface designed for ground technicians, site inspectors, and field workers. Optimized for handheld devices, it allows field personnel to view assigned task pools, check job schedules, clock in using geofenced location validation, record site inspection findings, capture touchscreen digital signatures from clients, upload proof of work photos, request shift swaps, submit leave applications, track earned performance encouragement points, and access digital payslips.

Employee Backend API Gateway

The Employee Backend API Gateway is a high-performance Express server specifically tuned for mobile interactions and field data synchronization. It manages employee authentication, location-based geofence checks, task pool availability, signature file storage, and offline data sync through dedicated operation logs with SHA-256 payload hashing. This architecture ensures that field technicians can capture critical site data even when working in areas with intermittent internet connectivity.

Human Resource Management and Payroll Suite

The Human Resource Management and Payroll Suite is a NextJS enterprise application equipped with Orval API client code generation. It handles the complete employee lifecycle, including organizational department structures, identity document verification for national identity cards, passports, and driving licenses, multi-shift roster scheduling, overnight shift configurations, and multi-tier leave approval workflows. The platform includes a Sri Lankan statutory payroll engine that automates employee and employer EPF contributions, ETF payments, APIT tax tier calculations, Benefit in Kind deductions, overtime multipliers for regular hours, Sundays, and public holidays, loan installment deductions, and General Ledger accounting mapping.

Field Operations and Service Lifecycle Engine

The service lifecycle engine coordinates field tasks from initial customer inquiry to post-service warranty support. When a lead is recorded, the system schedules an on-site technical inspection. Technicians use their mobile app to fill out inspection forms, attach photos, and capture client signatures. Upon inspection completion, the system automatically generates a PDF report and allows managers to build client quotations with itemized service components. Once approved, quotations convert into active jobs with assigned technician pools, real-time journey timelines, stock reservations, digital invoices, and automated completion emails.

Multi-Warehouse Inventory, Procurement, and Financial Ledger

The inventory and finance system manages stock levels across multiple warehouse locations, automatically issuing low-stock alerts when items fall below predefined reorder thresholds. It links product variants, attributes, and bundle items directly to field service jobs, enabling stock reservations prior to technician dispatch. The procurement module handles purchase orders, goods received notes, goods return records, and supplier ledger tracking, while the financial ledger maintains complete income and expense records, customer payments, scheduled transactions, and double-entry accounting sync with Zoho Books.

Performance Encouragement Points and Incentive Ledger

To motivate field staff and maintain high service standards, the platform includes a gamified performance encouragement point ledger system. Ground technicians earn points based on completed site inspections, timely job executions, and emergency service calls. The system tracks points awarded per employee, calculates participant distributions for team jobs, and automatically converts accumulated points into monetary bonuses included in the monthly statutory payroll calculation.

Technical Challenges and Architectural Solutions

Engineering the Secure Kill ERP System required solving complex multi-application challenges. Type safety across frontend applications and backend gateways was achieved by generating custom React hooks and API clients from OpenAPI specs using Orval. High database concurrency and multi-tenancy were managed through Prisma ORM across seventy-five enterprise data models. Offline data resilience for field technicians was solved using an operation sync log system with payload hashing and automatic conflict resolution. Data privacy and compliance were secured through HTTP-only authentication cookies, encrypted email logs, and encrypted bank detail storage.

Users & Characteristics

Executive Management and Super AdminsExecutive managers and super administrators configure company-wide settings, manage multi-tenant branch access, establish global human resource policies, review system audit logs, analyze payroll variance reports, oversee accounting integrations with Zoho Books, and manage mail server configurations.

Operations Managers and Field SupervisorsOperations managers and field supervisors handle customer leads, assign technicians to inspection pools, construct client quotations, monitor real-time travel timelines of field teams, review technician photo evidence, issue warranties, dispatch rework jobs, and manage client invoicing.

Human Resource and Payroll AdministratorsHuman resource and payroll administrators oversee employee onboarding, verify identity documents such as national identity cards and passports, design shift rosters, manage overnight shift assignments, review multi-level leave applications, execute monthly statutory payroll runs, and distribute digital payslips.

Field Technicians and Ground InspectorsField technicians and ground inspectors use the mobile field portal to view task pools, log geofenced attendance clock-ins, record technical site inspections, collect touchscreen client signatures, upload proof of work images, request shift swaps with colleagues, view performance points, and download monthly payslips.

Corporate and Residential ClientsCorporate and residential clients review and approve online service quotations, sign technical inspection reports directly on field technician devices, track scheduled service appointments, view job completion records, and receive automated email documentation.

Process of the Project

01
Domain Analysis and Architectural Blueprinting
Conducted extensive domain research into pest control, safety, and security operations to map business workflows from initial customer inquiry to statutory payroll accounting. Designed a decoupled five-application architecture separating administrative, employee field, and human resource concerns into focused micro-frontend and backend services.
02
Multi-Tenant Schema and Database Engineering
Engineered a multi-tenant PostgreSQL database schema using Prisma ORM containing seventy-five relational entities. Modeled complex structures for role-based access control, organizational hierarchies, field job travel timelines, multi-warehouse inventory, statutory payroll components, and offline synchronization logs with spatial indexing for geofenced location features.
03
Backend Gateway and API Specification Development
Built Express backend API gateways using TypeScript for both administrative operations and employee field applications. Integrated Zod schema validation, JWT cookie authentication, and TSOA to generate OpenAPI documentation, while implementing background workers for email dispatch, PDF report generation, and accounting synchronization.
04
Frontend UI/UX and Component Architecture
Designed and developed three separate NextJS web applications for administrative control, employee mobile access, and human resource management using Tailwind CSS, Radix UI primitives, and Lucide icons. Implemented responsive layouts, multi-step quotation forms, interactive roster schedules, and real-time dashboard visualization cards.
05
Offline Field Synchronization and Signature Integration
Implemented a resilient offline synchronization system for the employee mobile field application. Built touchscreen canvas signature capture, image compression pipelines for field proof uploads, and a sync operation queue with SHA-256 payload hashing to ensure seamless operation in low connectivity environments.
06
Statutory Payroll Engine Verification and System Testing
Built comprehensive automated test suites using Jest and JUnit to verify complex Sri Lankan statutory payroll calculations, ensuring precise computation of EPF employee and employer contributions, ETF rates, APIT tax brackets, overtime multipliers, and loan repayments.

Key Features

Multi-Tenant Enterprise Architecture

Role-Based Access Control (RBAC)

Central Admin Operations Portal

Admin API Gateway (Prisma & PostgreSQL)

Mobile-Optimized Employee Field App

Field API Gateway with Geofencing & Sync

HRM Suite & Identity Verification

Statutory Payroll Engine (EPF, ETF, APIT)

Digital Touchscreen Signature Capture

Dynamic Quotation Builder & PDF Export

Real-Time Field Job & Travel Tracking

Warranty & Rework Claim Management

Multi-Shift Rostering & Shift Swapping

Geofenced GPS Clock-In & Incident Logging

Multi-Level Leave & Encashment System

Gamified Performance Points & Incentives

Multi-Warehouse Inventory & Stock Alerts

Procurement Engine & Supplier Ledgers

Invoicing, Financial Ledgers & Field Billing

Offline Sync Engine with Payload Hashing

Type-Safe API Generation (Orval & OpenAPI)

Encrypted Email & Automated PDF Generation

Conclusion

The Secure Kill ERP System is an enterprise platform that unifies complex field service operations, site inspections, multi-warehouse inventory, human resource management, and Sri Lankan statutory payroll into a high-performance multi-application suite. Its decoupled architecture, offline field synchronization, touchscreen signature verification, and automated statutory calculations establish an operational foundation for enterprise field organizations.

Technologies and Frameworks

TypeScript

NextJS

React

NodeJS

Express

Prisma ORM

PostgreSQL

Tailwind CSS

Orval

TSOA

OpenAPI

Zod

JWT

Jest

Lucide Icons

Radix UI

Tools

Antigravity IDE

Visual Studio Code

Prisma Studio

GitLab CI CD

Docker

Figma

Swagger UI

Conclusion

Contact Me

Let's build something amazing together

Have an Idea? Let’s Make it Real

I'm currently available for freelance projects and open to full-time opportunities. If you have a project that needs some creative touch, or just want to say hi, feel free to drop a message.

Email Addressvidhuraneethika000@gmail.com

Phone Number+94 76 18 21 354

LocationKurunegala, Sri Lanka

Vidhura