Clarity Platform Architecture

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

Clarity Platform Architecture Diagram

Component Architecture

Remix UI
Frontend — React / Remix, SSR
arrow_downward
Client
Application entry point, client customizations
arrow_downward
Phoenix.Core
Foundation: Pipelines, Plugins, Auth, Caching, Scheduler, Notifications
arrow_downward
Plugins
Core Plugins
ConnectCore Payments Invoicing Sales Site
ERP Connectors
NetSuite Syspro EpicorEagle EpicorEclipse InforSyteline SapB1
Payment Providers
Mock Nuvei Stripe PayTrace Authorize.Net and more
Additional
CMS Products Reporting Shipping Taxes Currencies Maestro

Tech Stack

terminal

Backend

.NET 8 ASP.NET Core Entity Framework Core C#
web

Frontend

Remix v2 React 18 TypeScript Tailwind CSS
storage

Database

PostgreSQL / MSSQL EF Core TDE / Encryption at Rest
cloud

Infrastructure

Docker Kubernetes Redis Elasticsearch NFS

Documentation

layers

Platform & Infra

Project structure, deployment architecture, hosting configuration, and routing setup.
conversion_path

Pipelines & Hooks

Serial and parallel pipelines, hook system, pre hooks, pipeline context, and caching strategy.
storage

Database & Models

EF Core patterns, BaseEntity, model mapping, soft deletion, shadow properties, and dual-DB support.
api

API & Mutations

Query patterns, mutation engine architecture, and endpoint conventions.
web

Frontend

Remix routing, extension points, component overrides, and the theme editor.
extension

Plugins

IPlugin interface, Git submodules, and the full plugin catalog.
hub

Connectors & EkDB

ConnectCore integration layer, EkDB middleware, and the NetSuite connector reference.
payments

Payment Hub

Provider interfaces, entity model, payment lifecycle, tokenization, and adding new providers.
shield

Security & Compliance

Authentication, roles, permissions, encryption and TDE, and the no-PII-storage policy.
build

Operations

Deployment pipelines, scheduler, notifications, settings system, and business workflows.
verified

Quality & Releases

Test infrastructure, release process, and failure mode analysis.

Platform Design Principles

settings_input_component

Extensibility

Hooks, pipelines, and extension points ensure customization without modifying core code.

extension

Plugin-First

All features are modular plugins that can be added, removed, or replaced.

lock

Security by Default

All endpoints require authentication, payment data is tokenized, no PII stored.

upgrade

Upgrade Safety

Client customizations live in isolated layers, never interfering with core updates.