# alirezaas23/api-with-jtw-example architecture

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

- Interactive diagram: https://gitdiagram.com/alirezaas23/api-with-jtw-example
- Repository: https://github.com/alirezaas23/api-with-jtw-example

## Overview

This ASP.NET Core 8 API provides JWT authentication and authenticated blog CRUD, with SQLite persistence and AutoMapper DTO conversion. The principal flow is an HTTP request through the configured API pipeline to authentication or blog controllers; blog operations delegate to repositories that use EF Core context sets. The README also identifies Serilog logging and HTTP PATCH support. Authentication details are only partly sampled, so the graph shows the repository lookup and configured bearer validation without assuming the exact token-creation sequence.

Main entry points: [`JWTTraining/Program.cs`](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Program.cs) (HTTP pipeline), [`JWTTraining/Controllers/BlogsController.cs`](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Controllers/BlogsController.cs) (Blog endpoints), [`JWTTraining/Context/DatabaseContext.cs`](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Context/DatabaseContext.cs) (EF Core context), [`JWTTraining/AutoMapperProfiles/BlogProfile.cs`](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/AutoMapperProfiles/BlogProfile.cs) (Blog mappings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_hosting["API hosting"]
  node_pipeline["HTTP pipeline<br/>[Program.cs]"]
end

subgraph group_identity["Identity and security"]
  node_auth["Authentication endpoint<br/>[AuthController.cs]"]
  node_authdto["Authentication request"]
  node_userrepo["User repository<br/>[UserRepository.cs]"]
  node_userinterface["User repository contract<br/>[IUserRepository.cs]"]
  node_bearer["JWT bearer validation<br/>[Program.cs]"]
end

subgraph group_blogs["Blog API"]
  node_blogsapi["Blog endpoints<br/>[BlogsController.cs]"]
  node_blogrepo["Blog repository<br/>[BlogRepository.cs]"]
  node_bloginterface["Blog repository contract<br/>[IBlogRepository.cs]"]
  node_adddto["Add blog request<br/>[AddBlogDto.cs]"]
  node_updatedto["Patch blog data<br/>[UpdateBlogDto.cs]"]
  node_blogdto["Blog response<br/>[BlogDto.cs]"]
  node_listdto["Blog list response<br/>[BlogsListDto.cs]"]
end

subgraph group_persistence["Persistence and models"]
  node_context["EF Core context<br/>[DatabaseContext.cs]"]
  node_blogentity["Blog entity<br/>[Blog.cs]"]
  node_userentity["User entity<br/>[User.cs]"]
  node_sqlite[("SQLite database")]
end

subgraph group_mapping["DTO mapping"]
  node_mapper["Blog mappings<br/>[BlogProfile.cs]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_pipeline
node_pipeline -.->|"routes requests"| node_auth
node_pipeline -->|"routes requests"| node_blogsapi
node_pipeline -->|"validates bearer"| node_bearer
node_auth -->|"looks up user"| node_userrepo
node_auth -->|"accepts request"| node_authdto
node_userrepo -->|"queries users"| node_context
node_userrepo -->|"returns user"| node_userentity
node_userrepo -->|"implements"| node_userinterface
node_blogsapi -->|"calls operations"| node_blogrepo
node_blogsapi -->|"accepts request"| node_adddto
node_blogsapi -->|"patches data"| node_updatedto
node_blogsapi -->|"returns mapped data"| node_blogdto
node_blogsapi -->|"returns mapped list"| node_listdto
node_blogrepo -->|"implements"| node_bloginterface
node_blogrepo -->|"queries and saves"| node_context
node_blogrepo -->|"reads and writes"| node_blogentity
node_mapper -->|"maps entities"| node_blogentity
node_mapper -->|"maps request"| node_adddto
node_mapper -->|"maps patch data"| node_updatedto
node_mapper -->|"maps response"| node_blogdto
node_mapper -->|"maps list"| node_listdto
node_context -->|"tracks blogs"| node_blogentity
node_context -->|"tracks users"| node_userentity
node_pipeline -->|"configures context"| node_context
node_pipeline -->|"registers repository"| node_blogrepo
node_pipeline -->|"registers repository"| node_userrepo
node_pipeline -->|"uses provider"| node_sqlite
node_context -.->|"persists records"| node_sqlite

click node_pipeline "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Program.cs"
click node_auth "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Controllers/AuthController.cs"
click node_authdto "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Dtos/Auth/AuthenticationRequestDto.cs"
click node_userrepo "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Services/UserRepository.cs"
click node_userinterface "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Interfaces/IUserRepository.cs"
click node_bearer "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Program.cs"
click node_blogsapi "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Controllers/BlogsController.cs"
click node_blogrepo "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Services/BlogRepository.cs"
click node_bloginterface "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Interfaces/IBlogRepository.cs"
click node_adddto "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Dtos/Blog/AddBlogDto.cs"
click node_updatedto "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Dtos/Blog/UpdateBlogDto.cs"
click node_blogdto "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Dtos/Blog/BlogDto.cs"
click node_listdto "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Dtos/Blog/BlogsListDto.cs"
click node_mapper "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/AutoMapperProfiles/BlogProfile.cs"
click node_context "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Context/DatabaseContext.cs"
click node_blogentity "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Entities/Blog.cs"
click node_userentity "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Entities/User.cs"
click node_sqlite "https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/JwtDB"

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_pipeline,node_client toneBlue
class node_auth,node_authdto,node_userrepo,node_userinterface,node_bearer toneAmber
class node_blogsapi,node_blogrepo,node_bloginterface,node_adddto,node_updatedto,node_blogdto,node_listdto toneMint
class node_context,node_blogentity,node_userentity,node_sqlite toneRose
class node_mapper toneIndigo
```

## Components

### API hosting

- [HTTP pipeline](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Program.cs): `JWTTraining/Program.cs`

### Identity and security

- [Authentication endpoint](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Controllers/AuthController.cs): `JWTTraining/Controllers/AuthController.cs`
- [Authentication request](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Dtos/Auth/AuthenticationRequestDto.cs): `JWTTraining/Dtos/Auth/AuthenticationRequestDto.cs`
- [User repository](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Services/UserRepository.cs): `JWTTraining/Services/UserRepository.cs`
- [User repository contract](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Interfaces/IUserRepository.cs): `JWTTraining/Interfaces/IUserRepository.cs`
- [JWT bearer validation](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Program.cs): `JWTTraining/Program.cs`

### Blog API

- [Blog endpoints](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Controllers/BlogsController.cs): `JWTTraining/Controllers/BlogsController.cs`
- [Blog repository](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Services/BlogRepository.cs): `JWTTraining/Services/BlogRepository.cs`
- [Blog repository contract](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Interfaces/IBlogRepository.cs): `JWTTraining/Interfaces/IBlogRepository.cs`
- [Add blog request](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Dtos/Blog/AddBlogDto.cs): `JWTTraining/Dtos/Blog/AddBlogDto.cs`
- [Patch blog data](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Dtos/Blog/UpdateBlogDto.cs): `JWTTraining/Dtos/Blog/UpdateBlogDto.cs`
- [Blog response](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Dtos/Blog/BlogDto.cs): `JWTTraining/Dtos/Blog/BlogDto.cs`
- [Blog list response](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Dtos/Blog/BlogsListDto.cs): `JWTTraining/Dtos/Blog/BlogsListDto.cs`

### Persistence and models

- [EF Core context](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Context/DatabaseContext.cs): `JWTTraining/Context/DatabaseContext.cs`
- [Blog entity](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Entities/Blog.cs): `JWTTraining/Entities/Blog.cs`
- [User entity](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/Entities/User.cs): `JWTTraining/Entities/User.cs`
- [SQLite database](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/JwtDB): `JWTTraining/JwtDB`

### DTO mapping

- [Blog mappings](https://github.com/alirezaas23/api-with-jtw-example/blob/master/JWTTraining/AutoMapperProfiles/BlogProfile.cs): `JWTTraining/AutoMapperProfiles/BlogProfile.cs`

### Other components

- **API client**

## Connections

- API client → HTTP pipeline: sends requests (evidence: `JWTTraining/Program.cs`)
- HTTP pipeline → Authentication endpoint: routes requests
- HTTP pipeline → Blog endpoints: routes requests (evidence: `JWTTraining/Program.cs`)
- HTTP pipeline → JWT bearer validation: validates bearer (evidence: `JWTTraining/Program.cs`)
- Authentication endpoint → User repository: looks up user (evidence: `JWTTraining/Controllers/AuthController.cs`)
- Authentication endpoint → Authentication request: accepts request (evidence: `JWTTraining/Controllers/AuthController.cs`)
- User repository → EF Core context: queries users (evidence: `JWTTraining/Services/UserRepository.cs`)
- User repository → User entity: returns user (evidence: `JWTTraining/Services/UserRepository.cs`)
- User repository → User repository contract: implements (evidence: `JWTTraining/Services/UserRepository.cs`)
- Blog endpoints → Blog repository: calls operations (evidence: `JWTTraining/Controllers/BlogsController.cs`)
- Blog endpoints → Add blog request: accepts request (evidence: `JWTTraining/Controllers/BlogsController.cs`)
- Blog endpoints → Patch blog data: patches data (evidence: `JWTTraining/Controllers/BlogsController.cs`)
- Blog endpoints → Blog response: returns mapped data (evidence: `JWTTraining/Controllers/BlogsController.cs`)
- Blog endpoints → Blog list response: returns mapped list (evidence: `JWTTraining/Controllers/BlogsController.cs`)
- Blog repository → Blog repository contract: implements (evidence: `JWTTraining/Services/BlogRepository.cs`)
- Blog repository → EF Core context: queries and saves (evidence: `JWTTraining/Services/BlogRepository.cs`)
- Blog repository → Blog entity: reads and writes (evidence: `JWTTraining/Services/BlogRepository.cs`)
- Blog mappings → Blog entity: maps entities (evidence: `JWTTraining/AutoMapperProfiles/BlogProfile.cs`)
- Blog mappings → Add blog request: maps request (evidence: `JWTTraining/AutoMapperProfiles/BlogProfile.cs`)
- Blog mappings → Patch blog data: maps patch data (evidence: `JWTTraining/AutoMapperProfiles/BlogProfile.cs`)
- Blog mappings → Blog response: maps response (evidence: `JWTTraining/AutoMapperProfiles/BlogProfile.cs`)
- Blog mappings → Blog list response: maps list (evidence: `JWTTraining/AutoMapperProfiles/BlogProfile.cs`)
- EF Core context → Blog entity: tracks blogs (evidence: `JWTTraining/Context/DatabaseContext.cs`)
- EF Core context → User entity: tracks users (evidence: `JWTTraining/Context/DatabaseContext.cs`)
- HTTP pipeline → EF Core context: configures context (evidence: `JWTTraining/Program.cs`)
- HTTP pipeline → Blog repository: registers repository (evidence: `JWTTraining/Program.cs`)
- HTTP pipeline → User repository: registers repository (evidence: `JWTTraining/Program.cs`)
- HTTP pipeline → SQLite database: uses provider (evidence: `JWTTraining/Program.cs`)
- EF Core context → SQLite database: persists records
