# ad668/chatapplication architecture

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

- Interactive diagram: https://gitdiagram.com/ad668/chatapplication
- Repository: https://github.com/ad668/chatapplication

## Overview

This repository implements a browser-based chat application with an ASP.NET API. Users register or log in, then enter an authenticated chat interface for conversations, online-user presence, typing notifications, and message history. The backend serves account operations and a SignalR hub; the hub coordinates users and messages while persisting chat history through Entity Framework. The client’s chat service implementation was not sampled, so its detailed calls and realtime event wiring are not asserted; the API’s hub behavior and documented client component dependencies are shown where supported.

Main entry points: [`Client/src/app/app.routes.ts`](https://github.com/ad668/chatapplication/blob/main/Client/src/app/app.routes.ts) (App routes), [`API/Endpoints/AccountEndPoint.cs`](https://github.com/ad668/chatapplication/blob/main/API/Endpoints/AccountEndPoint.cs) (Account endpoints), [`API/Hubs/ChatHubs.cs`](https://github.com/ad668/chatapplication/blob/main/API/Hubs/ChatHubs.cs) (Chat hub), [`Client/src/app/services/auth-services.ts`](https://github.com/ad668/chatapplication/blob/main/Client/src/app/services/auth-services.ts) (Auth service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular client"]
  node_app["App shell<br/>[app.ts]"]
  node_routes["App routes<br/>[app.routes.ts]"]
  node_login["Login form<br/>[login.ts]"]
  node_register["Registration form<br/>[register.ts]"]
  node_authguards["Auth guards<br/>[auth.guard.ts]"]
  node_authclient["Auth service<br/>[auth-services.ts]"]
  node_chatview["Chat view<br/>[chat.ts]"]
  node_sidebar["User sidebar<br/>[chat-sidebar.ts]"]
  node_chatwindow["Chat window<br/>[chat-window.ts]"]
  node_chatbox["Message composer<br/>[chat-box.ts]"]
  node_rightsidebar["Chat details"]
  node_typing["Typing indicator"]
  node_chatclient["Chat service<br/>[chat.ts]"]
end

subgraph group_account["Account and identity"]
  node_accountapi["Account endpoints<br/>[AccountEndPoint.cs]"]
  node_tokens["JWT service<br/>[TokenService.cs]"]
  node_uploads["Profile upload<br/>[FileUpload.cs]"]
end

subgraph group_messaging["Realtime messaging"]
  node_hub["Chat hub<br/>[ChatHubs.cs]"]
end

subgraph group_data["Persistence and models"]
  node_dbcontext["EF context<br/>[AppDbContext.cs]"]
  node_users["User identity<br/>[AppUser.cs]"]
  node_messages["Chat messages<br/>[Message.cs]"]
  node_database[("SQL database")]
end

node_visitor(("Chat user"))
node_host["API host<br/>[Program.cs]"]

node_visitor -->|"uses"| node_app
node_app -->|"hosts"| node_routes
node_routes -->|"routes to"| node_login
node_routes -->|"routes to"| node_register
node_routes -->|"routes to"| node_chatview
node_routes -->|"guards"| node_authguards
node_login -->|"uses"| node_authclient
node_register -->|"uses"| node_authclient
node_authguards -->|"checks session"| node_authclient
node_authclient -->|"HTTP requests"| node_accountapi
node_chatview -->|"renders"| node_sidebar
node_chatview -->|"renders"| node_chatwindow
node_chatview -->|"renders"| node_rightsidebar
node_sidebar -->|"uses"| node_chatclient
node_sidebar -->|"uses"| node_authclient
node_sidebar -->|"renders"| node_typing
node_chatwindow -->|"uses"| node_chatclient
node_chatwindow -->|"renders"| node_chatbox
node_chatbox -->|"uses"| node_chatclient
node_host -->|"maps routes"| node_accountapi
node_host -->|"maps hub"| node_hub
node_accountapi -->|"generates token"| node_tokens
node_accountapi -->|"uploads image"| node_uploads
node_accountapi -->|"manages identity"| node_users
node_hub -->|"reads and writes"| node_dbcontext
node_hub -->|"looks up users"| node_users
node_hub -->|"persists messages"| node_messages
node_dbcontext -->|"maps identity"| node_users
node_dbcontext -->|"stores messages"| node_messages
node_dbcontext -->|"persists data"| node_database
node_chatclient -.->|"realtime transport"| node_hub

click node_app "https://github.com/ad668/chatapplication/blob/main/Client/src/app/app.ts"
click node_routes "https://github.com/ad668/chatapplication/blob/main/Client/src/app/app.routes.ts"
click node_login "https://github.com/ad668/chatapplication/blob/main/Client/src/app/login/login.ts"
click node_register "https://github.com/ad668/chatapplication/blob/main/Client/src/app/register/register.ts"
click node_authguards "https://github.com/ad668/chatapplication/blob/main/Client/src/app/guards/auth.guard.ts"
click node_authclient "https://github.com/ad668/chatapplication/blob/main/Client/src/app/services/auth-services.ts"
click node_chatview "https://github.com/ad668/chatapplication/blob/main/Client/src/app/chat/chat.ts"
click node_sidebar "https://github.com/ad668/chatapplication/blob/main/Client/src/app/chat-sidebar/chat-sidebar.ts"
click node_chatwindow "https://github.com/ad668/chatapplication/blob/main/Client/src/app/components/chat-window/chat-window.ts"
click node_chatbox "https://github.com/ad668/chatapplication/blob/main/Client/src/app/components/chat-box/chat-box.ts"
click node_rightsidebar "https://github.com/ad668/chatapplication/blob/main/Client/src/app/components/chat-right-sidebar/chat-right-sidebar.ts"
click node_typing "https://github.com/ad668/chatapplication/blob/main/Client/src/app/components/typing-indicator/typing-indicator.ts"
click node_chatclient "https://github.com/ad668/chatapplication/blob/main/Client/src/app/services/chat.ts"
click node_accountapi "https://github.com/ad668/chatapplication/blob/main/API/Endpoints/AccountEndPoint.cs"
click node_tokens "https://github.com/ad668/chatapplication/blob/main/API/Services/TokenService.cs"
click node_uploads "https://github.com/ad668/chatapplication/blob/main/API/Services/FileUpload.cs"
click node_hub "https://github.com/ad668/chatapplication/blob/main/API/Hubs/ChatHubs.cs"
click node_dbcontext "https://github.com/ad668/chatapplication/blob/main/API/Data/AppDbContext.cs"
click node_users "https://github.com/ad668/chatapplication/blob/main/API/Model/AppUser.cs"
click node_messages "https://github.com/ad668/chatapplication/blob/main/API/Model/Message.cs"
click node_host "https://github.com/ad668/chatapplication/blob/main/API/Program.cs"

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_app,node_routes,node_login,node_register,node_authguards,node_authclient,node_chatview,node_sidebar,node_chatwindow,node_chatbox,node_rightsidebar,node_typing,node_chatclient,node_visitor toneBlue
class node_accountapi,node_tokens,node_uploads toneAmber
class node_hub,node_host toneMint
class node_dbcontext,node_users,node_messages,node_database toneRose
```

## Components

### Angular client

- [App shell](https://github.com/ad668/chatapplication/blob/main/Client/src/app/app.ts): `Client/src/app/app.ts`
- [App routes](https://github.com/ad668/chatapplication/blob/main/Client/src/app/app.routes.ts): `Client/src/app/app.routes.ts`
- [Login form](https://github.com/ad668/chatapplication/blob/main/Client/src/app/login/login.ts): `Client/src/app/login/login.ts`
- [Registration form](https://github.com/ad668/chatapplication/blob/main/Client/src/app/register/register.ts): `Client/src/app/register/register.ts`
- [Auth guards](https://github.com/ad668/chatapplication/blob/main/Client/src/app/guards/auth.guard.ts): `Client/src/app/guards/auth.guard.ts`
- [Auth service](https://github.com/ad668/chatapplication/blob/main/Client/src/app/services/auth-services.ts): `Client/src/app/services/auth-services.ts`
- [Chat view](https://github.com/ad668/chatapplication/blob/main/Client/src/app/chat/chat.ts): `Client/src/app/chat/chat.ts`
- [User sidebar](https://github.com/ad668/chatapplication/blob/main/Client/src/app/chat-sidebar/chat-sidebar.ts): `Client/src/app/chat-sidebar/chat-sidebar.ts`
- [Chat window](https://github.com/ad668/chatapplication/blob/main/Client/src/app/components/chat-window/chat-window.ts): `Client/src/app/components/chat-window/chat-window.ts`
- [Message composer](https://github.com/ad668/chatapplication/blob/main/Client/src/app/components/chat-box/chat-box.ts): `Client/src/app/components/chat-box/chat-box.ts`
- [Chat details](https://github.com/ad668/chatapplication/blob/main/Client/src/app/components/chat-right-sidebar/chat-right-sidebar.ts): `Client/src/app/components/chat-right-sidebar/chat-right-sidebar.ts`
- [Typing indicator](https://github.com/ad668/chatapplication/blob/main/Client/src/app/components/typing-indicator/typing-indicator.ts): `Client/src/app/components/typing-indicator/typing-indicator.ts`
- [Chat service](https://github.com/ad668/chatapplication/blob/main/Client/src/app/services/chat.ts): `Client/src/app/services/chat.ts`

### Account and identity

- [Account endpoints](https://github.com/ad668/chatapplication/blob/main/API/Endpoints/AccountEndPoint.cs): `API/Endpoints/AccountEndPoint.cs`
- [JWT service](https://github.com/ad668/chatapplication/blob/main/API/Services/TokenService.cs): `API/Services/TokenService.cs`
- [Profile upload](https://github.com/ad668/chatapplication/blob/main/API/Services/FileUpload.cs): `API/Services/FileUpload.cs`

### Realtime messaging

- [Chat hub](https://github.com/ad668/chatapplication/blob/main/API/Hubs/ChatHubs.cs): `API/Hubs/ChatHubs.cs`

### Persistence and models

- [EF context](https://github.com/ad668/chatapplication/blob/main/API/Data/AppDbContext.cs): `API/Data/AppDbContext.cs`
- [User identity](https://github.com/ad668/chatapplication/blob/main/API/Model/AppUser.cs): `API/Model/AppUser.cs`
- [Chat messages](https://github.com/ad668/chatapplication/blob/main/API/Model/Message.cs): `API/Model/Message.cs`
- **SQL database**

### Other components

- **Chat user**
- [API host](https://github.com/ad668/chatapplication/blob/main/API/Program.cs): `API/Program.cs`

## Connections

- Chat user → App shell: uses
- App shell → App routes: hosts
- App routes → Login form: routes to (evidence: `Client/src/app/app.routes.ts`)
- App routes → Registration form: routes to (evidence: `Client/src/app/app.routes.ts`)
- App routes → Chat view: routes to (evidence: `Client/src/app/app.routes.ts`)
- App routes → Auth guards: guards (evidence: `Client/src/app/app.routes.ts`)
- Login form → Auth service: uses (evidence: `Client/src/app/login/login.ts`)
- Registration form → Auth service: uses (evidence: `Client/src/app/register/register.ts`)
- Auth guards → Auth service: checks session (evidence: `Client/src/app/guards/auth.guard.ts`)
- Auth service → Account endpoints: HTTP requests (evidence: `Client/src/app/services/auth-services.ts`)
- Chat view → User sidebar: renders (evidence: `Client/src/app/chat/chat.ts`)
- Chat view → Chat window: renders (evidence: `Client/src/app/chat/chat.ts`)
- Chat view → Chat details: renders (evidence: `Client/src/app/chat/chat.ts`)
- User sidebar → Chat service: uses (evidence: `Client/src/app/chat-sidebar/chat-sidebar.ts`)
- User sidebar → Auth service: uses (evidence: `Client/src/app/chat-sidebar/chat-sidebar.ts`)
- User sidebar → Typing indicator: renders (evidence: `Client/src/app/chat-sidebar/chat-sidebar.ts`)
- Chat window → Chat service: uses (evidence: `Client/src/app/components/chat-window/chat-window.ts`)
- Chat window → Message composer: renders (evidence: `Client/src/app/components/chat-window/chat-window.ts`)
- Message composer → Chat service: uses (evidence: `Client/src/app/components/chat-box/chat-box.ts`)
- API host → Account endpoints: maps routes (evidence: `API/Program.cs`)
- API host → Chat hub: maps hub (evidence: `API/Program.cs`)
- Account endpoints → JWT service: generates token (evidence: `API/Endpoints/AccountEndPoint.cs`)
- Account endpoints → Profile upload: uploads image (evidence: `API/Endpoints/AccountEndPoint.cs`)
- Account endpoints → User identity: manages identity (evidence: `API/Endpoints/AccountEndPoint.cs`)
- Chat hub → EF context: reads and writes (evidence: `API/Hubs/ChatHubs.cs`)
- Chat hub → User identity: looks up users (evidence: `API/Hubs/ChatHubs.cs`)
- Chat hub → Chat messages: persists messages (evidence: `API/Hubs/ChatHubs.cs`)
- EF context → User identity: maps identity (evidence: `API/Data/AppDbContext.cs`)
- EF context → Chat messages: stores messages (evidence: `API/Data/AppDbContext.cs`)
- EF context → SQL database: persists data
- Chat service → Chat hub: realtime transport
