Reza Salmanian

Command Palette

Search for a command to run...

All projectsHR · Payroll · Compliance

HR & Payroll

Compliance-Ready HR & Payroll Platform

An HR and payroll module designed around audit and compliance requirements from day one, with an AI assistant to help HR teams handle routine employee questions.

Timeline

  1. Phase 1

    Compliance architecture

    Designed audit logging and access model

  2. Phase 2

    Employee & payroll core

    Built employee management and payroll processing

  3. Phase 3

    Approvals

    Shipped configurable multi-step approval workflows

  4. Phase 4

    AI assistant

    Added scoped AI HR assistant for routine questions

Executive Summary

An HR and payroll platform covering employee records, payroll runs, leave management, and multi-step approvals, architected around audit logging and compliance requirements rather than adding them after the fact.

Business Problem

Payroll and HR data carry legal and financial consequences that most internal tools aren't built to handle — every change needs a defensible audit trail, and approval workflows need to reflect real organizational policy, not a generic status field. Businesses often outgrow spreadsheet-based HR processes long before they can justify a full enterprise HR suite.

Project Goals

  • Build employee management and payroll on an architecture that treats audit logging as a core requirement, not an add-on
  • Support configurable, multi-step approval workflows (leave, payroll exceptions) that mirror real company policy
  • Give HR teams an AI assistant for routine questions without exposing sensitive employee data beyond its authorized scope
  • Keep payroll processing correct and traceable across pay periods

Solution Overview

Every write to employee, payroll, or leave records passes through an audit-logging layer that captures who changed what and why. Approval workflows are modeled as configurable multi-step processes rather than a single status field, and an AI HR assistant answers common employee questions against a permission-scoped subset of HR data.

Architecture Decisions

  • Built audit logging as a cross-cutting concern applied to every write path, rather than a feature added to individual screens
  • Modeled approvals as a configurable workflow engine so different companies' policies (number of approval steps, who can approve what) don't require code changes
  • Scoped the AI HR assistant's data access explicitly narrower than a human HR admin's, since its answers are self-service and need a tighter blast radius

Screenshots

Employee record view

Illustrative — not an actual screen

Payroll run summary

Illustrative — not an actual screen

Approval workflow configuration

Illustrative — not an actual screen

Architecture Diagram

HR & Payroll compliance architecture

Employee & payroll core data
Cross-cutting audit logging layer
Configurable approval workflow engine
Scoped AI HR assistant (read-only)

Technical Challenges

  • Designing an audit trail detailed enough to satisfy compliance review without slowing down every write operation
  • Making the approval workflow engine flexible enough for different company policies without becoming impossible to reason about
  • Defining what an AI assistant should and shouldn't be allowed to answer about payroll and personal employee data

Engineering Decisions

  • Treated compliance and audit logging as launch-blocking requirements rather than a fast-follow, given the legal exposure of getting payroll wrong
  • Kept the AI HR assistant read-only against a narrowly scoped data view, with no ability to modify payroll or employee records

My Responsibilities

  • Designed the audit logging architecture applied across employee, payroll, and leave data
  • Built the configurable multi-step approval workflow engine
  • Defined the access-scoping model for the AI HR assistant

Technology Stack

TypeScriptReactNext.jsNode.jsPostgreSQLFirebaseGoogle Cloud PlatformOpenAI API

Results

  • Delivered a payroll and HR system with a full audit trail from day one, ahead of compliance review
  • Replaced spreadsheet-based leave and approval tracking with a configurable workflow
  • Reduced routine HR question volume to human staff via the scoped AI assistant

Lessons Learned

  • Building compliance and audit logging in from the start was significantly cheaper than the alternative of retrofitting it once payroll data already existed in production
  • An AI assistant over sensitive HR data needs its access model designed before its conversational behavior — the scoping question comes first

Next project

Vendor & Inventory

Continue