# mahendrakale4/issue-tracker architecture

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

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

## Overview

##### Project type and purpose
- Issuefy is a full-stack issue-tracking web application built with Next.js 15 (App Router).
- It provides UI for creating, listing, editing, and visualizing issues; a REST-like API layer; authentication via Google OAuth; and a PostgreSQL database managed by Prisma.

##### File structure
- Top-level “app” directory: contains React server and client components (layout.tsx, page.tsx), subfolders for feature areas (issues, dashboard, auth, components).
- app/api: Next.js API Routes for authentication (`/auth/[...nextauth]`), issues (`/issues`, `/issues/[id]`), and users (`/users`).
- prisma: ORM setup (schema.prisma, migrations) and client.ts.
- config files: next.config.js, tsconfig.json, tailwind.config.js, Dockerfile, etc.

##### README for additional insights
- Confirms tech stack: Next.js, React Query, Radix UI, React SimpleMDE, NextAuth.js, Zod, Prisma, PostgreSQL (NeonDB), Tailwind CSS.
- Features: real-time issue management, interactive dashboard, secure Google authentication, responsive design.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Side
    subgraph "Client Side (Browser UI)"
        direction TB
        FE_APP["Frontend (Next.js App Router)"]:::frontend
        Layout["Global Layout & Routing"]:::frontend
        Components["Shared UI Components"]:::frontend
        NavBar["NavBar"]:::frontend
        Hero["Hero"]:::frontend
        Features["Features"]:::frontend
        QueryProvider["React Query Provider"]:::frontend
        DashboardPage["Dashboard Page"]:::frontend
        IssuesListPage["Issues List Page"]:::frontend
        IssueDetailPage["Issue Detail Page"]:::frontend
        IssueFormPage["Issue Form Page"]:::frontend
    end

    %% Server Side
    subgraph "Server Side (Next.js Backend)"
        direction TB
        subgraph "API Layer"
            direction TB
            AuthRoute["Auth Routes (/api/auth)"]:::api
            IssueRoutes["Issues Routes (/api/issues)"]:::api
            UserRoutes["User Routes (/api/users)"]:::api
        end

        subgraph "Business Logic & Validation"
            direction TB
            ZodSchemas["Zod Schemas"]:::validation
        end

        subgraph "Data Access Layer"
            direction TB
            PrismaClient["Prisma Client"]:::orm
        end
    end

    %% Database
    DB["PostgreSQL Database (NeonDB)"]:::database

    %% External Services
    subgraph "External Services"
        direction TB
        GoogleOAuth["Google OAuth Provider"]:::external
        NeonDBHost["NeonDB Hosting"]:::external
    end

    %% Client to Server interactions
    FE_APP -->|"uses"| QueryProvider
    FE_APP -->|"renders"| Layout
    FE_APP -->|"calls UI Components"| Components
    FE_APP -->|"navigates"| NavBar
    FE_APP -->|"navigates"| Hero
    FE_APP -->|"navigates"| Features
    FE_APP -->|"fetches data"| AuthRoute
    FE_APP -->|"fetches data"| IssueRoutes
    FE_APP -->|"fetches data"| UserRoutes

    %% API to Validation and ORM
    AuthRoute -->|"validate"| ZodSchemas
    IssueRoutes -->|"validate"| ZodSchemas
    UserRoutes -->|"validate"| ZodSchemas

    ZodSchemas -->|"calls"| PrismaClient
    PrismaClient -->|"executes SQL"| DB

    %% Auth flow
    AuthRoute -->|"auth flow"| GoogleOAuth
    GoogleOAuth -->|"callback"| AuthRoute
    AuthRoute -->|"store sessions"| DB

    %% External DB host
    DB --> NeonDBHost

    %% Click Events
    click FE_APP "https://github.com/mahendrakale4/issue-tracker/tree/main/app/"
    click Layout "https://github.com/mahendrakale4/issue-tracker/blob/main/app/layout.tsx"
    click Components "https://github.com/mahendrakale4/issue-tracker/tree/main/app/components/"
    click NavBar "https://github.com/mahendrakale4/issue-tracker/blob/main/app/NavBar.tsx"
    click Hero "https://github.com/mahendrakale4/issue-tracker/blob/main/app/Hero.tsx"
    click Features "https://github.com/mahendrakale4/issue-tracker/blob/main/app/Features.tsx"
    click QueryProvider "https://github.com/mahendrakale4/issue-tracker/blob/main/app/QueryClientProvider.tsx"
    click AuthRoute "https://github.com/mahendrakale4/issue-tracker/blob/main/app/api/auth/[...nextauth]/route.ts"
    click IssueRoutes "https://github.com/mahendrakale4/issue-tracker/blob/main/app/api/issues/route.tsx"
    click IssueRoutes "https://github.com/mahendrakale4/issue-tracker/blob/main/app/api/issues/[id]/route.tsx"
    click UserRoutes "https://github.com/mahendrakale4/issue-tracker/blob/main/app/api/users/route.ts"
    click ZodSchemas "https://github.com/mahendrakale4/issue-tracker/blob/main/app/validationSchema.tsx"
    click ZodSchemas "https://github.com/mahendrakale4/issue-tracker/blob/main/app/components/validationSchema.tsx"
    click PrismaClient "https://github.com/mahendrakale4/issue-tracker/blob/main/prisma/client.ts"
    click DB "https://github.com/mahendrakale4/issue-tracker/blob/main/prisma/schema.prisma"
    click DB "https://github.com/mahendrakale4/issue-tracker/blob/main/prisma/migrations/20241223093101_init/migration.sql"
    click Dockerfile "https://github.com/mahendrakale4/issue-tracker/tree/main/Dockerfile"
    click NeonDBHost "https://github.com/mahendrakale4/issue-tracker/tree/main/Dockerfile"

    %% Styles and Config
    subgraph "Styling & Config"
        globals["globals.css"]:::config
        theme["theme-config.css"]:::config
        tailwind["tailwind.config.js"]:::config
        nextconf["next.config.js"]:::config
        tsconf["tsconfig.json"]:::config
        postcss["postcss.config.js"]:::config
        dockerignore[".dockerignore"]:::config
    end

    %% connections
    FE_APP -->|"styles"| globals
    FE_APP -->|"styles"| theme
    globals --> tailwind
    subgraph "Docker"
        Docker["Dockerfile"]:::config
        Dockerignore[".dockerignore"]:::config
    end

    %% Styling and config connections
    Docker --> FE_APP

    %% Styles
    classDef frontend fill:#E0F7FA,stroke:#006064,color:#004D40;
    classDef api fill:#E8F5E9,stroke:#1B5E20,color:#2E7D32;
    classDef validation fill:#FFF3E0,stroke:#E65100,color:#EF6C00;
    classDef orm fill:#EDE7F6,stroke:#4527A0,color:#5E35B1;
    classDef database fill:#ECEFF1,stroke:#37474F,color:#263238;
    classDef external fill:#FFEBEE,stroke:#B71C1C,color:#C62828;
    classDef config fill:#F3E5F5,stroke:#6A1B9A,color:#4A148C;
```
