# sohumsen96/superrdev-patch-exercise architecture

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

- Interactive diagram: https://gitdiagram.com/sohumsen96/superrdev-patch-exercise
- Repository: https://github.com/sohumsen96/superrdev-patch-exercise

## Overview

Task Tracker is a small full-stack app for browsing tasks by search term and status, with paginated results. The UI state and controls lead to a fetch hook and API request; Spring handles the request, queries task records, and returns a page for display. The README also identifies an Oracle SQL artifact that mirrors query logic but is not part of the local runtime. Connections reflect excerpts and README statements; the Oracle relationship is documented only at a high level.

Main entry points: [`frontend/src/App.jsx`](https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/frontend/src/App.jsx) (App and Paging), [`backend/src/main/java/com/internal/tasktracker/TaskController.java`](https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/backend/src/main/java/com/internal/tasktracker/TaskController.java) (Task Controller), [`backend/src/main/java/com/internal/tasktracker/TaskRepository.java`](https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/backend/src/main/java/com/internal/tasktracker/TaskRepository.java) (Task Repository), [`frontend/src/hooks/useTasks.js`](https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/frontend/src/hooks/useTasks.js) (Task Fetch Hook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Task UI"]
  node_app["App and Paging<br/>[App.jsx]"]
  node_search["Search Input<br/>[SearchBar.jsx]"]
  node_filter["Status Filter<br/>[StatusFilter.jsx]"]
  node_table["Task Table<br/>[TaskTable.jsx]"]
end

subgraph group_client["Frontend Data"]
  node_hook["Task Fetch Hook<br/>[useTasks.js]"]
  node_clientapi["Tasks Client<br/>[api.js]"]
end

subgraph group_server["Task API"]
  node_controller["Task Controller"]
  node_repository["Task Repository"]
  node_task["Task Entity<br/>[Task.java]"]
  node_status["Task Status<br/>[TaskStatus.java]"]
  node_database[("H2 Database")]
end

subgraph group_sql["SQL Reference"]
  node_oracle["Oracle Query Reference"]
  node_sqlquery["Search SQL<br/>[search_tasks.sql]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_search
node_app -->|"renders"| node_filter
node_app -->|"renders"| node_table
node_app -->|"loads tasks"| node_hook
node_hook -->|"fetches tasks"| node_clientapi
node_clientapi -->|"requests tasks"| node_controller
node_controller -->|"searches tasks"| node_repository
node_repository -->|"queries entities"| node_task
node_controller -->|"parses status"| node_status
node_repository -->|"queries records"| node_database
node_sqlquery -.->|"mirrors query logic"| node_oracle

click node_app "https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/frontend/src/App.jsx"
click node_search "https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/frontend/src/components/SearchBar.jsx"
click node_filter "https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/frontend/src/components/StatusFilter.jsx"
click node_table "https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/frontend/src/components/TaskTable.jsx"
click node_hook "https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/frontend/src/hooks/useTasks.js"
click node_clientapi "https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/frontend/src/api.js"
click node_controller "https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/backend/src/main/java/com/internal/tasktracker/TaskController.java"
click node_repository "https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/backend/src/main/java/com/internal/tasktracker/TaskRepository.java"
click node_task "https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/backend/src/main/java/com/internal/tasktracker/Task.java"
click node_status "https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/backend/src/main/java/com/internal/tasktracker/TaskStatus.java"
click node_oracle "https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/db/oracle/task_search_package.sql"
click node_sqlquery "https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/db/queries/search_tasks.sql"

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_search,node_filter,node_table,node_user toneBlue
class node_hook,node_clientapi toneAmber
class node_controller,node_repository,node_task,node_status,node_database toneMint
class node_oracle,node_sqlquery toneRose
```

## Components

### Task UI

- [App and Paging](https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Search Input](https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/frontend/src/components/SearchBar.jsx): `frontend/src/components/SearchBar.jsx`
- [Status Filter](https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/frontend/src/components/StatusFilter.jsx): `frontend/src/components/StatusFilter.jsx`
- [Task Table](https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/frontend/src/components/TaskTable.jsx): `frontend/src/components/TaskTable.jsx`

### Frontend Data

- [Task Fetch Hook](https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/frontend/src/hooks/useTasks.js): `frontend/src/hooks/useTasks.js`
- [Tasks Client](https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/frontend/src/api.js): `frontend/src/api.js`

### Task API

- [Task Controller](https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/backend/src/main/java/com/internal/tasktracker/TaskController.java): `backend/src/main/java/com/internal/tasktracker/TaskController.java`
- [Task Repository](https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/backend/src/main/java/com/internal/tasktracker/TaskRepository.java): `backend/src/main/java/com/internal/tasktracker/TaskRepository.java`
- [Task Entity](https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/backend/src/main/java/com/internal/tasktracker/Task.java): `backend/src/main/java/com/internal/tasktracker/Task.java`
- [Task Status](https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/backend/src/main/java/com/internal/tasktracker/TaskStatus.java): `backend/src/main/java/com/internal/tasktracker/TaskStatus.java`
- **H2 Database**

### SQL Reference

- [Oracle Query Reference](https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/db/oracle/task_search_package.sql): `db/oracle/task_search_package.sql`
- [Search SQL](https://github.com/sohumsen96/superrdev-patch-exercise/blob/main/db/queries/search_tasks.sql): `db/queries/search_tasks.sql`

### Other components

- **User**

## Connections

- User → App and Paging: uses (evidence: `README.md`)
- App and Paging → Search Input: renders (evidence: `frontend/src/App.jsx`)
- App and Paging → Status Filter: renders (evidence: `frontend/src/App.jsx`)
- App and Paging → Task Table: renders (evidence: `frontend/src/App.jsx`)
- App and Paging → Task Fetch Hook: loads tasks (evidence: `frontend/src/App.jsx`)
- Task Fetch Hook → Tasks Client: fetches tasks (evidence: `frontend/src/hooks/useTasks.js`)
- Tasks Client → Task Controller: requests tasks (evidence: `frontend/src/api.js`)
- Task Controller → Task Repository: searches tasks (evidence: `backend/src/main/java/com/internal/tasktracker/TaskController.java`)
- Task Repository → Task Entity: queries entities (evidence: `backend/src/main/java/com/internal/tasktracker/TaskRepository.java`)
- Task Controller → Task Status: parses status (evidence: `backend/src/main/java/com/internal/tasktracker/TaskController.java`)
- Task Repository → H2 Database: queries records (evidence: `README.md`)
- Search SQL → Oracle Query Reference: mirrors query logic (evidence: `README.md`)
