# aryannehe/synapse architecture

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

- Interactive diagram: https://gitdiagram.com/aryannehe/synapse
- Repository: https://github.com/aryannehe/synapse

## Overview

Synapse Workspace is an internal operations portal whose main workflows are employee knowledge search, support-ticket handling, and AI-assisted chat, alongside an admin analytics hub. Dashboard pages call shared services and workspace state; API routes enforce sessions and access MongoDB models, while AI routes use the Gemini integration. The README documents richer UI capabilities than the excerpts show; those are represented by their page components without inferring unshown internal flows.

Main entry points: [`src/services/serviceLayer.ts`](https://github.com/aryannehe/synapse/blob/main/src/services/serviceLayer.ts) (Workspace services), [`src/lib/auth.ts`](https://github.com/aryannehe/synapse/blob/main/src/lib/auth.ts) (Session and access), [`src/lib/db.ts`](https://github.com/aryannehe/synapse/blob/main/src/lib/db.ts) (Database connector), [`src/app/api/analytics/route.ts`](https://github.com/aryannehe/synapse/blob/main/src/app/api/analytics/route.ts) (Analytics API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Workspace experience"]
  node_analytics_page["Analytics hub<br/>[page.tsx]"]
  node_profile_page["Profile settings<br/>[page.tsx]"]
  node_settings_page["Workspace settings<br/>[page.tsx]"]
  node_navbar["Navigation bar<br/>[Navbar.tsx]"]
  node_sidebar["Workspace sidebar<br/>[Sidebar.tsx]"]
  node_providers["App providers<br/>[Providers.tsx]"]
  node_service_layer["Workspace services<br/>[serviceLayer.ts]"]
  node_workspace_store["Workspace state"]
  node_analytics_api["Analytics API<br/>[route.ts]"]
end

subgraph group_knowledge["Knowledge search"]
  node_knowledge_page["Knowledge workspace<br/>[page.tsx]"]
  node_knowledge_api["Knowledge API<br/>[route.ts]"]
  node_document_model[("Document records<br/>[Document.ts]")]
end

subgraph group_support["Ticket operations"]
  node_support_page["Ticket board<br/>[page.tsx]"]
  node_ticket_detail["Ticket conversation<br/>[page.tsx]"]
  node_tickets_api["Ticket collection API<br/>[route.ts]"]
  node_ticket_api["Ticket detail API<br/>[route.ts]"]
  node_ticket_model[("Ticket records<br/>[Ticket.ts]")]
end

subgraph group_assistant["AI assistant"]
  node_assistant_page["Prompt playground<br/>[page.tsx]"]
  node_assistant_stream["Assistant stream API<br/>[route.ts]"]
  node_markdown["Markdown renderer"]
end

subgraph group_platform["Identity and data"]
  node_auth_api["Authentication APIs<br/>[route.ts]"]
  node_auth_helpers["Session and access<br/>[auth.ts]"]
  node_user_model[("User records<br/>[User.ts]")]
  node_database_connector["Database connector<br/>[db.ts]"]
  node_mongo[("MongoDB")]
  node_ai_service["Gemini integration<br/>[ai.ts]"]
end

node_employee(("Workspace user"))

node_employee -->|"views"| node_analytics_page
node_employee -->|"searches"| node_knowledge_page
node_employee -->|"manages tickets"| node_support_page
node_employee -->|"prompts"| node_assistant_page
node_analytics_page -->|"requests stats"| node_service_layer
node_service_layer -->|"fetches stats"| node_analytics_api
node_knowledge_page -->|"searches articles"| node_service_layer
node_service_layer -->|"queries"| node_knowledge_api
node_knowledge_api -->|"checks session"| node_auth_helpers
node_knowledge_api -->|"connects"| node_database_connector
node_knowledge_api -->|"searches and writes"| node_document_model
node_knowledge_api -->|"generates answers"| node_ai_service
node_support_page -->|"loads tickets"| node_service_layer
node_ticket_detail -->|"updates ticket"| node_service_layer
node_service_layer -->|"requests tickets"| node_tickets_api
node_service_layer -->|"requests ticket"| node_ticket_api
node_tickets_api -->|"checks session"| node_auth_helpers
node_tickets_api -->|"connects"| node_database_connector
node_tickets_api -->|"reads and writes"| node_ticket_model
node_ticket_api -->|"checks session"| node_auth_helpers
node_ticket_api -->|"connects"| node_database_connector
node_ticket_api -->|"reads and updates"| node_ticket_model
node_assistant_page -->|"streams response"| node_service_layer
node_service_layer -->|"opens stream"| node_assistant_stream
node_assistant_page -->|"renders replies"| node_markdown
node_assistant_stream -->|"uses AI"| node_ai_service
node_knowledge_page -->|"uses state"| node_workspace_store
node_support_page -->|"uses state"| node_workspace_store
node_ticket_detail -->|"uses state"| node_workspace_store
node_assistant_page -->|"uses state"| node_workspace_store
node_workspace_store -->|"submits login"| node_auth_api
node_auth_api -->|"signs session"| node_auth_helpers
node_auth_api -->|"connects"| node_database_connector
node_auth_api -->|"checks user"| node_user_model
node_auth_helpers -->|"connects"| node_database_connector
node_auth_helpers -->|"loads user"| node_user_model
node_database_connector -->|"connects"| node_mongo
node_analytics_api -->|"checks session"| node_auth_helpers
node_analytics_api -->|"connects"| node_database_connector
node_analytics_api -->|"aggregates tickets"| node_ticket_model
node_analytics_api -->|"aggregates documents"| node_document_model
node_analytics_api -->|"counts users"| node_user_model

click node_analytics_page "https://github.com/aryannehe/synapse/blob/main/src/app/(dashboard)/page.tsx"
click node_profile_page "https://github.com/aryannehe/synapse/blob/main/src/app/(dashboard)/profile/page.tsx"
click node_settings_page "https://github.com/aryannehe/synapse/blob/main/src/app/(dashboard)/settings/page.tsx"
click node_navbar "https://github.com/aryannehe/synapse/blob/main/src/components/layout/Navbar.tsx"
click node_sidebar "https://github.com/aryannehe/synapse/blob/main/src/components/layout/Sidebar.tsx"
click node_providers "https://github.com/aryannehe/synapse/blob/main/src/components/layout/Providers.tsx"
click node_knowledge_page "https://github.com/aryannehe/synapse/blob/main/src/app/(dashboard)/knowledge/page.tsx"
click node_knowledge_api "https://github.com/aryannehe/synapse/blob/main/src/app/api/knowledge/route.ts"
click node_document_model "https://github.com/aryannehe/synapse/blob/main/src/models/Document.ts"
click node_support_page "https://github.com/aryannehe/synapse/blob/main/src/app/(dashboard)/support/page.tsx"
click node_ticket_detail "https://github.com/aryannehe/synapse/blob/main/src/app/(dashboard)/support/%5BticketId%5D/page.tsx"
click node_tickets_api "https://github.com/aryannehe/synapse/blob/main/src/app/api/tickets/route.ts"
click node_ticket_api "https://github.com/aryannehe/synapse/blob/main/src/app/api/tickets/%5BticketId%5D/route.ts"
click node_ticket_model "https://github.com/aryannehe/synapse/blob/main/src/models/Ticket.ts"
click node_assistant_page "https://github.com/aryannehe/synapse/blob/main/src/app/(dashboard)/assistant/page.tsx"
click node_assistant_stream "https://github.com/aryannehe/synapse/blob/main/src/app/api/assistant/stream/route.ts"
click node_markdown "https://github.com/aryannehe/synapse/blob/main/src/components/chat/MarkdownRenderer.tsx"
click node_service_layer "https://github.com/aryannehe/synapse/blob/main/src/services/serviceLayer.ts"
click node_workspace_store "https://github.com/aryannehe/synapse/blob/main/src/store/useWorkspaceStore.ts"
click node_auth_api "https://github.com/aryannehe/synapse/blob/main/src/app/api/auth/login/route.ts"
click node_auth_helpers "https://github.com/aryannehe/synapse/blob/main/src/lib/auth.ts"
click node_user_model "https://github.com/aryannehe/synapse/blob/main/src/models/User.ts"
click node_database_connector "https://github.com/aryannehe/synapse/blob/main/src/lib/db.ts"
click node_ai_service "https://github.com/aryannehe/synapse/blob/main/src/lib/ai.ts"
click node_analytics_api "https://github.com/aryannehe/synapse/blob/main/src/app/api/analytics/route.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_analytics_page,node_profile_page,node_settings_page,node_navbar,node_sidebar,node_providers,node_service_layer,node_workspace_store,node_analytics_api,node_employee toneBlue
class node_knowledge_page,node_knowledge_api,node_document_model toneAmber
class node_support_page,node_ticket_detail,node_tickets_api,node_ticket_api,node_ticket_model toneMint
class node_assistant_page,node_assistant_stream,node_markdown toneRose
class node_auth_api,node_auth_helpers,node_user_model,node_database_connector,node_mongo,node_ai_service toneIndigo
```

## Components

### Workspace experience

- [Analytics hub](https://github.com/aryannehe/synapse/blob/main/src/app/(dashboard)/page.tsx): `src/app/(dashboard)/page.tsx`
- [Profile settings](https://github.com/aryannehe/synapse/blob/main/src/app/(dashboard)/profile/page.tsx): `src/app/(dashboard)/profile/page.tsx`
- [Workspace settings](https://github.com/aryannehe/synapse/blob/main/src/app/(dashboard)/settings/page.tsx): `src/app/(dashboard)/settings/page.tsx`
- [Navigation bar](https://github.com/aryannehe/synapse/blob/main/src/components/layout/Navbar.tsx): `src/components/layout/Navbar.tsx`
- [Workspace sidebar](https://github.com/aryannehe/synapse/blob/main/src/components/layout/Sidebar.tsx): `src/components/layout/Sidebar.tsx`
- [App providers](https://github.com/aryannehe/synapse/blob/main/src/components/layout/Providers.tsx): `src/components/layout/Providers.tsx`
- [Workspace services](https://github.com/aryannehe/synapse/blob/main/src/services/serviceLayer.ts): `src/services/serviceLayer.ts`
- [Workspace state](https://github.com/aryannehe/synapse/blob/main/src/store/useWorkspaceStore.ts): `src/store/useWorkspaceStore.ts`
- [Analytics API](https://github.com/aryannehe/synapse/blob/main/src/app/api/analytics/route.ts): `src/app/api/analytics/route.ts`

### Knowledge search

- [Knowledge workspace](https://github.com/aryannehe/synapse/blob/main/src/app/(dashboard)/knowledge/page.tsx): `src/app/(dashboard)/knowledge/page.tsx`
- [Knowledge API](https://github.com/aryannehe/synapse/blob/main/src/app/api/knowledge/route.ts): `src/app/api/knowledge/route.ts`
- [Document records](https://github.com/aryannehe/synapse/blob/main/src/models/Document.ts): `src/models/Document.ts`

### Ticket operations

- [Ticket board](https://github.com/aryannehe/synapse/blob/main/src/app/(dashboard)/support/page.tsx): `src/app/(dashboard)/support/page.tsx`
- [Ticket conversation](https://github.com/aryannehe/synapse/blob/main/src/app/(dashboard)/support/%5BticketId%5D/page.tsx): `src/app/(dashboard)/support/[ticketId]/page.tsx`
- [Ticket collection API](https://github.com/aryannehe/synapse/blob/main/src/app/api/tickets/route.ts): `src/app/api/tickets/route.ts`
- [Ticket detail API](https://github.com/aryannehe/synapse/blob/main/src/app/api/tickets/%5BticketId%5D/route.ts): `src/app/api/tickets/[ticketId]/route.ts`
- [Ticket records](https://github.com/aryannehe/synapse/blob/main/src/models/Ticket.ts): `src/models/Ticket.ts`

### AI assistant

- [Prompt playground](https://github.com/aryannehe/synapse/blob/main/src/app/(dashboard)/assistant/page.tsx): `src/app/(dashboard)/assistant/page.tsx`
- [Assistant stream API](https://github.com/aryannehe/synapse/blob/main/src/app/api/assistant/stream/route.ts): `src/app/api/assistant/stream/route.ts`
- [Markdown renderer](https://github.com/aryannehe/synapse/blob/main/src/components/chat/MarkdownRenderer.tsx): `src/components/chat/MarkdownRenderer.tsx`

### Identity and data

- [Authentication APIs](https://github.com/aryannehe/synapse/blob/main/src/app/api/auth/login/route.ts): `src/app/api/auth/login/route.ts`
- [Session and access](https://github.com/aryannehe/synapse/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [User records](https://github.com/aryannehe/synapse/blob/main/src/models/User.ts): `src/models/User.ts`
- [Database connector](https://github.com/aryannehe/synapse/blob/main/src/lib/db.ts): `src/lib/db.ts`
- **MongoDB**
- [Gemini integration](https://github.com/aryannehe/synapse/blob/main/src/lib/ai.ts): `src/lib/ai.ts`

### Other components

- **Workspace user**

## Connections

- Workspace user → Analytics hub: views
- Workspace user → Knowledge workspace: searches
- Workspace user → Ticket board: manages tickets
- Workspace user → Prompt playground: prompts
- Analytics hub → Workspace services: requests stats (evidence: `src/app/(dashboard)/page.tsx`)
- Workspace services → Analytics API: fetches stats (evidence: `src/services/serviceLayer.ts`)
- Knowledge workspace → Workspace services: searches articles (evidence: `src/app/(dashboard)/knowledge/page.tsx`)
- Workspace services → Knowledge API: queries (evidence: `src/services/serviceLayer.ts`)
- Knowledge API → Session and access: checks session (evidence: `src/app/api/knowledge/route.ts`)
- Knowledge API → Database connector: connects (evidence: `src/app/api/knowledge/route.ts`)
- Knowledge API → Document records: searches and writes (evidence: `src/app/api/knowledge/route.ts`)
- Knowledge API → Gemini integration: generates answers (evidence: `src/app/api/knowledge/route.ts`)
- Ticket board → Workspace services: loads tickets (evidence: `src/app/(dashboard)/support/page.tsx`)
- Ticket conversation → Workspace services: updates ticket (evidence: `src/app/(dashboard)/support/[ticketId]/page.tsx`)
- Workspace services → Ticket collection API: requests tickets (evidence: `src/services/serviceLayer.ts`)
- Workspace services → Ticket detail API: requests ticket (evidence: `src/services/serviceLayer.ts`)
- Ticket collection API → Session and access: checks session (evidence: `src/app/api/tickets/route.ts`)
- Ticket collection API → Database connector: connects (evidence: `src/app/api/tickets/route.ts`)
- Ticket collection API → Ticket records: reads and writes (evidence: `src/app/api/tickets/route.ts`)
- Ticket detail API → Session and access: checks session (evidence: `src/app/api/tickets/[ticketId]/route.ts`)
- Ticket detail API → Database connector: connects (evidence: `src/app/api/tickets/[ticketId]/route.ts`)
- Ticket detail API → Ticket records: reads and updates (evidence: `src/app/api/tickets/[ticketId]/route.ts`)
- Prompt playground → Workspace services: streams response (evidence: `src/app/(dashboard)/assistant/page.tsx`)
- Workspace services → Assistant stream API: opens stream (evidence: `src/services/serviceLayer.ts`)
- Prompt playground → Markdown renderer: renders replies (evidence: `src/app/(dashboard)/assistant/page.tsx`)
- Assistant stream API → Gemini integration: uses AI (evidence: `src/app/api/assistant/stream/route.ts`)
- Knowledge workspace → Workspace state: uses state (evidence: `src/app/(dashboard)/knowledge/page.tsx`)
- Ticket board → Workspace state: uses state (evidence: `src/app/(dashboard)/support/page.tsx`)
- Ticket conversation → Workspace state: uses state (evidence: `src/app/(dashboard)/support/[ticketId]/page.tsx`)
- Prompt playground → Workspace state: uses state (evidence: `src/app/(dashboard)/assistant/page.tsx`)
- Workspace state → Authentication APIs: submits login (evidence: `src/store/useWorkspaceStore.ts`)
- Authentication APIs → Session and access: signs session (evidence: `src/app/api/auth/login/route.ts`)
- Authentication APIs → Database connector: connects (evidence: `src/app/api/auth/login/route.ts`)
- Authentication APIs → User records: checks user (evidence: `src/app/api/auth/login/route.ts`)
- Session and access → Database connector: connects (evidence: `src/lib/auth.ts`)
- Session and access → User records: loads user (evidence: `src/lib/auth.ts`)
- Database connector → MongoDB: connects (evidence: `src/lib/db.ts`)
- Analytics API → Session and access: checks session (evidence: `src/app/api/analytics/route.ts`)
- Analytics API → Database connector: connects (evidence: `src/app/api/analytics/route.ts`)
- Analytics API → Ticket records: aggregates tickets (evidence: `src/app/api/analytics/route.ts`)
- Analytics API → Document records: aggregates documents (evidence: `src/app/api/analytics/route.ts`)
- Analytics API → User records: counts users (evidence: `src/app/api/analytics/route.ts`)
