# neftalemmg/trace architecture

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

- Interactive diagram: https://gitdiagram.com/neftalemmg/trace
- Repository: https://github.com/neftalemmg/trace
- Video tour (about a minute): https://gitdiagram.com/neftalemmg/trace/video

## Overview

Trace is a live analysis platform for auditing and improving how AI systems represent Canadian organizations and opportunities. Users start from the landing page or navigation, then submit organization or opportunity inputs through focused tools; API handlers generate scores, verification, comparisons, community analyses, classifications, or implementation guidance, which the pages present. The query and multi-platform handlers’ sampled code supports their analysis and provider-call relationships; the README documents the other tool capabilities, though their implementation details were not sampled. No persistent application store is shown.

Main entry points: [`src/components/Navbar.tsx`](https://github.com/neftalemmg/trace/blob/main/src/components/Navbar.tsx) (Tool navigation), [`src/pages/api/multi-platform.ts`](https://github.com/neftalemmg/trace/blob/main/src/pages/api/multi-platform.ts) (Cross-platform analysis), [`src/pages/audit.tsx`](https://github.com/neftalemmg/trace/blob/main/src/pages/audit.tsx) (Audit Tool), [`src/pages/query-engine.tsx`](https://github.com/neftalemmg/trace/blob/main/src/pages/query-engine.tsx) (Query Engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web experience"]
  node_home["Home and telemetry<br/>[index.tsx]"]
  node_navigation["Tool navigation<br/>[Navbar.tsx]"]
  node_query_ui["Query Engine<br/>[query-engine.tsx]"]
  node_audit_ui["Audit Tool<br/>[audit.tsx]"]
  node_platform_ui["Platform Comparison<br/>[multi-platform.tsx]"]
  node_registry_ui["Hallucination Registry<br/>[registry.tsx]"]
  node_equity_ui["Equity Map<br/>[equity-map.tsx]"]
  node_guide_ui["AiEO Guide<br/>[guide.tsx]"]
end

subgraph group_analysis["Visibility analysis"]
  node_query_api["Query verification<br/>[query-engine.ts]"]
  node_audit_api["Visibility scoring<br/>[audit.ts]"]
  node_guide_api["Implementation guidance<br/>[guide.ts]"]
  node_platform_api["Cross-platform analysis<br/>[multi-platform.ts]"]
end

subgraph group_research["Research tools"]
  node_registry_api["Hallucination classification<br/>[registry.ts]"]
  node_equity_api["Community ecosystem analysis<br/>[equity-map.ts]"]
end

subgraph group_providers["AI providers"]
  node_anthropic{{"Anthropic Claude"}}
  node_perplexity{{"Perplexity API"}}
  node_gemini{{"Google Gemini API"}}
  node_openai{{"OpenAI GPT-4o API"}}
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_home
node_visitor -->|"uses"| node_navigation
node_home -->|"links to"| node_query_ui
node_home -->|"links to"| node_audit_ui
node_navigation -->|"links to"| node_query_ui
node_navigation -->|"links to"| node_audit_ui
node_navigation -->|"links to"| node_platform_ui
node_navigation -->|"links to"| node_registry_ui
node_navigation -->|"links to"| node_equity_ui
node_navigation -->|"links to"| node_guide_ui
node_query_ui -->|"posts query"| node_query_api
node_query_api -->|"requests analyses"| node_anthropic
node_query_api -->|"returns results"| node_query_ui
node_audit_ui -->|"submits organization"| node_audit_api
node_audit_api -->|"requests scoring"| node_anthropic
node_audit_api -->|"returns score"| node_audit_ui
node_audit_ui -->|"links with audit details"| node_guide_ui
node_guide_ui -->|"submits organization"| node_guide_api
node_guide_api -->|"requests guide"| node_anthropic
node_guide_api -->|"returns guidance"| node_guide_ui
node_platform_ui -->|"submits query"| node_platform_api
node_platform_api -->|"queries Claude; analyzes responses"| node_anthropic
node_platform_api -->|"queries"| node_perplexity
node_platform_api -->|"queries"| node_gemini
node_platform_api -->|"queries"| node_openai
node_platform_api -->|"returns comparison"| node_platform_ui
node_registry_ui -->|"submits response"| node_registry_api
node_registry_api -.->|"classifies hallucination"| node_anthropic
node_registry_api -->|"returns classification"| node_registry_ui
node_equity_ui -->|"requests community analysis"| node_equity_api
node_equity_api -.->|"requests analysis"| node_anthropic
node_equity_api -->|"returns findings"| node_equity_ui

click node_home "https://github.com/neftalemmg/trace/blob/main/src/pages/index.tsx"
click node_navigation "https://github.com/neftalemmg/trace/blob/main/src/components/Navbar.tsx"
click node_query_ui "https://github.com/neftalemmg/trace/blob/main/src/pages/query-engine.tsx"
click node_audit_ui "https://github.com/neftalemmg/trace/blob/main/src/pages/audit.tsx"
click node_platform_ui "https://github.com/neftalemmg/trace/blob/main/src/pages/multi-platform.tsx"
click node_registry_ui "https://github.com/neftalemmg/trace/blob/main/src/pages/registry.tsx"
click node_equity_ui "https://github.com/neftalemmg/trace/blob/main/src/pages/equity-map.tsx"
click node_guide_ui "https://github.com/neftalemmg/trace/blob/main/src/pages/guide.tsx"
click node_query_api "https://github.com/neftalemmg/trace/blob/main/src/pages/api/query-engine.ts"
click node_audit_api "https://github.com/neftalemmg/trace/blob/main/src/pages/api/audit.ts"
click node_guide_api "https://github.com/neftalemmg/trace/blob/main/src/pages/api/guide.ts"
click node_platform_api "https://github.com/neftalemmg/trace/blob/main/src/pages/api/multi-platform.ts"
click node_registry_api "https://github.com/neftalemmg/trace/blob/main/src/pages/api/registry.ts"
click node_equity_api "https://github.com/neftalemmg/trace/blob/main/src/pages/api/equity-map.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_home,node_navigation,node_query_ui,node_audit_ui,node_platform_ui,node_registry_ui,node_equity_ui,node_guide_ui toneBlue
class node_query_api,node_audit_api,node_guide_api,node_platform_api toneAmber
class node_registry_api,node_equity_api toneMint
class node_anthropic,node_perplexity,node_gemini,node_openai toneRose
class node_visitor toneIndigo
```

## Components

### Web experience

- [Home and telemetry](https://github.com/neftalemmg/trace/blob/main/src/pages/index.tsx): `src/pages/index.tsx`
- [Tool navigation](https://github.com/neftalemmg/trace/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Query Engine](https://github.com/neftalemmg/trace/blob/main/src/pages/query-engine.tsx): `src/pages/query-engine.tsx`
- [Audit Tool](https://github.com/neftalemmg/trace/blob/main/src/pages/audit.tsx): `src/pages/audit.tsx`
- [Platform Comparison](https://github.com/neftalemmg/trace/blob/main/src/pages/multi-platform.tsx): `src/pages/multi-platform.tsx`
- [Hallucination Registry](https://github.com/neftalemmg/trace/blob/main/src/pages/registry.tsx): `src/pages/registry.tsx`
- [Equity Map](https://github.com/neftalemmg/trace/blob/main/src/pages/equity-map.tsx): `src/pages/equity-map.tsx`
- [AiEO Guide](https://github.com/neftalemmg/trace/blob/main/src/pages/guide.tsx): `src/pages/guide.tsx`

### Visibility analysis

- [Query verification](https://github.com/neftalemmg/trace/blob/main/src/pages/api/query-engine.ts): `src/pages/api/query-engine.ts`
- [Visibility scoring](https://github.com/neftalemmg/trace/blob/main/src/pages/api/audit.ts): `src/pages/api/audit.ts`
- [Implementation guidance](https://github.com/neftalemmg/trace/blob/main/src/pages/api/guide.ts): `src/pages/api/guide.ts`
- [Cross-platform analysis](https://github.com/neftalemmg/trace/blob/main/src/pages/api/multi-platform.ts): `src/pages/api/multi-platform.ts`

### Research tools

- [Hallucination classification](https://github.com/neftalemmg/trace/blob/main/src/pages/api/registry.ts): `src/pages/api/registry.ts`
- [Community ecosystem analysis](https://github.com/neftalemmg/trace/blob/main/src/pages/api/equity-map.ts): `src/pages/api/equity-map.ts`

### AI providers

- **Anthropic Claude**
- **Perplexity API**
- **Google Gemini API**
- **OpenAI GPT-4o API**

### Other components

- **Visitor**

## Connections

- Visitor → Home and telemetry: opens
- Visitor → Tool navigation: uses
- Home and telemetry → Query Engine: links to
- Home and telemetry → Audit Tool: links to
- Tool navigation → Query Engine: links to
- Tool navigation → Audit Tool: links to
- Tool navigation → Platform Comparison: links to
- Tool navigation → Hallucination Registry: links to
- Tool navigation → Equity Map: links to
- Tool navigation → AiEO Guide: links to
- Query Engine → Query verification: posts query
- Query verification → Anthropic Claude: requests analyses
- Query verification → Query Engine: returns results
- Audit Tool → Visibility scoring: submits organization
- Visibility scoring → Anthropic Claude: requests scoring
- Visibility scoring → Audit Tool: returns score
- Audit Tool → AiEO Guide: links with audit details
- AiEO Guide → Implementation guidance: submits organization
- Implementation guidance → Anthropic Claude: requests guide
- Implementation guidance → AiEO Guide: returns guidance
- Platform Comparison → Cross-platform analysis: submits query
- Cross-platform analysis → Anthropic Claude: queries Claude; analyzes responses
- Cross-platform analysis → Perplexity API: queries
- Cross-platform analysis → Google Gemini API: queries
- Cross-platform analysis → OpenAI GPT-4o API: queries
- Cross-platform analysis → Platform Comparison: returns comparison
- Hallucination Registry → Hallucination classification: submits response
- Hallucination classification → Anthropic Claude: classifies hallucination
- Hallucination classification → Hallucination Registry: returns classification
- Equity Map → Community ecosystem analysis: requests community analysis
- Community ecosystem analysis → Anthropic Claude: requests analysis
- Community ecosystem analysis → Equity Map: returns findings