Home

WebServer Repository Overview

This page is a high-level map of the repository and how the major pieces fit together.

Top-Level Layout

  • apps/dashboard/ – Primary Node.js/Express web app (UI pages, API routes, auth, data services).
  • apps/ai/ – AI service container used by the platform for model-backed features.
  • apps/mongo/ – Mongo/DocumentDB-related container assets and local data setup.
  • apps/s3_minio/ – Local S3-compatible object storage via MinIO.
  • docker-compose.yml – Multi-service local orchestration across the stack.

System Roles

  • Dashboard app handles HTTP traffic, static pages, login/auth flow, and business APIs.
  • Database layer stores user/auth and app data used by the dashboard services.
  • AI service provides separate compute/model functionality behind internal service calls.
  • Object storage supports file/object workflows in local and containerized development.

High-Level Request Path

  1. Client request reaches the dashboard app.
  2. Express middleware handles parsing, CORS/cookies, and access checks.
  3. Route handlers dispatch to domain services (auth, data processing, integrations).
  4. Services interact with backing systems (database, mail/third-party APIs, storage, AI).
  5. Response is returned as HTML, JSON, or static assets.

Configuration Model

  • Environment variables drive runtime behavior (ports, DB credentials, auth secrets, service URLs, tenant settings).
  • OFFLINE mode is intended for local development shortcuts and bypass paths.
  • Containerized workflows are coordinated through Compose for consistent local environments.

Intended Use of This Documentation

This page is intentionally concise and architectural. It is designed to orient contributors quickly without per-file API details.