# pranavrelanto/21jumpstreeteditor architecture

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

- Interactive diagram: https://gitdiagram.com/pranavrelanto/21jumpstreeteditor
- Repository: https://github.com/pranavrelanto/21jumpstreeteditor

## Overview

This backend provides organization-scoped user access and collaborative project file management. A user signs up, verifies email, obtains approval, and logs in to receive a session; authenticated API routes then support organization and project administration, membership, folder navigation, and file operations. FastAPI routes delegate domain work to services, which use SQLAlchemy models through database sessions. The excerpts establish the central route-to-service and authentication flow; unsampled service details are represented as capability nodes without speculative internal links.

Main entry points: [`backend/app/main.py`](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/main.py) (FastAPI app), [`backend/app/utils/auth.py`](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/utils/auth.py) (Session authorization), [`backend/app/models/user.py`](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/models/user.py) (Identity records), [`backend/app/db.py`](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/db.py) (PostgreSQL)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API surface"]
  node_app["FastAPI app<br/>[main.py]"]
  node_user_routes["User routes<br/>[user_routes.py]"]
  node_org_routes["Organization routes<br/>[org_routes.py]"]
  node_project_routes["Project routes<br/>[project_routes.py]"]
  node_folder_routes["Folder routes<br/>[folder_routes.py]"]
  node_file_routes["File routes<br/>[file_routes.py]"]
end

subgraph group_identity["Identity and organizations"]
  node_auth["Session authorization<br/>[auth.py]"]
  node_user_service["Account lifecycle<br/>[user_service.py]"]
  node_user_model["Identity records<br/>[user.py]"]
  node_org_service["Organization management<br/>[org_service.py]"]
end

subgraph group_projects["Project collaboration"]
  node_project_service["Project management<br/>[project_service.py]"]
  node_folder_service["Folder operations<br/>[folder_service.py]"]
  node_file_service["File operations<br/>[file_service.py]"]
  node_project_model["Project records<br/>[project.py]"]
end

subgraph group_persistence["Persistence"]
  node_database[("PostgreSQL<br/>[db.py]")]
end

node_user(("User"))

node_user -->|"sends requests"| node_app
node_app -->|"registers routes"| node_user_routes
node_app -->|"registers routes"| node_org_routes
node_app -->|"registers routes"| node_project_routes
node_app -->|"registers routes"| node_folder_routes
node_app -->|"registers routes"| node_file_routes
node_app -->|"creates tables"| node_database
node_user_routes -->|"calls lifecycle"| node_user_service
node_user_routes -->|"uses guards"| node_auth
node_org_routes -->|"calls management"| node_org_service
node_org_routes -->|"uses guards"| node_auth
node_project_routes -->|"calls operations"| node_project_service
node_project_routes -->|"uses guards"| node_auth
node_folder_routes -->|"calls operations"| node_folder_service
node_folder_routes -->|"uses guards"| node_auth
node_file_routes -->|"calls operations"| node_file_service
node_file_routes -->|"uses guards"| node_auth
node_auth -->|"queries sessions"| node_database
node_auth -->|"loads user"| node_user_model
node_user_service -->|"manages records"| node_user_model
node_org_service -->|"uses identity data"| node_user_model
node_project_service -->|"manages project data"| node_project_model
node_project_service -->|"checks membership"| node_user_model
node_folder_service -->|"uses folder data"| node_project_model
node_file_service -->|"uses file data"| node_project_model
node_database -->|"registers mappings"| node_user_model
node_database -->|"registers mappings"| node_project_model

