# mosh-hamedani/issue-tracker architecture

> Architecture diagram of the GitHub repository mosh-hamedani/issue-tracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mosh-hamedani/issue-tracker
- Repository: https://github.com/mosh-hamedani/issue-tracker

## Overview

##### Project Type Analysis
This is a full-stack web application built with Next.js 13+ (evident from the app directory structure), using Prisma as an ORM, and implementing authentication. It's a modern issue tracking system similar to platforms like Jira or GitHub Issues.

##### Main Components

A. Frontend Layer:
- Issue Management UI (IssueForm, IssueTable, IssueDetails)
- Dashboard Components (IssueChart, IssueSummary, LatestIssues)
- Common Components (ErrorMessage, Spinner, Pagination)

B. API Layer:
- Issues API (/api/issues/*)
- Authentication API (/api/auth/*)
- Users API (/api/users)

C. Authentication System:
- NextAuth.js Provider
- Authentication Options
- External Auth Providers (based on auth configuration)

D. Database Layer:
- A container for "Database" showing:
- Prisma ORM
- Database Tables (from prisma/schema.prisma)

##### Component Relationships

- Client Components → API Routes (HTTP requests)
- API Routes → Prisma Client
- Prisma Client → Database
- Auth Provider → External Auth Services
- Auth Provider ↔ API Routes

##### Technical Stack Highlights

A "Technology Stack" section showing:
- Next.js 13+ (Framework)
- Prisma (ORM)
- NextAuth.js (Authentication)
- TypeScript
- Tailwind CSS

##### Specific Implementation Details

A. Route Structure:
- App router structure:
- /issues/[id] (Issue Details)
- /issues/new (Create Issue)
- /issues/edit/[id] (Edit Issue)
- /issues/list (Issue List)

B. Data Flow:
- Server Components vs Client Components
- API endpoint interactions
- Demonstrate authentication flow

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        IssueManagement["Issue Management UI"]
        Dashboard["Dashboard Components"]
        Common["Common Components"]

        subgraph IssueManagement
            IssueForm["Issue Form"]:::frontend
            IssueTable["Issue Table"]:::frontend
            IssueDetails["Issue Details"]:::frontend
        end

        subgraph Dashboard
            IssueChart["Issue Chart"]:::frontend
            IssueSummary["Issue Summary"]:::frontend
            LatestIssues["Latest Issues"]:::frontend
        end

        subgraph Common
            ErrorMessage["Error Message"]:::frontend
            Spinner["Spinner"]:::frontend
            Pagination["Pagination"]:::frontend
        end
    end

    subgraph API
        IssuesAPI["Issues API"]:::api
        AuthAPI["Authentication API"]:::api
        UsersAPI["Users API"]:::api
    end

    subgraph Auth
        AuthProvider["Auth Provider"]:::auth
        AuthOptions["Auth Options"]:::auth
        ExternalAuth["External Auth Providers"]:::auth
    end

    subgraph Database
        PrismaORM["Prisma ORM"]:::db
        DBSchema["Database Schema"]:::db
        Migrations["Migrations"]:::db
    end

    subgraph Routes
        CreateIssue["Create Issue"]:::route
        EditIssue["Edit Issue"]:::route
        ViewIssue["View Issue"]:::route
        ListIssues["List Issues"]:::route
    end

    subgraph LoadingStates
        ListLoading["List Loading"]:::loading
        DetailsLoading["Details Loading"]:::loading
        NewLoading["New Loading"]:::loading
    end

    IssueManagement --> API
    Dashboard --> API
    API --> PrismaORM
    PrismaORM --> DBSchema
    AuthProvider --> ExternalAuth
    AuthProvider <--> AuthAPI
    
    %% Click events
    click IssueForm "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/issues/_components/IssueForm.tsx"
    click IssueTable "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/issues/list/IssueTable.tsx"
    click IssueDetails "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/issues/[id]/IssueDetails.tsx"
    click IssueChart "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/IssueChart.tsx"
    click IssueSummary "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/IssueSummary.tsx"
    click LatestIssues "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/LatestIssues.tsx"
    click ErrorMessage "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/components/ErrorMessage.tsx"
    click Spinner "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/components/Spinner.tsx"
    click Pagination "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/components/Pagination.tsx"
    click IssuesAPI "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/api/issues/route.ts"
    click AuthAPI "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/api/auth/[...nextauth]/route.ts"
    click UsersAPI "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/api/users/route.ts"
    click AuthProvider "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/auth/Provider.tsx"
    click AuthOptions "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/auth/authOptions.ts"
    click PrismaORM "https://github.com/mosh-hamedani/issue-tracker/blob/main/prisma/client.ts"
    click DBSchema "https://github.com/mosh-hamedani/issue-tracker/blob/main/prisma/schema.prisma"
    click Migrations "https://github.com/mosh-hamedani/issue-tracker/tree/main/prisma/migrations/"
    click CreateIssue "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/issues/new/page.tsx"
    click EditIssue "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/issues/edit/[id]/page.tsx"
    click ViewIssue "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/issues/[id]/page.tsx"
    click ListIssues "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/issues/list/page.tsx"
    click ListLoading "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/issues/list/loading.tsx"
    click DetailsLoading "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/issues/[id]/loading.tsx"
    click NewLoading "https://github.com/mosh-hamedani/issue-tracker/blob/main/app/issues/new/loading.tsx"

    %% Styling
    classDef frontend fill:#3b82f6,color:#fff
    classDef api fill:#22c55e,color:#fff
    classDef auth fill:#eab308,color:#000
    classDef db fill:#ef4444,color:#fff
    classDef route fill:#8b5cf6,color:#fff
    classDef loading fill:#f97316,color:#fff
```
