# kushal-kn-langoor/ticket-system-fe architecture

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

- Interactive diagram: https://gitdiagram.com/kushal-kn-langoor/ticket-system-fe
- Repository: https://github.com/kushal-kn-langoor/ticket-system-fe

## Overview

HelpDesk Pro is a project-based support-ticket application. Users authenticate, view and create projects, open a project to inspect its summary or board, then create and manage tickets, including ticket details and comments. The sampled pages show client requests passing through a shared API client, which adds authentication and refresh handling; Redux persists authentication state, while a separate context retains legacy demo state. Chatbot and authentication route modules are present, but their internals were not sampled, so their detailed behavior and connections are not asserted.

Main entry points: [`app/project/[id]/page.tsx`](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/project/%5Bid%5D/page.tsx) (Project workspace), [`lib/apiClient.ts`](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/apiClient.ts) (API client), [`components/Navbar.tsx`](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/components/Navbar.tsx) (Navigation and search), [`app/project/[id]/ticket/[ticketId]/page.tsx`](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/project/%5Bid%5D/ticket/%5BticketId%5D/page.tsx) (Ticket details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Identity and session"]
  node_home["Home and login<br/>[page.tsx]"]
  node_signup["Sign up<br/>[page.tsx]"]
  node_loginroute["Login endpoint<br/>[route.ts]"]
  node_signuproute["Signup endpoint<br/>[route.ts]"]
  node_refreshroute["Refresh endpoint<br/>[route.ts]"]
end

subgraph group_projects["Project workspace"]
  node_dashboard["Project dashboard<br/>[page.tsx]"]
  node_project["Project workspace<br/>[page.tsx]"]
  node_summary["Project summary<br/>[SummaryTab.tsx]"]
  node_board["Kanban board<br/>[KanbanBoard.tsx]"]
  node_list["Ticket list<br/>[ListTab.tsx]"]
end

subgraph group_tickets["Ticket workflow"]
  node_create["Create ticket<br/>[page.tsx]"]
  node_ticketdetail["Ticket details<br/>[page.tsx]"]
  node_chatbot["Chatbot<br/>[page.tsx]"]
end

subgraph group_shared["Shared client state"]
  node_navbar["Navigation and search<br/>[Navbar.tsx]"]
  node_apiclient["API client<br/>[apiClient.ts]"]
  node_authstate["Auth state<br/>[authSlice.ts]"]
  node_reduxstore["Redux store<br/>[store.ts]"]
  node_provider["Store provider<br/>[StoreProvider.tsx]"]
  node_hooks["Typed Redux hooks<br/>[hooks.ts]"]
  node_appstore["Demo app context<br/>[AppStore.tsx]"]
  node_datamodel["Project and ticket models<br/>[data.ts]"]
  node_statusoverrides["Ticket status overrides"]
  node_jsonstore["JSON store helper<br/>[jsonStore.ts]"]
end

node_user(("Helpdesk user"))
node_backend{{"Backend API"}}

node_user -->|"opens"| node_home
node_user -->|"registers"| node_signup
node_user -->|"views"| node_dashboard
node_home -->|"reads auth"| node_authstate
node_signup -->|"uses auth"| node_authstate
node_dashboard -->|"loads projects"| node_apiclient
node_dashboard -->|"requests projects"| node_backend
node_dashboard -->|"renders"| node_navbar
node_dashboard -->|"reads user"| node_hooks
node_project -->|"loads project data"| node_apiclient
node_project -->|"requests tickets and summary"| node_backend
node_project -->|"renders"| node_summary
node_project -->|"renders"| node_board
node_project -.->|"selects view"| node_list
node_project -->|"applies overrides"| node_statusoverrides
node_project -->|"maps tickets"| node_datamodel
node_project -->|"reads demo projects"| node_appstore
node_project -->|"renders"| node_navbar
node_create -->|"creates ticket"| node_apiclient
node_create -->|"posts ticket and files"| node_backend
node_create -->|"reads user"| node_hooks
node_create -->|"renders"| node_navbar
node_ticketdetail -->|"loads and updates"| node_apiclient
node_ticketdetail -->|"requests ticket data"| node_backend
node_ticketdetail -->|"applies overrides"| node_statusoverrides
node_ticketdetail -->|"maps ticket"| node_datamodel
node_ticketdetail -->|"reads user"| node_hooks
node_ticketdetail -->|"renders"| node_navbar
node_chatbot -->|"renders"| node_navbar
node_navbar -->|"reads demo projects"| node_appstore
node_navbar -->|"dispatches logout"| node_authstate
node_apiclient -->|"reads and updates auth"| node_reduxstore
node_apiclient -->|"dispatches credentials"| node_authstate
node_apiclient -->|"requests refresh"| node_refreshroute
node_apiclient -->|"sends API requests"| node_backend
node_reduxstore -->|"reduces auth state"| node_authstate
node_provider -->|"provides store"| node_reduxstore
node_hooks -->|"types hooks"| node_reduxstore

click node_home "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/page.tsx"
click node_signup "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/signup/page.tsx"
click node_loginroute "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/api/auth/login/route.ts"
click node_signuproute "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/api/auth/signup/route.ts"
click node_refreshroute "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/api/auth/refresh/route.ts"
click node_dashboard "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/dashboard/page.tsx"
click node_project "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/project/%5Bid%5D/page.tsx"
click node_summary "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/components/SummaryTab.tsx"
click node_board "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/components/KanbanBoard.tsx"
click node_list "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/components/ListTab.tsx"
click node_create "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/create-ticket/page.tsx"
click node_ticketdetail "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/project/%5Bid%5D/ticket/%5BticketId%5D/page.tsx"
click node_chatbot "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/chatbot/page.tsx"
click node_navbar "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/components/Navbar.tsx"
click node_apiclient "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/apiClient.ts"
click node_authstate "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/redux/slices/authSlice.ts"
click node_reduxstore "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/redux/store.ts"
click node_provider "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/redux/StoreProvider.tsx"
click node_hooks "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/redux/hooks.ts"
click node_appstore "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/context/AppStore.tsx"
click node_datamodel "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/data.ts"
click node_statusoverrides "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/ticketStatusStore.ts"
click node_jsonstore "https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/jsonStore.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_home,node_signup,node_loginroute,node_signuproute,node_refreshroute,node_user toneBlue
class node_dashboard,node_project,node_summary,node_board,node_list toneAmber
class node_create,node_ticketdetail,node_chatbot,node_backend toneMint
class node_navbar,node_apiclient,node_authstate,node_reduxstore,node_provider,node_hooks,node_appstore,node_datamodel,node_statusoverrides,node_jsonstore toneRose
```

## Components

### Identity and session

- [Home and login](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/page.tsx): `app/page.tsx`
- [Sign up](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/signup/page.tsx): `app/signup/page.tsx`
- [Login endpoint](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/api/auth/login/route.ts): `app/api/auth/login/route.ts`
- [Signup endpoint](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/api/auth/signup/route.ts): `app/api/auth/signup/route.ts`
- [Refresh endpoint](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/api/auth/refresh/route.ts): `app/api/auth/refresh/route.ts`

### Project workspace

- [Project dashboard](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/dashboard/page.tsx): `app/dashboard/page.tsx`
- [Project workspace](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/project/%5Bid%5D/page.tsx): `app/project/[id]/page.tsx`
- [Project summary](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/components/SummaryTab.tsx): `components/SummaryTab.tsx`
- [Kanban board](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/components/KanbanBoard.tsx): `components/KanbanBoard.tsx`
- [Ticket list](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/components/ListTab.tsx): `components/ListTab.tsx`

### Ticket workflow

- [Create ticket](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/create-ticket/page.tsx): `app/create-ticket/page.tsx`
- [Ticket details](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/project/%5Bid%5D/ticket/%5BticketId%5D/page.tsx): `app/project/[id]/ticket/[ticketId]/page.tsx`
- [Chatbot](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/app/chatbot/page.tsx): `app/chatbot/page.tsx`

### Shared client state

- [Navigation and search](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/components/Navbar.tsx): `components/Navbar.tsx`
- [API client](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/apiClient.ts): `lib/apiClient.ts`
- [Auth state](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/redux/slices/authSlice.ts): `lib/redux/slices/authSlice.ts`
- [Redux store](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/redux/store.ts): `lib/redux/store.ts`
- [Store provider](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/redux/StoreProvider.tsx): `lib/redux/StoreProvider.tsx`
- [Typed Redux hooks](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/redux/hooks.ts): `lib/redux/hooks.ts`
- [Demo app context](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/context/AppStore.tsx): `context/AppStore.tsx`
- [Project and ticket models](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/data.ts): `lib/data.ts`
- [Ticket status overrides](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/ticketStatusStore.ts): `lib/ticketStatusStore.ts`
- [JSON store helper](https://github.com/kushal-kn-langoor/ticket-system-fe/blob/main/lib/jsonStore.ts): `lib/jsonStore.ts`

### Other components

- **Helpdesk user**
- **Backend API**

## Connections

- Helpdesk user → Home and login: opens
- Helpdesk user → Sign up: registers
- Helpdesk user → Project dashboard: views
- Home and login → Auth state: reads auth (evidence: `app/page.tsx`)
- Sign up → Auth state: uses auth (evidence: `app/signup/page.tsx`)
- Project dashboard → API client: loads projects (evidence: `app/dashboard/page.tsx`)
- Project dashboard → Backend API: requests projects (evidence: `app/dashboard/page.tsx`)
- Project dashboard → Navigation and search: renders (evidence: `app/dashboard/page.tsx`)
- Project dashboard → Typed Redux hooks: reads user (evidence: `app/dashboard/page.tsx`)
- Project workspace → API client: loads project data (evidence: `app/project/[id]/page.tsx`)
- Project workspace → Backend API: requests tickets and summary (evidence: `app/project/[id]/page.tsx`)
- Project workspace → Project summary: renders (evidence: `app/project/[id]/page.tsx`)
- Project workspace → Kanban board: renders (evidence: `app/project/[id]/page.tsx`)
- Project workspace → Ticket list: selects view
- Project workspace → Ticket status overrides: applies overrides (evidence: `app/project/[id]/page.tsx`)
- Project workspace → Project and ticket models: maps tickets (evidence: `app/project/[id]/page.tsx`)
- Project workspace → Demo app context: reads demo projects (evidence: `app/project/[id]/page.tsx`)
- Project workspace → Navigation and search: renders (evidence: `app/project/[id]/page.tsx`)
- Create ticket → API client: creates ticket (evidence: `app/create-ticket/page.tsx`)
- Create ticket → Backend API: posts ticket and files (evidence: `app/create-ticket/page.tsx`)
- Create ticket → Typed Redux hooks: reads user (evidence: `app/create-ticket/page.tsx`)
- Create ticket → Navigation and search: renders (evidence: `app/create-ticket/page.tsx`)
- Ticket details → API client: loads and updates (evidence: `app/project/[id]/ticket/[ticketId]/page.tsx`)
- Ticket details → Backend API: requests ticket data (evidence: `app/project/[id]/ticket/[ticketId]/page.tsx`)
- Ticket details → Ticket status overrides: applies overrides (evidence: `app/project/[id]/ticket/[ticketId]/page.tsx`)
- Ticket details → Project and ticket models: maps ticket (evidence: `app/project/[id]/ticket/[ticketId]/page.tsx`)
- Ticket details → Typed Redux hooks: reads user (evidence: `app/project/[id]/ticket/[ticketId]/page.tsx`)
- Ticket details → Navigation and search: renders (evidence: `app/project/[id]/ticket/[ticketId]/page.tsx`)
- Chatbot → Navigation and search: renders (evidence: `app/chatbot/page.tsx`)
- Navigation and search → Demo app context: reads demo projects (evidence: `components/Navbar.tsx`)
- Navigation and search → Auth state: dispatches logout (evidence: `components/Navbar.tsx`)
- API client → Redux store: reads and updates auth (evidence: `lib/apiClient.ts`)
- API client → Auth state: dispatches credentials (evidence: `lib/apiClient.ts`)
- API client → Refresh endpoint: requests refresh (evidence: `lib/apiClient.ts`)
- API client → Backend API: sends API requests (evidence: `lib/apiClient.ts`)
- Redux store → Auth state: reduces auth state (evidence: `lib/redux/store.ts`)
- Store provider → Redux store: provides store (evidence: `lib/redux/StoreProvider.tsx`)
- Typed Redux hooks → Redux store: types hooks (evidence: `lib/redux/hooks.ts`)
