# uit-devops-project/application architecture

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

- Interactive diagram: https://gitdiagram.com/uit-devops-project/application
- Repository: https://github.com/uit-devops-project/application

## Overview

This is an educational-task Kanban application: users organize boards and cards, edit task details, and reorder or move work through drag-and-drop. The browser UI calls an Express API, whose controllers delegate board/card operations to services backed by Prisma. The README chiefly documents deployment and CI/CD, so it does not establish additional runtime product features. Some component links are supported by the SOURCE INDEX; database and HTTP links are marked unverified where the excerpts do not show the complete connection.

Main entry points: [`frontend/src/components/KanbanBoard.tsx`](https://github.com/uit-devops-project/application/blob/main/frontend/src/components/KanbanBoard.tsx) (Board coordinator), [`frontend/src/components/BoardContainer.tsx`](https://github.com/uit-devops-project/application/blob/main/frontend/src/components/BoardContainer.tsx) (Board column), [`backend/src/server.js`](https://github.com/uit-devops-project/application/blob/main/backend/src/server.js) (Express server), [`frontend/src/components/BoardOptionsIcon.tsx`](https://github.com/uit-devops-project/application/blob/main/frontend/src/components/BoardOptionsIcon.tsx) (Board actions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Kanban interface"]
  node_app["React app<br/>[App.tsx]"]
  node_board["Board coordinator<br/>[KanbanBoard.tsx]"]
  node_drag["Drag and drop"]
  node_column["Board column<br/>[BoardContainer.tsx]"]
  node_task["Task card<br/>[TaskCard.tsx]"]
  node_boardform["Board editor<br/>[BoardFormModal.tsx]"]
  node_cardform["Card editor<br/>[CardFormModal.tsx]"]
  node_boardoptions["Board actions"]
  node_cardoptions["Card actions"]
  node_icons["Action icons"]
  node_boardapi["Board API client<br/>[boardApi.ts]"]
  node_cardapi["Card API client<br/>[cardApi.ts]"]
end

subgraph group_api["HTTP API"]
  node_server["Express server<br/>[server.js]"]
  node_boardroutes["Board routes<br/>[boardRoutes.js]"]
  node_cardroutes["Card routes<br/>[cardRoutes.js]"]
  node_boardcontroller["Board controller<br/>[boardController.js]"]
  node_cardcontroller["Card controller<br/>[cardController.js]"]
end

subgraph group_domain["Board and card services"]
  node_boardservice["Board service<br/>[boardService.js]"]
  node_cardservice["Card service<br/>[cardService.js]"]
end

subgraph group_persistence["Persistence"]
  node_prisma["Prisma client<br/>[prismaClient.js]"]
  node_postgres[("PostgreSQL")]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_board
node_board -->|"loads and mutates boards"| node_boardapi
node_board -->|"loads and mutates cards"| node_cardapi
node_board -->|"renders"| node_drag
node_board -->|"opens editor"| node_boardform
node_drag -->|"renders"| node_column
node_column -->|"renders"| node_task
node_column -->|"uses"| node_cardform
node_column -->|"uses"| node_boardoptions
node_task -->|"uses"| node_cardoptions
node_boardoptions -->|"opens editor"| node_boardform
node_boardoptions -->|"uses"| node_icons
node_cardoptions -->|"uses"| node_icons
node_boardapi -.->|"requests boards"| node_server
node_cardapi -.->|"requests cards"| node_server
node_server -->|"mounts routes"| node_boardroutes
node_server -->|"mounts routes"| node_cardroutes
node_boardroutes -->|"dispatches"| node_boardcontroller
node_cardroutes -->|"dispatches"| node_cardcontroller
node_boardcontroller -->|"delegates"| node_boardservice
node_cardcontroller -->|"delegates"| node_cardservice
node_boardservice -->|"uses"| node_prisma
node_cardservice -->|"uses"| node_prisma
node_prisma -.->|"queries"| node_postgres

click node_app "https://github.com/uit-devops-project/application/blob/main/frontend/src/App.tsx"
click node_board "https://github.com/uit-devops-project/application/blob/main/frontend/src/components/KanbanBoard.tsx"
click node_drag "https://github.com/uit-devops-project/application/blob/main/frontend/src/components/DragAndDropWrapper.tsx"
click node_column "https://github.com/uit-devops-project/application/blob/main/frontend/src/components/BoardContainer.tsx"
click node_task "https://github.com/uit-devops-project/application/blob/main/frontend/src/components/TaskCard.tsx"
click node_boardform "https://github.com/uit-devops-project/application/blob/main/frontend/src/components/BoardFormModal.tsx"
click node_cardform "https://github.com/uit-devops-project/application/blob/main/frontend/src/components/CardFormModal.tsx"
click node_boardoptions "https://github.com/uit-devops-project/application/blob/main/frontend/src/components/BoardOptionsIcon.tsx"
click node_cardoptions "https://github.com/uit-devops-project/application/blob/main/frontend/src/components/CardOptionsIcon.tsx"
click node_icons "https://github.com/uit-devops-project/application/tree/main/frontend/src/icons"
click node_boardapi "https://github.com/uit-devops-project/application/blob/main/frontend/src/api/boardApi.ts"
click node_cardapi "https://github.com/uit-devops-project/application/blob/main/frontend/src/api/cardApi.ts"
click node_server "https://github.com/uit-devops-project/application/blob/main/backend/src/server.js"
click node_boardroutes "https://github.com/uit-devops-project/application/blob/main/backend/src/routes/boardRoutes.js"
click node_cardroutes "https://github.com/uit-devops-project/application/blob/main/backend/src/routes/cardRoutes.js"
click node_boardcontroller "https://github.com/uit-devops-project/application/blob/main/backend/src/controllers/boardController.js"
click node_cardcontroller "https://github.com/uit-devops-project/application/blob/main/backend/src/controllers/cardController.js"
click node_boardservice "https://github.com/uit-devops-project/application/blob/main/backend/src/services/boardService.js"
click node_cardservice "https://github.com/uit-devops-project/application/blob/main/backend/src/services/cardService.js"
click node_prisma "https://github.com/uit-devops-project/application/blob/main/backend/src/prisma/prismaClient.js"

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_board,node_drag,node_column,node_task,node_boardform,node_cardform,node_boardoptions,node_cardoptions,node_icons,node_boardapi,node_cardapi,node_user toneBlue
class node_server,node_boardroutes,node_cardroutes,node_boardcontroller,node_cardcontroller toneAmber
class node_boardservice,node_cardservice toneMint
class node_prisma,node_postgres toneRose
```

## Components

### Kanban interface

- [React app](https://github.com/uit-devops-project/application/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Board coordinator](https://github.com/uit-devops-project/application/blob/main/frontend/src/components/KanbanBoard.tsx): `frontend/src/components/KanbanBoard.tsx`
- [Drag and drop](https://github.com/uit-devops-project/application/blob/main/frontend/src/components/DragAndDropWrapper.tsx): `frontend/src/components/DragAndDropWrapper.tsx`
- [Board column](https://github.com/uit-devops-project/application/blob/main/frontend/src/components/BoardContainer.tsx): `frontend/src/components/BoardContainer.tsx`
- [Task card](https://github.com/uit-devops-project/application/blob/main/frontend/src/components/TaskCard.tsx): `frontend/src/components/TaskCard.tsx`
- [Board editor](https://github.com/uit-devops-project/application/blob/main/frontend/src/components/BoardFormModal.tsx): `frontend/src/components/BoardFormModal.tsx`
- [Card editor](https://github.com/uit-devops-project/application/blob/main/frontend/src/components/CardFormModal.tsx): `frontend/src/components/CardFormModal.tsx`
- [Board actions](https://github.com/uit-devops-project/application/blob/main/frontend/src/components/BoardOptionsIcon.tsx): `frontend/src/components/BoardOptionsIcon.tsx`
- [Card actions](https://github.com/uit-devops-project/application/blob/main/frontend/src/components/CardOptionsIcon.tsx): `frontend/src/components/CardOptionsIcon.tsx`
- [Action icons](https://github.com/uit-devops-project/application/tree/main/frontend/src/icons): `frontend/src/icons`
- [Board API client](https://github.com/uit-devops-project/application/blob/main/frontend/src/api/boardApi.ts): `frontend/src/api/boardApi.ts`
- [Card API client](https://github.com/uit-devops-project/application/blob/main/frontend/src/api/cardApi.ts): `frontend/src/api/cardApi.ts`

### HTTP API

- [Express server](https://github.com/uit-devops-project/application/blob/main/backend/src/server.js): `backend/src/server.js`
- [Board routes](https://github.com/uit-devops-project/application/blob/main/backend/src/routes/boardRoutes.js): `backend/src/routes/boardRoutes.js`
- [Card routes](https://github.com/uit-devops-project/application/blob/main/backend/src/routes/cardRoutes.js): `backend/src/routes/cardRoutes.js`
- [Board controller](https://github.com/uit-devops-project/application/blob/main/backend/src/controllers/boardController.js): `backend/src/controllers/boardController.js`
- [Card controller](https://github.com/uit-devops-project/application/blob/main/backend/src/controllers/cardController.js): `backend/src/controllers/cardController.js`

### Board and card services

- [Board service](https://github.com/uit-devops-project/application/blob/main/backend/src/services/boardService.js): `backend/src/services/boardService.js`
- [Card service](https://github.com/uit-devops-project/application/blob/main/backend/src/services/cardService.js): `backend/src/services/cardService.js`

### Persistence

- [Prisma client](https://github.com/uit-devops-project/application/blob/main/backend/src/prisma/prismaClient.js): `backend/src/prisma/prismaClient.js`
- **PostgreSQL**

### Other components

- **User**

## Connections

- User → React app: uses (evidence: `frontend/src/App.tsx`)
- React app → Board coordinator: renders (evidence: `frontend/src/App.tsx`)
- Board coordinator → Board API client: loads and mutates boards (evidence: `frontend/src/components/KanbanBoard.tsx`)
- Board coordinator → Card API client: loads and mutates cards (evidence: `frontend/src/components/KanbanBoard.tsx`)
- Board coordinator → Drag and drop: renders (evidence: `frontend/src/components/KanbanBoard.tsx`)
- Board coordinator → Board editor: opens editor (evidence: `frontend/src/components/KanbanBoard.tsx`)
- Drag and drop → Board column: renders (evidence: `frontend/src/components/DragAndDropWrapper.tsx`)
- Board column → Task card: renders (evidence: `frontend/src/components/BoardContainer.tsx`)
- Board column → Card editor: uses (evidence: `frontend/src/components/BoardContainer.tsx`)
- Board column → Board actions: uses (evidence: `frontend/src/components/BoardContainer.tsx`)
- Task card → Card actions: uses (evidence: `frontend/src/components/TaskCard.tsx`)
- Board actions → Board editor: opens editor (evidence: `frontend/src/components/BoardOptionsIcon.tsx`)
- Board actions → Action icons: uses (evidence: `frontend/src/components/BoardOptionsIcon.tsx`)
- Card actions → Action icons: uses (evidence: `frontend/src/components/CardOptionsIcon.tsx`)
- Board API client → Express server: requests boards
- Card API client → Express server: requests cards
- Express server → Board routes: mounts routes (evidence: `backend/src/server.js`)
- Express server → Card routes: mounts routes (evidence: `backend/src/server.js`)
- Board routes → Board controller: dispatches (evidence: `backend/src/routes/boardRoutes.js`)
- Card routes → Card controller: dispatches (evidence: `backend/src/routes/cardRoutes.js`)
- Board controller → Board service: delegates (evidence: `backend/src/controllers/boardController.js`)
- Card controller → Card service: delegates (evidence: `backend/src/controllers/cardController.js`)
- Board service → Prisma client: uses (evidence: `backend/src/services/boardService.js`)
- Card service → Prisma client: uses (evidence: `backend/src/services/cardService.js`)
- Prisma client → PostgreSQL: queries
