# shouryashinde/devclash-teamlaggayelogs architecture

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

- Interactive diagram: https://gitdiagram.com/shouryashinde/devclash-teamlaggayelogs
- Repository: https://github.com/shouryashinde/devclash-teamlaggayelogs

## Overview

Devclash is a meeting-recording notes demo with two entry paths: Zoom recording webhooks download and process recordings into transcripts and notes, while a browser upload currently returns hard-coded demo notes. Zoom API endpoints also expose user and recording data. The upload and Zoom routes are mounted by the Express app; the processing path is explicit in source. The README is empty, and unsampled views and integrations are not inferred beyond the app’s render calls.

Main entry points: [`src/app.js`](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/app.js) (Express app), [`src/services/processingService.js`](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/services/processingService.js) (Recording processor), [`src/controllers/zoomController.js`](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/controllers/zoomController.js) (Zoom controller), [`src/services/zoomAuth.js`](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/services/zoomAuth.js) (Zoom OAuth)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Express app<br/>[app.js]"]
  node_zoom_routes["Zoom routes<br/>[zoomRoutes.js]"]
  node_uploads[("Uploaded videos")]
end

subgraph group_zoom["Zoom integration"]
  node_zoom_controller["Zoom controller<br/>[zoomController.js]"]
  node_zoom_auth["Zoom OAuth<br/>[zoomAuth.js]"]
end

subgraph group_processing["Recording processing"]
  node_processing_service["Recording processor"]
  node_recording_files[("Recording files")]
  node_ffmpeg["Audio conversion<br/>[ffmpeg.js]"]
  node_transcription["Transcription service"]
  node_whisper_script["Whisper script<br/>[transcribe.py]"]
  node_notes["Notes generator<br/>[aiService.js]"]
end

subgraph group_presentation["User interface"]
  node_home_view["Home page<br/>[home.ejs]"]
  node_dashboard_view["Dashboard<br/>[dashboard.ejs]"]
  node_uploads_view["Uploads page<br/>[uploads.ejs]"]
  node_working_view["Working page<br/>[working.ejs]"]
  node_login_view["Login page<br/>[login.ejs]"]
end

node_user(("Browser user"))
node_zoom_service["Zoom platform"]

node_user -->|"requests pages"| node_app
node_app -->|"mounts routes"| node_zoom_routes
node_zoom_routes -->|"dispatches requests"| node_zoom_controller
node_zoom_service -->|"sends webhooks"| node_zoom_controller
node_zoom_controller -->|"gets token"| node_zoom_auth
node_zoom_controller -->|"fetches users"| node_zoom_service
node_zoom_controller -->|"fetches recordings"| node_zoom_service
node_zoom_auth -->|"requests OAuth token"| node_zoom_service
node_zoom_controller -->|"processes recordings"| node_processing_service
node_processing_service -->|"gets download token"| node_zoom_auth
node_processing_service -->|"writes video"| node_recording_files
node_processing_service -->|"converts video"| node_ffmpeg
node_processing_service -->|"transcribes audio"| node_transcription
node_transcription -->|"runs script"| node_whisper_script
node_processing_service -->|"generates notes"| node_notes
node_user -->|"uploads video"| node_app
node_app -->|"stores upload"| node_uploads
node_app -->|"renders notes"| node_dashboard_view
node_app -->|"renders page"| node_home_view
node_app -->|"renders page"| node_uploads_view
node_app -->|"renders page"| node_working_view
node_app -->|"renders page"| node_login_view

