# mahdiebrahimidev/todolist architecture

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

- Interactive diagram: https://gitdiagram.com/mahdiebrahimidev/todolist
- Repository: https://github.com/mahdiebrahimidev/todolist

## Overview

TodoList is an ASP.NET Core MVC task manager with user accounts and per-user task management. The main workflow is an authenticated user submitting task actions to MVC controllers; the task service applies ownership checks, filtering, sorting, pagination, soft deletion, and completion changes through EF Core. Account and profile/user-management capabilities form a separate branch. The README documents the layered design and SQL Server configuration; some controller and view wiring is unsampled, so uncertain links are omitted or marked dashed.

Main entry points: [`TodoList/Program.cs`](https://github.com/mahdiebrahimidev/todolist/blob/main/TodoList/Program.cs) (App Startup), [`TodoList/Controllers/AccountController.cs`](https://github.com/mahdiebrahimidev/todolist/blob/main/TodoList/Controllers/AccountController.cs) (Account Actions), [`CoreLayer/Services/UserServices/UserServices.cs`](https://github.com/mahdiebrahimidev/todolist/blob/main/CoreLayer/Services/UserServices/UserServices.cs) (User Service), [`DataLayer/Context/AppDB.cs`](https://github.com/mahdiebrahimidev/todolist/blob/main/DataLayer/Context/AppDB.cs) (EF Context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["MVC Web"]
  node_startup["App Startup<br/>[Program.cs]"]
  node_account_controller["Account Actions"]
  node_todo_controller["Task Actions<br/>[TodoController.cs]"]
  node_user_controller["User Actions<br/>[UserController.cs]"]
  node_login_models["Login Forms<br/>[LoginViewModel.cs]"]
  node_register_model["Registration Form"]
end

subgraph group_accounts["Accounts"]
  node_account_dto["Login DTO<br/>[LoginDTO.cs]"]
  node_user_service["User Service<br/>[UserServices.cs]"]
  node_user_contract["User Service Contract<br/>[IUserServices.cs]"]
  node_user_dtos["User DTOs"]
end

subgraph group_tasks["Task Management"]
  node_todo_service["Task Service<br/>[TodoServices.cs]"]
  node_todo_contract["Task Service Contract<br/>[ITodoServices.cs]"]
  node_todo_dtos["Task DTOs"]
end

subgraph group_data["Persistence"]
  node_appdb["EF Context<br/>[AppDB.cs]"]
  node_users["User Entity<br/>[User.cs]"]
  node_todo_item["Task Entity<br/>[TodoItem.cs]"]
end

node_user(("User"))
node_sqlserver[("SQL Server")]

node_user -.->|"submits account requests"| node_account_controller
node_user -.->|"submits task requests"| node_todo_controller
node_user -.->|"submits profile requests"| node_user_controller
node_startup -->|"routes MVC"| node_account_controller
node_startup -->|"routes MVC"| node_todo_controller
node_startup -->|"routes MVC"| node_user_controller
node_startup -->|"registers service"| node_user_service
node_startup -->|"registers service"| node_todo_service
node_startup -->|"configures context"| node_appdb
node_account_controller -->|"calls account operations"| node_user_service
node_account_controller -->|"maps login input"| node_account_dto
node_account_controller -->|"accepts registration"| node_register_model
node_account_controller -->|"accepts login"| node_login_models
node_todo_controller -->|"calls task operations"| node_todo_service
node_todo_controller -->|"passes task data"| node_todo_dtos
node_user_controller -->|"calls user operations"| node_user_service
node_user_controller -->|"uses user data"| node_user_dtos
node_user_service -->|"queries and saves"| node_appdb
node_user_service -->|"reads and updates"| node_users
node_user_service -->|"counts user tasks"| node_todo_item
node_todo_service -->|"queries and saves"| node_appdb
node_todo_service -->|"creates and updates"| node_todo_item
node_appdb -->|"tracks task set"| node_todo_item
node_appdb -->|"tracks user set"| node_users
node_appdb -.->|"persists through EF Core"| node_sqlserver

click node_startup "https://github.com/mahdiebrahimidev/todolist/blob/main/TodoList/Program.cs"
click node_account_controller "https://github.com/mahdiebrahimidev/todolist/blob/main/TodoList/Controllers/AccountController.cs"
click node_todo_controller "https://github.com/mahdiebrahimidev/todolist/blob/main/TodoList/Controllers/TodoController.cs"
click node_user_controller "https://github.com/mahdiebrahimidev/todolist/blob/main/TodoList/Controllers/UserController.cs"
click node_login_models "https://github.com/mahdiebrahimidev/todolist/blob/main/TodoList/Models/LoginViewModel.cs"
click node_register_model "https://github.com/mahdiebrahimidev/todolist/blob/main/TodoList/Models/RegisterViewModel.cs"
click node_account_dto "https://github.com/mahdiebrahimidev/todolist/blob/main/CoreLayer/DTOs/AccountDTO/LoginDTO.cs"
click node_user_service "https://github.com/mahdiebrahimidev/todolist/blob/main/CoreLayer/Services/UserServices/UserServices.cs"
click node_user_contract "https://github.com/mahdiebrahimidev/todolist/blob/main/CoreLayer/Services/UserServices/IUserServices.cs"
click node_user_dtos "https://github.com/mahdiebrahimidev/todolist/tree/main/CoreLayer/DTOs/UserDTO"
click node_todo_service "https://github.com/mahdiebrahimidev/todolist/blob/main/CoreLayer/Services/TodoServices/TodoServices.cs"
click node_todo_contract "https://github.com/mahdiebrahimidev/todolist/blob/main/CoreLayer/Services/TodoServices/ITodoServices.cs"
click node_todo_dtos "https://github.com/mahdiebrahimidev/todolist/tree/main/CoreLayer/DTOs/TodoDTO"
click node_appdb "https://github.com/mahdiebrahimidev/todolist/blob/main/DataLayer/Context/AppDB.cs"
click node_users "https://github.com/mahdiebrahimidev/todolist/blob/main/DataLayer/Entities/User.cs"
click node_todo_item "https://github.com/mahdiebrahimidev/todolist/blob/main/DataLayer/Entities/TodoItem.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_startup,node_account_controller,node_todo_controller,node_user_controller,node_login_models,node_register_model,node_user toneBlue
class node_account_dto,node_user_service,node_user_contract,node_user_dtos,node_sqlserver toneAmber
class node_todo_service,node_todo_contract,node_todo_dtos toneMint
class node_appdb,node_users,node_todo_item toneRose
```

## Components

### MVC Web

- [App Startup](https://github.com/mahdiebrahimidev/todolist/blob/main/TodoList/Program.cs): `TodoList/Program.cs`
- [Account Actions](https://github.com/mahdiebrahimidev/todolist/blob/main/TodoList/Controllers/AccountController.cs): `TodoList/Controllers/AccountController.cs`
- [Task Actions](https://github.com/mahdiebrahimidev/todolist/blob/main/TodoList/Controllers/TodoController.cs): `TodoList/Controllers/TodoController.cs`
- [User Actions](https://github.com/mahdiebrahimidev/todolist/blob/main/TodoList/Controllers/UserController.cs): `TodoList/Controllers/UserController.cs`
- [Login Forms](https://github.com/mahdiebrahimidev/todolist/blob/main/TodoList/Models/LoginViewModel.cs): `TodoList/Models/LoginViewModel.cs`
- [Registration Form](https://github.com/mahdiebrahimidev/todolist/blob/main/TodoList/Models/RegisterViewModel.cs): `TodoList/Models/RegisterViewModel.cs`

### Accounts

- [Login DTO](https://github.com/mahdiebrahimidev/todolist/blob/main/CoreLayer/DTOs/AccountDTO/LoginDTO.cs): `CoreLayer/DTOs/AccountDTO/LoginDTO.cs`
- [User Service](https://github.com/mahdiebrahimidev/todolist/blob/main/CoreLayer/Services/UserServices/UserServices.cs): `CoreLayer/Services/UserServices/UserServices.cs`
- [User Service Contract](https://github.com/mahdiebrahimidev/todolist/blob/main/CoreLayer/Services/UserServices/IUserServices.cs): `CoreLayer/Services/UserServices/IUserServices.cs`
- [User DTOs](https://github.com/mahdiebrahimidev/todolist/tree/main/CoreLayer/DTOs/UserDTO): `CoreLayer/DTOs/UserDTO`

### Task Management

- [Task Service](https://github.com/mahdiebrahimidev/todolist/blob/main/CoreLayer/Services/TodoServices/TodoServices.cs): `CoreLayer/Services/TodoServices/TodoServices.cs`
- [Task Service Contract](https://github.com/mahdiebrahimidev/todolist/blob/main/CoreLayer/Services/TodoServices/ITodoServices.cs): `CoreLayer/Services/TodoServices/ITodoServices.cs`
- [Task DTOs](https://github.com/mahdiebrahimidev/todolist/tree/main/CoreLayer/DTOs/TodoDTO): `CoreLayer/DTOs/TodoDTO`

### Persistence

- [EF Context](https://github.com/mahdiebrahimidev/todolist/blob/main/DataLayer/Context/AppDB.cs): `DataLayer/Context/AppDB.cs`
- [User Entity](https://github.com/mahdiebrahimidev/todolist/blob/main/DataLayer/Entities/User.cs): `DataLayer/Entities/User.cs`
- [Task Entity](https://github.com/mahdiebrahimidev/todolist/blob/main/DataLayer/Entities/TodoItem.cs): `DataLayer/Entities/TodoItem.cs`

### Other components

- **User**
- **SQL Server**

## Connections

- User → Account Actions: submits account requests
- User → Task Actions: submits task requests
- User → User Actions: submits profile requests
- App Startup → Account Actions: routes MVC (evidence: `TodoList/Program.cs`)
- App Startup → Task Actions: routes MVC (evidence: `TodoList/Program.cs`)
- App Startup → User Actions: routes MVC (evidence: `TodoList/Program.cs`)
- App Startup → User Service: registers service (evidence: `TodoList/Program.cs`)
- App Startup → Task Service: registers service (evidence: `TodoList/Program.cs`)
- App Startup → EF Context: configures context (evidence: `TodoList/Program.cs`)
- Account Actions → User Service: calls account operations (evidence: `TodoList/Controllers/AccountController.cs`)
- Account Actions → Login DTO: maps login input (evidence: `TodoList/Controllers/AccountController.cs`)
- Account Actions → Registration Form: accepts registration (evidence: `TodoList/Controllers/AccountController.cs`)
- Account Actions → Login Forms: accepts login (evidence: `TodoList/Controllers/AccountController.cs`)
- Task Actions → Task Service: calls task operations (evidence: `TodoList/Controllers/TodoController.cs`)
- Task Actions → Task DTOs: passes task data (evidence: `TodoList/Controllers/TodoController.cs`)
- User Actions → User Service: calls user operations (evidence: `TodoList/Controllers/UserController.cs`)
- User Actions → User DTOs: uses user data (evidence: `TodoList/Controllers/UserController.cs`)
- User Service → EF Context: queries and saves (evidence: `CoreLayer/Services/UserServices/UserServices.cs`)
- User Service → User Entity: reads and updates (evidence: `CoreLayer/Services/UserServices/UserServices.cs`)
- User Service → Task Entity: counts user tasks (evidence: `CoreLayer/Services/UserServices/UserServices.cs`)
- Task Service → EF Context: queries and saves (evidence: `CoreLayer/Services/TodoServices/TodoServices.cs`)
- Task Service → Task Entity: creates and updates (evidence: `CoreLayer/Services/TodoServices/TodoServices.cs`)
- EF Context → Task Entity: tracks task set (evidence: `DataLayer/Context/AppDB.cs`)
- EF Context → User Entity: tracks user set (evidence: `DataLayer/Context/AppDB.cs`)
- EF Context → SQL Server: persists through EF Core
