# datarishavrathore/fastapi_mongodb architecture

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

- Interactive diagram: https://gitdiagram.com/datarishavrathore/fastapi_mongodb
- Repository: https://github.com/datarishavrathore/fastapi_mongodb

## Overview

This is a FastAPI tour-and-travel API. Its main workflow is registering or logging in, issuing a JWT, then using authenticated endpoints to list users or create and browse destinations. The application also initializes MongoDB at startup, with settings supplying the connection parameters and MongoEngine models representing users and destinations. The graph preserves the distinct API, authentication, domain, and persistence layers. Source excerpts show route-to-model operations; database behavior beyond the connection call follows the visible MongoEngine usage, so no separate database-operation edges are asserted.

Main entry points: [`main.py`](https://github.com/datarishavrathore/fastapi_mongodb/blob/main/main.py) (FastAPI app), [`routes/destination.py`](https://github.com/datarishavrathore/fastapi_mongodb/blob/main/routes/destination.py) (Destination endpoints), [`routes/auth.py`](https://github.com/datarishavrathore/fastapi_mongodb/blob/main/routes/auth.py) (Auth endpoints), [`models/user.py`](https://github.com/datarishavrathore/fastapi_mongodb/blob/main/models/user.py) (User model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API"]
  node_app["FastAPI app<br/>[main.py]"]
  node_auth_routes["Auth endpoints<br/>[auth.py]"]
  node_user_routes["User listing<br/>[get_users.py]"]
  node_destination_routes["Destination endpoints<br/>[destination.py]"]
end

subgraph group_auth["Authentication"]
  node_security["Token security<br/>[security.py]"]
  node_auth_dependency["JWT authentication<br/>[auth.py]"]
end

subgraph group_domain["Domain"]
  node_user_schemas["User schemas<br/>[user.py]"]
  node_destination_schemas["Destination schemas<br/>[destination.py]"]
  node_user_model["User model<br/>[user.py]"]
  node_destination_model["Destination model<br/>[destination.py]"]
end

subgraph group_persistence["Persistence"]
  node_db_connection["MongoDB connection<br/>[connection.py]"]
  node_settings["Database settings<br/>[settings.py]"]
  node_mongodb[("MongoDB")]
end

node_client(("API client"))

node_client -.->|"sends requests"| node_app
node_app -->|"connects at startup"| node_db_connection
node_app -->|"registers routes"| node_auth_routes
node_app -->|"registers routes"| node_user_routes
node_app -->|"registers routes"| node_destination_routes
node_db_connection -->|"reads settings"| node_settings
node_auth_routes -->|"validates input"| node_user_schemas
node_auth_routes -->|"hashes and signs"| node_security
node_auth_routes -->|"queries and saves"| node_user_model
node_auth_dependency -->|"loads user"| node_user_model
node_user_routes -->|"requires identity"| node_auth_dependency
node_user_routes -->|"lists users"| node_user_model
node_destination_routes -->|"validates and shapes"| node_destination_schemas
node_destination_routes -->|"requires identity"| node_auth_dependency
node_destination_routes -->|"types current user"| node_user_model
node_destination_routes -->|"saves and lists"| node_destination_model

click node_app "https://github.com/datarishavrathore/fastapi_mongodb/blob/main/main.py"
click node_auth_routes "https://github.com/datarishavrathore/fastapi_mongodb/blob/main/routes/auth.py"
click node_user_routes "https://github.com/datarishavrathore/fastapi_mongodb/blob/main/routes/get_users.py"
click node_destination_routes "https://github.com/datarishavrathore/fastapi_mongodb/blob/main/routes/destination.py"
click node_user_schemas "https://github.com/datarishavrathore/fastapi_mongodb/blob/main/schemas/user.py"
click node_destination_schemas "https://github.com/datarishavrathore/fastapi_mongodb/blob/main/schemas/destination.py"
click node_security "https://github.com/datarishavrathore/fastapi_mongodb/blob/main/utils/security.py"
click node_auth_dependency "https://github.com/datarishavrathore/fastapi_mongodb/blob/main/dependencies/auth.py"
click node_user_model "https://github.com/datarishavrathore/fastapi_mongodb/blob/main/models/user.py"
click node_destination_model "https://github.com/datarishavrathore/fastapi_mongodb/blob/main/models/destination.py"
click node_db_connection "https://github.com/datarishavrathore/fastapi_mongodb/blob/main/database/connection.py"
click node_settings "https://github.com/datarishavrathore/fastapi_mongodb/blob/main/config/settings.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_auth_routes,node_user_routes,node_destination_routes,node_client toneBlue
class node_security,node_auth_dependency toneAmber
class node_user_schemas,node_destination_schemas,node_user_model,node_destination_model toneMint
class node_db_connection,node_settings,node_mongodb toneRose
```

## Components

### API

- [FastAPI app](https://github.com/datarishavrathore/fastapi_mongodb/blob/main/main.py): `main.py`
- [Auth endpoints](https://github.com/datarishavrathore/fastapi_mongodb/blob/main/routes/auth.py): `routes/auth.py`
- [User listing](https://github.com/datarishavrathore/fastapi_mongodb/blob/main/routes/get_users.py): `routes/get_users.py`
- [Destination endpoints](https://github.com/datarishavrathore/fastapi_mongodb/blob/main/routes/destination.py): `routes/destination.py`

### Authentication

- [Token security](https://github.com/datarishavrathore/fastapi_mongodb/blob/main/utils/security.py): `utils/security.py`
- [JWT authentication](https://github.com/datarishavrathore/fastapi_mongodb/blob/main/dependencies/auth.py): `dependencies/auth.py`

### Domain

- [User schemas](https://github.com/datarishavrathore/fastapi_mongodb/blob/main/schemas/user.py): `schemas/user.py`
- [Destination schemas](https://github.com/datarishavrathore/fastapi_mongodb/blob/main/schemas/destination.py): `schemas/destination.py`
- [User model](https://github.com/datarishavrathore/fastapi_mongodb/blob/main/models/user.py): `models/user.py`
- [Destination model](https://github.com/datarishavrathore/fastapi_mongodb/blob/main/models/destination.py): `models/destination.py`

### Persistence

- [MongoDB connection](https://github.com/datarishavrathore/fastapi_mongodb/blob/main/database/connection.py): `database/connection.py`
- [Database settings](https://github.com/datarishavrathore/fastapi_mongodb/blob/main/config/settings.py): `config/settings.py`
- **MongoDB**

### Other components

- **API client**

## Connections

- API client → FastAPI app: sends requests
- FastAPI app → MongoDB connection: connects at startup (evidence: `main.py`)
- FastAPI app → Auth endpoints: registers routes (evidence: `main.py`)
- FastAPI app → User listing: registers routes (evidence: `main.py`)
- FastAPI app → Destination endpoints: registers routes (evidence: `main.py`)
- MongoDB connection → Database settings: reads settings (evidence: `database/connection.py`)
- Auth endpoints → User schemas: validates input (evidence: `routes/auth.py`)
- Auth endpoints → Token security: hashes and signs (evidence: `routes/auth.py`)
- Auth endpoints → User model: queries and saves (evidence: `routes/auth.py`)
- JWT authentication → User model: loads user (evidence: `dependencies/auth.py`)
- User listing → JWT authentication: requires identity (evidence: `routes/get_users.py`)
- User listing → User model: lists users (evidence: `routes/get_users.py`)
- Destination endpoints → Destination schemas: validates and shapes (evidence: `routes/destination.py`)
- Destination endpoints → JWT authentication: requires identity (evidence: `routes/destination.py`)
- Destination endpoints → User model: types current user (evidence: `routes/destination.py`)
- Destination endpoints → Destination model: saves and lists (evidence: `routes/destination.py`)
