Synaro docs

Architecture

Control plane, microservices, and infrastructure layering.

Synaro uses a modular backend: the Next.js app is the product surface and BFF (API routes, NextAuth, Prisma). Specialized services own Docker, projects, AI, and execution.

High-level diagram

┌─────────────────────────────────────────┐
│         Next.js App (port 3000)         │
│  Dashboard · Projects · API routes      │
└────────────────────┬────────────────────┘
                     │
     ┌───────────────┼───────────────┬──────────────┐
     ▼               ▼               ▼              ▼
 Project Svc    Environment Svc   AI Orch Svc   Execution Mgr
  :3001            :3002            :3003          :3004
     │               │               │              │
     └───────────────┴───────────────┴──────────────┘
                     │
              Docker · PostgreSQL

Responsibilities

Service	Role
project-service	Project CRUD and service-side metadata (Fastify)
environment-service	Container lifecycle, files, terminal WS, git operations
ai-orchestration-service	LLM tasks, repo analysis, patch application
execution-manager	Process run/stop, log capture, runtime monitoring