# iamumutcan/onlinecourse architecture

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

## Overview

This is an online-course management API built as a Clean Architecture monolith. Users and administrators reach authentication, course catalog, content/document, instructor, enrollment, and role-management capabilities through WebAPI controllers; requests are dispatched to application features and ultimately managed by domain services and persistence. The README also lists JWT, OTP, Google/Microsoft authentication, caching, logging, and search, but the supplied tree and excerpts do not establish their wiring. Several subsystem links are therefore omitted or marked unverified rather than inferred.

Main entry points: [`src/onlineCourse/Persistence/Repositories`](https://github.com/iamumutcan/onlinecourse/tree/main/src/onlineCourse/Persistence/Repositories) (Repositories), [`src/onlineCourse/WebAPI/Controllers/CourseDocumentsController.cs`](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/WebAPI/Controllers/CourseDocumentsController.cs) (Document endpoints), [`src/onlineCourse/WebAPI/Controllers/AuthController.cs`](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/WebAPI/Controllers/AuthController.cs) (Authentication), [`src/onlineCourse/Application/Services/AuthService/AuthManager.cs`](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Application/Services/AuthService/AuthManager.cs) (Token management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_webapi["Web API<br/>[Program.cs]"]
  node_authcontroller["Authentication<br/>[AuthController.cs]"]
  node_courseapi["Course endpoints"]
  node_docsapi["Document endpoints"]
end

subgraph group_application["Application"]
  node_features["CQRS features"]
  node_authcommands["Auth commands"]
  node_coursefeatures["Course features"]
  node_documentfeatures["Document features"]
  node_authmanager["Token management<br/>[AuthManager.cs]"]
  node_authenticators["Authenticators"]
  node_coursemanager["Course service<br/>[CourseManager.cs]"]
  node_documentmanager["Document service"]
  node_usercourses["Enrollment service"]
  node_claims["Role management"]
  node_upload["File upload"]
end

subgraph group_domain["Domain"]
  node_coursemodel["Course model<br/>[Course.cs]"]
  node_useridentity["User identity<br/>[User.cs]"]
  node_userclaims["User permissions"]
end

subgraph group_persistence["Persistence"]
  node_repositories["Repositories"]
  node_dbcontext[("Database context<br/>[BaseDbContext.cs]")]
end

node_client(("API client"))
node_database[("SQL database")]
node_mail["Mail service"]

node_client -->|"sends requests"| node_webapi
node_webapi -.->|"routes auth"| node_authcontroller
node_client -->|"calls auth"| node_authcontroller
node_client -.->|"calls documents"| node_docsapi
node_authcontroller -->|"dispatches commands"| node_authcommands
node_docsapi -->|"dispatches queries"| node_documentfeatures
node_docsapi -->|"calls upload"| node_upload
node_courseapi -.->|"dispatches requests"| node_coursefeatures
node_authmanager -->|"uses token repositories"| node_repositories
node_authmanager -->|"reads permissions"| node_userclaims
node_authenticators -->|"sends email"| node_mail
node_authenticators -->|"reads and updates"| node_repositories
node_coursemanager -->|"manages courses"| node_coursemodel
node_coursemanager -->|"uses course repository"| node_repositories
node_documentmanager -->|"uses document repository"| node_repositories
node_usercourses -->|"uses enrollment repository"| node_repositories
node_claims -->|"uses claim repository"| node_repositories
node_repositories -.->|"uses context"| node_dbcontext
node_dbcontext -.->|"persists data"| node_database

click node_webapi "https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/WebAPI/Program.cs"
click node_authcontroller "https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/WebAPI/Controllers/AuthController.cs"
click node_courseapi "https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/WebAPI/Controllers/CoursesController.cs"
click node_docsapi "https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/WebAPI/Controllers/CourseDocumentsController.cs"
click node_features "https://github.com/iamumutcan/onlinecourse/tree/main/src/onlineCourse/Application/Features"
click node_authcommands "https://github.com/iamumutcan/onlinecourse/tree/main/src/onlineCourse/Application/Features/Auth/Commands"
click node_coursefeatures "https://github.com/iamumutcan/onlinecourse/tree/main/src/onlineCourse/Application/Features/Courses"
click node_documentfeatures "https://github.com/iamumutcan/onlinecourse/tree/main/src/onlineCourse/Application/Features/CourseDocuments"
click node_authmanager "https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Application/Services/AuthService/AuthManager.cs"
click node_authenticators "https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Application/Services/AuthenticatorService/AuthenticatorManager.cs"
click node_coursemanager "https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Application/Services/Courses/CourseManager.cs"
click node_documentmanager "https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Application/Services/CourseDocuments/CourseDocumentManager.cs"
click node_usercourses "https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Application/Services/UserCourses/UserCourseManager.cs"
click node_claims "https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Application/Services/OperationClaims/OperationClaimManager.cs"
click node_coursemodel "https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Domain/Entities/Course.cs"
click node_useridentity "https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Domain/Entities/User.cs"
click node_userclaims "https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Domain/Entities/UserOperationClaim.cs"
click node_upload "https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Infrastructure/Adapters/FileService/FileUploadHandler.cs"
click node_repositories "https://github.com/iamumutcan/onlinecourse/tree/main/src/onlineCourse/Persistence/Repositories"
click node_dbcontext "https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Persistence/Contexts/BaseDbContext.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_webapi,node_authcontroller,node_courseapi,node_docsapi,node_client toneBlue
class node_features,node_authcommands,node_coursefeatures,node_documentfeatures,node_authmanager,node_authenticators,node_coursemanager,node_documentmanager,node_usercourses,node_claims,node_upload,node_database toneAmber
class node_coursemodel,node_useridentity,node_userclaims toneMint
class node_repositories,node_dbcontext toneRose
class node_mail toneIndigo
```

## Components

### HTTP API

- [Web API](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/WebAPI/Program.cs): `src/onlineCourse/WebAPI/Program.cs`
- [Authentication](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/WebAPI/Controllers/AuthController.cs): `src/onlineCourse/WebAPI/Controllers/AuthController.cs`
- [Course endpoints](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/WebAPI/Controllers/CoursesController.cs): `src/onlineCourse/WebAPI/Controllers/CoursesController.cs`
- [Document endpoints](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/WebAPI/Controllers/CourseDocumentsController.cs): `src/onlineCourse/WebAPI/Controllers/CourseDocumentsController.cs`

### Application

- [CQRS features](https://github.com/iamumutcan/onlinecourse/tree/main/src/onlineCourse/Application/Features): `src/onlineCourse/Application/Features`
- [Auth commands](https://github.com/iamumutcan/onlinecourse/tree/main/src/onlineCourse/Application/Features/Auth/Commands): `src/onlineCourse/Application/Features/Auth/Commands`
- [Course features](https://github.com/iamumutcan/onlinecourse/tree/main/src/onlineCourse/Application/Features/Courses): `src/onlineCourse/Application/Features/Courses`
- [Document features](https://github.com/iamumutcan/onlinecourse/tree/main/src/onlineCourse/Application/Features/CourseDocuments): `src/onlineCourse/Application/Features/CourseDocuments`
- [Token management](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Application/Services/AuthService/AuthManager.cs): `src/onlineCourse/Application/Services/AuthService/AuthManager.cs`
- [Authenticators](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Application/Services/AuthenticatorService/AuthenticatorManager.cs): `src/onlineCourse/Application/Services/AuthenticatorService/AuthenticatorManager.cs`
- [Course service](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Application/Services/Courses/CourseManager.cs): `src/onlineCourse/Application/Services/Courses/CourseManager.cs`
- [Document service](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Application/Services/CourseDocuments/CourseDocumentManager.cs): `src/onlineCourse/Application/Services/CourseDocuments/CourseDocumentManager.cs`
- [Enrollment service](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Application/Services/UserCourses/UserCourseManager.cs): `src/onlineCourse/Application/Services/UserCourses/UserCourseManager.cs`
- [Role management](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Application/Services/OperationClaims/OperationClaimManager.cs): `src/onlineCourse/Application/Services/OperationClaims/OperationClaimManager.cs`
- [File upload](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Infrastructure/Adapters/FileService/FileUploadHandler.cs): `src/onlineCourse/Infrastructure/Adapters/FileService/FileUploadHandler.cs`

### Domain

- [Course model](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Domain/Entities/Course.cs): `src/onlineCourse/Domain/Entities/Course.cs`
- [User identity](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Domain/Entities/User.cs): `src/onlineCourse/Domain/Entities/User.cs`
- [User permissions](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Domain/Entities/UserOperationClaim.cs): `src/onlineCourse/Domain/Entities/UserOperationClaim.cs`

### Persistence

- [Repositories](https://github.com/iamumutcan/onlinecourse/tree/main/src/onlineCourse/Persistence/Repositories): `src/onlineCourse/Persistence/Repositories`
- [Database context](https://github.com/iamumutcan/onlinecourse/blob/main/src/onlineCourse/Persistence/Contexts/BaseDbContext.cs): `src/onlineCourse/Persistence/Contexts/BaseDbContext.cs`

### Other components

- **API client**
- **SQL database**
- **Mail service**

## Connections

- API client → Web API: sends requests (evidence: `src/onlineCourse/WebAPI/Program.cs`)
- Web API → Authentication: routes auth
- API client → Authentication: calls auth (evidence: `src/onlineCourse/WebAPI/Controllers/AuthController.cs`)
- API client → Document endpoints: calls documents
- Authentication → Auth commands: dispatches commands (evidence: `src/onlineCourse/WebAPI/Controllers/AuthController.cs`)
- Document endpoints → Document features: dispatches queries (evidence: `src/onlineCourse/WebAPI/Controllers/CourseDocumentsController.cs`)
- Document endpoints → File upload: calls upload (evidence: `src/onlineCourse/WebAPI/Controllers/CourseDocumentsController.cs`)
- Course endpoints → Course features: dispatches requests
- Token management → Repositories: uses token repositories (evidence: `src/onlineCourse/Application/Services/AuthService/AuthManager.cs`)
- Token management → User permissions: reads permissions (evidence: `src/onlineCourse/Application/Services/AuthService/AuthManager.cs`)
- Authenticators → Mail service: sends email (evidence: `src/onlineCourse/Application/Services/AuthenticatorService/AuthenticatorManager.cs`)
- Authenticators → Repositories: reads and updates (evidence: `src/onlineCourse/Application/Services/AuthenticatorService/AuthenticatorManager.cs`)
- Course service → Course model: manages courses (evidence: `src/onlineCourse/Application/Services/Courses/CourseManager.cs`)
- Course service → Repositories: uses course repository (evidence: `src/onlineCourse/Application/Services/Courses/CourseManager.cs`)
- Document service → Repositories: uses document repository (evidence: `src/onlineCourse/Application/Services/CourseDocuments/CourseDocumentManager.cs`)
- Enrollment service → Repositories: uses enrollment repository (evidence: `src/onlineCourse/Application/Services/UserCourses/UserCourseManager.cs`)
- Role management → Repositories: uses claim repository (evidence: `src/onlineCourse/Application/Services/OperationClaims/OperationClaimManager.cs`)
- Repositories → Database context: uses context (evidence: `src/onlineCourse/Persistence/Repositories/EmailAuthenticatorRepository.cs`)
- Database context → SQL database: persists data
