# ashmitsherigar/trustnofile architecture

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

- Interactive diagram: https://gitdiagram.com/ashmitsherigar/trustnofile
- Repository: https://github.com/ashmitsherigar/trustnofile

## Overview

TrustNoFile is a web application for safely inspecting untrusted uploads and producing explainable risk reports. Users upload a file, the backend validates and stores it, static-analysis modules collect evidence, and an orchestrator assesses risk and records a report; the UI exposes progress, history, reports, and JSON export. Optional integrations add Gemini review and isolated ELF sandboxing. The graph preserves these documented capabilities, but some unsampled subsystem links are omitted rather than inferred.

Main entry points: [`backend/src/services/analysis-orchestrator.service.js`](https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/services/analysis-orchestrator.service.js) (Analysis workflow), [`frontend/src/services/api.js`](https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/services/api.js) (API client), [`frontend/src/App.jsx`](https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/App.jsx) (Workspace routes), [`backend/src/app.js`](https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/app.js) (API assembly)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User interface"]
  node_appui["Workspace routes<br/>[App.jsx]"]
  node_analyzeui["Upload screen<br/>[Analyze.jsx]"]
  node_progressui["Analysis progress"]
  node_historyui["History<br/>[History.jsx]"]
  node_reportui["Report view<br/>[Report.jsx]"]
  node_overviewui["Overview<br/>[Overview.jsx]"]
  node_apisvc["API client<br/>[api.js]"]
  node_authui["Session auth<br/>[auth.js]"]
end

subgraph group_http["HTTP and workflow"]
  node_filesroute["File routes<br/>[files.routes.js]"]
  node_analysisroute["Analysis routes<br/>[analysis.routes.js]"]
  node_appserver["API assembly<br/>[app.js]"]
  node_upload["Upload and validation<br/>[upload.service.js]"]
  node_analysisctl["Analysis API"]
end

subgraph group_analysis["File analysis"]
  node_orchestrator["Analysis workflow"]
  node_aggregator["Evidence aggregation"]
  node_archive["Archive inspection"]
  node_metadata["Metadata extraction<br/>[metadata.js]"]
  node_risk["Risk assessment"]
  node_report["Report building<br/>[report.service.js]"]
  node_states["Analysis states<br/>[analysis-states.js]"]
end

subgraph group_state["Persistence and integrations"]
  node_repos[("Analysis repositories")]
  node_storage[("File storage adapters")]
  node_llm["LLM integration"]
  node_sandbox["ELF sandbox"]
  node_worker["Sandbox worker<br/>[server.js]"]
end

node_user(("Analyst"))

node_user -->|"uses"| node_appui
node_appui -->|"routes to"| node_analyzeui
node_appui -->|"routes to"| node_progressui
node_appui -->|"routes to"| node_historyui
node_appui -->|"routes to"| node_reportui
node_appui -->|"routes to"| node_overviewui
node_analyzeui -->|"requests"| node_apisvc
node_progressui -->|"requests"| node_apisvc
node_historyui -->|"requests"| node_apisvc
node_reportui -->|"requests"| node_apisvc
node_overviewui -->|"requests"| node_apisvc
node_apisvc -->|"gets token"| node_authui
node_apisvc -->|"uploads and manages"| node_filesroute
node_apisvc -->|"requests reports"| node_analysisroute
node_appserver -->|"mounts"| node_filesroute
node_appserver -->|"mounts"| node_analysisroute
node_filesroute -->|"dispatches upload"| node_upload
node_filesroute -->|"dispatches analysis"| node_analysisctl
node_analysisroute -.->|"routes requests"| node_analysisctl
node_appserver -->|"creates"| node_orchestrator
node_analysisctl -->|"starts job"| node_orchestrator
node_orchestrator -->|"runs static analysis"| node_aggregator
node_aggregator -->|"inspects archives"| node_archive
node_aggregator -->|"extracts metadata"| node_metadata
node_orchestrator -->|"assesses evidence"| node_risk
node_orchestrator -->|"builds report"| node_report
node_orchestrator -->|"transitions status"| node_states
node_appserver -->|"configures"| node_repos
node_upload -.->|"stores upload"| node_storage
node_orchestrator -->|"optional review"| node_llm
node_orchestrator -.->|"optional execution"| node_sandbox
node_worker -->|"runs isolated ELF"| node_sandbox

