# ninxd20/social-analyst-ai architecture

> Architecture diagram of the GitHub repository ninxd20/social-analyst-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ninxd20/social-analyst-ai
- Repository: https://github.com/ninxd20/social-analyst-ai

## Overview

SOCIAL ANALYST AI is a React/TypeScript social-intelligence frontend prototype. Its intended analyst workflow spans case monitoring, event and evidence review, trend and sentiment analysis, audience/network views, alerts, and report export. The sampled home route is still a placeholder, and sampled services return demo data rather than implementing a complete live collection-to-analysis flow. The graph preserves the documented-by-data-model capability areas; unsampled screens and service wiring are not asserted. Server error handling and report export are shown where source excerpts establish their relationships.

Main entry points: [`src/services/reportService.ts`](https://github.com/ninxd20/social-analyst-ai/blob/main/src/services/reportService.ts) (Report service), [`src/server.ts`](https://github.com/ninxd20/social-analyst-ai/blob/main/src/server.ts) (SSR server), [`src/services/queries.ts`](https://github.com/ninxd20/social-analyst-ai/blob/main/src/services/queries.ts) (Query hooks), [`src/routeTree.gen.ts`](https://github.com/ninxd20/social-analyst-ai/blob/main/src/routeTree.gen.ts) (Route tree)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application runtime"]
  node_router["Router<br/>[router.tsx]"]
  node_route_tree["Route tree<br/>[routeTree.gen.ts]"]
  node_root_route["Root route<br/>[__root.tsx]"]
  node_home_route["Placeholder home<br/>[index.tsx]"]
  node_server["SSR server<br/>[server.ts]"]
  node_error_capture["Error capture<br/>[error-capture.ts]"]
  node_error_page["Error page<br/>[error-page.ts]"]
end

subgraph group_analysis["Intelligence views"]
  node_evidence_view["Evidence drawer<br/>[EvidenceDrawer.tsx]"]
  node_network_view["Network graph<br/>[NetworkGraph.tsx]"]
  node_charts["Charts<br/>[charts.tsx]"]
  node_primitives["Intel primitives<br/>[primitives.tsx]"]
end

subgraph group_domain["Domain data"]
  node_cases["Cases<br/>[cases.ts]"]
  node_events["Events &amp; evidence<br/>[events.ts]"]
  node_trends["Trends<br/>[trends.ts]"]
  node_network_data["Network data<br/>[network.ts]"]
  node_audience["Audience<br/>[audience.ts]"]
  node_alerts["Alerts<br/>[alerts.ts]"]
  node_sentiment["Sentiment<br/>[sentiment.ts]"]
  node_reports["Report data<br/>[reports.ts]"]
  node_types["Domain types<br/>[types.ts]"]
end

subgraph group_services["Data services"]
  node_case_service["Case service<br/>[caseService.ts]"]
  node_source_service["Source service<br/>[sourceService.ts]"]
  node_analytics_service["Analytics service"]
  node_report_service["Report service<br/>[reportService.ts]"]
  node_queries["Query hooks<br/>[queries.ts]"]
  node_http["HTTP mock<br/>[http.ts]"]
end

node_analyst(("Analyst"))

node_analyst -->|"opens app"| node_router
node_router -->|"configures"| node_route_tree
node_route_tree -->|"registers"| node_root_route
node_route_tree -->|"registers"| node_home_route
node_analyst -->|"sees placeholder"| node_home_route
node_server -->|"captures errors"| node_error_capture
node_server -->|"renders on failure"| node_error_page
node_server -->|"returns response"| node_analyst
node_network_view -->|"reads"| node_network_data
node_network_view -->|"uses types"| node_types
node_charts -->|"uses types"| node_types
node_primitives -->|"uses types"| node_types
node_case_service -->|"reads"| node_cases
node_case_service -->|"uses mock"| node_http
node_source_service -->|"uses mock"| node_http
node_report_service -->|"reads"| node_reports
node_report_service -->|"exports evidence"| node_events
node_report_service -->|"exports trends"| node_trends
node_report_service -->|"uses mock"| node_http
node_analyst -.->|"reviews evidence"| node_evidence_view
node_analyst -.->|"explores network"| node_network_view
node_analyst -.->|"reviews signals"| node_charts
node_queries -.->|"queries"| node_case_service
node_queries -.->|"queries"| node_analytics_service
node_queries -.->|"queries"| node_report_service

click node_router "https://github.com/ninxd20/social-analyst-ai/blob/main/src/router.tsx"
click node_route_tree "https://github.com/ninxd20/social-analyst-ai/blob/main/src/routeTree.gen.ts"
click node_root_route "https://github.com/ninxd20/social-analyst-ai/blob/main/src/routes/__root.tsx"
click node_home_route "https://github.com/ninxd20/social-analyst-ai/blob/main/src/routes/index.tsx"
click node_server "https://github.com/ninxd20/social-analyst-ai/blob/main/src/server.ts"
click node_error_capture "https://github.com/ninxd20/social-analyst-ai/blob/main/src/lib/error-capture.ts"
click node_error_page "https://github.com/ninxd20/social-analyst-ai/blob/main/src/lib/error-page.ts"
click node_evidence_view "https://github.com/ninxd20/social-analyst-ai/blob/main/src/components/intel/EvidenceDrawer.tsx"
click node_network_view "https://github.com/ninxd20/social-analyst-ai/blob/main/src/components/intel/NetworkGraph.tsx"
click node_charts "https://github.com/ninxd20/social-analyst-ai/blob/main/src/components/intel/charts.tsx"
click node_primitives "https://github.com/ninxd20/social-analyst-ai/blob/main/src/components/intel/primitives.tsx"
click node_cases "https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/cases.ts"
click node_events "https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/events.ts"
click node_trends "https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/trends.ts"
click node_network_data "https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/network.ts"
click node_audience "https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/audience.ts"
click node_alerts "https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/alerts.ts"
click node_sentiment "https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/sentiment.ts"
click node_reports "https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/reports.ts"
click node_types "https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/types.ts"
click node_case_service "https://github.com/ninxd20/social-analyst-ai/blob/main/src/services/caseService.ts"
click node_source_service "https://github.com/ninxd20/social-analyst-ai/blob/main/src/services/sourceService.ts"
click node_analytics_service "https://github.com/ninxd20/social-analyst-ai/blob/main/src/services/analyticsService.ts"
click node_report_service "https://github.com/ninxd20/social-analyst-ai/blob/main/src/services/reportService.ts"
click node_queries "https://github.com/ninxd20/social-analyst-ai/blob/main/src/services/queries.ts"
click node_http "https://github.com/ninxd20/social-analyst-ai/blob/main/src/services/http.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_router,node_route_tree,node_root_route,node_home_route,node_server,node_error_capture,node_error_page toneBlue
class node_evidence_view,node_network_view,node_charts,node_primitives toneAmber
class node_cases,node_events,node_trends,node_network_data,node_audience,node_alerts,node_sentiment,node_reports,node_types toneMint
class node_case_service,node_source_service,node_analytics_service,node_report_service,node_queries,node_http toneRose
class node_analyst toneIndigo
```

## Components

### Application runtime

- [Router](https://github.com/ninxd20/social-analyst-ai/blob/main/src/router.tsx): `src/router.tsx`
- [Route tree](https://github.com/ninxd20/social-analyst-ai/blob/main/src/routeTree.gen.ts): `src/routeTree.gen.ts`
- [Root route](https://github.com/ninxd20/social-analyst-ai/blob/main/src/routes/__root.tsx): `src/routes/__root.tsx`
- [Placeholder home](https://github.com/ninxd20/social-analyst-ai/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [SSR server](https://github.com/ninxd20/social-analyst-ai/blob/main/src/server.ts): `src/server.ts`
- [Error capture](https://github.com/ninxd20/social-analyst-ai/blob/main/src/lib/error-capture.ts): `src/lib/error-capture.ts`
- [Error page](https://github.com/ninxd20/social-analyst-ai/blob/main/src/lib/error-page.ts): `src/lib/error-page.ts`

### Intelligence views

- [Evidence drawer](https://github.com/ninxd20/social-analyst-ai/blob/main/src/components/intel/EvidenceDrawer.tsx): `src/components/intel/EvidenceDrawer.tsx`
- [Network graph](https://github.com/ninxd20/social-analyst-ai/blob/main/src/components/intel/NetworkGraph.tsx): `src/components/intel/NetworkGraph.tsx`
- [Charts](https://github.com/ninxd20/social-analyst-ai/blob/main/src/components/intel/charts.tsx): `src/components/intel/charts.tsx`
- [Intel primitives](https://github.com/ninxd20/social-analyst-ai/blob/main/src/components/intel/primitives.tsx): `src/components/intel/primitives.tsx`

### Domain data

- [Cases](https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/cases.ts): `src/data/cases.ts`
- [Events & evidence](https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/events.ts): `src/data/events.ts`
- [Trends](https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/trends.ts): `src/data/trends.ts`
- [Network data](https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/network.ts): `src/data/network.ts`
- [Audience](https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/audience.ts): `src/data/audience.ts`
- [Alerts](https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/alerts.ts): `src/data/alerts.ts`
- [Sentiment](https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/sentiment.ts): `src/data/sentiment.ts`
- [Report data](https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/reports.ts): `src/data/reports.ts`
- [Domain types](https://github.com/ninxd20/social-analyst-ai/blob/main/src/data/types.ts): `src/data/types.ts`

### Data services

- [Case service](https://github.com/ninxd20/social-analyst-ai/blob/main/src/services/caseService.ts): `src/services/caseService.ts`
- [Source service](https://github.com/ninxd20/social-analyst-ai/blob/main/src/services/sourceService.ts): `src/services/sourceService.ts`
- [Analytics service](https://github.com/ninxd20/social-analyst-ai/blob/main/src/services/analyticsService.ts): `src/services/analyticsService.ts`
- [Report service](https://github.com/ninxd20/social-analyst-ai/blob/main/src/services/reportService.ts): `src/services/reportService.ts`
- [Query hooks](https://github.com/ninxd20/social-analyst-ai/blob/main/src/services/queries.ts): `src/services/queries.ts`
- [HTTP mock](https://github.com/ninxd20/social-analyst-ai/blob/main/src/services/http.ts): `src/services/http.ts`

### Other components

- **Analyst**

## Connections

- Analyst → Router: opens app (evidence: `src/router.tsx`)
- Router → Route tree: configures (evidence: `src/router.tsx`)
- Route tree → Root route: registers (evidence: `src/routeTree.gen.ts`)
- Route tree → Placeholder home: registers (evidence: `src/routeTree.gen.ts`)
- Analyst → Placeholder home: sees placeholder (evidence: `src/routes/index.tsx`)
- SSR server → Error capture: captures errors (evidence: `src/server.ts`)
- SSR server → Error page: renders on failure (evidence: `src/server.ts`)
- SSR server → Analyst: returns response (evidence: `src/server.ts`)
- Network graph → Network data: reads (evidence: `src/components/intel/NetworkGraph.tsx`)
- Network graph → Domain types: uses types (evidence: `src/components/intel/NetworkGraph.tsx`)
- Charts → Domain types: uses types (evidence: `src/components/intel/charts.tsx`)
- Intel primitives → Domain types: uses types (evidence: `src/components/intel/primitives.tsx`)
- Case service → Cases: reads (evidence: `src/services/caseService.ts`)
- Case service → HTTP mock: uses mock (evidence: `src/services/caseService.ts`)
- Source service → HTTP mock: uses mock (evidence: `src/services/sourceService.ts`)
- Report service → Report data: reads (evidence: `src/services/reportService.ts`)
- Report service → Events & evidence: exports evidence (evidence: `src/services/reportService.ts`)
- Report service → Trends: exports trends (evidence: `src/services/reportService.ts`)
- Report service → HTTP mock: uses mock (evidence: `src/services/reportService.ts`)
- Analyst → Evidence drawer: reviews evidence
- Analyst → Network graph: explores network
- Analyst → Charts: reviews signals
- Query hooks → Case service: queries (evidence: `src/services/queries.ts`)
- Query hooks → Analytics service: queries (evidence: `src/services/queries.ts`)
- Query hooks → Report service: queries (evidence: `src/services/queries.ts`)
