# glebweider/taskboard architecture

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

- Interactive diagram: https://gitdiagram.com/glebweider/taskboard
- Repository: https://github.com/glebweider/taskboard

## Overview

Taskboard is a collaborative Kanban task manager. Users authenticate with Discord, enter the protected project workspace, and manage projects, boards, lists, and cards; the task view fetches the user’s assigned tasks and links back to their project. The backend also supports invitations, project membership, activity/SSE updates, caching, and card-file handling. Frontend routing and several backend call paths are visible in excerpts; unsampled subsystem links are omitted or marked unverified rather than inferred as confirmed calls.

Main entry points: [`Backend/src/project/service/project.service.ts`](https://github.com/glebweider/taskboard/blob/main/Backend/src/project/service/project.service.ts) (Project service), [`Backend/src/project/service/card.service.ts`](https://github.com/glebweider/taskboard/blob/main/Backend/src/project/service/card.service.ts) (Card service), [`FrontEnd/src/App.tsx`](https://github.com/glebweider/taskboard/blob/main/FrontEnd/src/App.tsx) (Route application), [`Backend/src/project/project.controller.ts`](https://github.com/glebweider/taskboard/blob/main/Backend/src/project/project.controller.ts) (Project routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_app["Route application<br/>[App.tsx]"]
  node_authpage["Sign-in page<br/>[AuthPage.tsx]"]
  node_callback["OAuth callback<br/>[CallbackPage.tsx]"]
  node_projects["Projects page<br/>[ProjectsPage.tsx]"]
  node_tasks["Assigned tasks<br/>[TasksPage.tsx]"]
  node_projectstate["Project state<br/>[projectReducer.ts]"]
  node_taskfetch["Task fetch"]
end

subgraph group_identity["Identity"]
  node_authcontroller["Auth routes<br/>[auth.controller.ts]"]
  node_authservice["Discord auth<br/>[auth.service.ts]"]
  node_usercontroller["User routes<br/>[user.controller.ts]"]
  node_userservice["User service<br/>[user.service.ts]"]
end

subgraph group_workspace["Workspace management"]
  node_projectcontroller["Project routes"]
  node_projectservice["Project service<br/>[project.service.ts]"]
  node_boardservice["Board service<br/>[board.service.ts]"]
  node_listservice["List service<br/>[list.service.ts]"]
  node_cardservice["Card service<br/>[card.service.ts]"]
end

subgraph group_runtime["Runtime services"]
  node_mongostore[("MongoDB")]
  node_redis["Redis service<br/>[redis.service.ts]"]
  node_sse["SSE service<br/>[sse.service.ts]"]
  node_activity["Activity service"]
  node_google["Google file service<br/>[google.service.ts]"]
end

node_user(("User"))
node_discord["Discord API"]
node_googleapi["Google API"]

node_user -->|"uses"| node_app
node_app -->|"routes"| node_authpage
node_app -->|"routes"| node_callback
node_app -->|"routes"| node_projects
node_app -->|"routes"| node_tasks
node_tasks -->|"fetches tasks"| node_taskfetch
node_tasks -->|"opens project"| node_projects
node_authpage -.->|"authenticates"| node_authcontroller
node_callback -.->|"exchanges token"| node_authcontroller
node_authcontroller -->|"calls"| node_authservice
node_authservice -->|"validates token"| node_discord
node_authservice -->|"looks up user"| node_userservice
node_authservice -->|"updates cache"| node_redis
node_usercontroller -->|"calls"| node_userservice
node_taskfetch -.->|"requests tasks"| node_usercontroller
node_projects -.->|"requests projects"| node_projectcontroller
node_projectcontroller -->|"dispatches"| node_projectservice
node_projectcontroller -->|"dispatches"| node_boardservice
node_projectcontroller -->|"dispatches"| node_listservice
node_projectcontroller -->|"dispatches"| node_cardservice
node_projectservice -->|"reads cache"| node_redis
node_projectservice -->|"emits updates"| node_sse
node_projectservice -->|"logs activity"| node_activity
node_projectservice -->|"uses integration"| node_discord
node_cardservice -->|"uploads files"| node_google
node_google -.->|"stores files"| node_googleapi
node_projectservice -->|"reads and writes"| node_mongostore
node_cardservice -->|"reads and writes"| node_mongostore
node_cardservice -->|"emits updates"| node_sse
node_cardservice -->|"logs activity"| node_activity
node_cardservice -->|"reads cache"| node_redis

click node_app "https://github.com/glebweider/taskboard/blob/main/FrontEnd/src/App.tsx"
click node_authpage "https://github.com/glebweider/taskboard/blob/main/FrontEnd/src/pages/AuthPage.tsx"
click node_callback "https://github.com/glebweider/taskboard/blob/main/FrontEnd/src/pages/CallbackPage.tsx"
click node_projects "https://github.com/glebweider/taskboard/blob/main/FrontEnd/src/pages/ProjectsPage.tsx"
click node_tasks "https://github.com/glebweider/taskboard/blob/main/FrontEnd/src/pages/TasksPage.tsx"
click node_projectstate "https://github.com/glebweider/taskboard/blob/main/FrontEnd/src/redux/reducers/projectReducer.ts"
click node_taskfetch "https://github.com/glebweider/taskboard/blob/main/FrontEnd/src/utils/fetch/getTasksByProjectId.ts"
click node_authcontroller "https://github.com/glebweider/taskboard/blob/main/Backend/src/auth/auth.controller.ts"
click node_authservice "https://github.com/glebweider/taskboard/blob/main/Backend/src/auth/auth.service.ts"
click node_usercontroller "https://github.com/glebweider/taskboard/blob/main/Backend/src/user/user.controller.ts"
click node_userservice "https://github.com/glebweider/taskboard/blob/main/Backend/src/user/user.service.ts"
click node_projectcontroller "https://github.com/glebweider/taskboard/blob/main/Backend/src/project/project.controller.ts"
click node_projectservice "https://github.com/glebweider/taskboard/blob/main/Backend/src/project/service/project.service.ts"
click node_boardservice "https://github.com/glebweider/taskboard/blob/main/Backend/src/project/service/board.service.ts"
click node_listservice "https://github.com/glebweider/taskboard/blob/main/Backend/src/project/service/list.service.ts"
click node_cardservice "https://github.com/glebweider/taskboard/blob/main/Backend/src/project/service/card.service.ts"
click node_redis "https://github.com/glebweider/taskboard/blob/main/Backend/src/redis/redis.service.ts"
click node_sse "https://github.com/glebweider/taskboard/blob/main/Backend/src/sse/sse.service.ts"
click node_activity "https://github.com/glebweider/taskboard/blob/main/Backend/src/activity/activity.service.ts"
click node_google "https://github.com/glebweider/taskboard/blob/main/Backend/src/google/google.service.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_app,node_authpage,node_callback,node_projects,node_tasks,node_projectstate,node_taskfetch,node_user toneBlue
class node_authcontroller,node_authservice,node_usercontroller,node_userservice toneAmber
class node_projectcontroller,node_projectservice,node_boardservice,node_listservice,node_cardservice,node_discord,node_googleapi toneMint
class node_mongostore,node_redis,node_sse,node_activity,node_google toneRose
```

## Components

### Frontend

- [Route application](https://github.com/glebweider/taskboard/blob/main/FrontEnd/src/App.tsx): `FrontEnd/src/App.tsx`
- [Sign-in page](https://github.com/glebweider/taskboard/blob/main/FrontEnd/src/pages/AuthPage.tsx): `FrontEnd/src/pages/AuthPage.tsx`
- [OAuth callback](https://github.com/glebweider/taskboard/blob/main/FrontEnd/src/pages/CallbackPage.tsx): `FrontEnd/src/pages/CallbackPage.tsx`
- [Projects page](https://github.com/glebweider/taskboard/blob/main/FrontEnd/src/pages/ProjectsPage.tsx): `FrontEnd/src/pages/ProjectsPage.tsx`
- [Assigned tasks](https://github.com/glebweider/taskboard/blob/main/FrontEnd/src/pages/TasksPage.tsx): `FrontEnd/src/pages/TasksPage.tsx`
- [Project state](https://github.com/glebweider/taskboard/blob/main/FrontEnd/src/redux/reducers/projectReducer.ts): `FrontEnd/src/redux/reducers/projectReducer.ts`
- [Task fetch](https://github.com/glebweider/taskboard/blob/main/FrontEnd/src/utils/fetch/getTasksByProjectId.ts): `FrontEnd/src/utils/fetch/getTasksByProjectId.ts`

### Identity

- [Auth routes](https://github.com/glebweider/taskboard/blob/main/Backend/src/auth/auth.controller.ts): `Backend/src/auth/auth.controller.ts`
- [Discord auth](https://github.com/glebweider/taskboard/blob/main/Backend/src/auth/auth.service.ts): `Backend/src/auth/auth.service.ts`
- [User routes](https://github.com/glebweider/taskboard/blob/main/Backend/src/user/user.controller.ts): `Backend/src/user/user.controller.ts`
- [User service](https://github.com/glebweider/taskboard/blob/main/Backend/src/user/user.service.ts): `Backend/src/user/user.service.ts`

### Workspace management

- [Project routes](https://github.com/glebweider/taskboard/blob/main/Backend/src/project/project.controller.ts): `Backend/src/project/project.controller.ts`
- [Project service](https://github.com/glebweider/taskboard/blob/main/Backend/src/project/service/project.service.ts): `Backend/src/project/service/project.service.ts`
- [Board service](https://github.com/glebweider/taskboard/blob/main/Backend/src/project/service/board.service.ts): `Backend/src/project/service/board.service.ts`
- [List service](https://github.com/glebweider/taskboard/blob/main/Backend/src/project/service/list.service.ts): `Backend/src/project/service/list.service.ts`
- [Card service](https://github.com/glebweider/taskboard/blob/main/Backend/src/project/service/card.service.ts): `Backend/src/project/service/card.service.ts`

### Runtime services

- **MongoDB**
- [Redis service](https://github.com/glebweider/taskboard/blob/main/Backend/src/redis/redis.service.ts): `Backend/src/redis/redis.service.ts`
- [SSE service](https://github.com/glebweider/taskboard/blob/main/Backend/src/sse/sse.service.ts): `Backend/src/sse/sse.service.ts`
- [Activity service](https://github.com/glebweider/taskboard/blob/main/Backend/src/activity/activity.service.ts): `Backend/src/activity/activity.service.ts`
- [Google file service](https://github.com/glebweider/taskboard/blob/main/Backend/src/google/google.service.ts): `Backend/src/google/google.service.ts`

### Other components

- **User**
- **Discord API**
- **Google API**

## Connections

- User → Route application: uses (evidence: `FrontEnd/src/App.tsx`)
- Route application → Sign-in page: routes (evidence: `FrontEnd/src/App.tsx`)
- Route application → OAuth callback: routes (evidence: `FrontEnd/src/App.tsx`)
- Route application → Projects page: routes (evidence: `FrontEnd/src/App.tsx`)
- Route application → Assigned tasks: routes (evidence: `FrontEnd/src/App.tsx`)
- Assigned tasks → Task fetch: fetches tasks (evidence: `FrontEnd/src/pages/TasksPage.tsx`)
- Assigned tasks → Projects page: opens project (evidence: `FrontEnd/src/pages/TasksPage.tsx`)
- Sign-in page → Auth routes: authenticates
- OAuth callback → Auth routes: exchanges token
- Auth routes → Discord auth: calls (evidence: `Backend/src/auth/auth.controller.ts`)
- Discord auth → Discord API: validates token (evidence: `Backend/src/auth/auth.service.ts`)
- Discord auth → User service: looks up user (evidence: `Backend/src/auth/auth.service.ts`)
- Discord auth → Redis service: updates cache (evidence: `Backend/src/auth/auth.service.ts`)
- User routes → User service: calls (evidence: `Backend/src/user/user.controller.ts`)
- Task fetch → User routes: requests tasks
- Projects page → Project routes: requests projects
- Project routes → Project service: dispatches (evidence: `Backend/src/project/project.controller.ts`)
- Project routes → Board service: dispatches (evidence: `Backend/src/project/project.controller.ts`)
- Project routes → List service: dispatches (evidence: `Backend/src/project/project.controller.ts`)
- Project routes → Card service: dispatches (evidence: `Backend/src/project/project.controller.ts`)
- Project service → Redis service: reads cache (evidence: `Backend/src/project/service/project.service.ts`)
- Project service → SSE service: emits updates (evidence: `Backend/src/project/service/project.service.ts`)
- Project service → Activity service: logs activity (evidence: `Backend/src/project/service/project.service.ts`)
- Project service → Discord API: uses integration (evidence: `Backend/src/project/service/project.service.ts`)
- Card service → Google file service: uploads files (evidence: `Backend/src/project/service/card.service.ts`)
- Google file service → Google API: stores files
- Project service → MongoDB: reads and writes (evidence: `Backend/src/project/service/project.service.ts`)
- Card service → MongoDB: reads and writes (evidence: `Backend/src/project/service/card.service.ts`)
- Card service → SSE service: emits updates (evidence: `Backend/src/project/service/card.service.ts`)
- Card service → Activity service: logs activity (evidence: `Backend/src/project/service/card.service.ts`)
- Card service → Redis service: reads cache (evidence: `Backend/src/project/service/card.service.ts`)
