# usmancodehub/codealpha_tasks architecture

> Architecture diagram of the GitHub repository usmancodehub/codealpha_tasks, 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/usmancodehub/codealpha_tasks
- Repository: https://github.com/usmancodehub/codealpha_tasks

## Overview

This repository contains three separate web products: an online store, a social feed, and a real-time collaboration app. Their main flows run from browser interaction through server routes to domain models; the collaboration app also supports room-based video, chat, a whiteboard, and file sharing. The graph preserves those distinct capabilities. Some client and route implementations are indexed but not excerpted, so uncertain links are omitted; dashed links mark the collaboration socket connection implied by the room and server modules.

Main entry points: [`realtime-collab-app/client/src/App.jsx`](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/App.jsx) (App router), [`realtime-collab-app/client/src/pages/Room.jsx`](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/pages/Room.jsx) (Collaboration room), [`mini-social-app/routes/posts.js`](https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/routes/posts.js) (Post routes), [`ecommerce-store/server.js`](https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/server.js) (Store server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_store["Online store"]
  node_storefront["Storefront UI<br/>[app.js]"]
  node_store_server["Store server<br/>[server.js]"]
  node_product_routes["Product routes<br/>[products.js]"]
  node_product_model[("Product catalog<br/>[Product.js]")]
  node_user_routes["User routes<br/>[users.js]"]
  node_store_user_model[("Store users<br/>[User.js]")]
  node_order_routes["Order routes<br/>[orders.js]"]
  node_order_model[("Orders<br/>[Order.js]")]
end

subgraph group_social["Social feed"]
  node_social_client["Social UI<br/>[app.js]"]
  node_social_server["Social server<br/>[server.js]"]
  node_social_auth_routes["Auth routes<br/>[auth.js]"]
  node_social_auth["Token middleware<br/>[auth.js]"]
  node_social_users[("Social users<br/>[User.js]")]
  node_post_routes["Post routes<br/>[posts.js]"]
  node_posts[("Posts<br/>[Post.js]")]
  node_comments[("Comments<br/>[Comment.js]")]
end

subgraph group_collab_client["Collaboration client"]
  node_collab_app["App router<br/>[App.jsx]"]
  node_auth_context["Client auth<br/>[AuthContext.jsx]"]
  node_login_page["Login page<br/>[Login.jsx]"]
  node_register_page["Registration page<br/>[Register.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_room["Collaboration room<br/>[Room.jsx]"]
  node_chat["Room chat<br/>[Chat.jsx]"]
  node_board["Whiteboard<br/>[WhiteBoard.jsx]"]
  node_file_share["File sharing UI<br/>[FileShare.jsx]"]
  node_video["Video tiles<br/>[VideoPlayer.jsx]"]
end

subgraph group_collab_server["Collaboration server"]
  node_collab_server["Collaboration server<br/>[server.js]"]
  node_collab_auth_routes["Auth routes<br/>[auth.js]"]
  node_collab_users[("Users<br/>[User.js]")]
  node_file_routes["File routes<br/>[files.js]"]
  node_file_model[("File records<br/>[File.js]")]
end

node_shopper(("Shopper"))
node_social_user(("Social user"))
node_collab_user(("Collaborator"))

node_store_server -->|"mounts routes"| node_product_routes
node_store_server -->|"mounts routes"| node_user_routes
node_store_server -->|"mounts routes"| node_order_routes
node_store_server -->|"serves static UI"| node_storefront
node_product_routes -->|"reads and seeds"| node_product_model
node_user_routes -->|"uses users"| node_store_user_model
node_order_routes -->|"uses orders"| node_order_model
node_social_server -->|"mounts routes"| node_social_auth_routes
node_social_server -->|"mounts routes"| node_post_routes
node_social_server -->|"serves static UI"| node_social_client
node_social_auth_routes -->|"reads and saves"| node_social_users
node_post_routes -->|"checks token"| node_social_auth
node_post_routes -->|"reads and saves"| node_posts
node_post_routes -->|"creates comments"| node_comments
node_post_routes -->|"populates authors"| node_social_users
node_collab_app -->|"provides auth"| node_auth_context
node_collab_app -->|"routes to"| node_login_page
node_collab_app -->|"routes to"| node_register_page
node_collab_app -->|"routes to"| node_dashboard
node_collab_app -->|"routes to"| node_room
node_auth_context -->|"calls auth API"| node_collab_auth_routes
node_collab_server -->|"mounts routes"| node_collab_auth_routes
node_collab_server -->|"mounts routes"| node_file_routes
node_collab_server -.->|"socket events"| node_room
node_collab_auth_routes -->|"reads and saves"| node_collab_users
node_file_routes -->|"uses file records"| node_file_model
node_room -->|"renders"| node_chat
node_room -->|"renders"| node_board
node_room -->|"renders"| node_file_share
node_room -->|"renders"| node_video
node_collab_user -.->|"uses UI"| node_collab_app
node_social_user -.->|"uses UI"| node_social_client
node_shopper -.->|"uses UI"| node_storefront

click node_storefront "https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/public/js/app.js"
click node_store_server "https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/server.js"
click node_product_routes "https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/routes/products.js"
click node_product_model "https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/models/Product.js"
click node_user_routes "https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/routes/users.js"
click node_store_user_model "https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/models/User.js"
click node_order_routes "https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/routes/orders.js"
click node_order_model "https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/models/Order.js"
click node_social_client "https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/public/js/app.js"
click node_social_server "https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/server.js"
click node_social_auth_routes "https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/routes/auth.js"
click node_social_auth "https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/middleware/auth.js"
click node_social_users "https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/models/User.js"
click node_post_routes "https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/routes/posts.js"
click node_posts "https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/models/Post.js"
click node_comments "https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/models/Comment.js"
click node_collab_app "https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/App.jsx"
click node_auth_context "https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/context/AuthContext.jsx"
click node_login_page "https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/pages/Login.jsx"
click node_register_page "https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/pages/Register.jsx"
click node_dashboard "https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/pages/Dashboard.jsx"
click node_room "https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/pages/Room.jsx"
click node_chat "https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/components/Chat.jsx"
click node_board "https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/components/WhiteBoard.jsx"
click node_file_share "https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/components/FileShare.jsx"
click node_video "https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/components/VideoPlayer.jsx"
click node_collab_server "https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/server/server.js"
click node_collab_auth_routes "https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/server/routes/auth.js"
click node_collab_users "https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/server/models/User.js"
click node_file_routes "https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/server/routes/files.js"
click node_file_model "https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/server/models/File.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_storefront,node_store_server,node_product_routes,node_product_model,node_user_routes,node_store_user_model,node_order_routes,node_order_model,node_social_user toneBlue
class node_social_client,node_social_server,node_social_auth_routes,node_social_auth,node_social_users,node_post_routes,node_posts,node_comments toneAmber
class node_collab_app,node_auth_context,node_login_page,node_register_page,node_dashboard,node_room,node_chat,node_board,node_file_share,node_video toneMint
class node_collab_server,node_collab_auth_routes,node_collab_users,node_file_routes,node_file_model toneRose
class node_shopper,node_collab_user toneIndigo
```

## Components

### Online store

- [Storefront UI](https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/public/js/app.js): `ecommerce-store/public/js/app.js`
- [Store server](https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/server.js): `ecommerce-store/server.js`
- [Product routes](https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/routes/products.js): `ecommerce-store/routes/products.js`
- [Product catalog](https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/models/Product.js): `ecommerce-store/models/Product.js`
- [User routes](https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/routes/users.js): `ecommerce-store/routes/users.js`
- [Store users](https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/models/User.js): `ecommerce-store/models/User.js`
- [Order routes](https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/routes/orders.js): `ecommerce-store/routes/orders.js`
- [Orders](https://github.com/usmancodehub/codealpha_tasks/blob/main/ecommerce-store/models/Order.js): `ecommerce-store/models/Order.js`

### Social feed

- [Social UI](https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/public/js/app.js): `mini-social-app/public/js/app.js`
- [Social server](https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/server.js): `mini-social-app/server.js`
- [Auth routes](https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/routes/auth.js): `mini-social-app/routes/auth.js`
- [Token middleware](https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/middleware/auth.js): `mini-social-app/middleware/auth.js`
- [Social users](https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/models/User.js): `mini-social-app/models/User.js`
- [Post routes](https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/routes/posts.js): `mini-social-app/routes/posts.js`
- [Posts](https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/models/Post.js): `mini-social-app/models/Post.js`
- [Comments](https://github.com/usmancodehub/codealpha_tasks/blob/main/mini-social-app/models/Comment.js): `mini-social-app/models/Comment.js`

### Collaboration client

- [App router](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/App.jsx): `realtime-collab-app/client/src/App.jsx`
- [Client auth](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/context/AuthContext.jsx): `realtime-collab-app/client/src/context/AuthContext.jsx`
- [Login page](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/pages/Login.jsx): `realtime-collab-app/client/src/pages/Login.jsx`
- [Registration page](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/pages/Register.jsx): `realtime-collab-app/client/src/pages/Register.jsx`
- [Dashboard](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/pages/Dashboard.jsx): `realtime-collab-app/client/src/pages/Dashboard.jsx`
- [Collaboration room](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/pages/Room.jsx): `realtime-collab-app/client/src/pages/Room.jsx`
- [Room chat](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/components/Chat.jsx): `realtime-collab-app/client/src/components/Chat.jsx`
- [Whiteboard](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/components/WhiteBoard.jsx): `realtime-collab-app/client/src/components/WhiteBoard.jsx`
- [File sharing UI](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/components/FileShare.jsx): `realtime-collab-app/client/src/components/FileShare.jsx`
- [Video tiles](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/client/src/components/VideoPlayer.jsx): `realtime-collab-app/client/src/components/VideoPlayer.jsx`

### Collaboration server

- [Collaboration server](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/server/server.js): `realtime-collab-app/server/server.js`
- [Auth routes](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/server/routes/auth.js): `realtime-collab-app/server/routes/auth.js`
- [Users](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/server/models/User.js): `realtime-collab-app/server/models/User.js`
- [File routes](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/server/routes/files.js): `realtime-collab-app/server/routes/files.js`
- [File records](https://github.com/usmancodehub/codealpha_tasks/blob/main/realtime-collab-app/server/models/File.js): `realtime-collab-app/server/models/File.js`

### Other components

- **Shopper**
- **Social user**
- **Collaborator**

## Connections

- Store server → Product routes: mounts routes (evidence: `ecommerce-store/server.js`)
- Store server → User routes: mounts routes (evidence: `ecommerce-store/server.js`)
- Store server → Order routes: mounts routes (evidence: `ecommerce-store/server.js`)
- Store server → Storefront UI: serves static UI (evidence: `ecommerce-store/server.js`)
- Product routes → Product catalog: reads and seeds (evidence: `ecommerce-store/routes/products.js`)
- User routes → Store users: uses users (evidence: `ecommerce-store/routes/users.js`)
- Order routes → Orders: uses orders (evidence: `ecommerce-store/routes/orders.js`)
- Social server → Auth routes: mounts routes (evidence: `mini-social-app/server.js`)
- Social server → Post routes: mounts routes (evidence: `mini-social-app/server.js`)
- Social server → Social UI: serves static UI (evidence: `mini-social-app/server.js`)
- Auth routes → Social users: reads and saves (evidence: `mini-social-app/routes/auth.js`)
- Post routes → Token middleware: checks token (evidence: `mini-social-app/routes/posts.js`)
- Post routes → Posts: reads and saves (evidence: `mini-social-app/routes/posts.js`)
- Post routes → Comments: creates comments (evidence: `mini-social-app/routes/posts.js`)
- Post routes → Social users: populates authors (evidence: `mini-social-app/routes/posts.js`)
- App router → Client auth: provides auth (evidence: `realtime-collab-app/client/src/App.jsx`)
- App router → Login page: routes to (evidence: `realtime-collab-app/client/src/App.jsx`)
- App router → Registration page: routes to (evidence: `realtime-collab-app/client/src/App.jsx`)
- App router → Dashboard: routes to (evidence: `realtime-collab-app/client/src/App.jsx`)
- App router → Collaboration room: routes to (evidence: `realtime-collab-app/client/src/App.jsx`)
- Client auth → Auth routes: calls auth API (evidence: `realtime-collab-app/client/src/context/AuthContext.jsx`)
- Collaboration server → Auth routes: mounts routes (evidence: `realtime-collab-app/server/server.js`)
- Collaboration server → File routes: mounts routes (evidence: `realtime-collab-app/server/server.js`)
- Collaboration server → Collaboration room: socket events
- Auth routes → Users: reads and saves (evidence: `realtime-collab-app/server/routes/auth.js`)
- File routes → File records: uses file records (evidence: `realtime-collab-app/server/routes/files.js`)
- Collaboration room → Room chat: renders (evidence: `realtime-collab-app/client/src/pages/Room.jsx`)
- Collaboration room → Whiteboard: renders (evidence: `realtime-collab-app/client/src/pages/Room.jsx`)
- Collaboration room → File sharing UI: renders (evidence: `realtime-collab-app/client/src/pages/Room.jsx`)
- Collaboration room → Video tiles: renders (evidence: `realtime-collab-app/client/src/pages/Room.jsx`)
- Collaborator → App router: uses UI
- Social user → Social UI: uses UI
- Shopper → Storefront UI: uses UI
