# sanuja03/swiftdrop architecture

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

- Interactive diagram: https://gitdiagram.com/sanuja03/swiftdrop
- Repository: https://github.com/sanuja03/swiftdrop

## Overview

SwiftDrop is presented as a parcel-delivery and courier platform, but the checked-in runtime is largely a starter scaffold: the React page is the Vite welcome screen and the backend authentication files are empty or skeletal. The visible user workflow is only browser entrypoint to that page; no parcel-management workflow is implemented in the sampled code. The README documents intended operational modules and PostgreSQL, but does not establish their implementation or connections. The backend-to-database link is documented; other domain relationships are omitted rather than inferred.

Main entry points: [`frontend/src/main.jsx`](https://github.com/sanuja03/swiftdrop/blob/main/frontend/src/main.jsx) (React entrypoint), [`backend/src/main/java/com/swiftdrop/backend/BackendApplication.java`](https://github.com/sanuja03/swiftdrop/blob/main/backend/src/main/java/com/swiftdrop/backend/BackendApplication.java) (Spring Boot app), [`frontend/src/App.jsx`](https://github.com/sanuja03/swiftdrop/blob/main/frontend/src/App.jsx) (Starter page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web client"]
  node_web_entry["React entrypoint<br/>[main.jsx]"]
  node_web_page["Starter page<br/>[App.jsx]"]
end

subgraph group_server["Backend scaffold"]
  node_backend_app["Spring Boot app"]
end

subgraph group_identity["Identity scaffold"]
  node_auth_controller["Auth controller"]
  node_auth_service["Auth service<br/>[AuthService.java]"]
  node_auth_repository["Auth repository"]
  node_auth_entity["Auth entity<br/>[AuthEntity.java]"]
end

node_user(("Browser user"))
node_postgres[("PostgreSQL")]

node_user -->|"opens"| node_web_entry
node_web_entry -->|"renders"| node_web_page
node_backend_app -->|"connects to"| node_postgres

click node_web_entry "https://github.com/sanuja03/swiftdrop/blob/main/frontend/src/main.jsx"
click node_web_page "https://github.com/sanuja03/swiftdrop/blob/main/frontend/src/App.jsx"
click node_backend_app "https://github.com/sanuja03/swiftdrop/blob/main/backend/src/main/java/com/swiftdrop/backend/BackendApplication.java"
click node_auth_controller "https://github.com/sanuja03/swiftdrop/blob/main/backend/src/main/java/com/swiftdrop/backend/modules/auth/controller/AuthController.java"
click node_auth_service "https://github.com/sanuja03/swiftdrop/blob/main/backend/src/main/java/com/swiftdrop/backend/modules/auth/service/AuthService.java"
click node_auth_repository "https://github.com/sanuja03/swiftdrop/blob/main/backend/src/main/java/com/swiftdrop/backend/modules/auth/repository/AuthRepository.java"
click node_auth_entity "https://github.com/sanuja03/swiftdrop/blob/main/backend/src/main/java/com/swiftdrop/backend/modules/auth/entity/AuthEntity.java"

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_web_entry,node_web_page,node_user toneBlue
class node_backend_app,node_postgres toneAmber
class node_auth_controller,node_auth_service,node_auth_repository,node_auth_entity toneMint
```

## Components

### Web client

- [React entrypoint](https://github.com/sanuja03/swiftdrop/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [Starter page](https://github.com/sanuja03/swiftdrop/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`

### Backend scaffold

- [Spring Boot app](https://github.com/sanuja03/swiftdrop/blob/main/backend/src/main/java/com/swiftdrop/backend/BackendApplication.java): `backend/src/main/java/com/swiftdrop/backend/BackendApplication.java`

### Identity scaffold

- [Auth controller](https://github.com/sanuja03/swiftdrop/blob/main/backend/src/main/java/com/swiftdrop/backend/modules/auth/controller/AuthController.java): `backend/src/main/java/com/swiftdrop/backend/modules/auth/controller/AuthController.java`
- [Auth service](https://github.com/sanuja03/swiftdrop/blob/main/backend/src/main/java/com/swiftdrop/backend/modules/auth/service/AuthService.java): `backend/src/main/java/com/swiftdrop/backend/modules/auth/service/AuthService.java`
- [Auth repository](https://github.com/sanuja03/swiftdrop/blob/main/backend/src/main/java/com/swiftdrop/backend/modules/auth/repository/AuthRepository.java): `backend/src/main/java/com/swiftdrop/backend/modules/auth/repository/AuthRepository.java`
- [Auth entity](https://github.com/sanuja03/swiftdrop/blob/main/backend/src/main/java/com/swiftdrop/backend/modules/auth/entity/AuthEntity.java): `backend/src/main/java/com/swiftdrop/backend/modules/auth/entity/AuthEntity.java`

### Other components

- **Browser user**
- **PostgreSQL**

## Connections

- Browser user → React entrypoint: opens (evidence: `frontend/src/main.jsx`)
- React entrypoint → Starter page: renders (evidence: `frontend/src/main.jsx`)
- Spring Boot app → PostgreSQL: connects to (evidence: `README.md`)