# lordqba/secure-upload architecture

> Architecture diagram of the GitHub repository lordqba/secure-upload, 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/lordqba/secure-upload
- Repository: https://github.com/lordqba/secure-upload

## Overview

Secure Upload is a backend API demonstrating file uploads in deliberately vulnerable and hardened forms. A client reaches the server, which mounts both API variants and identifies the request’s user; each variant handles upload, listing, and download requests, using MySQL metadata and local file storage. The README also describes a browser frontend, but the sampled App.tsx is an unmodified Vite/React starter rather than an upload interface, so it is not shown as part of the upload workflow. Edges reflect sampled calls or README statements; filesystem and database services are external.

Main entry points: [`backend/src/app.ts`](https://github.com/lordqba/secure-upload/blob/main/backend/src/app.ts) (API application), [`backend/src/routes/secure.ts`](https://github.com/lordqba/secure-upload/blob/main/backend/src/routes/secure.ts) (Secure routes), [`backend/src/routes/vulnerable.ts`](https://github.com/lordqba/secure-upload/blob/main/backend/src/routes/vulnerable.ts) (Vulnerable routes), [`backend/src/server.ts`](https://github.com/lordqba/secure-upload/blob/main/backend/src/server.ts) (HTTP listener)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["API runtime"]
  node_server["HTTP listener<br/>[server.ts]"]
  node_app["API application<br/>[app.ts]"]
  node_identity["User middleware<br/>[user.ts]"]
end

subgraph group_variants["Upload variants"]
  node_secure["Secure routes<br/>[secure.ts]"]
  node_vulnerable["Vulnerable routes<br/>[vulnerable.ts]"]
end

subgraph group_persistence["Persistence"]
  node_mysql[("MySQL database")]
  node_schema["Files schema<br/>[schema.sql]"]
  node_disk[("Upload filesystem")]
end

node_client(("API client"))

node_client -->|"sends requests"| node_server
node_server -->|"starts"| node_app
node_app -->|"applies"| node_identity
node_app -->|"mounts secure"| node_secure
node_app -->|"mounts vulnerable"| node_vulnerable
node_app -->|"checks health"| node_mysql
node_secure -->|"queries metadata"| node_mysql
node_secure -->|"writes and downloads"| node_disk
node_vulnerable -->|"queries metadata"| node_mysql
node_vulnerable -->|"stores and downloads"| node_disk
node_schema -->|"defines tables"| node_mysql

click node_server "https://github.com/lordqba/secure-upload/blob/main/backend/src/server.ts"
click node_app "https://github.com/lordqba/secure-upload/blob/main/backend/src/app.ts"
click node_identity "https://github.com/lordqba/secure-upload/blob/main/backend/src/user.ts"
click node_secure "https://github.com/lordqba/secure-upload/blob/main/backend/src/routes/secure.ts"
click node_vulnerable "https://github.com/lordqba/secure-upload/blob/main/backend/src/routes/vulnerable.ts"
click node_schema "https://github.com/lordqba/secure-upload/blob/main/schema.sql"

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_server,node_app,node_identity,node_client toneBlue
class node_secure,node_vulnerable toneAmber
class node_mysql,node_schema,node_disk toneMint
```

## Components

### API runtime

- [HTTP listener](https://github.com/lordqba/secure-upload/blob/main/backend/src/server.ts): `backend/src/server.ts`
- [API application](https://github.com/lordqba/secure-upload/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [User middleware](https://github.com/lordqba/secure-upload/blob/main/backend/src/user.ts): `backend/src/user.ts`

### Upload variants

- [Secure routes](https://github.com/lordqba/secure-upload/blob/main/backend/src/routes/secure.ts): `backend/src/routes/secure.ts`
- [Vulnerable routes](https://github.com/lordqba/secure-upload/blob/main/backend/src/routes/vulnerable.ts): `backend/src/routes/vulnerable.ts`

### Persistence

- **MySQL database**
- [Files schema](https://github.com/lordqba/secure-upload/blob/main/schema.sql): `schema.sql`
- **Upload filesystem**

### Other components

- **API client**

## Connections

- API client → HTTP listener: sends requests (evidence: `README.md`)
- HTTP listener → API application: starts (evidence: `backend/src/server.ts`)
- API application → User middleware: applies (evidence: `backend/src/app.ts`)
- API application → Secure routes: mounts secure (evidence: `backend/src/app.ts`)
- API application → Vulnerable routes: mounts vulnerable (evidence: `backend/src/app.ts`)
- API application → MySQL database: checks health (evidence: `backend/src/app.ts`)
- Secure routes → MySQL database: queries metadata (evidence: `backend/src/routes/secure.ts`)
- Secure routes → Upload filesystem: writes and downloads (evidence: `backend/src/routes/secure.ts`)
- Vulnerable routes → MySQL database: queries metadata (evidence: `backend/src/routes/vulnerable.ts`)
- Vulnerable routes → Upload filesystem: stores and downloads (evidence: `backend/src/routes/vulnerable.ts`)
- Files schema → MySQL database: defines tables (evidence: `README.md`)
