Clarity Platform Architecture
A comprehensive reference for the platform architecture, integrations, security posture, operational flows, extensibility model, and quality practices that power the Clarity platform.
Architecture Overview
Component Architecture
Tech Stack
Backend
Frontend
Database
Infrastructure
Documentation
Platform & Infra
Project structure, deployment architecture, hosting configuration, and routing setup.
Pipelines & Hooks
Serial and parallel pipelines, hook system, pre hooks, pipeline context, and caching strategy.
Database & Models
EF Core patterns, BaseEntity, model mapping, soft deletion, shadow properties, and dual-DB support.
API & Mutations
Query patterns, mutation engine architecture, and endpoint conventions.
Frontend
Remix routing, extension points, component overrides, and the theme editor.
Plugins
IPlugin interface, Git submodules, and the full plugin catalog.
Connectors & EkDB
ConnectCore integration layer, EkDB middleware, and the NetSuite connector reference.
Payment Hub
Provider interfaces, entity model, payment lifecycle, tokenization, and adding new providers.
Security & Compliance
Authentication, roles, permissions, encryption and TDE, and the no-PII-storage policy.
Operations
Deployment pipelines, scheduler, notifications, settings system, and business workflows.
Quality & Releases
Test infrastructure, release process, and failure mode analysis.
Platform Design Principles
Extensibility
Hooks, pipelines, and extension points ensure customization without modifying core code.
Plugin-First
All features are modular plugins that can be added, removed, or replaced.
Security by Default
All endpoints require authentication, payment data is tokenized, no PII stored.
Upgrade Safety
Client customizations live in isolated layers, never interfering with core updates.
ERP-Native Payment Experience
Payment forms embed directly within ERP interfaces like D365 and NetSuite. Users process payments without leaving their familiar workflow.
Multi-Tenant Architecture
Each client deployment uses dedicated, isolated database instances with per-tenant configuration and credential management.