Ailysi OS — 5-Layer Architecture Blueprint

Unified Operating System · v2.0 · Updated 2026-08-07

Production-Ready

Schema-driven · Manifest-driven · Governance-enforced · Multi-tenant

Layer 1: Architecture Mapping

Platform → OS → Modules → UX Shells

1. Platform Core

Identity & Access

live

Entities

UserTenantInvitationUserSessionUaePassIdentity
  • • Authentication (email/uae_pass)
  • • Role-based access (admin/partner/employer/applicant)
  • • Session management
  • • Invite lifecycle

Tenant Engine

live

Entities

DualPartnerTenantConfigTenantProfileTenantDomainSaaSBranding
  • • Tenant provisioning & lifecycle
  • • Hostname routing (subdomain + custom)
  • • Tenant isolation (RLS)
  • • Branding injection

Marketplace Engine

live

Entities

MarketplaceItemMarketplaceInstallMarketplaceManifestTenantModuleConfig
  • • OS/Module catalog
  • • Install/uninstall lifecycle
  • • Trial monitoring
  • • Governance gating

Global Orchestrator

live

Entities

OrchestratorStateOrchestratorLoopLogPlatformMetricPlatformAlert
  • • Cross-engine orchestration
  • • Loop execution & logging
  • • Self-healing proposals
  • • Platform health monitoring

Branding Engine

live

Entities

SaaSBrandingBrandProfileBrandChangeRequestBrandProfile
  • • White-label theming
  • • Logo/color injection
  • • Brand governance audits
  • • CSS token generation

Integration Hub

live

Entities

UaeIntegrationMCPConnectorLogUaePassAuditLogGovernanceAuditLog
  • • UAE government integrations (MOHRE, GDRFA, FTA)
  • • OAuth connectors (Gmail, Calendar, Slack)
  • • UAE Pass SSO & signing
  • • Webhook routing

2. Vertical OS Engines

Worker OS

live

Entities

TadbeerApplicantApplicantAssessmentWorkerLifecycleSnapshotApplicantMediaProfile

Workflows

Registration Quest → Document Verification → Visa Processing → Deployment → Offboarding

Modules

ProfileEditorDocumentReuploadSalaryMonitoringContractImplementationJourneyMap

AI Agents

gailmatching_agentaiScreeningAgentaiWorkerLifecycleAgent

Governance

stall_detectionexception_state_trackingocr_verification_gates

Employer OS

live

Entities

EmployerProfileEmployerOnboardingEmployerIntegritySnapshotEmployerFlagJobPost

Workflows

Employer Onboarding → KYC Verification → Job Posting → Candidate Selection → Interview Scheduling

Modules

OnboardingWizardHiringWorkflowAnalyticsIntegrityDashboardInterviewSchedule

AI Agents

heeraemployerOnboardingAutomatoremployerIntegrityEngine

Governance

integrity_scoringtrust_tierskyc_gatespledge_enforcement

Partner OS

live

Entities

PartnerAgentCommissionLedgerPartnerGuaranteedReservationPayoutRequestPartnerApplication

Workflows

Partner Registration → Tier Progression → Commission Loop → Payout Processing

Modules

CommissionLoopPanelDeploymentPipelinePartnerHealthSummaryGuaranteedReservations

AI Agents

partnerTieringAutomationautonomousPartnerGovernancepartnerOSAutonomousRulesEngine

Governance

tier_gatesguaranteed_hold_windowssla_breach_trackingreliability_scoring

Compliance OS

live

Entities

UaeComplianceProfileVatReturnCorporateTaxRecordComplianceProfileGccComplianceRecord

Workflows

Country Detection → Compliance Preset → VAT Filing → Corporate Tax Filing → e-Invoice Clearance

Modules

VatModuleCorporateTaxModuleLaborLawModuleESignatureModuleGccComplianceOS

AI Agents

uae_compliance_agentautonomousComplianceFilingEngineautoAdaptingComplianceAgent

Governance

filing_deadlinespenalty_preventioncross_country_routingdocument_integrity

Finance OS

live

Entities

InvoiceFinancialLedgerSubscriptionTierWorkerDeploymentExpenseTransactionExpenseItem

Workflows

Invoicing (PINT-AE) → Subscription Billing → Commission Payouts → WPS Salary Processing

Modules

TenantBillingTenantInvoicesVatReturnsTabCtReturnsTabBillingEngine

AI Agents

autonomousFinancialLoopautonomousFinancialDecisionEnginesalaryMonitoringEngine

Governance

e_invoice_signingvat_threshold_gatespayout_approval_gatesfx_compliance

Governance OS

live

Entities

GovernanceSettingGovernanceAuditLogGovernanceInboxItemAeonLogPillarHealthScore

Workflows

Gate Evaluation → Incident Response → Self-Healing Remediation → Policy Evolution

Modules

AeonEngineGovernanceHubSelfHealingPipelinePillarHealthIndexRuleEngine

AI Agents

aeonGovernanceGateaeonPredictiveEngineaeonSelfHealingRemediationgovernanceAIAssistant

Governance

pillar_gatesenforcement_levelsstress_testingadaptive_optimization

3. Autonomous Engines

Workflow Orchestrator

live

Entities

WorkflowWorkflowStepWorkflowVersionWorkflowProfileConfig

AI Agent Fleet

live

Entities

AgentLogAIConsultationAgentRadinLogGovernanceAgent

AEON Governance Engine

live

Entities

AeonLogPillarPillarHealthScoreGovernanceAuditLog

Telemetry & Analytics Spine

live

Entities

PlatformMetricPlatformAlertUserActivityLogAuditLog

4. Multi-OS UX Shells

ApplicantPortal

/applicant-portal

