# ganeshajdivekar/brd-to-jira architecture

> Architecture diagram of the GitHub repository ganeshajdivekar/brd-to-jira, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ganeshajdivekar/brd-to-jira
- Repository: https://github.com/ganeshajdivekar/brd-to-jira

## Overview

##### Project type and purpose
- From the file tree and README, this is a “full-stack AI-powered BRD→JIRA Task Automation” application.
- The provided files are the Next.js 13+ frontend; the README describes a Python/FastAPI backend (OCR, parsing, LLM, task assignment, JIRA sync) which sits behind the UI.

##### File structure
- Top-level folders:
- app/ (Next.js “App Router” pages and layouts)
- components/ (UI widgets & domain components)
- hooks/ (custom React hooks)
- lib/ (utility functions)
- public/, styles/, config files (Tailwind, PostCSS, Next config)
- The absence of a “backend/” folder confirms the repo is purely the frontend.
- The “components.json” suggests dynamic component registration or a design-system manifest.

##### README for additional insights
- Confirms multi-stage pipeline:
- Document ingestion (upload UI)
- OCR/Parsing & AI context extraction (backend services)
- Task generation & assignment (backend)
- JIRA sync (when implemented)
- Tech stack: React/Next.js frontend + Python/FastAPI backend + MongoDB/Postgres + LLMs + OCR engine.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "User Interaction"
        User["User"]:::external
    end

    subgraph "Frontend (Next.js React)" 
        Layout["Main Layout"]:::frontend
        Home["Home Page"]:::frontend
        Upload["Upload Section"]:::frontend
        Chat["AI Chat Popup"]:::frontend
        Extract["Extraction Results"]:::frontend
        JP["JIRA Ticket Preview"]:::frontend
        SPIn["Story Point Estimation"]:::frontend
        SPDist["Story Points Distribution"]:::frontend
        DevAssign["Developer Assignment"]:::frontend
        Loading["Loading Simulation"]:::frontend
        AnimBG["Animated Background"]:::frontend
        Card3D["3D Card"]:::frontend
        Icons["Floating Icons"]:::frontend
        ThemeProv["Theme Provider"]:::frontend
        ThemeToggle["Theme Toggle"]:::frontend
        UIPrims["UI Primitives & Design System"]:::frontend
        HookMobile["use-mobile"]:::frontend
        HookToast["use-toast"]:::frontend
        Utils["Utils Library"]:::frontend
        Globals["Global Stylesheet"]:::frontend
        TailwindConf["Tailwind Config"]:::frontend
        NextConf["Next.js Config"]:::frontend
        README["Project README"]:::frontend
    end

    subgraph "Backend (FastAPI Python)" 
        API["FastAPI Backend (API Gateway)"]:::backend
        OCR["OCR Service"]:::backend
        Parser["Parser Service"]:::backend
        LLM["LLM Service"]:::backend
        TaskGen["Task Generator & Assignment"]:::backend
        JIRASync["JIRA Sync Module"]:::backend
    end

    subgraph "Data Stores & External Services"
        DB["MongoDB/PostgreSQL"]:::external
        S3["Cloud Storage / Email Ingestion"]:::external
        OpenAI["OpenAI / Mistral API"]:::external
        JIRAAPI["JIRA REST API"]:::external
    end

    %% User to Frontend
    User -->|"interacts with"| Layout
    Layout --> Home

    %% Frontend navigation
    Home --> Upload
    Home --> Chat
    Home --> Extract
    Home --> JP
    Home --> SPIn
    Home --> SPDist
    Home --> DevAssign
    Home --> Loading
    Home --> AnimBG
    Home --> Card3D
    Home --> Icons
    Home --> ThemeProv
    ThemeProv --> ThemeToggle
    Home --> UIPrims
    Home --> HookMobile
    Home --> HookToast
    Home --> Utils
    Home --> Globals
    Home --> TailwindConf
    Home --> NextConf
    Home --> README

    %% Frontend to Backend & Storage
    Upload -->|uploads docs to| S3
    Home -->|API calls| API

    %% Backend API orchestrates services
    API --> OCR
    API --> Parser
    API --> LLM
    API --> TaskGen
    API --> JIRASync
    API --> DB
    API --> S3

    %% Services to DB and external
    OCR --> DB
    Parser --> DB
    TaskGen --> DB
    LLM --> OpenAI
    JIRASync --> JIRAAPI

    %% Click Events
    click Layout "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/app/layout.tsx"
    click Home "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/app/page.tsx"
    click Upload "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/components/upload-section.tsx"
    click Chat "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/components/ai-chat-popup.tsx"
    click Extract "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/components/extraction-results.tsx"
    click JP "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/components/jira-ticket-preview.tsx"
    click SPIn "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/components/story-point-estimation.tsx"
    click SPDist "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/components/story-points-distribution.tsx"
    click DevAssign "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/components/developer-assignment.tsx"
    click Loading "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/components/loading-simulation.tsx"
    click AnimBG "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/components/animated-background.tsx"
    click Card3D "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/components/card-3d.tsx"
    click Icons "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/components/floating-icons.tsx"
    click ThemeProv "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/components/theme-provider.tsx"
    click ThemeToggle "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/components/theme-toggle.tsx"
    click UIPrims "https://github.com/ganeshajdivekar/brd-to-jira/tree/master/components/ui/"
    click HookMobile "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/hooks/use-mobile.tsx"
    click HookToast "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/hooks/use-toast.ts"
    click Utils "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/lib/utils.ts"
    click Globals "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/app/globals.css"
    click TailwindConf "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/tailwind.config.ts"
    click NextConf "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/next.config.mjs"
    click README "https://github.com/ganeshajdivekar/brd-to-jira/blob/master/README.md"

    classDef frontend fill:#cce5ff,stroke:#004085,color:#004085
    classDef backend fill:#d4edda,stroke:#155724,color:#155724
    classDef external fill:#fff3cd,stroke:#856404,color:#856404
```
