# cjake28/taskflow-app architecture

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

- Interactive diagram: https://gitdiagram.com/cjake28/taskflow-app
- Repository: https://github.com/cjake28/taskflow-app

## Overview

TaskFlow is a full-stack personal task-management product. Its main workflow is that a signed-in user creates and organizes tasks, then tracks due dates, activity, and progress through task views, the calendar, and dashboard. Account security and profile management, image attachments, OAuth, and configurable notifications extend that workflow. The graph combines documented product capabilities with sampled routing, authentication, storage, and service code; several feature-level connections are documented rather than verified in source excerpts.

Main entry points: [`backend/src/routes.ts`](https://github.com/cjake28/taskflow-app/blob/main/backend/src/routes.ts) (API router), [`backend/src/database/prisma.ts`](https://github.com/cjake28/taskflow-app/blob/main/backend/src/database/prisma.ts) (PostgreSQL), [`backend/src/modules/auth/sessions.service.ts`](https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/auth/sessions.service.ts) (Session management), [`backend/src/modules/users/users.service.ts`](https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/users/users.service.ts) (Profile management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_web["Web shell<br/>[router.tsx]"]
  node_task_ui["Task views<br/>[tasks-page.tsx]"]
  node_insight_ui["Progress views<br/>[dashboard-page.tsx]"]
  node_account_ui["Account views<br/>[profile-page.tsx]"]
end

subgraph group_identity["Identity and account"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_sessions["Session management"]
  node_oauth["OAuth sign-in<br/>[oauth.service.ts]"]
  node_users["Profile management<br/>[users.service.ts]"]
end

subgraph group_work["Task workspace"]
  node_tasks["Task management<br/>[tasks.service.ts]"]
  node_images["Image handling<br/>[images.service.ts]"]
end

subgraph group_insights["Insights and notifications"]
  node_dashboard["Dashboard data"]
  node_activities["Activity history"]
  node_notifications["Notifications"]
end

subgraph group_platform["Backend platform"]
  node_contracts["Shared schemas<br/>[task.ts]"]
  node_api["API router<br/>[routes.ts]"]
  node_storage["Object storage<br/>[create-storage.ts]"]
  node_jobs["Background jobs<br/>[job-queue.ts]"]
  node_mail["Email delivery<br/>[mail.transport.ts]"]
  node_database[("PostgreSQL<br/>[prisma.ts]")]
  node_redis[("Redis<br/>[redis.ts]")]
end

node_user(("User"))
node_oauth_providers["Google / GitHub"]
node_email_service["SMTP service"]

node_user -->|"uses"| node_web
node_web -.->|"opens"| node_task_ui
node_task_ui -.->|"requests tasks"| node_api
node_insight_ui -.->|"requests progress"| node_api
node_account_ui -.->|"manages account"| node_api
node_api -->|"mounts routes"| node_auth
node_api -->|"mounts routes"| node_oauth
node_api -->|"mounts routes"| node_users
node_api -->|"mounts routes"| node_tasks
node_api -->|"mounts routes"| node_images
node_api -->|"mounts routes"| node_dashboard
node_api -->|"mounts routes"| node_activities
node_api -->|"mounts routes"| node_notifications
node_auth -.->|"creates sessions"| node_sessions
node_sessions -->|"reads / writes"| node_database
node_sessions -->|"checks cache"| node_redis
node_tasks -.->|"reads / writes"| node_database
node_activities -.->|"reads / writes"| node_database
node_dashboard -.->|"queries metrics"| node_database
node_users -->|"reads / writes"| node_database
node_users -->|"revokes sessions"| node_sessions
node_users -->|"enqueues email"| node_jobs
node_oauth -->|"exchanges code"| node_oauth_providers
node_oauth -->|"creates session"| node_sessions
node_images -.->|"stores images"| node_storage
node_storage -.->|"stores metadata"| node_database
node_notifications -.->|"schedules delivery"| node_jobs
node_jobs -.->|"dispatches email"| node_mail
node_mail -.->|"sends mail"| node_email_service
node_contracts -.->|"validates data"| node_task_ui

click node_web "https://github.com/cjake28/taskflow-app/blob/main/frontend/src/app/router.tsx"
click node_task_ui "https://github.com/cjake28/taskflow-app/blob/main/frontend/src/features/tasks/pages/tasks-page.tsx"
click node_insight_ui "https://github.com/cjake28/taskflow-app/blob/main/frontend/src/features/dashboard/pages/dashboard-page.tsx"
click node_account_ui "https://github.com/cjake28/taskflow-app/blob/main/frontend/src/features/profile/pages/profile-page.tsx"
click node_contracts "https://github.com/cjake28/taskflow-app/blob/main/packages/shared/src/schemas/task.ts"
click node_api "https://github.com/cjake28/taskflow-app/blob/main/backend/src/routes.ts"
click node_auth "https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/auth/auth.service.ts"
click node_sessions "https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/auth/sessions.service.ts"
click node_oauth "https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/oauth/oauth.service.ts"
click node_users "https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/users/users.service.ts"
click node_tasks "https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/tasks/tasks.service.ts"
click node_images "https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/images/images.service.ts"
click node_storage "https://github.com/cjake28/taskflow-app/blob/main/backend/src/storage/create-storage.ts"
click node_dashboard "https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/dashboard/dashboard.service.ts"
click node_activities "https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/activities/activity.service.ts"
click node_notifications "https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/notifications/notifications.service.ts"
click node_jobs "https://github.com/cjake28/taskflow-app/blob/main/backend/src/jobs/job-queue.ts"
click node_mail "https://github.com/cjake28/taskflow-app/blob/main/backend/src/mail/mail.transport.ts"
click node_database "https://github.com/cjake28/taskflow-app/blob/main/backend/src/database/prisma.ts"
click node_redis "https://github.com/cjake28/taskflow-app/blob/main/backend/src/redis/redis.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_web,node_task_ui,node_insight_ui,node_account_ui,node_user toneBlue
class node_auth,node_sessions,node_oauth,node_users toneAmber
class node_tasks,node_images toneMint
class node_dashboard,node_activities,node_notifications toneRose
class node_contracts,node_api,node_storage,node_jobs,node_mail,node_database,node_redis,node_oauth_providers,node_email_service toneIndigo
```

## Components

### Web application

- [Web shell](https://github.com/cjake28/taskflow-app/blob/main/frontend/src/app/router.tsx): `frontend/src/app/router.tsx`
- [Task views](https://github.com/cjake28/taskflow-app/blob/main/frontend/src/features/tasks/pages/tasks-page.tsx): `frontend/src/features/tasks/pages/tasks-page.tsx`
- [Progress views](https://github.com/cjake28/taskflow-app/blob/main/frontend/src/features/dashboard/pages/dashboard-page.tsx): `frontend/src/features/dashboard/pages/dashboard-page.tsx`
- [Account views](https://github.com/cjake28/taskflow-app/blob/main/frontend/src/features/profile/pages/profile-page.tsx): `frontend/src/features/profile/pages/profile-page.tsx`

### Identity and account

- [Authentication](https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/auth/auth.service.ts): `backend/src/modules/auth/auth.service.ts`
- [Session management](https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/auth/sessions.service.ts): `backend/src/modules/auth/sessions.service.ts`
- [OAuth sign-in](https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/oauth/oauth.service.ts): `backend/src/modules/oauth/oauth.service.ts`
- [Profile management](https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/users/users.service.ts): `backend/src/modules/users/users.service.ts`

### Task workspace

- [Task management](https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/tasks/tasks.service.ts): `backend/src/modules/tasks/tasks.service.ts`
- [Image handling](https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/images/images.service.ts): `backend/src/modules/images/images.service.ts`

### Insights and notifications

- [Dashboard data](https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/dashboard/dashboard.service.ts): `backend/src/modules/dashboard/dashboard.service.ts`
- [Activity history](https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/activities/activity.service.ts): `backend/src/modules/activities/activity.service.ts`
- [Notifications](https://github.com/cjake28/taskflow-app/blob/main/backend/src/modules/notifications/notifications.service.ts): `backend/src/modules/notifications/notifications.service.ts`

### Backend platform

- [Shared schemas](https://github.com/cjake28/taskflow-app/blob/main/packages/shared/src/schemas/task.ts): `packages/shared/src/schemas/task.ts`
- [API router](https://github.com/cjake28/taskflow-app/blob/main/backend/src/routes.ts): `backend/src/routes.ts`
- [Object storage](https://github.com/cjake28/taskflow-app/blob/main/backend/src/storage/create-storage.ts): `backend/src/storage/create-storage.ts`
- [Background jobs](https://github.com/cjake28/taskflow-app/blob/main/backend/src/jobs/job-queue.ts): `backend/src/jobs/job-queue.ts`
- [Email delivery](https://github.com/cjake28/taskflow-app/blob/main/backend/src/mail/mail.transport.ts): `backend/src/mail/mail.transport.ts`
- [PostgreSQL](https://github.com/cjake28/taskflow-app/blob/main/backend/src/database/prisma.ts): `backend/src/database/prisma.ts`
- [Redis](https://github.com/cjake28/taskflow-app/blob/main/backend/src/redis/redis.ts): `backend/src/redis/redis.ts`

### Other components

- **User**
- **Google / GitHub**
- **SMTP service**

## Connections

- User → Web shell: uses (evidence: `README.md`)
- Web shell → Task views: opens
- Task views → API router: requests tasks
- Progress views → API router: requests progress
- Account views → API router: manages account
- API router → Authentication: mounts routes (evidence: `backend/src/routes.ts`)
- API router → OAuth sign-in: mounts routes (evidence: `backend/src/routes.ts`)
- API router → Profile management: mounts routes (evidence: `backend/src/routes.ts`)
- API router → Task management: mounts routes (evidence: `backend/src/routes.ts`)
- API router → Image handling: mounts routes (evidence: `backend/src/routes.ts`)
- API router → Dashboard data: mounts routes (evidence: `backend/src/routes.ts`)
- API router → Activity history: mounts routes (evidence: `backend/src/routes.ts`)
- API router → Notifications: mounts routes (evidence: `backend/src/routes.ts`)
- Authentication → Session management: creates sessions
- Session management → PostgreSQL: reads / writes (evidence: `backend/src/modules/auth/sessions.service.ts`)
- Session management → Redis: checks cache (evidence: `backend/src/modules/auth/sessions.service.ts`)
- Task management → PostgreSQL: reads / writes
- Activity history → PostgreSQL: reads / writes
- Dashboard data → PostgreSQL: queries metrics
- Profile management → PostgreSQL: reads / writes (evidence: `backend/src/modules/users/users.service.ts`)
- Profile management → Session management: revokes sessions (evidence: `backend/src/modules/users/users.service.ts`)
- Profile management → Background jobs: enqueues email (evidence: `backend/src/modules/users/users.service.ts`)
- OAuth sign-in → Google / GitHub: exchanges code (evidence: `backend/src/modules/oauth/oauth.service.ts`)
- OAuth sign-in → Session management: creates session (evidence: `backend/src/modules/oauth/oauth.service.ts`)
- Image handling → Object storage: stores images
- Object storage → PostgreSQL: stores metadata
- Notifications → Background jobs: schedules delivery
- Background jobs → Email delivery: dispatches email
- Email delivery → SMTP service: sends mail
- Shared schemas → Task views: validates data
