We use cookies

PDPL Compliant

We use cookies to enhance your experience on our website. Some are essential for the site to function, while others help us understand how you use the site.

Privacy PolicyLearn More

Sovereign Spotlight

Search across all modules, people, and actions

Critical Compliance Alerts

8
Total Penalty Exposure:
5,249,500 SAR

No Pending Alerts

All regulatory requirements are up to date

3 critical8 pending
عقل

AqlHR

Architecture

Technical Documentation

System Architecture

Technical Infrastructure Overview of the AqlHR Platform

High-Level Architecture

CLIENT LAYER
Web Application
React 19 + TypeScript
Mobile App
React Native (Roadmap)
API Clients
REST / tRPC
SECURITY LAYER
WAF
TLS 1.3
DDoS Protection
Rate Limiting
APPLICATION LAYER
API Gateway
Express + tRPC
AI Engine
LLM + RAG
Job Queue
Background Tasks
Workflow Engine
Approvals & Automation
DATA LAYER
Primary Database
TiDB (MySQL Compatible)
File Storage
S3-Compatible (Saudi DC)
Vector Store
Knowledge Base Index
INTEGRATION LAYER
QiwaGOSIMudadAbsherSehhatyBanks (WPS)

Technology Stack

Frontend
FrameworkReact 19
LanguageTypeScript 5.x
StylingTailwind CSS 4
UI Componentsshadcn/ui
State ManagementTanStack Query
Build ToolVite
Backend
RuntimeNode.js 22 LTS
FrameworkExpress 4
API LayertRPC 11
ORMDrizzle ORM
AuthenticationJWT + OAuth 2.0
TestingVitest
Data & Storage
Primary DatabaseTiDB Serverless
CompatibilityMySQL 8.0
File StorageS3-Compatible
CDNCloudFront
BackupDaily Automated
AI & ML
LLM ProviderOpenAI GPT-4
ArchitectureRAG (Retrieval)
Embeddingstext-embedding-3
VoiceWhisper API
Image GenDALL-E 3

Deployment Model

SaaS (Default)
Multi-tenant cloud deployment
Instant deployment
Automatic updates
Saudi data residency
99.9% SLA
Dedicated Cloud
Single-tenant cloud instance
Isolated environment
Custom configuration
Dedicated resources
Enhanced SLA
On-Premise
Self-hosted deployment
Full data control
Air-gapped option
Custom integrations
Enterprise support

Integration Points

Government Systems

QiwaReady

Contract management, employee records

GOSIReady

Social insurance contributions

MudadReady

Wage protection system

AbsherPlanned

Identity verification, visa services

Enterprise Systems

ERP AReady

ERP integration via API

ERP B HCMReady

Bi-directional sync

Microsoft 365Ready

SSO, calendar, email

Banking (WPS)Ready

Salary file export

Need Technical Details?

Our engineering team can provide detailed architecture reviews, integration specifications, and custom deployment planning.