click node_app "https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/main.py"
click node_user_routes "https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/routes/user_routes.py"
click node_org_routes "https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/routes/org_routes.py"
click node_project_routes "https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/routes/project_routes.py"
click node_folder_routes "https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/routes/folder_routes.py"
click node_file_routes "https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/routes/file_routes.py"
click node_auth "https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/utils/auth.py"
click node_user_service "https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/services/user_service.py"
click node_user_model "https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/models/user.py"
click node_org_service "https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/services/org_service.py"
click node_project_service "https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/services/project_service.py"
click node_folder_service "https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/services/folder_service.py"
click node_file_service "https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/services/file_service.py"
click node_project_model "https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/models/project.py"
click node_database "https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/db.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_app,node_user_routes,node_org_routes,node_project_routes,node_folder_routes,node_file_routes,node_user toneBlue
class node_auth,node_user_service,node_user_model,node_org_service toneAmber
class node_project_service,node_folder_service,node_file_service,node_project_model toneMint
class node_database toneRose
```

## Components

### API surface

- [FastAPI app](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/main.py): `backend/app/main.py`
- [User routes](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/routes/user_routes.py): `backend/app/routes/user_routes.py`
- [Organization routes](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/routes/org_routes.py): `backend/app/routes/org_routes.py`
- [Project routes](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/routes/project_routes.py): `backend/app/routes/project_routes.py`
- [Folder routes](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/routes/folder_routes.py): `backend/app/routes/folder_routes.py`
- [File routes](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/routes/file_routes.py): `backend/app/routes/file_routes.py`

### Identity and organizations

- [Session authorization](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/utils/auth.py): `backend/app/utils/auth.py`
- [Account lifecycle](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/services/user_service.py): `backend/app/services/user_service.py`
- [Identity records](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/models/user.py): `backend/app/models/user.py`
- [Organization management](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/services/org_service.py): `backend/app/services/org_service.py`

### Project collaboration

- [Project management](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/services/project_service.py): `backend/app/services/project_service.py`
- [Folder operations](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/services/folder_service.py): `backend/app/services/folder_service.py`
- [File operations](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/services/file_service.py): `backend/app/services/file_service.py`
- [Project records](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/models/project.py): `backend/app/models/project.py`

### Persistence

- [PostgreSQL](https://github.com/pranavrelanto/21jumpstreeteditor/blob/main/backend/app/db.py): `backend/app/db.py`

### Other components

- **User**

## Connections

- User → FastAPI app: sends requests (evidence: `backend/app/main.py`)
- FastAPI app → User routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Organization routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Project routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → Folder routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → File routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI app → PostgreSQL: creates tables (evidence: `backend/app/main.py`)
- User routes → Account lifecycle: calls lifecycle (evidence: `backend/app/routes/user_routes.py`)
- User routes → Session authorization: uses guards (evidence: `backend/app/routes/user_routes.py`)
- Organization routes → Organization management: calls management (evidence: `backend/app/routes/org_routes.py`)
- Organization routes → Session authorization: uses guards (evidence: `backend/app/routes/org_routes.py`)
- Project routes → Project management: calls operations (evidence: `backend/app/routes/project_routes.py`)
- Project routes → Session authorization: uses guards (evidence: `backend/app/routes/project_routes.py`)
- Folder routes → Folder operations: calls operations (evidence: `backend/app/routes/folder_routes.py`)
- Folder routes → Session authorization: uses guards (evidence: `backend/app/routes/folder_routes.py`)
- File routes → File operations: calls operations (evidence: `backend/app/routes/file_routes.py`)
- File routes → Session authorization: uses guards (evidence: `backend/app/routes/file_routes.py`)
- Session authorization → PostgreSQL: queries sessions (evidence: `backend/app/utils/auth.py`)
- Session authorization → Identity records: loads user (evidence: `backend/app/utils/auth.py`)
- Account lifecycle → Identity records: manages records (evidence: `backend/app/services/user_service.py`)
- Organization management → Identity records: uses identity data (evidence: `backend/app/services/org_service.py`)
- Project management → Project records: manages project data (evidence: `backend/app/services/project_service.py`)
- Project management → Identity records: checks membership (evidence: `backend/app/services/project_service.py`)
- Folder operations → Project records: uses folder data (evidence: `backend/app/services/folder_service.py`)
- File operations → Project records: uses file data (evidence: `backend/app/services/file_service.py`)
- PostgreSQL → Identity records: registers mappings (evidence: `backend/app/db.py`)
- PostgreSQL → Project records: registers mappings (evidence: `backend/app/db.py`)
