# hannahqiu5/taskapp architecture

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

- Interactive diagram: https://gitdiagram.com/hannahqiu5/taskapp
- Repository: https://github.com/hannahqiu5/taskapp

## Overview

TaskApp is a task-list and task management product: users browse or edit lists, open a list to review and update tasks, and create or edit tasks with due dates, priorities, and status. The React app routes to screens, which use shared context for state and REST calls; Spring controllers delegate to services, with DTO/entity mapping and repository persistence to PostgreSQL. The README documents the backend layers and REST boundary; source-index references and excerpts support the shown module relationships. Not every backend implementation detail was excerpted.

Main entry points: [`frontend/src/AppProvider.tsx`](https://github.com/hannahqiu5/taskapp/blob/main/frontend/src/AppProvider.tsx) (State and API), [`frontend/src/App.tsx`](https://github.com/hannahqiu5/taskapp/blob/main/frontend/src/App.tsx) (App routes), [`src/main/java/com/hanqiu/taskapp/mappers/Impl`](https://github.com/hannahqiu5/taskapp/tree/main/src/main/java/com/hanqiu/taskapp/mappers/Impl) (DTO mappers), [`src/main/java/com/hanqiu/taskapp/domain/entities`](https://github.com/hannahqiu5/taskapp/tree/main/src/main/java/com/hanqiu/taskapp/domain/entities) (JPA entities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React frontend"]
  node_routes["App routes<br/>[App.tsx]"]
  node_listscreen["Task lists"]
  node_taskscreen["Tasks screen<br/>[TasksScreen.tsx]"]
  node_listform["List editor"]
  node_taskform["Task editor"]
  node_provider["State and API<br/>[AppProvider.tsx]"]
  node_frontendmodels["Task models<br/>[Task.ts]"]
end

subgraph group_api["REST API"]
  node_listcontroller["List controller"]
  node_taskcontroller["Task controller"]
  node_errors["Error handling"]
end

subgraph group_domain["Domain and persistence"]
  node_listservice["List service"]
  node_taskservice["Task service"]
  node_mappers["DTO mappers"]
  node_dtos["API DTOs"]
  node_entities["JPA entities"]
  node_listrepo["List repository"]
  node_taskrepo["Task repository"]
end

subgraph group_storage["Database"]
  node_postgres[("PostgreSQL")]
end

node_user(("User"))

node_user -->|"uses"| node_routes
node_routes -->|"routes to"| node_listscreen
node_routes -->|"routes to"| node_listform
node_routes -->|"routes to"| node_taskscreen
node_routes -->|"routes to"| node_taskform
node_listscreen -->|"uses API"| node_provider
node_taskscreen -->|"loads and updates"| node_provider
node_listform -->|"uses API"| node_provider
node_taskform -->|"creates and updates"| node_provider
node_provider -->|"uses types"| node_frontendmodels
node_provider -->|"REST requests"| node_listcontroller
node_provider -->|"REST requests"| node_taskcontroller
node_listcontroller -->|"delegates to"| node_listservice
node_listcontroller -->|"maps DTOs"| node_mappers
node_taskcontroller -->|"delegates to"| node_taskservice
node_taskcontroller -->|"maps DTOs"| node_mappers
node_listservice -->|"persists lists"| node_listrepo
node_taskservice -->|"loads list"| node_listrepo
node_taskservice -->|"persists tasks"| node_taskrepo
node_mappers -->|"converts"| node_dtos
node_mappers -->|"converts"| node_entities
node_listrepo -->|"stores"| node_entities
node_taskrepo -->|"stores"| node_entities
node_entities -->|"persisted in"| node_postgres
node_errors -->|"returns errors as"| node_dtos

click node_routes "https://github.com/hannahqiu5/taskapp/blob/main/frontend/src/App.tsx"
click node_listscreen "https://github.com/hannahqiu5/taskapp/blob/main/frontend/src/components/TaskListsScreen.tsx"
click node_taskscreen "https://github.com/hannahqiu5/taskapp/blob/main/frontend/src/components/TasksScreen.tsx"
click node_listform "https://github.com/hannahqiu5/taskapp/blob/main/frontend/src/components/CreateUpdateTaskListScreen.tsx"
click node_taskform "https://github.com/hannahqiu5/taskapp/blob/main/frontend/src/components/CreateUpdateTaskScreen.tsx"
click node_provider "https://github.com/hannahqiu5/taskapp/blob/main/frontend/src/AppProvider.tsx"
click node_frontendmodels "https://github.com/hannahqiu5/taskapp/blob/main/frontend/src/domain/Task.ts"
click node_listcontroller "https://github.com/hannahqiu5/taskapp/blob/main/src/main/java/com/hanqiu/taskapp/controller/TaskListController.java"
click node_taskcontroller "https://github.com/hannahqiu5/taskapp/blob/main/src/main/java/com/hanqiu/taskapp/controller/TaskController.java"
click node_errors "https://github.com/hannahqiu5/taskapp/blob/main/src/main/java/com/hanqiu/taskapp/controller/GlobalExceptionHandler.java"
click node_listservice "https://github.com/hannahqiu5/taskapp/blob/main/src/main/java/com/hanqiu/taskapp/services/impl/TaskListServiceImpl.java"
click node_taskservice "https://github.com/hannahqiu5/taskapp/blob/main/src/main/java/com/hanqiu/taskapp/services/impl/TaskServiceImpl.java"
click node_mappers "https://github.com/hannahqiu5/taskapp/tree/main/src/main/java/com/hanqiu/taskapp/mappers/Impl"
click node_dtos "https://github.com/hannahqiu5/taskapp/tree/main/src/main/java/com/hanqiu/taskapp/domain/dto"
click node_entities "https://github.com/hannahqiu5/taskapp/tree/main/src/main/java/com/hanqiu/taskapp/domain/entities"
click node_listrepo "https://github.com/hannahqiu5/taskapp/blob/main/src/main/java/com/hanqiu/taskapp/repositories/TaskListRepository.java"
click node_taskrepo "https://github.com/hannahqiu5/taskapp/blob/main/src/main/java/com/hanqiu/taskapp/repositories/TaskRepository.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_routes,node_listscreen,node_taskscreen,node_listform,node_taskform,node_provider,node_frontendmodels,node_user toneBlue
class node_listcontroller,node_taskcontroller,node_errors toneAmber
class node_listservice,node_taskservice,node_mappers,node_dtos,node_entities,node_listrepo,node_taskrepo toneMint
class node_postgres toneRose
```

## Components

### React frontend

- [App routes](https://github.com/hannahqiu5/taskapp/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Task lists](https://github.com/hannahqiu5/taskapp/blob/main/frontend/src/components/TaskListsScreen.tsx): `frontend/src/components/TaskListsScreen.tsx`
- [Tasks screen](https://github.com/hannahqiu5/taskapp/blob/main/frontend/src/components/TasksScreen.tsx): `frontend/src/components/TasksScreen.tsx`
- [List editor](https://github.com/hannahqiu5/taskapp/blob/main/frontend/src/components/CreateUpdateTaskListScreen.tsx): `frontend/src/components/CreateUpdateTaskListScreen.tsx`
- [Task editor](https://github.com/hannahqiu5/taskapp/blob/main/frontend/src/components/CreateUpdateTaskScreen.tsx): `frontend/src/components/CreateUpdateTaskScreen.tsx`
- [State and API](https://github.com/hannahqiu5/taskapp/blob/main/frontend/src/AppProvider.tsx): `frontend/src/AppProvider.tsx`
- [Task models](https://github.com/hannahqiu5/taskapp/blob/main/frontend/src/domain/Task.ts): `frontend/src/domain/Task.ts`

### REST API

- [List controller](https://github.com/hannahqiu5/taskapp/blob/main/src/main/java/com/hanqiu/taskapp/controller/TaskListController.java): `src/main/java/com/hanqiu/taskapp/controller/TaskListController.java`
- [Task controller](https://github.com/hannahqiu5/taskapp/blob/main/src/main/java/com/hanqiu/taskapp/controller/TaskController.java): `src/main/java/com/hanqiu/taskapp/controller/TaskController.java`
- [Error handling](https://github.com/hannahqiu5/taskapp/blob/main/src/main/java/com/hanqiu/taskapp/controller/GlobalExceptionHandler.java): `src/main/java/com/hanqiu/taskapp/controller/GlobalExceptionHandler.java`

### Domain and persistence

- [List service](https://github.com/hannahqiu5/taskapp/blob/main/src/main/java/com/hanqiu/taskapp/services/impl/TaskListServiceImpl.java): `src/main/java/com/hanqiu/taskapp/services/impl/TaskListServiceImpl.java`
- [Task service](https://github.com/hannahqiu5/taskapp/blob/main/src/main/java/com/hanqiu/taskapp/services/impl/TaskServiceImpl.java): `src/main/java/com/hanqiu/taskapp/services/impl/TaskServiceImpl.java`
- [DTO mappers](https://github.com/hannahqiu5/taskapp/tree/main/src/main/java/com/hanqiu/taskapp/mappers/Impl): `src/main/java/com/hanqiu/taskapp/mappers/Impl`
- [API DTOs](https://github.com/hannahqiu5/taskapp/tree/main/src/main/java/com/hanqiu/taskapp/domain/dto): `src/main/java/com/hanqiu/taskapp/domain/dto`
- [JPA entities](https://github.com/hannahqiu5/taskapp/tree/main/src/main/java/com/hanqiu/taskapp/domain/entities): `src/main/java/com/hanqiu/taskapp/domain/entities`
- [List repository](https://github.com/hannahqiu5/taskapp/blob/main/src/main/java/com/hanqiu/taskapp/repositories/TaskListRepository.java): `src/main/java/com/hanqiu/taskapp/repositories/TaskListRepository.java`
- [Task repository](https://github.com/hannahqiu5/taskapp/blob/main/src/main/java/com/hanqiu/taskapp/repositories/TaskRepository.java): `src/main/java/com/hanqiu/taskapp/repositories/TaskRepository.java`

### Database

- **PostgreSQL**

### Other components

- **User**

## Connections

- User → App routes: uses
- App routes → Task lists: routes to (evidence: `frontend/src/App.tsx`)
- App routes → List editor: routes to (evidence: `frontend/src/App.tsx`)
- App routes → Tasks screen: routes to (evidence: `frontend/src/App.tsx`)
- App routes → Task editor: routes to (evidence: `frontend/src/App.tsx`)
- Task lists → State and API: uses API (evidence: `frontend/src/components/TaskListsScreen.tsx`)
- Tasks screen → State and API: loads and updates (evidence: `frontend/src/components/TasksScreen.tsx`)
- List editor → State and API: uses API (evidence: `frontend/src/components/CreateUpdateTaskListScreen.tsx`)
- Task editor → State and API: creates and updates (evidence: `frontend/src/components/CreateUpdateTaskScreen.tsx`)
- State and API → Task models: uses types (evidence: `frontend/src/AppProvider.tsx`)
- State and API → List controller: REST requests (evidence: `frontend/src/AppProvider.tsx`)
- State and API → Task controller: REST requests (evidence: `frontend/src/AppProvider.tsx`)
- List controller → List service: delegates to (evidence: `src/main/java/com/hanqiu/taskapp/controller/TaskListController.java`)
- List controller → DTO mappers: maps DTOs (evidence: `src/main/java/com/hanqiu/taskapp/controller/TaskListController.java`)
- Task controller → Task service: delegates to (evidence: `src/main/java/com/hanqiu/taskapp/controller/TaskController.java`)
- Task controller → DTO mappers: maps DTOs (evidence: `src/main/java/com/hanqiu/taskapp/controller/TaskController.java`)
- List service → List repository: persists lists (evidence: `src/main/java/com/hanqiu/taskapp/services/impl/TaskListServiceImpl.java`)
- Task service → List repository: loads list (evidence: `src/main/java/com/hanqiu/taskapp/services/impl/TaskServiceImpl.java`)
- Task service → Task repository: persists tasks (evidence: `src/main/java/com/hanqiu/taskapp/services/impl/TaskServiceImpl.java`)
- DTO mappers → API DTOs: converts (evidence: `src/main/java/com/hanqiu/taskapp/mappers/Impl/TaskMapperImpl.java`)
- DTO mappers → JPA entities: converts (evidence: `src/main/java/com/hanqiu/taskapp/mappers/Impl/TaskMapperImpl.java`)
- List repository → JPA entities: stores (evidence: `src/main/java/com/hanqiu/taskapp/repositories/TaskListRepository.java`)
- Task repository → JPA entities: stores (evidence: `src/main/java/com/hanqiu/taskapp/repositories/TaskRepository.java`)
- JPA entities → PostgreSQL: persisted in (evidence: `README.md`)
- Error handling → API DTOs: returns errors as (evidence: `src/main/java/com/hanqiu/taskapp/controller/GlobalExceptionHandler.java`)
