# ram-rogers/taskflow architecture

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

- Interactive diagram: https://gitdiagram.com/ram-rogers/taskflow
- Repository: https://github.com/ram-rogers/taskflow

## Overview

TaskFlow is a project and task manager: users register or log in, then create projects and manage filtered, assignable tasks on a Kanban board. The React app routes authenticated users to project views and sends bearer-token requests through a shared API client. Spring controllers handle authentication and project/task endpoints, with JWT security and repositories backed by JPA entities. The README also documents PostgreSQL/Flyway persistence. Source excerpts show the frontend task and project calls and selected backend controller-to-repository paths; unsampled security and migration wiring is represented only where documented.

Main entry points: [`frontend/src/App.tsx`](https://github.com/ram-rogers/taskflow/blob/master/frontend/src/App.tsx) (React routes), [`frontend/src/api.ts`](https://github.com/ram-rogers/taskflow/blob/master/frontend/src/api.ts) (API client), [`frontend/src/pages/ProjectDetail.tsx`](https://github.com/ram-rogers/taskflow/blob/master/frontend/src/pages/ProjectDetail.tsx) (Kanban board), [`backend/src/main/java/com/taskflow/repository/UserRepository.java`](https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/repository/UserRepository.java) (User repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["React routes<br/>[App.tsx]"]
  node_authstate["Auth state<br/>[AuthContext.tsx]"]
  node_toast["Toast state<br/>[ToastContext.tsx]"]
  node_authpages["Login and register<br/>[Login.tsx]"]
  node_projects["Project list<br/>[Projects.tsx]"]
  node_board["Kanban board<br/>[ProjectDetail.tsx]"]
  node_projectmodal["Project editor<br/>[ProjectModal.tsx]"]
  node_taskmodal["Task editor<br/>[TaskModal.tsx]"]
  node_api["API client<br/>[api.ts]"]
end

subgraph group_auth["Identity and security"]
  node_authcontroller["Authentication endpoints"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_jwtfilter["JWT request filter"]
  node_securityconfig["Security configuration"]
  node_userdetails["User identity service"]
end

subgraph group_domain["Project and task API"]
  node_projectapi["Project endpoints"]
  node_taskapi["Task endpoints"]
end

subgraph group_persistence["Persistence"]
  node_projectsrepo["Project repository"]
  node_tasksrepo["Task repository"]
  node_usersrepo["User repository"]
  node_entities[("JPA domain entities<br/>[Task.java]")]
end

node_user(("User"))
node_postgres[("PostgreSQL")]

node_user -->|"uses"| node_app
node_app -->|"provides auth"| node_authstate
node_app -->|"provides notices"| node_toast
node_app -->|"routes"| node_authpages
node_app -->|"routes"| node_projects
node_app -->|"routes"| node_board
node_authpages -->|"updates session"| node_authstate
node_authpages -->|"calls"| node_api
node_projects -->|"calls"| node_api
node_projects -->|"opens"| node_projectmodal
node_board -->|"calls"| node_api
node_board -->|"opens"| node_taskmodal
node_board -->|"opens"| node_projectmodal
node_board -->|"reports errors"| node_toast
node_api -.->|"HTTP requests"| node_authcontroller
node_api -.->|"HTTP requests"| node_projectapi
node_api -.->|"HTTP requests"| node_taskapi
node_authcontroller -->|"reads and writes"| node_usersrepo
node_authcontroller -->|"issues tokens"| node_jwt
node_authcontroller -->|"creates identity"| node_userdetails
node_jwtfilter -->|"validates tokens"| node_jwt
node_securityconfig -.->|"configures filter"| node_jwtfilter
node_userdetails -->|"loads users"| node_usersrepo
node_projectapi -->|"queries projects"| node_projectsrepo
node_projectapi -->|"queries tasks"| node_tasksrepo
node_projectapi -->|"queries users"| node_usersrepo
node_taskapi -->|"queries tasks"| node_tasksrepo
node_taskapi -->|"queries users"| node_usersrepo
node_projectsrepo -->|"persists"| node_entities
node_tasksrepo -->|"persists"| node_entities
node_usersrepo -->|"persists"| node_entities
node_entities -.->|"stored in"| node_postgres

click node_app "https://github.com/ram-rogers/taskflow/blob/master/frontend/src/App.tsx"
click node_authstate "https://github.com/ram-rogers/taskflow/blob/master/frontend/src/context/AuthContext.tsx"
click node_toast "https://github.com/ram-rogers/taskflow/blob/master/frontend/src/context/ToastContext.tsx"
click node_authpages "https://github.com/ram-rogers/taskflow/blob/master/frontend/src/pages/Login.tsx"
click node_projects "https://github.com/ram-rogers/taskflow/blob/master/frontend/src/pages/Projects.tsx"
click node_board "https://github.com/ram-rogers/taskflow/blob/master/frontend/src/pages/ProjectDetail.tsx"
click node_projectmodal "https://github.com/ram-rogers/taskflow/blob/master/frontend/src/components/ProjectModal.tsx"
click node_taskmodal "https://github.com/ram-rogers/taskflow/blob/master/frontend/src/components/TaskModal.tsx"
click node_api "https://github.com/ram-rogers/taskflow/blob/master/frontend/src/api.ts"
click node_authcontroller "https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/controller/AuthController.java"
click node_jwt "https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/security/JwtService.java"
click node_jwtfilter "https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/security/JwtAuthenticationFilter.java"
click node_securityconfig "https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/config/SecurityConfig.java"
click node_userdetails "https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/security/CustomUserDetailsService.java"
click node_projectapi "https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/controller/ProjectController.java"
click node_taskapi "https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/controller/TaskController.java"
click node_projectsrepo "https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/repository/ProjectRepository.java"
click node_tasksrepo "https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/repository/TaskRepository.java"
click node_usersrepo "https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/repository/UserRepository.java"
click node_entities "https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/domain/Task.java"

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_authstate,node_toast,node_authpages,node_projects,node_board,node_projectmodal,node_taskmodal,node_api,node_user toneBlue
class node_authcontroller,node_jwt,node_jwtfilter,node_securityconfig,node_userdetails,node_postgres toneAmber
class node_projectapi,node_taskapi toneMint
class node_projectsrepo,node_tasksrepo,node_usersrepo,node_entities toneRose
```

## Components

### Web application

- [React routes](https://github.com/ram-rogers/taskflow/blob/master/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Auth state](https://github.com/ram-rogers/taskflow/blob/master/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Toast state](https://github.com/ram-rogers/taskflow/blob/master/frontend/src/context/ToastContext.tsx): `frontend/src/context/ToastContext.tsx`
- [Login and register](https://github.com/ram-rogers/taskflow/blob/master/frontend/src/pages/Login.tsx): `frontend/src/pages/Login.tsx`
- [Project list](https://github.com/ram-rogers/taskflow/blob/master/frontend/src/pages/Projects.tsx): `frontend/src/pages/Projects.tsx`
- [Kanban board](https://github.com/ram-rogers/taskflow/blob/master/frontend/src/pages/ProjectDetail.tsx): `frontend/src/pages/ProjectDetail.tsx`
- [Project editor](https://github.com/ram-rogers/taskflow/blob/master/frontend/src/components/ProjectModal.tsx): `frontend/src/components/ProjectModal.tsx`
- [Task editor](https://github.com/ram-rogers/taskflow/blob/master/frontend/src/components/TaskModal.tsx): `frontend/src/components/TaskModal.tsx`
- [API client](https://github.com/ram-rogers/taskflow/blob/master/frontend/src/api.ts): `frontend/src/api.ts`

### Identity and security

- [Authentication endpoints](https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/controller/AuthController.java): `backend/src/main/java/com/taskflow/controller/AuthController.java`
- [JWT service](https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/security/JwtService.java): `backend/src/main/java/com/taskflow/security/JwtService.java`
- [JWT request filter](https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/security/JwtAuthenticationFilter.java): `backend/src/main/java/com/taskflow/security/JwtAuthenticationFilter.java`
- [Security configuration](https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/config/SecurityConfig.java): `backend/src/main/java/com/taskflow/config/SecurityConfig.java`
- [User identity service](https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/security/CustomUserDetailsService.java): `backend/src/main/java/com/taskflow/security/CustomUserDetailsService.java`

### Project and task API

- [Project endpoints](https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/controller/ProjectController.java): `backend/src/main/java/com/taskflow/controller/ProjectController.java`
- [Task endpoints](https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/controller/TaskController.java): `backend/src/main/java/com/taskflow/controller/TaskController.java`

### Persistence

- [Project repository](https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/repository/ProjectRepository.java): `backend/src/main/java/com/taskflow/repository/ProjectRepository.java`
- [Task repository](https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/repository/TaskRepository.java): `backend/src/main/java/com/taskflow/repository/TaskRepository.java`
- [User repository](https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/repository/UserRepository.java): `backend/src/main/java/com/taskflow/repository/UserRepository.java`
- [JPA domain entities](https://github.com/ram-rogers/taskflow/blob/master/backend/src/main/java/com/taskflow/domain/Task.java): `backend/src/main/java/com/taskflow/domain/Task.java`

### Other components

- **User**
- **PostgreSQL**

## Connections

- User → React routes: uses (evidence: `frontend/src/App.tsx`)
- React routes → Auth state: provides auth (evidence: `frontend/src/App.tsx`)
- React routes → Toast state: provides notices (evidence: `frontend/src/App.tsx`)
- React routes → Login and register: routes (evidence: `frontend/src/App.tsx`)
- React routes → Project list: routes (evidence: `frontend/src/App.tsx`)
- React routes → Kanban board: routes (evidence: `frontend/src/App.tsx`)
- Login and register → Auth state: updates session (evidence: `frontend/src/pages/Login.tsx`)
- Login and register → API client: calls (evidence: `frontend/src/pages/Login.tsx`)
- Project list → API client: calls (evidence: `frontend/src/pages/Projects.tsx`)
- Project list → Project editor: opens (evidence: `frontend/src/pages/Projects.tsx`)
- Kanban board → API client: calls (evidence: `frontend/src/pages/ProjectDetail.tsx`)
- Kanban board → Task editor: opens (evidence: `frontend/src/pages/ProjectDetail.tsx`)
- Kanban board → Project editor: opens (evidence: `frontend/src/pages/ProjectDetail.tsx`)
- Kanban board → Toast state: reports errors (evidence: `frontend/src/pages/ProjectDetail.tsx`)
- API client → Authentication endpoints: HTTP requests (evidence: `README.md`)
- API client → Project endpoints: HTTP requests (evidence: `README.md`)
- API client → Task endpoints: HTTP requests (evidence: `README.md`)
- Authentication endpoints → User repository: reads and writes (evidence: `backend/src/main/java/com/taskflow/controller/AuthController.java`)
- Authentication endpoints → JWT service: issues tokens (evidence: `backend/src/main/java/com/taskflow/controller/AuthController.java`)
- Authentication endpoints → User identity service: creates identity (evidence: `backend/src/main/java/com/taskflow/controller/AuthController.java`)
- JWT request filter → JWT service: validates tokens (evidence: `backend/src/main/java/com/taskflow/security/JwtAuthenticationFilter.java`)
- Security configuration → JWT request filter: configures filter
- User identity service → User repository: loads users (evidence: `backend/src/main/java/com/taskflow/security/CustomUserDetailsService.java`)
- Project endpoints → Project repository: queries projects (evidence: `backend/src/main/java/com/taskflow/controller/ProjectController.java`)
- Project endpoints → Task repository: queries tasks (evidence: `backend/src/main/java/com/taskflow/controller/ProjectController.java`)
- Project endpoints → User repository: queries users (evidence: `backend/src/main/java/com/taskflow/controller/ProjectController.java`)
- Task endpoints → Task repository: queries tasks (evidence: `backend/src/main/java/com/taskflow/controller/TaskController.java`)
- Task endpoints → User repository: queries users (evidence: `backend/src/main/java/com/taskflow/controller/TaskController.java`)
- Project repository → JPA domain entities: persists (evidence: `backend/src/main/java/com/taskflow/repository/ProjectRepository.java`)
- Task repository → JPA domain entities: persists (evidence: `backend/src/main/java/com/taskflow/repository/TaskRepository.java`)
- User repository → JPA domain entities: persists (evidence: `backend/src/main/java/com/taskflow/repository/UserRepository.java`)
- JPA domain entities → PostgreSQL: stored in (evidence: `README.md`)