applicant

EmployerPortal

/employer-portal

employer

PartnerPortal (UnifiedPortal)

/partner-portal

partner

AdminConsole

/admin

admin

TenantCompliancePortal

/tenant/:id/compliance

tenant_admin

PublicLanding

/

public

5. Shared Components

Theme Tokens

CSS custom properties (--accent, --bg-page, --text-heading) + Tailwind token mapping

src/index.csstailwind.config.js

Layout Slots

Manifest-driven slot system for tenant page composition

src/lib/tenantSlotRegistry.jssrc/components/tenant/Slot.jsx

Manifest-Driven Pages

JSON manifests define page structure, sections, and component bindings

src/lib/landingSectionTemplates.jssrc/lib/tenantContentCatalog.js

Reusable Widgets

Widget library: stat cards, charts, tables, drawers, modals

src/components/ui/src/components/tenant/widgets/

AI Agent Fleet

— 18 agents across all 5 layers

5-Layer AI Agent Fleet

18 Agents Optional Enhancement

18 specialized agents — one architecture, five layers, governed by AEON

⚖ Layer 4 governance agents always override workflow agents when rules conflict (AEON rule AG-005).

Platform Agents

— Foundation engines — tenant, marketplace, integrations, orchestration4 agents

aether

Tenant Provisioning

Auto-provisions tenants, activates modules, assigns admins

Entities

DualPartnerTenantConfigTenantModuleConfig
fn:tenantProvisioningEngine()

bazaar

Marketplace Curator

Manages OS catalog, install lifecycle, trial monitoring

Entities

MarketplaceItemMarketplaceInstallMarketplaceManifest
fn:marketplaceOrchestrator()

pulse

Integration Hub Router

Routes UAE gov + OAuth connector events, webhook dispatch

Entities

UaeIntegrationMCPConnectorLog
fn:eventPropagationEngine()

oracle

Global Orchestrator

Cross-engine orchestration, loop execution, self-healing proposals

Entities

OrchestratorStatePlatformMetricPlatformAlert
fn:globalOrchestrator()

Wiring Agents

— Maintain the backend ↔ UI data contract3 agents

forge

Schema Validator

Validates entity schemas, RLS rules, field types

Entities

SchemaGovernanceRuleDataDictionary
fn:schemaValidationEngine()

loom

Manifest Generator

Generates page manifests, slot bindings, component mappings

fn:provisionTenantBlueprint()

seal

Contract Auditor

Audits backend↔UI contract drift, flags hardcoded logic

Entities

GovernanceAuditLog
fn:schemaGovernanceEngine()

Workflow Agents

— Embedded in workflow steps via the ai_assist field — one per vertical OS5 agents

gail

Worker OS Workflow

live

Applicant registration, document verification, assessment

Entities

TadbeerApplicantApplicantAssessment
fn:submitApplicantRegistration()

heera

Employer OS Workflow

live

Employer onboarding, hiring orchestration, interview scheduling

Entities

EmployerProfileEmployerOnboardingJobPost
fn:employerOnboardingAutomator()

mint

Finance OS Workflow

Invoicing (PINT-AE), commission payouts, WPS salary processing

Entities

InvoiceFinancialLedgerPayoutRequest
fn:autonomousFinancialLoop()

vera

Compliance OS Workflow

VAT filing, corporate tax, e-invoice clearance

Entities

VatReturnCorporateTaxRecord
fn:autonomousComplianceFilingEngine()

echo

Partner OS Workflow

Partner registration, tier progression, guaranteed reservations

Entities

PartnerAgentCommissionLedgerPartnerGuaranteedReservation
fn:partnerGuaranteedReservationEngine()

Governance Agents (AEON Model)

— One per governance domain — these ALWAYS override workflow agents (rule AG-005)5 agents

warden

Data Governance

Blocks invalid saves, enforces RLS, gates OCR confidence

Entities

GovernanceAuditLog
fn:schemaValidationEngine()

pace

Workflow Governance

Blocks invalid advancement, handles retries/escalation

Entities

WorkflowPlatformAlert
fn:stallDetectionEngine()

keeper

Tenant Governance

Suspends past-due tenants, gates module access, trial limits

Entities

DualPartnerTenantConfigTenantFeatureFlag
fn:tenantGuardCheck()

sentry

AI Governance (meta)

Credit budgets, confidence thresholds, model fallbacks, permission enforcement

Entities

AgentLogGovernanceAgent
fn:copilotGovernancePolicy()

gavel

Compliance Governance

Filing deadlines, e-invoice signing, visa/WPS compliance

Entities

VatReturnCorporateTaxRecordLaborLawRecord
fn:complianceDeadlineMonitor()

Synthesis Agents

— Deployment readiness gatekeepers — operate across all layers3 agents

helm

Deployment Readiness

Runs the deployment checklist, verifies all 5 layers connected

Entities

PlatformMetricPlatformAlert
fn:governmentIntegrationReadiness()

bridge

Tenant Onboarding Orchestrator

Orchestrates the 8-step tenant onboarding flow end-to-end

Entities

DualPartnerTenantApplicationTenantInvitation
fn:autoProvisionApprovedTenant()

strata

Multi-Tenant Scaling Monitor

Monitors RLS, routing, branding, cache isolation per tenant

Entities

DualPartnerPlatformMetric
fn:domainHealthMonitor()

Governance Hierarchy

Layer 4 agents (Warden, Pace, Keeper, Sentry, Gavel) always win. A workflow agent's decision is overridden if a governance rule fails — codified as AEON rule AG-005.

Flagship unlocked: All 18 agents are available on abiworkers.com and ailysi.com. Tenant deployments add this as an optional enhancement (AED 999/month).