# packtpublishing/fastapi-cookbook architecture

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

- Interactive diagram: https://gitdiagram.com/packtpublishing/fastapi-cookbook
- Repository: https://github.com/packtpublishing/fastapi-cookbook

## Overview

This repository is a cookbook of separate FastAPI examples, not one integrated application. The recurring workflow is an HTTP client calling a chapter-specific app, which routes requests to domain logic and, in some examples, persistence or integrations. The graph highlights representative examples and documented capabilities—authentication, ticketing, streaming/search, middleware, trips, chat, and AI/GraphQL/gRPC—rather than suggesting they share a runtime. Some subsystems are represented from the tree and README only; their internal call relationships are therefore omitted.

Main entry points: [`Chapter04/saas_app/main.py`](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter04/saas_app/main.py) (SaaS API), [`Chapter07/streaming_platform/app/main.py`](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter07/streaming_platform/app/main.py) (Streaming API), [`Chapter06/ticketing_system/app/main.py`](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter06/ticketing_system/app/main.py) (Ticketing API), [`Chapter08/trip_platform/app/main.py`](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter08/trip_platform/app/main.py) (Trip API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["API examples"]
  node_taskapi["Task API<br/>[main.py]"]
  node_taskops["Task operations<br/>[operations.py]"]
  node_saas["SaaS API<br/>[main.py]"]
  node_saasauth["Auth and access<br/>[security.py]"]
  node_saasops["User operations<br/>[operations.py]"]
  node_ticketapi["Ticketing API<br/>[main.py]"]
  node_streamapi["Streaming API<br/>[main.py]"]
end

subgraph group_data["Data-backed apps"]
  node_saasdb[("SaaS database<br/>[db_connection.py]")]
  node_ticketops["Ticket operations<br/>[operations.py]"]
  node_ticketdb[("Ticket models<br/>[database.py]")]
  node_songsearch["Song search<br/>[main_search.py]"]
  node_streamdb[("MongoDB access<br/>[database.py]")]
  node_searchstore[("Search and cache<br/>[db_connection.py]")]
end

subgraph group_advanced["Advanced capabilities"]
  node_tripapi["Trip API<br/>[main.py]"]
  node_tripdeps["Query dependencies<br/>[dependencies.py]"]
  node_tripfeatures["Trip middleware and limits<br/>[middleware.py]"]
  node_chatapp["Chat platform<br/>[main.py]"]
  node_chattransport["WebSocket manager<br/>[ws_manager.py]"]
  node_middlewareapp["Middleware example<br/>[main.py]"]
  node_middlewareparts["Request and webhook middleware<br/>[webhook.py]"]
end

subgraph group_ai["AI and protocols"]
  node_ragapp["RAG application<br/>[main.py]"]
  node_ragdocs["Document handling<br/>[documents.py]"]
  node_ragmodel["Model integration<br/>[model.py]"]
  node_graphql["GraphQL example<br/>[main.py]"]
  node_grpc["gRPC gateway<br/>[main.py]"]
end

node_client(("HTTP client"))

node_client -->|"sends requests"| node_taskapi
node_taskapi -->|"calls operations"| node_taskops
node_client -->|"sends requests"| node_saas
node_saas -->|"registers router"| node_saasauth
node_saas -->|"creates users"| node_saasops
node_saas -->|"initializes schema"| node_saasdb
node_saas -->|"resolves login token"| node_saasauth
node_saasauth -->|"authenticates users"| node_saasops
node_client -->|"sends requests"| node_ticketapi
node_ticketapi -->|"calls operations"| node_ticketops
node_ticketapi -->|"creates schema"| node_ticketdb
node_ticketops -->|"uses models"| node_ticketdb
node_client -->|"sends requests"| node_streamapi
node_streamapi -->|"reads and writes"| node_streamdb
node_streamapi -->|"includes router"| node_songsearch
node_streamapi -->|"initializes services"| node_searchstore
node_client -->|"sends requests"| node_tripapi
node_tripapi -->|"uses dependencies"| node_tripdeps
node_tripapi -->|"adds middleware"| node_tripfeatures
node_client -->|"opens chat"| node_chatapp
node_chatapp -->|"uses manager"| node_chattransport
node_client -->|"sends requests"| node_middlewareapp
node_middlewareapp -->|"registers webhook middleware"| node_middlewareparts
node_client -->|"sends prompts"| node_ragapp
node_ragapp -->|"loads documents"| node_ragdocs
node_ragapp -->|"uses model"| node_ragmodel
node_client -->|"sends queries"| node_graphql
node_client -->|"sends requests"| node_grpc

click node_taskapi "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter03/task_manager_app/main.py"
click node_taskops "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter03/task_manager_app/operations.py"
click node_saas "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter04/saas_app/main.py"
click node_saasauth "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter04/saas_app/security.py"
click node_saasops "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter04/saas_app/operations.py"
click node_saasdb "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter04/saas_app/db_connection.py"
click node_ticketapi "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter06/ticketing_system/app/main.py"
click node_ticketops "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter06/ticketing_system/app/operations.py"
click node_ticketdb "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter06/ticketing_system/app/database.py"
click node_streamapi "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter07/streaming_platform/app/main.py"
click node_songsearch "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter07/streaming_platform/app/main_search.py"
click node_streamdb "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter07/streaming_platform/app/database.py"
click node_searchstore "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter07/streaming_platform/app/db_connection.py"
click node_tripapi "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter08/trip_platform/app/main.py"
click node_tripdeps "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter08/trip_platform/app/dependencies.py"
click node_tripfeatures "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter08/trip_platform/app/middleware.py"
click node_chatapp "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter09/chat_platform/app/main.py"
click node_chattransport "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter09/chat_platform/app/ws_manager.py"
click node_middlewareapp "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter11/middleware_project/main.py"
click node_middlewareparts "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter11/middleware_project/middleware/webhook.py"
click node_ragapp "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter10/ecotech_RAG/main.py"
click node_ragdocs "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter10/ecotech_RAG/documents.py"
click node_ragmodel "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter10/ecotech_RAG/model.py"
click node_graphql "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter10/graphql/main.py"
click node_grpc "https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter10/grpc_gateway/app/main.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_taskapi,node_taskops,node_saas,node_saasauth,node_saasops,node_ticketapi,node_streamapi,node_client toneBlue
class node_saasdb,node_ticketops,node_ticketdb,node_songsearch,node_streamdb,node_searchstore toneAmber
class node_tripapi,node_tripdeps,node_tripfeatures,node_chatapp,node_chattransport,node_middlewareapp,node_middlewareparts toneMint
class node_ragapp,node_ragdocs,node_ragmodel,node_graphql,node_grpc toneRose
```

## Components

### API examples

- [Task API](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter03/task_manager_app/main.py): `Chapter03/task_manager_app/main.py`
- [Task operations](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter03/task_manager_app/operations.py): `Chapter03/task_manager_app/operations.py`
- [SaaS API](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter04/saas_app/main.py): `Chapter04/saas_app/main.py`
- [Auth and access](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter04/saas_app/security.py): `Chapter04/saas_app/security.py`
- [User operations](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter04/saas_app/operations.py): `Chapter04/saas_app/operations.py`
- [Ticketing API](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter06/ticketing_system/app/main.py): `Chapter06/ticketing_system/app/main.py`
- [Streaming API](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter07/streaming_platform/app/main.py): `Chapter07/streaming_platform/app/main.py`

### Data-backed apps

- [SaaS database](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter04/saas_app/db_connection.py): `Chapter04/saas_app/db_connection.py`
- [Ticket operations](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter06/ticketing_system/app/operations.py): `Chapter06/ticketing_system/app/operations.py`
- [Ticket models](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter06/ticketing_system/app/database.py): `Chapter06/ticketing_system/app/database.py`
- [Song search](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter07/streaming_platform/app/main_search.py): `Chapter07/streaming_platform/app/main_search.py`
- [MongoDB access](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter07/streaming_platform/app/database.py): `Chapter07/streaming_platform/app/database.py`
- [Search and cache](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter07/streaming_platform/app/db_connection.py): `Chapter07/streaming_platform/app/db_connection.py`

### Advanced capabilities

- [Trip API](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter08/trip_platform/app/main.py): `Chapter08/trip_platform/app/main.py`
- [Query dependencies](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter08/trip_platform/app/dependencies.py): `Chapter08/trip_platform/app/dependencies.py`
- [Trip middleware and limits](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter08/trip_platform/app/middleware.py): `Chapter08/trip_platform/app/middleware.py`
- [Chat platform](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter09/chat_platform/app/main.py): `Chapter09/chat_platform/app/main.py`
- [WebSocket manager](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter09/chat_platform/app/ws_manager.py): `Chapter09/chat_platform/app/ws_manager.py`
- [Middleware example](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter11/middleware_project/main.py): `Chapter11/middleware_project/main.py`
- [Request and webhook middleware](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter11/middleware_project/middleware/webhook.py): `Chapter11/middleware_project/middleware/webhook.py`

### AI and protocols

- [RAG application](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter10/ecotech_RAG/main.py): `Chapter10/ecotech_RAG/main.py`
- [Document handling](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter10/ecotech_RAG/documents.py): `Chapter10/ecotech_RAG/documents.py`
- [Model integration](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter10/ecotech_RAG/model.py): `Chapter10/ecotech_RAG/model.py`
- [GraphQL example](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter10/graphql/main.py): `Chapter10/graphql/main.py`
- [gRPC gateway](https://github.com/packtpublishing/fastapi-cookbook/blob/main/Chapter10/grpc_gateway/app/main.py): `Chapter10/grpc_gateway/app/main.py`

### Other components

- **HTTP client**

## Connections

- HTTP client → Task API: sends requests
- Task API → Task operations: calls operations (evidence: `Chapter03/task_manager_app/main.py`)
- HTTP client → SaaS API: sends requests
- SaaS API → Auth and access: registers router (evidence: `Chapter04/saas_app/main.py`)
- SaaS API → User operations: creates users (evidence: `Chapter04/saas_app/main.py`)
- SaaS API → SaaS database: initializes schema (evidence: `Chapter04/saas_app/main.py`)
- SaaS API → Auth and access: resolves login token (evidence: `Chapter04/saas_app/main.py`)
- Auth and access → User operations: authenticates users (evidence: `Chapter04/saas_app/security.py`)
- HTTP client → Ticketing API: sends requests
- Ticketing API → Ticket operations: calls operations (evidence: `Chapter06/ticketing_system/app/main.py`)
- Ticketing API → Ticket models: creates schema (evidence: `Chapter06/ticketing_system/app/main.py`)
- Ticket operations → Ticket models: uses models (evidence: `Chapter06/ticketing_system/app/operations.py`)
- HTTP client → Streaming API: sends requests
- Streaming API → MongoDB access: reads and writes (evidence: `Chapter07/streaming_platform/app/main.py`)
- Streaming API → Song search: includes router (evidence: `Chapter07/streaming_platform/app/main.py`)
- Streaming API → Search and cache: initializes services (evidence: `Chapter07/streaming_platform/app/main.py`)
- HTTP client → Trip API: sends requests
- Trip API → Query dependencies: uses dependencies (evidence: `Chapter08/trip_platform/app/main.py`)
- Trip API → Trip middleware and limits: adds middleware (evidence: `Chapter08/trip_platform/app/main.py`)
- HTTP client → Chat platform: opens chat
- Chat platform → WebSocket manager: uses manager (evidence: `Chapter09/chat_platform/app/main.py`)
- HTTP client → Middleware example: sends requests
- Middleware example → Request and webhook middleware: registers webhook middleware (evidence: `Chapter11/middleware_project/main.py`)
- HTTP client → RAG application: sends prompts
- RAG application → Document handling: loads documents (evidence: `Chapter10/ecotech_RAG/main.py`)
- RAG application → Model integration: uses model (evidence: `Chapter10/ecotech_RAG/main.py`)
- HTTP client → GraphQL example: sends queries
- HTTP client → gRPC gateway: sends requests
