# naveen-ravi2810/api-handler architecture

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

- Interactive diagram: https://gitdiagram.com/naveen-ravi2810/api-handler
- Repository: https://github.com/naveen-ravi2810/api-handler

## Overview

API Holder pairs a Nuxt dashboard with a FastAPI service. The visible backend workflow is request routing through authentication endpoints into user services, which use user models and issue JWTs; database sessions are provided separately. The client tree indicates login, signup, app, profile, SSO, and contribution screens, plus reusable table and filtering UI, but their source excerpts do not show how they call the API. The README is empty, so those client-to-server links and app-management behavior remain unverified.

Main entry points: [`server/api_holder/endpoints/v1/user.py`](https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/endpoints/v1/user.py) (User routes), [`server/api_holder/services/user.py`](https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/services/user.py) (User service), [`server/api_holder/models/user.py`](https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/models/user.py) (User model), [`client/components/Table/index.vue`](https://github.com/naveen-ravi2810/api-handler/blob/main/client/components/Table/index.vue) (Data table)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client_pages["Dashboard pages"]
  node_home_page["Home page<br/>[index.vue]"]
  node_login_page["Login page<br/>[Login.vue]"]
  node_signup_page["Signup page<br/>[signup.vue]"]
  node_apps_page["Apps page<br/>[apps.vue]"]
  node_app_page["App detail<br/>[index.vue]"]
  node_profile_page["Profile page<br/>[profile.vue]"]
  node_sso_page["SSO page<br/>[sso.vue]"]
  node_contrib_page["Contributions page<br/>[index.vue]"]
end

subgraph group_client_ui["Reusable interface"]
  node_table["Data table<br/>[index.vue]"]
  node_table_header["Table header<br/>[Header.vue]"]
  node_table_body["Table body<br/>[Body.vue]"]
  node_table_meta["Table controls<br/>[MetaHeader.vue]"]
  node_inline_filter["Inline filter<br/>[InLineFilter.vue]"]
  node_mapper["UI mappings<br/>[mapper.js]"]
end

subgraph group_api_runtime["API runtime"]
  node_api_app["FastAPI app<br/>[main.py]"]
  node_api_router["API router<br/>[api.py]"]
  node_user_routes["User routes<br/>[user.py]"]
end

subgraph group_identity_data["Identity and data"]
  node_user_service["User service<br/>[user.py]"]
  node_token_manager["JWT tokens<br/>[token_manager.py]"]
  node_user_model["User model<br/>[user.py]"]
  node_app_model["App model<br/>[app.py]"]
  node_model_attributes["Model attributes"]
  node_db_session[("Database sessions<br/>[db.py]")]
  node_settings["Service settings<br/>[settings.py]"]
  node_integrity_errors["Integrity errors<br/>[error_handler.py]"]
end

node_visitor(("Dashboard user"))

node_table -->|"renders"| node_table_header
node_table -->|"renders"| node_table_body
node_table -->|"renders"| node_table_meta
node_table_meta -->|"renders"| node_inline_filter
node_api_app -->|"registers"| node_api_router
node_api_router -->|"includes"| node_user_routes
node_user_routes -->|"depends on"| node_db_session
node_user_routes -->|"calls"| node_user_service
node_user_routes -->|"uses schemas"| node_token_manager
node_user_service -->|"queries"| node_user_model
node_user_service -->|"creates tokens"| node_token_manager
node_user_service -->|"formats errors"| node_integrity_errors
node_token_manager -->|"reads secrets"| node_settings
node_db_session -->|"reads database URI"| node_settings
node_user_model -->|"inherits"| node_model_attributes
node_app_model -->|"inherits"| node_model_attributes
node_user_model -->|"relates to"| node_app_model
node_app_model -->|"relates to"| node_user_model

click node_home_page "https://github.com/naveen-ravi2810/api-handler/blob/main/client/pages/index.vue"
click node_login_page "https://github.com/naveen-ravi2810/api-handler/blob/main/client/components/Login.vue"
click node_signup_page "https://github.com/naveen-ravi2810/api-handler/blob/main/client/pages/signup.vue"
click node_apps_page "https://github.com/naveen-ravi2810/api-handler/blob/main/client/pages/apps.vue"
click node_app_page "https://github.com/naveen-ravi2810/api-handler/blob/main/client/pages/%5Bapp_id%5D/index.vue"
click node_profile_page "https://github.com/naveen-ravi2810/api-handler/blob/main/client/pages/profile.vue"
click node_sso_page "https://github.com/naveen-ravi2810/api-handler/blob/main/client/pages/sso.vue"
click node_contrib_page "https://github.com/naveen-ravi2810/api-handler/blob/main/client/pages/contrib/index.vue"
click node_table "https://github.com/naveen-ravi2810/api-handler/blob/main/client/components/Table/index.vue"
click node_table_header "https://github.com/naveen-ravi2810/api-handler/blob/main/client/components/Table/Header.vue"
click node_table_body "https://github.com/naveen-ravi2810/api-handler/blob/main/client/components/Table/Body.vue"
click node_table_meta "https://github.com/naveen-ravi2810/api-handler/blob/main/client/components/Table/MetaHeader.vue"
click node_inline_filter "https://github.com/naveen-ravi2810/api-handler/blob/main/client/components/InLineFilter.vue"
click node_mapper "https://github.com/naveen-ravi2810/api-handler/blob/main/client/utils/mapper.js"
click node_api_app "https://github.com/naveen-ravi2810/api-handler/blob/main/server/main.py"
click node_api_router "https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/endpoints/api.py"
click node_user_routes "https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/endpoints/v1/user.py"
click node_user_service "https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/services/user.py"
click node_token_manager "https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/utils/token_manager.py"
click node_user_model "https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/models/user.py"
click node_app_model "https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/models/app.py"
click node_model_attributes "https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/utils/base_model_attribute.py"
click node_db_session "https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/core/db.py"
click node_settings "https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/core/settings.py"
click node_integrity_errors "https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/utils/error_handler.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_home_page,node_login_page,node_signup_page,node_apps_page,node_app_page,node_profile_page,node_sso_page,node_contrib_page,node_visitor toneBlue
class node_table,node_table_header,node_table_body,node_table_meta,node_inline_filter,node_mapper toneAmber
class node_api_app,node_api_router,node_user_routes toneMint
class node_user_service,node_token_manager,node_user_model,node_app_model,node_model_attributes,node_db_session,node_settings,node_integrity_errors toneRose
```

## Components

### Dashboard pages

- [Home page](https://github.com/naveen-ravi2810/api-handler/blob/main/client/pages/index.vue): `client/pages/index.vue`
- [Login page](https://github.com/naveen-ravi2810/api-handler/blob/main/client/components/Login.vue): `client/components/Login.vue`
- [Signup page](https://github.com/naveen-ravi2810/api-handler/blob/main/client/pages/signup.vue): `client/pages/signup.vue`
- [Apps page](https://github.com/naveen-ravi2810/api-handler/blob/main/client/pages/apps.vue): `client/pages/apps.vue`
- [App detail](https://github.com/naveen-ravi2810/api-handler/blob/main/client/pages/%5Bapp_id%5D/index.vue): `client/pages/[app_id]/index.vue`
- [Profile page](https://github.com/naveen-ravi2810/api-handler/blob/main/client/pages/profile.vue): `client/pages/profile.vue`
- [SSO page](https://github.com/naveen-ravi2810/api-handler/blob/main/client/pages/sso.vue): `client/pages/sso.vue`
- [Contributions page](https://github.com/naveen-ravi2810/api-handler/blob/main/client/pages/contrib/index.vue): `client/pages/contrib/index.vue`

### Reusable interface

- [Data table](https://github.com/naveen-ravi2810/api-handler/blob/main/client/components/Table/index.vue): `client/components/Table/index.vue`
- [Table header](https://github.com/naveen-ravi2810/api-handler/blob/main/client/components/Table/Header.vue): `client/components/Table/Header.vue`
- [Table body](https://github.com/naveen-ravi2810/api-handler/blob/main/client/components/Table/Body.vue): `client/components/Table/Body.vue`
- [Table controls](https://github.com/naveen-ravi2810/api-handler/blob/main/client/components/Table/MetaHeader.vue): `client/components/Table/MetaHeader.vue`
- [Inline filter](https://github.com/naveen-ravi2810/api-handler/blob/main/client/components/InLineFilter.vue): `client/components/InLineFilter.vue`
- [UI mappings](https://github.com/naveen-ravi2810/api-handler/blob/main/client/utils/mapper.js): `client/utils/mapper.js`

### API runtime

- [FastAPI app](https://github.com/naveen-ravi2810/api-handler/blob/main/server/main.py): `server/main.py`
- [API router](https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/endpoints/api.py): `server/api_holder/endpoints/api.py`
- [User routes](https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/endpoints/v1/user.py): `server/api_holder/endpoints/v1/user.py`

### Identity and data

- [User service](https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/services/user.py): `server/api_holder/services/user.py`
- [JWT tokens](https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/utils/token_manager.py): `server/api_holder/utils/token_manager.py`
- [User model](https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/models/user.py): `server/api_holder/models/user.py`
- [App model](https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/models/app.py): `server/api_holder/models/app.py`
- [Model attributes](https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/utils/base_model_attribute.py): `server/api_holder/utils/base_model_attribute.py`
- [Database sessions](https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/core/db.py): `server/api_holder/core/db.py`
- [Service settings](https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/core/settings.py): `server/api_holder/core/settings.py`
- [Integrity errors](https://github.com/naveen-ravi2810/api-handler/blob/main/server/api_holder/utils/error_handler.py): `server/api_holder/utils/error_handler.py`

### Other components

- **Dashboard user**

## Connections

- Data table → Table header: renders (evidence: `client/components/Table/index.vue`)
- Data table → Table body: renders (evidence: `client/components/Table/index.vue`)
- Data table → Table controls: renders (evidence: `client/components/Table/index.vue`)
- Table controls → Inline filter: renders (evidence: `client/components/Table/MetaHeader.vue`)
- FastAPI app → API router: registers (evidence: `server/main.py`)
- API router → User routes: includes (evidence: `server/api_holder/endpoints/api.py`)
- User routes → Database sessions: depends on (evidence: `server/api_holder/endpoints/v1/user.py`)
- User routes → User service: calls (evidence: `server/api_holder/endpoints/v1/user.py`)
- User routes → JWT tokens: uses schemas (evidence: `server/api_holder/endpoints/v1/user.py`)
- User service → User model: queries (evidence: `server/api_holder/services/user.py`)
- User service → JWT tokens: creates tokens (evidence: `server/api_holder/services/user.py`)
- User service → Integrity errors: formats errors (evidence: `server/api_holder/services/user.py`)
- JWT tokens → Service settings: reads secrets (evidence: `server/api_holder/utils/token_manager.py`)
- Database sessions → Service settings: reads database URI (evidence: `server/api_holder/core/db.py`)
- User model → Model attributes: inherits (evidence: `server/api_holder/models/user.py`)
- App model → Model attributes: inherits (evidence: `server/api_holder/models/app.py`)
- User model → App model: relates to (evidence: `server/api_holder/models/user.py`)
- App model → User model: relates to (evidence: `server/api_holder/models/app.py`)
