# ryan-b553/issue-tracker-assessment architecture

> Architecture diagram of the GitHub repository ryan-b553/issue-tracker-assessment, 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/ryan-b553/issue-tracker-assessment
- Repository: https://github.com/ryan-b553/issue-tracker-assessment

## Overview

Issue Tracker lets users register or log in, then create, filter, assign, update, and comment on issues; a dashboard summarizes issue totals and distributions. The browser pages use cached query hooks and a shared fetch helper to call Next.js API routes, which validate requests, enforce session and edit permissions, and access MySQL through Prisma. The graph also includes user lookup and the shared UI/auth layers. Relationships for unsampled handlers and pages follow the README and SOURCE INDEX; those files were not inspected directly.

Main entry points: [`src/lib/api.ts`](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/lib/api.ts) (Fetch helper), [`src/lib/prisma.ts`](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/lib/prisma.ts) (Prisma client), [`src/app/issues/[id]/page.tsx`](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/app/issues/%5Bid%5D/page.tsx) (Issue detail), [`src/hooks/useIssues.ts`](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/hooks/useIssues.ts) (Issue query hook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser experience"]
  node_issue_list["Issue list<br/>[page.tsx]"]
  node_new_issue["New issue<br/>[page.tsx]"]
  node_issue_detail["Issue detail<br/>[page.tsx]"]
  node_dashboard["Dashboard<br/>[page.tsx]"]
  node_auth_pages["Login and register"]
  node_auth_guard["Auth guard<br/>[AuthGuard.tsx]"]
  node_nav["Navigation<br/>[Navbar.tsx]"]
  node_status_badge["Status badge<br/>[StatusBadge.tsx]"]
  node_priority_badge["Priority badge<br/>[PriorityBadge.tsx]"]
  node_current_user_hook["Current-user hook<br/>[useCurrentUser.ts]"]
  node_issues_hook["Issue query hook<br/>[useIssues.ts]"]
  node_users_hook["User query hook<br/>[useUsers.ts]"]
  node_api_helper["Fetch helper<br/>[api.ts]"]
end

subgraph group_auth["Identity and access"]
  node_auth_routes["Auth endpoints"]
  node_auth_logic["Session and auth<br/>[auth.ts]"]
  node_auth_validation["Auth validation<br/>[auth.ts]"]
end

subgraph group_issues["Issue management"]
  node_issue_routes["Issue endpoints"]
  node_comment_route["Comment endpoint<br/>[route.ts]"]
  node_issue_validation["Issue validation<br/>[issue.ts]"]
end

subgraph group_data["API and persistence"]
  node_user_route["User endpoint<br/>[route.ts]"]
  node_dashboard_route["Dashboard endpoint<br/>[route.ts]"]
  node_prisma_client["Prisma client<br/>[prisma.ts]"]
  node_mysql[("MySQL database<br/>[schema.prisma]")]
end

node_user(("User"))

node_user -->|"signs in"| node_auth_pages
node_user -->|"browses issues"| node_issue_list
node_user -->|"creates issues"| node_new_issue
node_user -->|"updates and comments"| node_issue_detail
node_user -->|"views metrics"| node_dashboard
node_auth_guard -->|"checks session"| node_current_user_hook
node_nav -->|"reads user"| node_current_user_hook
node_issue_list -->|"loads issues"| node_issues_hook
node_new_issue -->|"mutates issues"| node_issues_hook
node_new_issue -->|"loads assignees"| node_users_hook
node_issue_detail -->|"loads and updates"| node_issues_hook
node_issue_detail -->|"loads assignees"| node_users_hook
node_dashboard -->|"loads issues"| node_issues_hook
node_issue_list -->|"renders status"| node_status_badge
node_issue_detail -->|"renders status"| node_status_badge
node_issue_detail -->|"renders priority"| node_priority_badge
node_issues_hook -->|"fetches issues"| node_api_helper
node_current_user_hook -->|"fetches session"| node_api_helper
node_users_hook -->|"fetches users"| node_api_helper
node_auth_pages -.->|"calls auth API"| node_api_helper
node_api_helper -.->|"sends requests"| node_auth_routes
node_api_helper -->|"sends requests"| node_issue_routes
node_api_helper -->|"sends requests"| node_comment_route
node_api_helper -->|"sends requests"| node_user_route
node_api_helper -->|"sends requests"| node_dashboard_route
node_auth_routes -->|"uses sessions"| node_auth_logic
node_auth_routes -->|"validates credentials"| node_auth_validation
node_issue_routes -->|"checks access"| node_auth_logic
node_issue_routes -->|"validates input"| node_issue_validation
node_comment_route -->|"validates comment"| node_issue_validation
node_issue_routes -->|"reads and writes"| node_prisma_client
node_comment_route -->|"reads and writes"| node_prisma_client
node_auth_routes -->|"accesses users"| node_prisma_client
node_user_route -->|"queries users"| node_prisma_client
node_dashboard_route -->|"aggregates issues"| node_prisma_client
node_prisma_client -->|"persists records"| node_mysql

click node_issue_list "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/app/issues/page.tsx"
click node_new_issue "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/app/issues/new/page.tsx"
click node_issue_detail "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/app/issues/%5Bid%5D/page.tsx"
click node_dashboard "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/app/dashboard/page.tsx"
click node_auth_pages "https://github.com/ryan-b553/issue-tracker-assessment/tree/main/src/app/(auth)"
click node_auth_guard "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/components/AuthGuard.tsx"
click node_nav "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/components/Navbar.tsx"
click node_status_badge "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/components/StatusBadge.tsx"
click node_priority_badge "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/components/PriorityBadge.tsx"
click node_current_user_hook "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/hooks/useCurrentUser.ts"
click node_issues_hook "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/hooks/useIssues.ts"
click node_users_hook "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/hooks/useUsers.ts"
click node_api_helper "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/lib/api.ts"
click node_auth_routes "https://github.com/ryan-b553/issue-tracker-assessment/tree/main/src/app/api/auth"
click node_auth_logic "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/lib/auth.ts"
click node_auth_validation "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/lib/validations/auth.ts"
click node_issue_routes "https://github.com/ryan-b553/issue-tracker-assessment/tree/main/src/app/api/issues"
click node_comment_route "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/app/api/issues/%5Bid%5D/comments/route.ts"
click node_issue_validation "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/lib/validations/issue.ts"
click node_user_route "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/app/api/users/route.ts"
click node_dashboard_route "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/app/api/dashboard/route.ts"
click node_prisma_client "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/lib/prisma.ts"
click node_mysql "https://github.com/ryan-b553/issue-tracker-assessment/blob/main/prisma/schema.prisma"

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_issue_list,node_new_issue,node_issue_detail,node_dashboard,node_auth_pages,node_auth_guard,node_nav,node_status_badge,node_priority_badge,node_current_user_hook,node_issues_hook,node_users_hook,node_api_helper,node_user toneBlue
class node_auth_routes,node_auth_logic,node_auth_validation toneAmber
class node_issue_routes,node_comment_route,node_issue_validation toneMint
class node_user_route,node_dashboard_route,node_prisma_client,node_mysql toneRose
```

## Components

### Browser experience

- [Issue list](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/app/issues/page.tsx): `src/app/issues/page.tsx`
- [New issue](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/app/issues/new/page.tsx): `src/app/issues/new/page.tsx`
- [Issue detail](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/app/issues/%5Bid%5D/page.tsx): `src/app/issues/[id]/page.tsx`
- [Dashboard](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/app/dashboard/page.tsx): `src/app/dashboard/page.tsx`
- [Login and register](https://github.com/ryan-b553/issue-tracker-assessment/tree/main/src/app/(auth)): `src/app/(auth)`
- [Auth guard](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/components/AuthGuard.tsx): `src/components/AuthGuard.tsx`
- [Navigation](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Status badge](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/components/StatusBadge.tsx): `src/components/StatusBadge.tsx`
- [Priority badge](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/components/PriorityBadge.tsx): `src/components/PriorityBadge.tsx`
- [Current-user hook](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/hooks/useCurrentUser.ts): `src/hooks/useCurrentUser.ts`
- [Issue query hook](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/hooks/useIssues.ts): `src/hooks/useIssues.ts`
- [User query hook](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/hooks/useUsers.ts): `src/hooks/useUsers.ts`
- [Fetch helper](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/lib/api.ts): `src/lib/api.ts`

### Identity and access

- [Auth endpoints](https://github.com/ryan-b553/issue-tracker-assessment/tree/main/src/app/api/auth): `src/app/api/auth`
- [Session and auth](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Auth validation](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/lib/validations/auth.ts): `src/lib/validations/auth.ts`

### Issue management

- [Issue endpoints](https://github.com/ryan-b553/issue-tracker-assessment/tree/main/src/app/api/issues): `src/app/api/issues`
- [Comment endpoint](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/app/api/issues/%5Bid%5D/comments/route.ts): `src/app/api/issues/[id]/comments/route.ts`
- [Issue validation](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/lib/validations/issue.ts): `src/lib/validations/issue.ts`

### API and persistence

- [User endpoint](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/app/api/users/route.ts): `src/app/api/users/route.ts`
- [Dashboard endpoint](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/app/api/dashboard/route.ts): `src/app/api/dashboard/route.ts`
- [Prisma client](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`
- [MySQL database](https://github.com/ryan-b553/issue-tracker-assessment/blob/main/prisma/schema.prisma): `prisma/schema.prisma`

### Other components

- **User**

## Connections

- User → Login and register: signs in (evidence: `README.md`)
- User → Issue list: browses issues (evidence: `README.md`)
- User → New issue: creates issues (evidence: `README.md`)
- User → Issue detail: updates and comments (evidence: `README.md`)
- User → Dashboard: views metrics (evidence: `README.md`)
- Auth guard → Current-user hook: checks session (evidence: `src/components/AuthGuard.tsx`)
- Navigation → Current-user hook: reads user (evidence: `src/components/Navbar.tsx`)
- Issue list → Issue query hook: loads issues (evidence: `src/app/issues/page.tsx`)
- New issue → Issue query hook: mutates issues (evidence: `src/app/issues/new/page.tsx`)
- New issue → User query hook: loads assignees (evidence: `src/app/issues/new/page.tsx`)
- Issue detail → Issue query hook: loads and updates (evidence: `src/app/issues/[id]/page.tsx`)
- Issue detail → User query hook: loads assignees (evidence: `src/app/issues/[id]/page.tsx`)
- Dashboard → Issue query hook: loads issues (evidence: `src/app/dashboard/page.tsx`)
- Issue list → Status badge: renders status (evidence: `src/app/issues/page.tsx`)
- Issue detail → Status badge: renders status (evidence: `src/app/issues/[id]/page.tsx`)
- Issue detail → Priority badge: renders priority (evidence: `src/app/issues/[id]/page.tsx`)
- Issue query hook → Fetch helper: fetches issues (evidence: `src/hooks/useIssues.ts`)
- Current-user hook → Fetch helper: fetches session (evidence: `src/hooks/useCurrentUser.ts`)
- User query hook → Fetch helper: fetches users (evidence: `src/hooks/useUsers.ts`)
- Login and register → Fetch helper: calls auth API
- Fetch helper → Auth endpoints: sends requests
- Fetch helper → Issue endpoints: sends requests (evidence: `README.md`)
- Fetch helper → Comment endpoint: sends requests (evidence: `README.md`)
- Fetch helper → User endpoint: sends requests (evidence: `README.md`)
- Fetch helper → Dashboard endpoint: sends requests (evidence: `README.md`)
- Auth endpoints → Session and auth: uses sessions (evidence: `src/app/api/auth/login/route.ts`)
- Auth endpoints → Auth validation: validates credentials (evidence: `src/app/api/auth/login/route.ts`)
- Issue endpoints → Session and auth: checks access (evidence: `src/app/api/issues/route.ts`)
- Issue endpoints → Issue validation: validates input (evidence: `src/app/api/issues/route.ts`)
- Comment endpoint → Issue validation: validates comment (evidence: `README.md`)
- Issue endpoints → Prisma client: reads and writes (evidence: `src/app/api/issues/route.ts`)
- Comment endpoint → Prisma client: reads and writes (evidence: `src/app/api/issues/[id]/comments/route.ts`)
- Auth endpoints → Prisma client: accesses users (evidence: `src/app/api/auth/login/route.ts`)
- User endpoint → Prisma client: queries users (evidence: `src/app/api/users/route.ts`)
- Dashboard endpoint → Prisma client: aggregates issues (evidence: `src/app/api/dashboard/route.ts`)
- Prisma client → MySQL database: persists records (evidence: `README.md`)
