# sofdev005/teamflow-project-management-saas-app architecture

> Architecture diagram of the GitHub repository sofdev005/teamflow-project-management-saas-app, 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/sofdev005/teamflow-project-management-saas-app
- Repository: https://github.com/sofdev005/teamflow-project-management-saas-app

## Overview

TeamFlow is a multi-tenant project and task management frontend. Users register or sign in, then use protected dashboard pages to manage projects, work on project Kanban boards, and invite organization or project members. The board supports task creation, editing, deletion, drag-and-drop moves, and graceful handling of missing backend routes. Service modules call the external .NET API through a shared Axios client; auth and preferences also use browser storage. The graph follows documented capabilities where source was not sampled, so some page-to-service links are omitted when not evidenced.

Main entry points: [`src/app/projects/[id]/page.tsx`](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/app/projects/%5Bid%5D/page.tsx) (Project Kanban board), [`src/services/projectService.ts`](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/services/projectService.ts) (Project API), [`src/services/taskService.ts`](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/services/taskService.ts) (Task API), [`src/lib/apiClient.ts`](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/lib/apiClient.ts) (HTTP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and shell"]
  node_login["Sign in and register<br/>[page.tsx]"]
  node_auth["Session provider<br/>[AuthContext.tsx]"]
  node_shell["Protected app shell"]
  node_settings["Profile and preferences<br/>[page.tsx]"]
  node_prefs["Preference state"]
end

subgraph group_projects["Project workspace"]
  node_dashboard["Dashboard overview<br/>[page.tsx]"]
  node_projectlist["Project list<br/>[page.tsx]"]
  node_projectboard["Project Kanban board<br/>[page.tsx]"]
  node_columns["Board columns"]
  node_taskcard["Task card<br/>[TaskCard.tsx]"]
  node_taskdrawer["Task editor drawer<br/>[TaskSideDrawer.tsx]"]
end

subgraph group_team["Team management"]
  node_teamview["Organization team<br/>[page.tsx]"]
end

subgraph group_runtime["Client services"]
  node_authservice["Authentication API<br/>[authService.ts]"]
  node_projectservice["Project API<br/>[projectService.ts]"]
  node_boardservice["Board API<br/>[boardService.ts]"]
  node_taskservice["Task API<br/>[taskService.ts]"]
  node_orgservice["Organization API"]
  node_client["HTTP client<br/>[apiClient.ts]"]
  node_modal["Modal<br/>[Modal.tsx]"]
  node_spinner["Loading indicator<br/>[Spinner.tsx]"]
  node_types["Domain types<br/>[index.ts]"]
end

node_visitor(("User"))
node_api{{"TeamFlow .NET API"}}

node_visitor -->|"signs in"| node_login
node_login -->|"submits credentials"| node_auth
node_auth -->|"sends auth requests"| node_client
node_shell -->|"guards session"| node_auth
node_visitor -->|"opens workspace"| node_shell
node_settings -->|"updates preferences"| node_prefs
node_dashboard -->|"loads projects"| node_projectservice
node_dashboard -->|"loads task data"| node_taskservice
node_projectlist -->|"manages projects"| node_projectservice
node_projectboard -->|"loads project"| node_projectservice
node_projectboard -->|"loads columns"| node_boardservice
node_projectboard -->|"manages tasks"| node_taskservice
node_projectboard -->|"loads members"| node_orgservice
node_projectboard -->|"renders columns"| node_columns
node_columns -->|"renders tasks"| node_taskcard
node_projectboard -->|"opens task editor"| node_taskdrawer
node_taskdrawer -->|"updates tasks"| node_taskservice
node_teamview -->|"loads and invites"| node_orgservice
node_teamview -->|"assigns project member"| node_projectservice
node_projectservice -->|"calls endpoints"| node_client
node_boardservice -->|"calls endpoints"| node_client
node_taskservice -->|"calls endpoints"| node_client
node_orgservice -->|"calls endpoints"| node_client
node_client -->|"sends HTTP requests"| node_api
node_auth -->|"registers and signs in"| node_api
node_taskservice -->|"reads and writes tasks"| node_api
node_projectservice -->|"reads and writes projects"| node_api
node_boardservice -->|"manages columns"| node_api
node_orgservice -->|"manages organization members"| node_api
node_projectboard -->|"reads board settings"| node_prefs
node_projectboard -->|"shows forms"| node_modal
node_teamview -->|"shows invite form"| node_modal
node_shell -->|"shows loading state"| node_spinner
node_taskservice -->|"uses task models"| node_types
node_projectservice -->|"uses project models"| node_types

click node_login "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/app/login/page.tsx"
click node_auth "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/context/AuthContext.tsx"
click node_shell "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/components/DashboardLayout.tsx"
click node_settings "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/app/settings/page.tsx"
click node_prefs "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/context/UserPreferencesContext.tsx"
click node_dashboard "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/app/dashboard/page.tsx"
click node_projectlist "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/app/projects/page.tsx"
click node_projectboard "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/app/projects/%5Bid%5D/page.tsx"
click node_columns "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/components/BoardColumnContainer.tsx"
click node_taskcard "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/components/TaskCard.tsx"
click node_taskdrawer "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/components/TaskSideDrawer.tsx"
click node_teamview "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/app/team/page.tsx"
click node_authservice "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/services/authService.ts"
click node_projectservice "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/services/projectService.ts"
click node_boardservice "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/services/boardService.ts"
click node_taskservice "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/services/taskService.ts"
click node_orgservice "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/services/organizationService.ts"
click node_client "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/lib/apiClient.ts"
click node_modal "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/components/Modal.tsx"
click node_spinner "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/components/Spinner.tsx"
click node_types "https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/types/index.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_login,node_auth,node_shell,node_settings,node_prefs,node_visitor toneBlue
class node_dashboard,node_projectlist,node_projectboard,node_columns,node_taskcard,node_taskdrawer toneAmber
class node_teamview,node_api toneMint
class node_authservice,node_projectservice,node_boardservice,node_taskservice,node_orgservice,node_client,node_modal,node_spinner,node_types toneRose
```

## Components

### Identity and shell

- [Sign in and register](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Session provider](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Protected app shell](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/components/DashboardLayout.tsx): `src/components/DashboardLayout.tsx`
- [Profile and preferences](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/app/settings/page.tsx): `src/app/settings/page.tsx`
- [Preference state](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/context/UserPreferencesContext.tsx): `src/context/UserPreferencesContext.tsx`

### Project workspace

- [Dashboard overview](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/app/dashboard/page.tsx): `src/app/dashboard/page.tsx`
- [Project list](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/app/projects/page.tsx): `src/app/projects/page.tsx`
- [Project Kanban board](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/app/projects/%5Bid%5D/page.tsx): `src/app/projects/[id]/page.tsx`
- [Board columns](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/components/BoardColumnContainer.tsx): `src/components/BoardColumnContainer.tsx`
- [Task card](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/components/TaskCard.tsx): `src/components/TaskCard.tsx`
- [Task editor drawer](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/components/TaskSideDrawer.tsx): `src/components/TaskSideDrawer.tsx`

### Team management

- [Organization team](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/app/team/page.tsx): `src/app/team/page.tsx`

### Client services

- [Authentication API](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/services/authService.ts): `src/services/authService.ts`
- [Project API](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/services/projectService.ts): `src/services/projectService.ts`
- [Board API](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/services/boardService.ts): `src/services/boardService.ts`
- [Task API](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/services/taskService.ts): `src/services/taskService.ts`
- [Organization API](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/services/organizationService.ts): `src/services/organizationService.ts`
- [HTTP client](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/lib/apiClient.ts): `src/lib/apiClient.ts`
- [Modal](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/components/Modal.tsx): `src/components/Modal.tsx`
- [Loading indicator](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/components/Spinner.tsx): `src/components/Spinner.tsx`
- [Domain types](https://github.com/sofdev005/teamflow-project-management-saas-app/blob/main/src/types/index.ts): `src/types/index.ts`

### Other components

- **User**
- **TeamFlow .NET API**

## Connections

- User → Sign in and register: signs in (evidence: `README.md`)
- Sign in and register → Session provider: submits credentials (evidence: `src/app/login/page.tsx`)
- Session provider → HTTP client: sends auth requests (evidence: `src/context/AuthContext.tsx`)
- Protected app shell → Session provider: guards session (evidence: `src/components/DashboardLayout.tsx`)
- User → Protected app shell: opens workspace (evidence: `README.md`)
- Profile and preferences → Preference state: updates preferences (evidence: `src/app/settings/page.tsx`)
- Dashboard overview → Project API: loads projects (evidence: `src/app/dashboard/page.tsx`)
- Dashboard overview → Task API: loads task data (evidence: `src/app/dashboard/page.tsx`)
- Project list → Project API: manages projects (evidence: `src/app/projects/page.tsx`)
- Project Kanban board → Project API: loads project (evidence: `src/app/projects/[id]/page.tsx`)
- Project Kanban board → Board API: loads columns (evidence: `src/app/projects/[id]/page.tsx`)
- Project Kanban board → Task API: manages tasks (evidence: `src/app/projects/[id]/page.tsx`)
- Project Kanban board → Organization API: loads members (evidence: `README.md`)
- Project Kanban board → Board columns: renders columns (evidence: `src/app/projects/[id]/page.tsx`)
- Board columns → Task card: renders tasks (evidence: `src/components/BoardColumnContainer.tsx`)
- Project Kanban board → Task editor drawer: opens task editor (evidence: `src/app/projects/[id]/page.tsx`)
- Task editor drawer → Task API: updates tasks (evidence: `src/components/TaskSideDrawer.tsx`)
- Organization team → Organization API: loads and invites (evidence: `src/app/team/page.tsx`)
- Organization team → Project API: assigns project member (evidence: `src/app/team/page.tsx`)
- Project API → HTTP client: calls endpoints (evidence: `src/services/projectService.ts`)
- Board API → HTTP client: calls endpoints (evidence: `src/services/boardService.ts`)
- Task API → HTTP client: calls endpoints (evidence: `src/services/taskService.ts`)
- Organization API → HTTP client: calls endpoints (evidence: `src/services/organizationService.ts`)
- HTTP client → TeamFlow .NET API: sends HTTP requests (evidence: `README.md`)
- Session provider → TeamFlow .NET API: registers and signs in (evidence: `src/context/AuthContext.tsx`)
- Task API → TeamFlow .NET API: reads and writes tasks (evidence: `src/services/taskService.ts`)
- Project API → TeamFlow .NET API: reads and writes projects (evidence: `src/services/projectService.ts`)
- Board API → TeamFlow .NET API: manages columns (evidence: `README.md`)
- Organization API → TeamFlow .NET API: manages organization members (evidence: `README.md`)
- Project Kanban board → Preference state: reads board settings (evidence: `src/app/projects/[id]/page.tsx`)
- Project Kanban board → Modal: shows forms (evidence: `src/app/projects/[id]/page.tsx`)
- Organization team → Modal: shows invite form (evidence: `src/app/team/page.tsx`)
- Protected app shell → Loading indicator: shows loading state (evidence: `src/components/DashboardLayout.tsx`)
- Task API → Domain types: uses task models (evidence: `src/services/taskService.ts`)
- Project API → Domain types: uses project models (evidence: `src/services/projectService.ts`)
