# personaldevworks/myloginbackend architecture

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

- Interactive diagram: https://gitdiagram.com/personaldevworks/myloginbackend
- Repository: https://github.com/personaldevworks/myloginbackend

## Overview

MyLoginApp is an Express API for login and registration, with user-management endpoints backed by SQL Server. The principal flow is HTTP requests through the Express app and routes to controllers, which validate credentials or user data, access the database, and return JSON; login also issues a JWT used to protect user listing. The shown source supports these links. The README describes the frontend/API relationship, but no frontend implementation is in this repository.

Main entry points: [`src/index.ts`](https://github.com/personaldevworks/myloginbackend/blob/main/src/index.ts) (Express app), [`src/db.ts`](https://github.com/personaldevworks/myloginbackend/blob/main/src/db.ts) (SQL connection), [`src/routes/userRoutes.ts`](https://github.com/personaldevworks/myloginbackend/blob/main/src/routes/userRoutes.ts) (User routes), [`src/server.ts`](https://github.com/personaldevworks/myloginbackend/blob/main/src/server.ts) (Server startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP API"]
  node_server["Server startup<br/>[server.ts]"]
  node_app["Express app<br/>[index.ts]"]
  node_auth_routes["Auth routes<br/>[authRoutes.ts]"]
  node_user_routes["User routes<br/>[userRoutes.ts]"]
end

subgraph group_identity["Identity and Users"]
  node_auth_controller["Login handler<br/>[authController.ts]"]
  node_user_controller["User handlers<br/>[userController.ts]"]
  node_token_middleware["Token verification<br/>[authMiddleware.ts]"]
end

subgraph group_persistence["Persistence"]
  node_sql_helper["SQL connection<br/>[db.ts]"]
  node_sqlserver[("SQL Server")]
end

node_client(("API client"))

node_server -->|"starts"| node_app
node_server -->|"checks connection"| node_sql_helper
node_client -.->|"sends requests"| node_app
node_app -->|"mounts auth"| node_auth_routes
node_app -->|"mounts users"| node_user_routes
node_auth_routes -->|"dispatches login"| node_auth_controller
node_user_routes -->|"dispatches users"| node_user_controller
node_user_routes -->|"protects listing"| node_token_middleware
node_auth_controller -->|"queries users"| node_sql_helper
node_user_controller -->|"reads and writes"| node_sql_helper
node_sql_helper -->|"connects"| node_sqlserver

click node_server "https://github.com/personaldevworks/myloginbackend/blob/main/src/server.ts"
click node_app "https://github.com/personaldevworks/myloginbackend/blob/main/src/index.ts"
click node_auth_routes "https://github.com/personaldevworks/myloginbackend/blob/main/src/routes/authRoutes.ts"
click node_user_routes "https://github.com/personaldevworks/myloginbackend/blob/main/src/routes/userRoutes.ts"
click node_auth_controller "https://github.com/personaldevworks/myloginbackend/blob/main/src/controllers/authController.ts"
click node_user_controller "https://github.com/personaldevworks/myloginbackend/blob/main/src/controllers/userController.ts"
click node_token_middleware "https://github.com/personaldevworks/myloginbackend/blob/main/src/middleware/authMiddleware.ts"
click node_sql_helper "https://github.com/personaldevworks/myloginbackend/blob/main/src/db.ts"

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_server,node_app,node_auth_routes,node_user_routes,node_client toneBlue
class node_auth_controller,node_user_controller,node_token_middleware toneAmber
class node_sql_helper,node_sqlserver toneMint
```

## Components

### HTTP API

- [Server startup](https://github.com/personaldevworks/myloginbackend/blob/main/src/server.ts): `src/server.ts`
- [Express app](https://github.com/personaldevworks/myloginbackend/blob/main/src/index.ts): `src/index.ts`
- [Auth routes](https://github.com/personaldevworks/myloginbackend/blob/main/src/routes/authRoutes.ts): `src/routes/authRoutes.ts`
- [User routes](https://github.com/personaldevworks/myloginbackend/blob/main/src/routes/userRoutes.ts): `src/routes/userRoutes.ts`

### Identity and Users

- [Login handler](https://github.com/personaldevworks/myloginbackend/blob/main/src/controllers/authController.ts): `src/controllers/authController.ts`
- [User handlers](https://github.com/personaldevworks/myloginbackend/blob/main/src/controllers/userController.ts): `src/controllers/userController.ts`
- [Token verification](https://github.com/personaldevworks/myloginbackend/blob/main/src/middleware/authMiddleware.ts): `src/middleware/authMiddleware.ts`

### Persistence

- [SQL connection](https://github.com/personaldevworks/myloginbackend/blob/main/src/db.ts): `src/db.ts`
- **SQL Server**

### Other components

- **API client**

## Connections

- Server startup → Express app: starts (evidence: `src/server.ts`)
- Server startup → SQL connection: checks connection (evidence: `src/server.ts`)
- API client → Express app: sends requests (evidence: `README.md`)
- Express app → Auth routes: mounts auth (evidence: `src/index.ts`)
- Express app → User routes: mounts users (evidence: `src/index.ts`)
- Auth routes → Login handler: dispatches login (evidence: `src/routes/authRoutes.ts`)
- User routes → User handlers: dispatches users (evidence: `src/routes/userRoutes.ts`)
- User routes → Token verification: protects listing (evidence: `src/routes/userRoutes.ts`)
- Login handler → SQL connection: queries users (evidence: `src/controllers/authController.ts`)
- User handlers → SQL connection: reads and writes (evidence: `src/controllers/userController.ts`)
- SQL connection → SQL Server: connects (evidence: `src/db.ts`)
