# jessicathomas13/issue-tracker architecture

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

## Overview

Issue Tracker is a React/TypeScript client backed by an ASP.NET Core API and SQL Server. A user signs in or registers, then works within projects: project roles govern access, issues can be searched and filtered, and members can create or update issues, add comments, and review activity history. Issue status changes are validated before persistence. The graph preserves these product stages and the API’s service/authorization layer. Dashed client-to-API links indicate HTTP use whose exact endpoint wiring is not shown in the excerpts; other edges cite caller files or documented capabilities.

Main entry points: [`backend/IssueTracker.Api/Data/AppDbContext.cs`](https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Data/AppDbContext.cs) (EF data context), [`frontend/src/api/client.ts`](https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/api/client.ts) (API request client), [`frontend/src/App.tsx`](https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/App.tsx) (Route application), [`backend/IssueTracker.Api/Services/IssueService.cs`](https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Services/IssueService.cs) (Issue service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["Route application<br/>[App.tsx]"]
  node_auth_ui["Auth state<br/>[AuthContext.tsx]"]
  node_auth_pages["Sign in / register<br/>[LoginPage.tsx]"]
  node_projects_ui["Project browser<br/>[ProjectsPage.tsx]"]
  node_issues_ui["Issue search"]
  node_details_ui["Issue details"]
  node_api_client["API request client<br/>[client.ts]"]
  node_auth_api["Auth API<br/>[auth.ts]"]
  node_projects_api["Projects API<br/>[projects.ts]"]
  node_issues_api["Issues API<br/>[issues.ts]"]
end

subgraph group_api["API and domain services"]
  node_auth_controller["Auth endpoints<br/>[AuthController.cs]"]
  node_projects_controller["Project endpoints"]
  node_issues_controller["Issue endpoints"]
  node_comments_controller["Comment endpoints"]
  node_auth_service["Authentication service<br/>[AuthService.cs]"]
  node_project_service["Project service<br/>[ProjectService.cs]"]
  node_issue_service["Issue service<br/>[IssueService.cs]"]
  node_comment_service["Comment service<br/>[CommentService.cs]"]
  node_authz["Project authorization"]
  node_status_validator["Status validator"]
  node_activity_log["Activity logging"]
end

subgraph group_data["Domain and persistence"]
  node_domain_models["Issue / project / user models<br/>[Issue.cs]"]
  node_db_context["EF data context<br/>[AppDbContext.cs]"]
end

subgraph group_external["External runtime"]
  node_sql_server[("SQL Server")]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_auth_pages
node_app -->|"routes to"| node_projects_ui
node_app -->|"routes to"| node_issues_ui
node_app -->|"routes to"| node_details_ui
node_auth_pages -->|"updates auth"| node_auth_ui
node_auth_pages -->|"uses"| node_auth_api
node_projects_ui -->|"uses"| node_projects_api
node_issues_ui -->|"uses"| node_issues_api
node_details_ui -->|"uses"| node_issues_api
node_auth_api -->|"requests"| node_api_client
node_projects_api -->|"requests"| node_api_client
node_issues_api -->|"requests"| node_api_client
node_api_client -.->|"HTTP requests"| node_auth_controller
node_api_client -.->|"HTTP requests"| node_projects_controller
node_api_client -.->|"HTTP requests"| node_issues_controller
node_api_client -.->|"HTTP requests"| node_comments_controller
node_auth_controller -->|"delegates"| node_auth_service
node_projects_controller -->|"delegates"| node_project_service
node_issues_controller -->|"delegates"| node_issue_service
node_comments_controller -->|"delegates"| node_comment_service
node_auth_service -->|"reads / writes"| node_db_context
node_project_service -->|"reads / writes"| node_db_context
node_issue_service -->|"reads / writes"| node_db_context
node_comment_service -->|"reads / writes"| node_db_context
node_project_service -->|"checks roles"| node_authz
node_issue_service -->|"checks membership"| node_authz
node_comment_service -->|"checks access"| node_authz
node_issue_service -->|"validates transition"| node_status_validator
node_issue_service -->|"records changes"| node_activity_log
node_activity_log -->|"writes entries"| node_db_context
node_db_context -->|"persists data"| node_sql_server
node_db_context -->|"maps entities"| node_domain_models
node_domain_models -->|"entity mapping"| node_db_context

click node_app "https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/App.tsx"
click node_auth_ui "https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/context/AuthContext.tsx"
click node_auth_pages "https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/pages/LoginPage.tsx"
click node_projects_ui "https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/pages/ProjectsPage.tsx"
click node_issues_ui "https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/pages/ProjectIssuesPage.tsx"
click node_details_ui "https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/pages/IssueDetailsPage.tsx"
click node_api_client "https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/api/client.ts"
click node_auth_api "https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/api/auth.ts"
click node_projects_api "https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/api/projects.ts"
click node_issues_api "https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/api/issues.ts"
click node_auth_controller "https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Controllers/AuthController.cs"
click node_projects_controller "https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Controllers/ProjectsController.cs"
click node_issues_controller "https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Controllers/IssuesController.cs"
click node_comments_controller "https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Controllers/CommentsController.cs"
click node_auth_service "https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Services/AuthService.cs"
click node_project_service "https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Services/ProjectService.cs"
click node_issue_service "https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Services/IssueService.cs"
click node_comment_service "https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Services/CommentService.cs"
click node_authz "https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Services/ProjectAuthorizationService.cs"
click node_status_validator "https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Services/IssueStatusValidator.cs"
click node_activity_log "https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Services/ActivityLogService.cs"
click node_domain_models "https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Models/Issue.cs"
click node_db_context "https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Data/AppDbContext.cs"

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_ui,node_auth_pages,node_projects_ui,node_issues_ui,node_details_ui,node_api_client,node_auth_api,node_projects_api,node_issues_api,node_user toneBlue
class node_auth_controller,node_projects_controller,node_issues_controller,node_comments_controller,node_auth_service,node_project_service,node_issue_service,node_comment_service,node_authz,node_status_validator,node_activity_log toneAmber
class node_domain_models,node_db_context toneMint
class node_sql_server toneRose
```

## Components

### React client

- [Route application](https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Auth state](https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Sign in / register](https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/pages/LoginPage.tsx): `frontend/src/pages/LoginPage.tsx`
- [Project browser](https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/pages/ProjectsPage.tsx): `frontend/src/pages/ProjectsPage.tsx`
- [Issue search](https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/pages/ProjectIssuesPage.tsx): `frontend/src/pages/ProjectIssuesPage.tsx`
- [Issue details](https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/pages/IssueDetailsPage.tsx): `frontend/src/pages/IssueDetailsPage.tsx`
- [API request client](https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`
- [Auth API](https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/api/auth.ts): `frontend/src/api/auth.ts`
- [Projects API](https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/api/projects.ts): `frontend/src/api/projects.ts`
- [Issues API](https://github.com/jessicathomas13/issue-tracker/blob/main/frontend/src/api/issues.ts): `frontend/src/api/issues.ts`

### API and domain services

- [Auth endpoints](https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Controllers/AuthController.cs): `backend/IssueTracker.Api/Controllers/AuthController.cs`
- [Project endpoints](https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Controllers/ProjectsController.cs): `backend/IssueTracker.Api/Controllers/ProjectsController.cs`
- [Issue endpoints](https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Controllers/IssuesController.cs): `backend/IssueTracker.Api/Controllers/IssuesController.cs`
- [Comment endpoints](https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Controllers/CommentsController.cs): `backend/IssueTracker.Api/Controllers/CommentsController.cs`
- [Authentication service](https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Services/AuthService.cs): `backend/IssueTracker.Api/Services/AuthService.cs`
- [Project service](https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Services/ProjectService.cs): `backend/IssueTracker.Api/Services/ProjectService.cs`
- [Issue service](https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Services/IssueService.cs): `backend/IssueTracker.Api/Services/IssueService.cs`
- [Comment service](https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Services/CommentService.cs): `backend/IssueTracker.Api/Services/CommentService.cs`
- [Project authorization](https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Services/ProjectAuthorizationService.cs): `backend/IssueTracker.Api/Services/ProjectAuthorizationService.cs`
- [Status validator](https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Services/IssueStatusValidator.cs): `backend/IssueTracker.Api/Services/IssueStatusValidator.cs`
- [Activity logging](https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Services/ActivityLogService.cs): `backend/IssueTracker.Api/Services/ActivityLogService.cs`

### Domain and persistence

- [Issue / project / user models](https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Models/Issue.cs): `backend/IssueTracker.Api/Models/Issue.cs`
- [EF data context](https://github.com/jessicathomas13/issue-tracker/blob/main/backend/IssueTracker.Api/Data/AppDbContext.cs): `backend/IssueTracker.Api/Data/AppDbContext.cs`

### External runtime

- **SQL Server**

### Other components

- **User**

## Connections

- User → Route application: uses (evidence: `frontend/src/App.tsx`)
- Route application → Sign in / register: routes to (evidence: `frontend/src/App.tsx`)
- Route application → Project browser: routes to (evidence: `frontend/src/App.tsx`)
- Route application → Issue search: routes to (evidence: `frontend/src/App.tsx`)
- Route application → Issue details: routes to (evidence: `frontend/src/App.tsx`)
- Sign in / register → Auth state: updates auth (evidence: `frontend/src/pages/LoginPage.tsx`)
- Sign in / register → Auth API: uses (evidence: `frontend/src/pages/LoginPage.tsx`)
- Project browser → Projects API: uses (evidence: `frontend/src/pages/ProjectsPage.tsx`)
- Issue search → Issues API: uses (evidence: `frontend/src/pages/ProjectIssuesPage.tsx`)
- Issue details → Issues API: uses (evidence: `frontend/src/pages/IssueDetailsPage.tsx`)
- Auth API → API request client: requests (evidence: `frontend/src/api/auth.ts`)
- Projects API → API request client: requests (evidence: `frontend/src/api/projects.ts`)
- Issues API → API request client: requests (evidence: `frontend/src/api/issues.ts`)
- API request client → Auth endpoints: HTTP requests
- API request client → Project endpoints: HTTP requests
- API request client → Issue endpoints: HTTP requests
- API request client → Comment endpoints: HTTP requests
- Auth endpoints → Authentication service: delegates (evidence: `backend/IssueTracker.Api/Controllers/AuthController.cs`)
- Project endpoints → Project service: delegates (evidence: `backend/IssueTracker.Api/Controllers/ProjectsController.cs`)
- Issue endpoints → Issue service: delegates (evidence: `backend/IssueTracker.Api/Controllers/IssuesController.cs`)
- Comment endpoints → Comment service: delegates (evidence: `backend/IssueTracker.Api/Controllers/CommentsController.cs`)
- Authentication service → EF data context: reads / writes (evidence: `backend/IssueTracker.Api/Services/AuthService.cs`)
- Project service → EF data context: reads / writes (evidence: `backend/IssueTracker.Api/Services/ProjectService.cs`)
- Issue service → EF data context: reads / writes (evidence: `backend/IssueTracker.Api/Services/IssueService.cs`)
- Comment service → EF data context: reads / writes (evidence: `backend/IssueTracker.Api/Services/CommentService.cs`)
- Project service → Project authorization: checks roles (evidence: `backend/IssueTracker.Api/Services/ProjectService.cs`)
- Issue service → Project authorization: checks membership (evidence: `backend/IssueTracker.Api/Services/IssueService.cs`)
- Comment service → Project authorization: checks access (evidence: `backend/IssueTracker.Api/Services/CommentService.cs`)
- Issue service → Status validator: validates transition (evidence: `backend/IssueTracker.Api/Services/IssueService.cs`)
- Issue service → Activity logging: records changes (evidence: `backend/IssueTracker.Api/Services/IssueService.cs`)
- Activity logging → EF data context: writes entries (evidence: `backend/IssueTracker.Api/Services/ActivityLogService.cs`)
- EF data context → SQL Server: persists data
- EF data context → Issue / project / user models: maps entities (evidence: `backend/IssueTracker.Api/Data/AppDbContext.cs`)
- Issue / project / user models → EF data context: entity mapping (evidence: `backend/IssueTracker.Api/Data/AppDbContext.cs`)