click node_app "https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/app.js"
click node_zoom_routes "https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/routes/zoomRoutes.js"
click node_zoom_controller "https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/controllers/zoomController.js"
click node_zoom_auth "https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/services/zoomAuth.js"
click node_processing_service "https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/services/processingService.js"
click node_recording_files "https://github.com/shouryashinde/devclash-teamlaggayelogs/tree/main/src/uploads"
click node_ffmpeg "https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/utils/ffmpeg.js"
click node_transcription "https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/services/transcriptionService.js"
click node_whisper_script "https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/scripts/transcribe.py"
click node_notes "https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/services/aiService.js"
click node_uploads "https://github.com/shouryashinde/devclash-teamlaggayelogs/tree/main/uploads"
click node_home_view "https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/views/home.ejs"
click node_dashboard_view "https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/views/dashboard.ejs"
click node_uploads_view "https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/views/uploads.ejs"
click node_working_view "https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/views/working.ejs"
click node_login_view "https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/views/login.ejs"

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_app,node_zoom_routes,node_uploads,node_user toneBlue
class node_zoom_controller,node_zoom_auth toneAmber
class node_processing_service,node_recording_files,node_ffmpeg,node_transcription,node_whisper_script,node_notes toneMint
class node_home_view,node_dashboard_view,node_uploads_view,node_working_view,node_login_view toneRose
class node_zoom_service toneIndigo
```

## Components

### Web application

- [Express app](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/app.js): `src/app.js`
- [Zoom routes](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/routes/zoomRoutes.js): `src/routes/zoomRoutes.js`
- [Uploaded videos](https://github.com/shouryashinde/devclash-teamlaggayelogs/tree/main/uploads): `uploads`

### Zoom integration

- [Zoom controller](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/controllers/zoomController.js): `src/controllers/zoomController.js`
- [Zoom OAuth](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/services/zoomAuth.js): `src/services/zoomAuth.js`

### Recording processing

- [Recording processor](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/services/processingService.js): `src/services/processingService.js`
- [Recording files](https://github.com/shouryashinde/devclash-teamlaggayelogs/tree/main/src/uploads): `src/uploads`
- [Audio conversion](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/utils/ffmpeg.js): `src/utils/ffmpeg.js`
- [Transcription service](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/services/transcriptionService.js): `src/services/transcriptionService.js`
- [Whisper script](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/scripts/transcribe.py): `scripts/transcribe.py`
- [Notes generator](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/src/services/aiService.js): `src/services/aiService.js`

### User interface

- [Home page](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/views/home.ejs): `views/home.ejs`
- [Dashboard](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/views/dashboard.ejs): `views/dashboard.ejs`
- [Uploads page](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/views/uploads.ejs): `views/uploads.ejs`
- [Working page](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/views/working.ejs): `views/working.ejs`
- [Login page](https://github.com/shouryashinde/devclash-teamlaggayelogs/blob/main/views/login.ejs): `views/login.ejs`

### Other components

- **Browser user**
- **Zoom platform**

## Connections

- Browser user → Express app: requests pages (evidence: `src/app.js`)
- Express app → Zoom routes: mounts routes (evidence: `src/app.js`)
- Zoom routes → Zoom controller: dispatches requests (evidence: `src/routes/zoomRoutes.js`)
- Zoom platform → Zoom controller: sends webhooks (evidence: `src/controllers/zoomController.js`)
- Zoom controller → Zoom OAuth: gets token (evidence: `src/controllers/zoomController.js`)
- Zoom controller → Zoom platform: fetches users (evidence: `src/controllers/zoomController.js`)
- Zoom controller → Zoom platform: fetches recordings (evidence: `src/controllers/zoomController.js`)
- Zoom OAuth → Zoom platform: requests OAuth token (evidence: `src/services/zoomAuth.js`)
- Zoom controller → Recording processor: processes recordings (evidence: `src/controllers/zoomController.js`)
- Recording processor → Zoom OAuth: gets download token (evidence: `src/services/processingService.js`)
- Recording processor → Recording files: writes video (evidence: `src/services/processingService.js`)
- Recording processor → Audio conversion: converts video (evidence: `src/services/processingService.js`)
- Recording processor → Transcription service: transcribes audio (evidence: `src/services/processingService.js`)
- Transcription service → Whisper script: runs script (evidence: `src/services/transcriptionService.js`)
- Recording processor → Notes generator: generates notes (evidence: `src/services/processingService.js`)
- Browser user → Express app: uploads video (evidence: `src/app.js`)
- Express app → Uploaded videos: stores upload (evidence: `src/app.js`)
- Express app → Dashboard: renders notes (evidence: `src/app.js`)
- Express app → Home page: renders page (evidence: `src/app.js`)
- Express app → Uploads page: renders page (evidence: `src/app.js`)
- Express app → Working page: renders page (evidence: `src/app.js`)
- Express app → Login page: renders page (evidence: `src/app.js`)
