PeopleHub Overview
What is PeopleHub?
PeopleHub is a modern, cloud-native Human Resource Management System (HRMS) designed to manage the complete employee lifecycle for enterprise organizations. Built from the ground up on AWS serverless infrastructure, PeopleHub delivers comprehensive HR functionality with unprecedented performance, scalability, and cost efficiency.
Core Purpose
PeopleHub provides a unified platform for managing all aspects of human resources operations, from attracting and onboarding candidates to managing active employees and handling separations. The platform uses a multi-tenant architecture with tenant isolation at the database level, designed to scale to 5,000+ employees per tenant across multiple global locations.
Key Capabilities
Employee Lifecycle Management
PeopleHub covers every stage of the employee journey:
Recruitment & Hiring
- Job requisition and approval workflows
- Candidate tracking and interview management
- Referral program management
- Integration with external ATS systems
Candidate Onboarding
- Isolated, secure onboarding portal
- Personal and employment information collection
- Document upload and verification
- Background verification (BGV) workflows
- Policy acknowledgment and e-signature
- Pre-joining engagement
Employee Management
- Comprehensive employee profiles
- Personal and contact information
- Banking and statutory details
- Education and work history
- Skills and certifications
- Document management
- Organizational hierarchy and reporting structures
Confirmation Management
- Employee confirmation workflows
- Performance evaluation during probation
- Multi-level approval processes
Leave & Attendance
- Leave application and approval
- Policy-based leave entitlements
- Attendance tracking and reporting
- Time-off calendar management
Performance Management
- OKR (Objectives and Key Results) framework
- Performance review cycles
- Goal setting and tracking
- Multi-stage performance evaluation
- Rating scales and assessments
Talent Management
- Skills inventory and profiling
- Internal job demand matching
- Career development tracking
- Training recommendations
Separation & Exit
- Resignation initiation
- Notice period management
- Exit surveys
- Clearance workflows (IT, Admin, Finance, HR)
- Final settlement processing
Supporting Capabilities
- Role-Based Access Control (RBAC): Granular permissions for 38+ actions across modules
- Multi-Tenant Architecture: Tenant-based isolation with support for multiple legal entities per tenant
- Master Data Management: Centralized configuration for departments, designations, locations
- Notification System: Automated email notifications for all workflows
- Document Management: Secure document storage with AWS S3
- E-Signature Integration: Digital signature workflows via Digio
- Support Ticketing: Internal helpdesk for employee queries
- Audit Trails: Complete audit logging for compliance
- Reports & Analytics: Dashboard insights and custom reporting
Platform Architecture
High-Level Design
PeopleHub is built on a serverless microservices architecture:
Architectural Principles
- Serverless First: No servers to manage, infinite scalability, pay-per-use pricing
- Microservices: Independently deployable services with clear domain boundaries
- API-Driven: RESTful APIs for all operations, enabling integrations
- Security Isolation: Candidate onboarding isolated from main system for security
- Type Safety: End-to-end TypeScript for reliability
- Cloud-Native: Built for AWS from day one, leveraging managed services
Technology Foundation
Modern Stack
- Frontend: React 19, TypeScript 5.8, Vite 7, TanStack Router/Query
- Backend: Node.js 22, Fastify 5, Drizzle ORM
- Database: PostgreSQL 17.5 on AWS RDS Multi-AZ
- Infrastructure: AWS Lambda, API Gateway, S3, CloudFront, SES
- Deployment: Serverless Framework 4, GitHub Actions CI/CD
Why These Technologies?
PostgreSQL: The most advanced open-source relational database
- Superior performance for complex queries vs MySQL
- Advanced features: JSONB, full-text search, window functions
- ACID compliance, data integrity
- Extensible and standards-compliant
Serverless Architecture: Modern cloud-native approach
- 85-90% cost reduction vs traditional servers
- Infinite scalability, AWS-managed
- No infrastructure management overhead
- Sub-second response times globally
TypeScript: Type safety across the stack
- Catch errors at compile time, not runtime
- Better developer experience with autocomplete
- Self-documenting code
- Easier refactoring and maintenance
See Technology Stack for complete details.
Design Philosophy
Performance First
PeopleHub is designed to be the fastest HRMS platform ever built:
- Global CDN: CloudFront edge locations deliver <50ms latency worldwide
- Optimized Lambdas: 1.5MB packages with <500ms cold starts
- Efficient Queries: Drizzle ORM generates optimized SQL
- Frontend Performance: Vite for instant HMR, code splitting for fast loads
- Caching Strategy: Smart caching at CDN, API, and database levels
Security by Design
Security is embedded at every layer:
- JWT Authentication: Secure token-based auth with refresh tokens
- RBAC: Granular permissions for every action
- Encryption: Data encrypted at rest (AWS KMS) and in transit (TLS 1.3)
- Secrets Management: AWS Secrets Manager for credentials
- Audit Logging: Complete audit trail for compliance
- PII Protection: Field-level encryption for sensitive data
- Compliance Ready: GDPR, DPDP Act compliant architecture
See Security Overview for details.
Developer Experience
Built for maintainability and velocity:
- Type Safety: TypeScript catches errors before runtime
- API Documentation: Auto-generated API docs at /docs endpoints
- Code Quality: ESLint, Prettier, pre-commit hooks
- Fast Feedback: Hot module replacement, instant dev server
- CI/CD: Automated testing and deployment
- Monorepo Structure: Clear separation of concerns
Target Use Cases
PeopleHub is optimized for:
Enterprise HR Operations
- Organizations with 10,000+ employees
- Multi-location companies (domestic and international)
- Complex organizational hierarchies
- Multiple legal entities under single group
Key Workflows
- High-volume hiring (100+ hires per month)
- Structured onboarding with compliance requirements
- Performance management with OKR frameworks
- Talent mobility and internal job postings
- Complex leave policies and attendance tracking
Deployment Model
Multi-Tenant Architecture
PeopleHub uses a multi-tenant architecture with tenant-level data isolation:
- Shared Infrastructure: Cost-efficient shared AWS resources across all tenants
- Tenant Isolation: Database-level separation with tenant_id on all tables
- Per-Tenant Configuration: Customizable workflows and business rules per tenant
- Data Sovereignty: Tenants defined in database with strict access controls
- Scalable Model: Support multiple enterprise clients on single infrastructure
Environment Strategy
Three isolated environments for safe development and deployment:
- Development: Active development, frequent deployments
- Staging: Pre-production testing, QA validation
- Production: Live system serving end users
See Environments for configuration details.
Success Metrics
PeopleHub delivers measurable improvements:
Performance Metrics
- API Latency: <200ms p95 for all endpoints
- Page Load Time: <2 seconds for initial load
- Global Access: <50ms latency from any CloudFront edge location
- Availability: 99.99% uptime SLA
Cost Efficiency
- Infrastructure Cost: 85-90% lower than traditional VM-based deployments
- Development Cost: 30% reduction in development time with modern stack
- Operational Cost: Zero server management overhead
Scalability
- User Capacity: Support for 10,000+ concurrent users
- Data Volume: Handle millions of records without performance degradation
- Request Throughput: 1000+ requests per second per Lambda function
- Growth Ready: Scale from 100 to 10,000 employees without re-architecture
Documentation Overview
This documentation provides comprehensive technical details for:
- Architects: System design, architecture decisions, scalability approach
- Developers: Technology stack, API references, code patterns
- DevOps: Infrastructure, deployment, monitoring, disaster recovery
- Security: Security architecture, compliance, data protection
- Business Stakeholders: Capabilities, workflows, roadmap
Navigation Guide
Start with these key documents:
- Architecture Philosophy - Why we built it this way
- Technology Stack - Complete technology inventory
- System Overview - How components fit together
- Security Overview - Security approach and compliance
Next Steps
- Explore Architecture Philosophy to understand design decisions
- Review System Architecture for technical diagrams
- Learn about Individual Services in detail
- Understand Security Model and compliance
Questions or clarifications? This documentation is maintained for technical review and handoff to the client's technical team.