ToDoAPI

Simple API ToDo list in .NET 8 with modular structure (3 projects + 1 test project): API itself (controllers, endpoints), Business logic and Data Access Layer.

Unit tests in xUnit

Main design patterns:

• CQRS - queries and commands (changes in database) are separated in dedicated class/handlers, which are invoking by MediatR.
• AutoMapper - is mapping objects from database logic into business logic and vice versa.
• UnitOfWork with BaseRepository in database logic project will give possibility to easy add new features and repositories - all of them can use the same basic, repeatable tasks like FindAllAsync(lambda expression) instead of implementing logic for all those basic db tasks one by one for each repository.
• Unit and integration tests in xUnit - and because project is modular by design, it's much easier to test and mock everything.

To run in docker container using docker-compose:

docker-compose up -d

Swagger will be at: http://localhost:8080/swagger/index.html

API Endpoints:

GET /api/Tasks - get all tasks

GET /api/Tasks/{Id} - get task by Id

GET /api/Tasks/GetIncomingTasks - get tasks with expiry date within next 7 days

POST /api/Tasks - Create new task, json example:

{
"title": "string",
"isCompleted": false,
"description": "string",
"percentageComplete": 0,
"createdAt": "2025-09-07T18:38:25.783Z",
"expiryDate": "2025-09-07T18:38:25.783Z"
}

PUT /api/Tasks/{Id} - Update task with Id

{
"id": 1,
"title": "string",
"description": "string",
"isCompleted": true,
"percentageComplete": 100,
"createdAt": "2025-09-07T18:39:49.194Z",
"expiryDate": "2025-09-07T18:39:49.194Z"
}

PATCH /api/Tasks/{id}/percent - Update task percent complete

When set to 100, task is also mark as done, if set to less than 100 - task is marked as undone

{
"percentageComplete": 0
}

PATCH /api/Tasks/{id}/status - Mark task as done or not When isCompleted set to true, percentage is set to 100, when false - percentage is set to 0

{
"isCompleted": false
}

Database structure:

ToDoAPI.Dal.Entities.TaskEntity

public class TaskEntity
{
[Key]
public int Id { get; set; }
[MaxLength(200)]
[Required]
public required string Title { get; set; }
[Required]
public bool IsCompleted { get; set; } = false;
public string? Description { get; set; }
[Range(0, 100)]
public int PercentageComplete { get; set; } = 0;
[Required]
public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
public DateTime? ExpiryDate { get; set; }
}