# vamseemohany/jira-confluence-automation architecture

> Architecture diagram of the GitHub repository vamseemohany/jira-confluence-automation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vamseemohany/jira-confluence-automation
- Repository: https://github.com/vamseemohany/jira-confluence-automation

## Overview

This repository is a Jira/Confluence reporting prototype: a user selects a source, period, and report type in the React interface, then requests a run and views its status, history, and Markdown report through the Express API. The server currently stores runs in memory and generates a sample report; the shown code does not connect to Jira or Confluence. Separate Python utilities discover local files, load JSON/CSV/text, and compute values for template rendering. Their integration into the web workflow is not shown.

Main entry points: [`server/src/server.js`](https://github.com/vamseemohany/jira-confluence-automation/blob/main/server/src/server.js) (Run API), [`client/src/App.jsx`](https://github.com/vamseemohany/jira-confluence-automation/blob/main/client/src/App.jsx) (Run dashboard), [`tools/discover_sources.py`](https://github.com/vamseemohany/jira-confluence-automation/blob/main/tools/discover_sources.py) (Source discovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_app["Run dashboard<br/>[App.jsx]"]
end

subgraph group_runs["Report runs"]
  node_api["Run API<br/>[server.js]"]
  node_runstate[("In-memory runs<br/>[server.js]")]
  node_report["Sample report output<br/>[server.js]"]
end

subgraph group_utilities["Local data utilities"]
  node_discover["Source discovery"]
  node_load["Source loading"]
  node_render["Compute and render"]
end

node_user(("Report user"))

node_user -->|"selects and starts"| node_app
node_app -->|"requests runs and reports"| node_api
node_api -->|"stores and reads"| node_runstate
node_api -->|"generates report"| node_report
node_api -->|"returns run data"| node_app
node_discover --> node_user

click node_app "https://github.com/vamseemohany/jira-confluence-automation/blob/main/client/src/App.jsx"
click node_api "https://github.com/vamseemohany/jira-confluence-automation/blob/main/server/src/server.js"
click node_runstate "https://github.com/vamseemohany/jira-confluence-automation/blob/main/server/src/server.js"
click node_report "https://github.com/vamseemohany/jira-confluence-automation/blob/main/server/src/server.js"
click node_discover "https://github.com/vamseemohany/jira-confluence-automation/blob/main/tools/discover_sources.py"
click node_load "https://github.com/vamseemohany/jira-confluence-automation/blob/main/tools/load_source_data.py"
click node_render "https://github.com/vamseemohany/jira-confluence-automation/blob/main/tools/render_computed_report.py"

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_user toneBlue
class node_api,node_runstate,node_report toneAmber
class node_discover,node_load,node_render toneMint
```

## Components

### Web interface

- [Run dashboard](https://github.com/vamseemohany/jira-confluence-automation/blob/main/client/src/App.jsx): `client/src/App.jsx`

### Report runs

- [Run API](https://github.com/vamseemohany/jira-confluence-automation/blob/main/server/src/server.js): `server/src/server.js`
- [In-memory runs](https://github.com/vamseemohany/jira-confluence-automation/blob/main/server/src/server.js): `server/src/server.js`
- [Sample report output](https://github.com/vamseemohany/jira-confluence-automation/blob/main/server/src/server.js): `server/src/server.js`

### Local data utilities

- [Source discovery](https://github.com/vamseemohany/jira-confluence-automation/blob/main/tools/discover_sources.py): `tools/discover_sources.py`
- [Source loading](https://github.com/vamseemohany/jira-confluence-automation/blob/main/tools/load_source_data.py): `tools/load_source_data.py`
- [Compute and render](https://github.com/vamseemohany/jira-confluence-automation/blob/main/tools/render_computed_report.py): `tools/render_computed_report.py`

### Other components

- **Report user**

## Connections

- Report user → Run dashboard: selects and starts (evidence: `client/src/App.jsx`)
- Run dashboard → Run API: requests runs and reports (evidence: `client/src/App.jsx`)
- Run API → In-memory runs: stores and reads (evidence: `server/src/server.js`)
- Run API → Sample report output: generates report (evidence: `server/src/server.js`)
- Run API → Run dashboard: returns run data (evidence: `client/src/App.jsx`)
- Source discovery → Report user
