# bmf-projet/pdfruche architecture

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

- Interactive diagram: https://gitdiagram.com/bmf-projet/pdfruche
- Repository: https://github.com/bmf-projet/pdfruche

## Overview

PDFRuche is a privacy-focused, browser-based PDF workspace: users discover a tool, provide documents, process them locally, and download results. Its catalog spans editing, conversion, organization, optimization, and security; a separate beta workflow editor models multi-step processing. The graph distinguishes catalog and tool UI from the sampled PDF-processing layer. README statements support the broad client-side product flow; source excerpts and the SOURCE INDEX support specific module relationships, while many individual tool implementations were not inspected.

Main entry points: [`src/app/[locale]/tools/ToolsPageClient.tsx`](https://github.com/bmf-projet/pdfruche/blob/main/src/app/%5Blocale%5D/tools/ToolsPageClient.tsx) (Tool Catalog), [`src/components/tools/ocg-manager/OCGManagerTool.tsx`](https://github.com/bmf-projet/pdfruche/blob/main/src/components/tools/ocg-manager/OCGManagerTool.tsx) (Tool Interface), [`src/lib/pdf/processors/ocg-manager.ts`](https://github.com/bmf-projet/pdfruche/blob/main/src/lib/pdf/processors/ocg-manager.ts) (PDF Processor), [`src/app/[locale]/layout.tsx`](https://github.com/bmf-projet/pdfruche/blob/main/src/app/%5Blocale%5D/layout.tsx) (Localized App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery and Navigation"]
  node_localized_app["Localized App<br/>[layout.tsx]"]
  node_home["Home Page<br/>[HomePageClient.tsx]"]
  node_tool_catalog["Tool Catalog"]
  node_tool_config["Tool Definitions<br/>[tools.ts]"]
  node_search["Tool Search<br/>[search.ts]"]
end

subgraph group_tools["PDF Tool Experience"]
  node_tool_grid["Tool Grid<br/>[ToolGrid.tsx]"]
  node_tool_card["Tool Card<br/>[ToolCard.tsx]"]
  node_tool_ui["Tool Interface<br/>[OCGManagerTool.tsx]"]
  node_uploader["File Uploader<br/>[FileUploader.tsx]"]
  node_preview["File Preview<br/>[FilePreview.tsx]"]
  node_download["Download Results<br/>[DownloadButton.tsx]"]
end

subgraph group_processing["PDF Processing"]
  node_processor["PDF Processor<br/>[ocg-manager.ts]"]
  node_pdf_engine["PDF Engine<br/>[processor.ts]"]
  node_pymupdf["PyMuPDF Loader<br/>[pymupdf-loader.ts]"]
  node_pdfjs["PDF.js Viewer<br/>[pdf.mjs]"]
end

subgraph group_workflow["Workflow Editor"]
  node_workflow_page["Workflow Page"]
  node_workflow_preview["Workflow Preview"]
  node_workflow_engine["Workflow Engine<br/>[engine.ts]"]
  node_workflow_storage[("Workflow Storage<br/>[storage.ts]")]
end

node_user(("User"))

node_user -->|"opens"| node_localized_app
node_localized_app -.->|"routes to"| node_home
node_home -->|"finds tools"| node_tool_catalog
node_tool_catalog -->|"loads definitions"| node_tool_config
node_tool_catalog -->|"searches with"| node_search
node_tool_catalog -->|"renders"| node_tool_grid
node_tool_grid -->|"renders"| node_tool_card
node_user -->|"selects operation"| node_tool_ui
node_tool_ui -->|"uses"| node_uploader
node_tool_ui -->|"invokes"| node_processor
node_processor -->|"extends"| node_pdf_engine
node_processor -->|"loads"| node_pymupdf
node_user -->|"reviews output"| node_preview
node_preview -->|"renders with"| node_pdfjs
node_user -->|"downloads result"| node_download
node_user -->|"opens editor"| node_workflow_page
node_workflow_preview -->|"executes through"| node_workflow_engine
node_workflow_engine -.->|"persists via"| node_workflow_storage

click node_localized_app "https://github.com/bmf-projet/pdfruche/blob/main/src/app/%5Blocale%5D/layout.tsx"
click node_home "https://github.com/bmf-projet/pdfruche/blob/main/src/app/%5Blocale%5D/HomePageClient.tsx"
click node_tool_catalog "https://github.com/bmf-projet/pdfruche/blob/main/src/app/%5Blocale%5D/tools/ToolsPageClient.tsx"
click node_tool_config "https://github.com/bmf-projet/pdfruche/blob/main/src/config/tools.ts"
click node_search "https://github.com/bmf-projet/pdfruche/blob/main/src/lib/utils/search.ts"
click node_tool_grid "https://github.com/bmf-projet/pdfruche/blob/main/src/components/tools/ToolGrid.tsx"
click node_tool_card "https://github.com/bmf-projet/pdfruche/blob/main/src/components/tools/ToolCard.tsx"
click node_tool_ui "https://github.com/bmf-projet/pdfruche/blob/main/src/components/tools/ocg-manager/OCGManagerTool.tsx"
click node_uploader "https://github.com/bmf-projet/pdfruche/blob/main/src/components/tools/FileUploader.tsx"
click node_preview "https://github.com/bmf-projet/pdfruche/blob/main/src/components/tools/FilePreview.tsx"
click node_download "https://github.com/bmf-projet/pdfruche/blob/main/src/components/tools/DownloadButton.tsx"
click node_processor "https://github.com/bmf-projet/pdfruche/blob/main/src/lib/pdf/processors/ocg-manager.ts"
click node_pdf_engine "https://github.com/bmf-projet/pdfruche/blob/main/src/lib/pdf/processor.ts"
click node_pymupdf "https://github.com/bmf-projet/pdfruche/blob/main/src/lib/pdf/pymupdf-loader.ts"
click node_pdfjs "https://github.com/bmf-projet/pdfruche/blob/main/public/pdfjs-viewer/pdf.mjs"
click node_workflow_page "https://github.com/bmf-projet/pdfruche/blob/main/src/app/%5Blocale%5D/workflow/WorkflowPageClient.tsx"
click node_workflow_preview "https://github.com/bmf-projet/pdfruche/blob/main/src/components/workflow/WorkflowPreview.tsx"
click node_workflow_engine "https://github.com/bmf-projet/pdfruche/blob/main/src/lib/workflow/engine.ts"
click node_workflow_storage "https://github.com/bmf-projet/pdfruche/blob/main/src/lib/workflow/storage.ts"

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_localized_app,node_home,node_tool_catalog,node_tool_config,node_search,node_user toneBlue
class node_tool_grid,node_tool_card,node_tool_ui,node_uploader,node_preview,node_download toneAmber
class node_processor,node_pdf_engine,node_pymupdf,node_pdfjs toneMint
class node_workflow_page,node_workflow_preview,node_workflow_engine,node_workflow_storage toneRose
```

## Components

### Discovery and Navigation

- [Localized App](https://github.com/bmf-projet/pdfruche/blob/main/src/app/%5Blocale%5D/layout.tsx): `src/app/[locale]/layout.tsx`
- [Home Page](https://github.com/bmf-projet/pdfruche/blob/main/src/app/%5Blocale%5D/HomePageClient.tsx): `src/app/[locale]/HomePageClient.tsx`
- [Tool Catalog](https://github.com/bmf-projet/pdfruche/blob/main/src/app/%5Blocale%5D/tools/ToolsPageClient.tsx): `src/app/[locale]/tools/ToolsPageClient.tsx`
- [Tool Definitions](https://github.com/bmf-projet/pdfruche/blob/main/src/config/tools.ts): `src/config/tools.ts`
- [Tool Search](https://github.com/bmf-projet/pdfruche/blob/main/src/lib/utils/search.ts): `src/lib/utils/search.ts`

### PDF Tool Experience

- [Tool Grid](https://github.com/bmf-projet/pdfruche/blob/main/src/components/tools/ToolGrid.tsx): `src/components/tools/ToolGrid.tsx`
- [Tool Card](https://github.com/bmf-projet/pdfruche/blob/main/src/components/tools/ToolCard.tsx): `src/components/tools/ToolCard.tsx`
- [Tool Interface](https://github.com/bmf-projet/pdfruche/blob/main/src/components/tools/ocg-manager/OCGManagerTool.tsx): `src/components/tools/ocg-manager/OCGManagerTool.tsx`
- [File Uploader](https://github.com/bmf-projet/pdfruche/blob/main/src/components/tools/FileUploader.tsx): `src/components/tools/FileUploader.tsx`
- [File Preview](https://github.com/bmf-projet/pdfruche/blob/main/src/components/tools/FilePreview.tsx): `src/components/tools/FilePreview.tsx`
- [Download Results](https://github.com/bmf-projet/pdfruche/blob/main/src/components/tools/DownloadButton.tsx): `src/components/tools/DownloadButton.tsx`

### PDF Processing

- [PDF Processor](https://github.com/bmf-projet/pdfruche/blob/main/src/lib/pdf/processors/ocg-manager.ts): `src/lib/pdf/processors/ocg-manager.ts`
- [PDF Engine](https://github.com/bmf-projet/pdfruche/blob/main/src/lib/pdf/processor.ts): `src/lib/pdf/processor.ts`
- [PyMuPDF Loader](https://github.com/bmf-projet/pdfruche/blob/main/src/lib/pdf/pymupdf-loader.ts): `src/lib/pdf/pymupdf-loader.ts`
- [PDF.js Viewer](https://github.com/bmf-projet/pdfruche/blob/main/public/pdfjs-viewer/pdf.mjs): `public/pdfjs-viewer/pdf.mjs`

### Workflow Editor

- [Workflow Page](https://github.com/bmf-projet/pdfruche/blob/main/src/app/%5Blocale%5D/workflow/WorkflowPageClient.tsx): `src/app/[locale]/workflow/WorkflowPageClient.tsx`
- [Workflow Preview](https://github.com/bmf-projet/pdfruche/blob/main/src/components/workflow/WorkflowPreview.tsx): `src/components/workflow/WorkflowPreview.tsx`
- [Workflow Engine](https://github.com/bmf-projet/pdfruche/blob/main/src/lib/workflow/engine.ts): `src/lib/workflow/engine.ts`
- [Workflow Storage](https://github.com/bmf-projet/pdfruche/blob/main/src/lib/workflow/storage.ts): `src/lib/workflow/storage.ts`

### Other components

- **User**

## Connections

- User → Localized App: opens (evidence: `README.md`)
- Localized App → Home Page: routes to
- Home Page → Tool Catalog: finds tools (evidence: `README.md`)
- Tool Catalog → Tool Definitions: loads definitions (evidence: `src/app/[locale]/tools/ToolsPageClient.tsx`)
- Tool Catalog → Tool Search: searches with (evidence: `src/app/[locale]/tools/ToolsPageClient.tsx`)
- Tool Catalog → Tool Grid: renders (evidence: `src/app/[locale]/tools/ToolsPageClient.tsx`)
- Tool Grid → Tool Card: renders (evidence: `src/components/tools/ToolGrid.tsx`)
- User → Tool Interface: selects operation (evidence: `README.md`)
- Tool Interface → File Uploader: uses (evidence: `src/components/tools/ocg-manager/OCGManagerTool.tsx`)
- Tool Interface → PDF Processor: invokes (evidence: `src/components/tools/ocg-manager/OCGManagerTool.tsx`)
- PDF Processor → PDF Engine: extends (evidence: `src/lib/pdf/processors/ocg-manager.ts`)
- PDF Processor → PyMuPDF Loader: loads (evidence: `src/lib/pdf/processors/ocg-manager.ts`)
- User → File Preview: reviews output (evidence: `README.md`)
- File Preview → PDF.js Viewer: renders with (evidence: `src/components/tools/FilePreview.tsx`)
- User → Download Results: downloads result (evidence: `README.md`)
- User → Workflow Page: opens editor (evidence: `README.md`)
- Workflow Preview → Workflow Engine: executes through (evidence: `src/components/workflow/WorkflowPreview.tsx`)
- Workflow Engine → Workflow Storage: persists via
