# coreymschafer/fastapi-19-deployment-docker-gcr architecture

> Architecture diagram of the GitHub repository coreymschafer/fastapi-19-deployment-docker-gcr, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/coreymschafer/fastapi-19-deployment-docker-gcr
- Repository: https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr

## Overview

This is a FastAPI blog with browser-rendered pages and a JSON API. Visitors browse posts; registered users can authenticate and manage posts, account details, and profile pictures. Password recovery uses expiring reset tokens and email. The implementation separates route handling, authentication, validation, ORM models, and database sessions, with S3-backed profile images. The README is empty, so capability coverage is based on the sampled source and tree; unsampled template and static behavior is not detailed.

Main entry points: [`routers/users.py`](https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/routers/users.py) (User routes), [`main.py`](https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/main.py) (Web entry and pages), [`database.py`](https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/database.py) (Database sessions), [`routers/posts.py`](https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/routers/posts.py) (Post routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_main["Web entry and pages<br/>[main.py]"]
  node_templates["Page templates"]
  node_static["Browser assets"]
end

subgraph group_accounts["Accounts and security"]
  node_user_routes["User routes<br/>[users.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_email["Reset email<br/>[email_utils.py]"]
end

subgraph group_content["Blog content"]
  node_post_routes["Post routes<br/>[posts.py]"]
  node_schemas["Request and response schemas<br/>[schemas.py]"]
end

subgraph group_services["Persistence and integrations"]
  node_models["ORM models<br/>[models.py]"]
  node_database["Database sessions<br/>[database.py]"]
  node_config["Application settings<br/>[config.py]"]
  node_images["Image processing and S3<br/>[image_utils.py]"]
  node_sql_store[("SQL database")]
  node_s3[("S3 object storage")]
  node_smtp["SMTP service"]
end

node_visitor(("Visitor"))

node_visitor -->|"requests pages"| node_main
node_visitor -->|"calls user API"| node_user_routes
node_visitor -->|"calls post API"| node_post_routes
node_main -->|"renders pages"| node_templates
node_main -->|"mounts assets"| node_static
node_main -->|"registers routes"| node_post_routes
node_main -->|"registers routes"| node_user_routes
node_main -->|"queries sessions"| node_database
node_main -->|"queries posts"| node_models
node_post_routes -->|"requires current user"| node_auth
node_post_routes -->|"gets sessions"| node_database
node_post_routes -->|"reads and writes"| node_models
node_post_routes -->|"validates responses"| node_schemas
node_user_routes -->|"uses credentials"| node_auth
node_user_routes -->|"gets sessions"| node_database
node_user_routes -->|"reads and writes"| node_models
node_user_routes -->|"validates requests"| node_schemas
node_user_routes -->|"sends reset email"| node_email
node_user_routes -->|"processes pictures"| node_images
node_database -->|"loads database URL"| node_config
node_database -->|"opens sessions"| node_sql_store
node_models -->|"uses declarative base"| node_database
node_auth -->|"loads user session"| node_database
node_auth -->|"looks up user"| node_models
node_auth -->|"uses token settings"| node_config
node_email -->|"uses mail settings"| node_config
node_email -->|"sends messages"| node_smtp
node_email -->|"renders reset email"| node_templates
node_images -->|"uses S3 settings"| node_config
node_images -->|"uploads and deletes"| node_s3

click node_main "https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/main.py"
click node_templates "https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/tree/main/templates"
click node_static "https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/tree/main/static"
click node_user_routes "https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/routers/users.py"
click node_auth "https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/auth.py"
click node_email "https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/email_utils.py"
click node_post_routes "https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/routers/posts.py"
click node_schemas "https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/schemas.py"
click node_models "https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/models.py"
click node_database "https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/database.py"
click node_config "https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/config.py"
click node_images "https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/image_utils.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_main,node_templates,node_static toneBlue
class node_user_routes,node_auth,node_email toneAmber
class node_post_routes,node_schemas toneMint
class node_models,node_database,node_config,node_images,node_sql_store,node_s3,node_smtp toneRose
class node_visitor toneIndigo
```

## Components

### Web application

- [Web entry and pages](https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/main.py): `main.py`
- [Page templates](https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/tree/main/templates): `templates`
- [Browser assets](https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/tree/main/static): `static`

### Accounts and security

- [User routes](https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/routers/users.py): `routers/users.py`
- [Authentication](https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/auth.py): `auth.py`
- [Reset email](https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/email_utils.py): `email_utils.py`

### Blog content

- [Post routes](https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/routers/posts.py): `routers/posts.py`
- [Request and response schemas](https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/schemas.py): `schemas.py`

### Persistence and integrations

- [ORM models](https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/models.py): `models.py`
- [Database sessions](https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/database.py): `database.py`
- [Application settings](https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/config.py): `config.py`
- [Image processing and S3](https://github.com/coreymschafer/fastapi-19-deployment-docker-gcr/blob/main/image_utils.py): `image_utils.py`
- **SQL database**
- **S3 object storage**
- **SMTP service**

### Other components

- **Visitor**

## Connections

- Visitor → Web entry and pages: requests pages (evidence: `main.py`)
- Visitor → User routes: calls user API (evidence: `routers/users.py`)
- Visitor → Post routes: calls post API (evidence: `routers/posts.py`)
- Web entry and pages → Page templates: renders pages (evidence: `main.py`)
- Web entry and pages → Browser assets: mounts assets (evidence: `main.py`)
- Web entry and pages → Post routes: registers routes (evidence: `main.py`)
- Web entry and pages → User routes: registers routes (evidence: `main.py`)
- Web entry and pages → Database sessions: queries sessions (evidence: `main.py`)
- Web entry and pages → ORM models: queries posts (evidence: `main.py`)
- Post routes → Authentication: requires current user (evidence: `routers/posts.py`)
- Post routes → Database sessions: gets sessions (evidence: `routers/posts.py`)
- Post routes → ORM models: reads and writes (evidence: `routers/posts.py`)
- Post routes → Request and response schemas: validates responses (evidence: `routers/posts.py`)
- User routes → Authentication: uses credentials (evidence: `routers/users.py`)
- User routes → Database sessions: gets sessions (evidence: `routers/users.py`)
- User routes → ORM models: reads and writes (evidence: `routers/users.py`)
- User routes → Request and response schemas: validates requests (evidence: `routers/users.py`)
- User routes → Reset email: sends reset email (evidence: `routers/users.py`)
- User routes → Image processing and S3: processes pictures (evidence: `routers/users.py`)
- Database sessions → Application settings: loads database URL (evidence: `database.py`)
- Database sessions → SQL database: opens sessions (evidence: `database.py`)
- ORM models → Database sessions: uses declarative base (evidence: `models.py`)
- Authentication → Database sessions: loads user session (evidence: `auth.py`)
- Authentication → ORM models: looks up user (evidence: `auth.py`)
- Authentication → Application settings: uses token settings (evidence: `auth.py`)
- Reset email → Application settings: uses mail settings (evidence: `email_utils.py`)
- Reset email → SMTP service: sends messages (evidence: `email_utils.py`)
- Reset email → Page templates: renders reset email (evidence: `email_utils.py`)
- Image processing and S3 → Application settings: uses S3 settings (evidence: `image_utils.py`)
- Image processing and S3 → S3 object storage: uploads and deletes (evidence: `image_utils.py`)
