# caturhidayat/issue-tracker architecture

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

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

## Overview

##### Main System Components

a) Frontend Layer:
- Next.js App Router architecture (indicated by the /app directory)
- Client Components (components directory)
- Server Components (pages)
- Server Actions (actions directory)

b) API Layer:
- REST API endpoints (api directory)
- Route handlers for CRUD operations

c) Database Layer:
- Prisma ORM
- Underlying database (likely PostgreSQL based on Prisma setup)

**┌─────────────────────────────────────────┐**
- Client Layer                            │
- ┌─────────────┐ ┌─────────────────────┐ │
- Components  │ │ Pages               │ │
- Navbar    │ │ - Home (page.tsx)   │ │
- ListIssues│ │ - Issue (issue/*.tsx)│ │
- ┘ └─────────────────────┘ │
- ┘

**┌─────────────────────────────────────────┐**
- Server Layer                            │
- ┌─────────────┐ ┌─────────────────────┐ │
- API Routes  │ │ Server Actions      │ │
- /api/issue  │ │ /actions/issue      │ │
- ┘ └─────────────────────┘ │
- ┘

**┌─────────────────────────────────────────┐**
- Data Layer                              │
- ┌─────────────┐                         │
- Prisma ORM  │                         │
- Database    │                         │
- ┘                         │
- ┘

##### Technology Stack Callouts

- Next.js 13+ (App Router)
- Prisma ORM
- TypeScript
- Tailwind CSS
- Database system

##### Component Relationships

Specific interactions:
- FormIssue → Server Actions
- ListIssues → API Routes
- EditIssueDialog → Server Actions
- DeleteButton → API Routes

##### Data Flow Patterns

Patterns:
- Server-side rendering flow
- Client-side mutations
- API route handling
- Database queries through Prisma

Use different line styles to represent:

##### Environment Configuration

A small section showing:
- Development environment setup
- Environment variables flow
- Build/deployment configuration

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Client
        Navbar["Navbar"]
        ListIssues["ListIssues"]
        FormIssue["FormIssue"]
        EditIssueDialog["EditIssueDialog"]
        DeleteButton["DeleteButton"]
    end

    subgraph Pages
        RootPage["Root Page"]
        IssuePage["Issue Page"]
        RootLayout["Root Layout"]
        LoadingState["Loading State"]
    end

    subgraph API
        IssueAPI["Issue API Routes"]
        IssueIDAPI["Issue ID Routes"]
        ServerActions["Server Actions"]
    end

    subgraph Database
        PrismaSchema["Prisma Schema"]
        PrismaClient["Prisma Client"]
        Migrations["Database Migrations"]
    end

    subgraph Config
        NextConfig["Next.js Config"]
        EnvConfig["Environment Config"]
        TSConfig["TypeScript Config"]
        TailwindConfig["Tailwind Config"]
    end

    %% Relationships
    Navbar --> RootPage
    ListIssues --> IssueAPI
    FormIssue --> ServerActions
    EditIssueDialog --> ServerActions
    DeleteButton --> IssueIDAPI
    
    IssueAPI --> PrismaClient
    IssueIDAPI --> PrismaClient
    ServerActions --> PrismaClient
    
    PrismaClient --> PrismaSchema
    PrismaSchema --> Migrations

    %% Click events
    click Navbar "https://github.com/caturhidayat/issue-tracker/blob/main/app/components/Navbar.tsx"
    click ListIssues "https://github.com/caturhidayat/issue-tracker/blob/main/app/components/ListIssues.tsx"
    click FormIssue "https://github.com/caturhidayat/issue-tracker/blob/main/app/components/FormIssue.tsx"
    click EditIssueDialog "https://github.com/caturhidayat/issue-tracker/blob/main/app/components/EditIssueDialog.tsx"
    click DeleteButton "https://github.com/caturhidayat/issue-tracker/blob/main/app/components/DeleteButton.tsx"
    click RootPage "https://github.com/caturhidayat/issue-tracker/blob/main/app/page.tsx"
    click IssuePage "https://github.com/caturhidayat/issue-tracker/blob/main/app/issue/page.tsx"
    click RootLayout "https://github.com/caturhidayat/issue-tracker/blob/main/app/layout.tsx"
    click LoadingState "https://github.com/caturhidayat/issue-tracker/blob/main/app/loading.tsx"
    click IssueAPI "https://github.com/caturhidayat/issue-tracker/blob/main/app/api/issue/route.ts"
    click IssueIDAPI "https://github.com/caturhidayat/issue-tracker/blob/main/app/api/issue/[issueId]/route.ts"
    click ServerActions "https://github.com/caturhidayat/issue-tracker/blob/main/app/actions/issue/action.ts"
    click PrismaSchema "https://github.com/caturhidayat/issue-tracker/blob/main/prisma/schema.prisma"
    click PrismaClient "https://github.com/caturhidayat/issue-tracker/blob/main/prisma/prisma.ts"
    click Migrations "https://github.com/caturhidayat/issue-tracker/tree/main/prisma/migrations"
    click NextConfig "https://github.com/caturhidayat/issue-tracker/blob/main/next.config.js"
    click TSConfig "https://github.com/caturhidayat/issue-tracker/blob/main/tsconfig.json"
    click TailwindConfig "https://github.com/caturhidayat/issue-tracker/blob/main/tailwind.config.ts"

    %% Styling
    classDef client fill:#e1f5fe,stroke:#01579b
    classDef pages fill:#f3e5f5,stroke:#4a148c
    classDef api fill:#e8f5e9,stroke:#1b5e20
    classDef database fill:#fff3e0,stroke:#e65100
    classDef config fill:#fafafa,stroke:#212121

    class Navbar,ListIssues,FormIssue,EditIssueDialog,DeleteButton client
    class RootPage,IssuePage,RootLayout,LoadingState pages
    class IssueAPI,IssueIDAPI,ServerActions api
    class PrismaSchema,PrismaClient,Migrations database
    class NextConfig,EnvConfig,TSConfig,TailwindConfig config
```
