Humzio — Building a Modern Multi-Tenant HR Platform
How Xyphors designed and built Humzio as a secure, scalable HR platform that brings core people operations into one connected SaaS product.
- Client
- Humzio
- Sector
- HR Technology / SaaS
- Practices
- Product Engineering · Software Engineering · SaaS Architecture · Cloud & DevOps · Data Engineering
- Published
Challenge
Humzio was created to solve a common problem for growing businesses: HR operations become fragmented across spreadsheets, manual processes and disconnected tools.
The platform needed to bring people management, leave, time, performance, employee lifecycle workflows, reporting and administration together while securely supporting multiple organizations on shared infrastructure.
The challenge was not only feature delivery. Humzio also needed strict tenant isolation, flexible role-based access, reliable background processing, multilingual experiences, billing and invoicing, secure authentication and a deployment architecture that could grow with the product.
Solution
Xyphors designed Humzio as an API-first, multi-tenant SaaS platform.
The backend uses FastAPI, SQLAlchemy and PostgreSQL. Tenant-aware application logic is reinforced with PostgreSQL Row-Level Security so organization isolation is enforced close to the data layer.
Authorization combines roles, organizational scope, hierarchy and safeguards for sensitive administrative actions. Redis supports background and event-driven workloads, while scheduled workers handle recurring processes.
The frontend provides a modern HR workspace covering people, leave, time, performance, onboarding and offboarding, reporting and administrative workflows. The public marketing application is separated from the authenticated product so each can evolve independently.
Billing was designed as a complete lifecycle with invoice states, idempotent generation, proration, historical snapshots, PDF generation and delivery tracking.
Humzio also supports multilingual experiences through organization-level defaults and user-level locale preferences. Containerized infrastructure and automated CI/CD provide repeatable deployments across staging, demo and production environments.
Outcome
Humzio now has a scalable foundation for delivering a broad set of HR workflows from one platform.
Key outcomes include:
- Strong multi-tenant isolation reinforced at the PostgreSQL database layer.
- Structured RBAC with hierarchy, scope and administrative safety controls.
- Connected workflows across people, leave, time, performance and employee lifecycle management.
- Billing and invoicing with controlled lifecycle states and auditable delivery.
- Multilingual product and marketing experiences.
- Bulk employee import and organization-aware data workflows.
- Automated backend and frontend testing, including security-sensitive scenarios.
- Repeatable Docker-based deployments with health checks, migrations, backups and rollback support.
- Separate staging, demo and production environments.
- Architecture prepared for future independent services, including Humzio AI.
- Stack
- PythonFastAPISQLAlchemyPostgreSQLRedisNext.jsTypeScriptReactDockerGitHub ActionsTraefik
- 01
Foundation & Architecture
Designed the multi-tenant architecture, authentication, tenant boundaries, database model and core application structure. People & HR Operations::Built employee management, organizational structures, leave, time, performance and lifecycle workflows. Security & Access Control::Implemented tenant isolation, PostgreSQL Row-Level Security, RBAC, hierarchy safeguards and session controls. Platform & Automation::Added background workers, scheduling, notifications, bulk imports, reporting and administrative capabilities. Billing & Invoicing::Built invoice generation, lifecycle states, proration, PDFs, delivery tracking and organization-facing billing views. Internationalization::Introduced organization defaults, user locale preferences and multilingual product and marketing experiences. Deployment & Reliability::Established containerized staging, demo and production environments with CI/CD, migrations, health verification, backups and rollback. Product Hardening::Expanded automated testing, improved consistency across workflows and prioritized stability before the next major feature phase.
Recognise any of thisin your own systems?
Describe where you are and what is in the way. We will come back with the two axes we think explain it, and what we would build against them.