# hariomlokhande-coder/chatapp architecture

> Architecture diagram of the GitHub repository hariomlokhande-coder/chatapp, 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/hariomlokhande-coder/chatapp
- Repository: https://github.com/hariomlokhande-coder/chatapp

## Overview

ChatApp is a real-time messaging product with legacy browser UI and a modern Angular client. The main workflow is authenticated users sending private or group messages through SignalR, with chat state persisted in SQL Server and live events delivered to connected clients. REST controllers provide authentication, user, and group management; the hub handles presence, delivery, read tracking, and call signaling. README capabilities supplement sampled implementation details; links for unsampled frontend and API behavior are omitted where call paths cannot be verified.

Main entry points: [`ChatApp.Infrastructure/Data/AppDbContext.cs`](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Infrastructure/Data/AppDbContext.cs) (EF data context), [`ChatApp.API/Hubs/ChatHub.cs`](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/Hubs/ChatHub.cs) (SignalR chat hub), [`ChatApp.API/Program.cs`](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/Program.cs) (Application startup), [`ChatApp.API/wwwroot/js/main.js`](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/wwwroot/js/main.js) (Legacy chat UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User clients"]
  node_legacy["Legacy chat UI<br/>[main.js]"]
  node_legacycore["Legacy chat actions<br/>[chat-core.js]"]
  node_legacystate["Legacy client state<br/>[state.js]"]
  node_angular["Angular chat app<br/>[chat.ts]"]
  node_angularroutes["Auth routing<br/>[app.routes.ts]"]
  node_authui["Login and register<br/>[login.ts]"]
  node_chatservices["Chat client services<br/>[chat.ts]"]
  node_calls["Video call client<br/>[video-call.ts]"]
end

subgraph group_delivery["API delivery"]
  node_program["Application startup<br/>[Program.cs]"]
  node_authapi["Authentication API<br/>[AuthController.cs]"]
  node_chatapi["Chat REST API<br/>[ChatController.cs]"]
  node_groupapi["Group management API<br/>[GroupController.cs]"]
  node_userapi["User API<br/>[UserController.cs]"]
  node_hub["SignalR chat hub<br/>[ChatHub.cs]"]
  node_ratelimit["Request throttling"]
end

subgraph group_domain["Chat domain"]
  node_connections["Connection tracking"]
  node_sanitize["Input sanitizing<br/>[InputSanitizer.cs]"]
  node_contracts["Chat contracts<br/>[ChatDTOs.cs]"]
  node_entities["Chat and user records<br/>[Message.cs]"]
  node_groups["Group membership<br/>[GroupMember.cs]"]
  node_readnotify["Reads and notifications"]
  node_tokens["Refresh tokens<br/>[RefreshToken.cs]"]
end

subgraph group_persistence["Persistence"]
  node_dbcontext[("EF data context<br/>[AppDbContext.cs]")]
  node_sql[("SQL Server")]
end

node_person(("Chat user"))

node_person -->|"uses"| node_legacy
node_legacy -->|"invokes"| node_legacycore
node_legacy -->|"reads state"| node_legacystate
node_legacycore -->|"updates state"| node_legacystate
node_person -->|"opens app"| node_angularroutes
node_angularroutes -->|"routes guests"| node_authui
node_angularroutes -->|"routes signed-in"| node_angular
node_angular -.->|"uses"| node_chatservices
node_chatservices -.->|"connects"| node_hub
node_calls -.->|"signals calls"| node_hub
node_program -->|"configures"| node_dbcontext
node_program -->|"maps hub"| node_hub
node_program -->|"registers"| node_connections
node_program -->|"registers"| node_sanitize
node_program -->|"uses middleware"| node_ratelimit
node_authapi -->|"reads/writes"| node_dbcontext
node_chatapi -->|"reads/writes"| node_dbcontext
node_groupapi -->|"reads/writes"| node_dbcontext
node_userapi -->|"reads/writes"| node_dbcontext
node_hub -->|"reads/writes"| node_dbcontext
node_hub -->|"tracks sessions"| node_connections
node_hub -->|"uses contracts"| node_contracts
node_groupapi -.->|"uses hub services"| node_hub
node_dbcontext -->|"persists"| node_sql
node_dbcontext -->|"maps records"| node_entities
node_dbcontext -->|"maps records"| node_groups
node_dbcontext -->|"maps records"| node_readnotify
node_dbcontext -->|"maps records"| node_tokens
node_hub -->|"updates receipts"| node_readnotify

click node_legacy "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/wwwroot/js/main.js"
click node_legacycore "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/wwwroot/js/chat-core.js"
click node_legacystate "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/wwwroot/js/state.js"
click node_angular "https://github.com/hariomlokhande-coder/chatapp/blob/main/frontend/src/app/features/chat/pages/chat/chat.ts"
click node_angularroutes "https://github.com/hariomlokhande-coder/chatapp/blob/main/frontend/src/app/app.routes.ts"
click node_authui "https://github.com/hariomlokhande-coder/chatapp/blob/main/frontend/src/app/features/auth/pages/login/login.ts"
click node_chatservices "https://github.com/hariomlokhande-coder/chatapp/blob/main/frontend/src/app/core/services/chat.ts"
click node_calls "https://github.com/hariomlokhande-coder/chatapp/blob/main/frontend/src/app/core/services/video-call.ts"
click node_program "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/Program.cs"
click node_authapi "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/controllers/AuthController.cs"
click node_chatapi "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/controllers/ChatController.cs"
click node_groupapi "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/controllers/GroupController.cs"
click node_userapi "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/controllers/UserController.cs"
click node_hub "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/Hubs/ChatHub.cs"
click node_ratelimit "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/Middleware/RateLimitingMiddleware.cs"
click node_connections "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Application/Services/ConnectionManager.cs"
click node_sanitize "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Application/Services/InputSanitizer.cs"
click node_contracts "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Application/DTOs/ChatDTOs.cs"
click node_entities "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Domain/Entities/Message.cs"
click node_groups "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Domain/Entities/GroupMember.cs"
click node_readnotify "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Domain/Entities/MessageReadStatus.cs"
click node_tokens "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Domain/Entities/RefreshToken.cs"
click node_dbcontext "https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Infrastructure/Data/AppDbContext.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_legacy,node_legacycore,node_legacystate,node_angular,node_angularroutes,node_authui,node_chatservices,node_calls,node_person toneBlue
class node_program,node_authapi,node_chatapi,node_groupapi,node_userapi,node_hub,node_ratelimit toneAmber
class node_connections,node_sanitize,node_contracts,node_entities,node_groups,node_readnotify,node_tokens toneMint
class node_dbcontext,node_sql toneRose
```

## Components

### User clients

- [Legacy chat UI](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/wwwroot/js/main.js): `ChatApp.API/wwwroot/js/main.js`
- [Legacy chat actions](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/wwwroot/js/chat-core.js): `ChatApp.API/wwwroot/js/chat-core.js`
- [Legacy client state](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/wwwroot/js/state.js): `ChatApp.API/wwwroot/js/state.js`
- [Angular chat app](https://github.com/hariomlokhande-coder/chatapp/blob/main/frontend/src/app/features/chat/pages/chat/chat.ts): `frontend/src/app/features/chat/pages/chat/chat.ts`
- [Auth routing](https://github.com/hariomlokhande-coder/chatapp/blob/main/frontend/src/app/app.routes.ts): `frontend/src/app/app.routes.ts`
- [Login and register](https://github.com/hariomlokhande-coder/chatapp/blob/main/frontend/src/app/features/auth/pages/login/login.ts): `frontend/src/app/features/auth/pages/login/login.ts`
- [Chat client services](https://github.com/hariomlokhande-coder/chatapp/blob/main/frontend/src/app/core/services/chat.ts): `frontend/src/app/core/services/chat.ts`
- [Video call client](https://github.com/hariomlokhande-coder/chatapp/blob/main/frontend/src/app/core/services/video-call.ts): `frontend/src/app/core/services/video-call.ts`

### API delivery

- [Application startup](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/Program.cs): `ChatApp.API/Program.cs`
- [Authentication API](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/controllers/AuthController.cs): `ChatApp.API/controllers/AuthController.cs`
- [Chat REST API](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/controllers/ChatController.cs): `ChatApp.API/controllers/ChatController.cs`
- [Group management API](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/controllers/GroupController.cs): `ChatApp.API/controllers/GroupController.cs`
- [User API](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/controllers/UserController.cs): `ChatApp.API/controllers/UserController.cs`
- [SignalR chat hub](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/Hubs/ChatHub.cs): `ChatApp.API/Hubs/ChatHub.cs`
- [Request throttling](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.API/Middleware/RateLimitingMiddleware.cs): `ChatApp.API/Middleware/RateLimitingMiddleware.cs`

### Chat domain

- [Connection tracking](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Application/Services/ConnectionManager.cs): `ChatApp.Application/Services/ConnectionManager.cs`
- [Input sanitizing](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Application/Services/InputSanitizer.cs): `ChatApp.Application/Services/InputSanitizer.cs`
- [Chat contracts](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Application/DTOs/ChatDTOs.cs): `ChatApp.Application/DTOs/ChatDTOs.cs`
- [Chat and user records](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Domain/Entities/Message.cs): `ChatApp.Domain/Entities/Message.cs`
- [Group membership](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Domain/Entities/GroupMember.cs): `ChatApp.Domain/Entities/GroupMember.cs`
- [Reads and notifications](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Domain/Entities/MessageReadStatus.cs): `ChatApp.Domain/Entities/MessageReadStatus.cs`
- [Refresh tokens](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Domain/Entities/RefreshToken.cs): `ChatApp.Domain/Entities/RefreshToken.cs`

### Persistence

- [EF data context](https://github.com/hariomlokhande-coder/chatapp/blob/main/ChatApp.Infrastructure/Data/AppDbContext.cs): `ChatApp.Infrastructure/Data/AppDbContext.cs`
- **SQL Server**

### Other components

- **Chat user**

## Connections

- Chat user → Legacy chat UI: uses (evidence: `ChatApp.API/wwwroot/js/main.js`)
- Legacy chat UI → Legacy chat actions: invokes (evidence: `ChatApp.API/wwwroot/js/main.js`)
- Legacy chat UI → Legacy client state: reads state (evidence: `ChatApp.API/wwwroot/js/main.js`)
- Legacy chat actions → Legacy client state: updates state (evidence: `ChatApp.API/wwwroot/js/chat-core.js`)
- Chat user → Auth routing: opens app (evidence: `frontend/src/app/app.routes.ts`)
- Auth routing → Login and register: routes guests (evidence: `frontend/src/app/app.routes.ts`)
- Auth routing → Angular chat app: routes signed-in (evidence: `frontend/src/app/app.routes.ts`)
- Angular chat app → Chat client services: uses
- Chat client services → SignalR chat hub: connects
- Video call client → SignalR chat hub: signals calls
- Application startup → EF data context: configures (evidence: `ChatApp.API/Program.cs`)
- Application startup → SignalR chat hub: maps hub (evidence: `ChatApp.API/Program.cs`)
- Application startup → Connection tracking: registers (evidence: `ChatApp.API/Program.cs`)
- Application startup → Input sanitizing: registers (evidence: `ChatApp.API/Program.cs`)
- Application startup → Request throttling: uses middleware (evidence: `ChatApp.API/Program.cs`)
- Authentication API → EF data context: reads/writes (evidence: `ChatApp.API/controllers/AuthController.cs`)
- Chat REST API → EF data context: reads/writes (evidence: `ChatApp.API/controllers/ChatController.cs`)
- Group management API → EF data context: reads/writes (evidence: `ChatApp.API/controllers/GroupController.cs`)
- User API → EF data context: reads/writes (evidence: `ChatApp.API/controllers/UserController.cs`)
- SignalR chat hub → EF data context: reads/writes (evidence: `ChatApp.API/Hubs/ChatHub.cs`)
- SignalR chat hub → Connection tracking: tracks sessions (evidence: `ChatApp.API/Hubs/ChatHub.cs`)
- SignalR chat hub → Chat contracts: uses contracts (evidence: `ChatApp.API/Hubs/ChatHub.cs`)
- Group management API → SignalR chat hub: uses hub services (evidence: `ChatApp.API/controllers/GroupController.cs`)
- EF data context → SQL Server: persists
- EF data context → Chat and user records: maps records (evidence: `ChatApp.Infrastructure/Data/AppDbContext.cs`)
- EF data context → Group membership: maps records (evidence: `ChatApp.Infrastructure/Data/AppDbContext.cs`)
- EF data context → Reads and notifications: maps records (evidence: `ChatApp.Infrastructure/Data/AppDbContext.cs`)
- EF data context → Refresh tokens: maps records (evidence: `ChatApp.Infrastructure/Data/AppDbContext.cs`)
- SignalR chat hub → Reads and notifications: updates receipts (evidence: `ChatApp.API/Hubs/ChatHub.cs`)
