# tusharanand767/auth_demo_library architecture

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

- Interactive diagram: https://gitdiagram.com/tusharanand767/auth_demo_library
- Repository: https://github.com/tusharanand767/auth_demo_library

## Overview

Auth_Demo_Library is a demonstration library for authentication and authorization mechanisms, exposed through both a FastAPI server and a command-line demo runner. The CLI exercises JWT, password hashing, OAuth PKCE, MFA, RBAC, rate limiting, sessions, and API keys; the HTTP routes expose corresponding workflows for most features. Several services persist state through SQLite, while JWT, rate limiting, and session behavior use centralized configuration. The README provides no further capability details; edges for unsampled modules are limited to relationships shown in the source index.

Main entry points: [`main.py`](https://github.com/tusharanand767/auth_demo_library/blob/main/main.py) (CLI demo runner), [`server.py`](https://github.com/tusharanand767/auth_demo_library/blob/main/server.py) (FastAPI server), [`src/oauth/service.py`](https://github.com/tusharanand767/auth_demo_library/blob/main/src/oauth/service.py) (OAuth PKCE), [`src/sessions/service.py`](https://github.com/tusharanand767/auth_demo_library/blob/main/src/sessions/service.py) (Session management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry points"]
  node_demo_runner["CLI demo runner<br/>[main.py]"]
  node_api_server["FastAPI server<br/>[server.py]"]
  node_dashboard["Dashboard<br/>[dashboard.py]"]
end

subgraph group_identity["Identity workflows"]
  node_jwt_routes["JWT routes<br/>[routes.py]"]
  node_jwt_service["JWT tokens<br/>[service.py]"]
  node_password_service["Password hashing<br/>[service.py]"]
  node_oauth_routes["OAuth routes<br/>[routes.py]"]
  node_oauth_service["OAuth PKCE<br/>[service.py]"]
  node_mfa_routes["MFA routes<br/>[routes.py]"]
  node_mfa_service["MFA verification<br/>[service.py]"]
  node_session_routes["Session routes<br/>[routes.py]"]
  node_session_service["Session management<br/>[service.py]"]
end

subgraph group_access["Access controls"]
  node_api_key_routes["API key routes<br/>[routes.py]"]
  node_api_key_service["API key management<br/>[service.py]"]
  node_rbac_routes["RBAC routes<br/>[routes.py]"]
  node_rbac_service["Permission engine<br/>[service.py]"]
  node_rate_routes["Rate-limit routes<br/>[routes.py]"]
  node_rate_service["Rate limiting<br/>[service.py]"]
  node_auth_middleware["Auth middleware<br/>[auth_middleware.py]"]
end

subgraph group_platform["Shared services"]
  node_config["Auth configuration<br/>[auth_config.py]"]
  node_database[("SQLite database<br/>[db.py]")]
end

node_operator(("Demo operator"))
node_http_client(("HTTP client"))

node_operator -.->|"runs demo"| node_demo_runner
node_http_client -.->|"sends requests"| node_api_server
node_api_server -->|"uses middleware"| node_auth_middleware
node_api_server -->|"registers routes"| node_jwt_routes
node_api_server -->|"registers routes"| node_oauth_routes
node_api_server -->|"registers routes"| node_mfa_routes
node_api_server -->|"registers routes"| node_rbac_routes
node_api_server -->|"registers routes"| node_rate_routes
node_api_server -->|"registers routes"| node_session_routes
node_api_server -->|"registers routes"| node_api_key_routes
node_demo_runner -->|"exercises tokens"| node_jwt_service
node_demo_runner -->|"exercises hashing"| node_password_service
node_demo_runner -->|"exercises PKCE"| node_oauth_service
node_demo_runner -->|"exercises MFA"| node_mfa_service
node_demo_runner -->|"checks permissions"| node_rbac_service
node_demo_runner -->|"checks limits"| node_rate_service
node_demo_runner -->|"manages sessions"| node_session_service
node_demo_runner -->|"manages keys"| node_api_key_service
node_jwt_routes -->|"delegates to"| node_jwt_service
node_oauth_routes -->|"delegates to"| node_oauth_service
node_mfa_routes -->|"delegates to"| node_mfa_service
node_session_routes -->|"delegates to"| node_session_service
node_api_key_routes -->|"delegates to"| node_api_key_service
node_rbac_routes -->|"delegates to"| node_rbac_service
node_auth_middleware -->|"checks limits"| node_rate_service
node_jwt_service -->|"reads settings"| node_config
node_oauth_service -->|"reads settings"| node_config
node_session_service -->|"reads settings"| node_config
node_rate_service -->|"reads settings"| node_config
node_mfa_service -->|"reads and writes"| node_database
node_oauth_service -->|"reads and writes"| node_database
node_session_service -->|"reads and writes"| node_database
node_api_key_service -->|"reads and writes"| node_database

click node_demo_runner "https://github.com/tusharanand767/auth_demo_library/blob/main/main.py"
click node_api_server "https://github.com/tusharanand767/auth_demo_library/blob/main/server.py"
click node_dashboard "https://github.com/tusharanand767/auth_demo_library/blob/main/dashboard.py"
click node_jwt_routes "https://github.com/tusharanand767/auth_demo_library/blob/main/src/jwt/routes.py"
click node_jwt_service "https://github.com/tusharanand767/auth_demo_library/blob/main/src/jwt/service.py"
click node_password_service "https://github.com/tusharanand767/auth_demo_library/blob/main/src/password/service.py"
click node_oauth_routes "https://github.com/tusharanand767/auth_demo_library/blob/main/src/oauth/routes.py"
click node_oauth_service "https://github.com/tusharanand767/auth_demo_library/blob/main/src/oauth/service.py"
click node_mfa_routes "https://github.com/tusharanand767/auth_demo_library/blob/main/src/mfa/routes.py"
click node_mfa_service "https://github.com/tusharanand767/auth_demo_library/blob/main/src/mfa/service.py"
click node_session_routes "https://github.com/tusharanand767/auth_demo_library/blob/main/src/sessions/routes.py"
click node_session_service "https://github.com/tusharanand767/auth_demo_library/blob/main/src/sessions/service.py"
click node_api_key_routes "https://github.com/tusharanand767/auth_demo_library/blob/main/src/api_keys/routes.py"
click node_api_key_service "https://github.com/tusharanand767/auth_demo_library/blob/main/src/api_keys/service.py"
click node_rbac_routes "https://github.com/tusharanand767/auth_demo_library/blob/main/src/rbac/routes.py"
click node_rbac_service "https://github.com/tusharanand767/auth_demo_library/blob/main/src/rbac/service.py"
click node_rate_routes "https://github.com/tusharanand767/auth_demo_library/blob/main/src/rate_limiting/routes.py"
click node_rate_service "https://github.com/tusharanand767/auth_demo_library/blob/main/src/rate_limiting/service.py"
click node_auth_middleware "https://github.com/tusharanand767/auth_demo_library/blob/main/middleware/auth_middleware.py"
click node_config "https://github.com/tusharanand767/auth_demo_library/blob/main/config/auth_config.py"
click node_database "https://github.com/tusharanand767/auth_demo_library/blob/main/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_demo_runner,node_api_server,node_dashboard,node_http_client toneBlue
class node_jwt_routes,node_jwt_service,node_password_service,node_oauth_routes,node_oauth_service,node_mfa_routes,node_mfa_service,node_session_routes,node_session_service toneAmber
class node_api_key_routes,node_api_key_service,node_rbac_routes,node_rbac_service,node_rate_routes,node_rate_service,node_auth_middleware toneMint
class node_config,node_database toneRose
class node_operator toneIndigo
```

## Components

### Entry points

- [CLI demo runner](https://github.com/tusharanand767/auth_demo_library/blob/main/main.py): `main.py`
- [FastAPI server](https://github.com/tusharanand767/auth_demo_library/blob/main/server.py): `server.py`
- [Dashboard](https://github.com/tusharanand767/auth_demo_library/blob/main/dashboard.py): `dashboard.py`

### Identity workflows

- [JWT routes](https://github.com/tusharanand767/auth_demo_library/blob/main/src/jwt/routes.py): `src/jwt/routes.py`
- [JWT tokens](https://github.com/tusharanand767/auth_demo_library/blob/main/src/jwt/service.py): `src/jwt/service.py`
- [Password hashing](https://github.com/tusharanand767/auth_demo_library/blob/main/src/password/service.py): `src/password/service.py`
- [OAuth routes](https://github.com/tusharanand767/auth_demo_library/blob/main/src/oauth/routes.py): `src/oauth/routes.py`
- [OAuth PKCE](https://github.com/tusharanand767/auth_demo_library/blob/main/src/oauth/service.py): `src/oauth/service.py`
- [MFA routes](https://github.com/tusharanand767/auth_demo_library/blob/main/src/mfa/routes.py): `src/mfa/routes.py`
- [MFA verification](https://github.com/tusharanand767/auth_demo_library/blob/main/src/mfa/service.py): `src/mfa/service.py`
- [Session routes](https://github.com/tusharanand767/auth_demo_library/blob/main/src/sessions/routes.py): `src/sessions/routes.py`
- [Session management](https://github.com/tusharanand767/auth_demo_library/blob/main/src/sessions/service.py): `src/sessions/service.py`

### Access controls

- [API key routes](https://github.com/tusharanand767/auth_demo_library/blob/main/src/api_keys/routes.py): `src/api_keys/routes.py`
- [API key management](https://github.com/tusharanand767/auth_demo_library/blob/main/src/api_keys/service.py): `src/api_keys/service.py`
- [RBAC routes](https://github.com/tusharanand767/auth_demo_library/blob/main/src/rbac/routes.py): `src/rbac/routes.py`
- [Permission engine](https://github.com/tusharanand767/auth_demo_library/blob/main/src/rbac/service.py): `src/rbac/service.py`
- [Rate-limit routes](https://github.com/tusharanand767/auth_demo_library/blob/main/src/rate_limiting/routes.py): `src/rate_limiting/routes.py`
- [Rate limiting](https://github.com/tusharanand767/auth_demo_library/blob/main/src/rate_limiting/service.py): `src/rate_limiting/service.py`
- [Auth middleware](https://github.com/tusharanand767/auth_demo_library/blob/main/middleware/auth_middleware.py): `middleware/auth_middleware.py`

### Shared services

- [Auth configuration](https://github.com/tusharanand767/auth_demo_library/blob/main/config/auth_config.py): `config/auth_config.py`
- [SQLite database](https://github.com/tusharanand767/auth_demo_library/blob/main/db.py): `db.py`

### Other components

- **Demo operator**
- **HTTP client**

## Connections

- Demo operator → CLI demo runner: runs demo
- HTTP client → FastAPI server: sends requests
- FastAPI server → Auth middleware: uses middleware (evidence: `server.py`)
- FastAPI server → JWT routes: registers routes (evidence: `server.py`)
- FastAPI server → OAuth routes: registers routes (evidence: `server.py`)
- FastAPI server → MFA routes: registers routes (evidence: `server.py`)
- FastAPI server → RBAC routes: registers routes (evidence: `server.py`)
- FastAPI server → Rate-limit routes: registers routes (evidence: `server.py`)
- FastAPI server → Session routes: registers routes (evidence: `server.py`)
- FastAPI server → API key routes: registers routes (evidence: `server.py`)
- CLI demo runner → JWT tokens: exercises tokens (evidence: `main.py`)
- CLI demo runner → Password hashing: exercises hashing (evidence: `main.py`)
- CLI demo runner → OAuth PKCE: exercises PKCE (evidence: `main.py`)
- CLI demo runner → MFA verification: exercises MFA (evidence: `main.py`)
- CLI demo runner → Permission engine: checks permissions (evidence: `main.py`)
- CLI demo runner → Rate limiting: checks limits (evidence: `main.py`)
- CLI demo runner → Session management: manages sessions (evidence: `main.py`)
- CLI demo runner → API key management: manages keys (evidence: `main.py`)
- JWT routes → JWT tokens: delegates to (evidence: `src/jwt/routes.py`)
- OAuth routes → OAuth PKCE: delegates to (evidence: `src/oauth/routes.py`)
- MFA routes → MFA verification: delegates to (evidence: `src/mfa/routes.py`)
- Session routes → Session management: delegates to (evidence: `src/sessions/routes.py`)
- API key routes → API key management: delegates to (evidence: `src/api_keys/routes.py`)
- RBAC routes → Permission engine: delegates to (evidence: `src/rbac/routes.py`)
- Auth middleware → Rate limiting: checks limits (evidence: `middleware/auth_middleware.py`)
- JWT tokens → Auth configuration: reads settings (evidence: `src/jwt/service.py`)
- OAuth PKCE → Auth configuration: reads settings (evidence: `src/oauth/service.py`)
- Session management → Auth configuration: reads settings (evidence: `src/sessions/service.py`)
- Rate limiting → Auth configuration: reads settings (evidence: `src/rate_limiting/service.py`)
- MFA verification → SQLite database: reads and writes (evidence: `src/mfa/service.py`)
- OAuth PKCE → SQLite database: reads and writes (evidence: `src/oauth/service.py`)
- Session management → SQLite database: reads and writes (evidence: `src/sessions/service.py`)
- API key management → SQLite database: reads and writes (evidence: `src/api_keys/service.py`)
