# sukanta116/url_shortner_api architecture

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

- Interactive diagram: https://gitdiagram.com/sukanta116/url_shortner_api
- Repository: https://github.com/sukanta116/url_shortner_api

## Overview

Linkora is a URL-shortening web application. Users register or log in, then reach an authenticated dashboard to create and review short links; visiting a short-link path looks up the saved destination and redirects the visitor. The server also validates account input, issues and verifies signed JWT cookies, and persists users, links, and the ID counter through Mongoose models. The graph follows the sampled routes and calls; README documentation was not provided, so unsampled capabilities are not inferred.

Main entry points: [`app.js`](https://github.com/sukanta116/url_shortner_api/blob/main/app.js) (Express routes), [`controllers/urlMaker.js`](https://github.com/sukanta116/url_shortner_api/blob/main/controllers/urlMaker.js) (Short-link controller), [`views/script.js`](https://github.com/sukanta116/url_shortner_api/blob/main/views/script.js) (Login and register UI), [`views/dashboard.js`](https://github.com/sukanta116/url_shortner_api/blob/main/views/dashboard.js) (Dashboard UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser experience"]
  node_login_ui["Login and register UI<br/>[script.js]"]
  node_dashboard_ui["Dashboard UI<br/>[dashboard.js]"]
end

subgraph group_server["HTTP and identity"]
  node_app["Express routes<br/>[app.js]"]
  node_login_validation["Login validation<br/>[loginValidation.js]"]
  node_register_validation["Registration validation<br/>[userValidation.js]"]
  node_auth_controller["Account controllers<br/>[auth.js]"]
  node_auth_middleware["Cookie authentication<br/>[authenticate.js]"]
end

subgraph group_links["Short-link operations"]
  node_url_controller["Short-link controller<br/>[urlMaker.js]"]
end

subgraph group_data["Persistent records"]
  node_user_model[("User records<br/>[User.js]")]
  node_link_model[("Link records<br/>[Link.js]")]
  node_counter_model[("ID counter<br/>[Counter.js]")]
end

node_browser(("Browser"))

node_browser -->|"uses"| node_login_ui
node_browser -->|"uses"| node_dashboard_ui
node_login_ui -->|"posts auth requests"| node_app
node_dashboard_ui -->|"requests dashboard data"| node_app
node_app -->|"serves home page"| node_login_ui
node_app -->|"serves dashboard"| node_dashboard_ui
node_app -->|"runs login checks"| node_login_validation
node_app -->|"runs registration checks"| node_register_validation
node_app -->|"dispatches auth routes"| node_auth_controller
node_app -->|"guards private routes"| node_auth_middleware
node_app -->|"dispatches link routes"| node_url_controller
node_login_validation -->|"checks account"| node_user_model
node_register_validation -->|"checks account"| node_user_model
node_auth_controller -->|"creates and finds users"| node_user_model
node_url_controller -->|"increments ID"| node_counter_model
node_url_controller -->|"stores and looks up links"| node_link_model

click node_app "https://github.com/sukanta116/url_shortner_api/blob/main/app.js"
click node_login_ui "https://github.com/sukanta116/url_shortner_api/blob/main/views/script.js"
click node_dashboard_ui "https://github.com/sukanta116/url_shortner_api/blob/main/views/dashboard.js"
click node_login_validation "https://github.com/sukanta116/url_shortner_api/blob/main/midlewares/loginValidation.js"
click node_register_validation "https://github.com/sukanta116/url_shortner_api/blob/main/midlewares/userValidation.js"
click node_auth_controller "https://github.com/sukanta116/url_shortner_api/blob/main/controllers/auth.js"
click node_auth_middleware "https://github.com/sukanta116/url_shortner_api/blob/main/midlewares/authenticate.js"
click node_url_controller "https://github.com/sukanta116/url_shortner_api/blob/main/controllers/urlMaker.js"
click node_user_model "https://github.com/sukanta116/url_shortner_api/blob/main/models/User.js"
click node_link_model "https://github.com/sukanta116/url_shortner_api/blob/main/models/Link.js"
click node_counter_model "https://github.com/sukanta116/url_shortner_api/blob/main/models/Counter.js"

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_login_ui,node_dashboard_ui,node_browser toneBlue
class node_app,node_login_validation,node_register_validation,node_auth_controller,node_auth_middleware toneAmber
class node_url_controller toneMint
class node_user_model,node_link_model,node_counter_model toneRose
```

## Components

### Browser experience

- [Login and register UI](https://github.com/sukanta116/url_shortner_api/blob/main/views/script.js): `views/script.js`
- [Dashboard UI](https://github.com/sukanta116/url_shortner_api/blob/main/views/dashboard.js): `views/dashboard.js`

### HTTP and identity

- [Express routes](https://github.com/sukanta116/url_shortner_api/blob/main/app.js): `app.js`
- [Login validation](https://github.com/sukanta116/url_shortner_api/blob/main/midlewares/loginValidation.js): `midlewares/loginValidation.js`
- [Registration validation](https://github.com/sukanta116/url_shortner_api/blob/main/midlewares/userValidation.js): `midlewares/userValidation.js`
- [Account controllers](https://github.com/sukanta116/url_shortner_api/blob/main/controllers/auth.js): `controllers/auth.js`
- [Cookie authentication](https://github.com/sukanta116/url_shortner_api/blob/main/midlewares/authenticate.js): `midlewares/authenticate.js`

### Short-link operations

- [Short-link controller](https://github.com/sukanta116/url_shortner_api/blob/main/controllers/urlMaker.js): `controllers/urlMaker.js`

### Persistent records

- [User records](https://github.com/sukanta116/url_shortner_api/blob/main/models/User.js): `models/User.js`
- [Link records](https://github.com/sukanta116/url_shortner_api/blob/main/models/Link.js): `models/Link.js`
- [ID counter](https://github.com/sukanta116/url_shortner_api/blob/main/models/Counter.js): `models/Counter.js`

### Other components

- **Browser**

## Connections

- Browser → Login and register UI: uses (evidence: `views/script.js`)
- Browser → Dashboard UI: uses (evidence: `views/dashboard.js`)
- Login and register UI → Express routes: posts auth requests (evidence: `views/script.js`)
- Dashboard UI → Express routes: requests dashboard data (evidence: `views/dashboard.js`)
- Express routes → Login and register UI: serves home page (evidence: `app.js`)
- Express routes → Dashboard UI: serves dashboard (evidence: `app.js`)
- Express routes → Login validation: runs login checks (evidence: `app.js`)
- Express routes → Registration validation: runs registration checks (evidence: `app.js`)
- Express routes → Account controllers: dispatches auth routes (evidence: `app.js`)
- Express routes → Cookie authentication: guards private routes (evidence: `app.js`)
- Express routes → Short-link controller: dispatches link routes (evidence: `app.js`)
- Login validation → User records: checks account (evidence: `midlewares/loginValidation.js`)
- Registration validation → User records: checks account (evidence: `midlewares/userValidation.js`)
- Account controllers → User records: creates and finds users (evidence: `controllers/auth.js`)
- Short-link controller → ID counter: increments ID (evidence: `controllers/urlMaker.js`)
- Short-link controller → Link records: stores and looks up links (evidence: `controllers/urlMaker.js`)
