# vinay7766/moatradar architecture

> Architecture diagram of the GitHub repository vinay7766/moatradar, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vinay7766/moatradar
- Repository: https://github.com/vinay7766/moatradar

## Overview

MoatRadar is a self-hosted competitive-intelligence workbench: users launch a product research mission, approve discovered competitors, follow live research and verification, then review and export a structured dossier or ask workspace-grounded questions. The graph preserves the documented discovery, research, Critic, synthesis, snapshot, RAG, monitoring, and provider-configuration capabilities. Backend wiring is supported by excerpts and the source index; several UI and agent details are documented in the README but their implementation was not sampled.

Main entry points: [`backend/app/api/routes.py`](https://github.com/vinay7766/moatradar/blob/main/backend/app/api/routes.py) (FastAPI Routes), [`backend/app/services/mission_runner.py`](https://github.com/vinay7766/moatradar/blob/main/backend/app/services/mission_runner.py) (Mission Runner), [`backend/app/agents/nodes.py`](https://github.com/vinay7766/moatradar/blob/main/backend/app/agents/nodes.py) (Research Stages), [`frontend/src/app/page.tsx`](https://github.com/vinay7766/moatradar/blob/main/frontend/src/app/page.tsx) (Workbench Shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workbench["Product Workbench"]
  node_ui["Workbench Shell<br/>[page.tsx]"]
  node_launcher["Mission Launcher"]
  node_approval["Competitor Approval"]
  node_trace["Mission Trace"]
  node_dossier["Dossier Views<br/>[DossierTabs.tsx]"]
  node_monitor_ui["Monitor Settings"]
  node_workflow_ui["Workflow Inspector<br/>[WorkflowXRay.tsx]"]
end

subgraph group_mission["Mission Research"]
  node_api["FastAPI Routes<br/>[routes.py]"]
  node_runner["Mission Runner<br/>[mission_runner.py]"]
  node_graph["LangGraph Workflow<br/>[graph.py]"]
  node_stages["Research Stages<br/>[nodes.py]"]
  node_contracts["Intelligence Contracts<br/>[intelligence.py]"]
end

subgraph group_intelligence["Intelligence Services"]
  node_tools["Evidence Collectors<br/>[registry.py]"]
  node_search["Web Search<br/>[web_search.py]"]
  node_security["Evidence Safety<br/>[security.py]"]
  node_diff["Snapshot Diff<br/>[diff_engine.py]"]
  node_export["Dossier Export<br/>[exporter.py]"]
  node_rag["RAG Chat<br/>[rag_chat.py]"]
  node_scheduler["Monitor Scheduler"]
end

subgraph group_persistence["Workspace Data"]
  node_sqlite[("Workspace Database<br/>[database.py]")]
  node_vectors[("Chroma Vector Store<br/>[vector_store.py]")]
end

subgraph group_providers["Model Providers"]
  node_settings["Runtime Settings<br/>[config.py]"]
  node_llm["LLM Factory<br/>[factory.py]"]
  node_byok["BYOK Storage<br/>[byokStorage.ts]"]
end

node_pm(("Product Manager"))
node_model_services["LLM Services"]
node_signal_sources["Live Signal Sources"]

node_pm -->|"uses"| node_ui
node_ui -->|"launches from"| node_launcher
node_launcher -->|"starts mission"| node_api
node_api -->|"dispatches"| node_runner
node_runner -->|"runs"| node_graph
node_graph -->|"dispatches"| node_stages
node_stages -->|"pauses for review"| node_approval
node_approval -->|"submits approval"| node_api
node_stages -->|"collects evidence"| node_tools
node_tools -->|"uses search"| node_search
node_search -->|"sanitizes snippets"| node_security
node_tools -->|"queries sources"| node_signal_sources
node_stages -->|"requests generation"| node_llm
node_llm -->|"reads settings"| node_settings
node_settings -->|"discovers models"| node_model_services
node_stages -->|"produces typed results"| node_contracts
node_runner -->|"persists mission state"| node_sqlite
node_runner -->|"streams events"| node_trace
node_api -->|"serves dossier data"| node_dossier
node_dossier -->|"requests export"| node_export
node_runner -->|"compares snapshots"| node_diff
node_runner -->|"indexes dossier"| node_vectors
node_api -->|"routes questions"| node_rag
node_rag -->|"retrieves evidence"| node_vectors
node_api -->|"reads and writes"| node_sqlite
node_api -->|"manages uploads"| node_vectors
node_ui -.->|"configures credentials"| node_byok
node_byok -.->|"sends provider headers"| node_api
node_api -->|"configures monitoring"| node_scheduler
node_scheduler -->|"starts scheduled runs"| node_runner
node_monitor_ui -.->|"sets monitor options"| node_api
node_workflow_ui -.->|"loads workflow spec"| node_api

click node_ui "https://github.com/vinay7766/moatradar/blob/main/frontend/src/app/page.tsx"
click node_launcher "https://github.com/vinay7766/moatradar/blob/main/frontend/src/components/MissionLauncher.tsx"
click node_approval "https://github.com/vinay7766/moatradar/blob/main/frontend/src/components/HitlApprovalPanel.tsx"
click node_trace "https://github.com/vinay7766/moatradar/blob/main/frontend/src/components/AgentTracePanel.tsx"
click node_dossier "https://github.com/vinay7766/moatradar/blob/main/frontend/src/components/DossierTabs.tsx"
click node_monitor_ui "https://github.com/vinay7766/moatradar/blob/main/frontend/src/components/MonitorSettingsPanel.tsx"
click node_workflow_ui "https://github.com/vinay7766/moatradar/blob/main/frontend/src/components/WorkflowXRay.tsx"
click node_api "https://github.com/vinay7766/moatradar/blob/main/backend/app/api/routes.py"
click node_runner "https://github.com/vinay7766/moatradar/blob/main/backend/app/services/mission_runner.py"
click node_graph "https://github.com/vinay7766/moatradar/blob/main/backend/app/agents/graph.py"
click node_stages "https://github.com/vinay7766/moatradar/blob/main/backend/app/agents/nodes.py"
click node_contracts "https://github.com/vinay7766/moatradar/blob/main/backend/app/schemas/intelligence.py"
click node_tools "https://github.com/vinay7766/moatradar/blob/main/backend/app/tools/registry.py"
click node_search "https://github.com/vinay7766/moatradar/blob/main/backend/app/tools/web_search.py"
click node_security "https://github.com/vinay7766/moatradar/blob/main/backend/app/tools/security.py"
click node_diff "https://github.com/vinay7766/moatradar/blob/main/backend/app/agents/diff_engine.py"
click node_export "https://github.com/vinay7766/moatradar/blob/main/backend/app/services/exporter.py"
click node_rag "https://github.com/vinay7766/moatradar/blob/main/backend/app/agents/rag_chat.py"
click node_scheduler "https://github.com/vinay7766/moatradar/blob/main/backend/app/services/monitor_scheduler.py"
click node_sqlite "https://github.com/vinay7766/moatradar/blob/main/backend/app/db/database.py"
click node_vectors "https://github.com/vinay7766/moatradar/blob/main/backend/app/db/vector_store.py"
click node_settings "https://github.com/vinay7766/moatradar/blob/main/backend/app/config.py"
click node_llm "https://github.com/vinay7766/moatradar/blob/main/backend/app/llm/factory.py"
click node_byok "https://github.com/vinay7766/moatradar/blob/main/frontend/src/lib/byokStorage.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ui,node_launcher,node_approval,node_trace,node_dossier,node_monitor_ui,node_workflow_ui toneBlue
class node_api,node_runner,node_graph,node_stages,node_contracts toneAmber
class node_tools,node_search,node_security,node_diff,node_export,node_rag,node_scheduler toneMint
class node_sqlite,node_vectors toneRose
class node_settings,node_llm,node_byok,node_pm,node_model_services,node_signal_sources toneIndigo
```

## Components

### Product Workbench

- [Workbench Shell](https://github.com/vinay7766/moatradar/blob/main/frontend/src/app/page.tsx): `frontend/src/app/page.tsx`
- [Mission Launcher](https://github.com/vinay7766/moatradar/blob/main/frontend/src/components/MissionLauncher.tsx): `frontend/src/components/MissionLauncher.tsx`
- [Competitor Approval](https://github.com/vinay7766/moatradar/blob/main/frontend/src/components/HitlApprovalPanel.tsx): `frontend/src/components/HitlApprovalPanel.tsx`
- [Mission Trace](https://github.com/vinay7766/moatradar/blob/main/frontend/src/components/AgentTracePanel.tsx): `frontend/src/components/AgentTracePanel.tsx`
- [Dossier Views](https://github.com/vinay7766/moatradar/blob/main/frontend/src/components/DossierTabs.tsx): `frontend/src/components/DossierTabs.tsx`
- [Monitor Settings](https://github.com/vinay7766/moatradar/blob/main/frontend/src/components/MonitorSettingsPanel.tsx): `frontend/src/components/MonitorSettingsPanel.tsx`
- [Workflow Inspector](https://github.com/vinay7766/moatradar/blob/main/frontend/src/components/WorkflowXRay.tsx): `frontend/src/components/WorkflowXRay.tsx`

### Mission Research

- [FastAPI Routes](https://github.com/vinay7766/moatradar/blob/main/backend/app/api/routes.py): `backend/app/api/routes.py`
- [Mission Runner](https://github.com/vinay7766/moatradar/blob/main/backend/app/services/mission_runner.py): `backend/app/services/mission_runner.py`
- [LangGraph Workflow](https://github.com/vinay7766/moatradar/blob/main/backend/app/agents/graph.py): `backend/app/agents/graph.py`
- [Research Stages](https://github.com/vinay7766/moatradar/blob/main/backend/app/agents/nodes.py): `backend/app/agents/nodes.py`
- [Intelligence Contracts](https://github.com/vinay7766/moatradar/blob/main/backend/app/schemas/intelligence.py): `backend/app/schemas/intelligence.py`

### Intelligence Services

- [Evidence Collectors](https://github.com/vinay7766/moatradar/blob/main/backend/app/tools/registry.py): `backend/app/tools/registry.py`
- [Web Search](https://github.com/vinay7766/moatradar/blob/main/backend/app/tools/web_search.py): `backend/app/tools/web_search.py`
- [Evidence Safety](https://github.com/vinay7766/moatradar/blob/main/backend/app/tools/security.py): `backend/app/tools/security.py`
- [Snapshot Diff](https://github.com/vinay7766/moatradar/blob/main/backend/app/agents/diff_engine.py): `backend/app/agents/diff_engine.py`
- [Dossier Export](https://github.com/vinay7766/moatradar/blob/main/backend/app/services/exporter.py): `backend/app/services/exporter.py`
- [RAG Chat](https://github.com/vinay7766/moatradar/blob/main/backend/app/agents/rag_chat.py): `backend/app/agents/rag_chat.py`
- [Monitor Scheduler](https://github.com/vinay7766/moatradar/blob/main/backend/app/services/monitor_scheduler.py): `backend/app/services/monitor_scheduler.py`

### Workspace Data

- [Workspace Database](https://github.com/vinay7766/moatradar/blob/main/backend/app/db/database.py): `backend/app/db/database.py`
- [Chroma Vector Store](https://github.com/vinay7766/moatradar/blob/main/backend/app/db/vector_store.py): `backend/app/db/vector_store.py`

### Model Providers

- [Runtime Settings](https://github.com/vinay7766/moatradar/blob/main/backend/app/config.py): `backend/app/config.py`
- [LLM Factory](https://github.com/vinay7766/moatradar/blob/main/backend/app/llm/factory.py): `backend/app/llm/factory.py`
- [BYOK Storage](https://github.com/vinay7766/moatradar/blob/main/frontend/src/lib/byokStorage.ts): `frontend/src/lib/byokStorage.ts`

### Other components

- **Product Manager**
- **LLM Services**
- **Live Signal Sources**

## Connections

- Product Manager → Workbench Shell: uses (evidence: `README.md`)
- Workbench Shell → Mission Launcher: launches from (evidence: `frontend/src/app/page.tsx`)
- Mission Launcher → FastAPI Routes: starts mission (evidence: `README.md`)
- FastAPI Routes → Mission Runner: dispatches (evidence: `README.md`)
- Mission Runner → LangGraph Workflow: runs (evidence: `backend/app/services/mission_runner.py`)
- LangGraph Workflow → Research Stages: dispatches (evidence: `backend/app/agents/graph.py`)
- Research Stages → Competitor Approval: pauses for review (evidence: `README.md`)
- Competitor Approval → FastAPI Routes: submits approval (evidence: `README.md`)
- Research Stages → Evidence Collectors: collects evidence (evidence: `backend/app/agents/nodes.py`)
- Evidence Collectors → Web Search: uses search (evidence: `backend/app/tools/registry.py`)
- Web Search → Evidence Safety: sanitizes snippets (evidence: `backend/app/tools/web_search.py`)
- Evidence Collectors → Live Signal Sources: queries sources (evidence: `README.md`)
- Research Stages → LLM Factory: requests generation (evidence: `backend/app/agents/nodes.py`)
- LLM Factory → Runtime Settings: reads settings (evidence: `backend/app/llm/factory.py`)
- Runtime Settings → LLM Services: discovers models (evidence: `backend/app/config.py`)
- Research Stages → Intelligence Contracts: produces typed results (evidence: `README.md`)
- Mission Runner → Workspace Database: persists mission state (evidence: `backend/app/services/mission_runner.py`)
- Mission Runner → Mission Trace: streams events (evidence: `README.md`)
- FastAPI Routes → Dossier Views: serves dossier data (evidence: `README.md`)
- Dossier Views → Dossier Export: requests export (evidence: `README.md`)
- Mission Runner → Snapshot Diff: compares snapshots (evidence: `README.md`)
- Mission Runner → Chroma Vector Store: indexes dossier (evidence: `README.md`)
- FastAPI Routes → RAG Chat: routes questions (evidence: `backend/app/api/routes.py`)
- RAG Chat → Chroma Vector Store: retrieves evidence (evidence: `backend/app/agents/rag_chat.py`)
- FastAPI Routes → Workspace Database: reads and writes (evidence: `backend/app/api/routes.py`)
- FastAPI Routes → Chroma Vector Store: manages uploads (evidence: `backend/app/api/routes.py`)
- Workbench Shell → BYOK Storage: configures credentials
- BYOK Storage → FastAPI Routes: sends provider headers
- FastAPI Routes → Monitor Scheduler: configures monitoring (evidence: `backend/app/api/routes.py`)
- Monitor Scheduler → Mission Runner: starts scheduled runs (evidence: `backend/app/services/monitor_scheduler.py`)
- Monitor Settings → FastAPI Routes: sets monitor options
- Workflow Inspector → FastAPI Routes: loads workflow spec
