Architecture Diagrams

Visual maps of every layer of the Leadmetrics v3 system. Read top to bottom — each diagram zooms into a layer from the one above.

1. Full System Overview

All major components and the connections between them.

2. API Layer Internals

What lives inside the Fastify API process (:3003).

3. Job Lifecycle — API to Worker to Result

How a content generation request travels from the API to a completed piece of content.

4. Worker Servers & Their Queues

Seven background processes handle all async work.

5. Adapter Layer — LLM Dispatch

How the agents server selects and calls an LLM backend per job.

6. Auth Flow

How authentication works across all portals and the API.

7. Data Layer — What Goes Where

Which database stores which data and why.

8. RAG Pipeline

How documents and web pages flow from upload to searchable vector chunks used by AI agents.

9. Notification Routing

How notifications reach users across every channel.

10. Tenant Data Isolation

How one PostgreSQL + Redis cluster serves all tenants safely.

11. Deployment

Services, ports, and how code gets to production.

Component Summary