# sandeshshirse/sutrameet architecture

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

- Interactive diagram: https://gitdiagram.com/sandeshshirse/sutrameet
- Repository: https://github.com/sandeshshirse/sutrameet

## Overview

This is a live meeting and student-issue coordination web app with administrator, participant, and projection-display roles. The principal workflow is role selection, shared session-state delivery, participant issue and doubt activity, and administrator moderation or meeting preparation, with the display presenting live agenda and poll information. The server keeps session data in memory and synchronizes it over Socket.IO. Source excerpts establish the app shell, role views, seed data, and selected rendering/helper relationships; unsampled behavior is not inferred.

Main entry points: [`src/App.tsx`](https://github.com/sandeshshirse/sutrameet/blob/main/src/App.tsx) (Role coordinator), [`src/components/AdminPlatform.tsx`](https://github.com/sandeshshirse/sutrameet/blob/main/src/components/AdminPlatform.tsx) (Admin workspace), [`src/components/ParticipantPlatform.tsx`](https://github.com/sandeshshirse/sutrameet/blob/main/src/components/ParticipantPlatform.tsx) (Participant workspace), [`server.ts`](https://github.com/sandeshshirse/sutrameet/blob/main/server.ts) (Socket server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["App shell"]
  node_entry["React entry<br/>[main.tsx]"]
  node_app["Role coordinator<br/>[App.tsx]"]
  node_rolepick["Role picker<br/>[RolePicker.tsx]"]
  node_rolebar["Role switcher<br/>[RoleBar.tsx]"]
end

subgraph group_meeting["Meeting management"]
  node_admin["Admin workspace<br/>[AdminPlatform.tsx]"]
  node_agenda["Agenda builder<br/>[AgendaBuilder.tsx]"]
  node_pollcreate["Poll creator<br/>[PollCreator.tsx]"]
  node_analytics["Meeting analytics<br/>[AnalyticsPanel.tsx]"]
  node_display["Live display"]
end

subgraph group_participation["Participant experience"]
  node_participant["Participant workspace"]
  node_issuecard["Issue card<br/>[IssueCard.tsx]"]
end

subgraph group_runtime["Session runtime"]
  node_server["Socket server<br/>[server.ts]"]
  node_sessionstate[("In-memory session state<br/>[server.ts]")]
  node_seed["Initial meeting data<br/>[mockData.ts]"]
  node_helpers["Issue and time helpers<br/>[utils.ts]"]
  node_types["Domain types<br/>[types.ts]"]
end

node_browser(("Meeting users"))

node_browser -->|"opens app"| node_entry
node_entry -->|"renders"| node_app
node_app -->|"selects role"| node_rolepick
node_app -->|"shows role"| node_rolebar
node_app -->|"renders admin"| node_admin
node_app -->|"renders participant"| node_participant
node_app -->|"renders display"| node_display
node_admin -->|"renders builder"| node_agenda
node_admin -.-> node_pollcreate
node_admin -.-> node_analytics
node_participant -->|"renders issues"| node_issuecard
node_app -->|"connects by socket"| node_server
node_server -->|"sends initial state"| node_app
node_server -->|"updates and broadcasts"| node_sessionstate
node_server -->|"loads initial data"| node_seed
node_admin -->|"sorts issues"| node_helpers
node_participant -.->|"sorts issues"| node_helpers
node_participant -->|"uses priority helper"| node_issuecard
node_display -->|"formats and sorts"| node_helpers

click node_entry "https://github.com/sandeshshirse/sutrameet/blob/main/src/main.tsx"
click node_app "https://github.com/sandeshshirse/sutrameet/blob/main/src/App.tsx"
click node_rolepick "https://github.com/sandeshshirse/sutrameet/blob/main/src/components/RolePicker.tsx"
click node_rolebar "https://github.com/sandeshshirse/sutrameet/blob/main/src/components/RoleBar.tsx"
click node_admin "https://github.com/sandeshshirse/sutrameet/blob/main/src/components/AdminPlatform.tsx"
click node_agenda "https://github.com/sandeshshirse/sutrameet/blob/main/src/components/admin/AgendaBuilder.tsx"
click node_pollcreate "https://github.com/sandeshshirse/sutrameet/blob/main/src/components/admin/PollCreator.tsx"
click node_analytics "https://github.com/sandeshshirse/sutrameet/blob/main/src/components/admin/AnalyticsPanel.tsx"
click node_participant "https://github.com/sandeshshirse/sutrameet/blob/main/src/components/ParticipantPlatform.tsx"
click node_issuecard "https://github.com/sandeshshirse/sutrameet/blob/main/src/components/IssueCard.tsx"
click node_display "https://github.com/sandeshshirse/sutrameet/blob/main/src/components/DisplayPlatform.tsx"
click node_server "https://github.com/sandeshshirse/sutrameet/blob/main/server.ts"
click node_sessionstate "https://github.com/sandeshshirse/sutrameet/blob/main/server.ts"
click node_seed "https://github.com/sandeshshirse/sutrameet/blob/main/src/lib/mockData.ts"
click node_helpers "https://github.com/sandeshshirse/sutrameet/blob/main/src/lib/utils.ts"
click node_types "https://github.com/sandeshshirse/sutrameet/blob/main/src/types.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_entry,node_app,node_rolepick,node_rolebar,node_browser toneBlue
class node_admin,node_agenda,node_pollcreate,node_analytics,node_display toneAmber
class node_participant,node_issuecard toneMint
class node_server,node_sessionstate,node_seed,node_helpers,node_types toneRose
```

## Components

### App shell

- [React entry](https://github.com/sandeshshirse/sutrameet/blob/main/src/main.tsx): `src/main.tsx`
- [Role coordinator](https://github.com/sandeshshirse/sutrameet/blob/main/src/App.tsx): `src/App.tsx`
- [Role picker](https://github.com/sandeshshirse/sutrameet/blob/main/src/components/RolePicker.tsx): `src/components/RolePicker.tsx`
- [Role switcher](https://github.com/sandeshshirse/sutrameet/blob/main/src/components/RoleBar.tsx): `src/components/RoleBar.tsx`

### Meeting management

- [Admin workspace](https://github.com/sandeshshirse/sutrameet/blob/main/src/components/AdminPlatform.tsx): `src/components/AdminPlatform.tsx`
- [Agenda builder](https://github.com/sandeshshirse/sutrameet/blob/main/src/components/admin/AgendaBuilder.tsx): `src/components/admin/AgendaBuilder.tsx`
- [Poll creator](https://github.com/sandeshshirse/sutrameet/blob/main/src/components/admin/PollCreator.tsx): `src/components/admin/PollCreator.tsx`
- [Meeting analytics](https://github.com/sandeshshirse/sutrameet/blob/main/src/components/admin/AnalyticsPanel.tsx): `src/components/admin/AnalyticsPanel.tsx`
- [Live display](https://github.com/sandeshshirse/sutrameet/blob/main/src/components/DisplayPlatform.tsx): `src/components/DisplayPlatform.tsx`

### Participant experience

- [Participant workspace](https://github.com/sandeshshirse/sutrameet/blob/main/src/components/ParticipantPlatform.tsx): `src/components/ParticipantPlatform.tsx`
- [Issue card](https://github.com/sandeshshirse/sutrameet/blob/main/src/components/IssueCard.tsx): `src/components/IssueCard.tsx`

### Session runtime

- [Socket server](https://github.com/sandeshshirse/sutrameet/blob/main/server.ts): `server.ts`
- [In-memory session state](https://github.com/sandeshshirse/sutrameet/blob/main/server.ts): `server.ts`
- [Initial meeting data](https://github.com/sandeshshirse/sutrameet/blob/main/src/lib/mockData.ts): `src/lib/mockData.ts`
- [Issue and time helpers](https://github.com/sandeshshirse/sutrameet/blob/main/src/lib/utils.ts): `src/lib/utils.ts`
- [Domain types](https://github.com/sandeshshirse/sutrameet/blob/main/src/types.ts): `src/types.ts`

### Other components

- **Meeting users**

## Connections

- Meeting users → React entry: opens app
- React entry → Role coordinator: renders (evidence: `src/main.tsx`)
- Role coordinator → Role picker: selects role (evidence: `src/App.tsx`)
- Role coordinator → Role switcher: shows role (evidence: `src/App.tsx`)
- Role coordinator → Admin workspace: renders admin (evidence: `src/App.tsx`)
- Role coordinator → Participant workspace: renders participant (evidence: `src/App.tsx`)
- Role coordinator → Live display: renders display (evidence: `src/App.tsx`)
- Admin workspace → Agenda builder: renders builder (evidence: `src/components/AdminPlatform.tsx`)
- Admin workspace → Poll creator (evidence: `src/components/AdminPlatform.tsx`)
- Admin workspace → Meeting analytics (evidence: `src/components/AdminPlatform.tsx`)
- Participant workspace → Issue card: renders issues (evidence: `src/components/ParticipantPlatform.tsx`)
- Role coordinator → Socket server: connects by socket (evidence: `src/App.tsx`)
- Socket server → Role coordinator: sends initial state (evidence: `server.ts`)
- Socket server → In-memory session state: updates and broadcasts (evidence: `server.ts`)
- Socket server → Initial meeting data: loads initial data (evidence: `server.ts`)
- Admin workspace → Issue and time helpers: sorts issues (evidence: `src/components/AdminPlatform.tsx`)
- Participant workspace → Issue and time helpers: sorts issues (evidence: `src/components/ParticipantPlatform.tsx`)
- Participant workspace → Issue card: uses priority helper (evidence: `src/components/IssueCard.tsx`)
- Live display → Issue and time helpers: formats and sorts (evidence: `src/components/DisplayPlatform.tsx`)
