# ashwinipoojary-01/ai-meeting-copilot architecture

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

- Interactive diagram: https://gitdiagram.com/ashwinipoojary-01/ai-meeting-copilot
- Repository: https://github.com/ashwinipoojary-01/ai-meeting-copilot

## Overview

AI Meeting Copilot is a React workspace backed by an Express API and PostgreSQL. Users browse and manage meetings, process demo records into transcripts, decisions, and action items, then search transcripts or ask questions with cited meeting sources. The graph emphasizes those product stages and the API/database boundary. Frontend request details beyond the dashboard hook and route wiring are partly unsampled; dashed edges indicate documented but not directly shown calls.

Main entry points: [`artifacts/api-server/src/routes/index.ts`](https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/routes/index.ts) (API Router), [`artifacts/api-server/src/routes/intelligence.ts`](https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/routes/intelligence.ts) (Dashboard and Search), [`lib/db/src/schema/meetings.ts`](https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/lib/db/src/schema/meetings.ts) (PostgreSQL Records), [`artifacts/ai-meeting-copilot/src/App.tsx`](https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/ai-meeting-copilot/src/App.tsx) (React Workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Meeting Workspace"]
  node_web["React Workspace<br/>[App.tsx]"]
  node_client["Typed API Client<br/>[custom-fetch.ts]"]
end

subgraph group_service["API Service"]
  node_server["Express Application<br/>[app.ts]"]
  node_routes["API Router<br/>[index.ts]"]
  node_meetings["Meeting Records<br/>[meetings.ts]"]
  node_actions["Action Items<br/>[action-items.ts]"]
  node_health["Health Check<br/>[health.ts]"]
end

subgraph group_knowledge["Meeting Intelligence"]
  node_intelligence["Dashboard and Search<br/>[intelligence.ts]"]
  node_transcript["Transcript Retrieval<br/>[intelligence.ts]"]
  node_grounded["Grounded Answers<br/>[intelligence.ts]"]
end

subgraph group_storage["Data Storage"]
  node_db[("PostgreSQL Records<br/>[meetings.ts]")]
end

node_user(("Workspace User"))

node_user -->|"uses"| node_web
node_web -.->|"requests data"| node_client
node_client -.->|"calls API"| node_server
node_server -->|"mounts API"| node_routes
node_routes -->|"routes meetings"| node_meetings
node_routes -->|"routes actions"| node_actions
node_routes -->|"routes health"| node_health
node_routes -->|"routes intelligence"| node_intelligence
node_meetings -->|"reads and writes"| node_db
node_actions -->|"reads and updates"| node_db
node_intelligence -->|"queries records"| node_db
node_intelligence -->|"retrieves segments"| node_transcript
node_transcript -->|"supplies sources"| node_grounded

click node_web "https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/ai-meeting-copilot/src/App.tsx"
click node_client "https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/lib/api-client-react/src/custom-fetch.ts"
click node_server "https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/app.ts"
click node_routes "https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/routes/index.ts"
click node_meetings "https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/routes/meetings.ts"
click node_actions "https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/routes/action-items.ts"
click node_health "https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/routes/health.ts"
click node_intelligence "https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/routes/intelligence.ts"
click node_transcript "https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/routes/intelligence.ts"
click node_grounded "https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/routes/intelligence.ts"
click node_db "https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/lib/db/src/schema/meetings.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_web,node_client,node_user toneBlue
class node_server,node_routes,node_meetings,node_actions,node_health toneAmber
class node_intelligence,node_transcript,node_grounded toneMint
class node_db toneRose
```

## Components

### Meeting Workspace

- [React Workspace](https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/ai-meeting-copilot/src/App.tsx): `artifacts/ai-meeting-copilot/src/App.tsx`
- [Typed API Client](https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/lib/api-client-react/src/custom-fetch.ts): `lib/api-client-react/src/custom-fetch.ts`

### API Service

- [Express Application](https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/app.ts): `artifacts/api-server/src/app.ts`
- [API Router](https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/routes/index.ts): `artifacts/api-server/src/routes/index.ts`
- [Meeting Records](https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/routes/meetings.ts): `artifacts/api-server/src/routes/meetings.ts`
- [Action Items](https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/routes/action-items.ts): `artifacts/api-server/src/routes/action-items.ts`
- [Health Check](https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/routes/health.ts): `artifacts/api-server/src/routes/health.ts`

### Meeting Intelligence

- [Dashboard and Search](https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/routes/intelligence.ts): `artifacts/api-server/src/routes/intelligence.ts`
- [Transcript Retrieval](https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/routes/intelligence.ts): `artifacts/api-server/src/routes/intelligence.ts`
- [Grounded Answers](https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/artifacts/api-server/src/routes/intelligence.ts): `artifacts/api-server/src/routes/intelligence.ts`

### Data Storage

- [PostgreSQL Records](https://github.com/ashwinipoojary-01/ai-meeting-copilot/blob/main/lib/db/src/schema/meetings.ts): `lib/db/src/schema/meetings.ts`

### Other components

- **Workspace User**

## Connections

- Workspace User → React Workspace: uses
- React Workspace → Typed API Client: requests data
- Typed API Client → Express Application: calls API
- Express Application → API Router: mounts API (evidence: `artifacts/api-server/src/app.ts`)
- API Router → Meeting Records: routes meetings (evidence: `artifacts/api-server/src/routes/index.ts`)
- API Router → Action Items: routes actions (evidence: `artifacts/api-server/src/routes/index.ts`)
- API Router → Health Check: routes health (evidence: `artifacts/api-server/src/routes/index.ts`)
- API Router → Dashboard and Search: routes intelligence (evidence: `artifacts/api-server/src/routes/index.ts`)
- Meeting Records → PostgreSQL Records: reads and writes (evidence: `artifacts/api-server/src/routes/meetings.ts`)
- Action Items → PostgreSQL Records: reads and updates (evidence: `artifacts/api-server/src/routes/action-items.ts`)
- Dashboard and Search → PostgreSQL Records: queries records (evidence: `artifacts/api-server/src/routes/intelligence.ts`)
- Dashboard and Search → Transcript Retrieval: retrieves segments (evidence: `artifacts/api-server/src/routes/intelligence.ts`)
- Transcript Retrieval → Grounded Answers: supplies sources (evidence: `artifacts/api-server/src/routes/intelligence.ts`)
