# omarbadawy/audiocomms-podcast-api architecture

> Architecture diagram of the GitHub repository omarbadawy/audiocomms-podcast-api, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/omarbadawy/audiocomms-podcast-api
- Repository: https://github.com/omarbadawy/audiocomms-podcast-api

## Overview

This is a Node/Express API for audio rooms and podcast publishing, with JWT-authenticated HTTP endpoints and Socket.IO room communication. The main workflow is a client request through app.js and feature routes to controllers, which validate or transform domain data and read or write MongoDB-backed models; clients can also join the real-time room workflow. The README’s user/follow, podcast, event, category, room, and chat capabilities are represented. Some controller and route source was not sampled, so uncertain internal links are omitted.

Main entry points: [`app.js`](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/app.js) (HTTP app), [`server.js`](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/server.js) (HTTP and sockets), [`routes/userRoutes.js`](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/routes/userRoutes.js) (User routes), [`routes/podcastRoutes.js`](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/routes/podcastRoutes.js) (Podcast routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_app["HTTP app<br/>[app.js]"]
  node_server["HTTP and sockets<br/>[server.js]"]
  node_user_routes["User routes<br/>[userRoutes.js]"]
  node_podcast_routes["Podcast routes<br/>[podcastRoutes.js]"]
  node_category_routes["Category routes<br/>[categoryRoutes.js]"]
  node_event_routes["Event routes<br/>[eventRoute.js]"]
  node_room_routes["Room routes<br/>[roomRoutes.js]"]
  node_chat_routes["Chat routes<br/>[roomChatRoute.js]"]
end

subgraph group_identity["Identity and users"]
  node_auth["JWT authentication<br/>[authController.js]"]
  node_users["User and follow management<br/>[userController.js]"]
  node_follows["Follow actions"]
end

subgraph group_content["Podcast and events"]
  node_podcasts["Podcast management"]
  node_events["Event management"]
  node_categories["Category management"]
  node_likes["Podcast likes<br/>[likesController.js]"]
end

subgraph group_rooms["Audio rooms"]
  node_rooms_api["Room queries<br/>[roomController.js]"]
  node_socket["Room socket handling"]
  node_room_chat["Chat queries"]
end

subgraph group_persistence["Persistence and integrations"]
  node_database[("MongoDB")]
  node_cloudinary["Cloudinary"]
  node_email["Email provider"]
  node_rtc["RTC token utility<br/>[generateRTC.js]"]
end

node_client(("API client"))

node_client -->|"sends HTTP"| node_app
node_app -->|"mounts routes"| node_user_routes
node_app -->|"mounts routes"| node_podcast_routes
node_app -->|"mounts routes"| node_category_routes
node_app -->|"mounts routes"| node_event_routes
node_app -->|"mounts routes"| node_room_routes
node_app -->|"mounts routes"| node_chat_routes
node_user_routes -->|"dispatches auth"| node_auth
node_user_routes -->|"dispatches users"| node_users
node_user_routes -->|"dispatches follows"| node_follows
node_podcast_routes -->|"guards access"| node_auth
node_podcast_routes -->|"dispatches podcasts"| node_podcasts
node_podcast_routes -->|"mounts likes"| node_likes
node_category_routes -->|"dispatches categories"| node_categories
node_event_routes -->|"dispatches events"| node_events
node_room_routes -->|"dispatches rooms"| node_rooms_api
node_room_routes -->|"mounts chat"| node_chat_routes
node_chat_routes -->|"dispatches chat"| node_room_chat
node_server -->|"serves HTTP"| node_app
node_client -->|"opens socket"| node_server
node_server -->|"dispatches connections"| node_socket
node_server -->|"connects database"| node_database
node_server -->|"configures media"| node_cloudinary
node_auth -->|"reads and writes users"| node_database
node_auth -->|"sends reset email"| node_email
node_users -->|"reads and writes users"| node_database
node_follows -->|"reads and writes follows"| node_database
node_podcasts -->|"reads and writes content"| node_database
node_podcasts -->|"manages media"| node_cloudinary
node_podcasts -->|"generates signature"| node_rtc
node_categories -->|"reads and writes categories"| node_database
node_events -->|"reads and writes events"| node_database
node_likes -->|"reads and writes likes"| node_database
node_rooms_api -->|"reads rooms"| node_database
node_room_chat -->|"reads and writes messages"| node_database
node_socket -->|"reads and writes room data"| node_database

click node_app "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/app.js"
click node_server "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/server.js"
click node_user_routes "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/routes/userRoutes.js"
click node_podcast_routes "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/routes/podcastRoutes.js"
click node_category_routes "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/routes/categoryRoutes.js"
click node_event_routes "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/routes/eventRoute.js"
click node_room_routes "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/routes/roomRoutes.js"
click node_chat_routes "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/routes/roomChatRoute.js"
click node_auth "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/authController.js"
click node_users "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/userController.js"
click node_follows "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/followController.js"
click node_podcasts "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/podcastController.js"
click node_events "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/eventsController.js"
click node_categories "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/categoryController.js"
click node_likes "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/likesController.js"
click node_rooms_api "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/roomController.js"
click node_socket "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/socketIOController.js"
click node_room_chat "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/roomChatController.js"
click node_rtc "https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/utils/generateRTC.js"

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_server,node_user_routes,node_podcast_routes,node_category_routes,node_event_routes,node_room_routes,node_chat_routes,node_client toneBlue
class node_auth,node_users,node_follows toneAmber
class node_podcasts,node_events,node_categories,node_likes toneMint
class node_rooms_api,node_socket,node_room_chat toneRose
class node_database,node_cloudinary,node_email,node_rtc toneIndigo
```

## Components

### API entry

- [HTTP app](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/app.js): `app.js`
- [HTTP and sockets](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/server.js): `server.js`
- [User routes](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/routes/userRoutes.js): `routes/userRoutes.js`
- [Podcast routes](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/routes/podcastRoutes.js): `routes/podcastRoutes.js`
- [Category routes](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/routes/categoryRoutes.js): `routes/categoryRoutes.js`
- [Event routes](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/routes/eventRoute.js): `routes/eventRoute.js`
- [Room routes](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/routes/roomRoutes.js): `routes/roomRoutes.js`
- [Chat routes](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/routes/roomChatRoute.js): `routes/roomChatRoute.js`

### Identity and users

- [JWT authentication](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/authController.js): `controllers/authController.js`
- [User and follow management](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/userController.js): `controllers/userController.js`
- [Follow actions](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/followController.js): `controllers/followController.js`

### Podcast and events

- [Podcast management](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/podcastController.js): `controllers/podcastController.js`
- [Event management](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/eventsController.js): `controllers/eventsController.js`
- [Category management](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/categoryController.js): `controllers/categoryController.js`
- [Podcast likes](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/likesController.js): `controllers/likesController.js`

### Audio rooms

- [Room queries](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/roomController.js): `controllers/roomController.js`
- [Room socket handling](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/socketIOController.js): `controllers/socketIOController.js`
- [Chat queries](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/controllers/roomChatController.js): `controllers/roomChatController.js`

### Persistence and integrations

- **MongoDB**
- **Cloudinary**
- **Email provider**
- [RTC token utility](https://github.com/omarbadawy/audiocomms-podcast-api/blob/main/utils/generateRTC.js): `utils/generateRTC.js`

### Other components

- **API client**

## Connections

- API client → HTTP app: sends HTTP
- HTTP app → User routes: mounts routes
- HTTP app → Podcast routes: mounts routes
- HTTP app → Category routes: mounts routes
- HTTP app → Event routes: mounts routes
- HTTP app → Room routes: mounts routes
- HTTP app → Chat routes: mounts routes
- User routes → JWT authentication: dispatches auth
- User routes → User and follow management: dispatches users
- User routes → Follow actions: dispatches follows
- Podcast routes → JWT authentication: guards access
- Podcast routes → Podcast management: dispatches podcasts
- Podcast routes → Podcast likes: mounts likes
- Category routes → Category management: dispatches categories
- Event routes → Event management: dispatches events
- Room routes → Room queries: dispatches rooms
- Room routes → Chat routes: mounts chat
- Chat routes → Chat queries: dispatches chat
- HTTP and sockets → HTTP app: serves HTTP
- API client → HTTP and sockets: opens socket
- HTTP and sockets → Room socket handling: dispatches connections
- HTTP and sockets → MongoDB: connects database
- HTTP and sockets → Cloudinary: configures media
- JWT authentication → MongoDB: reads and writes users
- JWT authentication → Email provider: sends reset email
- User and follow management → MongoDB: reads and writes users
- Follow actions → MongoDB: reads and writes follows
- Podcast management → MongoDB: reads and writes content
- Podcast management → Cloudinary: manages media
- Podcast management → RTC token utility: generates signature
- Category management → MongoDB: reads and writes categories
- Event management → MongoDB: reads and writes events
- Podcast likes → MongoDB: reads and writes likes
- Room queries → MongoDB: reads rooms
- Chat queries → MongoDB: reads and writes messages
- Room socket handling → MongoDB: reads and writes room data