# syedfaizan7058/smartasspdf architecture

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

- Interactive diagram: https://gitdiagram.com/syedfaizan7058/smartasspdf
- Repository: https://github.com/syedfaizan7058/smartasspdf

## Overview

SmartAssPDF is a browser-based document and image processing suite backed by a Spring API. Users select a tool, submit files and options, and receive a downloadable result; the backend stores each request as a temporary job and dispatches it to the processing service. The README documents scanning, conversions, PDF editing, protection, OCR, repair, comparison, sanitization, and signing. The sampled Java and Python excerpts support the backend wiring; frontend source and some processing paths were not sampled, so uncertain internal links are omitted. The README mentions a browser AI agent, but its source path is absent from the tree.

Main entry points: [`backend/src/main/java/com/smartasspdf/api/ToolController.java`](https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/ToolController.java) (Tool controller), [`backend/src/main/java/com/smartasspdf/api/PdfProcessingService.java`](https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/PdfProcessingService.java) (PDF processing), [`frontend/assets/js/tool.js`](https://github.com/syedfaizan7058/smartasspdf/blob/main/frontend/assets/js/tool.js) (Tool interface), [`backend/src/main/java/com/smartasspdf/api/JobStore.java`](https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/JobStore.java) (Job store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_site["Tool pages"]
  node_browser["Tool interface<br/>[tool.js]"]
  node_scanner["Scan capture<br/>[scanner.js]"]
  node_catalog["Tool configuration<br/>[tools-config.js]"]
end

subgraph group_api["Job API"]
  node_api["Tool controller"]
end

subgraph group_processing["Document processing"]
  node_processor["PDF processing"]
  node_bridge["Python converter<br/>[converter.py]"]
  node_pdfops["PDF operations"]
  node_conversions["Format conversions"]
  node_imageops["Image processing"]
  node_ocr["OCR and repair<br/>[converter.py]"]
  node_integrity["Compare and secure<br/>[converter.py]"]
end

subgraph group_lifecycle["Temporary job lifecycle"]
  node_jobs[("Job store<br/>[JobStore.java]")]
  node_cleanup["File cleanup"]
  node_result["Processed files"]
end

node_user(("User"))

node_user -->|"selects tool"| node_site
node_site -->|"opens tool"| node_browser
node_browser -->|"submits files"| node_api
node_scanner -->|"provides captures"| node_browser
node_catalog -->|"configures tools"| node_browser
node_api -->|"creates job"| node_jobs
node_api -->|"dispatches processing"| node_processor
node_processor -->|"handles PDF tasks"| node_pdfops
node_processor -->|"handles conversions"| node_conversions
node_processor -->|"handles images"| node_imageops
node_processor -.->|"invokes converter"| node_bridge
node_bridge -->|"performs OCR and repair"| node_ocr
node_bridge -->|"performs integrity tasks"| node_integrity
node_api -->|"records status"| node_jobs
node_api -->|"marks result ready"| node_result
node_api -->|"looks up download"| node_jobs
node_api -->|"serves download"| node_result
node_browser -->|"requests download"| node_api
node_cleanup -->|"expires jobs"| node_jobs

click node_site "https://github.com/syedfaizan7058/smartasspdf/tree/main/frontend/tools"
click node_browser "https://github.com/syedfaizan7058/smartasspdf/blob/main/frontend/assets/js/tool.js"
click node_scanner "https://github.com/syedfaizan7058/smartasspdf/blob/main/frontend/assets/js/scanner.js"
click node_catalog "https://github.com/syedfaizan7058/smartasspdf/blob/main/frontend/assets/js/tools-config.js"
click node_api "https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/ToolController.java"
click node_jobs "https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/JobStore.java"
click node_processor "https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/PdfProcessingService.java"
click node_bridge "https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/scripts/converter.py"
click node_cleanup "https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/FileCleanupService.java"
click node_pdfops "https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/PdfProcessingService.java"
click node_conversions "https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/PdfProcessingService.java"
click node_imageops "https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/PdfProcessingService.java"
click node_ocr "https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/scripts/converter.py"
click node_integrity "https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/scripts/converter.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_site,node_browser,node_scanner,node_catalog,node_user toneBlue
class node_api toneAmber
class node_processor,node_bridge,node_pdfops,node_conversions,node_imageops,node_ocr,node_integrity toneMint
class node_jobs,node_cleanup,node_result toneRose
```

## Components

### Web experience

- [Tool pages](https://github.com/syedfaizan7058/smartasspdf/tree/main/frontend/tools): `frontend/tools`
- [Tool interface](https://github.com/syedfaizan7058/smartasspdf/blob/main/frontend/assets/js/tool.js): `frontend/assets/js/tool.js`
- [Scan capture](https://github.com/syedfaizan7058/smartasspdf/blob/main/frontend/assets/js/scanner.js): `frontend/assets/js/scanner.js`
- [Tool configuration](https://github.com/syedfaizan7058/smartasspdf/blob/main/frontend/assets/js/tools-config.js): `frontend/assets/js/tools-config.js`

### Job API

- [Tool controller](https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/ToolController.java): `backend/src/main/java/com/smartasspdf/api/ToolController.java`

### Document processing

- [PDF processing](https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/PdfProcessingService.java): `backend/src/main/java/com/smartasspdf/api/PdfProcessingService.java`
- [Python converter](https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/scripts/converter.py): `backend/scripts/converter.py`
- [PDF operations](https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/PdfProcessingService.java): `backend/src/main/java/com/smartasspdf/api/PdfProcessingService.java`
- [Format conversions](https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/PdfProcessingService.java): `backend/src/main/java/com/smartasspdf/api/PdfProcessingService.java`
- [Image processing](https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/PdfProcessingService.java): `backend/src/main/java/com/smartasspdf/api/PdfProcessingService.java`
- [OCR and repair](https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/scripts/converter.py): `backend/scripts/converter.py`
- [Compare and secure](https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/scripts/converter.py): `backend/scripts/converter.py`

### Temporary job lifecycle

- [Job store](https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/JobStore.java): `backend/src/main/java/com/smartasspdf/api/JobStore.java`
- [File cleanup](https://github.com/syedfaizan7058/smartasspdf/blob/main/backend/src/main/java/com/smartasspdf/api/FileCleanupService.java): `backend/src/main/java/com/smartasspdf/api/FileCleanupService.java`
- **Processed files**

### Other components

- **User**

## Connections

- User → Tool pages: selects tool
- Tool pages → Tool interface: opens tool
- Tool interface → Tool controller: submits files
- Scan capture → Tool interface: provides captures
- Tool configuration → Tool interface: configures tools
- Tool controller → Job store: creates job
- Tool controller → PDF processing: dispatches processing
- PDF processing → PDF operations: handles PDF tasks
- PDF processing → Format conversions: handles conversions
- PDF processing → Image processing: handles images
- PDF processing → Python converter: invokes converter
- Python converter → OCR and repair: performs OCR and repair
- Python converter → Compare and secure: performs integrity tasks
- Tool controller → Job store: records status
- Tool controller → Processed files: marks result ready
- Tool controller → Job store: looks up download
- Tool controller → Processed files: serves download
- Tool interface → Tool controller: requests download
- File cleanup → Job store: expires jobs