# viveksyal/kanban-board architecture

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

- Interactive diagram: https://gitdiagram.com/viveksyal/kanban-board
- Repository: https://github.com/viveksyal/kanban-board

## Overview

Kanban-Board is a backend API for user accounts and managing boards, lists, and cards. The main workflow is an authenticated client request routed through validation and authentication middleware to a domain controller, then a service that reads or changes persisted data and returns a response. The graph shows those layers and the ordering features exposed for lists and cards. Source excerpts and the SOURCE INDEX support the links shown; the README itself provides no further capability details, and unsampled implementation details are not inferred.

Main entry points: [`backend/src/app.ts`](https://github.com/viveksyal/kanban-board/blob/main/backend/src/app.ts) (Express app), [`backend/src/routes/auth.routes.ts`](https://github.com/viveksyal/kanban-board/blob/main/backend/src/routes/auth.routes.ts) (Auth routes), [`backend/src/routes/board.routes.ts`](https://github.com/viveksyal/kanban-board/blob/main/backend/src/routes/board.routes.ts) (Board routes), [`backend/src/routes/list.routes.ts`](https://github.com/viveksyal/kanban-board/blob/main/backend/src/routes/list.routes.ts) (List routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry and routing"]
  node_app["Express app<br/>[app.ts]"]
  node_auth_routes["Auth routes<br/>[auth.routes.ts]"]
  node_board_routes["Board routes<br/>[board.routes.ts]"]
  node_list_routes["List routes<br/>[list.routes.ts]"]
  node_card_routes["Card routes<br/>[card.routes.ts]"]
end

subgraph group_domain["Kanban domain"]
  node_auth_controller["Auth controller<br/>[auth.controller.ts]"]
  node_board_controller["Board controller"]
  node_list_controller["List controller<br/>[list.controller.ts]"]
  node_card_controller["Card controller<br/>[card.controller.ts]"]
  node_auth_service["Auth service<br/>[auth.service.ts]"]
  node_board_service["Board service<br/>[board.service.ts]"]
  node_list_service["List service<br/>[list.service.ts]"]
  node_card_service["Card service<br/>[card.service.ts]"]
end

subgraph group_identity["Identity and request checks"]
  node_auth_middleware["Authentication<br/>[auth.middleware.ts]"]
  node_validation["Request validation"]
  node_auth_validator["Auth schemas<br/>[auth.validator.ts]"]
  node_board_validator["Board schemas<br/>[board.validator.ts]"]
  node_list_validator["List schemas<br/>[list.validator.ts]"]
  node_card_validator["Card schemas<br/>[card.validator.ts]"]
  node_error_middleware["Error handler"]
end

subgraph group_persistence["Persistence and utilities"]
  node_prisma["Prisma client<br/>[prisma.ts]"]
  node_postgres[("PostgreSQL")]
  node_hash_utils["Password hashing<br/>[hash.utils.ts]"]
  node_jwt_utils["JWT utilities<br/>[jwt.utils.ts]"]
  node_error_utils["App errors<br/>[error.utils.ts]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_app -->|"mounts routes"| node_auth_routes
node_app -->|"mounts routes"| node_board_routes
node_app -->|"mounts routes"| node_list_routes
node_app -->|"mounts routes"| node_card_routes
node_app -->|"handles errors"| node_error_middleware
node_auth_routes -->|"dispatches to"| node_auth_controller
node_board_routes -->|"dispatches to"| node_board_controller
node_list_routes -->|"dispatches to"| node_list_controller
node_card_routes -->|"dispatches to"| node_card_controller
node_auth_routes -->|"validates with"| node_validation
node_board_routes -->|"validates with"| node_validation
node_list_routes -->|"validates with"| node_validation
node_card_routes -->|"validates with"| node_validation
node_auth_routes -->|"uses schemas"| node_auth_validator
node_board_routes -->|"uses schemas"| node_board_validator
node_list_routes -->|"uses schemas"| node_list_validator
node_card_routes -->|"uses schemas"| node_card_validator
node_auth_routes -->|"protects endpoints"| node_auth_middleware
node_board_routes -->|"protects endpoints"| node_auth_middleware
node_list_routes -->|"protects endpoints"| node_auth_middleware
node_card_routes -->|"protects endpoints"| node_auth_middleware
node_auth_controller -->|"calls"| node_auth_service
node_board_controller -->|"calls"| node_board_service
node_list_controller -->|"calls"| node_list_service
node_card_controller -->|"calls"| node_card_service
node_auth_service -->|"queries data"| node_prisma
node_board_service -->|"queries data"| node_prisma
node_list_service -->|"queries data"| node_prisma
node_card_service -->|"queries data"| node_prisma
node_prisma -->|"connects to"| node_postgres
node_auth_service -->|"hashes passwords"| node_hash_utils
node_auth_service -->|"signs tokens"| node_jwt_utils
node_auth_middleware -->|"verifies tokens"| node_jwt_utils
node_auth_service -->|"creates errors"| node_error_utils
node_board_service -->|"creates errors"| node_error_utils
node_list_service -->|"creates errors"| node_error_utils
node_card_service -->|"creates errors"| node_error_utils
node_error_middleware -->|"handles app errors"| node_error_utils

click node_app "https://github.com/viveksyal/kanban-board/blob/main/backend/src/app.ts"
click node_auth_routes "https://github.com/viveksyal/kanban-board/blob/main/backend/src/routes/auth.routes.ts"
click node_board_routes "https://github.com/viveksyal/kanban-board/blob/main/backend/src/routes/board.routes.ts"
click node_list_routes "https://github.com/viveksyal/kanban-board/blob/main/backend/src/routes/list.routes.ts"
click node_card_routes "https://github.com/viveksyal/kanban-board/blob/main/backend/src/routes/card.routes.ts"
click node_auth_controller "https://github.com/viveksyal/kanban-board/blob/main/backend/src/controllers/auth.controller.ts"
click node_board_controller "https://github.com/viveksyal/kanban-board/blob/main/backend/src/controllers/board.controller.ts"
click node_list_controller "https://github.com/viveksyal/kanban-board/blob/main/backend/src/controllers/list.controller.ts"
click node_card_controller "https://github.com/viveksyal/kanban-board/blob/main/backend/src/controllers/card.controller.ts"
click node_auth_service "https://github.com/viveksyal/kanban-board/blob/main/backend/src/services/auth.service.ts"
click node_board_service "https://github.com/viveksyal/kanban-board/blob/main/backend/src/services/board.service.ts"
click node_list_service "https://github.com/viveksyal/kanban-board/blob/main/backend/src/services/list.service.ts"
click node_card_service "https://github.com/viveksyal/kanban-board/blob/main/backend/src/services/card.service.ts"
click node_auth_middleware "https://github.com/viveksyal/kanban-board/blob/main/backend/src/middlewares/auth.middleware.ts"
click node_validation "https://github.com/viveksyal/kanban-board/blob/main/backend/src/middlewares/validate.middleware.ts"
click node_auth_validator "https://github.com/viveksyal/kanban-board/blob/main/backend/src/validators/auth.validator.ts"
click node_board_validator "https://github.com/viveksyal/kanban-board/blob/main/backend/src/validators/board.validator.ts"
click node_list_validator "https://github.com/viveksyal/kanban-board/blob/main/backend/src/validators/list.validator.ts"
click node_card_validator "https://github.com/viveksyal/kanban-board/blob/main/backend/src/validators/card.validator.ts"
click node_error_middleware "https://github.com/viveksyal/kanban-board/blob/main/backend/src/middlewares/error.middleware.ts"
click node_prisma "https://github.com/viveksyal/kanban-board/blob/main/backend/src/lib/prisma.ts"
click node_hash_utils "https://github.com/viveksyal/kanban-board/blob/main/backend/src/utils/hash.utils.ts"
click node_jwt_utils "https://github.com/viveksyal/kanban-board/blob/main/backend/src/utils/jwt.utils.ts"
click node_error_utils "https://github.com/viveksyal/kanban-board/blob/main/backend/src/utils/error.utils.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_app,node_auth_routes,node_board_routes,node_list_routes,node_card_routes,node_client toneBlue
class node_auth_controller,node_board_controller,node_list_controller,node_card_controller,node_auth_service,node_board_service,node_list_service,node_card_service toneAmber
class node_auth_middleware,node_validation,node_auth_validator,node_board_validator,node_list_validator,node_card_validator,node_error_middleware toneMint
class node_prisma,node_postgres,node_hash_utils,node_jwt_utils,node_error_utils toneRose
```

## Components

### API entry and routing

- [Express app](https://github.com/viveksyal/kanban-board/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Auth routes](https://github.com/viveksyal/kanban-board/blob/main/backend/src/routes/auth.routes.ts): `backend/src/routes/auth.routes.ts`
- [Board routes](https://github.com/viveksyal/kanban-board/blob/main/backend/src/routes/board.routes.ts): `backend/src/routes/board.routes.ts`
- [List routes](https://github.com/viveksyal/kanban-board/blob/main/backend/src/routes/list.routes.ts): `backend/src/routes/list.routes.ts`
- [Card routes](https://github.com/viveksyal/kanban-board/blob/main/backend/src/routes/card.routes.ts): `backend/src/routes/card.routes.ts`

### Kanban domain

- [Auth controller](https://github.com/viveksyal/kanban-board/blob/main/backend/src/controllers/auth.controller.ts): `backend/src/controllers/auth.controller.ts`
- [Board controller](https://github.com/viveksyal/kanban-board/blob/main/backend/src/controllers/board.controller.ts): `backend/src/controllers/board.controller.ts`
- [List controller](https://github.com/viveksyal/kanban-board/blob/main/backend/src/controllers/list.controller.ts): `backend/src/controllers/list.controller.ts`
- [Card controller](https://github.com/viveksyal/kanban-board/blob/main/backend/src/controllers/card.controller.ts): `backend/src/controllers/card.controller.ts`
- [Auth service](https://github.com/viveksyal/kanban-board/blob/main/backend/src/services/auth.service.ts): `backend/src/services/auth.service.ts`
- [Board service](https://github.com/viveksyal/kanban-board/blob/main/backend/src/services/board.service.ts): `backend/src/services/board.service.ts`
- [List service](https://github.com/viveksyal/kanban-board/blob/main/backend/src/services/list.service.ts): `backend/src/services/list.service.ts`
- [Card service](https://github.com/viveksyal/kanban-board/blob/main/backend/src/services/card.service.ts): `backend/src/services/card.service.ts`

### Identity and request checks

- [Authentication](https://github.com/viveksyal/kanban-board/blob/main/backend/src/middlewares/auth.middleware.ts): `backend/src/middlewares/auth.middleware.ts`
- [Request validation](https://github.com/viveksyal/kanban-board/blob/main/backend/src/middlewares/validate.middleware.ts): `backend/src/middlewares/validate.middleware.ts`
- [Auth schemas](https://github.com/viveksyal/kanban-board/blob/main/backend/src/validators/auth.validator.ts): `backend/src/validators/auth.validator.ts`
- [Board schemas](https://github.com/viveksyal/kanban-board/blob/main/backend/src/validators/board.validator.ts): `backend/src/validators/board.validator.ts`
- [List schemas](https://github.com/viveksyal/kanban-board/blob/main/backend/src/validators/list.validator.ts): `backend/src/validators/list.validator.ts`
- [Card schemas](https://github.com/viveksyal/kanban-board/blob/main/backend/src/validators/card.validator.ts): `backend/src/validators/card.validator.ts`
- [Error handler](https://github.com/viveksyal/kanban-board/blob/main/backend/src/middlewares/error.middleware.ts): `backend/src/middlewares/error.middleware.ts`

### Persistence and utilities

- [Prisma client](https://github.com/viveksyal/kanban-board/blob/main/backend/src/lib/prisma.ts): `backend/src/lib/prisma.ts`
- **PostgreSQL**
- [Password hashing](https://github.com/viveksyal/kanban-board/blob/main/backend/src/utils/hash.utils.ts): `backend/src/utils/hash.utils.ts`
- [JWT utilities](https://github.com/viveksyal/kanban-board/blob/main/backend/src/utils/jwt.utils.ts): `backend/src/utils/jwt.utils.ts`
- [App errors](https://github.com/viveksyal/kanban-board/blob/main/backend/src/utils/error.utils.ts): `backend/src/utils/error.utils.ts`

### Other components

- **API client**

## Connections

- API client → Express app: sends requests (evidence: `backend/src/app.ts`)
- Express app → Auth routes: mounts routes (evidence: `backend/src/app.ts`)
- Express app → Board routes: mounts routes (evidence: `backend/src/app.ts`)
- Express app → List routes: mounts routes (evidence: `backend/src/app.ts`)
- Express app → Card routes: mounts routes (evidence: `backend/src/app.ts`)
- Express app → Error handler: handles errors (evidence: `backend/src/app.ts`)
- Auth routes → Auth controller: dispatches to (evidence: `backend/src/routes/auth.routes.ts`)
- Board routes → Board controller: dispatches to (evidence: `backend/src/routes/board.routes.ts`)
- List routes → List controller: dispatches to (evidence: `backend/src/routes/list.routes.ts`)
- Card routes → Card controller: dispatches to (evidence: `backend/src/routes/card.routes.ts`)
- Auth routes → Request validation: validates with (evidence: `backend/src/routes/auth.routes.ts`)
- Board routes → Request validation: validates with (evidence: `backend/src/routes/board.routes.ts`)
- List routes → Request validation: validates with (evidence: `backend/src/routes/list.routes.ts`)
- Card routes → Request validation: validates with (evidence: `backend/src/routes/card.routes.ts`)
- Auth routes → Auth schemas: uses schemas (evidence: `backend/src/routes/auth.routes.ts`)
- Board routes → Board schemas: uses schemas (evidence: `backend/src/routes/board.routes.ts`)
- List routes → List schemas: uses schemas (evidence: `backend/src/routes/list.routes.ts`)
- Card routes → Card schemas: uses schemas (evidence: `backend/src/routes/card.routes.ts`)
- Auth routes → Authentication: protects endpoints (evidence: `backend/src/routes/auth.routes.ts`)
- Board routes → Authentication: protects endpoints (evidence: `backend/src/routes/board.routes.ts`)
- List routes → Authentication: protects endpoints (evidence: `backend/src/routes/list.routes.ts`)
- Card routes → Authentication: protects endpoints (evidence: `backend/src/routes/card.routes.ts`)
- Auth controller → Auth service: calls (evidence: `backend/src/controllers/auth.controller.ts`)
- Board controller → Board service: calls (evidence: `backend/src/controllers/board.controller.ts`)
- List controller → List service: calls (evidence: `backend/src/controllers/list.controller.ts`)
- Card controller → Card service: calls (evidence: `backend/src/controllers/card.controller.ts`)
- Auth service → Prisma client: queries data (evidence: `backend/src/services/auth.service.ts`)
- Board service → Prisma client: queries data (evidence: `backend/src/services/board.service.ts`)
- List service → Prisma client: queries data (evidence: `backend/src/services/list.service.ts`)
- Card service → Prisma client: queries data (evidence: `backend/src/services/card.service.ts`)
- Prisma client → PostgreSQL: connects to (evidence: `backend/src/lib/prisma.ts`)
- Auth service → Password hashing: hashes passwords (evidence: `backend/src/services/auth.service.ts`)
- Auth service → JWT utilities: signs tokens (evidence: `backend/src/services/auth.service.ts`)
- Authentication → JWT utilities: verifies tokens (evidence: `backend/src/middlewares/auth.middleware.ts`)
- Auth service → App errors: creates errors (evidence: `backend/src/services/auth.service.ts`)
- Board service → App errors: creates errors (evidence: `backend/src/services/board.service.ts`)
- List service → App errors: creates errors (evidence: `backend/src/services/list.service.ts`)
- Card service → App errors: creates errors (evidence: `backend/src/services/card.service.ts`)
- Error handler → App errors: handles app errors (evidence: `backend/src/middlewares/error.middleware.ts`)
