Skip to main content

Technology Stack

An overview of the technologies, cloud services, and tooling that power the Zynomi platform.

Deployment Architecture


Architecture Philosophy

Zynomi is built on a simple, modern technology stack. While there are multiple components, each serves a specific purpose in delivering a comprehensive clinical trial platform.

PrincipleDescription
Loosely CoupledComponents are independent and can be updated separately
Plugin-BasedFeatures can be added without modifying core code
Horizontal ScalingNew capabilities added alongside existing ones
Microfrontend ReadyAI Chatbot installs as standalone widget

Cloud Infrastructure

Core Services

The platform is delivered as a self-contained Docker Compose bundle on AWS EC2 — one dedicated stack per client, in the AWS region the client selects.

ServiceProviderPurposeNotes
Web App and Mobile WebsiteDocker ComposeNext.js hosting, REST APIsSelf-hosted on AWS EC2
Healthcare BackendFrappe (self-hosted)EHR, patient data, API backendDocker Compose, part of the bundle
DatabaseSupabase (self-hosted)PostgreSQL, authentication, real-timeDocker Compose, part of the bundle
Cache StoreRedisCube.dev cache, session managementIn-memory for small deployments
Source ControlGitHubCode repository, CI/CDFree tier available
Mobile push notifications

Push delivery to the Sublink mobile app uses Firebase Cloud Messaging (FCM) — the standard delivery channel for Android/iOS push. It is an optional, app-level messaging service; all platform hosting runs on AWS.

Analytics Infrastructure

ServiceProviderPurposeNotes
Data Ingestiondlthub (Python)OLTP to lakehouse pipelinePython-based ETL
Data TransformationdbtMedallion architecture, data martsOSS Core edition; Cloud available for scaling
Semantic LayerCube.devGoverned metrics, REST/SQL APIsOSS edition via Docker Compose; Cloud available for enterprise
Data LakePostgreSQL (Supabase)Default for small deploymentsCan swap to Snowflake, Iceberg, Databricks
Data LineageMarquez (OpenLineage)Pipeline lineage tracking and visualizationWeb UI at http://localhost:3300

AI and Integration Services

ServiceProviderPurposeNotes
API GatewayKrakenDUnified API endpoint, rate limitingSelf-hosted via Docker Compose
MCP ServerCustom BuiltSemantic Layer as MCP toolsAdheres to Cube.dev API/SDK standards
AI Agent / ChatbotCustom BuiltAgentic analytics interfaceNot Cube.dev Cloud (enterprise-only)
LLM ProviderOpenAI (Default)GPT-4.0 Mini for tool selectionAny commercial or OSS LLM supported
LLM Requirements

An LLM API subscription is required for the AI chatbot. Default is GPT-4.x Mini. Better models improve tool selection accuracy. No hallucination risk as responses are grounded via MCP tool-calling.


Mobile Application

PlatformTechnologyDescription
iOSNative ShellWebView wrapper loading Ionic mobile website
AndroidNative ShellWebView wrapper loading Ionic mobile website
Mobile WebsiteIonic + Vue.jsProgressive web app hosted via Docker Compose

Security and Compliance

The platform is designed to support regulated clinical workloads. Compliance is a shared, ongoing program — the controls below describe what the architecture provides today; formal certifications and audits are on the roadmap, not claimed as delivered.

ControlDescription
Audit TrailActivity logging across services (a visual audit-trail UI for 21 CFR Part 11 / GxP workflows is on the roadmap)
Data at RestEncrypted storage for databases and files
Data in TransitTLS 1.3 for all communications
HIPAAArchitecture designed to support HIPAA-aligned deployments (dedicated per-client stack, encryption, access control)
GDPRArchitecture designed to support GDPR-aligned data handling (client-selected AWS region, data isolation)

Development Environment

Hardware Requirements

SpecificationMinimumRecommended
RAM8 GB16 GB
CPU4 cores8 cores
Storage50 GB SSD100 GB SSD

Technology Stack

The platform is built with modern, widely-adopted technologies.

CategoryTechnologiesNotes
Primary LanguagesTypeScript, JavaScript70% of codebase
Backend LanguagesPython, SQLdbt, data ingestion, analytics
ScriptingShell/BashAutomation and deployment
Frontend FrameworkReact, Next.js 14Web application
Mobile FrameworkReact NativeMobile application
StylingTailwind CSS, shadcn/uiComponent library
ContainerizationDockerDevelopment and deployment

Software Requirements

SoftwareVersionRequiredNotes
Node.js20.x LTSYesJavaScript runtime
BunLatestYesPackage manager (preferred over npm)
Python3.11+Yesdbt, data ingestion
Git2.xYesVersion control
Docker20.x+YesContainer runtime
VS CodeLatestRecommendedIDE with extensions

Supported Operating Systems

OSVersion
macOS12 (Monterey) or later
Ubuntu20.04 LTS or later
Windows10/11 with WSL2

Scaling Options

ComponentDefaultScaled Option
dbtOSS Core via Dockerdbt Cloud
Cube.devOSS via DockerCube Cloud
CacheRedis / In-memoryDedicated Redis
DatabaseSupabase (PostgreSQL)Dedicated PostgreSQL
Data LakePostgreSQLSnowflake, Iceberg, Databricks

Microfrontend Architecture

The AI Chatbot is built as a microfrontend widget that can be installed independently.

FeatureDescription
Standalone WidgetDeploys separately from host application
No Code ChangesIntegrates without modifying main codebase
Independent UpdatesCan be versioned and updated separately
EmbeddableWorks in any web application