click node_appui "https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/App.jsx"
click node_analyzeui "https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/pages/Analyze.jsx"
click node_progressui "https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/pages/AnalysisProgress.jsx"
click node_historyui "https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/pages/History.jsx"
click node_reportui "https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/pages/Report.jsx"
click node_overviewui "https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/pages/Overview.jsx"
click node_apisvc "https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/services/api.js"
click node_authui "https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/services/auth.js"
click node_filesroute "https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/routes/files.routes.js"
click node_analysisroute "https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/routes/analysis.routes.js"
click node_appserver "https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/app.js"
click node_upload "https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/services/upload.service.js"
click node_analysisctl "https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/controllers/analysis.controller.js"
click node_orchestrator "https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/services/analysis-orchestrator.service.js"
click node_aggregator "https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/analysis/evidence-aggregator.js"
click node_archive "https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/analysis/archive-inspection.js"
click node_metadata "https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/analysis/metadata.js"
click node_risk "https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/services/risk-assessment.service.js"
click node_report "https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/services/report.service.js"
click node_states "https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/services/analysis-states.js"
click node_repos "https://github.com/ashmitsherigar/trustnofile/tree/main/backend/src/repositories"
click node_storage "https://github.com/ashmitsherigar/trustnofile/tree/main/backend/src/integrations/storage"
click node_llm "https://github.com/ashmitsherigar/trustnofile/tree/main/backend/src/integrations/llm"
click node_sandbox "https://github.com/ashmitsherigar/trustnofile/tree/main/backend/src/integrations/sandbox"
click node_worker "https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/sandbox-worker/server.js"

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_appui,node_analyzeui,node_progressui,node_historyui,node_reportui,node_overviewui,node_apisvc,node_authui toneBlue
class node_filesroute,node_analysisroute,node_appserver,node_upload,node_analysisctl toneAmber
class node_orchestrator,node_aggregator,node_archive,node_metadata,node_risk,node_report,node_states toneMint
class node_repos,node_storage,node_llm,node_sandbox,node_worker toneRose
class node_user toneIndigo
```

## Components

### User interface

- [Workspace routes](https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Upload screen](https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/pages/Analyze.jsx): `frontend/src/pages/Analyze.jsx`
- [Analysis progress](https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/pages/AnalysisProgress.jsx): `frontend/src/pages/AnalysisProgress.jsx`
- [History](https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/pages/History.jsx): `frontend/src/pages/History.jsx`
- [Report view](https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/pages/Report.jsx): `frontend/src/pages/Report.jsx`
- [Overview](https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/pages/Overview.jsx): `frontend/src/pages/Overview.jsx`
- [API client](https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Session auth](https://github.com/ashmitsherigar/trustnofile/blob/main/frontend/src/services/auth.js): `frontend/src/services/auth.js`

### HTTP and workflow

- [File routes](https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/routes/files.routes.js): `backend/src/routes/files.routes.js`
- [Analysis routes](https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/routes/analysis.routes.js): `backend/src/routes/analysis.routes.js`
- [API assembly](https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/app.js): `backend/src/app.js`
- [Upload and validation](https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/services/upload.service.js): `backend/src/services/upload.service.js`
- [Analysis API](https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/controllers/analysis.controller.js): `backend/src/controllers/analysis.controller.js`

### File analysis

- [Analysis workflow](https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/services/analysis-orchestrator.service.js): `backend/src/services/analysis-orchestrator.service.js`
- [Evidence aggregation](https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/analysis/evidence-aggregator.js): `backend/src/analysis/evidence-aggregator.js`
- [Archive inspection](https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/analysis/archive-inspection.js): `backend/src/analysis/archive-inspection.js`
- [Metadata extraction](https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/analysis/metadata.js): `backend/src/analysis/metadata.js`
- [Risk assessment](https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/services/risk-assessment.service.js): `backend/src/services/risk-assessment.service.js`
- [Report building](https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/services/report.service.js): `backend/src/services/report.service.js`
- [Analysis states](https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/services/analysis-states.js): `backend/src/services/analysis-states.js`

### Persistence and integrations

- [Analysis repositories](https://github.com/ashmitsherigar/trustnofile/tree/main/backend/src/repositories): `backend/src/repositories`
- [File storage adapters](https://github.com/ashmitsherigar/trustnofile/tree/main/backend/src/integrations/storage): `backend/src/integrations/storage`
- [LLM integration](https://github.com/ashmitsherigar/trustnofile/tree/main/backend/src/integrations/llm): `backend/src/integrations/llm`
- [ELF sandbox](https://github.com/ashmitsherigar/trustnofile/tree/main/backend/src/integrations/sandbox): `backend/src/integrations/sandbox`
- [Sandbox worker](https://github.com/ashmitsherigar/trustnofile/blob/main/backend/src/sandbox-worker/server.js): `backend/src/sandbox-worker/server.js`

### Other components

- **Analyst**

## Connections

- Analyst → Workspace routes: uses (evidence: `frontend/src/App.jsx`)
- Workspace routes → Upload screen: routes to (evidence: `frontend/src/App.jsx`)
- Workspace routes → Analysis progress: routes to (evidence: `frontend/src/App.jsx`)
- Workspace routes → History: routes to (evidence: `frontend/src/App.jsx`)
- Workspace routes → Report view: routes to (evidence: `frontend/src/App.jsx`)
- Workspace routes → Overview: routes to (evidence: `frontend/src/App.jsx`)
- Upload screen → API client: requests (evidence: `frontend/src/services/api.js`)
- Analysis progress → API client: requests (evidence: `frontend/src/pages/AnalysisProgress.jsx`)
- History → API client: requests (evidence: `frontend/src/pages/History.jsx`)
- Report view → API client: requests (evidence: `frontend/src/pages/Report.jsx`)
- Overview → API client: requests (evidence: `frontend/src/pages/Overview.jsx`)
- API client → Session auth: gets token (evidence: `frontend/src/services/api.js`)
- API client → File routes: uploads and manages (evidence: `frontend/src/services/api.js`)
- API client → Analysis routes: requests reports (evidence: `frontend/src/services/api.js`)
- API assembly → File routes: mounts (evidence: `backend/src/app.js`)
- API assembly → Analysis routes: mounts (evidence: `backend/src/app.js`)
- File routes → Upload and validation: dispatches upload (evidence: `backend/src/routes/files.routes.js`)
- File routes → Analysis API: dispatches analysis (evidence: `backend/src/routes/files.routes.js`)
- Analysis routes → Analysis API: routes requests
- API assembly → Analysis workflow: creates (evidence: `backend/src/app.js`)
- Analysis API → Analysis workflow: starts job (evidence: `backend/src/controllers/analysis.controller.js`)
- Analysis workflow → Evidence aggregation: runs static analysis (evidence: `backend/src/services/analysis-orchestrator.service.js`)
- Evidence aggregation → Archive inspection: inspects archives (evidence: `backend/src/analysis/evidence-aggregator.js`)
- Evidence aggregation → Metadata extraction: extracts metadata (evidence: `backend/src/analysis/evidence-aggregator.js`)
- Analysis workflow → Risk assessment: assesses evidence (evidence: `backend/src/services/analysis-orchestrator.service.js`)
- Analysis workflow → Report building: builds report (evidence: `backend/src/services/analysis-orchestrator.service.js`)
- Analysis workflow → Analysis states: transitions status (evidence: `backend/src/services/analysis-orchestrator.service.js`)
- API assembly → Analysis repositories: configures (evidence: `backend/src/app.js`)
- Upload and validation → File storage adapters: stores upload
- Analysis workflow → LLM integration: optional review (evidence: `backend/src/services/analysis-orchestrator.service.js`)
- Analysis workflow → ELF sandbox: optional execution
- Sandbox worker → ELF sandbox: runs isolated ELF (evidence: `backend/src/sandbox-worker/server.js`)
