Skip to main content

Architecture Overview

This page explains Nova architecture in practical terms.

One-sentence view​

Nova is an agentic platform that understands natural language, plans actions, and executes them safely with approvals, audit logs, and retry-safe behavior.

Main parts​

  • API (NestJS): core runtime, orchestration, and business logic
  • Dashboard (Next.js): user and operator interface
  • Telegram app path: chat channel connected to the same runtime rules

Core infrastructure​

  • MongoDB: source of truth for runs, approvals, messages, calendar events, and audit data
  • Redis/Dragonfly: queue transport, throttling, replay protection
  • Mailcow (optional): managed assistant mailbox lifecycle

Why this design​

  • People talk naturally; they should not need command syntax.
  • Writes must be safe; risky actions require confirmation.
  • Every important action should be traceable.
  • Runtime behavior must be predictable at scale.

How a request flows​

User message (Dashboard/API/Telegram)
  -> Transport layer
  -> Agent runtime (plan + policy + execution)
  -> DB/queues/providers
  -> Result back to user

Important data sets​

  • agent_runs, agent_steps, tool_executions
  • pending_approvals
  • calendar_events, calendar_action_runs, calendar_sync_cursors
  • normalized_messages, raw_messages, conversations
  • audit_events