# selvakumar3/tridots architecture

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

- Interactive diagram: https://gitdiagram.com/selvakumar3/tridots
- Repository: https://github.com/selvakumar3/tridots

## Overview

This is a Django web portal paired with a REST API, with account registration, login/logout, and a dashboard as the visible user workflow. The web views submit authentication requests to the API; API routes dispatch to handlers, which validate credentials or registration data and access the user and reference-data models. Login also invokes bulk creation. The graph includes the shared response/query utility layer. Source excerpts do not show the full dashboard or other API capabilities, so those behaviors and their connections are not inferred.

Main entry points: [`myproject/apiapp/views.py`](https://github.com/selvakumar3/tridots/blob/main/myproject/apiapp/views.py) (Auth handlers), [`myproject/apiapp/models.py`](https://github.com/selvakumar3/tridots/blob/main/myproject/apiapp/models.py) (User and status models), [`myproject/webapp/urls.py`](https://github.com/selvakumar3/tridots/blob/main/myproject/webapp/urls.py) (Web routes), [`myproject/webapp/views.py`](https://github.com/selvakumar3/tridots/blob/main/myproject/webapp/views.py) (Portal views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web portal"]
  node_web_routes["Web routes<br/>[urls.py]"]
  node_web_views["Portal views<br/>[views.py]"]
end

subgraph group_api["Authentication API"]
  node_api_routes["API routes<br/>[urls.py]"]
  node_auth_handlers["Auth handlers<br/>[views.py]"]
  node_serializers["Auth validation<br/>[serializers.py]"]
end

subgraph group_domain["Domain and persistence"]
  node_bulk_data["Reference data setup<br/>[bulk_creation.py]"]
  node_domain_models[("User and status models<br/>[models.py]")]
  node_api_utils["API and query helpers<br/>[utils.py]"]
end

node_visitor(("Portal user"))

node_visitor -->|"opens pages"| node_web_routes
node_web_routes -->|"routes requests"| node_web_views
node_web_views -->|"HTTP auth"| node_auth_handlers
node_api_routes -->|"routes endpoints"| node_auth_handlers
node_auth_handlers -->|"validates data"| node_serializers
node_auth_handlers -->|"queries users"| node_domain_models
node_auth_handlers -->|"initializes data"| node_bulk_data
node_serializers -->|"validates and saves"| node_domain_models
node_bulk_data -->|"bulk creates"| node_domain_models
node_auth_handlers -->|"uses helpers"| node_api_utils
node_api_utils -->|"queries models"| node_domain_models

click node_web_routes "https://github.com/selvakumar3/tridots/blob/main/myproject/webapp/urls.py"
click node_web_views "https://github.com/selvakumar3/tridots/blob/main/myproject/webapp/views.py"
click node_api_routes "https://github.com/selvakumar3/tridots/blob/main/myproject/apiapp/urls.py"
click node_auth_handlers "https://github.com/selvakumar3/tridots/blob/main/myproject/apiapp/views.py"
click node_serializers "https://github.com/selvakumar3/tridots/blob/main/myproject/apiapp/serializers.py"
click node_bulk_data "https://github.com/selvakumar3/tridots/blob/main/myproject/apiapp/bulk_creation.py"
click node_domain_models "https://github.com/selvakumar3/tridots/blob/main/myproject/apiapp/models.py"
click node_api_utils "https://github.com/selvakumar3/tridots/blob/main/myproject/apiapp/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_web_routes,node_web_views,node_visitor toneBlue
class node_api_routes,node_auth_handlers,node_serializers toneAmber
class node_bulk_data,node_domain_models,node_api_utils toneMint
```

## Components

### Web portal

- [Web routes](https://github.com/selvakumar3/tridots/blob/main/myproject/webapp/urls.py): `myproject/webapp/urls.py`
- [Portal views](https://github.com/selvakumar3/tridots/blob/main/myproject/webapp/views.py): `myproject/webapp/views.py`

### Authentication API

- [API routes](https://github.com/selvakumar3/tridots/blob/main/myproject/apiapp/urls.py): `myproject/apiapp/urls.py`
- [Auth handlers](https://github.com/selvakumar3/tridots/blob/main/myproject/apiapp/views.py): `myproject/apiapp/views.py`
- [Auth validation](https://github.com/selvakumar3/tridots/blob/main/myproject/apiapp/serializers.py): `myproject/apiapp/serializers.py`

### Domain and persistence

- [Reference data setup](https://github.com/selvakumar3/tridots/blob/main/myproject/apiapp/bulk_creation.py): `myproject/apiapp/bulk_creation.py`
- [User and status models](https://github.com/selvakumar3/tridots/blob/main/myproject/apiapp/models.py): `myproject/apiapp/models.py`
- [API and query helpers](https://github.com/selvakumar3/tridots/blob/main/myproject/apiapp/utils.py): `myproject/apiapp/utils.py`

### Other components

- **Portal user**

## Connections

- Portal user → Web routes: opens pages (evidence: `myproject/webapp/urls.py`)
- Web routes → Portal views: routes requests (evidence: `myproject/webapp/urls.py`)
- Portal views → Auth handlers: HTTP auth (evidence: `myproject/webapp/views.py`)
- API routes → Auth handlers: routes endpoints (evidence: `myproject/apiapp/urls.py`)
- Auth handlers → Auth validation: validates data (evidence: `myproject/apiapp/views.py`)
- Auth handlers → User and status models: queries users (evidence: `myproject/apiapp/views.py`)
- Auth handlers → Reference data setup: initializes data (evidence: `myproject/apiapp/views.py`)
- Auth validation → User and status models: validates and saves (evidence: `myproject/apiapp/serializers.py`)
- Reference data setup → User and status models: bulk creates (evidence: `myproject/apiapp/bulk_creation.py`)
- Auth handlers → API and query helpers: uses helpers (evidence: `myproject/apiapp/views.py`)
- API and query helpers → User and status models: queries models (evidence: `myproject/apiapp/utils.py`)
