Skip to main content

Project Setup

Project Technical Stack Overview Version: 1.0 Date: October 14, 2025 Status: Final

  1. Introduction This document provides a comprehensive overview of the technical stack, frameworks, and platforms used to build and deploy the ChainAlign project. The architecture is designed to be modular, scalable, and maintainable, leveraging a modern, cloud-native technology stack.

  2. Core Frameworks The project follows a microservices-oriented architecture with a clear separation between the frontend and various backend services.

Frontend Applications:

Main Application: The core S&OP dashboard is built using React.js. Landing Page & Documentation: The public-facing marketing site and documentation are built as a separate React.js application using Vite for an optimized build process. Backend API (Main):

The primary backend service, responsible for orchestration, business logic, and API gateway functions, is built with Node.js and the Express.js framework. Backend Microservices:

Specialized, computationally intensive tasks such as Monte Carlo simulations are handled by dedicated Python microservices, likely using a modern framework like FastAPI for performance. 3. Data & Persistence ORM (Object-Relational Mapping):

The Node.js backend utilizes Knex.js for building SQL queries, managing database connections, and handling schema migrations. This provides a flexible and powerful interface to the database without the overhead of a full ORM. Database:

The primary database is a managed PostgreSQL instance hosted on Supabase. This provides a robust, scalable SQL database with the benefits of a managed service, including authentication and real-time capabilities. 4. Testing & Quality Assurance Testing Framework: Jest is the standardized testing framework used across the entire project for both frontend (React components) and backend (Node.js services) unit and integration testing. 5. Containerization Container Runtime: Podman is used for building, managing, and running OCI-compliant containers. This choice emphasizes a daemonless and more secure approach to containerization for both local development (e.g., spinning up test databases) and production deployments. 6. Deployment & Infrastructure The deployment strategy is a hybrid-cloud approach, leveraging the strengths of different specialized platforms for each component of the application.

Component Service / Platform Description Database Supabase Managed PostgreSQL database service. Backend (Node.js) Google Cloud Run The main Express.js API is deployed as a serverless, containerized service. Backend (Python) Google Cloud Run Python microservices are deployed as separate serverless, containerized services. Frontend (Landing Page) Cloudflare Pages The public-facing marketing and documentation site is hosted on Cloudflare's edge network for global performance. Domain & DNS Cloudflare Manages the project's domain, DNS records, and provides CDN and security services.