# yash12122004/eyva-assignment architecture

> Architecture diagram of the GitHub repository yash12122004/eyva-assignment, 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/yash12122004/eyva-assignment
- Repository: https://github.com/yash12122004/eyva-assignment

## Overview

EYVA is a project-management app: users register or log in, view and create projects, then open a project to manage tasks on a status-based Kanban board. The React frontend calls an Express API; authenticated routes validate requests where configured, controllers query PostgreSQL, and results return to the UI. The README documents PostgreSQL-backed users, projects, and tasks. The graph includes documented deployment/database context and the major task-editing UI; unsampled internals are represented only where the tree and source index support them.

Main entry points: [`backend/src/routes/projectRoutes.js`](https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/routes/projectRoutes.js) (Project routes), [`frontend/src/App.tsx`](https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/App.tsx) (Routes and app shell), [`backend/src/routes/taskRoutes.js`](https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/routes/taskRoutes.js) (Task routes), [`frontend/src/api/axios.ts`](https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/api/axios.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["Routes and app shell<br/>[App.tsx]"]
  node_login["Login and register<br/>[Login.tsx]"]
  node_authstate["Auth state<br/>[AuthContext.tsx]"]
  node_dashboard["Project dashboard<br/>[Dashboard.tsx]"]
  node_projectview["Project view<br/>[ProjectView.tsx]"]
  node_board["Kanban board<br/>[KanbanBoard.tsx]"]
  node_column["Task column<br/>[TaskColumn.tsx]"]
  node_card["Task card<br/>[TaskCard.tsx]"]
  node_modal["Task editor<br/>[TaskModal.tsx]"]
  node_http["API client<br/>[axios.ts]"]
end

subgraph group_api["API and access"]
  node_server["Express API<br/>[app.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_projectroutes["Project routes<br/>[projectRoutes.js]"]
  node_taskroutes["Task routes<br/>[taskRoutes.js]"]
  node_authcontroller["Auth handlers<br/>[authController.js]"]
  node_authmw["JWT middleware<br/>[authMiddleware.js]"]
  node_validation["Request validation<br/>[validate.js]"]
  node_schemas["Validation schemas<br/>[schema-zod.js]"]
end

subgraph group_domain["Project and task domain"]
  node_projects["Project handlers"]
  node_tasks["Task handlers<br/>[taskController.js]"]
end

subgraph group_persistence["Persistence"]
  node_pool["PostgreSQL pool<br/>[db.js]"]
  node_postgres[("PostgreSQL")]
end

node_user(("User"))
node_browser["Browser"]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_projectview
node_app -->|"provides auth"| node_authstate
node_login -->|"sends auth requests"| node_http
node_login -->|"sets session"| node_authstate
node_dashboard -->|"requests projects"| node_http
node_projectview -->|"requests project data"| node_http
node_projectview -->|"renders"| node_board
node_board -->|"renders"| node_column
node_board -->|"uses"| node_card
node_column -->|"renders"| node_card
node_column -->|"opens"| node_modal
node_column -->|"updates tasks"| node_http
node_http -.->|"HTTP requests"| node_server
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_projectroutes
node_server -->|"mounts"| node_taskroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_authroutes -->|"validates"| node_validation
node_authroutes -->|"uses schemas"| node_schemas
node_projectroutes -->|"dispatches"| node_projects
node_projectroutes -->|"dispatches"| node_tasks
node_projectroutes -->|"protects routes"| node_authmw
node_projectroutes -->|"validates"| node_validation
node_projectroutes -->|"uses schemas"| node_schemas
node_taskroutes -->|"dispatches"| node_tasks
node_taskroutes -->|"protects routes"| node_authmw
node_taskroutes -->|"validates"| node_validation
node_taskroutes -->|"uses schemas"| node_schemas
node_projects -->|"queries"| node_pool
node_tasks -->|"queries"| node_pool
node_authcontroller -->|"queries"| node_pool
node_pool -.->|"reads and writes"| node_postgres
node_browser -->|"stores session"| node_authstate

click node_app "https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/App.tsx"
click node_login "https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/pages/Login.tsx"
click node_authstate "https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/context/AuthContext.tsx"
click node_dashboard "https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/pages/Dashboard.tsx"
click node_projectview "https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/pages/ProjectView.tsx"
click node_board "https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/components/kanban/KanbanBoard.tsx"
click node_column "https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/components/kanban/TaskColumn.tsx"
click node_card "https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/components/kanban/TaskCard.tsx"
click node_modal "https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/components/TaskModal.tsx"
click node_http "https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/api/axios.ts"
click node_server "https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/app.js"
click node_authroutes "https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/routes/authRoutes.js"
click node_projectroutes "https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/routes/projectRoutes.js"
click node_taskroutes "https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/routes/taskRoutes.js"
click node_authcontroller "https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/controllers/authController.js"
click node_authmw "https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/middleware/authMiddleware.js"
click node_validation "https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/middleware/validate.js"
click node_schemas "https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/schemas/schema-zod.js"
click node_projects "https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/controllers/projectController.js"
click node_tasks "https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/controllers/taskController.js"
click node_pool "https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/db.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_login,node_authstate,node_dashboard,node_projectview,node_board,node_column,node_card,node_modal,node_http,node_user,node_browser toneBlue
class node_server,node_authroutes,node_projectroutes,node_taskroutes,node_authcontroller,node_authmw,node_validation,node_schemas toneAmber
class node_projects,node_tasks toneMint
class node_pool,node_postgres toneRose
```

## Components

### Web application

- [Routes and app shell](https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Login and register](https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/pages/Login.tsx): `frontend/src/pages/Login.tsx`
- [Auth state](https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Project dashboard](https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/pages/Dashboard.tsx): `frontend/src/pages/Dashboard.tsx`
- [Project view](https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/pages/ProjectView.tsx): `frontend/src/pages/ProjectView.tsx`
- [Kanban board](https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/components/kanban/KanbanBoard.tsx): `frontend/src/components/kanban/KanbanBoard.tsx`
- [Task column](https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/components/kanban/TaskColumn.tsx): `frontend/src/components/kanban/TaskColumn.tsx`
- [Task card](https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/components/kanban/TaskCard.tsx): `frontend/src/components/kanban/TaskCard.tsx`
- [Task editor](https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/components/TaskModal.tsx): `frontend/src/components/TaskModal.tsx`
- [API client](https://github.com/yash12122004/eyva-assignment/blob/main/frontend/src/api/axios.ts): `frontend/src/api/axios.ts`

### API and access

- [Express API](https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/app.js): `backend/src/app.js`
- [Auth routes](https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/routes/authRoutes.js): `backend/src/routes/authRoutes.js`
- [Project routes](https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/routes/projectRoutes.js): `backend/src/routes/projectRoutes.js`
- [Task routes](https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/routes/taskRoutes.js): `backend/src/routes/taskRoutes.js`
- [Auth handlers](https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/controllers/authController.js): `backend/src/controllers/authController.js`
- [JWT middleware](https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/middleware/authMiddleware.js): `backend/src/middleware/authMiddleware.js`
- [Request validation](https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/middleware/validate.js): `backend/src/middleware/validate.js`
- [Validation schemas](https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/schemas/schema-zod.js): `backend/src/schemas/schema-zod.js`

### Project and task domain

- [Project handlers](https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/controllers/projectController.js): `backend/src/controllers/projectController.js`
- [Task handlers](https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/controllers/taskController.js): `backend/src/controllers/taskController.js`

### Persistence

- [PostgreSQL pool](https://github.com/yash12122004/eyva-assignment/blob/main/backend/src/db.js): `backend/src/db.js`
- **PostgreSQL**

### Other components

- **User**
- **Browser**

## Connections

- User → Routes and app shell: uses (evidence: `frontend/src/App.tsx`)
- Routes and app shell → Login and register: routes to (evidence: `frontend/src/App.tsx`)
- Routes and app shell → Project dashboard: routes to (evidence: `frontend/src/App.tsx`)
- Routes and app shell → Project view: routes to (evidence: `frontend/src/App.tsx`)
- Routes and app shell → Auth state: provides auth (evidence: `frontend/src/App.tsx`)
- Login and register → API client: sends auth requests (evidence: `frontend/src/pages/Login.tsx`)
- Login and register → Auth state: sets session (evidence: `frontend/src/pages/Login.tsx`)
- Project dashboard → API client: requests projects (evidence: `frontend/src/pages/Dashboard.tsx`)
- Project view → API client: requests project data (evidence: `frontend/src/pages/ProjectView.tsx`)
- Project view → Kanban board: renders (evidence: `frontend/src/pages/ProjectView.tsx`)
- Kanban board → Task column: renders (evidence: `frontend/src/components/kanban/KanbanBoard.tsx`)
- Kanban board → Task card: uses (evidence: `frontend/src/components/kanban/KanbanBoard.tsx`)
- Task column → Task card: renders (evidence: `frontend/src/components/kanban/TaskColumn.tsx`)
- Task column → Task editor: opens (evidence: `frontend/src/components/kanban/TaskColumn.tsx`)
- Task column → API client: updates tasks (evidence: `frontend/src/components/kanban/TaskColumn.tsx`)
- API client → Express API: HTTP requests (evidence: `README.md`)
- Express API → Auth routes: mounts (evidence: `backend/src/app.js`)
- Express API → Project routes: mounts (evidence: `backend/src/app.js`)
- Express API → Task routes: mounts (evidence: `backend/src/app.js`)
- Auth routes → Auth handlers: dispatches (evidence: `backend/src/routes/authRoutes.js`)
- Auth routes → Request validation: validates (evidence: `backend/src/routes/authRoutes.js`)
- Auth routes → Validation schemas: uses schemas (evidence: `backend/src/routes/authRoutes.js`)
- Project routes → Project handlers: dispatches (evidence: `backend/src/routes/projectRoutes.js`)
- Project routes → Task handlers: dispatches (evidence: `backend/src/routes/projectRoutes.js`)
- Project routes → JWT middleware: protects routes (evidence: `backend/src/routes/projectRoutes.js`)
- Project routes → Request validation: validates (evidence: `backend/src/routes/projectRoutes.js`)
- Project routes → Validation schemas: uses schemas (evidence: `backend/src/routes/projectRoutes.js`)
- Task routes → Task handlers: dispatches (evidence: `backend/src/routes/taskRoutes.js`)
- Task routes → JWT middleware: protects routes (evidence: `backend/src/routes/taskRoutes.js`)
- Task routes → Request validation: validates (evidence: `backend/src/routes/taskRoutes.js`)
- Task routes → Validation schemas: uses schemas (evidence: `backend/src/routes/taskRoutes.js`)
- Project handlers → PostgreSQL pool: queries (evidence: `backend/src/controllers/projectController.js`)
- Task handlers → PostgreSQL pool: queries (evidence: `backend/src/controllers/taskController.js`)
- Auth handlers → PostgreSQL pool: queries (evidence: `backend/src/controllers/authController.js`)
- PostgreSQL pool → PostgreSQL: reads and writes (evidence: `README.md`)
- Browser → Auth state: stores session (evidence: `frontend/src/context/AuthContext.tsx`)
