# rahil71/reports-analysis architecture

> Architecture diagram of the GitHub repository rahil71/reports-analysis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rahil71/reports-analysis
- Repository: https://github.com/rahil71/reports-analysis

## Overview

Reports Analysis provides multiple React interfaces for uploading reports and requesting summaries, table explanations, and document Q&A; Flask services handle AI-backed analysis, with document retrieval also advertised. The clearest user flow is the client-side-web upload page followed by its action page. The README documents the backend capabilities, but backend implementation excerpts were not provided, so internal backend calls and detailed processing order are not asserted.

Main entry points: [`flask-server/server_gemini.py`](https://github.com/rahil71/reports-analysis/blob/master/flask-server/server_gemini.py) (Gemini API server), [`client-side-web/src/pages/Upload.jsx`](https://github.com/rahil71/reports-analysis/blob/master/client-side-web/src/pages/Upload.jsx) (Report upload), [`client/summarize/src/App.jsx`](https://github.com/rahil71/reports-analysis/blob/master/client/summarize/src/App.jsx) (Summarize client), [`flask-server/server_groq.py`](https://github.com/rahil71/reports-analysis/blob/master/flask-server/server_groq.py) (Groq API server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflow"]
  node_landing["Landing page<br/>[Hero.jsx]"]
  node_upload["Report upload<br/>[Upload.jsx]"]
  node_loader["PDF loader<br/>[PdfLoader.jsx]"]
  node_actions["Analysis actions<br/>[Action.jsx]"]
  node_webrouter["Web routes<br/>[App.jsx]"]
end

subgraph group_alternate["Other clients"]
  node_basicclient["PDF analysis client<br/>[App.jsx]"]
  node_summarizeclient["Summarize client<br/>[App.jsx]"]
  node_gradient["Gradient controls<br/>[GradientButton.jsx]"]
  node_summarizeloader["Summarize loader<br/>[PdfLoader.jsx]"]
end

subgraph group_services["Analysis services"]
  node_geminiservice["Gemini API server<br/>[server_gemini.py]"]
  node_groqservice["Groq API server<br/>[server_groq.py]"]
  node_geminiopenai["Gemini OpenAI<br/>[gemini_openai.py]"]
  node_geminiupdated["Gemini analysis<br/>[gemini_updated.py]"]
  node_grokupdated["Grok analysis<br/>[grok_updated.py]"]
  node_openai["OpenAI processing<br/>[openai_file.py]"]
end

subgraph group_knowledge["Document knowledge"]
  node_markdown["Markdown conversion<br/>[md_to_txt.py]"]
  node_uploads[("Uploaded reports")]
  node_faiss[("FAISS retrieval index")]
  node_docdb[("Document database")]
end

node_user(("Report user"))

node_user -->|"opens"| node_landing
node_landing -->|"navigates to"| node_upload
node_upload -->|"navigates after upload"| node_actions
node_upload -->|"shows while uploading"| node_loader
node_actions -->|"shows while processing"| node_loader
node_upload -->|"POSTs upload"| node_geminiservice
node_actions -->|"POSTs analysis requests"| node_geminiservice
node_user -.->|"uses"| node_basicclient
node_basicclient -.->|"sends requests"| node_geminiservice
node_user -.->|"uses"| node_summarizeclient
node_summarizeclient -.->|"sends requests"| node_geminiservice
node_summarizeclient -->|"renders controls"| node_gradient
node_summarizeclient -->|"renders loader"| node_summarizeloader
node_geminiservice -.->|"uses AI integration"| node_geminiopenai
node_geminiservice -.->|"uses AI integration"| node_geminiupdated
node_groqservice -.->|"uses AI integration"| node_grokupdated
node_groqservice -.->|"uses AI processing"| node_openai
node_geminiservice -.->|"handles report uploads"| node_uploads
node_geminiservice -.->|"converts reports"| node_markdown
node_geminiservice -.->|"supports retrieval"| node_faiss
node_geminiservice -.->|"supports document storage"| node_docdb
node_groqservice -.->|"supports retrieval"| node_faiss

click node_landing "https://github.com/rahil71/reports-analysis/blob/master/client-side-web/src/pages/Hero.jsx"
click node_upload "https://github.com/rahil71/reports-analysis/blob/master/client-side-web/src/pages/Upload.jsx"
click node_loader "https://github.com/rahil71/reports-analysis/blob/master/client-side-web/src/components/PdfLoader.jsx"
click node_actions "https://github.com/rahil71/reports-analysis/blob/master/client-side-web/src/pages/Action.jsx"
click node_webrouter "https://github.com/rahil71/reports-analysis/blob/master/client-side-web/src/App.jsx"
click node_basicclient "https://github.com/rahil71/reports-analysis/blob/master/client/src/App.jsx"
click node_summarizeclient "https://github.com/rahil71/reports-analysis/blob/master/client/summarize/src/App.jsx"
click node_gradient "https://github.com/rahil71/reports-analysis/blob/master/client/summarize/src/components/GradientButton.jsx"
click node_summarizeloader "https://github.com/rahil71/reports-analysis/blob/master/client/summarize/src/components/PdfLoader.jsx"
click node_geminiservice "https://github.com/rahil71/reports-analysis/blob/master/flask-server/server_gemini.py"
click node_groqservice "https://github.com/rahil71/reports-analysis/blob/master/flask-server/server_groq.py"
click node_geminiopenai "https://github.com/rahil71/reports-analysis/blob/master/flask-server/gemini_openai.py"
click node_geminiupdated "https://github.com/rahil71/reports-analysis/blob/master/flask-server/gemini_updated.py"
click node_grokupdated "https://github.com/rahil71/reports-analysis/blob/master/flask-server/grok_updated.py"
click node_openai "https://github.com/rahil71/reports-analysis/blob/master/flask-server/openai_file.py"
click node_markdown "https://github.com/rahil71/reports-analysis/blob/master/flask-server/md_to_txt.py"
click node_uploads "https://github.com/rahil71/reports-analysis/tree/master/flask-server/uploaded_files"
click node_faiss "https://github.com/rahil71/reports-analysis/tree/master/flask-server/faiss_index"
click node_docdb "https://github.com/rahil71/reports-analysis/tree/master/flask-server/rahil_doc_db"

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_landing,node_upload,node_loader,node_actions,node_webrouter,node_user toneBlue
class node_basicclient,node_summarizeclient,node_gradient,node_summarizeloader toneAmber
class node_geminiservice,node_groqservice,node_geminiopenai,node_geminiupdated,node_grokupdated,node_openai toneMint
class node_markdown,node_uploads,node_faiss,node_docdb toneRose
```

## Components

### Web workflow

- [Landing page](https://github.com/rahil71/reports-analysis/blob/master/client-side-web/src/pages/Hero.jsx): `client-side-web/src/pages/Hero.jsx`
- [Report upload](https://github.com/rahil71/reports-analysis/blob/master/client-side-web/src/pages/Upload.jsx): `client-side-web/src/pages/Upload.jsx`
- [PDF loader](https://github.com/rahil71/reports-analysis/blob/master/client-side-web/src/components/PdfLoader.jsx): `client-side-web/src/components/PdfLoader.jsx`
- [Analysis actions](https://github.com/rahil71/reports-analysis/blob/master/client-side-web/src/pages/Action.jsx): `client-side-web/src/pages/Action.jsx`
- [Web routes](https://github.com/rahil71/reports-analysis/blob/master/client-side-web/src/App.jsx): `client-side-web/src/App.jsx`

### Other clients

- [PDF analysis client](https://github.com/rahil71/reports-analysis/blob/master/client/src/App.jsx): `client/src/App.jsx`
- [Summarize client](https://github.com/rahil71/reports-analysis/blob/master/client/summarize/src/App.jsx): `client/summarize/src/App.jsx`
- [Gradient controls](https://github.com/rahil71/reports-analysis/blob/master/client/summarize/src/components/GradientButton.jsx): `client/summarize/src/components/GradientButton.jsx`
- [Summarize loader](https://github.com/rahil71/reports-analysis/blob/master/client/summarize/src/components/PdfLoader.jsx): `client/summarize/src/components/PdfLoader.jsx`

### Analysis services

- [Gemini API server](https://github.com/rahil71/reports-analysis/blob/master/flask-server/server_gemini.py): `flask-server/server_gemini.py`
- [Groq API server](https://github.com/rahil71/reports-analysis/blob/master/flask-server/server_groq.py): `flask-server/server_groq.py`
- [Gemini OpenAI](https://github.com/rahil71/reports-analysis/blob/master/flask-server/gemini_openai.py): `flask-server/gemini_openai.py`
- [Gemini analysis](https://github.com/rahil71/reports-analysis/blob/master/flask-server/gemini_updated.py): `flask-server/gemini_updated.py`
- [Grok analysis](https://github.com/rahil71/reports-analysis/blob/master/flask-server/grok_updated.py): `flask-server/grok_updated.py`
- [OpenAI processing](https://github.com/rahil71/reports-analysis/blob/master/flask-server/openai_file.py): `flask-server/openai_file.py`

### Document knowledge

- [Markdown conversion](https://github.com/rahil71/reports-analysis/blob/master/flask-server/md_to_txt.py): `flask-server/md_to_txt.py`
- [Uploaded reports](https://github.com/rahil71/reports-analysis/tree/master/flask-server/uploaded_files): `flask-server/uploaded_files`
- [FAISS retrieval index](https://github.com/rahil71/reports-analysis/tree/master/flask-server/faiss_index): `flask-server/faiss_index`
- [Document database](https://github.com/rahil71/reports-analysis/tree/master/flask-server/rahil_doc_db): `flask-server/rahil_doc_db`

### Other components

- **Report user**

## Connections

- Report user → Landing page: opens
- Landing page → Report upload: navigates to (evidence: `client-side-web/src/App.jsx`)
- Report upload → Analysis actions: navigates after upload (evidence: `client-side-web/src/pages/Upload.jsx`)
- Report upload → PDF loader: shows while uploading (evidence: `client-side-web/src/pages/Upload.jsx`)
- Analysis actions → PDF loader: shows while processing (evidence: `client-side-web/src/pages/Action.jsx`)
- Report upload → Gemini API server: POSTs upload (evidence: `client-side-web/src/pages/Upload.jsx`)
- Analysis actions → Gemini API server: POSTs analysis requests (evidence: `client-side-web/src/pages/Action.jsx`)
- Report user → PDF analysis client: uses
- PDF analysis client → Gemini API server: sends requests (evidence: `client/src/App.jsx`)
- Report user → Summarize client: uses
- Summarize client → Gemini API server: sends requests (evidence: `client/summarize/src/App.jsx`)
- Summarize client → Gradient controls: renders controls (evidence: `client/summarize/src/App.jsx`)
- Summarize client → Summarize loader: renders loader (evidence: `client/summarize/src/App.jsx`)
- Gemini API server → Gemini OpenAI: uses AI integration
- Gemini API server → Gemini analysis: uses AI integration
- Groq API server → Grok analysis: uses AI integration
- Groq API server → OpenAI processing: uses AI processing
- Gemini API server → Uploaded reports: handles report uploads (evidence: `README.md`)
- Gemini API server → Markdown conversion: converts reports (evidence: `README.md`)
- Gemini API server → FAISS retrieval index: supports retrieval (evidence: `README.md`)
- Gemini API server → Document database: supports document storage (evidence: `README.md`)
- Groq API server → FAISS retrieval index: supports retrieval (evidence: `README.md`)
